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

anthropic/types/__init__.py

@@ -32,6 +32,11 @@ from .text_citation import TextCitation as TextCitation
 from .beta_api_error import BetaAPIError as BetaAPIError
 from .cache_creation import CacheCreation as CacheCreation
 from .metadata_param import MetadataParam as MetadataParam
+from .parsed_message import (
+    ParsedMessage as ParsedMessage,
+    ParsedTextBlock as ParsedTextBlock,
+    ParsedContentBlock as ParsedContentBlock,
+)
 from .thinking_block import ThinkingBlock as ThinkingBlock
 from .thinking_delta import ThinkingDelta as ThinkingDelta
 from .tool_use_block import ToolUseBlock as ToolUseBlock
@@ -51,6 +56,7 @@ from .content_block_param import ContentBlockParam as ContentBlockParam
 from .message_delta_event import MessageDeltaEvent as MessageDeltaEvent
 from .message_delta_usage import MessageDeltaUsage as MessageDeltaUsage
 from .message_start_event import MessageStartEvent as MessageStartEvent
+from .output_config_param import OutputConfigParam as OutputConfigParam
 from .text_citation_param import TextCitationParam as TextCitationParam
 from .anthropic_beta_param import AnthropicBetaParam as AnthropicBetaParam
 from .beta_not_found_error import BetaNotFoundError as BetaNotFoundError
@@ -85,6 +91,7 @@ from .tool_result_block_param import ToolResultBlockParam as ToolResultBlockPara
 from .web_search_result_block import WebSearchResultBlock as WebSearchResultBlock
 from .completion_create_params import CompletionCreateParams as CompletionCreateParams
 from .content_block_stop_event import ContentBlockStopEvent as ContentBlockStopEvent
+from .json_output_format_param import JSONOutputFormatParam as JSONOutputFormatParam
 from .raw_message_stream_event import RawMessageStreamEvent as RawMessageStreamEvent
 from .tool_bash_20250124_param import ToolBash20250124Param as ToolBash20250124Param
 from .base64_image_source_param import Base64ImageSourceParam as Base64ImageSourceParam

anthropic/types/beta/beta_code_execution_tool_20250522_param.py

@@ -31,3 +31,4 @@ class BetaCodeExecutionTool20250522Param(TypedDict, total=False):
     """
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_code_execution_tool_20250825_param.py

@@ -31,3 +31,4 @@ class BetaCodeExecutionTool20250825Param(TypedDict, total=False):
     """
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_memory_tool_20250818_param.py

@@ -33,3 +33,4 @@ class BetaMemoryTool20250818Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_output_config_param.py

@@ -5,9 +5,23 @@ from __future__ import annotations
 from typing import Optional
 from typing_extensions import Literal, TypedDict
 
+from .beta_json_output_format_param import BetaJSONOutputFormatParam
+
 __all__ = ["BetaOutputConfigParam"]
 
 
 class BetaOutputConfigParam(TypedDict, total=False):
     effort: Optional[Literal["low", "medium", "high"]]
-    """All possible effort levels."""
+    """How much effort the model should put into its response.
+
+    Higher effort levels may result in more thorough analysis but take longer.
+
+    Valid values are `low`, `medium`, or `high`.
+    """
+
+    format: Optional[BetaJSONOutputFormatParam]
+    """A schema to specify Claude's output format in responses.
+
+    See
+    [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
+    """

anthropic/types/beta/beta_server_tool_use_block.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, Union
+from typing import Dict, Union, Optional
 from typing_extensions import Literal, Annotated, TypeAlias
 
 from ..._utils import PropertyInfo
