anthropic 1.46.0 → 1.47.0

data/lib/anthropic/models/beta/beta_model_info.rb

@@ -11,6 +11,14 @@ module Anthropic
         #   @return [String]
         required :id, String
 
+        # @!attribute allowed_fallback_models
+        #   Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An
+        #   empty list means the `fallbacks` parameter is not supported for this model as
+        #   primary.
+        #
+        #   @return [Array<String>, nil]
+        required :allowed_fallback_models, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
         # @!attribute capabilities
         #   Model capability information.
         #
@@ -50,12 +58,14 @@ module Anthropic
         #   @return [Symbol, :model]
         required :type, const: :model
 
-        # @!method initialize(id:, capabilities:, created_at:, display_name:, max_input_tokens:, max_tokens:, type: :model)
+        # @!method initialize(id:, allowed_fallback_models:, capabilities:, created_at:, display_name:, max_input_tokens:, max_tokens:, type: :model)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaModelInfo} for more details.
         #
         #   @param id [String] Unique model identifier.
         #
+        #   @param allowed_fallback_models [Array<String>, nil] Model IDs this model accepts as `fallbacks[i].model` on the Messages API. An emp
+        #
         #   @param capabilities [Anthropic::Models::Beta::BetaModelCapabilities, nil] Model capability information.
         #
         #   @param created_at [Time] RFC 3339 datetime string representing the time at which the model was released.

data/lib/anthropic/models/beta/beta_raw_content_block_start_event.rb

@@ -7,7 +7,7 @@ module Anthropic
         # @!attribute content_block
         #   Response model for a file uploaded to the container.
         #
-        #   @return [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock]
+        #   @return [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock]
         required :content_block, union: -> { Anthropic::Beta::BetaRawContentBlockStartEvent::ContentBlock }
 
         # @!attribute index
@@ -21,7 +21,7 @@ module Anthropic
         required :type, const: :content_block_start
 
         # @!method initialize(content_block:, index:, type: :content_block_start)
-        #   @param content_block [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock] Response model for a file uploaded to the container.
+        #   @param content_block [Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock] Response model for a file uploaded to the container.
         #
         #   @param index [Integer]
         #
@@ -74,8 +74,21 @@ module Anthropic
           # compaction blocks with null content; the server treats them as no-ops.
           variant :compaction, -> { Anthropic::Beta::BetaCompactionBlock }
 
+          # Marks the point in `content` where one model's output gives way to the next.
+          #
+          # One block appears per hop where a preceding model actually ran this turn and
+          # declined. A turn routed directly by the sticky decision has no such boundary
+          # and carries no block — the signal for whether a fallback model served the
+          # response is the presence of a `fallback_message` entry in
+          # `usage.iterations`, not this block.
+          #
+          # The block is treated like a server-tool content block for streaming: it
+          # arrives via the standard `content_block_start` / `content_block_stop`
+          # pair and carries no deltas.
+          variant :fallback, -> { Anthropic::Beta::BetaFallbackBlock }
+
           # @!method self.variants
-          #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock)]
+          #   @return [Array(Anthropic::Models::Beta::BetaTextBlock, Anthropic::Models::Beta::BetaThinkingBlock, Anthropic::Models::Beta::BetaRedactedThinkingBlock, Anthropic::Models::Beta::BetaToolUseBlock, Anthropic::Models::Beta::BetaServerToolUseBlock, Anthropic::Models::Beta::BetaWebSearchToolResultBlock, Anthropic::Models::Beta::BetaWebFetchToolResultBlock, Anthropic::Models::Beta::BetaAdvisorToolResultBlock, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlock, Anthropic::Models::Beta::BetaToolSearchToolResultBlock, Anthropic::Models::Beta::BetaMCPToolUseBlock, Anthropic::Models::Beta::BetaMCPToolResultBlock, Anthropic::Models::Beta::BetaContainerUploadBlock, Anthropic::Models::Beta::BetaCompactionBlock, Anthropic::Models::Beta::BetaFallbackBlock)]
         end
       end
     end

data/lib/anthropic/models/beta/beta_refusal_stop_details.rb

@@ -21,12 +21,68 @@ module Anthropic
         #   @return [String, nil]
         required :explanation, String, nil?: true
 
