anthropic 1.45.0 → 1.47.0

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_custom_tool_input_schema.rb

@@ -4,8 +4,12 @@ module Anthropic
   module Models
     module Beta
       class BetaManagedAgentsCustomToolInputSchema < Anthropic::Internal::Type::BaseModel
+        # @!attribute type
+        #
+        #   @return [Symbol, :object]
+        required :type, const: :object
+
         # @!attribute properties
-        #   JSON Schema properties defining the tool's input parameters.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :properties,
@@ -13,37 +17,16 @@ module Anthropic
                  nil?: true
 
         # @!attribute required
-        #   List of required property names.
         #
         #   @return [Array<String>, nil]
-        optional :required, Anthropic::Internal::Type::ArrayOf[String]
-
-        # @!attribute type
-        #   Must be 'object' for tool input schemas.
-        #
-        #   @return [Symbol, Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema::Type, nil]
-        optional :type, enum: -> { Anthropic::Beta::BetaManagedAgentsCustomToolInputSchema::Type }
+        optional :required, Anthropic::Internal::Type::ArrayOf[String], nil?: true
 
-        # @!method initialize(properties: nil, required: nil, type: nil)
+        # @!method initialize(properties: nil, required: nil, type: :object)
         #   JSON Schema for custom tool input parameters.
         #
-        #   @param properties [Hash{Symbol=>Object}, nil] JSON Schema properties defining the tool's input parameters.
-        #
-        #   @param required [Array<String>] List of required property names.
-        #
-        #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema::Type] Must be 'object' for tool input schemas.
-
-        # Must be 'object' for tool input schemas.
-        #
-        # @see Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema#type
-        module Type
-          extend Anthropic::Internal::Type::Enum
-
-          OBJECT = :object
-
-          # @!method self.values
-          #   @return [Array<Symbol>]
-        end
+        #   @param properties [Hash{Symbol=>Object}, nil]
+        #   @param required [Array<String>, nil]
+        #   @param type [Symbol, :object]
       end
     end
 

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 =

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_tool_search_tool_result_error_param.rb

@@ -14,8 +14,14 @@ module Anthropic
         #   @return [Symbol, :tool_search_tool_result_error]
         required :type, const: :tool_search_tool_result_error
 
-        # @!method initialize(error_code:, type: :tool_search_tool_result_error)
+        # @!attribute error_message
+        #
+        #   @return [String, nil]
+        optional :error_message, String, nil?: true
+
+        # @!method initialize(error_code:, error_message: nil, type: :tool_search_tool_result_error)
         #   @param error_code [Symbol, Anthropic::Models::Beta::BetaToolSearchToolResultErrorParam::ErrorCode]
+        #   @param error_message [String, nil]
         #   @param type [Symbol, :tool_search_tool_result_error]
 
         # @see Anthropic::Models::Beta::BetaToolSearchToolResultErrorParam#error_code

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/beta_webhook_session_archived_event_data.rb

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionArchivedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.archived")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionCreatedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.created")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionDeletedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.deleted")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionIdledEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.idled")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionOutcomeEvaluationEndedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.outcome_evaluation_ended")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionPendingEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.pending")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionRequiresActionEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.requires_action")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionRunningEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.running")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionStatusIdledEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.status_idled")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionStatusRescheduledEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.status_rescheduled")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #

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

@@ -5,7 +5,7 @@ module Anthropic
     module Beta
       class BetaWebhookSessionStatusRunStartedEventData < Anthropic::Internal::Type::BaseModel
         # @!attribute id
-        #   ID of the resource that triggered the event.
+        #   ID of the session that triggered the event.
         #
         #   @return [String]
         required :id, String
@@ -26,7 +26,7 @@ module Anthropic
         required :workspace_id, String
 
         # @!method initialize(id:, organization_id:, workspace_id:, type: :"session.status_run_started")
-        #   @param id [String] ID of the resource that triggered the event.
+        #   @param id [String] ID of the session that triggered the event.
         #
         #   @param organization_id [String]
         #