fix(ai): surface provider HTTP error body instead of opaque SDK message

Add a shared normalizeProviderError helper in packages/ai/src/utils/error-body.ts
and route the 8 body-blind / status-only providers through it (amazon-bedrock,
azure-openai-responses, google, google-vertex, images/openrouter,
openai-codex-responses, openai-completions, openai-responses). Non-schema 4xx/5xx
responses from proxies / gateways now show the real reason carried in the response
body alongside the HTTP status, instead of "403 status code (no body)" or
"Unknown: UnknownError".

The helper probes status (statusCode, status, $metadata.httpStatusCode,
$response.statusCode) and body (body, parsed error object, $response.body) across
the Mistral, OpenAI, Google, and Bedrock SDK shapes, truncates the body at a 4000
char cap, and preserves error.message when the SDK already folded the body in
(Anthropic / Google happy path). mistral.ts and anthropic.ts are left untouched.
Provider prefixes and the OpenRouter metadata.raw append are preserved.

closes #5763
This commit is contained in:
Stephan Schneider
2026-06-17 09:21:03 +02:00
parent d7868b0998
commit 62fad94f1a
12 changed files with 580 additions and 36 deletions
+12 -4
View File
@@ -47,6 +47,7 @@ import type {
ToolCall,
ToolResultMessage,
} from "../types.ts";
import { normalizeProviderError } from "../utils/error-body.ts";
import { AssistantMessageEventStream } from "../utils/event-stream.ts";
import { providerHeadersToRecord } from "../utils/headers.ts";
import { parseStreamingJson } from "../utils/json-parse.ts";
@@ -322,15 +323,22 @@ const BEDROCK_DATA_RETENTION_DOCS_URL = "https://docs.aws.amazon.com/bedrock/lat
* detection) can distinguish error categories via simple string matching.
*/
function formatBedrockError(error: unknown): string {
const message = error instanceof Error ? error.message : JSON.stringify(error);
const dataRetentionHint = /data retention mode/i.test(message)
const norm = normalizeProviderError(error);
// Surface the raw HTTP body (with status) when the SDK did not fold it into
// the message; otherwise fall back to the message. This is what stops a
// gateway 403 from collapsing to `Unknown: UnknownError`.
const core =
!norm.messageCarriesBody && norm.status !== undefined && norm.body !== undefined
? `${norm.status}: ${norm.body}`
: norm.message;
const dataRetentionHint = /data retention mode/i.test(core)
? ` See ${BEDROCK_DATA_RETENTION_DOCS_URL} for supported data retention modes.`
: "";
if (error instanceof BedrockRuntimeServiceException) {
const prefix = BEDROCK_ERROR_PREFIXES[error.name] ?? error.name;
return `${prefix}: ${message}${dataRetentionHint}`;
return `${prefix}: ${core}${dataRetentionHint}`;
}
return `${message}${dataRetentionHint}`;
return `${core}${dataRetentionHint}`;
}
/**