@ai-sdk/anthropic 2.0.102 → 2.0.104

package/dist/internal/index.d.mts

@@ -2,7 +2,7 @@ import { LanguageModelV2, JSONSchema7, SharedV2ProviderMetadata, LanguageModelV2
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | '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-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | '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' | (string & {});
 
 type AnthropicMessagesConfig = {
     provider: string;
@@ -32,6 +32,36 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV2 {
     doGenerate(options: Parameters<LanguageModelV2['doGenerate']>[0]): Promise<Awaited<ReturnType<LanguageModelV2['doGenerate']>>>;
     doStream(options: Parameters<LanguageModelV2['doStream']>[0]): Promise<Awaited<ReturnType<LanguageModelV2['doStream']>>>;
 }
+/**
+ * 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;
+    rejectsSamplingParameters: boolean;
+    rejectsThinkingDisabledAboveHighEffort: boolean;
+    /**
+     * Thinking is always adaptive: `thinking.type` `disabled` and `enabled`
+     * are rejected with a 400.
+     */
+    rejectsThinkingDisabled: boolean;
+    /**
+     * Forced tool use (`tool_choice` `any` or a named tool) is rejected with a 400.
+     */
+    rejectsForcedToolUse: boolean;
+    isKnownModel: boolean;
+};
+
+/**
+ * Member tools of the computer toolset. Each member is returned by the API as
+ * its own `tool_use` block; the AI SDK exposes it as the `action` of a single
+ * computer tool call.
+ */
+declare const computerToolset_20260801Members: readonly ["screenshot", "zoom", "left_click", "right_click", "middle_click", "double_click", "triple_click", "left_click_drag", "mouse_move", "left_mouse_down", "left_mouse_up", "cursor_position", "scroll", "type", "key", "hold_key", "wait"];
+type ComputerToolset_20260801Member = (typeof computerToolset_20260801Members)[number];
 
 declare const anthropicTools: {
     /**
@@ -379,6 +409,46 @@ declare const anthropicTools: {
         displayHeightPx: number;
         displayNumber?: number;
     }>;
+    /**
+     * The computer toolset lets Claude control a computer through screenshots,
+     * mouse, and keyboard. It replaces the versioned computer tools
+     * (`computer_20250124` and earlier) on newer models.
+     *
+     * The API returns each computer action as its own `tool_use` block with
+     * `toolset_name: 'computer'`. The AI SDK maps every member call to this tool
+     * and exposes the member name as `action`, so `execute` receives the same
+     * input shape as the older computer tools. Claude may return several actions
+     * in one turn.
+     *
+     * Coordinates are always in the pixel space of the screenshots you return;
+     * there are no display size parameters. Zoom is enabled by default.
+     *
+     * Does not require a beta header.
+     *
+     * Tool name must be `computer`.
+     *
+     * Supported models: Claude Opus 5.5 (required; older computer tool types
+     * are rejected), Opus 5, Sonnet 5, Fable 5, Fable 5.1, Opus 4.8.
+     *
+     * @param configs - Per-member settings keyed by member name, e.g.
+     * `{ zoom: { enabled: false } }`. Omitted members keep their defaults.
+     */
+    computerToolset_20260801: _ai_sdk_provider_utils.ProviderDefinedToolFactory<{
+        action: ComputerToolset_20260801Member;
+        coordinate?: [number, number];
+        duration?: number;
+        region?: [number, number, number, number];
+        repeat?: number;
+        scroll_amount?: number;
+        scroll_direction?: "up" | "down" | "left" | "right";
+        start_coordinate?: [number, number];
+        text?: string;
+    }, {
+        configs?: Partial<Record<ComputerToolset_20260801Member, {
+            enabled?: boolean;
+            deferLoading?: 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,
@@ -634,6 +704,17 @@ type AnthropicTool = {
     display_height_px: number;
     display_number: number;
     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';
@@ -695,11 +776,17 @@ declare class CacheControlValidator {
     getWarnings(): LanguageModelV2CallWarning[];
 }
 
-declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, }: {
+declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, rejectsForcedToolUse, }: {
     tools: LanguageModelV2CallOptions['tools'];
     toolChoice?: LanguageModelV2CallOptions['toolChoice'];
     disableParallelToolUse?: boolean;
     cacheControlValidator?: CacheControlValidator;
+    /**
+     * Whether the model rejects forced tool use (`tool_choice` `any` or a
+     * named tool). When true, `required` and `tool` tool choices fall back to
+     * `auto` with a warning.
+     */
+    rejectsForcedToolUse?: boolean;
 }): Promise<{
     tools: Array<AnthropicTool> | undefined;
     toolChoice: AnthropicToolChoice | undefined;
@@ -716,4 +803,4 @@ declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cache
  */
 declare function sanitizeJsonSchema(schema: JSONSchema7): JSONSchema7;
 
-export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, prepareTools, sanitizeJsonSchema };
+export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, getModelCapabilities, prepareTools, sanitizeJsonSchema };

package/dist/internal/index.d.ts

@@ -2,7 +2,7 @@ import { LanguageModelV2, JSONSchema7, SharedV2ProviderMetadata, LanguageModelV2
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { Resolvable, FetchFunction } from '@ai-sdk/provider-utils';
 
-type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | '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-fable-5' | 'claude-fable-5-1' | 'claude-sonnet-5' | (string & {});
+type AnthropicMessagesModelId = 'claude-3-5-haiku-20241022' | 'claude-3-5-haiku-latest' | 'claude-3-7-sonnet-20250219' | 'claude-3-7-sonnet-latest' | 'claude-3-haiku-20240307' | 'claude-haiku-4-5-20251001' | 'claude-haiku-4-5' | 'claude-opus-4-0' | 'claude-opus-4-1-20250805' | 'claude-opus-4-1' | 'claude-opus-4-20250514' | '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' | (string & {});
 
 type AnthropicMessagesConfig = {
     provider: string;
@@ -32,6 +32,36 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV2 {
     doGenerate(options: Parameters<LanguageModelV2['doGenerate']>[0]): Promise<Awaited<ReturnType<LanguageModelV2['doGenerate']>>>;
     doStream(options: Parameters<LanguageModelV2['doStream']>[0]): Promise<Awaited<ReturnType<LanguageModelV2['doStream']>>>;
 }
+/**
+ * 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;
+    rejectsSamplingParameters: boolean;
+    rejectsThinkingDisabledAboveHighEffort: boolean;
+    /**
+     * Thinking is always adaptive: `thinking.type` `disabled` and `enabled`
+     * are rejected with a 400.
+     */
+    rejectsThinkingDisabled: boolean;
+    /**
+     * Forced tool use (`tool_choice` `any` or a named tool) is rejected with a 400.
+     */
+    rejectsForcedToolUse: boolean;
+    isKnownModel: boolean;
+};
+
+/**
+ * Member tools of the computer toolset. Each member is returned by the API as
+ * its own `tool_use` block; the AI SDK exposes it as the `action` of a single
+ * computer tool call.
+ */
+declare const computerToolset_20260801Members: readonly ["screenshot", "zoom", "left_click", "right_click", "middle_click", "double_click", "triple_click", "left_click_drag", "mouse_move", "left_mouse_down", "left_mouse_up", "cursor_position", "scroll", "type", "key", "hold_key", "wait"];
+type ComputerToolset_20260801Member = (typeof computerToolset_20260801Members)[number];
 
 declare const anthropicTools: {
     /**
@@ -379,6 +409,46 @@ declare const anthropicTools: {
         displayHeightPx: number;
         displayNumber?: number;
     }>;
+    /**
+     * The computer toolset lets Claude control a computer through screenshots,
+     * mouse, and keyboard. It replaces the versioned computer tools
+     * (`computer_20250124` and earlier) on newer models.
+     *
+     * The API returns each computer action as its own `tool_use` block with
+     * `toolset_name: 'computer'`. The AI SDK maps every member call to this tool
+     * and exposes the member name as `action`, so `execute` receives the same
+     * input shape as the older computer tools. Claude may return several actions
+     * in one turn.
+     *
+     * Coordinates are always in the pixel space of the screenshots you return;
+     * there are no display size parameters. Zoom is enabled by default.
+     *
+     * Does not require a beta header.
+     *
+     * Tool name must be `computer`.
+     *
+     * Supported models: Claude Opus 5.5 (required; older computer tool types
+     * are rejected), Opus 5, Sonnet 5, Fable 5, Fable 5.1, Opus 4.8.
+     *
+     * @param configs - Per-member settings keyed by member name, e.g.
+     * `{ zoom: { enabled: false } }`. Omitted members keep their defaults.
+     */
+    computerToolset_20260801: _ai_sdk_provider_utils.ProviderDefinedToolFactory<{
+        action: ComputerToolset_20260801Member;
+        coordinate?: [number, number];
+        duration?: number;
+        region?: [number, number, number, number];
+        repeat?: number;
+        scroll_amount?: number;
+        scroll_direction?: "up" | "down" | "left" | "right";
+        start_coordinate?: [number, number];
+        text?: string;
+    }, {
+        configs?: Partial<Record<ComputerToolset_20260801Member, {
+            enabled?: boolean;
+            deferLoading?: 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,
@@ -634,6 +704,17 @@ type AnthropicTool = {
     display_height_px: number;
     display_number: number;
     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';
@@ -695,11 +776,17 @@ declare class CacheControlValidator {
     getWarnings(): LanguageModelV2CallWarning[];
 }
 
-declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, }: {
+declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cacheControlValidator, rejectsForcedToolUse, }: {
     tools: LanguageModelV2CallOptions['tools'];
     toolChoice?: LanguageModelV2CallOptions['toolChoice'];
     disableParallelToolUse?: boolean;
     cacheControlValidator?: CacheControlValidator;
+    /**
+     * Whether the model rejects forced tool use (`tool_choice` `any` or a
+     * named tool). When true, `required` and `tool` tool choices fall back to
+     * `auto` with a warning.
+     */
+    rejectsForcedToolUse?: boolean;
 }): Promise<{
     tools: Array<AnthropicTool> | undefined;
     toolChoice: AnthropicToolChoice | undefined;
@@ -716,4 +803,4 @@ declare function prepareTools({ tools, toolChoice, disableParallelToolUse, cache
  */
 declare function sanitizeJsonSchema(schema: JSONSchema7): JSONSchema7;
 
-export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, prepareTools, sanitizeJsonSchema };
+export { AnthropicMessagesLanguageModel, type AnthropicMessagesModelId, anthropicTools, getModelCapabilities, prepareTools, sanitizeJsonSchema };