anthropic 0.56.0__py3-none-any.whl → 0.57.1__py3-none-any.whl

anthropic/_exceptions.py

@@ -75,7 +75,10 @@ class APIConnectionError(APIError):
 
 class APITimeoutError(APIConnectionError):
     def __init__(self, request: httpx.Request) -> None:
-        super().__init__(message="Request timed out.", request=request)
+        super().__init__(
+            message="Request timed out or interrupted. This could be due to a network timeout, dropped connection, or request cancellation. See https://docs.anthropic.com/en/api/errors#long-requests for more details.",
+            request=request,
+        )
 
 
 class BadRequestError(APIStatusError):

anthropic/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "anthropic"
-__version__ = "0.56.0"  # x-release-please-version
+__version__ = "0.57.1"  # x-release-please-version

anthropic/lib/streaming/_beta_messages.py

@@ -101,7 +101,9 @@ class BetaMessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
 
         return "".join(text_blocks)
 
@@ -239,7 +241,10 @@ class BetaAsyncMessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
+
 
         return "".join(text_blocks)
 

anthropic/lib/streaming/_messages.py

@@ -100,7 +100,9 @@ class MessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
 
         return "".join(text_blocks)
 
@@ -237,7 +239,9 @@ class AsyncMessageStream:
                 text_blocks.append(block.text)
 
         if not text_blocks:
-            raise RuntimeError("Expected to have received at least 1 text block")
+            raise RuntimeError(
+                f".get_final_text() can only be called when the API returns a `text` content block.\nThe API returned {','.join([b.type for b in message.content])} content block type(s) that you can access by calling get_final_message().content"
+            )
 
         return "".join(text_blocks)
 

anthropic/resources/beta/messages/messages.py

@@ -207,7 +207,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -275,6 +275,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -501,7 +507,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -569,6 +575,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -795,7 +807,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -863,6 +875,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -1220,7 +1238,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -1254,6 +1272,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -1516,7 +1540,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -1584,6 +1608,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -1810,7 +1840,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -1878,6 +1908,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -2104,7 +2140,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -2172,6 +2208,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -2527,7 +2569,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -2561,6 +2603,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.

anthropic/resources/messages/messages.py

