anthropic 0.72.1__py3-none-any.whl → 0.73.0__py3-none-any.whl

anthropic/resources/messages/batches.py

@@ -63,7 +63,7 @@ class Batches(SyncAPIResource):
         can take up to 24 hours to complete.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           requests: List of requests for prompt completion. Each is an individual request to create
@@ -104,7 +104,7 @@ class Batches(SyncAPIResource):
         `results_url` field in the response.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -146,7 +146,7 @@ class Batches(SyncAPIResource):
         returned first.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           after_id: ID of the object to use as a cursor for pagination. When provided, returns the
@@ -205,7 +205,7 @@ class Batches(SyncAPIResource):
         like to delete an in-progress batch, you must first cancel it.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -252,7 +252,7 @@ class Batches(SyncAPIResource):
         non-interruptible.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -294,7 +294,7 @@ class Batches(SyncAPIResource):
         requests. Use the `custom_id` field to match results to requests.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -366,7 +366,7 @@ class AsyncBatches(AsyncAPIResource):
         can take up to 24 hours to complete.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           requests: List of requests for prompt completion. Each is an individual request to create
@@ -407,7 +407,7 @@ class AsyncBatches(AsyncAPIResource):
         `results_url` field in the response.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -449,7 +449,7 @@ class AsyncBatches(AsyncAPIResource):
         returned first.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           after_id: ID of the object to use as a cursor for pagination. When provided, returns the
@@ -508,7 +508,7 @@ class AsyncBatches(AsyncAPIResource):
         like to delete an in-progress batch, you must first cancel it.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -555,7 +555,7 @@ class AsyncBatches(AsyncAPIResource):
         non-interruptible.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.
@@ -597,7 +597,7 @@ class AsyncBatches(AsyncAPIResource):
         requests. Use the `custom_id` field to match results to requests.
 
         Learn more about the Message Batches API in our
-        [user guide](/en/docs/build-with-claude/batch-processing)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
 
         Args:
           message_batch_id: ID of the Message Batch.

anthropic/resources/messages/messages.py

@@ -118,7 +118,8 @@ class Messages(SyncAPIResource):
         The Messages API can be used for either single queries or stateless multi-turn
         conversations.
 
