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

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
@@ -12,6 +12,11 @@ __all__ = ["BetaToolParam", "InputSchema"]
 
 
 class InputSchemaTyped(TypedDict, total=False):
+    """[JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
+
+    This defines the shape of the `input` that your tool accepts and that the model will produce.
+    """
+
     type: Required[Literal["object"]]
 
     properties: Optional[Dict[str, object]]
@@ -36,9 +41,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 +61,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,21 @@
+# 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 reference block that can be included in tool_result content."""
+
+    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"]]

anthropic/types/beta/beta_tool_search_tool_search_result_block.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from .beta_tool_reference_block import BetaToolReferenceBlock
+
+__all__ = ["BetaToolSearchToolSearchResultBlock"]
+
+
+class BetaToolSearchToolSearchResultBlock(BaseModel):
+    tool_references: List[BetaToolReferenceBlock]
+
+    type: Literal["tool_search_tool_search_result"]

anthropic/types/beta/beta_tool_search_tool_search_result_block_param.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable
+from typing_extensions import Literal, Required, TypedDict
+
+from .beta_tool_reference_block_param import BetaToolReferenceBlockParam
+
+__all__ = ["BetaToolSearchToolSearchResultBlockParam"]
+
+
+class BetaToolSearchToolSearchResultBlockParam(TypedDict, total=False):
+    tool_references: Required[Iterable[BetaToolReferenceBlockParam]]
+
+    type: Required[Literal["tool_search_tool_search_result"]]

anthropic/types/beta/beta_tool_text_editor_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 BetaToolTextEditor20241022Param(TypedDict, total=False):
 
     type: Required[Literal["text_editor_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_text_editor_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 BetaToolTextEditor20250124Param(TypedDict, total=False):
 
     type: Required[Literal["text_editor_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_text_editor_20250429_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 BetaToolTextEditor20250429Param(TypedDict, total=False):
 
     type: Required[Literal["text_editor_20250429"]]
 
+    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_text_editor_20250728_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,9 +19,19 @@ class BetaToolTextEditor20250728Param(TypedDict, total=False):
 
     type: Required[Literal["text_editor_20250728"]]
 
+    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]]
+
     max_characters: Optional[int]
     """Maximum number of characters to display when viewing a file.
 

anthropic/types/beta/beta_tool_union_param.py

@@ -6,6 +6,7 @@ from typing import Union
 from typing_extensions import TypeAlias
 
 from .beta_tool_param import BetaToolParam
+from .beta_mcp_toolset_param import BetaMCPToolsetParam
 from .beta_tool_bash_20241022_param import BetaToolBash20241022Param
 from .beta_tool_bash_20250124_param import BetaToolBash20250124Param
 from .beta_memory_tool_20250818_param import BetaMemoryTool20250818Param
@@ -17,8 +18,11 @@ from .beta_tool_text_editor_20250429_param import BetaToolTextEditor20250429Para
 from .beta_tool_text_editor_20250728_param import BetaToolTextEditor20250728Param
 from .beta_tool_computer_use_20241022_param import BetaToolComputerUse20241022Param
 from .beta_tool_computer_use_20250124_param import BetaToolComputerUse20250124Param
+from .beta_tool_computer_use_20251124_param import BetaToolComputerUse20251124Param
 from .beta_code_execution_tool_20250522_param import BetaCodeExecutionTool20250522Param
 from .beta_code_execution_tool_20250825_param import BetaCodeExecutionTool20250825Param
+from .beta_tool_search_tool_bm25_20251119_param import BetaToolSearchToolBm25_20251119Param
+from .beta_tool_search_tool_regex_20251119_param import BetaToolSearchToolRegex20251119Param
 
 __all__ = ["BetaToolUnionParam"]
 
@@ -32,9 +36,13 @@ BetaToolUnionParam: TypeAlias = Union[
     BetaMemoryTool20250818Param,
     BetaToolComputerUse20250124Param,
     BetaToolTextEditor20241022Param,
+    BetaToolComputerUse20251124Param,
     BetaToolTextEditor20250124Param,
     BetaToolTextEditor20250429Param,
     BetaToolTextEditor20250728Param,
     BetaWebSearchTool20250305Param,
     BetaWebFetchTool20250910Param,
+    BetaToolSearchToolBm25_20251119Param,
+    BetaToolSearchToolRegex20251119Param,
+    BetaMCPToolsetParam,
 ]

anthropic/types/beta/beta_tool_use_block.py

@@ -1,11 +1,16 @@
 # 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, Optional
+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__ = ["BetaToolUseBlock"]
+__all__ = ["BetaToolUseBlock", "Caller"]
+
+Caller: TypeAlias = Annotated[Union[BetaDirectCaller, BetaServerToolCaller], PropertyInfo(discriminator="type")]
 
 
 class BetaToolUseBlock(BaseModel):
@@ -16,3 +21,6 @@ class BetaToolUseBlock(BaseModel):
     name: str
 
     type: Literal["tool_use"]
+
+    caller: Optional[Caller] = None
+    """Tool invocation directly from the model."""

anthropic/types/beta/beta_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__ = ["BetaToolUseBlockParam"]
+__all__ = ["BetaToolUseBlockParam", "Caller"]
+
+Caller: TypeAlias = Union[BetaDirectCallerParam, BetaServerToolCallerParam]
 
 
 class BetaToolUseBlockParam(TypedDict, total=False):
@@ -21,3 +25,6 @@ class BetaToolUseBlockParam(TypedDict, total=False):
 
     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_web_fetch_tool_20250910_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 ..._types import SequenceNotStr
@@ -21,6 +21,8 @@ class BetaWebFetchTool20250910Param(TypedDict, total=False):
 
     type: Required[Literal["web_fetch_20250910"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     allowed_domains: Optional[SequenceNotStr[str]]
     """List of domains to allow fetching from"""
 
@@ -36,6 +38,12 @@ class BetaWebFetchTool20250910Param(TypedDict, total=False):
     Citations are disabled by default.
     """
 
+    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_content_tokens: Optional[int]
     """Maximum number of tokens used by including web page text content in the context.
 

anthropic/types/beta/beta_web_search_tool_20250305_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 ..._types import SequenceNotStr
@@ -12,6 +12,11 @@ __all__ = ["BetaWebSearchTool20250305Param", "UserLocation"]
 
 
 class UserLocation(TypedDict, total=False):
+    """Parameters for the user's location.
+
+    Used to provide more relevant search results.
+    """
+
     type: Required[Literal["approximate"]]
 
     city: Optional[str]
@@ -40,6 +45,8 @@ class BetaWebSearchTool20250305Param(TypedDict, total=False):
 
     type: Required[Literal["web_search_20250305"]]
 
+    allowed_callers: List[Literal["direct", "code_execution_20250825"]]
+
     allowed_domains: Optional[SequenceNotStr[str]]
     """If provided, only these domains will be included in results.
 
@@ -55,6 +62,12 @@ class BetaWebSearchTool20250305Param(TypedDict, total=False):
     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.
+    """
+
     max_uses: Optional[int]
     """Maximum number of times the tool can be used in the API request."""