anthropic 1.46.0 → 1.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a58b5713db9e1ef7b8abebd0a189176ddc46d1b28d04b8f072a32331a9d6be95
-  data.tar.gz: dc427a2dd0b75d47dbbb8e2b71539e4f2de1ffd5844ac96a77ca0a38d8588de0
+  metadata.gz: c4bc5b547e144ce8912f64688a18447637a87c762639cb57e34605698cf26e9b
+  data.tar.gz: bfa5bfdf7451e6906b0f51e821495375c0b97226a3b8661994a4de82b533984b
 SHA512:
-  metadata.gz: 40c8be3263202fb1abec20744d6448cd395d28a778c0375f104059038f26adc03f001e40e286afb5cb5c0d11045ed5e5fce106c96f9fbad46207c0331e1cec36
-  data.tar.gz: 928a92d2e651601606d99d1bca07e5b46e601068b715478a53458d6a788a12791672df06bd80153efbc78cd9964fd2b18dc81c578b3c038a1bb59337279abd31
+  metadata.gz: 80450518d0be5fb60fe3b1d1f909ed2d0b6b740d6ecd38e6335a2235728dd0171a026c4654ba484a971e20de4626444b6f5ce6e8591cd83854b92266159bae11
+  data.tar.gz: 22072523e6e0df8c4530a54738498b6098d71b274bdd2b97de552a275105b6cb92f53f4102512ff7791834ad3e487f8790b411856342b3cf79cb67815004bb30

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.47.0 (2026-06-09)
+
+Full Changelog: [v1.46.0...v1.47.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.46.0...v1.47.0)
+
+### Features
+
+* **api:** add support for claude-mythos-5 and claude-fable-5, with support for server-side fallbacks on refusal ([41e21c3](https://github.com/anthropics/anthropic-sdk-ruby/commit/41e21c3a17ba4d5b930e50701ffc395844fb1dd9))
+
 ## 1.46.0 (2026-06-06)
 
 Full Changelog: [v1.45.0...v1.46.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.45.0...v1.46.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.46.0"
+gem "anthropic", "~> 1.47.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/anthropic/helpers/streaming/message_stream.rb

@@ -113,6 +113,10 @@ module Anthropic
             return Anthropic::Internal::Type::Converter.coerce(Anthropic::Models::BetaMessage, event.message)
           in Anthropic::Models::RawContentBlockStartEvent | Anthropic::Models::BetaRawContentBlockStartEvent
             current_snapshot.content = (current_snapshot.content || []) + [event.content_block]
+
+            # The final hop's fallback block names the model that served the response —
+            # keeps the snapshot consistent with the relabeled non-streaming message.
+            current_snapshot.model = event.content_block.to.model if event.content_block.type == :fallback
           in Anthropic::Models::RawContentBlockDeltaEvent | Anthropic::Models::BetaRawContentBlockDeltaEvent
             content = current_snapshot.content[event.index]
 

data/lib/anthropic/models/anthropic_beta.rb

@@ -59,6 +59,10 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::THINKING_TOKEN_COUNT_2026_05_13 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::SERVER_SIDE_FALLBACK_2026_06_01 }
+
+      variant const: -> { Anthropic::Models::AnthropicBeta::FALLBACK_CREDIT_2026_06_01 }
+
       # @!method self.variants
       #   @return [Array(String, Symbol)]
 
@@ -94,6 +98,8 @@ module Anthropic
       MANAGED_AGENTS_2026_04_01 = :"managed-agents-2026-04-01"
       CACHE_DIAGNOSIS_2026_04_07 = :"cache-diagnosis-2026-04-07"
       THINKING_TOKEN_COUNT_2026_05_13 = :"thinking-token-count-2026-05-13"
+      SERVER_SIDE_FALLBACK_2026_06_01 = :"server-side-fallback-2026-06-01"
+      FALLBACK_CREDIT_2026_06_01 = :"fallback-credit-2026-06-01"
 
       # @!endgroup
     end

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

@@ -48,8 +48,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
 

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

@@ -74,8 +74,25 @@ module Anthropic
         # point in the conversation, rather than only via the top-level `system` parameter.
         variant :mid_conv_system, -> { Anthropic::Beta::BetaMidConversationSystemBlockParam }
 
+        # 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.
+        variant :fallback, -> { Anthropic::Beta::BetaFallbackBlockParam }
+
         # @!method self.variants
-        #   @return [Array(Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam)]
+        #   @return [Array(Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam)]
       end
     end
 

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute from
+        #   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.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackInfo]
+        required :from, -> { Anthropic::Beta::BetaFallbackInfo }
+
+        # @!attribute to
+        #   The fallback model producing the content that follows this block. Its `model` is
+        #   always the canonical id.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackInfo]
+        required :to, -> { Anthropic::Beta::BetaFallbackInfo }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :fallback]
+        required :type, const: :fallback
+
+        # @!method initialize(from:, to:, type: :fallback)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackBlock} for more details.
+        #
+        #   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.
+        #
+        #   @param from [Anthropic::Models::Beta::BetaFallbackInfo] The model whose output ends at this point — the model that declined at this hop.
+        #
+        #   @param to [Anthropic::Models::Beta::BetaFallbackInfo] The fallback model producing the content that follows this block. Its `model` is
+        #
+        #   @param type [Symbol, :fallback]
+      end
+    end
+
+    BetaFallbackBlock = Beta::BetaFallbackBlock
+  end
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackBlockParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute from
+        #   Identifies one hop of a fallback transition.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackInfoParam]
+        required :from, -> { Anthropic::Beta::BetaFallbackInfoParam }
+
+        # @!attribute to
+        #   Identifies one hop of a fallback transition.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackInfoParam]
+        required :to, -> { Anthropic::Beta::BetaFallbackInfoParam }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :fallback]
+        required :type, const: :fallback
+
+        # @!method initialize(from:, to:, type: :fallback)
+        #   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.
+        #
+        #   @param from [Anthropic::Models::Beta::BetaFallbackInfoParam] Identifies one hop of a fallback transition.
+        #
+        #   @param to [Anthropic::Models::Beta::BetaFallbackInfoParam] Identifies one hop of a fallback transition.
+        #
+        #   @param type [Symbol, :fallback]
+      end
+    end
+
+    BetaFallbackBlockParam = Beta::BetaFallbackBlockParam
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackInfo < Anthropic::Internal::Type::BaseModel
+        # @!attribute model
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   details and options.
+        #
+        #   @return [Symbol, String, Anthropic::Models::Model]
+        required :model, union: -> { Anthropic::Model }
+
+        # @!method initialize(model:)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackInfo} for more details.
+        #
+        #   Identifies one hop of a fallback transition.
+        #
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
+      end
+    end
+
+    BetaFallbackInfo = Beta::BetaFallbackInfo
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackInfoParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute model
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   details and options.
+        #
+        #   @return [Symbol, String, Anthropic::Models::Model]
+        required :model, union: -> { Anthropic::Model }
+
+        # @!method initialize(model:)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackInfoParam} for more details.
+        #
+        #   Identifies one hop of a fallback transition.
+        #
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
+      end
+    end
+
+    BetaFallbackInfoParam = Beta::BetaFallbackInfoParam
+  end
+end

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

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackMessageIterationUsage < Anthropic::Internal::Type::BaseModel
+        # @!attribute cache_creation
+        #   Breakdown of cached tokens by TTL
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheCreation, nil]
+        required :cache_creation, -> { Anthropic::Beta::BetaCacheCreation }, nil?: true
+
+        # @!attribute cache_creation_input_tokens
+        #   The number of input tokens used to create the cache entry.
+        #
+        #   @return [Integer]
+        required :cache_creation_input_tokens, Integer
+
+        # @!attribute cache_read_input_tokens
+        #   The number of input tokens read from the cache.
+        #
+        #   @return [Integer]
+        required :cache_read_input_tokens, Integer
+
+        # @!attribute input_tokens
+        #   The number of input tokens which were used.
+        #
+        #   @return [Integer]
+        required :input_tokens, Integer
+
+        # @!attribute model
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   details and options.
+        #
+        #   @return [Symbol, String, Anthropic::Models::Model]
+        required :model, union: -> { Anthropic::Model }
+
+        # @!attribute output_tokens
+        #   The number of output tokens which were used.
+        #
+        #   @return [Integer]
+        required :output_tokens, Integer
+
+        # @!attribute type
+        #   Usage for the fallback-model attempt that served the response
+        #
+        #   @return [Symbol, :fallback_message]
+        required :type, const: :fallback_message
+
+        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, model:, output_tokens:, type: :fallback_message)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackMessageIterationUsage} for more details.
+        #
+        #   Token usage for the fallback-model attempt of a server-side fallback request.
+        #
+        #   Produced in place of a `message` entry for whichever hop served the response. A
+        #   declined hop produces the existing `message` entry. Whether a fallback model
+        #   served the response is signalled by the presence of this entry in
+        #   `usage.iterations`.
+        #
+        #   @param cache_creation [Anthropic::Models::Beta::BetaCacheCreation, nil] Breakdown of cached tokens by TTL
+        #
+        #   @param cache_creation_input_tokens [Integer] The number of input tokens used to create the cache entry.
+        #
+        #   @param cache_read_input_tokens [Integer] The number of input tokens read from the cache.
+        #
+        #   @param input_tokens [Integer] The number of input tokens which were used.
+        #
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
+        #
+        #   @param output_tokens [Integer] The number of output tokens which were used.
+        #
+        #   @param type [Symbol, :fallback_message] Usage for the fallback-model attempt that served the response
+      end
+    end
+
+    BetaFallbackMessageIterationUsage = Beta::BetaFallbackMessageIterationUsage
+  end
+end

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackParam < Anthropic::Internal::Type::BaseModel
+        # @!attribute model
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   details and options.
+        #
+        #   @return [Symbol, String, Anthropic::Models::Model]
+        required :model, union: -> { Anthropic::Model }
+
+        # @!attribute max_tokens
+        #
+        #   @return [Integer, nil]
+        optional :max_tokens, Integer, nil?: true
+
+        # @!attribute output_config
+        #
+        #   @return [Anthropic::Models::Beta::BetaOutputConfig, nil]
+        optional :output_config, -> { Anthropic::Beta::BetaOutputConfig }, nil?: true
+
+        # @!attribute speed
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaFallbackParam::Speed, nil]
+        optional :speed, enum: -> { Anthropic::Beta::BetaFallbackParam::Speed }, nil?: true
+
+        # @!attribute thinking
+        #
+        #   @return [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
+        optional :thinking, union: -> { Anthropic::Beta::BetaFallbackParam::Thinking }, nil?: true
+
+        # @!method initialize(model:, max_tokens: nil, output_config: nil, speed: nil, thinking: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackParam} for more details.
+        #
+        #   One entry in the `fallbacks` chain on a `/v1/messages` request.
+        #
+        #   `model` is required. The four override fields (`max_tokens`, `thinking`,
+        #   `output_config`, and `speed`) replace the corresponding top-level field for this
+        #   attempt only and are validated as if the request were made to `model`. Any other
+        #   key is rejected at parse time.
+        #
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
+        #
+        #   @param max_tokens [Integer, nil]
+        #
+        #   @param output_config [Anthropic::Models::Beta::BetaOutputConfig, nil]
+        #
+        #   @param speed [Symbol, Anthropic::Models::Beta::BetaFallbackParam::Speed, nil]
+        #
+        #   @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive, nil]
+
+        # @see Anthropic::Models::Beta::BetaFallbackParam#speed
+        module Speed
+          extend Anthropic::Internal::Type::Enum
+
+          STANDARD = :standard
+          FAST = :fast
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see Anthropic::Models::Beta::BetaFallbackParam#thinking
+        module Thinking
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          variant :enabled, -> { Anthropic::Beta::BetaThinkingConfigEnabled }
+
+          variant :disabled, -> { Anthropic::Beta::BetaThinkingConfigDisabled }
+
+          variant :adaptive, -> { Anthropic::Beta::BetaThinkingConfigAdaptive }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigAdaptive)]
+        end
+      end
+    end
+
+    BetaFallbackParam = Beta::BetaFallbackParam
+  end
+end

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

