anthropic 0.74.1__py3-none-any.whl → 0.76.0__py3-none-any.whl

anthropic/types/beta/__init__.py

@@ -18,6 +18,7 @@ from .beta_skill_params import BetaSkillParams as BetaSkillParams
 from .model_list_params import ModelListParams as ModelListParams
 from .skill_list_params import SkillListParams as SkillListParams
 from .beta_content_block import BetaContentBlock as BetaContentBlock
+from .beta_direct_caller import BetaDirectCaller as BetaDirectCaller
 from .beta_message_param import BetaMessageParam as BetaMessageParam
 from .beta_text_citation import BetaTextCitation as BetaTextCitation
 from .file_upload_params import FileUploadParams as FileUploadParams
@@ -42,20 +43,26 @@ from .skill_create_response import SkillCreateResponse as SkillCreateResponse
 from .skill_delete_response import SkillDeleteResponse as SkillDeleteResponse
 from .beta_base64_pdf_source import BetaBase64PDFSource as BetaBase64PDFSource
 from .beta_image_block_param import BetaImageBlockParam as BetaImageBlockParam
+from .beta_mcp_toolset_param import BetaMCPToolsetParam as BetaMCPToolsetParam
 from .beta_plain_text_source import BetaPlainTextSource as BetaPlainTextSource
 from .beta_server_tool_usage import BetaServerToolUsage as BetaServerToolUsage
 from .beta_tool_choice_param import BetaToolChoiceParam as BetaToolChoiceParam
 from .beta_mcp_tool_use_block import BetaMCPToolUseBlock as BetaMCPToolUseBlock
+from .beta_server_tool_caller import BetaServerToolCaller as BetaServerToolCaller
 from .skill_retrieve_response import SkillRetrieveResponse as SkillRetrieveResponse
 from .beta_content_block_param import BetaContentBlockParam as BetaContentBlockParam
+from .beta_direct_caller_param import BetaDirectCallerParam as BetaDirectCallerParam
 from .beta_message_delta_usage import BetaMessageDeltaUsage as BetaMessageDeltaUsage
+from .beta_output_config_param import BetaOutputConfigParam as BetaOutputConfigParam
 from .beta_text_citation_param import BetaTextCitationParam as BetaTextCitationParam
 from .beta_message_tokens_count import BetaMessageTokensCount as BetaMessageTokensCount
 from .beta_thinking_block_param import BetaThinkingBlockParam as BetaThinkingBlockParam
 from .beta_thinking_turns_param import BetaThinkingTurnsParam as BetaThinkingTurnsParam
+from .beta_tool_reference_block import BetaToolReferenceBlock as BetaToolReferenceBlock
 from .beta_tool_use_block_param import BetaToolUseBlockParam as BetaToolUseBlockParam
 from .beta_tool_uses_keep_param import BetaToolUsesKeepParam as BetaToolUsesKeepParam
 from .beta_url_pdf_source_param import BetaURLPDFSourceParam as BetaURLPDFSourceParam
+from .beta_mcp_tool_config_param import BetaMCPToolConfigParam as BetaMCPToolConfigParam
 from .beta_mcp_tool_result_block import BetaMCPToolResultBlock as BetaMCPToolResultBlock
 from .beta_server_tool_use_block import BetaServerToolUseBlock as BetaServerToolUseBlock
 from .beta_thinking_config_param import BetaThinkingConfigParam as BetaThinkingConfigParam
@@ -86,6 +93,7 @@ from .beta_all_thinking_turns_param import BetaAllThinkingTurnsParam as BetaAllT
 from .beta_json_output_format_param import BetaJSONOutputFormatParam as BetaJSONOutputFormatParam
 from .beta_mcp_tool_use_block_param import BetaMCPToolUseBlockParam as BetaMCPToolUseBlockParam
 from .beta_raw_message_stream_event import BetaRawMessageStreamEvent as BetaRawMessageStreamEvent
+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_base64_image_source_param import BetaBase64ImageSourceParam as BetaBase64ImageSourceParam
@@ -94,6 +102,7 @@ from .beta_content_block_source_param import BetaContentBlockSourceParam as Beta
 from .beta_file_document_source_param import BetaFileDocumentSourceParam as BetaFileDocumentSourceParam
 from .beta_input_tokens_trigger_param import BetaInputTokensTriggerParam as BetaInputTokensTriggerParam
 from .beta_memory_tool_20250818_param import BetaMemoryTool20250818Param as BetaMemoryTool20250818Param
