anthropic 1.45.0 → 1.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e459430d4274990ec5b16c71b6e8ceb9f8fb7ea7b598a0743b1395751f70a04
-  data.tar.gz: ca0766ef57242877ab67638e9c83c3511864e1fd99350fa100d3d095db0290d6
+  metadata.gz: c4bc5b547e144ce8912f64688a18447637a87c762639cb57e34605698cf26e9b
+  data.tar.gz: bfa5bfdf7451e6906b0f51e821495375c0b97226a3b8661994a4de82b533984b
 SHA512:
-  metadata.gz: 56c89b576946c7d3dc4544b96230be1602d4cbb58b72249065dd16f6bc2ec19077bbb7c87a6d5483a9f6642b6bae5b672aab9717efbeaebcf05878941c96f413
-  data.tar.gz: dab9b9b13abdb2b18049fe2549cad38d426e7616239c5d96245658ed3f05c6c14c15d13c2efac466424e77c744bd7fbece4ea9daf63ebdcdd00f5982591834e1
+  metadata.gz: 80450518d0be5fb60fe3b1d1f909ed2d0b6b740d6ecd38e6335a2235728dd0171a026c4654ba484a971e20de4626444b6f5ce6e8591cd83854b92266159bae11
+  data.tar.gz: 22072523e6e0df8c4530a54738498b6098d71b274bdd2b97de552a275105b6cb92f53f4102512ff7791834ad3e487f8790b411856342b3cf79cb67815004bb30

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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)
+
+### Features
+
+* **api:** small updates to Managed Agents types ([7edca7a](https://github.com/anthropics/anthropic-sdk-ruby/commit/7edca7a42f521b53085fef8360dcda9bad974748))
+
 ## 1.45.0 (2026-06-05)
 
 Full Changelog: [v1.44.0...v1.45.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.44.0...v1.45.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.45.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/agent_create_params.rb

@@ -18,13 +18,13 @@ module Anthropic
         required :model, union: -> { Anthropic::Beta::AgentCreateParams::Model }
 
         # @!attribute name
-        #   Human-readable name for the agent. 1-256 characters.
+        #   Human-readable name for the agent.
         #
         #   @return [String]
         required :name, String
 
         # @!attribute description
-        #   Description of what the agent does. Up to 2048 characters.
+        #   Description of what the agent does.
         #
         #   @return [String, nil]
         optional :description, String, nil?: true
@@ -52,14 +52,14 @@ module Anthropic
         optional :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams }, nil?: true
 
         # @!attribute skills
-        #   Skills available to the agent. Maximum 20.
+        #   Skills available to the agent.
         #
         #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil]
         optional :skills,
                  -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaManagedAgentsSkillParams] }
 
         # @!attribute system_
-        #   System prompt for the agent. Up to 100,000 characters.
+        #   System prompt for the agent.
         #
         #   @return [String, nil]
         optional :system_, String, api_name: :system, nil?: true
@@ -84,9 +84,9 @@ module Anthropic
         #
         #   @param model [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams] Model identifier. Accepts the [model string](https://platform.claude.com/docs/en
         #
-        #   @param name [String] Human-readable name for the agent. 1-256 characters.
+        #   @param name [String] Human-readable name for the agent.
         #
-        #   @param description [String, nil] Description of what the agent does. Up to 2048 characters.
+        #   @param description [String, nil] Description of what the agent does.
         #
         #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>] MCP servers this agent connects to. Maximum 20. Names must be unique within the
         #
@@ -94,9 +94,9 @@ module Anthropic
         #
         #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] A coordinator topology: the session's primary thread orchestrates work by spawni
         #
-        #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>] Skills available to the agent. Maximum 20.
+        #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>] Skills available to the agent.
         #
-        #   @param system_ [String, nil] System prompt for the agent. Up to 100,000 characters.
+        #   @param system_ [String, nil] System prompt for the agent.
         #
         #   @param tools [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>] Tool configurations available to the agent. Maximum of 128 tools across all tool
         #

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

@@ -22,8 +22,7 @@ module Anthropic
         required :version, Integer
 
         # @!attribute description
-        #   Description. Up to 2048 characters. Omit to preserve; send empty string or null
-        #   to clear.
+        #   Description. Omit to preserve; send empty string or null to clear.
         #
         #   @return [String, nil]
         optional :description, String, nil?: true
@@ -64,14 +63,13 @@ module Anthropic
         optional :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams }, nil?: true
 
         # @!attribute name
-        #   Human-readable name. 1-256 characters. Omit to preserve. Cannot be cleared.
+        #   Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
         #
         #   @return [String, nil]
         optional :name, String
 
         # @!attribute skills
         #   Skills. Full replacement. Omit to preserve; send empty array or null to clear.