@@ -18,8 +18,16 @@ module Anthropic
         # Token usage for an advisor sub-inference iteration.
         variant :advisor_message, -> { Anthropic::Beta::BetaAdvisorMessageIterationUsage }
 
+        # Token usage for the fallback-model attempt of a server-side fallback request.
+        #
+        # Produced in place of a `message` entry for whichever hop served the
+        # response. A declined hop produces the existing `message` entry. Whether
+        # a fallback model served the response is signalled by the presence of this
+        # entry in `usage.iterations`.
+        variant :fallback_message, -> { Anthropic::Beta::BetaFallbackMessageIterationUsage }
+
         # @!method self.variants
-        #   @return [Array(Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage, Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage)]
+        #   @return [Array(Anthropic::Models::Beta::BetaMessageIterationUsage, Anthropic::Models::Beta::BetaCompactionIterationUsage, Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage, Anthropic::Models::Beta::BetaFallbackMessageIterationUsage)]
       end
 
       # @type [Anthropic::Internal::Type::Converter]

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

@@ -10,6 +10,8 @@ module Anthropic
       module BetaManagedAgentsModel
         extend Anthropic::Internal::Type::Union
 
+        variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_FABLE_5 }
+
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_8 }
 
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_7 }
@@ -41,6 +43,9 @@ module Anthropic
 
         # @!group
 
