@ai-sdk/amazon-bedrock 5.0.120 → 5.0.121

package/dist/mantle/index.cjs

@@ -4,7 +4,7 @@ let _ai_sdk_provider = require("@ai-sdk/provider");
 let _ai_sdk_provider_utils = require("@ai-sdk/provider-utils");
 let aws4fetch = require("aws4fetch");
 //#region src/version.ts
-const VERSION = "5.0.120";
+const VERSION = "5.0.121";
 //#endregion
 //#region src/amazon-bedrock-sigv4-fetch.ts
 /**

package/dist/mantle/index.js

@@ -3,7 +3,7 @@ import { InvalidArgumentError, NoSuchModelError } from "@ai-sdk/provider";
 import { combineHeaders, getRuntimeEnvironmentUserAgent, isValidHostnamePart, loadOptionalSetting, loadSetting, normalizeHeaders, withUserAgentSuffix, withoutTrailingSlash } from "@ai-sdk/provider-utils";
 import { AwsV4Signer } from "aws4fetch";
 //#region src/version.ts
-const VERSION = "5.0.120";
+const VERSION = "5.0.121";
 //#endregion
 //#region src/amazon-bedrock-sigv4-fetch.ts
 /**

package/docs/08-amazon-bedrock.mdx

@@ -1,17 +1,65 @@
 ---
 title: Amazon Bedrock
-description: Learn how to use the Amazon Bedrock provider.
+description: Learn how to use Amazon Bedrock with AI Gateway and the direct provider.
 ---
 
 # Amazon Bedrock Provider
 
 The Amazon Bedrock provider for the [AI SDK](/docs) contains language model support for the [Amazon Bedrock](https://aws.amazon.com/bedrock) APIs.
+Start with [AI Gateway](/providers/ai-sdk-providers/ai-gateway) for models in its catalog (recommended), or use `@ai-sdk/amazon-bedrock` to connect directly to Amazon Bedrock.
 
-## Setup
+```ts provider="amazon" model="amazon/nova-pro"
+import { generateText } from 'ai';
+__PROVIDER_IMPORT__;
+
+const { text } = await generateText({
+  model: __MODEL__,
+  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
+  __GATEWAY_OPTIONS__,
+});
+
+console.log(text);
+```
+
+## Using AI Gateway
+
+The AI SDK uses AI Gateway by default for model strings. Gateway provides access to models across providers through a single API key, with usage and cost tracking. Install `ai`:
+
+<InstallPackages packages="ai" />
+
+Set an [AI Gateway API key](https://vercel.com/docs/ai-gateway/getting-started) in your environment:
+
+```bash
+export AI_GATEWAY_API_KEY=your_api_key_here
+```
+
+Vercel deployments can also use [OIDC authentication](/providers/ai-sdk-providers/ai-gateway#oidc-authentication-vercel-deployments).
+See the [AI Gateway provider documentation](/providers/ai-sdk-providers/ai-gateway) for configuration and the [model catalog](https://vercel.com/ai-gateway/models) for available models.
+
+The example sets `providerOptions.gateway.order` to `['bedrock']`. This sends the request to Amazon Bedrock first, then falls back to other available providers of the same model if Amazon Bedrock is unavailable or the request fails. `order` sets a preference; it does not restrict fallback to Amazon Bedrock. See [provider ordering](https://vercel.com/docs/ai-gateway/models-and-providers/provider-filtering-and-ordering).
+
+The dropdown lists models served by Amazon Bedrock through Gateway with a corresponding direct-provider example. Provider availability depends on the model and your team's [Provider Allowlist](https://vercel.com/docs/ai-gateway/models-and-providers/provider-filtering-and-ordering).
+
+## Using `@ai-sdk/amazon-bedrock`
+
+For direct access to Amazon Bedrock, install `ai` and `@ai-sdk/amazon-bedrock`:
+
+<InstallPackages packages="ai @ai-sdk/amazon-bedrock" />
 
-The Bedrock provider is available in the `@ai-sdk/amazon-bedrock` module. You can install it with
+Set your Amazon Bedrock API credential in the `AWS_BEARER_TOKEN_BEDROCK` environment variable:
 
-<InstallPackages packages="@ai-sdk/amazon-bedrock" />
+```bash
+export AWS_BEARER_TOKEN_BEDROCK=your_api_key_here
+export AWS_REGION=us-east-1
+```
+
+Use the direct provider for AWS authentication, account-specific inference profiles, or Bedrock-specific APIs. Gateway and Bedrock use different model IDs.
+
+<Note>
+  The following sections document the direct `@ai-sdk/amazon-bedrock` provider,
+  including its model factories and settings. Gateway model and feature
+  availability can differ.
+</Note>
 
 ### Prerequisites
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/amazon-bedrock",
-  "version": "5.0.120",
+  "version": "5.0.121",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -41,10 +41,10 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "4.0.84",
-    "@ai-sdk/openai": "4.0.98",
+    "@ai-sdk/anthropic": "4.0.85",
+    "@ai-sdk/openai": "4.0.99",
     "@ai-sdk/provider": "4.0.31",
-    "@ai-sdk/provider-utils": "5.0.64",
+    "@ai-sdk/provider-utils": "5.0.65",
     "@smithy/eventstream-codec": "^4.3.3",
     "@smithy/util-utf8": "^4.3.3",
     "aws4fetch": "^1.0.20"

package/src/amazon-bedrock-chat-language-model-options.ts

@@ -1,3 +1,8 @@
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+} from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 // https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html
@@ -108,22 +113,26 @@ export type AmazonBedrockChatModelSettings = {
  * Bedrock file part provider options for document-specific features.
  * These options apply to individual file parts (documents).
  */
