@ai-sdk/anthropic 3.0.133 → 3.0.135

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "3.0.133",
+  "version": "3.0.135",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "3.0.19",
-    "@ai-sdk/provider-utils": "4.0.61"
+    "@ai-sdk/provider-utils": "4.0.62"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/anthropic-messages-api.ts

@@ -48,6 +48,7 @@ export interface AnthropicUserMessage {
   content: Array<
     | AnthropicTextContent
     | AnthropicImageContent
+    | AnthropicVideoContent
     | AnthropicDocumentContent
     | AnthropicToolResultContent
   >;
@@ -126,6 +127,13 @@ export interface AnthropicImageContent {
   cache_control: AnthropicCacheControl | undefined;
 }
 
+/** Video blocks supplied by compatible providers through custom media conversion. */
+export interface AnthropicVideoContent {
+  type: 'video';
+  source: AnthropicContentSource;
+  cache_control: AnthropicCacheControl | undefined;
+}
+
 export interface AnthropicDocumentContent {
   type: 'document';
   source: AnthropicContentSource;
@@ -641,55 +649,61 @@ export type AnthropicResponseContextManagement = {
   applied_edits: AnthropicResponseContextManagementEdit[];
 };
 
-const anthropicStopDetailsSchema = z.object({
-  type: z.string(),
-  category: z.string().nullish(),
-  explanation: z.string().nullish(),
-  recommended_model: z.string().nullish(),
-});
+const anthropicStopDetailsSchema = () =>
+  z.object({
+    type: z.string(),
+    category: z.string().nullish(),
+    explanation: z.string().nullish(),
+    recommended_model: z.string().nullish(),
+  });
 
-export type AnthropicStopDetails = z.infer<typeof anthropicStopDetailsSchema>;
+export type AnthropicStopDetails = z.infer<
+  ReturnType<typeof anthropicStopDetailsSchema>
+>;
 
-const anthropicSafeguardResultSchema = z.object({
-  type: z.string(),
-  status: z.object({
+const anthropicSafeguardResultSchema = () =>
+  z.object({
     type: z.string(),
-    tool_uses: z
-      .record(
-        z.string(),
-        z.object({
-          type: z.string(),
-          outcome: z.string().nullish(),
-          explanation: z.string().nullish(),
-        }),
-      )
-      .nullish(),
-  }),
-});
+    status: z.object({
+      type: z.string(),
+      tool_uses: z
+        .record(
+          z.string(),
+          z.object({
+            type: z.string(),
+            outcome: z.string().nullish(),
+            explanation: z.string().nullish(),
+          }),
+        )
+        .nullish(),
+    }),
+  });
 
 export type AnthropicSafeguardResult = z.infer<
-  typeof anthropicSafeguardResultSchema
+  ReturnType<typeof anthropicSafeguardResultSchema>
 >;
 
-const anthropicToolCallCallerSchema = z.union([
-  z.object({
-    type: z.literal('code_execution_20250825'),
-    tool_id: z.string(),
-  }),
-  z.object({
-    type: z.literal('code_execution_20260120'),
-    tool_id: z.string(),
-  }),
-  z.object({
-    type: z.literal('direct'),
-  }),
-]);
+const anthropicToolCallCallerSchema = () =>
+  z.union([
+    z.object({
+      type: z.literal('code_execution_20250825'),
+      tool_id: z.string(),
+    }),
+    z.object({
+      type: z.literal('code_execution_20260120'),
+      tool_id: z.string(),
+    }),
+    z.object({
+      type: z.literal('direct'),
+    }),
+  ]);
 
-const anthropicInputTransformationSchema = z.object({
-  type: z.string(),
-  path: z.string(),
-  reason: z.string(),
-});
+const anthropicInputTransformationSchema = () =>
+  z.object({
+    type: z.string(),
+    path: z.string(),
+    reason: z.string(),
+  });
 
 // limited version of the schema, focussed on what is needed for the implementation
 // this approach limits breakages when the API changes and increases efficiency
@@ -753,7 +767,7 @@ export const anthropicMessagesResponseSchema = lazySchema(() =>
             name: z.string(),
             input: z.unknown(),
             // Programmatic tool calling: caller info when triggered from code execution
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
             // Toolsets (e.g. computer toolset): name of the toolset this member call belongs to
             toolset_name: z.string().nullish(),
           }),
@@ -762,7 +776,7 @@ export const anthropicMessagesResponseSchema = lazySchema(() =>
             id: z.string(),
             name: z.string(),
             input: z.record(z.string(), z.unknown()).nullish(),
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
           }),
           z.object({
             type: z.literal('mcp_tool_use'),
@@ -785,7 +799,7 @@ export const anthropicMessagesResponseSchema = lazySchema(() =>
           z.object({
             type: z.literal('web_fetch_tool_result'),
             tool_use_id: z.string(),
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
             content: z.union([
               z.object({
                 type: z.literal('web_fetch_result'),
@@ -818,7 +832,7 @@ export const anthropicMessagesResponseSchema = lazySchema(() =>
           z.object({
             type: z.literal('web_search_tool_result'),
             tool_use_id: z.string(),
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
             content: z.union([
               z.array(
                 z.object({
@@ -981,11 +995,11 @@ export const anthropicMessagesResponseSchema = lazySchema(() =>
       ),
       stop_reason: z.string().nullish(),
       stop_sequence: z.string().nullish(),
-      stop_details: anthropicStopDetailsSchema.nullish(),
+      stop_details: anthropicStopDetailsSchema().nullish(),
       input_transformations: z
-        .array(anthropicInputTransformationSchema)
+        .array(anthropicInputTransformationSchema())
         .nullish(),
-      safeguard_results: z.array(anthropicSafeguardResultSchema).nullish(),
+      safeguard_results: z.array(anthropicSafeguardResultSchema()).nullish(),
       usage: z.looseObject({
         input_tokens: z.number(),
         output_tokens: z.number(),
@@ -1079,7 +1093,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
                   id: z.string(),
                   name: z.string(),
                   input: z.unknown(),
-                  caller: anthropicToolCallCallerSchema.optional(),
+                  caller: anthropicToolCallCallerSchema().optional(),
                   toolset_name: z.string().nullish(),
                 }),
               ]),
@@ -1087,7 +1101,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
             .nullish(),
           stop_reason: z.string().nullish(),
           input_transformations: z
-            .array(anthropicInputTransformationSchema)
+            .array(anthropicInputTransformationSchema())
             .nullish(),
           container: z
             .object({
@@ -1116,7 +1130,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
             // Programmatic tool calling: input may be present directly for deferred tool calls
             input: z.record(z.string(), z.unknown()).optional(),
             // Programmatic tool calling: caller info when triggered from code execution
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
             // Toolsets (e.g. computer toolset): name of the toolset this member call belongs to
             toolset_name: z.string().nullish(),
           }),
@@ -1133,7 +1147,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
             id: z.string(),
             name: z.string(),
             input: z.record(z.string(), z.unknown()).nullish(),
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
           }),
           z.object({
             type: z.literal('mcp_tool_use'),
@@ -1156,7 +1170,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
           z.object({
             type: z.literal('web_fetch_tool_result'),
             tool_use_id: z.string(),
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
             content: z.union([
               z.object({
                 type: z.literal('web_fetch_result'),
@@ -1189,7 +1203,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
           z.object({
             type: z.literal('web_search_tool_result'),
             tool_use_id: z.string(),
-            caller: anthropicToolCallCallerSchema.optional(),
+            caller: anthropicToolCallCallerSchema().optional(),
             content: z.union([
               z.array(
                 z.object({
@@ -1419,8 +1433,10 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
         delta: z.object({
           stop_reason: z.string().nullish(),
           stop_sequence: z.string().nullish(),
-          stop_details: anthropicStopDetailsSchema.nullish(),
-          safeguard_results: z.array(anthropicSafeguardResultSchema).nullish(),
+          stop_details: anthropicStopDetailsSchema().nullish(),
+          safeguard_results: z
+            .array(anthropicSafeguardResultSchema())
+            .nullish(),
           container: z
             .object({
               expires_at: z.string(),
@@ -1469,7 +1485,7 @@ export const anthropicMessagesChunkSchema = lazySchema(() =>
             .nullish(),
         }),
         input_transformations: z
-          .array(anthropicInputTransformationSchema)
+          .array(anthropicInputTransformationSchema())
           .nullish(),
         context_management: z
           .object({

package/src/anthropic-messages-language-model.ts

@@ -56,7 +56,10 @@ import {
   convertAnthropicMessagesUsage,
   type AnthropicMessagesUsage,
 } from './convert-anthropic-messages-usage';
-import { convertToAnthropicMessagesPrompt } from './convert-to-anthropic-messages-prompt';
+import {
+  convertToAnthropicMessagesPrompt,
+  type AnthropicMediaPartConverter,
+} from './convert-to-anthropic-messages-prompt';
 import { CacheControlValidator } from './get-cache-control';
 import { mapAnthropicStopReason } from './map-anthropic-stop-reason';
 import { sanitizeJsonSchema } from './sanitize-json-schema';
@@ -186,6 +189,14 @@ type AnthropicMessagesConfig = {
   headers: Resolvable<Record<string, string | undefined>>;
   fetch?: FetchFunction;
   buildRequestUrl?: (baseURL: string, isStreaming: boolean) => string;
+  /** Custom media conversion for compatible providers. */
+  convertMediaPart?: AnthropicMediaPartConverter;
+  /** Maximum temperature for compatible providers. Defaults to 1. */
+  maxTemperature?: number;
+  /** Preserve temperature and topP with thinking for compatible providers. */
+  supportsTemperatureAndTopPWithThinking?: boolean;
+  /** Cache option namespace for compatible providers. Defaults to anthropic. */
+  cacheControlProviderOptionsName?: string;
   transformRequestBody?: (
     args: Record<string, any>,
     betas: Set<string>,
@@ -278,18 +289,24 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
       warnings.push({ type: 'unsupported', feature: 'seed' });
     }
 
-    if (temperature != null && temperature > 1) {
+    const maxTemperature = this.config.maxTemperature ?? 1;
+    const temperatureProvider =
+      this.config.maxTemperature == null
+        ? 'anthropic'
+        : this.providerOptionsName;
+
+    if (temperature != null && temperature > maxTemperature) {
       warnings.push({
         type: 'unsupported',
         feature: 'temperature',
-        details: `${temperature} exceeds anthropic maximum of 1.0. clamped to 1.0`,
+        details: `${temperature} exceeds ${temperatureProvider} maximum of ${maxTemperature.toFixed(1)}. clamped to ${maxTemperature.toFixed(1)}`,
       });
-      temperature = 1;
+      temperature = maxTemperature;
     } else if (temperature != null && temperature < 0) {
       warnings.push({
         type: 'unsupported',
         feature: 'temperature',
-        details: `${temperature} is below anthropic minimum of 0. clamped to 0`,
+        details: `${temperature} is below ${temperatureProvider} minimum of 0. clamped to 0`,
       });
       temperature = 0;
     }
@@ -448,7 +465,9 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
     const contextManagement = anthropicOptions?.contextManagement;
 
     // Create a shared cache control validator to track breakpoints across tools and messages
-    const cacheControlValidator = new CacheControlValidator();
+    const cacheControlValidator = new CacheControlValidator(
+      this.config.cacheControlProviderOptionsName,
+    );
 
     const toolNameMapping = createToolNameMapping({
       tools,
@@ -487,6 +506,7 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
         cacheControlValidator,
         toolNameMapping,
         toolsetNames,
+        convertMediaPart: this.config.convertMediaPart,
       });
 
     // Some models always run adaptive thinking and reject `disabled` thinking
@@ -799,7 +819,10 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
         thinkingBudget = 1024;
       }
 
-      if (baseArgs.temperature != null) {
+      if (
+        baseArgs.temperature != null &&
+        !this.config.supportsTemperatureAndTopPWithThinking
+      ) {
         baseArgs.temperature = undefined;
         warnings.push({
           type: 'unsupported',
@@ -817,7 +840,7 @@ export class AnthropicMessagesLanguageModel implements LanguageModelV3 {
         });
       }
 
-      if (topP != null) {
+      if (topP != null && !this.config.supportsTemperatureAndTopPWithThinking) {
         baseArgs.top_p = undefined;
         warnings.push({
           type: 'unsupported',