+        # Next generation of intelligence for the hardest knowledge work and coding problems
+        CLAUDE_FABLE_5 = :"claude-fable-5"
+
         # Frontier intelligence for long-running agents and coding
         CLAUDE_OPUS_4_8 = :"claude-opus-4-8"
 

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

@@ -56,7 +56,7 @@ module Anthropic
         #   [{ "type": "text", "text": "B)" }]
         #   ```
         #
-        #   @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>]
         required :content, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaContentBlock] }
 
         # parsed value of response when a JSON output schema object has been specified via :output_format
@@ -174,7 +174,7 @@ module Anthropic
         #
         #   @param container [Anthropic::Models::Beta::BetaContainer, nil] Information about the container used in the request (for the code execution tool
         #
-        #   @param content [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>] Content generated by the model.
+        #   @param content [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>] Content generated by the model.
         #
         #   @param context_management [Anthropic::Models::Beta::BetaContextManagementResponse, nil] Context management response.
         #

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

@@ -32,7 +32,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
@@ -70,7 +70,7 @@ module Anthropic
         #
         #   @param input_tokens [Integer, nil] The cumulative 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 cumulative number of output tokens which were used.
         #

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

@@ -28,6 +28,15 @@ module Anthropic
         #   @return [Integer]
         required :input_tokens, Integer
 
