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

package/CHANGELOG.md

@@ -1,5 +1,231 @@
 # @ai-sdk/anthropic
 
+## 4.0.0-beta.31
+
+### Patch Changes
+
+- Updated dependencies [083947b]
+  - @ai-sdk/provider-utils@5.0.0-beta.22
+
+## 4.0.0-beta.30
+
+### Patch Changes
+
+- 0d8f107: feat(provider/anthropic): add support for Opus 4.7 and relevant API enhancements
+
+## 4.0.0-beta.29
+
+### Patch Changes
+
+- Updated dependencies [add1126]
+  - @ai-sdk/provider-utils@5.0.0-beta.21
+
+## 4.0.0-beta.28
+
+### Patch Changes
+
+- b3976a2: Add workflow serialization support to all provider models.
+
+  **`@ai-sdk/provider-utils`:** New `serializeModel()` helper that extracts only serializable properties from a model instance, filtering out functions and objects containing functions. Third-party provider authors can use this to add workflow support to their own models.
+
+  **All providers:** `headers` is now optional in provider config types. This is non-breaking — existing code that passes `headers` continues to work. Custom provider implementations that construct model configs manually can now omit `headers`, which is useful when models are deserialized from a workflow step boundary where auth is provided separately.
+
+  All provider model classes now include `WORKFLOW_SERIALIZE` and `WORKFLOW_DESERIALIZE` static methods, enabling them to cross workflow step boundaries without serialization errors.
+
+- ff5eba1: feat: roll `image-*` tool output types into their equivalent `file-*` types
+- Updated dependencies [b3976a2]
+- Updated dependencies [ff5eba1]
+  - @ai-sdk/provider-utils@5.0.0-beta.20
+  - @ai-sdk/provider@4.0.0-beta.12
+
+## 4.0.0-beta.27
+
+### Major Changes
+
+- ef992f8: Remove CommonJS exports from all packages. All packages are now ESM-only (`"type": "module"`). Consumers using `require()` must switch to ESM `import` syntax.
+
+### Patch Changes
+
+- Updated dependencies [ef992f8]
+  - @ai-sdk/provider@4.0.0-beta.11
+  - @ai-sdk/provider-utils@5.0.0-beta.19
+
+## 4.0.0-beta.26
+
+### Patch Changes
+
+- 90e2d8a: chore: fix unused vars not being flagged by our lint tooling
+- Updated dependencies [90e2d8a]
+  - @ai-sdk/provider-utils@5.0.0-beta.18
+
+## 4.0.0-beta.25
+
+### Patch Changes
+
+- 09bd27b: feat (provider/anthropic): add support for inference_geo provider option
+
+## 4.0.0-beta.24
+
+### Patch Changes
+
+- Updated dependencies [3ae1786]
+  - @ai-sdk/provider-utils@5.0.0-beta.17
+
+## 4.0.0-beta.23
+
+### Patch Changes
+
+- Updated dependencies [176466a]
+  - @ai-sdk/provider@4.0.0-beta.10
+  - @ai-sdk/provider-utils@5.0.0-beta.16
+
+## 4.0.0-beta.22
+
+### Patch Changes
+
+- e311194: feat(ai): allow passing provider instance to `uploadFile` and `uploadSkill` as shorthand
+- Updated dependencies [e311194]
+  - @ai-sdk/provider@4.0.0-beta.9
+  - @ai-sdk/provider-utils@5.0.0-beta.15
+
+## 4.0.0-beta.21
+
+### Patch Changes
+
+- 34bd95d: feat(ai): add support for uploading provider skills using the provider references abstraction
+- Updated dependencies [34bd95d]
+- Updated dependencies [008271d]
+  - @ai-sdk/provider@4.0.0-beta.8
+  - @ai-sdk/provider-utils@5.0.0-beta.14
+
+## 4.0.0-beta.20
+
+### Patch Changes
+
+- Updated dependencies [b0c2869]
+- Updated dependencies [7e26e81]
+  - @ai-sdk/provider-utils@5.0.0-beta.13
+
+## 4.0.0-beta.19
+
+### Patch Changes
+
+- Updated dependencies [46d1149]
+  - @ai-sdk/provider-utils@5.0.0-beta.12
+
+## 4.0.0-beta.18
+
+### Patch Changes
+
+- 6fd51c0: fix(provider): preserve error type prefix in getErrorMessage
+- Updated dependencies [6fd51c0]
+  - @ai-sdk/provider-utils@5.0.0-beta.11
+  - @ai-sdk/provider@4.0.0-beta.7
+
+## 4.0.0-beta.17
+
+### Patch Changes
+
+- c29a26f: feat(provider): add support for provider references and uploading files as supported per provider
+- Updated dependencies [c29a26f]
+  - @ai-sdk/provider-utils@5.0.0-beta.10
+  - @ai-sdk/provider@4.0.0-beta.6
+
+## 4.0.0-beta.16
+
+### Patch Changes
+
+- 38fc777: Add AI Gateway hint to provider READMEs
+
+## 4.0.0-beta.15
+
+### Patch Changes
+
+- f57c702: fix(anthropic): allow both temperature and topP for non-Anthropic models using the Anthropic-compatible API
+
+  The temperature/topP mutual exclusivity check now only applies to known Anthropic models (model IDs starting with `claude-`). Non-Anthropic models using the Anthropic-compatible API (e.g. Minimax) can now send both parameters as required by their APIs.
+
+## 4.0.0-beta.14
+
+### Patch Changes
+
+- Updated dependencies [2e17091]
+  - @ai-sdk/provider-utils@5.0.0-beta.9
+
+## 4.0.0-beta.13
+
+### Patch Changes
+
+- Updated dependencies [986c6fd]
+- Updated dependencies [493295c]
+  - @ai-sdk/provider-utils@5.0.0-beta.8
+
+## 4.0.0-beta.12
+
+### Patch Changes
+
+- Updated dependencies [1f509d4]
+  - @ai-sdk/provider-utils@5.0.0-beta.7
+  - @ai-sdk/provider@4.0.0-beta.5
+
+## 4.0.0-beta.11
+
+### Patch Changes
+
+- 0ee8aec: feat (provider/anthropic): support passing metadata.user_id
+
+## 4.0.0-beta.10
+
+### Patch Changes
+
+- 3887c70: feat(provider): add new top-level reasoning parameter to spec and support it in `generateText` and `streamText`
+- Updated dependencies [3887c70]
+  - @ai-sdk/provider-utils@5.0.0-beta.6
+  - @ai-sdk/provider@4.0.0-beta.4
+
+## 4.0.0-beta.9
+
+### Patch Changes
+
+- Updated dependencies [776b617]
+  - @ai-sdk/provider-utils@5.0.0-beta.5
+  - @ai-sdk/provider@4.0.0-beta.3
+
+## 4.0.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+
+## 4.0.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [f7d4f01]
+  - @ai-sdk/provider-utils@5.0.0-beta.3
+  - @ai-sdk/provider@4.0.0-beta.2
+
+## 4.0.0-beta.6
+
+### Patch Changes
+
+- 21d1ee3: fix(anthropic): skip passing beta header for tool search tools
+
+## 4.0.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [5c2a5a2]
+  - @ai-sdk/provider@4.0.0-beta.1
+  - @ai-sdk/provider-utils@5.0.0-beta.2
+
+## 4.0.0-beta.4
+
+### Patch Changes
+
+- f05a40d: fix(vertex): throw warning when strict: true for vertexAnthropic
+
 ## 4.0.0-beta.3
 
 ### Patch Changes