+from .beta_tool_reference_block_param import BetaToolReferenceBlockParam as BetaToolReferenceBlockParam
 from .beta_code_execution_output_block import BetaCodeExecutionOutputBlock as BetaCodeExecutionOutputBlock
 from .beta_code_execution_result_block import BetaCodeExecutionResultBlock as BetaCodeExecutionResultBlock
 from .beta_context_management_response import BetaContextManagementResponse as BetaContextManagementResponse
@@ -108,10 +117,13 @@ from .beta_request_document_block_param import BetaRequestDocumentBlockParam as
 from .beta_web_search_tool_result_block import BetaWebSearchToolResultBlock as BetaWebSearchToolResultBlock
 from .beta_web_search_tool_result_error import BetaWebSearchToolResultError as BetaWebSearchToolResultError
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam as BetaCacheControlEphemeralParam
+from .beta_mcp_tool_default_config_param import BetaMCPToolDefaultConfigParam as BetaMCPToolDefaultConfigParam
 from .beta_raw_content_block_delta_event import BetaRawContentBlockDeltaEvent as BetaRawContentBlockDeltaEvent
 from .beta_raw_content_block_start_event import BetaRawContentBlockStartEvent as BetaRawContentBlockStartEvent
 from .beta_redacted_thinking_block_param import BetaRedactedThinkingBlockParam as BetaRedactedThinkingBlockParam
 from .beta_thinking_config_enabled_param import BetaThinkingConfigEnabledParam as BetaThinkingConfigEnabledParam
+from .beta_tool_search_tool_result_block import BetaToolSearchToolResultBlock as BetaToolSearchToolResultBlock
+from .beta_tool_search_tool_result_error import BetaToolSearchToolResultError as BetaToolSearchToolResultError
 from .beta_web_fetch_tool_20250910_param import BetaWebFetchTool20250910Param as BetaWebFetchTool20250910Param
 from .beta_web_search_result_block_param import BetaWebSearchResultBlockParam as BetaWebSearchResultBlockParam
 from .beta_thinking_config_disabled_param import BetaThinkingConfigDisabledParam as BetaThinkingConfigDisabledParam
@@ -129,6 +141,7 @@ from .beta_code_execution_tool_result_block import BetaCodeExecutionToolResultBl
 from .beta_code_execution_tool_result_error import BetaCodeExecutionToolResultError as BetaCodeExecutionToolResultError
 from .beta_tool_computer_use_20241022_param import BetaToolComputerUse20241022Param as BetaToolComputerUse20241022Param
 from .beta_tool_computer_use_20250124_param import BetaToolComputerUse20250124Param as BetaToolComputerUse20250124Param
