@ai-sdk/amazon-bedrock 4.0.43 → 4.0.45

package/docs/08-amazon-bedrock.mdx

@@ -348,7 +348,21 @@ console.log('Response:', result.object);
 
 In messages, you can use the `providerOptions` property to set cache points. Set the `bedrock` property in the `providerOptions` object to `{ cachePoint: { type: 'default' } }` to create a cache point.
 
-Cache usage information is returned in the `providerMetadata` object`. See examples below.
+You can also specify a TTL (time-to-live) for cache points using the `ttl` property. Supported values are `'5m'` (5 minutes, default) and `'1h'` (1 hour). The 1-hour TTL is only supported by Claude Opus 4.5, Claude Haiku 4.5, and Claude Sonnet 4.5.
+
+```ts
+providerOptions: {
+  bedrock: { cachePoint: { type: 'default', ttl: '1h' } },
+}
+```
+
+<Note>
+  When using multiple cache points with different TTLs, cache entries with
+  longer TTL must appear before shorter TTLs (i.e., 1-hour cache entries must
+  come before 5-minute cache entries).
+</Note>
+
+Cache usage information is returned in the `providerMetadata` object. See examples below.
 
 <Note>
   Cache points have model-specific token minimums and limits. For example,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/amazon-bedrock",
-  "version": "4.0.43",
+  "version": "4.0.45",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -39,8 +39,8 @@
     "@smithy/util-utf8": "^4.0.0",
     "aws4fetch": "^1.0.20",
     "@ai-sdk/provider": "3.0.6",
-    "@ai-sdk/provider-utils": "4.0.11",
-    "@ai-sdk/anthropic": "3.0.33"
+    "@ai-sdk/anthropic": "3.0.34",
+    "@ai-sdk/provider-utils": "4.0.12"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/bedrock-api-types.ts

@@ -35,11 +35,31 @@ export interface BedrockUserMessage {
   content: Array<BedrockContentBlock>;
 }
 
-export const BEDROCK_CACHE_POINT = {
-  cachePoint: { type: 'default' },
-} as const;
+/**
+ * Cache TTL options for Bedrock prompt caching.
+ * @see https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-caching.html
+ *
+ * - '5m': 5-minute TTL (default, supported by all models)
+ * - '1h': 1-hour TTL (supported by Claude Opus 4.5, Claude Haiku 4.5, Claude Sonnet 4.5)
+ */
+export type BedrockCacheTTL = '5m' | '1h';
+
+export type BedrockCachePoint = {
+  cachePoint: { type: 'default'; ttl?: BedrockCacheTTL };
+};
+
+/**
+ * Creates a cache point with an optional TTL.
+ * @param ttl - Cache TTL ('5m' or '1h'). If not provided, uses the default 5-minute TTL.
+ */
+export function createBedrockCachePoint(
+  ttl?: BedrockCacheTTL,
+): BedrockCachePoint {
+  return {
+    cachePoint: { type: 'default', ttl },
+  };
+}
 
-export type BedrockCachePoint = { cachePoint: { type: 'default' } };
 export type BedrockSystemContentBlock = { text: string } | BedrockCachePoint;
 
 export interface BedrockGuardrailConfiguration {

package/src/convert-to-bedrock-chat-messages.ts

@@ -7,7 +7,6 @@ import {
 } from '@ai-sdk/provider';
 import { convertToBase64, parseProviderOptions } from '@ai-sdk/provider-utils';
 import {
-  BEDROCK_CACHE_POINT,
   BEDROCK_DOCUMENT_MIME_TYPES,
   BEDROCK_IMAGE_MIME_TYPES,
   BedrockAssistantMessage,
@@ -27,7 +26,15 @@ import { normalizeToolCallId } from './normalize-tool-call-id';
 function getCachePoint(
   providerMetadata: SharedV3ProviderMetadata | undefined,
 ): BedrockCachePoint | undefined {
-  return providerMetadata?.bedrock?.cachePoint as BedrockCachePoint | undefined;
+  const cachePointConfig = providerMetadata?.bedrock?.cachePoint as
+    | BedrockCachePoint['cachePoint']
+    | undefined;
+
+  if (!cachePointConfig) {
+    return undefined;
+  }
+
+  return { cachePoint: cachePointConfig };
 }
 
 async function shouldEnableCitations(
@@ -73,8 +80,9 @@ export async function convertToBedrockChatMessages(
 
         for (const message of block.messages) {
           system.push({ text: message.content });
-          if (getCachePoint(message.providerOptions)) {
-            system.push(BEDROCK_CACHE_POINT);
+          const cachePoint = getCachePoint(message.providerOptions);
+          if (cachePoint) {
+            system.push(cachePoint);
           }
         }
         break;
@@ -220,8 +228,9 @@ export async function convertToBedrockChatMessages(
             }
           }
 
-          if (getCachePoint(providerOptions)) {
-            bedrockContent.push(BEDROCK_CACHE_POINT);
+          const cachePoint = getCachePoint(providerOptions);
+          if (cachePoint) {
+            bedrockContent.push(cachePoint);
           }
         }
 
@@ -316,8 +325,9 @@ export async function convertToBedrockChatMessages(
               }
             }
           }
-          if (getCachePoint(message.providerOptions)) {
-            bedrockContent.push(BEDROCK_CACHE_POINT);
+          const cachePoint = getCachePoint(message.providerOptions);
+          if (cachePoint) {
+            bedrockContent.push(cachePoint);
           }
         }