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

anthropic/types/beta/beta_direct_caller.py

@@ -0,0 +1,11 @@
+# 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):
+    type: Literal["direct"]

anthropic/types/beta/beta_direct_caller_param.py

@@ -0,0 +1,11 @@
+# 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):
+    type: Required[Literal["direct"]]

anthropic/types/beta/beta_mcp_tool_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_extensions import TypedDict
+
+__all__ = ["BetaMCPToolConfigParam"]
+
+
+class BetaMCPToolConfigParam(TypedDict, total=False):
+    defer_loading: bool
+
+    enabled: bool

anthropic/types/beta/beta_mcp_tool_default_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_extensions import TypedDict
+
+__all__ = ["BetaMCPToolDefaultConfigParam"]
+
+
+class BetaMCPToolDefaultConfigParam(TypedDict, total=False):
+    defer_loading: bool
+
+    enabled: bool

anthropic/types/beta/beta_mcp_toolset_param.py

@@ -0,0 +1,28 @@
+# 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):
+    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,13 @@
+# 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_id: str
+
+    type: Literal["code_execution_20250825"]

anthropic/types/beta/beta_server_tool_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__ = ["BetaServerToolCallerParam"]
+
+
+class BetaServerToolCallerParam(TypedDict, total=False):
+    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_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_computer_use_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
@@ -25,10 +25,20 @@ class BetaToolComputerUse20241022Param(TypedDict, total=False):
 
     type: Required[Literal["computer_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.
+    """
+
     display_number: Optional[int]
     """The X11 display number (e.g. 0, 1) for the display."""
 
+    input_examples: Iterable[Dict[str, object]]
+
     strict: bool

anthropic/types/beta/beta_tool_computer_use_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
@@ -25,10 +25,20 @@ class BetaToolComputerUse20250124Param(TypedDict, total=False):
 
     type: Required[Literal["computer_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.
+    """
+
     display_number: Optional[int]
     """The X11 display number (e.g. 0, 1) for the display."""
 
+    input_examples: Iterable[Dict[str, object]]
+
     strict: bool

anthropic/types/beta/beta_tool_computer_use_20251124_param.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Iterable, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+
+__all__ = ["BetaToolComputerUse20251124Param"]
+
+
+class BetaToolComputerUse20251124Param(TypedDict, total=False):
+    display_height_px: Required[int]
+    """The height of the display in pixels."""
+
+    display_width_px: Required[int]
+    """The width of the display in pixels."""
+
+    name: Required[Literal["computer"]]
+    """Name of the tool.
+
+    This is how the tool will be called by the model and in `tool_use` blocks.
+    """
+
+    type: Required[Literal["computer_20251124"]]
+
+    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.
+    """
+
+    display_number: Optional[int]
+    """The X11 display number (e.g. 0, 1) for the display."""
+
+    enable_zoom: bool
+    """Whether to enable an action to take a zoomed-in screenshot of the screen."""
+
+    input_examples: Iterable[Dict[str, object]]
+
+    strict: bool

anthropic/types/beta/beta_tool_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, Union, Optional
+from typing import Dict, List, Union, Iterable, Optional
 from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
 from ..._types import SequenceNotStr
@@ -36,9 +36,17 @@ class BetaToolParam(TypedDict, total=False):
     This is how the tool will be called by the model and in `tool_use` blocks.
     """
 
+    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.
+    """
+
     description: str
     """Description of what this tool does.
 
@@ -48,6 +56,8 @@ class BetaToolParam(TypedDict, total=False):
     aspects of the tool input JSON schema.
     """
 
+    input_examples: Iterable[Dict[str, object]]
+
     strict: bool
 
     type: Optional[Literal["custom"]]

anthropic/types/beta/beta_tool_reference_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__ = ["BetaToolReferenceBlock"]
+
+
+class BetaToolReferenceBlock(BaseModel):
+    tool_name: str
+
+    type: Literal["tool_reference"]

anthropic/types/beta/beta_tool_reference_block_param.py

@@ -0,0 +1,19 @@
+# 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, Required, TypedDict
+
+from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+
+__all__ = ["BetaToolReferenceBlockParam"]
+
+
+class BetaToolReferenceBlockParam(TypedDict, total=False):
+    tool_name: Required[str]
+
+    type: Required[Literal["tool_reference"]]
+
+    cache_control: Optional[BetaCacheControlEphemeralParam]
+    """Create a cache control breakpoint at this content block."""

anthropic/types/beta/beta_tool_result_block_param.py

@@ -8,13 +8,18 @@ from typing_extensions import Literal, Required, TypeAlias, TypedDict
 from .beta_text_block_param import BetaTextBlockParam
 from .beta_image_block_param import BetaImageBlockParam
 from .beta_search_result_block_param import BetaSearchResultBlockParam
+from .beta_tool_reference_block_param import BetaToolReferenceBlockParam
 from .beta_request_document_block_param import BetaRequestDocumentBlockParam
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
 
 __all__ = ["BetaToolResultBlockParam", "Content"]
 
 Content: TypeAlias = Union[
-    BetaTextBlockParam, BetaImageBlockParam, BetaSearchResultBlockParam, BetaRequestDocumentBlockParam
+    BetaTextBlockParam,
+    BetaImageBlockParam,
+    BetaSearchResultBlockParam,
+    BetaRequestDocumentBlockParam,
+    BetaToolReferenceBlockParam,
 ]
 
 

anthropic/types/beta/beta_tool_search_tool_bm25_20251119_param.py

@@ -0,0 +1,33 @@
+# 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 .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+
+__all__ = ["BetaToolSearchToolBm25_20251119Param"]
+
+
+class BetaToolSearchToolBm25_20251119Param(TypedDict, total=False):
+    name: Required[Literal["tool_search_tool_bm25"]]
+    """Name of the tool.
+
+    This is how the tool will be called by the model and in `tool_use` blocks.
+    """
+
+    type: Required[Literal["tool_search_tool_bm25_20251119", "tool_search_tool_bm25"]]
+
+    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_tool_search_tool_regex_20251119_param.py

@@ -0,0 +1,33 @@
+# 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 .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+
+__all__ = ["BetaToolSearchToolRegex20251119Param"]
+
+
+class BetaToolSearchToolRegex20251119Param(TypedDict, total=False):
+    name: Required[Literal["tool_search_tool_regex"]]
+    """Name of the tool.
+
+    This is how the tool will be called by the model and in `tool_use` blocks.
+    """
+
+    type: Required[Literal["tool_search_tool_regex_20251119", "tool_search_tool_regex"]]
+
+    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_tool_search_tool_result_block.py

@@ -0,0 +1,20 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union
+from typing_extensions import Literal, TypeAlias
+
+from ..._models import BaseModel
+from .beta_tool_search_tool_result_error import BetaToolSearchToolResultError
+from .beta_tool_search_tool_search_result_block import BetaToolSearchToolSearchResultBlock
+
+__all__ = ["BetaToolSearchToolResultBlock", "Content"]
+
+Content: TypeAlias = Union[BetaToolSearchToolResultError, BetaToolSearchToolSearchResultBlock]
+
+
+class BetaToolSearchToolResultBlock(BaseModel):
+    content: Content
+
+    tool_use_id: str
+
+    type: Literal["tool_search_tool_result"]

anthropic/types/beta/beta_tool_search_tool_result_block_param.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union, Optional
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+from .beta_tool_search_tool_result_error_param import BetaToolSearchToolResultErrorParam
+from .beta_tool_search_tool_search_result_block_param import BetaToolSearchToolSearchResultBlockParam
+
+__all__ = ["BetaToolSearchToolResultBlockParam", "Content"]
+
+Content: TypeAlias = Union[BetaToolSearchToolResultErrorParam, BetaToolSearchToolSearchResultBlockParam]
+
+
+class BetaToolSearchToolResultBlockParam(TypedDict, total=False):
+    content: Required[Content]
+
+    tool_use_id: Required[str]
+
+    type: Required[Literal["tool_search_tool_result"]]
+
+    cache_control: Optional[BetaCacheControlEphemeralParam]
+    """Create a cache control breakpoint at this content block."""

anthropic/types/beta/beta_tool_search_tool_result_error.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaToolSearchToolResultError"]
+
+
+class BetaToolSearchToolResultError(BaseModel):
+    error_code: Literal["invalid_tool_input", "unavailable", "too_many_requests", "execution_time_exceeded"]
+
+    error_message: Optional[str] = None
+
+    type: Literal["tool_search_tool_result_error"]

anthropic/types/beta/beta_tool_search_tool_result_error_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__ = ["BetaToolSearchToolResultErrorParam"]
+
+
+class BetaToolSearchToolResultErrorParam(TypedDict, total=False):
+    error_code: Required[Literal["invalid_tool_input", "unavailable", "too_many_requests", "execution_time_exceeded"]]
+
+    type: Required[Literal["tool_search_tool_result_error"]]