+        # @!attribute model
+        #   The model that will complete your prompt.
+        #
+        #   See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        #   details and options.
+        #
+        #   @return [Symbol, String, Anthropic::Models::Model]
+        required :model, union: -> { Anthropic::Model }
+
         # @!attribute output_tokens
         #   The number of output tokens which were used.
         #
@@ -40,7 +49,10 @@ module Anthropic
         #   @return [Symbol, :message]
         required :type, const: :message
 
-        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:, type: :message)
+        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, model:, output_tokens:, type: :message)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaMessageIterationUsage} for more details.
+        #
         #   Token usage for a sampling iteration.
         #
         #   @param cache_creation [Anthropic::Models::Beta::BetaCacheCreation, nil] Breakdown of cached tokens by TTL
@@ -51,6 +63,8 @@ module Anthropic
         #
         #   @param input_tokens [Integer] The number of input tokens which were used.
         #
+        #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.
+        #
         #   @param output_tokens [Integer] The number of output tokens which were used.
         #
         #   @param type [Symbol, :message] Usage for a sampling iteration

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

@@ -6,7 +6,7 @@ module Anthropic
       class BetaMessageParam < Anthropic::Internal::Type::BaseModel
         # @!attribute content
         #
-        #   @return [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam>]
+        #   @return [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam>]
         required :content, union: -> { Anthropic::Beta::BetaMessageParam::Content }
 
         # @!attribute role
@@ -15,7 +15,7 @@ module Anthropic
         required :role, enum: -> { Anthropic::Beta::BetaMessageParam::Role }
 
         # @!method initialize(content:, role:)
-        #   @param content [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam>]
+        #   @param content [String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam>]
         #   @param role [Symbol, Anthropic::Models::Beta::BetaMessageParam::Role]
 
         # @see Anthropic::Models::Beta::BetaMessageParam#content
@@ -27,7 +27,7 @@ module Anthropic
           variant -> { Anthropic::Models::Beta::BetaMessageParam::Content::BetaContentBlockParamArray }
 
           # @!method self.variants
-          #   @return [Array(String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam>)]
+          #   @return [Array(String, Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaImageBlockParam, Anthropic::Models::Beta::BetaRequestDocumentBlock, Anthropic::Models::Beta::BetaSearchResultBlockParam, Anthropic::Models::Beta::BetaThinkingBlockParam, Anthropic::Models::Beta::BetaRedactedThinkingBlockParam, Anthropic::Models::Beta::BetaToolUseBlockParam, Anthropic::Models::Beta::BetaToolResultBlockParam, Anthropic::Models::Beta::BetaServerToolUseBlockParam, Anthropic::Models::Beta::BetaWebSearchToolResultBlockParam, Anthropic::Models::Beta::BetaWebFetchToolResultBlockParam, Anthropic::Models::Beta::BetaAdvisorToolResultBlockParam, Anthropic::Models::Beta::BetaCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaBashCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaTextEditorCodeExecutionToolResultBlockParam, Anthropic::Models::Beta::BetaToolSearchToolResultBlockParam, Anthropic::Models::Beta::BetaMCPToolUseBlockParam, Anthropic::Models::Beta::BetaRequestMCPToolResultBlockParam, Anthropic::Models::Beta::BetaContainerUploadBlockParam, Anthropic::Models::Beta::BetaCompactionBlockParam, Anthropic::Models::Beta::BetaMidConversationSystemBlockParam, Anthropic::Models::Beta::BetaFallbackBlockParam>)]
 
           # @type [Anthropic::Internal::Type::Converter]
           BetaContentBlockParamArray =