@@ -16,9 +16,6 @@ Caller: TypeAlias = Annotated[Union[BetaDirectCaller, BetaServerToolCaller], Pro
 class BetaServerToolUseBlock(BaseModel):
     id: str
 
-    caller: Caller
-    """Tool invocation directly from the model."""
-
     input: Dict[str, object]
 
     name: Literal[
@@ -32,3 +29,6 @@ class BetaServerToolUseBlock(BaseModel):
     ]
 
     type: Literal["server_tool_use"]
+
+    caller: Optional[Caller] = None
+    """Tool invocation directly from the model."""

anthropic/types/beta/beta_tool_bash_20241022_param.py

@@ -33,3 +33,4 @@ class BetaToolBash20241022Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_bash_20250124_param.py

@@ -33,3 +33,4 @@ class BetaToolBash20250124Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_computer_use_20241022_param.py

@@ -42,3 +42,4 @@ class BetaToolComputerUse20241022Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_computer_use_20250124_param.py

@@ -42,3 +42,4 @@ class BetaToolComputerUse20250124Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_computer_use_20251124_param.py

@@ -45,3 +45,4 @@ class BetaToolComputerUse20251124Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_param.py

@@ -64,5 +64,6 @@ class BetaToolParam(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""
 
     type: Optional[Literal["custom"]]

anthropic/types/beta/beta_tool_search_tool_bm25_20251119_param.py

@@ -31,3 +31,4 @@ class BetaToolSearchToolBm25_20251119Param(TypedDict, total=False):
     """
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_search_tool_regex_20251119_param.py

@@ -31,3 +31,4 @@ class BetaToolSearchToolRegex20251119Param(TypedDict, total=False):
     """
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_text_editor_20241022_param.py

@@ -33,3 +33,4 @@ class BetaToolTextEditor20241022Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_text_editor_20250124_param.py

@@ -33,3 +33,4 @@ class BetaToolTextEditor20250124Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_text_editor_20250429_param.py

@@ -33,3 +33,4 @@ class BetaToolTextEditor20250429Param(TypedDict, total=False):
     input_examples: Iterable[Dict[str, object]]
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_tool_text_editor_20250728_param.py

@@ -39,3 +39,4 @@ class BetaToolTextEditor20250728Param(TypedDict, total=False):
     """
 
     strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/beta/beta_web_fetch_tool_20250910_param.py

@@ -54,3 +54,4 @@ class BetaWebFetchTool20250910Param(TypedDict, total=False):
     """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"""

anthropic/types/beta/beta_web_search_tool_20250305_param.py

@@ -72,6 +72,7 @@ class BetaWebSearchTool20250305Param(TypedDict, total=False):
     """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"""
 
     user_location: Optional[UserLocation]
     """Parameters for the user's location.

anthropic/types/beta/beta_web_search_tool_result_error_code.py

@@ -5,5 +5,5 @@ from typing_extensions import Literal, TypeAlias
 __all__ = ["BetaWebSearchToolResultErrorCode"]
 
 BetaWebSearchToolResultErrorCode: TypeAlias = Literal[
-    "invalid_tool_input", "unavailable", "max_uses_exceeded", "too_many_requests", "query_too_long"
+    "invalid_tool_input", "unavailable", "max_uses_exceeded", "too_many_requests", "query_too_long", "request_too_large"
 ]

anthropic/types/beta/message_count_tokens_params.py

@@ -125,13 +125,17 @@ class MessageCountTokensParams(TypedDict, total=False):
     """MCP servers to be utilized in this request"""
 
     output_config: BetaOutputConfigParam
-    """Configuration options for the model's output.
-
-    Controls aspects like how much effort the model puts into its response.
-    """
+    """Configuration options for the model's output, such as the output format."""
 
     output_format: Optional[BetaJSONOutputFormatParam]
-    """A schema to specify Claude's output format in responses."""
+    """Deprecated: Use `output_config.format` instead.
+
+    See
+    [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
+
+    A schema to specify Claude's output format in responses. This parameter will be
+    removed in a future release.
+    """
 
     system: Union[str, Iterable[BetaTextBlockParam]]
     """System prompt.

anthropic/types/beta/message_create_params.py

@@ -134,13 +134,17 @@ class MessageCreateParamsBase(TypedDict, total=False):
     """An object describing metadata about the request."""
 
     output_config: BetaOutputConfigParam
-    """Configuration options for the model's output.
-
-    Controls aspects like how much effort the model puts into its response.
-    """
+    """Configuration options for the model's output, such as the output format."""
 
     output_format: Optional[BetaJSONOutputFormatParam]
-    """A schema to specify Claude's output format in responses."""
+    """Deprecated: Use `output_config.format` instead.
+
+    See
+    [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
+
+    A schema to specify Claude's output format in responses. This parameter will be
+    removed in a future release.
+    """
 
     service_tier: Literal["auto", "standard_only"]
     """

anthropic/types/beta/messages/batch_create_params.py

@@ -2,14 +2,14 @@
 
 from __future__ import annotations
 
-from typing import List, Literal, Iterable
+from typing import List, Iterable
 from typing_extensions import Required, Annotated, TypedDict
 
 from ...._utils import PropertyInfo
 from ...anthropic_beta_param import AnthropicBetaParam
 from ..message_create_params import MessageCreateParamsNonStreaming
 
-__all__ = ["BatchCreateParams", "Request", "RequestParamsOutputFormat"]
+__all__ = ["BatchCreateParams", "Request"]
 
 
 class BatchCreateParams(TypedDict, total=False):
@@ -23,13 +23,6 @@ class BatchCreateParams(TypedDict, total=False):
     """Optional header to specify the beta version(s) you want to use."""
 
 
-class RequestParamsOutputFormat(TypedDict, total=False):
-    schema: Required[object]
-    """The JSON schema of the format"""
-
-    type: Required[Literal["json_schema"]]
-
-
 class Request(TypedDict, total=False):
     custom_id: Required[str]
     """Developer-provided ID created for each request in a Message Batch.

anthropic/types/json_output_format_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 import Dict
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["JSONOutputFormatParam"]
+
+
+class JSONOutputFormatParam(TypedDict, total=False):
+    schema: Required[Dict[str, object]]
+    """The JSON schema of the format"""
+
+    type: Required[Literal["json_schema"]]

anthropic/types/message_count_tokens_params.py

@@ -9,6 +9,7 @@ from .model_param import ModelParam
 from .message_param import MessageParam
 from .text_block_param import TextBlockParam
 from .tool_choice_param import ToolChoiceParam
+from .output_config_param import OutputConfigParam
 from .thinking_config_param import ThinkingConfigParam
 from .message_count_tokens_tool_param import MessageCountTokensToolParam
 
@@ -91,6 +92,9 @@ class MessageCountTokensParams(TypedDict, total=False):
     details and options.
     """
 
+    output_config: OutputConfigParam
+    """Configuration options for the model's output, such as the output format."""
+
     system: Union[str, Iterable[TextBlockParam]]
     """System prompt.
 

anthropic/types/message_create_params.py

@@ -12,6 +12,7 @@ from .metadata_param import MetadataParam
 from .text_block_param import TextBlockParam
 from .tool_union_param import ToolUnionParam
 from .tool_choice_param import ToolChoiceParam
+from .output_config_param import OutputConfigParam
 from .thinking_config_param import ThinkingConfigParam
 from .tool_choice_any_param import ToolChoiceAnyParam
 from .tool_choice_auto_param import ToolChoiceAutoParam
@@ -118,6 +119,9 @@ class MessageCreateParamsBase(TypedDict, total=False):
     metadata: MetadataParam
     """An object describing metadata about the request."""
 
+    output_config: OutputConfigParam
+    """Configuration options for the model's output, such as the output format."""
+
     service_tier: Literal["auto", "standard_only"]
     """
     Determines whether to use priority capacity (if available) or standard capacity

anthropic/types/output_config_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 TypedDict
+
+from .json_output_format_param import JSONOutputFormatParam
+
+__all__ = ["OutputConfigParam"]
+
+
+class OutputConfigParam(TypedDict, total=False):
+    format: Optional[JSONOutputFormatParam]
+    """A schema to specify Claude's output format in responses.
+
+    See
+    [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
+    """

anthropic/types/parsed_message.py

@@ -0,0 +1,56 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, List, Union, Generic, Optional
+from typing_extensions import TypeVar, Annotated, TypeAlias
+
+from .._utils import PropertyInfo
+from .message import Message
+from .text_block import TextBlock
+from .thinking_block import ThinkingBlock
+from .tool_use_block import ToolUseBlock
+from .server_tool_use_block import ServerToolUseBlock
+from .redacted_thinking_block import RedactedThinkingBlock
+from .web_search_tool_result_block import WebSearchToolResultBlock
+
+ResponseFormatT = TypeVar("ResponseFormatT", default=None)
+
+
+__all__ = [
+    "ParsedTextBlock",
+    "ParsedContentBlock",
+    "ParsedMessage",
+]
+
+
+class ParsedTextBlock(TextBlock, Generic[ResponseFormatT]):
+    parsed_output: Optional[ResponseFormatT] = None
+
+    __api_exclude__ = {"parsed_output"}
+
+
+# Note that generic unions are not valid for pydantic at runtime
+ParsedContentBlock: TypeAlias = Annotated[
+    Union[
+        ParsedTextBlock[ResponseFormatT],
+        ThinkingBlock,
+        RedactedThinkingBlock,
+        ToolUseBlock,
+        ServerToolUseBlock,
+        WebSearchToolResultBlock,
+    ],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ParsedMessage(Message, Generic[ResponseFormatT]):
+    if TYPE_CHECKING:
+        content: List[ParsedContentBlock[ResponseFormatT]]  # type: ignore[assignment]
+    else:
+        content: List[ParsedContentBlock]
+
+    @property
+    def parsed_output(self) -> Optional[ResponseFormatT]:
+        for content in self.content:
+            if content.type == "text" and content.parsed_output:
+                return content.parsed_output
+        return None

anthropic/types/tool_bash_20250124_param.py

@@ -21,3 +21,6 @@ class ToolBash20250124Param(TypedDict, total=False):
 
     cache_control: Optional[CacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/tool_param.py

@@ -56,4 +56,7 @@ class ToolParam(TypedDict, total=False):
     aspects of the tool input JSON schema.
     """
 
+    strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""
+
     type: Optional[Literal["custom"]]

anthropic/types/tool_text_editor_20250124_param.py

@@ -21,3 +21,6 @@ class ToolTextEditor20250124Param(TypedDict, total=False):
 
     cache_control: Optional[CacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/tool_text_editor_20250429_param.py

@@ -21,3 +21,6 @@ class ToolTextEditor20250429Param(TypedDict, total=False):
 
     cache_control: Optional[CacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/tool_text_editor_20250728_param.py

@@ -27,3 +27,6 @@ class ToolTextEditor20250728Param(TypedDict, total=False):
 
     If not specified, defaults to displaying the full file.
     """
+
+    strict: bool
+    """When true, guarantees schema validation on tool names and inputs"""

anthropic/types/web_search_tool_20250305_param.py

@@ -63,6 +63,9 @@ class WebSearchTool20250305Param(TypedDict, total=False):
     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"""
+
     user_location: Optional[UserLocation]
     """Parameters for the user's location.
 

anthropic/types/web_search_tool_request_error_param.py

@@ -9,7 +9,14 @@ __all__ = ["WebSearchToolRequestErrorParam"]
 
 class WebSearchToolRequestErrorParam(TypedDict, total=False):
     error_code: Required[
-        Literal["invalid_tool_input", "unavailable", "max_uses_exceeded", "too_many_requests", "query_too_long"]
+        Literal[
+            "invalid_tool_input",
+            "unavailable",
+            "max_uses_exceeded",
+            "too_many_requests",
+            "query_too_long",
+            "request_too_large",
+        ]
     ]
 
     type: Required[Literal["web_search_tool_result_error"]]

anthropic/types/web_search_tool_result_error.py

@@ -8,6 +8,13 @@ __all__ = ["WebSearchToolResultError"]
 
 
 class WebSearchToolResultError(BaseModel):
-    error_code: Literal["invalid_tool_input", "unavailable", "max_uses_exceeded", "too_many_requests", "query_too_long"]
+    error_code: Literal[
+        "invalid_tool_input",
+        "unavailable",
+        "max_uses_exceeded",
+        "too_many_requests",
+        "query_too_long",
+        "request_too_large",
+    ]
 
     type: Literal["web_search_tool_result_error"]

{anthropic-0.76.0.dist-info → anthropic-0.77.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.76.0
+Version: 0.77.0
 Summary: The official Python library for the anthropic API
 Project-URL: Homepage, https://github.com/anthropics/anthropic-sdk-python
 Project-URL: Repository, https://github.com/anthropics/anthropic-sdk-python