@ai-sdk/anthropic 3.0.133 → 3.0.134

package/dist/internal/index.d.mts

@@ -1,15 +1,189 @@
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, JSONSchema7, SharedV3ProviderMetadata, SharedV3Warning } from '@ai-sdk/provider';
+import { JSONSchema7, SharedV3ProviderMetadata, SharedV3Warning, LanguageModelV3FilePart, LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
 type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-haiku-5-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-sonnet-5-5' | (string & {});
 
+type AnthropicCacheControl = {
+    type: 'ephemeral';
+    ttl?: '5m' | '1h';
+};
+type AnthropicContentSource = {
+    type: 'base64';
+    media_type: string;
+    data: string;
+} | {
+    type: 'url';
+    url: string;
+} | {
+    type: 'text';
+    media_type: 'text/plain';
+    data: string;
+};
+interface AnthropicImageContent {
+    type: 'image';
+    source: AnthropicContentSource;
+    cache_control: AnthropicCacheControl | undefined;
+}
+/** Video blocks supplied by compatible providers through custom media conversion. */
+interface AnthropicVideoContent {
+    type: 'video';
+    source: AnthropicContentSource;
+    cache_control: AnthropicCacheControl | undefined;
+}
+type AnthropicTool = {
+    name: string;
+    description: string | undefined;
+    input_schema: JSONSchema7;
+    cache_control: AnthropicCacheControl | undefined;
+    eager_input_streaming?: boolean;
+    strict?: boolean;
+    /**
+     * When true, this tool is deferred and will only be loaded when
+     * discovered via the tool search tool.
+     */
+    defer_loading?: boolean;
+    /**
+     * Programmatic tool calling: specifies which server-executed tools
+     * are allowed to call this tool. When set, only the specified callers
+     * can invoke this tool programmatically.
+     *
+     * @example ['code_execution_20250825']
+     */
+    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+} | {
+    type: 'code_execution_20250522';
+    name: string;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'code_execution_20250825';
+    name: string;
+} | {
+    type: 'code_execution_20260120';
+    name: string;
+} | {
+    name: string;
+    type: 'computer_20250124' | 'computer_20241022';
+    display_width_px: number;
+    display_height_px: number;
+    display_number: number;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'computer_20251124';
+    display_width_px: number;
+    display_height_px: number;
+    display_number: number;
+    enable_zoom?: boolean;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    /**
+     * Computer toolset. Declared without a `name`; the API returns member
+     * tool calls (e.g. `left_click`) with `toolset_name: 'computer'`.
+     */
+    type: 'computer_toolset_20260801';
+    configs?: Record<string, {
+        enabled?: boolean;
+        defer_loading?: boolean;
+    }>;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'text_editor_20250124' | 'text_editor_20241022' | 'text_editor_20250429';
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'text_editor_20250728';
+    max_characters?: number;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'bash_20250124' | 'bash_20241022';
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'memory_20250818';
+} | {
+    type: 'web_fetch_20250910' | 'web_fetch_20260209';
+    name: string;
+    max_uses?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    citations?: {
+        enabled: boolean;
+    };
+    max_content_tokens?: number;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'web_search_20250305' | 'web_search_20260209';
+    name: string;
+    max_uses?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    user_location?: {
+        type: 'approximate';
+        city?: string;
+        region?: string;
+        country?: string;
+        timezone?: string;
+    };
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'tool_search_tool_regex_20251119';
+    name: string;
+} | {
+    type: 'tool_search_tool_bm25_20251119';
+    name: string;
+} | {
+    type: 'advisor_20260301';
+    name: 'advisor';
+    model: string;
+    max_uses?: number;
+    caching?: {
+        type: 'ephemeral';
+        ttl: '5m' | '1h';
+    };
+};
+type AnthropicToolChoice = {
+    type: 'auto' | 'any';
+    disable_parallel_tool_use?: boolean;
+} | {
+    type: 'none';
+} | {
+    type: 'tool';
+    name: string;
+    disable_parallel_tool_use?: boolean;
+};
+
+declare class CacheControlValidator {
+    private readonly providerOptionsName;
+    private breakpointCount;
+    private warnings;
+    constructor(providerOptionsName?: string);
+    getCacheControl(providerMetadata: SharedV3ProviderMetadata | undefined, context: {
+        type: string;
+        canCache: boolean;
+    }): AnthropicCacheControl | undefined;
+    getWarnings(): SharedV3Warning[];
+}
+
+/** Return undefined to use the default file conversion. */
+type AnthropicMediaPartConverter = (part: LanguageModelV3FilePart) => PromiseLike<Omit<AnthropicImageContent | AnthropicVideoContent, 'cache_control'> | undefined>;
+
 type AnthropicMessagesConfig = {
     provider: string;
     baseURL: string;
     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>) => Record<string, any>;
     supportedUrls?: () => LanguageModelV3['supportedUrls'];
     generateId?: () => string;
@@ -962,144 +1136,6 @@ declare const anthropicTools: {
     }[]>;
 };
 
