@ai-sdk/amazon-bedrock 4.0.55 → 4.0.57

package/docs/08-amazon-bedrock.mdx

@@ -267,6 +267,8 @@ const result = await generateText({
 You can use the `bedrock` provider options to utilize [Amazon Bedrock Guardrails](https://aws.amazon.com/bedrock/guardrails/):
 
 ```ts
+import { type AmazonBedrockLanguageModelOptions } from '@ai-sdk/amazon-bedrock';
+
 const result = await generateText({
   model: bedrock('anthropic.claude-3-sonnet-20240229-v1:0'),
   prompt: 'Write a story about space exploration.',
@@ -278,7 +280,7 @@ const result = await generateText({
         trace: 'enabled' as const,
         streamProcessingMode: 'async',
       },
-    },
+    } satisfies AmazonBedrockLanguageModelOptions,
   },
 });
 ```
@@ -449,6 +451,21 @@ console.log(
 // }
 ```
 
+### Provider Metadata
+
+The following Bedrock-specific metadata may be returned in `providerMetadata.bedrock`:
+
+- **trace** _(optional)_
+  Guardrail tracing information (when tracing is enabled).
+- **performanceConfig** _(optional)_
+  Performance configuration, e.g. `{ latency: 'optimized' }`.
+- **serviceTier** _(optional)_
+  Service tier information, e.g. `{ type: 'on-demand' }`.
+- **usage** _(optional)_
+  Cache token usage details including `cacheWriteInputTokens` and `cacheDetails`.
+- **stopSequence** _string | null_
+  The stop sequence that triggered the stop, if any.
+
 ## Reasoning
 
 Amazon Bedrock supports model creator-specific reasoning features:
@@ -457,7 +474,10 @@ Amazon Bedrock supports model creator-specific reasoning features:
 - Amazon (e.g. `us.amazon.nova-2-lite-v1:0`): enable via the `reasoningConfig` provider option and specifying a maximum reasoning effort level (`'low' | 'medium' | 'high'`).
 
 ```ts
-import { bedrock } from '@ai-sdk/amazon-bedrock';
+import {
+  bedrock,
+  type AmazonBedrockLanguageModelOptions,
+} from '@ai-sdk/amazon-bedrock';
 import { generateText } from 'ai';
 
 // Anthropic example
@@ -467,7 +487,7 @@ const anthropicResult = await generateText({
   providerOptions: {
     bedrock: {
       reasoningConfig: { type: 'enabled', budgetTokens: 1024 },
-    },
+    } satisfies AmazonBedrockLanguageModelOptions,
   },
 });
 
@@ -481,7 +501,7 @@ const amazonResult = await generateText({
   providerOptions: {
     bedrock: {
       reasoningConfig: { type: 'enabled', maxReasoningEffort: 'medium' },
-    },
+    } satisfies AmazonBedrockLanguageModelOptions,
   },
 });
 
@@ -497,7 +517,10 @@ on how to integrate reasoning into your chatbot.
 Claude Sonnet 4 models on Amazon Bedrock support an extended context window of up to 1 million tokens when using the `context-1m-2025-08-07` beta feature.
 
 ```ts
-import { bedrock } from '@ai-sdk/amazon-bedrock';
+import {
+  bedrock,
+  type AmazonBedrockLanguageModelOptions,
+} from '@ai-sdk/amazon-bedrock';
 import { generateText } from 'ai';
 
 const result = await generateText({
@@ -506,7 +529,7 @@ const result = await generateText({
   providerOptions: {
     bedrock: {
       anthropicBeta: ['context-1m-2025-08-07'],
-    },
+    } satisfies AmazonBedrockLanguageModelOptions,
   },
 });
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/amazon-bedrock",
-  "version": "4.0.55",
+  "version": "4.0.57",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -38,7 +38,7 @@
     "@smithy/eventstream-codec": "^4.0.1",
     "@smithy/util-utf8": "^4.0.0",
     "aws4fetch": "^1.0.20",
-    "@ai-sdk/anthropic": "3.0.41",
+    "@ai-sdk/anthropic": "3.0.42",
     "@ai-sdk/provider": "3.0.8",
     "@ai-sdk/provider-utils": "4.0.14"
   },
@@ -47,8 +47,8 @@
     "tsup": "^8.3.0",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "1.0.3",
-    "@vercel/ai-tsconfig": "0.0.0"
+    "@vercel/ai-tsconfig": "0.0.0",
+    "@ai-sdk/test-server": "1.0.3"
   },
   "peerDependencies": {
     "zod": "^3.25.76 || ^4.1.8"

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

@@ -31,7 +31,7 @@ import {
 } from './bedrock-api-types';
 import {
   BedrockChatModelId,
-  bedrockProviderOptions,
+  amazonBedrockLanguageModelOptions,
 } from './bedrock-chat-options';
 import { BedrockErrorSchema } from './bedrock-error';
 import { createBedrockEventStreamResponseHandler } from './bedrock-event-stream-response-handler';
@@ -82,7 +82,7 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
       (await parseProviderOptions({
         provider: 'bedrock',
         providerOptions,
-        schema: bedrockProviderOptions,
+        schema: amazonBedrockLanguageModelOptions,
       })) ?? {};
 
     const warnings: SharedV3Warning[] = [];
@@ -483,15 +483,32 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
       response.additionalModelResponseFields?.delta?.stop_sequence ?? null;
 
     const providerMetadata =
-      response.trace || response.usage || isJsonResponseFromTool || stopSequence
+      response.trace ||
+      response.usage ||
+      response.performanceConfig ||
+      response.serviceTier ||
+      isJsonResponseFromTool ||
+      stopSequence
         ? {
             bedrock: {
               ...(response.trace && typeof response.trace === 'object'
                 ? { trace: response.trace as JSONObject }
                 : {}),
-              ...(response.usage?.cacheWriteInputTokens != null && {
+              ...(response.performanceConfig && {
+                performanceConfig: response.performanceConfig,
+              }),
+              ...(response.serviceTier && {
+                serviceTier: response.serviceTier,
+              }),
+              ...((response.usage?.cacheWriteInputTokens != null ||
+                response.usage?.cacheDetails != null) && {
                 usage: {
-                  cacheWriteInputTokens: response.usage.cacheWriteInputTokens,
+                  ...(response.usage.cacheWriteInputTokens != null && {
+                    cacheWriteInputTokens: response.usage.cacheWriteInputTokens,
+                  }),
+                  ...(response.usage.cacheDetails != null && {
+                    cacheDetails: response.usage.cacheDetails,
+                  }),
                 },
               }),
               ...(isJsonResponseFromTool && { isJsonResponseFromTool: true }),
@@ -511,7 +528,12 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
       },
       usage: convertBedrockUsage(response.usage),
       response: {
-        // TODO add id, timestamp, etc
+        id: responseHeaders?.['x-amzn-requestid'] ?? undefined,
+        timestamp:
+          responseHeaders?.['date'] != null
+            ? new Date(responseHeaders['date'])
+            : undefined,
+        modelId: this.modelId,
         headers: responseHeaders,
       },
       warnings,
@@ -527,8 +549,9 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
       warnings,
       usesJsonResponseTool,
     } = await this.getArgs(options);
-    const isMistral = isMistralModel(this.modelId);
-    const url = `${this.getUrl(this.modelId)}/converse-stream`;
+    const modelId = this.modelId;
+    const isMistral = isMistralModel(modelId);
+    const url = `${this.getUrl(modelId)}/converse-stream`;
 
     const { value: response, responseHeaders } = await postJsonToApi({
       url,
@@ -573,6 +596,15 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
         >({
           start(controller) {
             controller.enqueue({ type: 'stream-start', warnings });
+            controller.enqueue({
+              type: 'response-metadata',
+              id: responseHeaders?.['x-amzn-requestid'] ?? undefined,
+              timestamp:
+                responseHeaders?.['date'] != null
+                  ? new Date(responseHeaders['date'])
+                  : undefined,
+              modelId,
+            });
           },
 
           transform(chunk, controller) {
@@ -631,11 +663,18 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
               }
 
               const cacheUsage =
-                value.metadata.usage?.cacheWriteInputTokens != null
+                value.metadata.usage?.cacheWriteInputTokens != null ||
+                value.metadata.usage?.cacheDetails != null
                   ? {
                       usage: {
-                        cacheWriteInputTokens:
-                          value.metadata.usage.cacheWriteInputTokens,
+                        ...(value.metadata.usage?.cacheWriteInputTokens !=
+                          null && {
+                          cacheWriteInputTokens:
+                            value.metadata.usage.cacheWriteInputTokens,
+                        }),
+                        ...(value.metadata.usage?.cacheDetails != null && {
+                          cacheDetails: value.metadata.usage.cacheDetails,
+                        }),
                       },
                     }
                   : undefined;
@@ -646,11 +685,22 @@ export class BedrockChatLanguageModel implements LanguageModelV3 {
                   }
                 : undefined;
 
-              if (cacheUsage || trace) {
+              if (
+                cacheUsage ||
+                trace ||
+                value.metadata.performanceConfig ||
+                value.metadata.serviceTier
+              ) {
                 providerMetadata = {
                   bedrock: {
                     ...cacheUsage,
                     ...trace,
+                    ...(value.metadata.performanceConfig && {
+                      performanceConfig: value.metadata.performanceConfig,
+                    }),
+                    ...(value.metadata.serviceTier && {
+                      serviceTier: value.metadata.serviceTier,
+                    }),
                   },
                 };
               }
@@ -955,12 +1005,17 @@ const BedrockResponseSchema = z.object({
   additionalModelResponseFields:
     BedrockAdditionalModelResponseFieldsSchema.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(z.object({ inputTokens: z.number(), ttl: z.string() }))
+      .nullish(),
   }),
 });
 
@@ -1015,10 +1070,15 @@ const BedrockStreamSchema = z.object({
   metadata: z
     .object({
       trace: z.unknown().nullish(),
+      performanceConfig: z.object({ latency: z.string() }).nullish(),
+      serviceTier: z.object({ type: z.string() }).nullish(),
       usage: z
         .object({
           cacheReadInputTokens: z.number().nullish(),
           cacheWriteInputTokens: z.number().nullish(),
+          cacheDetails: z
+            .array(z.object({ inputTokens: z.number(), ttl: z.string() }))
+            .nullish(),
           inputTokens: z.number(),
           outputTokens: z.number(),
         })

package/src/bedrock-chat-options.ts

@@ -91,7 +91,7 @@ export type BedrockFilePartProviderOptions = z.infer<
   typeof bedrockFilePartProviderOptions
 >;
 
-export const bedrockProviderOptions = z.object({
+export const amazonBedrockLanguageModelOptions = z.object({
   /**
    * Additional inference parameters that the model supports,
    * beyond the base set of inference parameters that Converse
@@ -117,4 +117,6 @@ export const bedrockProviderOptions = z.object({
   anthropicBeta: z.array(z.string()).optional(),
 });
 
-export type BedrockProviderOptions = z.infer<typeof bedrockProviderOptions>;
+export type AmazonBedrockLanguageModelOptions = z.infer<
+  typeof amazonBedrockLanguageModelOptions
+>;

package/src/index.ts

@@ -1,10 +1,18 @@
 export type { AnthropicProviderOptions } from '@ai-sdk/anthropic';
 
-export type { BedrockProviderOptions } from './bedrock-chat-options';
+export type {
+  AmazonBedrockLanguageModelOptions,
+  /** @deprecated Use `AmazonBedrockLanguageModelOptions` instead. */
+  AmazonBedrockLanguageModelOptions as BedrockProviderOptions,
+} from './bedrock-chat-options';
 export { bedrock, createAmazonBedrock } from './bedrock-provider';
 export type {
   AmazonBedrockProvider,
   AmazonBedrockProviderSettings,
 } from './bedrock-provider';
-export type { BedrockRerankingOptions } from './reranking/bedrock-reranking-options';
+export type {
+  AmazonBedrockRerankingModelOptions,
+  /** @deprecated Use `AmazonBedrockRerankingModelOptions` instead. */
+  AmazonBedrockRerankingModelOptions as BedrockRerankingOptions,
+} from './reranking/bedrock-reranking-options';
 export { VERSION } from './version';

package/src/reranking/bedrock-reranking-model.ts

@@ -16,7 +16,7 @@ import {
 } from './bedrock-reranking-api';
 import {
   BedrockRerankingModelId,
-  bedrockRerankingOptionsSchema,
+  amazonBedrockRerankingModelOptionsSchema,
 } from './bedrock-reranking-options';
 
 type BedrockRerankingConfig = {
@@ -48,7 +48,7 @@ export class BedrockRerankingModel implements RerankingModelV3 {
     const bedrockOptions = await parseProviderOptions({
       provider: 'bedrock',
       providerOptions,
-      schema: bedrockRerankingOptionsSchema,
+      schema: amazonBedrockRerankingModelOptionsSchema,
     });
 
     const {

package/src/reranking/bedrock-reranking-options.ts

@@ -7,7 +7,7 @@ export type BedrockRerankingModelId =
   | 'cohere.rerank-v3-5:0'
   | (string & {});
 
-export type BedrockRerankingOptions = {
+export type AmazonBedrockRerankingModelOptions = {
   /**
    * If the total number of results was greater than could fit in a response, a token is returned in the nextToken field. You can enter that token in this field to return the next batch of results.
    */
@@ -19,7 +19,7 @@ export type BedrockRerankingOptions = {
   additionalModelRequestFields?: Record<string, unknown>;
 };
 
-export const bedrockRerankingOptionsSchema = lazySchema(() =>
+export const amazonBedrockRerankingModelOptionsSchema = lazySchema(() =>
   zodSchema(
     z.object({
       /**