-export const amazonBedrockFilePartProviderOptions = z.object({
-  /**
-   * Citation configuration for this document.
-   * When enabled, this document will generate citations in the response.
-   */
-  citations: z
-    .object({
+export const amazonBedrockFilePartProviderOptions = lazySchema(() =>
+  zodSchema(
+    z.object({
       /**
-       * Enable citations for this document
+       * Citation configuration for this document.
+       * When enabled, this document will generate citations in the response.
        */
-      enabled: z.boolean(),
-    })
-    .optional(),
-});
+      citations: z
+        .object({
+          /**
+           * Enable citations for this document
+           */
+          enabled: z.boolean(),
+        })
+        .optional(),
+    }),
+  ),
+);
 
-export type AmazonBedrockFilePartProviderOptions = z.infer<
+export type AmazonBedrockFilePartProviderOptions = InferSchema<
   typeof amazonBedrockFilePartProviderOptions
 >;
 
@@ -131,14 +140,18 @@ export type AmazonBedrockFilePartProviderOptions = z.infer<
  * Amazon Bedrock text part provider options for guardrail content.
  * These options apply to individual text parts.
  */
-export const amazonBedrockTextPartProviderOptions = z.object({
-  guardContent: z.boolean().optional(),
-  guardContentQualifiers: z
-    .array(z.enum(['grounding_source', 'query', 'guard_content']))
-    .optional(),
-});
+export const amazonBedrockTextPartProviderOptions = lazySchema(() =>
+  zodSchema(
+    z.object({
+      guardContent: z.boolean().optional(),
+      guardContentQualifiers: z
+        .array(z.enum(['grounding_source', 'query', 'guard_content']))
+        .optional(),
+    }),
+  ),
+);
 
-export type AmazonBedrockTextPartProviderOptions = z.infer<
+export type AmazonBedrockTextPartProviderOptions = InferSchema<
   typeof amazonBedrockTextPartProviderOptions
 >;
 
@@ -146,11 +159,15 @@ export type AmazonBedrockTextPartProviderOptions = z.infer<
  * Amazon Bedrock image part provider options for guardrail content.
  * These options apply to individual image parts.
  */
-export const amazonBedrockImagePartProviderOptions = z.object({
-  guardContent: z.boolean().optional(),
-});
+export const amazonBedrockImagePartProviderOptions = lazySchema(() =>
+  zodSchema(
+    z.object({
+      guardContent: z.boolean().optional(),
+    }),
+  ),
+);
 
-export type AmazonBedrockImagePartProviderOptions = z.infer<
+export type AmazonBedrockImagePartProviderOptions = InferSchema<
   typeof amazonBedrockImagePartProviderOptions
 >;
 

package/src/amazon-bedrock-chat-language-model.ts