+        # @!attribute fallback_credit_token
+        #   Opaque code that refunds the cache-miss cost when retrying this refused request
+        #   on the fallback model. Pass it as `fallback_credit_token` on the retry request.
+        #   Expires 5 minutes after the refusal.
+        #
+        #   The retry is sent either with the same request body (`system`, `messages`,
+        #   `tools`, and other render-shaping fields), or with the same body plus one
+        #   appended `assistant` message whose content is the partial text (with any
+        #   trailing whitespace stripped from the final text block) and paired server-tool
+        #   blocks from this refusal — which also authorizes that appended turn as an
+        #   assistant-prefill continuation on models that otherwise disallow prefill. A
+        #   token minted mid-server-tool-loop whose partial content was continuable may only
+        #   be redeemed the second way — if a same-body retry is rejected with a 400 saying
+        #   the token must be redeemed by continuing the partial response, retry the second
+        #   way instead. Either way: same workspace, same platform; a mismatch is a 400.
+        #   Resending a token for an already-warm prefix is permitted but yields no
+        #   additional credit.
+        #
+        #   `null` when the refused model isn't eligible for a fallback credit.
+        #
+        #   @return [String, nil]
+        required :fallback_credit_token, String, nil?: true
+
+        # @!attribute fallback_has_prefill_claim
+        #   Whether the accompanying `fallback_credit_token` may be redeemed with the
+        #   appended-assistant retry form. Only set when `fallback_credit_token` is present.
+        #
+        #   `true`: retry by resending the same request body plus one appended `assistant`
+        #   message whose content is this response's `content` with any trailing whitespace
+        #   stripped from the final text block and unpaired `tool_use` blocks omitted (the
+        #   same appended-turn shape described on `fallback_credit_token`), with the token
+        #   attached. `false`: retry by resending the original request body unchanged, with
+        #   the token attached — the appended-assistant form is not available for this
+        #   refusal (no continuable partial content, or the request uses `output_format` or
+        #   a `tool_choice` that forces tool use). One exception: when the request used
+        #   `output_format` or a forced `tool_choice` and the refusal arrived after server
+        #   tools (including MCP connector tools) had already executed, the token may not be
+        #   redeemable by either retry form; if the exact-body retry is then rejected with a
+        #   400 saying the token must be redeemed by continuing the partial response,
+        #   discard the token and retry without it.
+        #
+        #   Advisory: if an appended-assistant retry is rejected with a 400 despite `true`,
+        #   fall back to resending the original request body with the token.
+        #
+        #   @return [Boolean, nil]
+        required :fallback_has_prefill_claim, Anthropic::Internal::Type::Boolean, nil?: true
+
+        # @!attribute recommended_model
+        #   The server's suggested retry target for this refusal. Populated when a fallback
+        #   attempt could not be made (the fallback model's rate limit was exhausted, or it
+        #   was overloaded); names the fallback model the caller can retry directly. Null
+        #   otherwise.
+        #
+        #   @return [String, nil]
+        required :recommended_model, String, nil?: true
+
         # @!attribute type
         #
         #   @return [Symbol, :refusal]
         required :type, const: :refusal
 
-        # @!method initialize(category:, explanation:, type: :refusal)
+        # @!method initialize(category:, explanation:, fallback_credit_token:, fallback_has_prefill_claim:, recommended_model:, type: :refusal)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaRefusalStopDetails} for more details.
         #
@@ -36,6 +92,12 @@ module Anthropic
         #
         #   @param explanation [String, nil] Human-readable explanation of the refusal.
         #
+        #   @param fallback_credit_token [String, nil] Opaque code that refunds the cache-miss cost when retrying this refused
+        #
+        #   @param fallback_has_prefill_claim [Boolean, nil] Whether the accompanying `fallback_credit_token` may be redeemed with the
+        #
+        #   @param recommended_model [String, nil] The server's suggested retry target for this refusal. Populated when a fallback
+        #
         #   @param type [Symbol, :refusal]
 
         # The policy category that triggered the refusal.
@@ -48,6 +110,7 @@ module Anthropic
 
           CYBER = :cyber
           BIO = :bio
