@ai-sdk/anthropic 4.0.0-beta.3 → 4.0.0-beta.32

package/dist/internal/index.d.ts

@@ -1,13 +1,13 @@
-import { LanguageModelV4, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, JSONSchema7, SharedV4ProviderMetadata, SharedV4Warning } from '@ai-sdk/provider';
+import { LanguageModelV4, JSONObject, LanguageModelV4CallOptions, LanguageModelV4GenerateResult, LanguageModelV4StreamResult, JSONSchema7, SharedV4ProviderMetadata, SharedV4Warning } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
-import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
+import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE, Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-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' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-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' | (string & {});
 
 type AnthropicMessagesConfig = {
     provider: string;
     baseURL: string;
-    headers: Resolvable<Record<string, string | undefined>>;
+    headers?: Resolvable<Record<string, string | undefined>>;
     fetch?: FetchFunction;
     buildRequestUrl?: (baseURL: string, isStreaming: boolean) => string;
     transformRequestBody?: (args: Record<string, any>, betas: Set<string>) => Record<string, any>;
@@ -17,12 +17,25 @@ type AnthropicMessagesConfig = {
      * When false, the model will use JSON tool fallback for structured outputs.
      */
     supportsNativeStructuredOutput?: boolean;
+    /**
+     * When false, `strict` on tool definitions will be ignored and a warning emitted.
+     * Defaults to true.
+     */
+    supportsStrictTools?: boolean;
 };
 declare class AnthropicMessagesLanguageModel implements LanguageModelV4 {
     readonly specificationVersion = "v4";
     readonly modelId: AnthropicMessagesModelId;
     private readonly config;
     private readonly generateId;
+    static [WORKFLOW_SERIALIZE](model: AnthropicMessagesLanguageModel): {
+        modelId: string;
+        config: JSONObject;
+    };
+    static [WORKFLOW_DESERIALIZE](options: {
+        modelId: AnthropicMessagesModelId;
+        config: AnthropicMessagesConfig;
+    }): AnthropicMessagesLanguageModel;
     constructor(modelId: AnthropicMessagesModelId, config: AnthropicMessagesConfig);
     supportsUrl(url: URL): boolean;
     get provider(): string;
@@ -41,6 +54,20 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV4 {
     doGenerate(options: LanguageModelV4CallOptions): Promise<LanguageModelV4GenerateResult>;
     doStream(options: LanguageModelV4CallOptions): Promise<LanguageModelV4StreamResult>;
 }
+/**
+ * Returns the capabilities of a Claude model that are used for defaults and feature selection.
+ *
+ * @see https://docs.claude.com/en/docs/about-claude/models/overview#model-comparison-table
+ * @see https://platform.claude.com/docs/en/build-with-claude/structured-outputs
+ */
+declare function getModelCapabilities(modelId: string): {
+    maxOutputTokens: number;
+    supportsStructuredOutput: boolean;
+    supportsAdaptiveThinking: boolean;
+    rejectsSamplingParameters: boolean;
+    supportsXhighEffort: boolean;
+    isKnownModel: boolean;
+};
 
 declare const anthropicTools: {
     /**
@@ -52,7 +79,7 @@ declare const anthropicTools: {
     bash_20241022: _ai_sdk_provider_utils.ProviderToolFactory<{
         command: string;
         restart?: boolean;
-    }, {}>;
+    }, {}, {}>;
     /**
      * The bash tool enables Claude to execute shell commands in a persistent bash session,
      * allowing system operations, script execution, and command-line automation.
@@ -62,7 +89,7 @@ declare const anthropicTools: {
     bash_20250124: _ai_sdk_provider_utils.ProviderToolFactory<{
         command: string;
         restart?: boolean;
-    }, {}>;
+    }, {}, {}>;
     /**
      * Claude can analyze data, create visualizations, perform complex calculations,
      * run system commands, create and edit files, and process uploaded files directly within
@@ -82,7 +109,7 @@ declare const anthropicTools: {
             type: "code_execution_output";
             file_id: string;
         }>;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         code: string;
     }, {
         type: "code_execution_result";
@@ -93,7 +120,7 @@ declare const anthropicTools: {
             type: "code_execution_output";
             file_id: string;
         }>;
-    }>;
+    }, {}>;
     /**
      * Claude can analyze data, create visualizations, perform complex calculations,
      * run system commands, create and edit files, and process uploaded files directly within
@@ -166,7 +193,7 @@ declare const anthropicTools: {
         new_start: number | null;
         old_lines: number | null;
         old_start: number | null;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         type: "programmatic-tool-call";
         code: string;
     } | {
@@ -228,7 +255,7 @@ declare const anthropicTools: {
         new_start: number | null;
         old_lines: number | null;
         old_start: number | null;
-    }>;
+    }, {}>;
     /**
      * Claude can analyze data, create visualizations, perform complex calculations,
      * run system commands, create and edit files, and process uploaded files directly within
@@ -312,7 +339,7 @@ declare const anthropicTools: {
         new_start: number | null;
         old_lines: number | null;
         old_start: number | null;
-    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         type: "programmatic-tool-call";
         code: string;
     } | {
@@ -383,7 +410,7 @@ declare const anthropicTools: {
         new_start: number | null;
         old_lines: number | null;
         old_start: number | null;
-    }>;
+    }, {}>;
     /**
      * Claude can interact with computer environments through the computer use tool, which
      * provides screenshot capabilities and mouse/keyboard control for autonomous desktop interaction.
@@ -402,7 +429,7 @@ declare const anthropicTools: {
         displayWidthPx: number;
         displayHeightPx: number;
         displayNumber?: number;
-    }>;
+    }, {}>;
     /**
      * Claude can interact with computer environments through the computer use tool, which
      * provides screenshot capabilities and mouse/keyboard control for autonomous desktop interaction.
@@ -425,7 +452,7 @@ declare const anthropicTools: {
         displayWidthPx: number;
         displayHeightPx: number;
         displayNumber?: number;
-    }>;
+    }, {}>;
     /**
      * Claude can interact with computer environments through the computer use tool, which
      * provides screenshot capabilities and mouse/keyboard control for autonomous desktop interaction.
@@ -455,7 +482,7 @@ declare const anthropicTools: {
         displayHeightPx: number;
         displayNumber?: number;
         enableZoom?: boolean;
-    }>;
+    }, {}>;
     /**
      * The memory tool enables Claude to store and retrieve information across conversations through a memory file directory.
      * Claude can create, read, update, and delete files that persist between sessions,
@@ -489,7 +516,7 @@ declare const anthropicTools: {
         command: "rename";
         old_path: string;
         new_path: string;
-    }, {}>;
+    }, {}, {}>;
     /**
      * Claude can use an Anthropic-defined text editor tool to view and modify text files,
      * helping you debug, fix, and improve your code or other text documents. This allows Claude
@@ -506,7 +533,7 @@ declare const anthropicTools: {
         insert_text?: string;
         old_str?: string;
         view_range?: number[];
-    }, {}>;
+    }, {}, {}>;
     /**
      * Claude can use an Anthropic-defined text editor tool to view and modify text files,
      * helping you debug, fix, and improve your code or other text documents. This allows Claude
@@ -523,7 +550,7 @@ declare const anthropicTools: {
         insert_text?: string;
         old_str?: string;
         view_range?: number[];
-    }, {}>;
+    }, {}, {}>;
     /**
      * Claude can use an Anthropic-defined text editor tool to view and modify text files,
      * helping you debug, fix, and improve your code or other text documents. This allows Claude
@@ -542,7 +569,7 @@ declare const anthropicTools: {
         insert_text?: string;
         old_str?: string;
         view_range?: number[];
-    }, {}>;
+    }, {}, {}>;
     /**
      * Claude can use an Anthropic-defined text editor tool to view and modify text files,
      * helping you debug, fix, and improve your code or other text documents. This allows Claude
@@ -565,7 +592,7 @@ declare const anthropicTools: {
         view_range?: number[];
     }, {
         maxCharacters?: number;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         command: "view" | "create" | "str_replace" | "insert";
         path: string;
         file_text?: string;
@@ -574,7 +601,7 @@ declare const anthropicTools: {
         insert_text?: string;
         old_str?: string;
         view_range?: number[];
-    }, unknown>;
+    }, unknown, {}>;
     /**
      * Creates a web fetch tool that gives Claude direct access to real-time web content.
      *
@@ -614,7 +641,7 @@ declare const anthropicTools: {
             enabled: boolean;
         };
         maxContentTokens?: number;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         url: string;
     }, {
         type: "web_fetch_result";
@@ -636,7 +663,7 @@ declare const anthropicTools: {
             };
         };
         retrievedAt: string | null;
-    }>;
+    }, {}>;
     /**
      * Creates a web fetch tool that gives Claude direct access to real-time web content.
      *
@@ -676,7 +703,7 @@ declare const anthropicTools: {
             enabled: boolean;
         };
         maxContentTokens?: number;
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         url: string;
     }, {
         type: "web_fetch_result";
@@ -698,7 +725,7 @@ declare const anthropicTools: {
             };
         };
         retrievedAt: string | null;
-    }>;
+    }, {}>;
     /**
      * Creates a web search tool that gives Claude direct access to real-time web content.
      *
@@ -726,7 +753,7 @@ declare const anthropicTools: {
             country?: string;
             timezone?: string;
         };
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         query: string;
     }, {
         type: "web_search_result";
@@ -734,7 +761,7 @@ declare const anthropicTools: {
         title: string | null;
         pageAge: string | null;
         encryptedContent: string;
-    }[]>;
+    }[], {}>;
     /**
      * Creates a web search tool that gives Claude direct access to real-time web content.
      *
@@ -762,7 +789,7 @@ declare const anthropicTools: {
             country?: string;
             timezone?: string;
         };
-    }>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         query: string;
     }, {
         type: "web_search_result";
@@ -770,7 +797,7 @@ declare const anthropicTools: {
         title: string | null;
         pageAge: string | null;
         encryptedContent: string;
-    }[]>;
+    }[], {}>;
     /**
      * Creates a tool search tool that uses regex patterns to find tools.
      *
@@ -790,13 +817,13 @@ declare const anthropicTools: {
     }, {
         type: "tool_reference";
         toolName: string;
-    }[], {}>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }[], {}, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         pattern: string;
         limit?: number;
     }, {
         type: "tool_reference";
         toolName: string;
-    }[]>;
+    }[], {}>;
     /**
      * Creates a tool search tool that uses BM25 (natural language) to find tools.
      *
@@ -816,13 +843,13 @@ declare const anthropicTools: {
     }, {
         type: "tool_reference";
         toolName: string;
-    }[], {}>>[0]) => _ai_sdk_provider_utils.Tool<{
+    }[], {}, {}>>[0]) => _ai_sdk_provider_utils.Tool<{
         query: string;
         limit?: number;
     }, {
         type: "tool_reference";
         toolName: string;
-    }[]>;
+    }[], {}>;
 };
 
 type AnthropicCacheControl = {
@@ -941,15 +968,24 @@ declare class CacheControlValidator {
     getWarnings(): SharedV4Warning[];
 }
 
-declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, }: {
+declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, supportsStructuredOutput, supportsStrictTools, defaultEagerInputStreaming, }: {
     tools: LanguageModelV4CallOptions['tools'];
     toolChoice: LanguageModelV4CallOptions['toolChoice'] | undefined;
     disableParallelToolUse?: boolean;
     cacheControlValidator?: CacheControlValidator;
     /**
-     * Whether the model supports structured output.
+     * Whether the model supports native structured output response format.
      */
     supportsStructuredOutput: boolean;
+    /**
+     * Whether the model supports strict mode on tool definitions.
+     */
+    supportsStrictTools: boolean;
+    /**
+     * Default for `eager_input_streaming` on function tools that do not set
+     * it explicitly. Driven by the model-level `toolStreaming` option.
+     */
+    defaultEagerInputStreaming?: boolean;
 }): Promise<{
     tools: Array<AnthropicTool> | undefined;
     toolChoice: AnthropicToolChoice | undefined;
@@ -957,4 +993,4 @@ declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cache
     betas: Set<string>;
 }>;
 
-export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, prepareTools };
+export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, getModelCapabilities, prepareTools };