-        Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        Learn more about the Messages API in our
+        [user guide](https://docs.claude.com/en/docs/initial-setup)
 
         Args:
           max_tokens: The maximum number of tokens to generate before stopping.
@@ -385,7 +386,8 @@ class Messages(SyncAPIResource):
         The Messages API can be used for either single queries or stateless multi-turn
         conversations.
 
-        Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        Learn more about the Messages API in our
+        [user guide](https://docs.claude.com/en/docs/initial-setup)
 
         Args:
           max_tokens: The maximum number of tokens to generate before stopping.
@@ -652,7 +654,8 @@ class Messages(SyncAPIResource):
         The Messages API can be used for either single queries or stateless multi-turn
         conversations.
 
-        Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        Learn more about the Messages API in our
+        [user guide](https://docs.claude.com/en/docs/initial-setup)
 
         Args:
           max_tokens: The maximum number of tokens to generate before stopping.
@@ -1046,7 +1049,7 @@ class Messages(SyncAPIResource):
         including tools, images, and documents, without creating it.
 
         Learn more about token counting in our
-        [user guide](/en/docs/build-with-claude/token-counting)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
 
         Args:
           messages: Input messages.
@@ -1298,7 +1301,8 @@ class AsyncMessages(AsyncAPIResource):
         The Messages API can be used for either single queries or stateless multi-turn
         conversations.
 
-        Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        Learn more about the Messages API in our
+        [user guide](https://docs.claude.com/en/docs/initial-setup)
 
         Args:
           max_tokens: The maximum number of tokens to generate before stopping.
@@ -1565,7 +1569,8 @@ class AsyncMessages(AsyncAPIResource):
         The Messages API can be used for either single queries or stateless multi-turn
         conversations.
 
-        Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        Learn more about the Messages API in our
+        [user guide](https://docs.claude.com/en/docs/initial-setup)
 
         Args:
           max_tokens: The maximum number of tokens to generate before stopping.
@@ -1832,7 +1837,8 @@ class AsyncMessages(AsyncAPIResource):
         The Messages API can be used for either single queries or stateless multi-turn
         conversations.
 
-        Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+        Learn more about the Messages API in our
+        [user guide](https://docs.claude.com/en/docs/initial-setup)
 
         Args:
           max_tokens: The maximum number of tokens to generate before stopping.
@@ -2225,7 +2231,7 @@ class AsyncMessages(AsyncAPIResource):
         including tools, images, and documents, without creating it.
 
         Learn more about token counting in our
-        [user guide](/en/docs/build-with-claude/token-counting)
+        [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
 
         Args:
           messages: Input messages.

anthropic/types/beta/__init__.py

@@ -83,6 +83,7 @@ from .beta_tool_result_block_param import BetaToolResultBlockParam as BetaToolRe
 from .beta_tool_uses_trigger_param import BetaToolUsesTriggerParam as BetaToolUsesTriggerParam
 from .beta_web_search_result_block import BetaWebSearchResultBlock as BetaWebSearchResultBlock
 from .beta_all_thinking_turns_param import BetaAllThinkingTurnsParam as BetaAllThinkingTurnsParam
+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_tool_bash_20241022_param import BetaToolBash20241022Param as BetaToolBash20241022Param

anthropic/types/beta/beta_code_execution_tool_20250522_param.py

@@ -21,3 +21,5 @@ class BetaCodeExecutionTool20250522Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_code_execution_tool_20250825_param.py

@@ -21,3 +21,5 @@ class BetaCodeExecutionTool20250825Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_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__ = ["BetaJSONOutputFormatParam"]
+
+
+class BetaJSONOutputFormatParam(TypedDict, total=False):
+    schema: Required[Dict[str, object]]
+    """The JSON schema of the format"""
+
+    type: Required[Literal["json_schema"]]

anthropic/types/beta/beta_memory_tool_20250818_param.py

@@ -21,3 +21,5 @@ class BetaMemoryTool20250818Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_tool_bash_20241022_param.py

@@ -21,3 +21,5 @@ class BetaToolBash20241022Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_tool_bash_20250124_param.py

@@ -21,3 +21,5 @@ class BetaToolBash20250124Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_tool_computer_use_20241022_param.py

@@ -30,3 +30,5 @@ class BetaToolComputerUse20241022Param(TypedDict, total=False):
 
     display_number: Optional[int]
     """The X11 display number (e.g. 0, 1) for the display."""
+
+    strict: bool

anthropic/types/beta/beta_tool_computer_use_20250124_param.py

@@ -30,3 +30,5 @@ class BetaToolComputerUse20250124Param(TypedDict, total=False):
 
     display_number: Optional[int]
     """The X11 display number (e.g. 0, 1) for the display."""
+
+    strict: bool

anthropic/types/beta/beta_tool_param.py

@@ -48,4 +48,6 @@ class BetaToolParam(TypedDict, total=False):
     aspects of the tool input JSON schema.
     """
 
+    strict: bool
+
     type: Optional[Literal["custom"]]

anthropic/types/beta/beta_tool_text_editor_20241022_param.py

@@ -21,3 +21,5 @@ class BetaToolTextEditor20241022Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_tool_text_editor_20250124_param.py

@@ -21,3 +21,5 @@ class BetaToolTextEditor20250124Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_tool_text_editor_20250429_param.py

@@ -21,3 +21,5 @@ class BetaToolTextEditor20250429Param(TypedDict, total=False):
 
     cache_control: Optional[BetaCacheControlEphemeralParam]
     """Create a cache control breakpoint at this content block."""
+
+    strict: bool

anthropic/types/beta/beta_tool_text_editor_20250728_param.py

@@ -27,3 +27,5 @@ class BetaToolTextEditor20250728Param(TypedDict, total=False):
 
     If not specified, defaults to displaying the full file.
     """
+
+    strict: bool

anthropic/types/beta/beta_web_fetch_tool_20250910_param.py

@@ -44,3 +44,5 @@ class BetaWebFetchTool20250910Param(TypedDict, total=False):
 
     max_uses: Optional[int]
     """Maximum number of times the tool can be used in the API request."""
+
+    strict: bool

anthropic/types/beta/beta_web_search_tool_20250305_param.py

@@ -58,6 +58,8 @@ class BetaWebSearchTool20250305Param(TypedDict, total=False):
     max_uses: Optional[int]
     """Maximum number of times the tool can be used in the API request."""
 
+    strict: bool
+
     user_location: Optional[UserLocation]
     """Parameters for the user's location.
 

anthropic/types/beta/message_count_tokens_params.py

@@ -13,6 +13,7 @@ from ..anthropic_beta_param import AnthropicBetaParam
 from .beta_text_block_param import BetaTextBlockParam
 from .beta_tool_choice_param import BetaToolChoiceParam
 from .beta_thinking_config_param import BetaThinkingConfigParam
+from .beta_json_output_format_param import BetaJSONOutputFormatParam
 from .beta_tool_bash_20241022_param import BetaToolBash20241022Param
 from .beta_tool_bash_20250124_param import BetaToolBash20250124Param
 from .beta_memory_tool_20250818_param import BetaMemoryTool20250818Param
@@ -118,6 +119,9 @@ class MessageCountTokensParams(TypedDict, total=False):
     mcp_servers: Iterable[BetaRequestMCPServerURLDefinitionParam]
     """MCP servers to be utilized in this request"""
 
+    output_format: Optional[BetaJSONOutputFormatParam]
+    """A schema to specify Claude's output format in responses."""
+
     system: Union[str, Iterable[BetaTextBlockParam]]
     """System prompt.
 

anthropic/types/beta/message_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Union, Iterable, Optional
+from typing import List, Union, Generic, Iterable, Optional
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
 from ..._types import SequenceNotStr
@@ -10,16 +10,24 @@ from ..._utils import PropertyInfo
 from ..model_param import ModelParam
 from .beta_message_param import BetaMessageParam
 from .beta_metadata_param import BetaMetadataParam
+from .parsed_beta_message import ResponseFormatT
 from ..anthropic_beta_param import AnthropicBetaParam
 from .beta_container_params import BetaContainerParams
 from .beta_text_block_param import BetaTextBlockParam
 from .beta_tool_union_param import BetaToolUnionParam
 from .beta_tool_choice_param import BetaToolChoiceParam
 from .beta_thinking_config_param import BetaThinkingConfigParam
+from .beta_json_output_format_param import BetaJSONOutputFormatParam
 from .beta_context_management_config_param import BetaContextManagementConfigParam
 from .beta_request_mcp_server_url_definition_param import BetaRequestMCPServerURLDefinitionParam
 
-__all__ = ["MessageCreateParamsBase", "Container", "MessageCreateParamsNonStreaming", "MessageCreateParamsStreaming"]
+__all__ = [
+    "MessageCreateParamsBase",
+    "Container",
+    "MessageCreateParamsNonStreaming",
+    "MessageCreateParamsStreaming",
+    "OutputFormat",
+]
 
 
 class MessageCreateParamsBase(TypedDict, total=False):
@@ -124,6 +132,9 @@ class MessageCreateParamsBase(TypedDict, total=False):
     metadata: BetaMetadataParam
     """An object describing metadata about the request."""
 
+    output_format: Optional[BetaJSONOutputFormatParam]
+    """A schema to specify Claude's output format in responses."""
+
     service_tier: Literal["auto", "standard_only"]
     """
     Determines whether to use priority capacity (if available) or standard capacity
@@ -290,6 +301,17 @@ class MessageCreateParamsBase(TypedDict, total=False):
 Container: TypeAlias = Union[BetaContainerParams, str]
 
 
+class ParseMessageCreateParamsBase(MessageCreateParamsBase, Generic[ResponseFormatT]):
+    output_format: type[ResponseFormatT]  # type: ignore[misc]
+
+
+class OutputFormat(TypedDict, total=False):
+    schema: Required[object]
+    """The JSON schema of the format"""
+
+    type: Required[Literal["json_schema"]]
+
+
 class MessageCreateParamsNonStreaming(MessageCreateParamsBase, total=False):
     stream: Literal[False]
     """Whether to incrementally stream the response using server-sent events.

anthropic/types/beta/messages/batch_create_params.py

@@ -3,13 +3,13 @@
 from __future__ import annotations
 
 from typing import List, Iterable
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from ...._utils import PropertyInfo
 from ...anthropic_beta_param import AnthropicBetaParam
 from ..message_create_params import MessageCreateParamsNonStreaming
 
-__all__ = ["BatchCreateParams", "Request"]
+__all__ = ["BatchCreateParams", "Request", "RequestParamsOutputFormat"]
 
 
 class BatchCreateParams(TypedDict, total=False):
@@ -23,6 +23,12 @@ 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]

anthropic/types/beta/parsed_beta_message.py

@@ -0,0 +1,68 @@
+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 .beta_message import BetaMessage
+from .beta_text_block import BetaTextBlock
+from .beta_thinking_block import BetaThinkingBlock
+from .beta_tool_use_block import BetaToolUseBlock
+from .beta_mcp_tool_use_block import BetaMCPToolUseBlock
+from .beta_mcp_tool_result_block import BetaMCPToolResultBlock
+from .beta_server_tool_use_block import BetaServerToolUseBlock
+from .beta_container_upload_block import BetaContainerUploadBlock
+from .beta_redacted_thinking_block import BetaRedactedThinkingBlock
+from .beta_web_search_tool_result_block import BetaWebSearchToolResultBlock
+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
+
+ResponseFormatT = TypeVar("ResponseFormatT", default=None)
+
+
+__all__ = [
+    "ParsedBetaTextBlock",
+    "ParsedBetaContentBlock",
+    "ParsedBetaMessage",
+]
+
+
+class ParsedBetaTextBlock(BetaTextBlock, Generic[ResponseFormatT]):
+    parsed_output: Optional[ResponseFormatT] = None
+
+    __api_exclude__ = {"parsed_output"}
+
+
+# Note that generic unions are not valid for pydantic at runtime
+ParsedBetaContentBlock: TypeAlias = Annotated[
+    Union[
+        ParsedBetaTextBlock[ResponseFormatT],
+        BetaThinkingBlock,
+        BetaRedactedThinkingBlock,
+        BetaToolUseBlock,
+        BetaServerToolUseBlock,
+        BetaWebSearchToolResultBlock,
+        BetaCodeExecutionToolResultBlock,
+        BetaBashCodeExecutionToolResultBlock,
+        BetaTextEditorCodeExecutionToolResultBlock,
+        BetaMCPToolUseBlock,
+        BetaMCPToolResultBlock,
+        BetaContainerUploadBlock,
+    ],
+    PropertyInfo(discriminator="type"),
+]
+
+
+class ParsedBetaMessage(BetaMessage, Generic[ResponseFormatT]):
+    if TYPE_CHECKING:
+        content: List[ParsedBetaContentBlock[ResponseFormatT]]  # type: ignore[assignment]
+    else:
+        content: List[ParsedBetaContentBlock]
+
+    @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/messages/batch_create_params.py

@@ -18,7 +18,6 @@ class BatchCreateParams(TypedDict, total=False):
     """
 
 
-
 class Request(TypedDict, total=False):
     custom_id: Required[str]
     """Developer-provided ID created for each request in a Message Batch.

{anthropic-0.72.1.dist-info → anthropic-0.73.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: anthropic
-Version: 0.72.1
+Version: 0.73.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