feat(api): add thinking_mismatch_allowed entries to input_transformations (beta)

Stainless-Generated-From: fd851ba1d88ae230e58ff413cca443158a8a9b56

Author: anthropic-sdks-writer[bot]

api.md

@@ -572,6 +572,7 @@ from anthropic.types.beta import (
     BetaInputJSONDelta,
     BetaInputTokensClearAtLeast,
     BetaInputTokensTrigger,
+    BetaInputTransformation,
     BetaIterationsUsage,
     BetaJSONOutputFormat,
     BetaMCPToolConfig,
@@ -648,6 +649,7 @@ from anthropic.types.beta import (
     BetaThinkingConfigParam,
     BetaThinkingDelta,
     BetaThinkingDroppedInputTransformation,
+    BetaThinkingMismatchAllowedInputTransformation,
     BetaThinkingPrefixMismatchBehavior,
     BetaThinkingTurns,
     BetaTokenTaskBudget,

scripts/mock-spec.json.gz

@@ -115,6 +115,7 @@
 from .beta_advisor_result_block import BetaAdvisorResultBlock as BetaAdvisorResultBlock
 from .beta_dream_sessions_input import BetaDreamSessionsInput as BetaDreamSessionsInput
 from .beta_fallback_block_param import BetaFallbackBlockParam as BetaFallbackBlockParam
+from .beta_input_transformation import BetaInputTransformation as BetaInputTransformation
 from .beta_managed_agents_agent import BetaManagedAgentsAgent as BetaManagedAgentsAgent
 from .beta_managed_agents_model import BetaManagedAgentsModel as BetaManagedAgentsModel
 from .beta_managed_agents_vault import BetaManagedAgentsVault as BetaManagedAgentsVault
@@ -978,6 +979,9 @@
 from .beta_text_editor_code_execution_create_result_block import (
     BetaTextEditorCodeExecutionCreateResultBlock as BetaTextEditorCodeExecutionCreateResultBlock,
 )
+from .beta_thinking_mismatch_allowed_input_transformation import (
+    BetaThinkingMismatchAllowedInputTransformation as BetaThinkingMismatchAllowedInputTransformation,
+)
 from .beta_managed_agents_agent_toolset20260401_bash_input import (
     BetaManagedAgentsAgentToolset20260401BashInput as BetaManagedAgentsAgentToolset20260401BashInput,
 )

src/anthropic/types/beta/__init__.py

@@ -0,0 +1,13 @@
+from typing import Union
+from typing_extensions import Annotated, TypeAlias
+
+from ..._models import UnionDiscriminator
+from .beta_thinking_dropped_input_transformation import BetaThinkingDroppedInputTransformation
+from .beta_thinking_mismatch_allowed_input_transformation import BetaThinkingMismatchAllowedInputTransformation
+
+__all__ = ["BetaInputTransformation"]
+
+BetaInputTransformation: TypeAlias = Annotated[
+    Union[BetaThinkingDroppedInputTransformation, BetaThinkingMismatchAllowedInputTransformation],
+    UnionDiscriminator("type"),
+]

src/anthropic/types/beta/beta_input_transformation.py

@@ -8,10 +8,10 @@
 from .beta_diagnostics import BetaDiagnostics
 from .beta_stop_reason import BetaStopReason
 from .beta_content_block import BetaContentBlock, BetaContentBlock as BetaContentBlock
+from .beta_input_transformation import BetaInputTransformation
 from .beta_message_param import BetaMessageParam
 from .beta_refusal_stop_details import BetaRefusalStopDetails
 from .beta_context_management_response import BetaContextManagementResponse
-from .beta_thinking_dropped_input_transformation import BetaThinkingDroppedInputTransformation
 
 __all__ = ["BetaMessage"]
 
@@ -143,23 +143,28 @@ class BetaMessage(BaseModel):
     `cache_creation_input_tokens`, and `cache_read_input_tokens`.
     """
 
-    input_transformations: Optional[List[BetaThinkingDroppedInputTransformation]] = None
+    input_transformations: Optional[List[BetaInputTransformation]] = None
     """
-    Changes the API made to the request's input before showing it to the model: one
-    entry per change, in request order. Today the only entry type is
-    `thinking_dropped` — a `thinking`, `redacted_thinking` or `connector_text` block
-    from the request's `messages` that was removed from the prompt instead of being
-    shown to the model because it failed a binding check. More entry types may be
-    added over time; ignore types you do not recognize.
+    Changes the API made to the request's input before showing it to the model, and
+    blocks that failed a binding check but were left unchanged: one entry per block,
+    in request order. Two entry types today. `thinking_dropped` — a `thinking`,
+    `redacted_thinking` or `connector_text` block from the request's `messages` that
+    was removed from the prompt instead of being shown to the model because it
+    failed a binding check. `thinking_mismatch_allowed` — a `thinking` or
+    `redacted_thinking` block that failed the conversation check (the conversation
+    before it differs from the one it was created in, or it carries no record of one
+    on a model that requires it) and was shown to the model all the same, because
+    that check is not enforced for this request. More entry types may be added over
+    time; ignore types you do not recognize.
 
     Requires `anthropic-beta: thinking-binding-controls-2026-08-01`. Present on
     every such response from a model that supports extended thinking, as `[]` when
-    nothing was changed; without the beta, blocks are removed all the same but
-    nothing is reported. Removed blocks contribute nothing to `usage.input_tokens`.
-    When streaming, the array is final in `message_start`; the final `message_delta`
-    event carries it only when a server-side model fallback happened mid-stream, in
-    which case it holds the serving model's entries and replaces the one in
-    `message_start`.
+    there is no entry to report; without the beta, blocks are removed or left in
+    place all the same but nothing is reported. Removed blocks contribute nothing to
+    `usage.input_tokens`; blocks left in place count as sent. When streaming, the
+    array is final in `message_start`; the final `message_delta` event carries it
+    only when a server-side model fallback happened mid-stream, in which case it
+    holds the serving model's entries and replaces the one in `message_start`.
     """
 
     def to_param(self) -> BetaMessageParam:

src/anthropic/types/beta/beta_message.py

@@ -1,15 +1,16 @@
-from typing import List, Optional
-from typing_extensions import Literal
+from typing import List, Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
 
-from ..._models import BaseModel
+from ..._models import BaseModel, UnionDiscriminator
 from .beta_container import BetaContainer
 from .beta_stop_reason import BetaStopReason
 from .beta_message_delta_usage import BetaMessageDeltaUsage
 from .beta_refusal_stop_details import BetaRefusalStopDetails
 from .beta_context_management_response import BetaContextManagementResponse
 from .beta_thinking_dropped_input_transformation import BetaThinkingDroppedInputTransformation
+from .beta_thinking_mismatch_allowed_input_transformation import BetaThinkingMismatchAllowedInputTransformation
 
-__all__ = ["BetaRawMessageDeltaEvent", "Delta"]
+__all__ = ["BetaRawMessageDeltaEvent", "Delta", "InputTransformation"]
 
 
 class Delta(BaseModel):
@@ -27,6 +28,12 @@ class Delta(BaseModel):
     stop_sequence: Optional[str] = None
 
 
+InputTransformation: TypeAlias = Annotated[
+    Union[BetaThinkingDroppedInputTransformation, BetaThinkingMismatchAllowedInputTransformation],
+    UnionDiscriminator("type"),
+]
+
+
 class BetaRawMessageDeltaEvent(BaseModel):
     context_management: Optional[BetaContextManagementResponse] = None
     """Information about context management strategies applied during the request"""
@@ -53,21 +60,26 @@ class BetaRawMessageDeltaEvent(BaseModel):
     `cache_creation_input_tokens`, and `cache_read_input_tokens`.
     """
 
-    input_transformations: Optional[List[BetaThinkingDroppedInputTransformation]] = None
+    input_transformations: Optional[List[InputTransformation]] = None
     """
-    Changes the API made to the request's input before showing it to the model: one
-    entry per change, in request order. Today the only entry type is
-    `thinking_dropped` — a `thinking`, `redacted_thinking` or `connector_text` block
-    from the request's `messages` that was removed from the prompt instead of being
-    shown to the model because it failed a binding check. More entry types may be
-    added over time; ignore types you do not recognize.
+    Changes the API made to the request's input before showing it to the model, and
+    blocks that failed a binding check but were left unchanged: one entry per block,
+    in request order. Two entry types today. `thinking_dropped` — a `thinking`,
+    `redacted_thinking` or `connector_text` block from the request's `messages` that
+    was removed from the prompt instead of being shown to the model because it
+    failed a binding check. `thinking_mismatch_allowed` — a `thinking` or
+    `redacted_thinking` block that failed the conversation check (the conversation
+    before it differs from the one it was created in, or it carries no record of one
+    on a model that requires it) and was shown to the model all the same, because
+    that check is not enforced for this request. More entry types may be added over
+    time; ignore types you do not recognize.
 
     Requires `anthropic-beta: thinking-binding-controls-2026-08-01`. Present on
     every such response from a model that supports extended thinking, as `[]` when
-    nothing was changed; without the beta, blocks are removed all the same but
-    nothing is reported. Removed blocks contribute nothing to `usage.input_tokens`.
-    When streaming, the array is final in `message_start`; the final `message_delta`
-    event carries it only when a server-side model fallback happened mid-stream, in
-    which case it holds the serving model's entries and replaces the one in
-    `message_start`.
+    there is no entry to report; without the beta, blocks are removed or left in
+    place all the same but nothing is reported. Removed blocks contribute nothing to
+    `usage.input_tokens`; blocks left in place count as sent. When streaming, the
+    array is final in `message_start`; the final `message_delta` event carries it
+    only when a server-side model fallback happened mid-stream, in which case it
+    holds the serving model's entries and replaces the one in `message_start`.
     """

src/anthropic/types/beta/beta_raw_message_delta_event.py

@@ -0,0 +1,35 @@
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["BetaThinkingMismatchAllowedInputTransformation"]
+
+
+class BetaThinkingMismatchAllowedInputTransformation(BaseModel):
+    path: str
+    """
+    Where the block is in your request, as `messages.{i}.content.{j}`: `i` indexes
+    the `messages` array you sent and `j` that message's `content` array — the same
+    form error messages use.
+    """
+
+    reason: Literal[
+        "model_binding_mismatch",
+        "prefix_binding_mismatch",
+        "organization_binding_mismatch",
+        "end_user_binding_mismatch",
+    ]
+    """
+    Which binding check the block failed; the block was shown to the model all the
+    same. Always `prefix_binding_mismatch` today — the conversation before the block
+    differs from the conversation it was created in, or the block carries no record
+    of one on a model that requires it. Were the check enforced for this request,
+    the block would have been removed or the request rejected
+    (`thinking.block_binding.prefix_mismatch_behavior`). A removal also takes the
+    rest of that turn's consecutive thinking blocks, whereas here each block is
+    checked on its own, so `thinking_mismatch_allowed` entries are a lower bound on
+    what enforcement would remove.
+    """
+
+    type: Literal["thinking_mismatch_allowed"]
+    """Always `thinking_mismatch_allowed` for this entry type."""