anthropic 1.58.0 → 1.59.0

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaFallbackCreditUsage < Anthropic::Internal::Type::BaseModel
+        # @!attribute status
+        #   Whether the fallback-credit reprice was applied to this response's billing.
+        #
+        #   A union discriminated on `type`. `redeemed`: the retry is billed as if the
+        #   conversation had been on the retry model all along — including when the
+        #   resulting shift is zero because there was nothing to move. `not_applied`: no
+        #   reprice was applied; the arm's `reason` says why.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackCreditRedeemed, Anthropic::Models::Beta::BetaFallbackCreditNotApplied]
+        required :status, union: -> { Anthropic::Beta::BetaFallbackCreditUsage::Status }
+
+        # @!method initialize(status:)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaFallbackCreditUsage} for more details.
+        #
+        #   Outcome of the `fallback_credit_token` presented on this request.
+        #
+        #   @param status [Anthropic::Models::Beta::BetaFallbackCreditRedeemed, Anthropic::Models::Beta::BetaFallbackCreditNotApplied] Whether the fallback-credit reprice was applied to this response's billing.
+
+        # Whether the fallback-credit reprice was applied to this response's billing.
+        #
+        # A union discriminated on `type`. `redeemed`: the retry is billed as if the
+        # conversation had been on the retry model all along — including when the
+        # resulting shift is zero because there was nothing to move. `not_applied`: no
+        # reprice was applied; the arm's `reason` says why.
+        #
+        # @see Anthropic::Models::Beta::BetaFallbackCreditUsage#status
+        module Status
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # The reprice was applied: the retry is billed as if the conversation
+          # had been on the retry model all along.
+          variant :redeemed, -> { Anthropic::Beta::BetaFallbackCreditRedeemed }
+
+          # No reprice was applied; ``reason`` says why.
+          variant :not_applied, -> { Anthropic::Beta::BetaFallbackCreditNotApplied }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaFallbackCreditRedeemed, Anthropic::Models::Beta::BetaFallbackCreditNotApplied)]
+        end
+      end
+    end
+
+    BetaFallbackCreditUsage = Beta::BetaFallbackCreditUsage
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      # 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. The string "default" requests the
+      # requested model's server-defined default fallback configuration.
+      module BetaFallbacksParam
+        extend Anthropic::Internal::Type::Union
+
+        variant -> { Anthropic::Models::Beta::BetaFallbacksParam::BetaFallbackParamArray }
+
+        variant const: :default
+
+        # @!method self.variants
+        #   @return [Array(Array<Anthropic::Models::Beta::BetaFallbackParam>, Symbol, :default)]
+
+        # @type [Anthropic::Internal::Type::Converter]
+        BetaFallbackParamArray = Anthropic::Internal::Type::ArrayOf[-> { Anthropic::Beta::BetaFallbackParam }]
+      end
+    end
+
+    BetaFallbacksParam = Beta::BetaFallbacksParam
+  end
+end

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

@@ -14,6 +14,8 @@ module Anthropic
 
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_FABLE_5 }
 
+        variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_5 }
+
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_8 }
 
         variant const: -> { Anthropic::Models::Beta::BetaManagedAgentsModel::CLAUDE_OPUS_4_7 }
@@ -51,13 +53,16 @@ module Anthropic
         # 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
+        # Powerful intelligence for long-running agents and coding
+        CLAUDE_OPUS_5 = :"claude-opus-5"
+
+        # Powerful intelligence for long-running agents and coding
         CLAUDE_OPUS_4_8 = :"claude-opus-4-8"
 
-        # Frontier intelligence for long-running agents and coding
+        # Powerful intelligence for long-running agents and coding
         CLAUDE_OPUS_4_7 = :"claude-opus-4-7"
 
-        # Most intelligent model for building agents and coding
+        # Powerful intelligence for long-running agents and coding
         CLAUDE_OPUS_4_6 = :"claude-opus-4-6"
 
         # Best combination of speed and intelligence
@@ -69,10 +74,10 @@ module Anthropic
         # Fastest model with near-frontier intelligence
         CLAUDE_HAIKU_4_5_20251001 = :"claude-haiku-4-5-20251001"
 
-        # Premium model combining maximum intelligence with practical performance
+        # Powerful intelligence for long-running agents and coding
         CLAUDE_OPUS_4_5 = :"claude-opus-4-5"
 
-        # Premium model combining maximum intelligence with practical performance
+        # Powerful intelligence for long-running agents and coding
         CLAUDE_OPUS_4_5_20251101 = :"claude-opus-4-5-20251101"
 
         # High-performance model for agents and coding

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