-type AnthropicCacheControl = {
-    type: 'ephemeral';
-    ttl?: '5m' | '1h';
-};
-type AnthropicTool = {
-    name: string;
-    description: string | undefined;
-    input_schema: JSONSchema7;
-    cache_control: AnthropicCacheControl | undefined;
-    eager_input_streaming?: boolean;
-    strict?: boolean;
-    /**
-     * When true, this tool is deferred and will only be loaded when
-     * discovered via the tool search tool.
-     */
-    defer_loading?: boolean;
-    /**
-     * Programmatic tool calling: specifies which server-executed tools
-     * are allowed to call this tool. When set, only the specified callers
-     * can invoke this tool programmatically.
-     *
-     * @example ['code_execution_20250825']
-     */
-    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
-} | {
-    type: 'code_execution_20250522';
-    name: string;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    type: 'code_execution_20250825';
-    name: string;
-} | {
-    type: 'code_execution_20260120';
-    name: string;
-} | {
-    name: string;
-    type: 'computer_20250124' | 'computer_20241022';
-    display_width_px: number;
-    display_height_px: number;
-    display_number: number;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'computer_20251124';
-    display_width_px: number;
-    display_height_px: number;
-    display_number: number;
-    enable_zoom?: boolean;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    /**
-     * Computer toolset. Declared without a `name`; the API returns member
-     * tool calls (e.g. `left_click`) with `toolset_name: 'computer'`.
-     */
-    type: 'computer_toolset_20260801';
-    configs?: Record<string, {
-        enabled?: boolean;
-        defer_loading?: boolean;
-    }>;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'text_editor_20250124' | 'text_editor_20241022' | 'text_editor_20250429';
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'text_editor_20250728';
-    max_characters?: number;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'bash_20250124' | 'bash_20241022';
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'memory_20250818';
-} | {
-    type: 'web_fetch_20250910' | 'web_fetch_20260209';
-    name: string;
-    max_uses?: number;
-    allowed_domains?: string[];
-    blocked_domains?: string[];
-    citations?: {
-        enabled: boolean;
-    };
-    max_content_tokens?: number;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    type: 'web_search_20250305' | 'web_search_20260209';
-    name: string;
-    max_uses?: number;
-    allowed_domains?: string[];
-    blocked_domains?: string[];
-    user_location?: {
-        type: 'approximate';
-        city?: string;
-        region?: string;
-        country?: string;
-        timezone?: string;
-    };
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    type: 'tool_search_tool_regex_20251119';
-    name: string;
-} | {
-    type: 'tool_search_tool_bm25_20251119';
-    name: string;
-} | {
-    type: 'advisor_20260301';
-    name: 'advisor';
-    model: string;
-    max_uses?: number;
-    caching?: {
-        type: 'ephemeral';
-        ttl: '5m' | '1h';
-    };
-};
-type AnthropicToolChoice = {
-    type: 'auto' | 'any';
-    disable_parallel_tool_use?: boolean;
-} | {
-    type: 'none';
-} | {
-    type: 'tool';
-    name: string;
-    disable_parallel_tool_use?: boolean;
-};
-
-declare class CacheControlValidator {
-    private breakpointCount;
-    private warnings;
-    getCacheControl(providerMetadata: SharedV3ProviderMetadata | undefined, context: {
-        type: string;
-        canCache: boolean;
-    }): AnthropicCacheControl | undefined;
-    getWarnings(): SharedV3Warning[];
-}
-
 declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, supportsStrictTools, defaultEagerInputStreaming, rejectsForcedToolUse, }: {
     tools: LanguageModelV3CallOptions['tools'];
     toolChoice: LanguageModelV3CallOptions['toolChoice'] | undefined;

package/dist/internal/index.d.ts

@@ -1,15 +1,189 @@
-import { LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult, JSONSchema7, SharedV3ProviderMetadata, SharedV3Warning } from '@ai-sdk/provider';
+import { JSONSchema7, SharedV3ProviderMetadata, SharedV3Warning, LanguageModelV3FilePart, LanguageModelV3, LanguageModelV3CallOptions, LanguageModelV3GenerateResult, LanguageModelV3StreamResult } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
 type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-haiku-5-5' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-sonnet-4-5' | 'claude-sonnet-4-6' | 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-opus-5' | 'claude-opus-5-5' | 'claude-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | 'claude-sonnet-5-5' | (string & {});
 
+type AnthropicCacheControl = {
+    type: 'ephemeral';
+    ttl?: '5m' | '1h';
+};
+type AnthropicContentSource = {
+    type: 'base64';
+    media_type: string;
+    data: string;
+} | {
+    type: 'url';
+    url: string;
+} | {
+    type: 'text';
+    media_type: 'text/plain';
+    data: string;
+};
+interface AnthropicImageContent {
+    type: 'image';
+    source: AnthropicContentSource;
+    cache_control: AnthropicCacheControl | undefined;
+}
+/** Video blocks supplied by compatible providers through custom media conversion. */
+interface AnthropicVideoContent {
+    type: 'video';
+    source: AnthropicContentSource;
+    cache_control: AnthropicCacheControl | undefined;
+}
+type AnthropicTool = {
+    name: string;
+    description: string | undefined;
+    input_schema: JSONSchema7;
+    cache_control: AnthropicCacheControl | undefined;
+    eager_input_streaming?: boolean;
+    strict?: boolean;
+    /**
+     * When true, this tool is deferred and will only be loaded when
+     * discovered via the tool search tool.
+     */
+    defer_loading?: boolean;
+    /**
+     * Programmatic tool calling: specifies which server-executed tools
+     * are allowed to call this tool. When set, only the specified callers
+     * can invoke this tool programmatically.
+     *
+     * @example ['code_execution_20250825']
+     */
+    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
+} | {
+    type: 'code_execution_20250522';
+    name: string;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'code_execution_20250825';
+    name: string;
+} | {
+    type: 'code_execution_20260120';
+    name: string;
+} | {
+    name: string;
+    type: 'computer_20250124' | 'computer_20241022';
+    display_width_px: number;
+    display_height_px: number;
+    display_number: number;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'computer_20251124';
+    display_width_px: number;
+    display_height_px: number;
+    display_number: number;
+    enable_zoom?: boolean;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    /**
+     * Computer toolset. Declared without a `name`; the API returns member
+     * tool calls (e.g. `left_click`) with `toolset_name: 'computer'`.
+     */
+    type: 'computer_toolset_20260801';
+    configs?: Record<string, {
+        enabled?: boolean;
+        defer_loading?: boolean;
+    }>;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'text_editor_20250124' | 'text_editor_20241022' | 'text_editor_20250429';
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'text_editor_20250728';
+    max_characters?: number;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'bash_20250124' | 'bash_20241022';
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    name: string;
+    type: 'memory_20250818';
+} | {
+    type: 'web_fetch_20250910' | 'web_fetch_20260209';
+    name: string;
+    max_uses?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    citations?: {
+        enabled: boolean;
+    };
+    max_content_tokens?: number;
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'web_search_20250305' | 'web_search_20260209';
+    name: string;
+    max_uses?: number;
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+    user_location?: {
+        type: 'approximate';
+        city?: string;
+        region?: string;
+        country?: string;
+        timezone?: string;
+    };
+    cache_control: AnthropicCacheControl | undefined;
+} | {
+    type: 'tool_search_tool_regex_20251119';
+    name: string;
+} | {
+    type: 'tool_search_tool_bm25_20251119';
+    name: string;
+} | {
+    type: 'advisor_20260301';
+    name: 'advisor';
+    model: string;
+    max_uses?: number;
+    caching?: {
+        type: 'ephemeral';
+        ttl: '5m' | '1h';
+    };
+};
+type AnthropicToolChoice = {
+    type: 'auto' | 'any';
+    disable_parallel_tool_use?: boolean;
+} | {
+    type: 'none';
+} | {
+    type: 'tool';
+    name: string;
+    disable_parallel_tool_use?: boolean;
+};
+
+declare class CacheControlValidator {
+    private readonly providerOptionsName;
+    private breakpointCount;
+    private warnings;
+    constructor(providerOptionsName?: string);
+    getCacheControl(providerMetadata: SharedV3ProviderMetadata | undefined, context: {
+        type: string;
+        canCache: boolean;
+    }): AnthropicCacheControl | undefined;
+    getWarnings(): SharedV3Warning[];
+}
+
+/** Return undefined to use the default file conversion. */
+type AnthropicMediaPartConverter = (part: LanguageModelV3FilePart) => PromiseLike<Omit<AnthropicImageContent | AnthropicVideoContent, 'cache_control'> | undefined>;
+
 type AnthropicMessagesConfig = {
     provider: string;
     baseURL: string;
     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>) => Record<string, any>;
     supportedUrls?: () => LanguageModelV3['supportedUrls'];
     generateId?: () => string;
@@ -962,144 +1136,6 @@ declare const anthropicTools: {
     }[]>;
 };
 