@@ -446,13 +672,13 @@
   Before
 
   ```ts
-  model.textEmbeddingModel('my-model-id');
+  model.textEmbeddingModel("my-model-id");
   ```
 
   After
 
   ```ts
-  model.embeddingModel('my-model-id');
+  model.embeddingModel("my-model-id");
   ```
 
 - f33a018: chore: add model ID for Haiku 4.5
@@ -792,13 +1018,13 @@
   Before
 
   ```ts
-  model.textEmbeddingModel('my-model-id');
+  model.textEmbeddingModel("my-model-id");
   ```
 
   After
 
   ```ts
-  model.embeddingModel('my-model-id');
+  model.embeddingModel("my-model-id");
   ```
 
 - Updated dependencies [8d9e8ad]

package/README.md

@@ -2,6 +2,8 @@
 
 The **[Anthropic provider](https://ai-sdk.dev/providers/ai-sdk-providers/anthropic)** for the [AI SDK](https://ai-sdk.dev/docs) contains language model support for the [Anthropic Messages API](https://docs.anthropic.com/claude/reference/messages_post).
 
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access Anthropic (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
+
 ## Setup
 
 The Anthropic provider is available in the `@ai-sdk/anthropic` module. You can install it with

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JSONObject, ProviderV4, LanguageModelV4 } from '@ai-sdk/provider';
+import { JSONObject, ProviderV4, LanguageModelV4, FilesV4, SkillsV4 } from '@ai-sdk/provider';
 import { z } from 'zod/v4';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction } from '@ai-sdk/provider-utils';