+          REASONING_EXTRACTION = :reasoning_extraction
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/anthropic/models/beta/beta_usage.rb

@@ -44,7 +44,7 @@ module Anthropic
         #   - Calculate the true context window size from the last iteration
         #   - Understand token accumulation across server-side tool use loops
         #
-        #   @return [Array<Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage, Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage>, nil]
+        #   @return [Array<Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage, Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage, Anthropic::Models::Beta::BetaFallbackMessageIterationUsage>, nil]
         required :iterations,
                  -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaIterationsUsageItem] },
                  nil?: true
@@ -98,7 +98,7 @@ module Anthropic
         #
         #   @param input_tokens [Integer] The number of input tokens which were used.
         #
-        #   @param iterations [Array<Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage, Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage>, nil] Per-iteration token usage breakdown.
+        #   @param iterations [Array<Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage, Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage, Anthropic::Models::Beta::BetaFallbackMessageIterationUsage>, nil] Per-iteration token usage breakdown.
         #
         #   @param output_tokens [Integer] The number of output tokens which were used.
         #

data/lib/anthropic/models/beta/message_create_params.rb

@@ -134,6 +134,40 @@ module Anthropic
         #   @return [Anthropic::Models::Beta::BetaDiagnosticsParam, nil]
         optional :diagnostics, -> { Anthropic::Beta::BetaDiagnosticsParam }, nil?: true
 
+        # @!attribute fallback_credit_token
+        #   The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        #   When a preceding request was refused and returned a `fallback_credit_token`,
+        #   pass that code here on the retry to have the retry's cache-creation tokens for
+        #   the prefix that was warm on the refused model billed at the cache-read rate.
+        #   Must be redeemed by the same organization and workspace, with the same request
+        #   body (optionally extended by one appended `assistant` message whose content is
+        #   the partial text — with any trailing whitespace stripped from the final text
+        #   block — and paired server-tool blocks streamed before the refusal; the
+        #   appended-assistant form is not available for requests with `output_format` set
+        #   or forced `tool_choice`), on an eligible fallback model, on the same platform,
+        #   and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+        #   mid-server-tool-loop whose partial content was continuable may only be redeemed
+        #   with the appended-assistant form — if an exact-body retry is rejected with a 400
+        #   saying the token must be redeemed by continuing the partial response, retry with
+        #   the appended-assistant form instead.
+        #
+        #   When the appended-assistant form is used on a model that otherwise disallows
+        #   assistant-turn prefill, this token also authorizes that one prefill.
+        #
+        #   @return [String, nil]
+        optional :fallback_credit_token, String, nil?: true
+
+        # @!attribute fallbacks
+        #   Opt-in server-side retry on one or more substitute models when the requested
+        #   model declines for policy reasons. Tried in order: if the first entry also
+        #   declines, the second is tried, and so on.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil]
+        optional :fallbacks,
+                 -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaFallbackParam] },
+                 nil?: true
+
         # @!attribute inference_geo
         #   Specifies the geographic region for inference processing. If not specified, the
         #   workspace's `default_inference_geo` is used.
@@ -374,7 +408,7 @@ module Anthropic
         #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
-        # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
+        # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
@@ -392,6 +426,10 @@ module Anthropic
         #
         #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Request-level diagnostics. Currently carries the previous response
         #
+        #   @param fallback_credit_token [String, nil] The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        #   @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Opt-in server-side retry on one or more substitute models when the requested mod
+        #
         #   @param inference_geo [String, nil] Specifies the geographic region for inference processing. If not specified, the
         #
         #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] MCP servers to be utilized in this request

data/lib/anthropic/models/beta/messages/batch_create_params.rb

@@ -189,6 +189,40 @@ module Anthropic
               #   @return [Anthropic::Models::Beta::BetaDiagnosticsParam, nil]
               optional :diagnostics, -> { Anthropic::Beta::BetaDiagnosticsParam }, nil?: true
 