@@ -13,6 +13,8 @@ import type {
   SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
+  lazySchema,
+  zodSchema,
   combineHeaders,
   createProviderStreamError,
   createJsonErrorResponseHandler,
@@ -79,10 +81,16 @@ type AmazonBedrockChatConfig = {
   modelFamily?: AmazonBedrockChatModelSettings['modelFamily'];
 };
 
-const anthropicProviderOptions = z.object({
-  disableParallelToolUse: z.boolean().optional(),
-  structuredOutputMode: z.enum(['outputFormat', 'jsonTool', 'auto']).optional(),
-});
+const anthropicProviderOptions = lazySchema(() =>
+  zodSchema(
+    z.object({
+      disableParallelToolUse: z.boolean().optional(),
+      structuredOutputMode: z
+        .enum(['outputFormat', 'jsonTool', 'auto'])
+        .optional(),
+    }),
+  ),
+);
 
 function createAmazonBedrockStreamError({
   type,
@@ -1454,14 +1462,16 @@ const AmazonBedrockToolUseSchema = z.object({
   input: z.unknown().optional(),
 });
 
-const AmazonBedrockReasoningTextSchema = z.object({
-  signature: z.string().nullish(),
-  text: z.string(),
-});
+const AmazonBedrockReasoningTextSchema = () =>
+  z.object({
+    signature: z.string().nullish(),
+    text: z.string(),
+  });
 
-const AmazonBedrockRedactedReasoningSchema = z.object({
-  data: z.string(),
-});
+const AmazonBedrockRedactedReasoningSchema = () =>
+  z.object({
+    data: z.string(),
+  });
 
 const AmazonBedrockCacheDetailSchema = z
   .object({
@@ -1472,68 +1482,72 @@ const AmazonBedrockCacheDetailSchema = z
 
 // limited version of the schema, focused on what is needed for the implementation
 // this approach limits breakages when the API changes and increases efficiency
-const AmazonBedrockResponseSchema = z.object({
-  metrics: z
-    .object({
-      latencyMs: z.number(),
-    })
-    .nullish(),
-  output: z.object({
-    message: z.object({
-      content: z.array(
-        z.object({
-          text: z.string().nullish(),
-          citationsContent: z
-            .object({
-              content: z
-                .array(
+const AmazonBedrockResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      metrics: z
+        .object({
+          latencyMs: z.number(),
+        })
+        .nullish(),
+      output: z.object({
+        message: z.object({
+          content: z.array(
+            z.object({
+              text: z.string().nullish(),
+              citationsContent: z
+                .object({
+                  content: z
+                    .array(
+                      z.object({
+                        text: z.string().nullish(),
+                      }),
+                    )
+                    .nullish(),
+                })
+                .nullish(),
+              toolUse: AmazonBedrockToolUseSchema.nullish(),
+              reasoningContent: z
+                .union([
+                  z.object({
+                    reasoningText: AmazonBedrockReasoningTextSchema(),
+                  }),
                   z.object({
-                    text: z.string().nullish(),
+                    redactedReasoning: AmazonBedrockRedactedReasoningSchema(),
                   }),
-                )
+                  // `redactedContent` is a member of the documented
+                  // ReasoningContentBlock union. OpenAI models on Bedrock
+                  // (e.g. `us.openai.gpt-5.6-luna`) return their encrypted
+                  // reasoning in this shape.
+                  z.object({
+                    redactedContent: z.string(),
+                  }),
+                ])
                 .nullish(),
-            })
-            .nullish(),
-          toolUse: AmazonBedrockToolUseSchema.nullish(),
-          reasoningContent: z
-            .union([
-              z.object({
-                reasoningText: AmazonBedrockReasoningTextSchema,
-              }),
-              z.object({
-                redactedReasoning: AmazonBedrockRedactedReasoningSchema,
-              }),
-              // `redactedContent` is a member of the documented
-              // ReasoningContentBlock union. OpenAI models on Bedrock
-              // (e.g. `us.openai.gpt-5.6-luna`) return their encrypted
-              // reasoning in this shape.
-              z.object({
-                redactedContent: z.string(),
-              }),
-            ])
-            .nullish(),
+            }),
+          ),
+          role: z.string(),
         }),
-      ),
-      role: z.string(),
+      }),
+      stopReason: AmazonBedrockStopReasonSchema,
+      additionalModelResponseFields:
+        AmazonBedrockAdditionalModelResponseFieldsSchema.nullish(),
+      trace: z.unknown().nullish(),
+      performanceConfig: z.object({ latency: z.string() }).nullish(),
+      serviceTier: z.object({ type: z.string() }).nullish(),
+      usage: z
+        .object({
+          inputTokens: z.number(),
+          outputTokens: z.number(),
+          totalTokens: z.number(),
+          cacheReadInputTokens: z.number().nullish(),
+          cacheWriteInputTokens: z.number().nullish(),
+          cacheDetails: z.array(AmazonBedrockCacheDetailSchema).nullish(),
+        })
+        .catchall(z.json()),
     }),
-  }),
-  stopReason: AmazonBedrockStopReasonSchema,
-  additionalModelResponseFields:
-    AmazonBedrockAdditionalModelResponseFieldsSchema.nullish(),
-  trace: z.unknown().nullish(),
-  performanceConfig: z.object({ latency: z.string() }).nullish(),
-  serviceTier: z.object({ type: z.string() }).nullish(),
-  usage: z
-    .object({
-      inputTokens: z.number(),
-      outputTokens: z.number(),
-      totalTokens: z.number(),
-      cacheReadInputTokens: z.number().nullish(),
-      cacheWriteInputTokens: z.number().nullish(),
-      cacheDetails: z.array(AmazonBedrockCacheDetailSchema).nullish(),
-    })
-    .catchall(z.json()),
-});
+  ),
+);
 
 // limited version of the schema, focussed on what is needed for the implementation
 // this approach limits breakages when the API changes and increases efficiency

package/src/amazon-bedrock-embedding-model-options.ts

@@ -1,3 +1,8 @@
+import {
+  lazySchema,
+  zodSchema,
+  type InferSchema,
+} from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
 export type AmazonBedrockEmbeddingModelId =
@@ -17,72 +22,91 @@ export type AmazonBedrockEmbeddingModelSettings = {
   modelFamily?: 'titan' | 'cohere' | 'nova';
 };
 
-export const amazonBedrockEmbeddingModelOptionsSchema = z.object({
-  /**
-   * The number of dimensions the resulting output embeddings should have (defaults to 1024).
-   * Only supported in amazon.titan-embed-text-v2:0.
-   */
-  dimensions: z
-    .union([z.literal(1024), z.literal(512), z.literal(256)])
-    .optional(),
+export const amazonBedrockEmbeddingModelOptionsSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      /**
+       * The number of dimensions the resulting output embeddings should have (defaults to 1024).
+       * Only supported in amazon.titan-embed-text-v2:0.
+       */
+      dimensions: z
+        .union([z.literal(1024), z.literal(512), z.literal(256)])
+        .optional(),
 
-  /**
-   * Flag indicating whether or not to normalize the output embeddings. Defaults to true.
-   * Only supported in amazon.titan-embed-text-v2:0.
-   */
-  normalize: z.boolean().optional(),
+      /**
+       * Flag indicating whether or not to normalize the output embeddings. Defaults to true.
+       * Only supported in amazon.titan-embed-text-v2:0.
+       */
+      normalize: z.boolean().optional(),
 
-  /**
-   * The number of dimensions for Nova embedding models (defaults to 1024).
-   * Supported values: 256, 384, 1024, 3072.
-   * Only supported in amazon.nova-* embedding models.
-   */
-  embeddingDimension: z
-    .union([z.literal(256), z.literal(384), z.literal(1024), z.literal(3072)])
-    .optional(),
+      /**
+       * The number of dimensions for Nova embedding models (defaults to 1024).
+       * Supported values: 256, 384, 1024, 3072.
+       * Only supported in amazon.nova-* embedding models.
+       */
+      embeddingDimension: z
+        .union([
+          z.literal(256),
+          z.literal(384),
+          z.literal(1024),
+          z.literal(3072),
+        ])
+        .optional(),
 
-  /**
-   * The purpose of the embedding. Defaults to 'GENERIC_INDEX'.
-   * Only supported in amazon.nova-* embedding models.
-   */
-  embeddingPurpose: z
-    .enum([
-      'GENERIC_INDEX',
-      'TEXT_RETRIEVAL',
-      'IMAGE_RETRIEVAL',
-      'VIDEO_RETRIEVAL',
-      'DOCUMENT_RETRIEVAL',
-      'AUDIO_RETRIEVAL',
-      'GENERIC_RETRIEVAL',
-      'CLASSIFICATION',
-      'CLUSTERING',
-    ])
-    .optional(),
+      /**
+       * The purpose of the embedding. Defaults to 'GENERIC_INDEX'.
+       * Only supported in amazon.nova-* embedding models.
+       */
+      embeddingPurpose: z
+        .enum([
+          'GENERIC_INDEX',
+          'TEXT_RETRIEVAL',
+          'IMAGE_RETRIEVAL',
+          'VIDEO_RETRIEVAL',
+          'DOCUMENT_RETRIEVAL',
+          'AUDIO_RETRIEVAL',
+          'GENERIC_RETRIEVAL',
+          'CLASSIFICATION',
+          'CLUSTERING',
+        ])
+        .optional(),
 
-  /**
-   * Input type for Cohere embedding models on Bedrock.
-   * Common values: `search_document`, `search_query`, `classification`, `clustering`.
-   * If not set, the provider defaults to `search_query`.
-   */
-  inputType: z
-    .enum(['search_document', 'search_query', 'classification', 'clustering'])
-    .optional(),
+      /**
+       * Input type for Cohere embedding models on Bedrock.
+       * Common values: `search_document`, `search_query`, `classification`, `clustering`.
+       * If not set, the provider defaults to `search_query`.
+       */
+      inputType: z
+        .enum([
+          'search_document',
+          'search_query',
+          'classification',
+          'clustering',
+        ])
+        .optional(),
 
-  /**
-   * Truncation behavior when input exceeds the model's context length.
-   * Supported in Cohere and Nova embedding models. Defaults to 'END' for Nova models.
-   */
-  truncate: z.enum(['NONE', 'START', 'END']).optional(),
+      /**
+       * Truncation behavior when input exceeds the model's context length.
+       * Supported in Cohere and Nova embedding models. Defaults to 'END' for Nova models.
+       */
+      truncate: z.enum(['NONE', 'START', 'END']).optional(),
 
-  /**
-   * The number of dimensions the resulting output embeddings should have (defaults to 1536).
-   * Only supported in cohere.embed-v4:0 and newer Cohere embedding models.
-   */
-  outputDimension: z
-    .union([z.literal(256), z.literal(512), z.literal(1024), z.literal(1536)])
-    .optional(),
-});
+      /**
+       * The number of dimensions the resulting output embeddings should have (defaults to 1536).
+       * Only supported in cohere.embed-v4:0 and newer Cohere embedding models.
+       */
+      outputDimension: z
+        .union([
+          z.literal(256),
+          z.literal(512),
+          z.literal(1024),
+          z.literal(1536),
+        ])
+        .optional(),
+    }),
+  ),
+);
 
-export type AmazonBedrockEmbeddingModelOptions = z.infer<
+export type AmazonBedrockEmbeddingModelOptions = InferSchema<
   typeof amazonBedrockEmbeddingModelOptionsSchema
 >;

package/src/amazon-bedrock-embedding-model.ts

@@ -3,6 +3,8 @@ import {
   type EmbeddingModelV4,
 } from '@ai-sdk/provider';
 import {
+  lazySchema,
+  zodSchema,
   combineHeaders,
   createJsonResponseHandler,
   parseProviderOptions,
@@ -217,30 +219,34 @@ function detectEmbeddingModelFamily(
       : 'titan';
 }
 
-const AmazonBedrockEmbeddingResponseSchema = z.union([
-  // Titan-style response
-  z.object({
-    embedding: z.array(z.number()),
-    inputTextTokenCount: z.number(),
-  }),
-  // Nova-style response
-  z.object({
-    embeddings: z.array(
+const AmazonBedrockEmbeddingResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.union([
+      // Titan-style response
       z.object({
-        embeddingType: z.string(),
         embedding: z.array(z.number()),
+        inputTextTokenCount: z.number(),
       }),
-    ),
-    inputTokenCount: z.number().optional(),
-  }),
-  // Cohere v3-style response
-  z.object({
-    embeddings: z.array(z.array(z.number())),
-  }),
-  // Cohere v4-style response
-  z.object({
-    embeddings: z.object({
-      float: z.array(z.array(z.number())),
-    }),
-  }),
-]);
+      // Nova-style response
+      z.object({
+        embeddings: z.array(
+          z.object({
+            embeddingType: z.string(),
+            embedding: z.array(z.number()),
+          }),
+        ),
+        inputTokenCount: z.number().optional(),
+      }),
+      // Cohere v3-style response
+      z.object({
+        embeddings: z.array(z.array(z.number())),
+      }),
+      // Cohere v4-style response
+      z.object({
+        embeddings: z.object({
+          float: z.array(z.array(z.number())),
+        }),
+      }),
+    ]),
+  ),
+);

package/src/amazon-bedrock-error.ts

@@ -1,10 +1,18 @@
-import { createJsonErrorResponseHandler } from '@ai-sdk/provider-utils';
+import {
+  lazySchema,
+  zodSchema,
+  createJsonErrorResponseHandler,
+} from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 
-export const AmazonBedrockErrorSchema = z.object({
-  message: z.string(),
-  type: z.string().nullish(),
-});
+export const AmazonBedrockErrorSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      message: z.string(),
+      type: z.string().nullish(),
+    }),
+  ),
+);
 
 export const amazonBedrockFailedResponseHandler =
   createJsonErrorResponseHandler({