@@ -16,6 +16,12 @@ module Anthropic
         #   @return [Integer, nil]
         required :cache_read_input_tokens, Integer, nil?: true
 
+        # @!attribute fallback_credit
+        #   Outcome of the `fallback_credit_token` presented on this request.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackCreditUsage, nil]
+        required :fallback_credit, -> { Anthropic::Beta::BetaFallbackCreditUsage }, nil?: true
+
         # @!attribute input_tokens
         #   The cumulative number of input tokens which were used.
         #
@@ -60,7 +66,7 @@ module Anthropic
         #   @return [Anthropic::Models::Beta::BetaServerToolUsage, nil]
         required :server_tool_use, -> { Anthropic::Beta::BetaServerToolUsage }, nil?: true
 
-        # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, iterations:, output_tokens:, output_tokens_details:, server_tool_use:)
+        # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, fallback_credit:, input_tokens:, iterations:, output_tokens:, output_tokens_details:, server_tool_use:)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaMessageDeltaUsage} for more details.
         #
@@ -68,6 +74,8 @@ module Anthropic
         #
         #   @param cache_read_input_tokens [Integer, nil] The cumulative number of input tokens read from the cache.
         #
+        #   @param fallback_credit [Anthropic::Models::Beta::BetaFallbackCreditUsage, nil] Outcome of the `fallback_credit_token` presented on this request.
+        #
         #   @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, Anthropic::Models::Beta::BetaFallbackMessageIterationUsage>, nil] Per-iteration token usage breakdown.

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, Anthropic::Models::Beta::BetaFallbackBlockParam>]
+        #   @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::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, 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, Anthropic::Models::Beta::BetaFallbackBlockParam>]
+        #   @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::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, 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, Anthropic::Models::Beta::BetaFallbackBlockParam>)]
+          #   @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::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock, Anthropic::Models::Beta::BetaFallbackBlockParam>)]
 
           # @type [Anthropic::Internal::Type::Converter]
           BetaContentBlockParamArray =

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

@@ -7,8 +7,9 @@ module Anthropic
         # @!attribute content
         #   System instruction text blocks.
         #
-        #   @return [Array<Anthropic::Models::Beta::BetaTextBlockParam>]
-        required :content, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaTextBlockParam] }
+        #   @return [Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock>]
+        required :content,
+                 -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaMidConversationSystemBlockParam::Content] }
 
         # @!attribute type
         #
@@ -28,11 +29,40 @@ module Anthropic
         #   point in the conversation, rather than only via the top-level `system`
         #   parameter.
         #
-        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlockParam>] System instruction text blocks.
+        #   @param content [Array<Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock>] System instruction text blocks.
         #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
         #
         #   @param type [Symbol, :mid_conv_system]