+              # @!attribute fallback_credit_token
+              #   The `fallback_credit_token` from a prior refusal's `stop_details`.
+              #
+              #   When a preceding request was refused and returned a `fallback_credit_token`,
+              #   pass that code here on the retry to have the retry's cache-creation tokens for
+              #   the prefix that was warm on the refused model billed at the cache-read rate.
+              #   Must be redeemed by the same organization and workspace, with the same request
+              #   body (optionally extended by one appended `assistant` message whose content is
+              #   the partial text — with any trailing whitespace stripped from the final text
+              #   block — and paired server-tool blocks streamed before the refusal; the
+              #   appended-assistant form is not available for requests with `output_format` set
+              #   or forced `tool_choice`), on an eligible fallback model, on the same platform,
+              #   and within 5 minutes of the refusal; a mismatch is a 400. A token minted
+              #   mid-server-tool-loop whose partial content was continuable may only be redeemed
+              #   with the appended-assistant form — if an exact-body retry is rejected with a 400
+              #   saying the token must be redeemed by continuing the partial response, retry with
+              #   the appended-assistant form instead.
+              #
+              #   When the appended-assistant form is used on a model that otherwise disallows
+              #   assistant-turn prefill, this token also authorizes that one prefill.
+              #
+              #   @return [String, nil]
+              optional :fallback_credit_token, String, nil?: true
+
+              # @!attribute fallbacks
+              #   Opt-in server-side retry on one or more substitute models when the requested
+              #   model declines for policy reasons. Tried in order: if the first entry also
+              #   declines, the second is tried, and so on.
+              #
+              #   @return [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil]
+              optional :fallbacks,
+                       -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaFallbackParam] },
+                       nil?: true
+
               # @!attribute inference_geo
               #   Specifies the geographic region for inference processing. If not specified, the
               #   workspace's `default_inference_geo` is used.
@@ -436,7 +470,7 @@ module Anthropic
               #   @return [String, nil]
               optional :user_profile_id, String, nil?: true
 
-              # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil)
+              # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil)
               #   Some parameter documentations has been truncated, see
               #   {Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params} for more
               #   details.
@@ -460,6 +494,10 @@ module Anthropic
               #
               #   @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Request-level diagnostics. Currently carries the previous response
               #
+              #   @param fallback_credit_token [String, nil] The `fallback_credit_token` from a prior refusal's `stop_details`.
+              #
+              #   @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Opt-in server-side retry on one or more substitute models when the requested mod
+              #
               #   @param inference_geo [String, nil] Specifies the geographic region for inference processing. If not specified, the
               #
               #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] MCP servers to be utilized in this request

data/lib/anthropic/models/model.rb

@@ -9,6 +9,10 @@ module Anthropic
     module Model
       extend Anthropic::Internal::Type::Union
 
+      variant const: -> { Anthropic::Models::Model::CLAUDE_FABLE_5 }
+
+      variant const: -> { Anthropic::Models::Model::CLAUDE_MYTHOS_5 }
+
       variant const: -> { Anthropic::Models::Model::CLAUDE_OPUS_4_8 }
 
       variant const: -> { Anthropic::Models::Model::CLAUDE_OPUS_4_7 }
@@ -56,6 +60,12 @@ module Anthropic
 
       # @!group
 
+      # Next generation of intelligence for the hardest knowledge work and coding problems
+      CLAUDE_FABLE_5 = :"claude-fable-5"
+
+      # Most capable model for cybersecurity and biology research
+      CLAUDE_MYTHOS_5 = :"claude-mythos-5"
+
       # Frontier intelligence for long-running agents and coding
       CLAUDE_OPUS_4_8 = :"claude-opus-4-8"
 
@@ -63,6 +73,9 @@ module Anthropic
       CLAUDE_OPUS_4_7 = :"claude-opus-4-7"
 
       # New class of intelligence, strongest in coding and cybersecurity
+      # @deprecated Will reach end-of-life on June 30, 2026. Please migrate to claude-mythos-5.
+      # Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more
+      # information.
       CLAUDE_MYTHOS_PREVIEW = :"claude-mythos-preview"
 
       # Frontier intelligence for long-running agents and coding

data/lib/anthropic/models/refusal_stop_details.rb

@@ -47,6 +47,7 @@ module Anthropic
 
         CYBER = :cyber
         BIO = :bio
+        REASONING_EXTRACTION = :reasoning_extraction
 
         # @!method self.values
         #   @return [Array<Symbol>]

