@ai-sdk/anthropic 3.0.133 → 3.0.134

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/anthropic",
-  "version": "3.0.133",
+  "version": "3.0.134",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

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;

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',

package/src/convert-to-anthropic-messages-prompt.ts

@@ -2,6 +2,7 @@ import {
   UnsupportedFunctionalityError,
   type SharedV3Warning,
   type LanguageModelV3DataContent,
+  type LanguageModelV3FilePart,
   type LanguageModelV3Message,
   type LanguageModelV3Prompt,
   type SharedV3ProviderMetadata,
@@ -19,6 +20,7 @@ import {
 import {
   anthropicReasoningMetadataSchema,
   type AnthropicAssistantMessage,
+  type AnthropicImageContent,
   type AnthropicMessagesPrompt,
   type AnthropicSystemMessage,
   type AnthropicTextContent,
@@ -26,6 +28,7 @@ import {
   type AnthropicToolCallCaller,
   type AnthropicToolResultContent,
   type AnthropicUserMessage,
+  type AnthropicVideoContent,
   type AnthropicWebFetchToolResultContent,
   type Citation,
 } from './anthropic-messages-api';
@@ -109,6 +112,14 @@ async function extractErrorValue(
   return {};
 }
 
+/** Return undefined to use the default file conversion. */
+export type AnthropicMediaPartConverter = (
+  part: LanguageModelV3FilePart,
+) => PromiseLike<
+  | Omit<AnthropicImageContent | AnthropicVideoContent, 'cache_control'>
+  | undefined
+>;
+
 export async function convertToAnthropicMessagesPrompt({
   prompt,
   sendReasoning,
@@ -116,12 +127,14 @@ export async function convertToAnthropicMessagesPrompt({
   cacheControlValidator,
   toolNameMapping,
   toolsetNames = {},
+  convertMediaPart,
 }: {
   prompt: LanguageModelV3Prompt;
   sendReasoning: boolean;
   warnings: SharedV3Warning[];
   cacheControlValidator?: CacheControlValidator;
   toolNameMapping: ToolNameMapping;
+  convertMediaPart?: AnthropicMediaPartConverter;
 
   /**
    * Maps custom tool names of toolset tools (e.g. the computer toolset) to
@@ -336,6 +349,15 @@ export async function convertToAnthropicMessagesPrompt({
                   }
 
                   case 'file': {
+                    const customContent = await convertMediaPart?.(part);
+                    if (customContent != null) {
+                      anthropicContent.push({
+                        ...customContent,
+                        cache_control: cacheControl,
+                      });
+                      break;
+                    }
+
                     if (part.mediaType.startsWith('image/')) {
                       anthropicContent.push({
                         type: 'image',

package/src/get-cache-control.ts

@@ -11,11 +11,18 @@ const MAX_CACHE_BREAKPOINTS = 4;
 // Allows both cacheControl and cache_control for flexibility
 function getCacheControl(
   providerMetadata: SharedV3ProviderMetadata | undefined,
+  providerOptionsName: string,
 ): AnthropicCacheControl | undefined {
+  const custom = providerMetadata?.[providerOptionsName];
   const anthropic = providerMetadata?.anthropic;
 
-  // allow both cacheControl and cache_control:
-  const cacheControlValue = anthropic?.cacheControl ?? anthropic?.cache_control;
+  // Prefer the configured namespace, retaining the canonical namespace as a fallback.
+  // Allow both cacheControl and cache_control.
+  const cacheControlValue =
+    custom?.cacheControl ??
+    custom?.cache_control ??
+    anthropic?.cacheControl ??
+    anthropic?.cache_control;
 
   // Pass through value assuming it is of the correct type.
   // The Anthropic API will validate the value.
@@ -26,11 +33,16 @@ export class CacheControlValidator {
   private breakpointCount = 0;
   private warnings: SharedV3Warning[] = [];
 
+  constructor(private readonly providerOptionsName = 'anthropic') {}
+
   getCacheControl(
     providerMetadata: SharedV3ProviderMetadata | undefined,
     context: { type: string; canCache: boolean },
   ): AnthropicCacheControl | undefined {
-    const cacheControlValue = getCacheControl(providerMetadata);
+    const cacheControlValue = getCacheControl(
+      providerMetadata,
+      this.providerOptionsName,
+    );
 
     if (!cacheControlValue) {
       return undefined;