feat(api): add ability to clear thinking in context management

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 34
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-baca86203d0f4f4f2413b8da9237f7353b28b4b2251937fdcf33fe758e08ead2.yml
-openapi_spec_hash: 327b1deb1eba170331a3ac42eabedfbe
-config_hash: 57f9ccec4116f3b6706647d4e9200482
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/anthropic%2Fanthropic-5e665f72d2774cd751988ccc94f623f264d9358aa073289779de5815d36e89a3.yml
+openapi_spec_hash: c5f969a677c73796d192cf09dbb047f9
+config_hash: fd2165a5f09975707d3c0f6f78fb2be7

api.md

@@ -202,6 +202,7 @@ Types:
 
 ```python
 from anthropic.types.beta import (
+    BetaAllThinkingTurns,
     BetaBase64ImageSource,
     BetaBase64PDFSource,
     BetaBashCodeExecutionOutputBlock,
@@ -227,6 +228,8 @@ from anthropic.types.beta import (
     BetaCitationsConfigParam,
     BetaCitationsDelta,
     BetaCitationsWebSearchResultLocation,
+    BetaClearThinking20251015Edit,
+    BetaClearThinking20251015EditResponse,
     BetaClearToolUses20250919Edit,
     BetaClearToolUses20250919EditResponse,
     BetaCodeExecutionOutputBlock,
@@ -320,6 +323,7 @@ from anthropic.types.beta import (
     BetaThinkingConfigEnabled,
     BetaThinkingConfigParam,
     BetaThinkingDelta,
+    BetaThinkingTurns,
     BetaTool,
     BetaToolBash20241022,
     BetaToolBash20250124,

src/anthropic/types/beta/__init__.py

@@ -52,6 +52,7 @@
 from .beta_text_citation_param import BetaTextCitationParam as BetaTextCitationParam
 from .beta_message_tokens_count import BetaMessageTokensCount as BetaMessageTokensCount
 from .beta_thinking_block_param import BetaThinkingBlockParam as BetaThinkingBlockParam
+from .beta_thinking_turns_param import BetaThinkingTurnsParam as BetaThinkingTurnsParam
 from .beta_tool_use_block_param import BetaToolUseBlockParam as BetaToolUseBlockParam
 from .beta_tool_uses_keep_param import BetaToolUsesKeepParam as BetaToolUsesKeepParam
 from .beta_url_pdf_source_param import BetaURLPDFSourceParam as BetaURLPDFSourceParam
@@ -81,6 +82,7 @@
 from .beta_tool_result_block_param import BetaToolResultBlockParam as BetaToolResultBlockParam
 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_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
@@ -140,6 +142,9 @@
 from .beta_web_fetch_tool_result_block_param import BetaWebFetchToolResultBlockParam as BetaWebFetchToolResultBlockParam
 from .beta_web_fetch_tool_result_error_block import BetaWebFetchToolResultErrorBlock as BetaWebFetchToolResultErrorBlock
 from .beta_web_search_tool_result_error_code import BetaWebSearchToolResultErrorCode as BetaWebSearchToolResultErrorCode
+from .beta_clear_thinking_20251015_edit_param import (
+    BetaClearThinking20251015EditParam as BetaClearThinking20251015EditParam,
+)
 from .beta_code_execution_tool_20250522_param import (
     BetaCodeExecutionTool20250522Param as BetaCodeExecutionTool20250522Param,
 )
@@ -191,6 +196,9 @@
 from .beta_citation_search_result_location_param import (
     BetaCitationSearchResultLocationParam as BetaCitationSearchResultLocationParam,
 )
+from .beta_clear_thinking_20251015_edit_response import (
+    BetaClearThinking20251015EditResponse as BetaClearThinking20251015EditResponse,
+)
 from .beta_code_execution_tool_result_error_code import (
     BetaCodeExecutionToolResultErrorCode as BetaCodeExecutionToolResultErrorCode,
 )

src/anthropic/types/beta/beta_all_thinking_turns_param.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["BetaAllThinkingTurnsParam"]
+
+
+class BetaAllThinkingTurnsParam(TypedDict, total=False):
+    type: Required[Literal["all"]]

src/anthropic/types/beta/beta_clear_thinking_20251015_edit_param.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, Required, TypeAlias, TypedDict
+
+from .beta_thinking_turns_param import BetaThinkingTurnsParam
+from .beta_all_thinking_turns_param import BetaAllThinkingTurnsParam
+
+__all__ = ["BetaClearThinking20251015EditParam", "Keep"]
+
+Keep: TypeAlias = Union[BetaThinkingTurnsParam, BetaAllThinkingTurnsParam, Literal["all"]]
+
+
+class BetaClearThinking20251015EditParam(TypedDict, total=False):
+    type: Required[Literal["clear_thinking_20251015"]]
+
+    keep: Keep
+    """Number of most recent assistant turns to keep thinking blocks for.
+
+    Older turns will have their thinking blocks removed.
+    """

src/anthropic/types/beta/beta_clear_thinking_20251015_edit_response.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaClearThinking20251015EditResponse"]
+
+
+class BetaClearThinking20251015EditResponse(BaseModel):
+    cleared_input_tokens: int
+    """Number of input tokens cleared by this edit."""
+
+    cleared_thinking_turns: int
+    """Number of thinking turns that were cleared."""
+
+    type: Literal["clear_thinking_20251015"]
+    """The type of context management edit applied."""

src/anthropic/types/beta/beta_context_management_config_param.py

@@ -2,14 +2,17 @@
 
 from __future__ import annotations
 
-from typing import Iterable
-from typing_extensions import TypedDict
+from typing import Union, Iterable
+from typing_extensions import TypeAlias, TypedDict
 
+from .beta_clear_thinking_20251015_edit_param import BetaClearThinking20251015EditParam
 from .beta_clear_tool_uses_20250919_edit_param import BetaClearToolUses20250919EditParam
 
-__all__ = ["BetaContextManagementConfigParam"]
+__all__ = ["BetaContextManagementConfigParam", "Edit"]
+
+Edit: TypeAlias = Union[BetaClearToolUses20250919EditParam, BetaClearThinking20251015EditParam]
 
 
 class BetaContextManagementConfigParam(TypedDict, total=False):
-    edits: Iterable[BetaClearToolUses20250919EditParam]
+    edits: Iterable[Edit]
     """List of context management edits to apply"""

src/anthropic/types/beta/beta_context_management_response.py

@@ -1,13 +1,21 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List
+from typing import List, Union
+from typing_extensions import Annotated, TypeAlias
 
+from ..._utils import PropertyInfo
 from ..._models import BaseModel
+from .beta_clear_thinking_20251015_edit_response import BetaClearThinking20251015EditResponse
 from .beta_clear_tool_uses_20250919_edit_response import BetaClearToolUses20250919EditResponse
 
-__all__ = ["BetaContextManagementResponse"]
+__all__ = ["BetaContextManagementResponse", "AppliedEdit"]
+
+AppliedEdit: TypeAlias = Annotated[
+    Union[BetaClearToolUses20250919EditResponse, BetaClearThinking20251015EditResponse],
+    PropertyInfo(discriminator="type"),
+]
 
 
 class BetaContextManagementResponse(BaseModel):
-    applied_edits: List[BetaClearToolUses20250919EditResponse]
+    applied_edits: List[AppliedEdit]
     """List of context management edits that were applied."""

src/anthropic/types/beta/beta_mcp_tool_use_block.py

@@ -1,5 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from typing import Dict
 from typing_extensions import Literal
 
 from ..._models import BaseModel
@@ -10,7 +11,7 @@
 class BetaMCPToolUseBlock(BaseModel):
     id: str
 
-    input: object
+    input: Dict[str, object]
 
     name: str
     """The name of the MCP tool"""

src/anthropic/types/beta/beta_mcp_tool_use_block_param.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import Literal, Required, TypedDict
 
 from .beta_cache_control_ephemeral_param import BetaCacheControlEphemeralParam
@@ -13,7 +13,7 @@
 class BetaMCPToolUseBlockParam(TypedDict, total=False):
     id: Required[str]
 
-    input: Required[object]
+    input: Required[Dict[str, object]]
 
     name: Required[str]