+
+        # Mid-conversation directive to surface a declared tool.
+        #
+        # `tool` references a tool (or MCP toolset) by name from the request's `tools`; it
+        # is offered to the model from this point in the conversation onward.
+        module Content
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          variant :text, -> { Anthropic::Beta::BetaTextBlockParam }
+
+          # Mid-conversation directive to surface a declared tool.
+          #
+          # ``tool`` references a tool (or MCP toolset) by name from the request's
+          # ``tools``; it is offered to the model from this point in the
+          # conversation onward.
+          variant :tool_addition, -> { Anthropic::Beta::BetaRequestToolAdditionBlock }
+
+          # Mid-conversation directive to withdraw a tool.
+          #
+          # ``tool`` references a tool (or MCP toolset) by name from the request's
+          # ``tools``; it is no longer offered to the model from this point in the
+          # conversation onward.
+          variant :tool_removal, -> { Anthropic::Beta::BetaRequestToolRemovalBlock }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaTextBlockParam, Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock)]
+        end
       end
     end
 

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

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaRequestToolAdditionBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute tool
+        #   Reference to a single tool the caller declared directly in `tools[]`. Does not
+        #   accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+        #   tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+        #
+        #   @return [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference]
+        required :tool, union: -> { Anthropic::Beta::BetaRequestToolAdditionBlock::Tool }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :tool_addition]
+        required :type, const: :tool_addition
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!method initialize(tool:, cache_control: nil, type: :tool_addition)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaRequestToolAdditionBlock} for more details.
+        #
+        #   Mid-conversation directive to surface a declared tool.
+        #
+        #   `tool` references a tool (or MCP toolset) by name from the request's `tools`; it
+        #   is offered to the model from this point in the conversation onward.
+        #
+        #   @param tool [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference] Reference to a single tool the caller declared directly in
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param type [Symbol, :tool_addition]
+
+        # Reference to a single tool the caller declared directly in `tools[]`. Does not
+        # accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+        # tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+        #
+        # @see Anthropic::Models::Beta::BetaRequestToolAdditionBlock#tool
+        module Tool
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # Reference to a single tool the caller declared directly in
+          # ``tools[]``. Does not accept the composed ``{server}_{name}`` form the
+          # server assigns to MCP-resolved tools — use ``mcp_tool_reference`` or
+          # ``mcp_toolset_reference`` for those.
+          variant :tool_reference, -> { Anthropic::Beta::BetaToolChangeToolReference }
+
+          # Reference to a single MCP tool by its server and remote name — the
+          # same ``server_name``/``name`` pair ``mcp_tool_use`` carries.
+          variant :mcp_tool_reference, -> { Anthropic::Beta::BetaToolChangeMCPToolReference }
+
+          # Reference to every tool in the named MCP server's toolset.
+          variant :mcp_toolset_reference, -> { Anthropic::Beta::BetaToolChangeMCPToolsetReference }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference)]
+        end
+      end
+    end
+
+    BetaRequestToolAdditionBlock = Beta::BetaRequestToolAdditionBlock
+  end
+end

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

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaRequestToolRemovalBlock < Anthropic::Internal::Type::BaseModel
+        # @!attribute tool
+        #   Reference to a single tool the caller declared directly in `tools[]`. Does not
+        #   accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+        #   tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+        #
+        #   @return [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference]
+        required :tool, union: -> { Anthropic::Beta::BetaRequestToolRemovalBlock::Tool }
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :tool_removal]
+        required :type, const: :tool_removal
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
+        # @!method initialize(tool:, cache_control: nil, type: :tool_removal)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaRequestToolRemovalBlock} for more details.
+        #
+        #   Mid-conversation directive to withdraw a tool.
+        #
+        #   `tool` references a tool (or MCP toolset) by name from the request's `tools`; it
+        #   is no longer offered to the model from this point in the conversation onward.
+        #
+        #   @param tool [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference] Reference to a single tool the caller declared directly in
+        #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param type [Symbol, :tool_removal]
+
+        # Reference to a single tool the caller declared directly in `tools[]`. Does not
+        # accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+        # tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+        #
+        # @see Anthropic::Models::Beta::BetaRequestToolRemovalBlock#tool
+        module Tool
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # Reference to a single tool the caller declared directly in
+          # ``tools[]``. Does not accept the composed ``{server}_{name}`` form the
+          # server assigns to MCP-resolved tools — use ``mcp_tool_reference`` or
+          # ``mcp_toolset_reference`` for those.
+          variant :tool_reference, -> { Anthropic::Beta::BetaToolChangeToolReference }
+
+          # Reference to a single MCP tool by its server and remote name — the
+          # same ``server_name``/``name`` pair ``mcp_tool_use`` carries.
+          variant :mcp_tool_reference, -> { Anthropic::Beta::BetaToolChangeMCPToolReference }
+
+          # Reference to every tool in the named MCP server's toolset.
+          variant :mcp_toolset_reference, -> { Anthropic::Beta::BetaToolChangeMCPToolsetReference }
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference)]
+        end
+      end
+    end
+
+    BetaRequestToolRemovalBlock = Beta::BetaRequestToolRemovalBlock
+  end
+end

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

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChangeMCPToolReference < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute server_name
+        #
+        #   @return [String]
+        required :server_name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_tool_reference]
+        required :type, const: :mcp_tool_reference
+
+        # @!method initialize(name:, server_name:, type: :mcp_tool_reference)
+        #   Reference to a single MCP tool by its server and remote name — the same
+        #   `server_name`/`name` pair `mcp_tool_use` carries.
+        #
+        #   @param name [String]
+        #   @param server_name [String]
+        #   @param type [Symbol, :mcp_tool_reference]
+      end
+    end
+
+    BetaToolChangeMCPToolReference = Beta::BetaToolChangeMCPToolReference
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChangeMCPToolsetReference < Anthropic::Internal::Type::BaseModel
+        # @!attribute server_name
+        #
+        #   @return [String]
+        required :server_name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :mcp_toolset_reference]
+        required :type, const: :mcp_toolset_reference
+
+        # @!method initialize(server_name:, type: :mcp_toolset_reference)
+        #   Reference to every tool in the named MCP server's toolset.
+        #
+        #   @param server_name [String]
+        #   @param type [Symbol, :mcp_toolset_reference]
+      end
+    end
+
+    BetaToolChangeMCPToolsetReference = Beta::BetaToolChangeMCPToolsetReference
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaToolChangeToolReference < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :tool_reference]
+        required :type, const: :tool_reference
+
+        # @!method initialize(name:, type: :tool_reference)
+        #   Reference to a single tool the caller declared directly in `tools[]`. Does not
+        #   accept the composed `{server}_{name}` form the server assigns to MCP-resolved
+        #   tools — use `mcp_tool_reference` or `mcp_toolset_reference` for those.
+        #
+        #   @param name [String]
+        #   @param type [Symbol, :tool_reference]
+      end
+    end
+
+    BetaToolChangeToolReference = Beta::BetaToolChangeToolReference
+  end
+end

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