@@ -128,7 +128,7 @@ interface AnthropicMessageMetadata {
     } | null;
 }
 
-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 & {});
 declare const anthropicLanguageModelOptions: z.ZodObject<{
     sendReasoning: z.ZodOptional<z.ZodBoolean>;
     structuredOutputMode: z.ZodOptional<z.ZodEnum<{
@@ -138,6 +138,10 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
     }>>;
     thinking: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"adaptive">;
+        display: z.ZodOptional<z.ZodEnum<{
+            omitted: "omitted";
+            summarized: "summarized";
+        }>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"enabled">;
         budgetTokens: z.ZodOptional<z.ZodNumber>;
@@ -149,6 +153,9 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
         type: z.ZodLiteral<"ephemeral">;
         ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
     }, z.core.$strip>>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        userId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     mcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
         type: z.ZodLiteral<"url">;
         name: z.ZodString;
@@ -161,23 +168,37 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
     }, z.core.$strip>>>;
     container: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
-        skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            type: z.ZodUnion<readonly [z.ZodLiteral<"anthropic">, z.ZodLiteral<"custom">]>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"anthropic">;
             skillId: z.ZodString;
             version: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"custom">;
+            providerReference: z.ZodRecord<z.ZodString, z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
     }, z.core.$strip>>;
     toolStreaming: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodOptional<z.ZodEnum<{
         low: "low";
         medium: "medium";
         high: "high";
+        xhigh: "xhigh";
         max: "max";
     }>>;
+    taskBudget: z.ZodOptional<z.ZodObject<{
+        type: z.ZodLiteral<"tokens">;
+        total: z.ZodNumber;
+        remaining: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
     speed: z.ZodOptional<z.ZodEnum<{
         fast: "fast";
         standard: "standard";
     }>>;
+    inferenceGeo: z.ZodOptional<z.ZodEnum<{
+        us: "us";
+        global: "global";
+    }>>;
     anthropicBeta: z.ZodOptional<z.ZodArray<z.ZodString>>;
     contextManagement: z.ZodOptional<z.ZodObject<{
         edits: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -234,7 +255,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.
@@ -244,7 +265,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
@@ -264,7 +285,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";
@@ -275,7 +296,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
@@ -348,7 +369,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;
     } | {
@@ -410,7 +431,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
@@ -494,7 +515,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;
     } | {
@@ -565,7 +586,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.
@@ -584,7 +605,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.
@@ -607,7 +628,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.
@@ -637,7 +658,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,
@@ -671,7 +692,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
@@ -688,7 +709,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
@@ -705,7 +726,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
@@ -724,7 +745,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
@@ -747,7 +768,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;
@@ -756,7 +777,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.
      *
@@ -796,7 +817,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";
@@ -818,7 +839,7 @@ declare const anthropicTools: {
             };
         };
         retrievedAt: string | null;
-    }>;
+    }, {}>;
     /**
      * Creates a web fetch tool that gives Claude direct access to real-time web content.
      *
@@ -858,7 +879,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";
@@ -880,7 +901,7 @@ declare const anthropicTools: {
             };
         };
         retrievedAt: string | null;
-    }>;
+    }, {}>;
     /**
      * Creates a web search tool that gives Claude direct access to real-time web content.
      *
@@ -908,7 +929,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";
@@ -916,7 +937,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.
      *
@@ -944,7 +965,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";
@@ -952,7 +973,7 @@ declare const anthropicTools: {
         title: string | null;
         pageAge: string | null;
         encryptedContent: string;
-    }[]>;
+    }[], {}>;
     /**
      * Creates a tool search tool that uses regex patterns to find tools.
      *
@@ -972,13 +993,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.
      *
@@ -998,13 +1019,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;
-    }[]>;
+    }[], {}>;
 };
 
 interface AnthropicProvider extends ProviderV4 {
@@ -1022,6 +1043,11 @@ interface AnthropicProvider extends ProviderV4 {
      * @deprecated Use `embeddingModel` instead.
      */
     textEmbeddingModel(modelId: string): never;
+    files(): FilesV4;
+    /**
+     * Returns a SkillsV4 interface for uploading skills to Anthropic.
+     */
+    skills(): SkillsV4;
     /**
      * Anthropic-specific computer use tool.
      */