-        #   Maximum 20.
         #
         #   @return [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil]
         optional :skills,
@@ -81,8 +79,7 @@ module Anthropic
                  nil?: true
 
         # @!attribute system_
-        #   System prompt. Up to 100,000 characters. Omit to preserve; send empty string or
-        #   null to clear.
+        #   System prompt. Omit to preserve; send empty string or null to clear.
         #
         #   @return [String, nil]
         optional :system_, String, api_name: :system, nil?: true
@@ -111,7 +108,7 @@ module Anthropic
         #
         #   @param version [Integer] The agent's current version, used to prevent concurrent overwrites. Obtain this
         #
-        #   @param description [String, nil] Description. Up to 2048 characters. Omit to preserve; send empty string or null
+        #   @param description [String, nil] Description. Omit to preserve; send empty string or null to clear.
         #
         #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaManagedAgentsURLMCPServerParams>, nil] MCP servers. Full replacement. Omit to preserve; send empty array or null to cle
         #
@@ -121,11 +118,11 @@ module Anthropic
         #
         #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] A coordinator topology: the session's primary thread orchestrates work by spawni
         #
-        #   @param name [String] Human-readable name. 1-256 characters. Omit to preserve. Cannot be cleared.
+        #   @param name [String] Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
         #
-        #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil] Skills. Full replacement. Omit to preserve; send empty array or null to clear. M
+        #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>, nil] Skills. Full replacement. Omit to preserve; send empty array or null to clear.
         #
-        #   @param system_ [String, nil] System prompt. Up to 100,000 characters. Omit to preserve; send empty string or
+        #   @param system_ [String, nil] System prompt. Omit to preserve; send empty string or null to clear.
         #
         #   @param tools [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>, nil] Tool configurations available to the agent. Full replacement. Omit to preserve;
         #

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

@@ -53,6 +53,18 @@ module Anthropic
         #   @return [Boolean, nil]
         optional :defer_loading, Anthropic::Internal::Type::Boolean
 
+        # @!attribute max_tokens
+        #   Bounds the advisor's total output (thinking + text) per call. When the advisor
+        #   hits this cap, the returned advisor_result or advisor_redacted_result block
+        #   carries stop_reason='max_tokens', and a truncation note is appended to the
+        #   advice text the worker model sees (inside the encrypted blob in redacted mode).
+        #   When set, the server also emits a remaining-tokens budget block in the advisor's
+        #   prompt so the advisor self-shapes toward the cap. When omitted, the advisor
+        #   model's default output cap applies and no budget block is emitted.
+        #
+        #   @return [Integer, nil]
+        optional :max_tokens, Integer, nil?: true
+
         # @!attribute max_uses
         #   Maximum number of times the tool can be used in the API request.
         #
@@ -65,7 +77,7 @@ module Anthropic
         #   @return [Boolean, nil]
         optional :strict, Anthropic::Internal::Type::Boolean
 
-        # @!method initialize(model:, allowed_callers: nil, cache_control: nil, caching: nil, defer_loading: nil, max_uses: nil, strict: nil, name: :advisor, type: :advisor_20260301)
+        # @!method initialize(model:, allowed_callers: nil, cache_control: nil, caching: nil, defer_loading: nil, max_tokens: nil, max_uses: nil, strict: nil, name: :advisor, type: :advisor_20260301)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaAdvisorTool20260301} for more details.
         #
@@ -79,6 +91,8 @@ module Anthropic
         #
         #   @param defer_loading [Boolean] If true, tool will not be included in initial system prompt. Only loaded when re
         #
+        #   @param max_tokens [Integer, nil] Bounds the advisor's total output (thinking + text) per call. When the advisor h
+        #
         #   @param max_uses [Integer, nil] Maximum number of times the tool can be used in the API request.
         #
         #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs

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

@@ -28,6 +28,7 @@ module Anthropic
           OVERLOADED = :overloaded
           UNAVAILABLE = :unavailable
           EXECUTION_TIME_EXCEEDED = :execution_time_exceeded
+          MODEL_NOT_FOUND = :model_not_found
 
           # @!method self.values
           #   @return [Array<Symbol>]

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

@@ -28,6 +28,7 @@ module Anthropic
           OVERLOADED = :overloaded
           UNAVAILABLE = :unavailable
           EXECUTION_TIME_EXCEEDED = :execution_time_exceeded
+          MODEL_NOT_FOUND = :model_not_found
 
           # @!method self.values
           #   @return [Array<Symbol>]

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