+from .beta_tool_computer_use_20251124_param import BetaToolComputerUse20251124Param as BetaToolComputerUse20251124Param
 from .beta_web_fetch_tool_result_error_code import BetaWebFetchToolResultErrorCode as BetaWebFetchToolResultErrorCode
 from .beta_code_execution_output_block_param import (
     BetaCodeExecutionOutputBlockParam as BetaCodeExecutionOutputBlockParam,
@@ -176,12 +189,24 @@ from .beta_memory_tool_20250818_rename_command import (
 from .beta_request_mcp_tool_result_block_param import (
     BetaRequestMCPToolResultBlockParam as BetaRequestMCPToolResultBlockParam,
 )
+from .beta_tool_search_tool_result_block_param import (
+    BetaToolSearchToolResultBlockParam as BetaToolSearchToolResultBlockParam,
+)
+from .beta_tool_search_tool_result_error_param import (
+    BetaToolSearchToolResultErrorParam as BetaToolSearchToolResultErrorParam,
+)
 from .beta_web_search_tool_request_error_param import (
     BetaWebSearchToolRequestErrorParam as BetaWebSearchToolRequestErrorParam,
 )
 from .beta_citations_web_search_result_location import (
     BetaCitationsWebSearchResultLocation as BetaCitationsWebSearchResultLocation,
 )
+from .beta_tool_search_tool_bm25_20251119_param import (
+    BetaToolSearchToolBm25_20251119Param as BetaToolSearchToolBm25_20251119Param,
+)
+from .beta_tool_search_tool_search_result_block import (
+    BetaToolSearchToolSearchResultBlock as BetaToolSearchToolSearchResultBlock,
+)
 from .beta_web_search_tool_result_block_content import (
     BetaWebSearchToolResultBlockContent as BetaWebSearchToolResultBlockContent,
 )
@@ -203,6 +228,9 @@ from .beta_clear_thinking_20251015_edit_response import (
 from .beta_code_execution_tool_result_error_code import (
     BetaCodeExecutionToolResultErrorCode as BetaCodeExecutionToolResultErrorCode,
 )
+from .beta_tool_search_tool_regex_20251119_param import (
+    BetaToolSearchToolRegex20251119Param as BetaToolSearchToolRegex20251119Param,
+)
 from .beta_bash_code_execution_output_block_param import (
     BetaBashCodeExecutionOutputBlockParam as BetaBashCodeExecutionOutputBlockParam,
 )
@@ -236,6 +264,9 @@ from .beta_memory_tool_20250818_str_replace_command import (
 from .beta_citation_web_search_result_location_param import (
     BetaCitationWebSearchResultLocationParam as BetaCitationWebSearchResultLocationParam,
 )
+from .beta_tool_search_tool_search_result_block_param import (
+    BetaToolSearchToolSearchResultBlockParam as BetaToolSearchToolSearchResultBlockParam,
+)
 from .beta_bash_code_execution_tool_result_block_param import (
     BetaBashCodeExecutionToolResultBlockParam as BetaBashCodeExecutionToolResultBlockParam,
 )

anthropic/types/beta/beta_code_execution_tool_20250522_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import List, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
@@ -19,7 +19,15 @@ class BetaCodeExecutionTool20250522Param(TypedDict, total=False):
 
     type: Required[Literal["code_execution_20250522"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
 
+    defer_loading: bool
+    """If true, tool will not be included in initial system prompt.
+
+    Only loaded when returned via tool_reference from tool search.
+    """
+
     strict: bool

anthropic/types/beta/beta_code_execution_tool_20250825_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import List, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
@@ -19,7 +19,15 @@ class BetaCodeExecutionTool20250825Param(TypedDict, total=False):
 
     type: Required[Literal["code_execution_20250825"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
 
+    defer_loading: bool
+    """If true, tool will not be included in initial system prompt.
+
+    Only loaded when returned via tool_reference from tool search.
+    """
+
     strict: bool

anthropic/types/beta/beta_container.py

@@ -10,6 +10,10 @@ __all__ = ["BetaContainer"]
 
 
 class BetaContainer(BaseModel):
+    """
+    Information about the container used in the request (for the code execution tool)
+    """
+
     id: str
     """Identifier for the container used in this request"""
 

anthropic/types/beta/beta_container_params.py

@@ -11,6 +11,8 @@ __all__ = ["BetaContainerParams"]
 
 
 class BetaContainerParams(TypedDict, total=False):
+    """Container parameters with skills to be loaded."""
+
     id: Optional[str]
     """Container id"""
 

anthropic/types/beta/beta_container_upload_block.py

@@ -8,6 +8,8 @@ __all__ = ["BetaContainerUploadBlock"]
 
 
 class BetaContainerUploadBlock(BaseModel):
+    """Response model for a file uploaded to the container."""
+
     file_id: str
 
     type: Literal["container_upload"]

anthropic/types/beta/beta_container_upload_block_param.py

@@ -11,6 +11,11 @@ __all__ = ["BetaContainerUploadBlockParam"]
 
 
 class BetaContainerUploadBlockParam(TypedDict, total=False):
+    """
+    A content block that represents a file to be uploaded to the container
+    Files uploaded via this block will be available in the container's input directory.
+    """
+
     file_id: Required[str]
 
     type: Required[Literal["container_upload"]]

anthropic/types/beta/beta_content_block.py

@@ -14,6 +14,7 @@ from .beta_container_upload_block import BetaContainerUploadBlock
 from .beta_redacted_thinking_block import BetaRedactedThinkingBlock
 from .beta_web_fetch_tool_result_block import BetaWebFetchToolResultBlock
 from .beta_web_search_tool_result_block import BetaWebSearchToolResultBlock
+from .beta_tool_search_tool_result_block import BetaToolSearchToolResultBlock
 from .beta_code_execution_tool_result_block import BetaCodeExecutionToolResultBlock
 from .beta_bash_code_execution_tool_result_block import BetaBashCodeExecutionToolResultBlock
 from .beta_text_editor_code_execution_tool_result_block import BetaTextEditorCodeExecutionToolResultBlock
@@ -32,6 +33,7 @@ BetaContentBlock: TypeAlias = Annotated[
         BetaCodeExecutionToolResultBlock,
         BetaBashCodeExecutionToolResultBlock,
         BetaTextEditorCodeExecutionToolResultBlock,
+        BetaToolSearchToolResultBlock,
         BetaMCPToolUseBlock,
         BetaMCPToolResultBlock,
         BetaContainerUploadBlock,

anthropic/types/beta/beta_content_block_param.py

@@ -20,6 +20,7 @@ from .beta_redacted_thinking_block_param import BetaRedactedThinkingBlockParam
 from .beta_web_fetch_tool_result_block_param import BetaWebFetchToolResultBlockParam
 from .beta_web_search_tool_result_block_param import BetaWebSearchToolResultBlockParam
 from .beta_request_mcp_tool_result_block_param import BetaRequestMCPToolResultBlockParam
+from .beta_tool_search_tool_result_block_param import BetaToolSearchToolResultBlockParam
 from .beta_code_execution_tool_result_block_param import BetaCodeExecutionToolResultBlockParam
 from .beta_bash_code_execution_tool_result_block_param import BetaBashCodeExecutionToolResultBlockParam
 from .beta_text_editor_code_execution_tool_result_block_param import BetaTextEditorCodeExecutionToolResultBlockParam
@@ -41,6 +42,7 @@ BetaContentBlockParam: TypeAlias = Union[
     BetaCodeExecutionToolResultBlockParam,
     BetaBashCodeExecutionToolResultBlockParam,
     BetaTextEditorCodeExecutionToolResultBlockParam,
+    BetaToolSearchToolResultBlockParam,
     BetaMCPToolUseBlockParam,
     BetaRequestMCPToolResultBlockParam,
     BetaContainerUploadBlockParam,

anthropic/types/beta/beta_direct_caller.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__ = ["BetaDirectCaller"]
+
+
+class BetaDirectCaller(BaseModel):
+    """Tool invocation directly from the model."""
+
+    type: Literal["direct"]

anthropic/types/beta/beta_direct_caller_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__ = ["BetaDirectCallerParam"]
+
+
+class BetaDirectCallerParam(TypedDict, total=False):
+    """Tool invocation directly from the model."""
+
+    type: Required[Literal["direct"]]

anthropic/types/beta/beta_mcp_tool_config_param.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["BetaMCPToolConfigParam"]
+
+
+class BetaMCPToolConfigParam(TypedDict, total=False):
+    """Configuration for a specific tool in an MCP toolset."""
+
+    defer_loading: bool
+
+    enabled: bool

anthropic/types/beta/beta_mcp_tool_default_config_param.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["BetaMCPToolDefaultConfigParam"]
+
+
+class BetaMCPToolDefaultConfigParam(TypedDict, total=False):
+    """Default configuration for tools in an MCP toolset."""
+
+    defer_loading: bool
+
+    enabled: bool

anthropic/types/beta/beta_mcp_toolset_param.py

@@ -0,0 +1,34 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .beta_mcp_tool_config_param import BetaMCPToolConfigParam
+from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+from .beta_mcp_tool_default_config_param import BetaMCPToolDefaultConfigParam
+
+__all__ = ["BetaMCPToolsetParam"]
+
+
+class BetaMCPToolsetParam(TypedDict, total=False):
+    """Configuration for a group of tools from an MCP server.
+
+    Allows configuring enabled status and defer_loading for all tools
+    from an MCP server, with optional per-tool overrides.
+    """
+
+    mcp_server_name: Required[str]
+    """Name of the MCP server to configure tools for"""
+
+    type: Required[Literal["mcp_toolset"]]
+
+    cache_control: Optional[BetaCacheControlEphemeralParam]
+    """Create a cache control breakpoint at this content block."""
+
+    configs: Optional[Dict[str, BetaMCPToolConfigParam]]
+    """Configuration overrides for specific tools, keyed by tool name"""
+
+    default_config: BetaMCPToolDefaultConfigParam
+    """Default configuration applied to all tools from this server"""

anthropic/types/beta/beta_memory_tool_20250818_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
@@ -19,7 +19,17 @@ class BetaMemoryTool20250818Param(TypedDict, total=False):
 
     type: Required[Literal["memory_20250818"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
 
+    defer_loading: bool
+    """If true, tool will not be included in initial system prompt.
+
+    Only loaded when returned via tool_reference from tool search.
+    """
+
+    input_examples: Iterable[Dict[str, object]]
+
     strict: bool

anthropic/types/beta/beta_output_config_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 import Optional
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["BetaOutputConfigParam"]
+
+
+class BetaOutputConfigParam(TypedDict, total=False):
+    effort: Optional[Literal["low", "medium", "high"]]
+    """All possible effort levels."""

anthropic/types/beta/beta_raw_content_block_start_event.py

@@ -15,6 +15,7 @@ from .beta_container_upload_block import BetaContainerUploadBlock
 from .beta_redacted_thinking_block import BetaRedactedThinkingBlock
 from .beta_web_fetch_tool_result_block import BetaWebFetchToolResultBlock
 from .beta_web_search_tool_result_block import BetaWebSearchToolResultBlock
+from .beta_tool_search_tool_result_block import BetaToolSearchToolResultBlock
 from .beta_code_execution_tool_result_block import BetaCodeExecutionToolResultBlock
 from .beta_bash_code_execution_tool_result_block import BetaBashCodeExecutionToolResultBlock
 from .beta_text_editor_code_execution_tool_result_block import BetaTextEditorCodeExecutionToolResultBlock
@@ -33,6 +34,7 @@ ContentBlock: TypeAlias = Annotated[
         BetaCodeExecutionToolResultBlock,
         BetaBashCodeExecutionToolResultBlock,
         BetaTextEditorCodeExecutionToolResultBlock,
+        BetaToolSearchToolResultBlock,
         BetaMCPToolUseBlock,
         BetaMCPToolResultBlock,
         BetaContainerUploadBlock,

anthropic/types/beta/beta_server_tool_caller.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaServerToolCaller"]
+
+
+class BetaServerToolCaller(BaseModel):
+    """Tool invocation generated by a server-side tool."""
+
+    tool_id: str
+
+    type: Literal["code_execution_20250825"]

anthropic/types/beta/beta_server_tool_caller_param.py

@@ -0,0 +1,15 @@
+# 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__ = ["BetaServerToolCallerParam"]
+
+
+class BetaServerToolCallerParam(TypedDict, total=False):
+    """Tool invocation generated by a server-side tool."""
+
+    tool_id: Required[str]
+
+    type: Required[Literal["code_execution_20250825"]]

anthropic/types/beta/beta_server_tool_use_block.py

@@ -1,18 +1,34 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict
-from typing_extensions import Literal
+from typing import Dict, Union
+from typing_extensions import Literal, Annotated, TypeAlias
 
+from ..._utils import PropertyInfo
 from ..._models import BaseModel
+from .beta_direct_caller import BetaDirectCaller
+from .beta_server_tool_caller import BetaServerToolCaller
 
-__all__ = ["BetaServerToolUseBlock"]
+__all__ = ["BetaServerToolUseBlock", "Caller"]
+
+Caller: TypeAlias = Annotated[Union[BetaDirectCaller, BetaServerToolCaller], PropertyInfo(discriminator="type")]
 
 
 class BetaServerToolUseBlock(BaseModel):
     id: str
 
+    caller: Caller
+    """Tool invocation directly from the model."""
+
     input: Dict[str, object]
 
-    name: Literal["web_search", "web_fetch", "code_execution", "bash_code_execution", "text_editor_code_execution"]
+    name: Literal[
+        "web_search",
+        "web_fetch",
+        "code_execution",
+        "bash_code_execution",
+        "text_editor_code_execution",
+        "tool_search_tool_regex",
+        "tool_search_tool_bm25",
+    ]
 
     type: Literal["server_tool_use"]

anthropic/types/beta/beta_server_tool_use_block_param.py

@@ -2,12 +2,16 @@
 
 from __future__ import annotations
 
-from typing import Dict, Optional
-from typing_extensions import Literal, Required, TypedDict
+from typing import Dict, Union, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
+from .beta_direct_caller_param import BetaDirectCallerParam
+from .beta_server_tool_caller_param import BetaServerToolCallerParam
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
 
-__all__ = ["BetaServerToolUseBlockParam"]
+__all__ = ["BetaServerToolUseBlockParam", "Caller"]
+
+Caller: TypeAlias = Union[BetaDirectCallerParam, BetaServerToolCallerParam]
 
 
 class BetaServerToolUseBlockParam(TypedDict, total=False):
@@ -16,10 +20,21 @@ class BetaServerToolUseBlockParam(TypedDict, total=False):
     input: Required[Dict[str, object]]
 
     name: Required[
-        Literal["web_search", "web_fetch", "code_execution", "bash_code_execution", "text_editor_code_execution"]
+        Literal[
+            "web_search",
+            "web_fetch",
+            "code_execution",
+            "bash_code_execution",
+            "text_editor_code_execution",
+            "tool_search_tool_regex",
+            "tool_search_tool_bm25",
+        ]
     ]
 
     type: Required[Literal["server_tool_use"]]
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    caller: Caller
+    """Tool invocation directly from the model."""

anthropic/types/beta/beta_skill.py

@@ -8,6 +8,8 @@ __all__ = ["BetaSkill"]
 
 
 class BetaSkill(BaseModel):
+    """A skill that was loaded in a container (response model)."""
+
     skill_id: str
     """Skill ID"""
 

anthropic/types/beta/beta_skill_params.py

@@ -8,6 +8,8 @@ __all__ = ["BetaSkillParams"]
 
 
 class BetaSkillParams(TypedDict, total=False):
+    """Specification for a skill to be loaded in a container (request model)."""
+
     skill_id: Required[str]
     """Skill ID"""
 

anthropic/types/beta/beta_tool_bash_20241022_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
@@ -19,7 +19,17 @@ class BetaToolBash20241022Param(TypedDict, total=False):
 
     type: Required[Literal["bash_20241022"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
 
+    defer_loading: bool
+    """If true, tool will not be included in initial system prompt.
+
+    Only loaded when returned via tool_reference from tool search.
+    """
+
+    input_examples: Iterable[Dict[str, object]]
+
     strict: bool

anthropic/types/beta/beta_tool_bash_20250124_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, List, Iterable, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
@@ -19,7 +19,17 @@ class BetaToolBash20250124Param(TypedDict, total=False):
 
     type: Required[Literal["bash_20250124"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
 
+    defer_loading: bool
+    """If true, tool will not be included in initial system prompt.
+
+    Only loaded when returned via tool_reference from tool search.
+    """
+
+    input_examples: Iterable[Dict[str, object]]
+
     strict: bool

anthropic/types/beta/beta_tool_choice_any_param.py

@@ -8,6 +8,8 @@ __all__ = ["BetaToolChoiceAnyParam"]
 
 
 class BetaToolChoiceAnyParam(TypedDict, total=False):
+    """The model will use any available tools."""
+
     type: Required[Literal["any"]]
 
     disable_parallel_tool_use: bool

anthropic/types/beta/beta_tool_choice_auto_param.py

@@ -8,6 +8,8 @@ __all__ = ["BetaToolChoiceAutoParam"]
 
 
 class BetaToolChoiceAutoParam(TypedDict, total=False):
+    """The model will automatically decide whether to use tools."""
+
     type: Required[Literal["auto"]]
 
     disable_parallel_tool_use: bool

anthropic/types/beta/beta_tool_choice_none_param.py

@@ -8,4 +8,6 @@ __all__ = ["BetaToolChoiceNoneParam"]
 
 
 class BetaToolChoiceNoneParam(TypedDict, total=False):
+    """The model will not be allowed to use tools."""
+
     type: Required[Literal["none"]]

anthropic/types/beta/beta_tool_choice_tool_param.py

@@ -8,6 +8,8 @@ __all__ = ["BetaToolChoiceToolParam"]
 
 
 class BetaToolChoiceToolParam(TypedDict, total=False):
+    """The model will use the specified tool with `tool_choice.name`."""
+
     name: Required[str]
     """The name of the tool to use."""