@@ -22,6 +22,12 @@ module Anthropic
         #   @return [Integer, nil]
         required :cache_read_input_tokens, Integer, nil?: true
 
+        # @!attribute fallback_credit
+        #   Outcome of the `fallback_credit_token` presented on this request.
+        #
+        #   @return [Anthropic::Models::Beta::BetaFallbackCreditUsage, nil]
+        required :fallback_credit, -> { Anthropic::Beta::BetaFallbackCreditUsage }, nil?: true
+
         # @!attribute inference_geo
         #   The geographic region where inference was performed for this request.
         #
@@ -86,7 +92,7 @@ module Anthropic
         #   @return [Symbol, Anthropic::Models::Beta::BetaUsage::Speed, nil]
         required :speed, enum: -> { Anthropic::Beta::BetaUsage::Speed }, nil?: true
 
-        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, inference_geo:, input_tokens:, iterations:, output_tokens:, output_tokens_details:, server_tool_use:, service_tier:, speed:)
+        # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, fallback_credit:, inference_geo:, input_tokens:, iterations:, output_tokens:, output_tokens_details:, server_tool_use:, service_tier:, speed:)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaUsage} for more details.
         #
@@ -96,6 +102,8 @@ module Anthropic
         #
         #   @param cache_read_input_tokens [Integer, nil] The number of input tokens read from the cache.
         #
+        #   @param fallback_credit [Anthropic::Models::Beta::BetaFallbackCreditUsage, nil] Outcome of the `fallback_credit_token` presented on this request.
+        #
         #   @param inference_geo [String, nil] The geographic region where inference was performed for this request.
         #
         #   @param input_tokens [Integer] The number of input tokens which were used.

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

@@ -157,18 +157,19 @@ module Anthropic
         #   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
+        #   @return [String, Anthropic::Models::Beta::BetaFallbackCreditTokenParam, nil]
+        optional :fallback_credit_token,
+                 union: -> { Anthropic::Beta::MessageCreateParams::FallbackCreditToken },
+                 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.
+        #   declines, the second is tried, and so on. The string "default" requests the
+        #   requested model's server-defined default fallback configuration.
         #
-        #   @return [Array<Anthropic::Models::Beta::BetaFallbackParam>, nil]
-        optional :fallbacks,
-                 -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaFallbackParam] },
-                 nil?: true
+        #   @return [Array<Anthropic::Models::Beta::BetaFallbackParam>, Symbol, :default, nil]
+        optional :fallbacks, union: -> { Anthropic::Beta::BetaFallbacksParam }, nil?: true
 
         # @!attribute inference_geo
         #   Specifies the geographic region for inference processing. If not specified, the
@@ -432,9 +433,9 @@ 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 fallback_credit_token [String, Anthropic::Models::Beta::BetaFallbackCreditTokenParam, 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 fallbacks [Array<Anthropic::Models::Beta::BetaFallbackParam>, Symbol, :default, 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
         #
@@ -485,6 +486,43 @@ module Anthropic
           #   @return [Array(Anthropic::Models::Beta::BetaContainerParams, String)]
         end
 
+        # 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.
+        module FallbackCreditToken
+          extend Anthropic::Internal::Type::Union
+
+          variant String
+
+          # Object form of ``fallback_credit_token``: the token plus a redemption
+          # mode.
+          #
+          # Requires ``anthropic-beta: fallback-credit-2026-07-01``; without that
+          # header the field accepts the bare string only. The bare string and the
+          # mode-less object are equivalent (both select ``strict``), so wrapping
+          # an existing token changes nothing by itself.
+          variant -> { Anthropic::Beta::BetaFallbackCreditTokenParam }
+
+          # @!method self.variants
+          #   @return [Array(String, Anthropic::Models::Beta::BetaFallbackCreditTokenParam)]
+        end
+
         # Determines whether to use priority capacity (if available) or standard capacity
         # for this request.
         #