-type AnthropicCacheControl = {
-    type: 'ephemeral';
-    ttl?: '5m' | '1h';
-};
-type AnthropicTool = {
-    name: string;
-    description: string | undefined;
-    input_schema: JSONSchema7;
-    cache_control: AnthropicCacheControl | undefined;
-    eager_input_streaming?: boolean;
-    strict?: boolean;
-    /**
-     * When true, this tool is deferred and will only be loaded when
-     * discovered via the tool search tool.
-     */
-    defer_loading?: boolean;
-    /**
-     * Programmatic tool calling: specifies which server-executed tools
-     * are allowed to call this tool. When set, only the specified callers
-     * can invoke this tool programmatically.
-     *
-     * @example ['code_execution_20250825']
-     */
-    allowed_callers?: Array<'direct' | 'code_execution_20250825' | 'code_execution_20260120'>;
-} | {
-    type: 'code_execution_20250522';
-    name: string;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    type: 'code_execution_20250825';
-    name: string;
-} | {
-    type: 'code_execution_20260120';
-    name: string;
-} | {
-    name: string;
-    type: 'computer_20250124' | 'computer_20241022';
-    display_width_px: number;
-    display_height_px: number;
-    display_number: number;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'computer_20251124';
-    display_width_px: number;
-    display_height_px: number;
-    display_number: number;
-    enable_zoom?: boolean;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    /**
-     * Computer toolset. Declared without a `name`; the API returns member
-     * tool calls (e.g. `left_click`) with `toolset_name: 'computer'`.
-     */
-    type: 'computer_toolset_20260801';
-    configs?: Record<string, {
-        enabled?: boolean;
-        defer_loading?: boolean;
-    }>;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'text_editor_20250124' | 'text_editor_20241022' | 'text_editor_20250429';
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'text_editor_20250728';
-    max_characters?: number;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'bash_20250124' | 'bash_20241022';
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    name: string;
-    type: 'memory_20250818';
-} | {
-    type: 'web_fetch_20250910' | 'web_fetch_20260209';
-    name: string;
-    max_uses?: number;
-    allowed_domains?: string[];
-    blocked_domains?: string[];
-    citations?: {
-        enabled: boolean;
-    };
-    max_content_tokens?: number;
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    type: 'web_search_20250305' | 'web_search_20260209';
-    name: string;
-    max_uses?: number;
-    allowed_domains?: string[];
-    blocked_domains?: string[];
-    user_location?: {
-        type: 'approximate';
-        city?: string;
-        region?: string;
-        country?: string;
-        timezone?: string;
-    };
-    cache_control: AnthropicCacheControl | undefined;
-} | {
-    type: 'tool_search_tool_regex_20251119';
-    name: string;
-} | {
-    type: 'tool_search_tool_bm25_20251119';
-    name: string;
-} | {
-    type: 'advisor_20260301';
-    name: 'advisor';
-    model: string;
-    max_uses?: number;
-    caching?: {
-        type: 'ephemeral';
-        ttl: '5m' | '1h';
-    };
-};
-type AnthropicToolChoice = {
-    type: 'auto' | 'any';
-    disable_parallel_tool_use?: boolean;
-} | {
-    type: 'none';
-} | {
-    type: 'tool';
-    name: string;
-    disable_parallel_tool_use?: boolean;
-};
-
-declare class CacheControlValidator {
-    private breakpointCount;
-    private warnings;
-    getCacheControl(providerMetadata: SharedV3ProviderMetadata | undefined, context: {
-        type: string;
-        canCache: boolean;
-    }): AnthropicCacheControl | undefined;
-    getWarnings(): SharedV3Warning[];
-}
-
 declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, supportsStrictTools, defaultEagerInputStreaming, rejectsForcedToolUse, }: {
     tools: LanguageModelV3CallOptions['tools'];
     toolChoice: LanguageModelV3CallOptions['toolChoice'] | undefined;