@@ -214,7 +214,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -278,6 +278,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -499,7 +505,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -563,6 +569,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -784,7 +796,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -848,6 +860,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -1188,7 +1206,7 @@ class Messages(SyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -1220,6 +1238,12 @@ class Messages(SyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -1465,7 +1489,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -1529,6 +1553,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -1750,7 +1780,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -1814,6 +1844,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -2035,7 +2071,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -2099,6 +2135,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.
@@ -2438,7 +2480,7 @@ class AsyncMessages(AsyncAPIResource):
               the top-level `system` parameter — there is no `"system"` role for input
               messages in the Messages API.
 
-              There is a limit of 100000 messages in a single request.
+              There is a limit of 100,000 messages in a single request.
 
           model: The model that will complete your prompt.\n\nSee
               [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -2470,6 +2512,12 @@ class AsyncMessages(AsyncAPIResource):
               those tools using the tool input generated by the model and then optionally
               return results back to the model using `tool_result` content blocks.
 
+              There are two types of tools: **client tools** and **server tools**. The
+              behavior described below applies to client tools. For
+              [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+              see their individual documentation as each has its own behavior (e.g., the
+              [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+
               Each tool definition includes:
 
               - `name`: Name of the tool.

anthropic/types/beta/__init__.py

@@ -69,6 +69,7 @@ from .beta_raw_message_stream_event import BetaRawMessageStreamEvent as BetaRawM
 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
+from .beta_search_result_block_param import BetaSearchResultBlockParam as BetaSearchResultBlockParam
 from .beta_content_block_source_param import BetaContentBlockSourceParam as BetaContentBlockSourceParam
 from .beta_file_document_source_param import BetaFileDocumentSourceParam as BetaFileDocumentSourceParam
 from .beta_code_execution_output_block import BetaCodeExecutionOutputBlock as BetaCodeExecutionOutputBlock
@@ -90,6 +91,7 @@ from .beta_web_search_result_block_param import BetaWebSearchResultBlockParam as
 from .beta_thinking_config_disabled_param import BetaThinkingConfigDisabledParam as BetaThinkingConfigDisabledParam
 from .beta_web_search_tool_20250305_param import BetaWebSearchTool20250305Param as BetaWebSearchTool20250305Param
 from .beta_citation_content_block_location import BetaCitationContentBlockLocation as BetaCitationContentBlockLocation
+from .beta_citation_search_result_location import BetaCitationSearchResultLocation as BetaCitationSearchResultLocation
 from .beta_tool_text_editor_20241022_param import BetaToolTextEditor20241022Param as BetaToolTextEditor20241022Param
 from .beta_tool_text_editor_20250124_param import BetaToolTextEditor20250124Param as BetaToolTextEditor20250124Param
 from .beta_tool_text_editor_20250429_param import BetaToolTextEditor20250429Param as BetaToolTextEditor20250429Param
@@ -128,6 +130,9 @@ from .beta_web_search_tool_result_block_content import (
 from .beta_citation_content_block_location_param import (
     BetaCitationContentBlockLocationParam as BetaCitationContentBlockLocationParam,
 )
+from .beta_citation_search_result_location_param import (
+    BetaCitationSearchResultLocationParam as BetaCitationSearchResultLocationParam,
+)
 from .beta_code_execution_tool_result_error_code import (
     BetaCodeExecutionToolResultErrorCode as BetaCodeExecutionToolResultErrorCode,
 )

anthropic/types/beta/beta_citation_search_result_location.py

@@ -0,0 +1,24 @@
+# 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__ = ["BetaCitationSearchResultLocation"]
+
+
+class BetaCitationSearchResultLocation(BaseModel):
+    cited_text: str
+
+    end_block_index: int
+
+    search_result_index: int
+
+    source: str
+
+    start_block_index: int
+
+    title: Optional[str] = None
+
+    type: Literal["search_result_location"]

anthropic/types/beta/beta_citation_search_result_location_param.py

@@ -0,0 +1,24 @@
+# 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
+
+__all__ = ["BetaCitationSearchResultLocationParam"]
+
+
+class BetaCitationSearchResultLocationParam(TypedDict, total=False):
+    cited_text: Required[str]
+
+    end_block_index: Required[int]
+
+    search_result_index: Required[int]
+
+    source: Required[str]
+
+    start_block_index: Required[int]
+
+    title: Required[Optional[str]]
+
+    type: Required[Literal["search_result_location"]]

anthropic/types/beta/beta_citations_delta.py

@@ -8,6 +8,7 @@ from ..._models import BaseModel
 from .beta_citation_char_location import BetaCitationCharLocation
 from .beta_citation_page_location import BetaCitationPageLocation
 from .beta_citation_content_block_location import BetaCitationContentBlockLocation
+from .beta_citation_search_result_location import BetaCitationSearchResultLocation
 from .beta_citations_web_search_result_location import BetaCitationsWebSearchResultLocation
 
 __all__ = ["BetaCitationsDelta", "Citation"]
@@ -18,6 +19,7 @@ Citation: TypeAlias = Annotated[
         BetaCitationPageLocation,
         BetaCitationContentBlockLocation,
         BetaCitationsWebSearchResultLocation,
+        BetaCitationSearchResultLocation,
     ],
     PropertyInfo(discriminator="type"),
 ]

anthropic/types/beta/beta_content_block.py

@@ -20,6 +20,8 @@ __all__ = ["BetaContentBlock"]
 BetaContentBlock: TypeAlias = Annotated[
     Union[
         BetaTextBlock,
+        BetaThinkingBlock,
+        BetaRedactedThinkingBlock,
         BetaToolUseBlock,
         BetaServerToolUseBlock,
         BetaWebSearchToolResultBlock,
@@ -27,8 +29,6 @@ BetaContentBlock: TypeAlias = Annotated[
         BetaMCPToolUseBlock,
         BetaMCPToolResultBlock,
         BetaContainerUploadBlock,
-        BetaThinkingBlock,
-        BetaRedactedThinkingBlock,
     ],
     PropertyInfo(discriminator="type"),
 ]

anthropic/types/beta/beta_content_block_param.py

@@ -11,6 +11,7 @@ from .beta_thinking_block_param import BetaThinkingBlockParam
 from .beta_tool_use_block_param import BetaToolUseBlockParam
 from .beta_tool_result_block_param import BetaToolResultBlockParam
 from .beta_mcp_tool_use_block_param import BetaMCPToolUseBlockParam
+from .beta_search_result_block_param import BetaSearchResultBlockParam
 from .beta_server_tool_use_block_param import BetaServerToolUseBlockParam
 from .beta_container_upload_block_param import BetaContainerUploadBlockParam
 from .beta_request_document_block_param import BetaRequestDocumentBlockParam
@@ -22,17 +23,18 @@ from .beta_code_execution_tool_result_block_param import BetaCodeExecutionToolRe
 __all__ = ["BetaContentBlockParam"]
 
 BetaContentBlockParam: TypeAlias = Union[
-    BetaServerToolUseBlockParam,
-    BetaWebSearchToolResultBlockParam,
-    BetaCodeExecutionToolResultBlockParam,
-    BetaMCPToolUseBlockParam,
-    BetaRequestMCPToolResultBlockParam,
     BetaTextBlockParam,
     BetaImageBlockParam,
-    BetaToolUseBlockParam,
-    BetaToolResultBlockParam,
     BetaRequestDocumentBlockParam,
+    BetaSearchResultBlockParam,
     BetaThinkingBlockParam,
     BetaRedactedThinkingBlockParam,
+    BetaToolUseBlockParam,
+    BetaToolResultBlockParam,
+    BetaServerToolUseBlockParam,
+    BetaWebSearchToolResultBlockParam,
+    BetaCodeExecutionToolResultBlockParam,
+    BetaMCPToolUseBlockParam,
+    BetaRequestMCPToolResultBlockParam,
     BetaContainerUploadBlockParam,
 ]

anthropic/types/beta/beta_message.py

@@ -83,6 +83,10 @@ class BetaMessage(BaseModel):
     - `"max_tokens"`: we exceeded the requested `max_tokens` or the model's maximum
     - `"stop_sequence"`: one of your provided custom `stop_sequences` was generated
     - `"tool_use"`: the model invoked one or more tools
+    - `"pause_turn"`: we paused a long-running turn. You may provide the response
+      back as-is in a subsequent request to let the model continue.
+    - `"refusal"`: when streaming classifiers intervene to handle potential policy
+      violations
 
     In non-streaming mode this value is always non-null. In streaming mode, it is
     null in the `message_start` event and non-null otherwise.

anthropic/types/beta/beta_raw_content_block_start_event.py

@@ -21,6 +21,8 @@ __all__ = ["BetaRawContentBlockStartEvent", "ContentBlock"]
 ContentBlock: TypeAlias = Annotated[
     Union[
         BetaTextBlock,
+        BetaThinkingBlock,
+        BetaRedactedThinkingBlock,
         BetaToolUseBlock,
         BetaServerToolUseBlock,
         BetaWebSearchToolResultBlock,
@@ -28,8 +30,6 @@ ContentBlock: TypeAlias = Annotated[
         BetaMCPToolUseBlock,
         BetaMCPToolResultBlock,
         BetaContainerUploadBlock,
-        BetaThinkingBlock,
-        BetaRedactedThinkingBlock,
     ],
     PropertyInfo(discriminator="type"),
 ]

anthropic/types/beta/beta_search_result_block_param.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Iterable, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+from .beta_text_block_param import BetaTextBlockParam
+from .beta_citations_config_param import BetaCitationsConfigParam
+from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
+
+__all__ = ["BetaSearchResultBlockParam"]
+
+
+class BetaSearchResultBlockParam(TypedDict, total=False):
+    content: Required[Iterable[BetaTextBlockParam]]
+
+    source: Required[str]
+
+    title: Required[str]
+
+    type: Required[Literal["search_result"]]
+
+    cache_control: Optional[BetaCacheControlEphemeralParam]
+    """Create a cache control breakpoint at this content block."""
+
+    citations: BetaCitationsConfigParam

anthropic/types/beta/beta_text_citation.py

@@ -7,6 +7,7 @@ from ..._utils import PropertyInfo
 from .beta_citation_char_location import BetaCitationCharLocation
 from .beta_citation_page_location import BetaCitationPageLocation
 from .beta_citation_content_block_location import BetaCitationContentBlockLocation
+from .beta_citation_search_result_location import BetaCitationSearchResultLocation
 from .beta_citations_web_search_result_location import BetaCitationsWebSearchResultLocation
 
 __all__ = ["BetaTextCitation"]
@@ -17,6 +18,7 @@ BetaTextCitation: TypeAlias = Annotated[
         BetaCitationPageLocation,
         BetaCitationContentBlockLocation,
         BetaCitationsWebSearchResultLocation,
+        BetaCitationSearchResultLocation,
     ],
     PropertyInfo(discriminator="type"),
 ]

anthropic/types/beta/beta_text_citation_param.py

@@ -8,6 +8,7 @@ from typing_extensions import TypeAlias
 from .beta_citation_char_location_param import BetaCitationCharLocationParam
 from .beta_citation_page_location_param import BetaCitationPageLocationParam
 from .beta_citation_content_block_location_param import BetaCitationContentBlockLocationParam
+from .beta_citation_search_result_location_param import BetaCitationSearchResultLocationParam
 from .beta_citation_web_search_result_location_param import BetaCitationWebSearchResultLocationParam
 
 __all__ = ["BetaTextCitationParam"]
@@ -17,4 +18,5 @@ BetaTextCitationParam: TypeAlias = Union[
     BetaCitationPageLocationParam,
     BetaCitationContentBlockLocationParam,
     BetaCitationWebSearchResultLocationParam,
+    BetaCitationSearchResultLocationParam,
 ]