@ai-sdk/anthropic 3.0.76 → 3.0.77

package/dist/internal/index.d.mts

@@ -48,6 +48,60 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV3 {
 }
 
 declare const anthropicTools: {
+    /**
+     * Pairs a faster executor model with a higher-intelligence advisor model
+     * that provides strategic guidance mid-generation.
+     *
+     * The advisor lets a faster, lower-cost executor model consult a
+     * higher-intelligence advisor model server-side. The advisor reads the
+     * executor's full transcript and produces a plan or course correction;
+     * the executor continues with the task, informed by the advice. All of
+     * this happens inside a single `/v1/messages` request.
+     *
+     * Beta header `advisor-tool-2026-03-01` is added automatically when this
+     * tool is included.
+     *
+     * Multi-turn conversations: pass the full assistant content (including
+     * `advisor_tool_result` blocks) back to the API on subsequent turns. If
+     * you omit the advisor tool from `tools` on a follow-up turn while the
+     * message history still contains `advisor_tool_result` blocks, the API
+     * returns a `400 invalid_request_error`.
+     *
+     * Supported executor models: Claude Haiku 4.5, Sonnet 4.6, Opus 4.6,
+     * Opus 4.7. The advisor must be at least as capable as the executor.
+     *
+     * @param model - The advisor model ID (required), e.g. `"claude-opus-4-7"`.
+     * @param maxUses - Maximum advisor calls per request (per-request cap).
+     * @param caching - Enables prompt caching for the advisor's transcript
+     * across calls within a conversation. Worthwhile from ~3 advisor calls
+     * per conversation.
+     */
+    advisor_20260301: (args: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+        type: "advisor_result";
+        text: string;
+    } | {
+        type: "advisor_redacted_result";
+        encryptedContent: string;
+    } | {
+        type: "advisor_tool_result_error";
+        errorCode: string;
+    }, {
+        model: string;
+        maxUses?: number;
+        caching?: {
+            type: "ephemeral";
+            ttl: "5m" | "1h";
+        };
+    }>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+        type: "advisor_result";
+        text: string;
+    } | {
+        type: "advisor_redacted_result";
+        encryptedContent: string;
+    } | {
+        type: "advisor_tool_result_error";
+        errorCode: string;
+    }>;
     /**
      * The bash tool enables Claude to execute shell commands in a persistent bash session,
      * allowing system operations, script execution, and command-line automation.
@@ -926,6 +980,15 @@ type AnthropicTool = {
 } | {
     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';

package/dist/internal/index.d.ts

@@ -48,6 +48,60 @@ declare class AnthropicMessagesLanguageModel implements LanguageModelV3 {
 }
 
 declare const anthropicTools: {
+    /**
+     * Pairs a faster executor model with a higher-intelligence advisor model
+     * that provides strategic guidance mid-generation.
+     *
+     * The advisor lets a faster, lower-cost executor model consult a
+     * higher-intelligence advisor model server-side. The advisor reads the
+     * executor's full transcript and produces a plan or course correction;
+     * the executor continues with the task, informed by the advice. All of
+     * this happens inside a single `/v1/messages` request.
+     *
+     * Beta header `advisor-tool-2026-03-01` is added automatically when this
+     * tool is included.
+     *
+     * Multi-turn conversations: pass the full assistant content (including
+     * `advisor_tool_result` blocks) back to the API on subsequent turns. If
+     * you omit the advisor tool from `tools` on a follow-up turn while the
+     * message history still contains `advisor_tool_result` blocks, the API
+     * returns a `400 invalid_request_error`.
+     *
+     * Supported executor models: Claude Haiku 4.5, Sonnet 4.6, Opus 4.6,
+     * Opus 4.7. The advisor must be at least as capable as the executor.
+     *
+     * @param model - The advisor model ID (required), e.g. `"claude-opus-4-7"`.
+     * @param maxUses - Maximum advisor calls per request (per-request cap).
+     * @param caching - Enables prompt caching for the advisor's transcript
+     * across calls within a conversation. Worthwhile from ~3 advisor calls
+     * per conversation.
+     */
+    advisor_20260301: (args: Parameters<_ai_sdk_provider_utils.ProviderToolFactoryWithOutputSchema<{}, {
+        type: "advisor_result";
+        text: string;
+    } | {
+        type: "advisor_redacted_result";
+        encryptedContent: string;
+    } | {
+        type: "advisor_tool_result_error";
+        errorCode: string;
+    }, {
+        model: string;
+        maxUses?: number;
+        caching?: {
+            type: "ephemeral";
+            ttl: "5m" | "1h";
+        };
+    }>>[0]) => _ai_sdk_provider_utils.Tool<{}, {
+        type: "advisor_result";
+        text: string;
+    } | {
+        type: "advisor_redacted_result";
+        encryptedContent: string;
+    } | {
+        type: "advisor_tool_result_error";
+        errorCode: string;
+    }>;
     /**
      * The bash tool enables Claude to execute shell commands in a persistent bash session,
      * allowing system operations, script execution, and command-line automation.
@@ -926,6 +980,15 @@ type AnthropicTool = {
 } | {
     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';