feat(api): Add beta advisor tool

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 72
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-2803e5a61e6baf09a06c02861b3891a45ecf093b7364946a101bee3ab63f002f.yml
-openapi_spec_hash: 24c3be07d605d11323afa51c7808fa00
-config_hash: e5581931b467b1d7bae9fee74aeb8bff
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-d87d3ef6f636c667a0256be82cebef0699d17403d409c26ec15813683cfc3263.yml
+openapi_spec_hash: d849fdf2c4dd6631a60c4340e9bc1322
+config_hash: 062be10c6bf39b6719b3a5ea2bf758b3

api.md

@@ -292,6 +292,16 @@ Types:
 
 ```python
 from anthropic.types.beta import (
+    BetaAdvisorMessageIterationUsage,
+    BetaAdvisorRedactedResultBlock,
+    BetaAdvisorRedactedResultBlockParam,
+    BetaAdvisorResultBlock,
+    BetaAdvisorResultBlockParam,
+    BetaAdvisorTool20260301,
+    BetaAdvisorToolResultBlock,
+    BetaAdvisorToolResultBlockParam,
+    BetaAdvisorToolResultError,
+    BetaAdvisorToolResultErrorParam,
     BetaAllThinkingTurns,
     BetaBase64ImageSource,
     BetaBase64PDFSource,

src/anthropic/types/anthropic_beta_param.py

@@ -31,5 +31,6 @@
         "skills-2025-10-02",
         "fast-mode-2026-02-01",
         "output-300k-2026-03-24",
+        "advisor-tool-2026-03-01",
     ],
 ]

src/anthropic/types/beta/__init__.py

@@ -81,6 +81,7 @@
 from .beta_text_citation_param import BetaTextCitationParam as BetaTextCitationParam
 from .beta_thinking_capability import BetaThinkingCapability as BetaThinkingCapability
 from .beta_user_location_param import BetaUserLocationParam as BetaUserLocationParam
+from .beta_advisor_result_block import BetaAdvisorResultBlock as BetaAdvisorResultBlock
 from .beta_managed_agents_agent import BetaManagedAgentsAgent as BetaManagedAgentsAgent
 from .beta_managed_agents_model import BetaManagedAgentsModel as BetaManagedAgentsModel
 from .beta_managed_agents_vault import BetaManagedAgentsVault as BetaManagedAgentsVault
@@ -133,8 +134,11 @@
 from .beta_server_tool_caller_param import BetaServerToolCallerParam as BetaServerToolCallerParam
 from .beta_tool_bash_20241022_param import BetaToolBash20241022Param as BetaToolBash20241022Param
 from .beta_tool_bash_20250124_param import BetaToolBash20250124Param as BetaToolBash20250124Param
+from .beta_advisor_tool_result_block import BetaAdvisorToolResultBlock as BetaAdvisorToolResultBlock
+from .beta_advisor_tool_result_error import BetaAdvisorToolResultError as BetaAdvisorToolResultError
 from .beta_base64_image_source_param import BetaBase64ImageSourceParam as BetaBase64ImageSourceParam
 from .beta_search_result_block_param import BetaSearchResultBlockParam as BetaSearchResultBlockParam
+from .beta_advisor_result_block_param import BetaAdvisorResultBlockParam as BetaAdvisorResultBlockParam
 from .beta_compaction_iteration_usage import BetaCompactionIterationUsage as BetaCompactionIterationUsage
 from .beta_content_block_source_param import BetaContentBlockSourceParam as BetaContentBlockSourceParam
 from .beta_file_document_source_param import BetaFileDocumentSourceParam as BetaFileDocumentSourceParam
@@ -145,6 +149,7 @@
 from .beta_memory_tool_20250818_param import BetaMemoryTool20250818Param as BetaMemoryTool20250818Param
 from .beta_tool_reference_block_param import BetaToolReferenceBlockParam as BetaToolReferenceBlockParam
 from .beta_unrestricted_network_param import BetaUnrestrictedNetworkParam as BetaUnrestrictedNetworkParam
+from .beta_advisor_tool_20260301_param import BetaAdvisorTool20260301Param as BetaAdvisorTool20260301Param
 from .beta_code_execution_output_block import BetaCodeExecutionOutputBlock as BetaCodeExecutionOutputBlock
 from .beta_code_execution_result_block import BetaCodeExecutionResultBlock as BetaCodeExecutionResultBlock
 from .beta_compact_20260112_edit_param import BetaCompact20260112EditParam as BetaCompact20260112EditParam
@@ -169,6 +174,7 @@
 from .beta_request_document_block_param import BetaRequestDocumentBlockParam as BetaRequestDocumentBlockParam
 from .beta_web_search_tool_result_block import BetaWebSearchToolResultBlock as BetaWebSearchToolResultBlock
 from .beta_web_search_tool_result_error import BetaWebSearchToolResultError as BetaWebSearchToolResultError
+from .beta_advisor_redacted_result_block import BetaAdvisorRedactedResultBlock as BetaAdvisorRedactedResultBlock
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam as BetaCacheControlEphemeralParam
 from .beta_context_management_capability import BetaContextManagementCapability as BetaContextManagementCapability
 from .beta_mcp_tool_default_config_param import BetaMCPToolDefaultConfigParam as BetaMCPToolDefaultConfigParam
@@ -192,6 +198,9 @@
 from .beta_thinking_config_disabled_param import BetaThinkingConfigDisabledParam as BetaThinkingConfigDisabledParam
 from .beta_web_search_tool_20250305_param import BetaWebSearchTool20250305Param as BetaWebSearchTool20250305Param
 from .beta_web_search_tool_20260209_param import BetaWebSearchTool20260209Param as BetaWebSearchTool20260209Param
+from .beta_advisor_message_iteration_usage import BetaAdvisorMessageIterationUsage as BetaAdvisorMessageIterationUsage
+from .beta_advisor_tool_result_block_param import BetaAdvisorToolResultBlockParam as BetaAdvisorToolResultBlockParam
+from .beta_advisor_tool_result_error_param import BetaAdvisorToolResultErrorParam as BetaAdvisorToolResultErrorParam
 from .beta_citation_content_block_location import BetaCitationContentBlockLocation as BetaCitationContentBlockLocation
 from .beta_citation_search_result_location import BetaCitationSearchResultLocation as BetaCitationSearchResultLocation
 from .beta_context_management_config_param import BetaContextManagementConfigParam as BetaContextManagementConfigParam
@@ -258,6 +267,9 @@
 from .beta_web_search_tool_result_block_param import (
     BetaWebSearchToolResultBlockParam as BetaWebSearchToolResultBlockParam,
 )
+from .beta_advisor_redacted_result_block_param import (
+    BetaAdvisorRedactedResultBlockParam as BetaAdvisorRedactedResultBlockParam,
+)
 from .beta_clear_tool_uses_20250919_edit_param import (
     BetaClearToolUses20250919EditParam as BetaClearToolUses20250919EditParam,
 )

src/anthropic/types/beta/beta_advisor_message_iteration_usage.py

@@ -0,0 +1,39 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..model import Model
+from ..._models import BaseModel
+from .beta_cache_creation import BetaCacheCreation
+
+__all__ = ["BetaAdvisorMessageIterationUsage"]
+
+
+class BetaAdvisorMessageIterationUsage(BaseModel):
+    """Token usage for an advisor sub-inference iteration."""
+
+    cache_creation: Optional[BetaCacheCreation] = None
+    """Breakdown of cached tokens by TTL"""
+
+    cache_creation_input_tokens: int
+    """The number of input tokens used to create the cache entry."""
+
+    cache_read_input_tokens: int
+    """The number of input tokens read from the cache."""
+
+    input_tokens: int
+    """The number of input tokens which were used."""
+
+    model: Model
+    """
+    The model that will complete your prompt.\n\nSee
+    [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+    details and options.
+    """
+
+    output_tokens: int
+    """The number of output tokens which were used."""
+
+    type: Literal["advisor_message"]
+    """Usage for an advisor sub-inference iteration"""

src/anthropic/types/beta/beta_advisor_redacted_result_block.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaAdvisorRedactedResultBlock"]
+
+
+class BetaAdvisorRedactedResultBlock(BaseModel):
+    encrypted_content: str
+    """Opaque blob containing the advisor's output.
+
+    Round-trip verbatim; do not inspect or modify.
+    """
+
+    type: Literal["advisor_redacted_result"]

src/anthropic/types/beta/beta_advisor_redacted_result_block_param.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["BetaAdvisorRedactedResultBlockParam"]
+
+
+class BetaAdvisorRedactedResultBlockParam(TypedDict, total=False):
+    encrypted_content: Required[str]
+    """Opaque blob produced by a prior response; must be round-tripped verbatim."""
+
+    type: Required[Literal["advisor_redacted_result"]]

src/anthropic/types/beta/beta_advisor_result_block.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaAdvisorResultBlock"]
+
+
+class BetaAdvisorResultBlock(BaseModel):
+    text: str
+
+    type: Literal["advisor_result"]

src/anthropic/types/beta/beta_advisor_result_block_param.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["BetaAdvisorResultBlockParam"]
+
+
+class BetaAdvisorResultBlockParam(TypedDict, total=False):
+    text: Required[str]
+
+    type: Required[Literal["advisor_result"]]

src/anthropic/types/beta/beta_advisor_tool_20260301_param.py

@@ -0,0 +1,53 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from ..model_param import ModelParam
+from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+
+__all__ = ["BetaAdvisorTool20260301Param"]
+
+
+class BetaAdvisorTool20260301Param(TypedDict, total=False):
+    model: Required[ModelParam]
+    """
+    The model that will complete your prompt.\n\nSee
+    [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+    details and options.
+    """
+
+    name: Required[Literal["advisor"]]
+    """Name of the tool.
+
+    This is how the tool will be called by the model and in `tool_use` blocks.
+    """
+
+    type: Required[Literal["advisor_20260301"]]
+
+    allowed_callers: List[Literal["direct", "code_execution_20250825", "code_execution_20260120"]]
+
+    cache_control: Optional[BetaCacheControlEphemeralParam]
+    """Create a cache control breakpoint at this content block."""
+
+    caching: Optional[BetaCacheControlEphemeralParam]
+    """Caching for the advisor's own prompt.
+
+    When set, each advisor call writes a cache entry at the given TTL so subsequent
+    calls in the same conversation read the stable prefix. When omitted, the advisor
+    prompt is not cached.
+    """
+
+    defer_loading: bool
+    """If true, tool will not be included in initial system prompt.
+
+    Only loaded when returned via tool_reference from tool search.
+    """
+
+    max_uses: Optional[int]
+    """Maximum number of times the tool can be used in the API request."""
+
+    strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""