data/lib/anthropic/resources/beta/messages.rb

@@ -40,7 +40,7 @@ module Anthropic
         # Learn more about the Messages API in our
         # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload create(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
+        # @overload create(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -56,6 +56,10 @@ module Anthropic
         #
         # @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Body param: Request-level diagnostics. Currently carries the previous response
         #
+        # @param fallback_credit_token [String, nil] Body param: The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        # @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Body param: Opt-in server-side retry on one or more substitute models when the r
+        #
         # @param inference_geo [String, nil] Body param: Specifies the geographic region for inference processing. If not spe
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request
@@ -150,7 +154,7 @@ module Anthropic
         # Learn more about the Messages API in our
         # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
+        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, user_profile_id: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -166,6 +170,10 @@ module Anthropic
         #
         # @param diagnostics [Anthropic::Models::Beta::BetaDiagnosticsParam, nil] Body param: Request-level diagnostics. Currently carries the previous response
         #
+        # @param fallback_credit_token [String, nil] Body param: The `fallback_credit_token` from a prior refusal's `stop_details`.
+        #
+        # @param fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil] Body param: Opt-in server-side retry on one or more substitute models when the r
+        #
         # @param inference_geo [String, nil] Body param: Specifies the geographic region for inference processing. If not spe
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request

data/lib/anthropic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Anthropic
-  VERSION = "1.46.0"
+  VERSION = "1.47.0"
 end

data/lib/anthropic.rb

@@ -205,6 +205,12 @@ require_relative "anthropic/models/beta/beta_encrypted_code_execution_result_blo
 require_relative "anthropic/models/beta/beta_encrypted_code_execution_result_block_param"
 require_relative "anthropic/models/beta/beta_environment"
 require_relative "anthropic/models/beta/beta_environment_delete_response"
+require_relative "anthropic/models/beta/beta_fallback_block"
+require_relative "anthropic/models/beta/beta_fallback_block_param"
+require_relative "anthropic/models/beta/beta_fallback_info"
+require_relative "anthropic/models/beta/beta_fallback_info_param"
+require_relative "anthropic/models/beta/beta_fallback_message_iteration_usage"
+require_relative "anthropic/models/beta/beta_fallback_param"
 require_relative "anthropic/models/beta/beta_file_document_source"
 require_relative "anthropic/models/beta/beta_file_image_source"
 require_relative "anthropic/models/beta/beta_file_scope"

data/rbi/anthropic/models/anthropic_beta.rbi

@@ -118,6 +118,16 @@ module Anthropic
           :"thinking-token-count-2026-05-13",
           Anthropic::AnthropicBeta::TaggedSymbol
         )
+      SERVER_SIDE_FALLBACK_2026_06_01 =
+        T.let(
+          :"server-side-fallback-2026-06-01",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
+      FALLBACK_CREDIT_2026_06_01 =
+        T.let(
+          :"fallback-credit-2026-06-01",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
     end
   end
 end

data/rbi/anthropic/models/beta/beta_content_block.rbi

@@ -27,7 +27,8 @@ module Anthropic
               Anthropic::Beta::BetaMCPToolUseBlock,
               Anthropic::Beta::BetaMCPToolResultBlock,
               Anthropic::Beta::BetaContainerUploadBlock,
-              Anthropic::Beta::BetaCompactionBlock
+              Anthropic::Beta::BetaCompactionBlock,
+              Anthropic::Beta::BetaFallbackBlock
             )
           end
 

data/rbi/anthropic/models/beta/beta_content_block_param.rbi

@@ -32,7 +32,8 @@ module Anthropic
               Anthropic::Beta::BetaRequestMCPToolResultBlockParam,
               Anthropic::Beta::BetaContainerUploadBlockParam,
               Anthropic::Beta::BetaCompactionBlockParam,
-              Anthropic::Beta::BetaMidConversationSystemBlockParam
+              Anthropic::Beta::BetaMidConversationSystemBlockParam,
+              Anthropic::Beta::BetaFallbackBlockParam
             )
           end
 

data/rbi/anthropic/models/beta/beta_fallback_block.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackBlock = Beta::BetaFallbackBlock
+
+    module Beta
+      class BetaFallbackBlock < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackBlock,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The model whose output ends at this point — the model that declined at this hop.
+        # When the declining hop is the requested model, its `model` echoes the top-level
+        # `model` string the caller sent (alias or canonical); when the declining hop is a
+        # fallback model, its `model` is that model's canonical id.
+        sig { returns(Anthropic::Beta::BetaFallbackInfo) }
+        attr_reader :from
+
+        sig { params(from: Anthropic::Beta::BetaFallbackInfo::OrHash).void }
+        attr_writer :from
+
+        # The fallback model producing the content that follows this block. Its `model` is
+        # always the canonical id.
+        sig { returns(Anthropic::Beta::BetaFallbackInfo) }
+        attr_reader :to
+
+        sig { params(to: Anthropic::Beta::BetaFallbackInfo::OrHash).void }
+        attr_writer :to
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Marks the point in `content` where one model's output gives way to the next.
+        #
+        # One block appears per hop where a preceding model actually ran this turn and
+        # declined. A turn routed directly by the sticky decision has no such boundary and
+        # carries no block — the signal for whether a fallback model served the response
+        # is the presence of a `fallback_message` entry in `usage.iterations`, not this
+        # block.
+        #
+        # The block is treated like a server-tool content block for streaming: it arrives
+        # via the standard `content_block_start` / `content_block_stop` pair and carries
+        # no deltas.
+        sig do
+          params(
+            from: Anthropic::Beta::BetaFallbackInfo::OrHash,
+            to: Anthropic::Beta::BetaFallbackInfo::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The model whose output ends at this point — the model that declined at this hop.
+          # When the declining hop is the requested model, its `model` echoes the top-level
+          # `model` string the caller sent (alias or canonical); when the declining hop is a
+          # fallback model, its `model` is that model's canonical id.
+          from:,
+          # The fallback model producing the content that follows this block. Its `model` is
+          # always the canonical id.
+          to:,
+          type: :fallback
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              from: Anthropic::Beta::BetaFallbackInfo,
+              to: Anthropic::Beta::BetaFallbackInfo,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_fallback_block_param.rbi

@@ -0,0 +1,81 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackBlockParam = Beta::BetaFallbackBlockParam
+
+    module Beta
+      class BetaFallbackBlockParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackBlockParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Identifies one hop of a fallback transition.
+        sig { returns(Anthropic::Beta::BetaFallbackInfoParam) }
+        attr_reader :from
+
+        sig do
+          params(from: Anthropic::Beta::BetaFallbackInfoParam::OrHash).void
+        end
+        attr_writer :from
+
+        # Identifies one hop of a fallback transition.
+        sig { returns(Anthropic::Beta::BetaFallbackInfoParam) }
+        attr_reader :to
+
+        sig { params(to: Anthropic::Beta::BetaFallbackInfoParam::OrHash).void }
+        attr_writer :to
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # A `fallback` block echoed back from a prior response.
+        #
+        # Accepted in `messages[].content` and never rendered into the prompt, not
+        # validated against the request's `fallbacks` chain or top-level `model`, and
+        # stripped before the sticky-routing cache key is computed.
+        #
+        # Callers should echo the assistant turn verbatim — block included. The block's
+        # position is load-bearing for thinking verification: the thinking runs on either
+        # side of a fallback hop carry independently-rooted verification hash chains, and
+        # this block is the only record of where one chain ends and the next begins. When
+        # thinking runs flank the boundary, omitting the block merges the runs into one
+        # contiguous span whose hashes cannot verify (the request is rejected), and moving
+        # it into the middle of a single run splits that run's chain and is likewise
+        # rejected; between non-thinking blocks the block's placement has no verification
+        # effect.
+        sig do
+          params(
+            from: Anthropic::Beta::BetaFallbackInfoParam::OrHash,
+            to: Anthropic::Beta::BetaFallbackInfoParam::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Identifies one hop of a fallback transition.
+          from:,
+          # Identifies one hop of a fallback transition.
+          to:,
+          type: :fallback
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              from: Anthropic::Beta::BetaFallbackInfoParam,
+              to: Anthropic::Beta::BetaFallbackInfoParam,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end