anthropic 1.44.0 → 1.48.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 876ada84a1da262a8c81ca559e5123da5d477507d02e127415541a6c58e12acd
-  data.tar.gz: 45fbc86ad5fa0153da5ff489c356acbd52ec59cee705d1dd3e8f764262c7a232
+  metadata.gz: 0d9658d2e43fdcfc11701082172ce0b076645519a1245c12cc7aa36971d62184
+  data.tar.gz: 2c40246a6be022f5fa0527144933b5f5cd7928c02ba216f412d7f1eb90856e41
 SHA512:
-  metadata.gz: 747f49e8366dec6fddbe2190984cf71927f6e55829ce868e8dd116b91ccdd5f89331ad115b84527d73f8963f892f3fea4e317b366283f4df2df1dfb4a3ba3ab1
-  data.tar.gz: 6ab572aa679fe5f526ab9043d67f128382e0518f3bfc3d628feefbd751f71eda4be61c05a1767b96faf2b816e58868adab3ed1c4ee3009a7b0efbee220ebdacd
+  metadata.gz: 3df9ec3734487252ad82aa9ba9995f825b1232d944ea3e0cb716002709ce4d4007d36a9cb020477a237edf839c74390379d474f6e7c2cd2f0378061b411799fd
+  data.tar.gz: 933cc3016a9750c7a69e8890aafefb7bfd4c8745d60b52ac6931c4be254e16a25397e4454d7ff0c11faa24c40f0b73456d7b4e97f5f88ce61f98c59d17fd8c8e

data/CHANGELOG.md

@@ -1,5 +1,64 @@
 # Changelog
 
+## 1.48.1 (2026-06-09)
+
+Full Changelog: [v1.48.0...v1.48.1](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.48.0...v1.48.1)
+
+### Bug Fixes
+
+* **api:** add `frontier_llm` refusal category ([5fb7044](https://github.com/anthropics/anthropic-sdk-ruby/commit/5fb704475d5296d37065cec77a18867f2ccdee16))
+
+## 1.48.0 (2026-06-09)
+
+Full Changelog: [v1.47.0...v1.48.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.47.0...v1.48.0)
+
+### Features
+
+* **api:** add support for Managed Agents deployments and environment variable credentials ([fcf62cf](https://github.com/anthropics/anthropic-sdk-ruby/commit/fcf62cfeb16456f8341b3ebb3c4fe06a2903b9e3))
+
+## 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)
+
+### Features
+
+* **api:** mark Claude Opus 4.1 as deprecated ([ccc292f](https://github.com/anthropics/anthropic-sdk-ruby/commit/ccc292f10ffb2c825f5b34c8372e7d6803ebc83d))
+
+
+### Bug Fixes
+
+* **streaming:** carry encrypted_content through beta compaction accumulator ([#938](https://github.com/anthropics/anthropic-sdk-ruby/issues/938)) ([6bd298f](https://github.com/anthropics/anthropic-sdk-ruby/commit/6bd298fa4421192fdc74ee99462d94ec01a514d3))
+* **streaming:** carry stop_details and full usage through message_delta ([#940](https://github.com/anthropics/anthropic-sdk-ruby/issues/940)) ([ef4d2ea](https://github.com/anthropics/anthropic-sdk-ruby/commit/ef4d2ea31c0e566d7ad387419ba7d6144bf06861))
+
+
+### Chores
+
+* **internal:** codegen related update ([296d6a4](https://github.com/anthropics/anthropic-sdk-ruby/commit/296d6a47ec96c36cf7a924bd74aa752d2d2ff125))
+* **internal:** fix artifact url ([a97bd1e](https://github.com/anthropics/anthropic-sdk-ruby/commit/a97bd1e6fa5094057d2967d1b0573eec6602e026))
+* **internal:** fix branch names ([16564d3](https://github.com/anthropics/anthropic-sdk-ruby/commit/16564d3806d4cb70000fe374c6ccf399e8903ba8))
+* **internal:** update staging repo ([3f6005b](https://github.com/anthropics/anthropic-sdk-ruby/commit/3f6005b00242d66f711c31a4e51973576745aaee))
+
+
+### Documentation
+
+* point security reports to Anthropic's HackerOne program ([#6](https://github.com/anthropics/anthropic-sdk-ruby/issues/6)) ([2d0f2af](https://github.com/anthropics/anthropic-sdk-ruby/commit/2d0f2af04956b58976aaf783b6ce24a4271c15ab))
+
 ## 1.44.0 (2026-05-28)
 
 Full Changelog: [v1.43.0...v1.44.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.43.0...v1.44.0)

data/README.md

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

data/SECURITY.md

@@ -1,27 +1,15 @@
 # Security Policy
 
-## Reporting Security Issues
-
-This SDK is generated by [Stainless Software Inc](http://stainless.com). Stainless takes security seriously, and encourages you to report any security vulnerability promptly so that appropriate action can be taken.
-
-To report a security issue, please contact the Stainless team at security@stainless.com.
-
-## Responsible Disclosure
-
-We appreciate the efforts of security researchers and individuals who help us maintain the security of
-SDKs we generate. If you believe you have found a security vulnerability, please adhere to responsible
-disclosure practices by allowing us a reasonable amount of time to investigate and address the issue
-before making any information public.
+Thank you for helping us keep the SDKs and systems they interact with secure.
 
-## Reporting Non-SDK Related Security Issues
+## Reporting Security Issues
 
-If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Anthropic, please follow the respective company's security reporting guidelines.
+This SDK is maintained by [Anthropic](https://www.anthropic.com/).
 
-### Anthropic Terms and Policies
+The security of our systems and user data is Anthropic’s top priority. We appreciate the work of security researchers acting in good faith in identifying and reporting potential vulnerabilities.
 
-Please contact support@anthropic.com for any questions or concerns regarding the security of our services.
+Our security program is managed on HackerOne and we ask that any validated vulnerability in this functionality be reported through their [submission form](https://hackerone.com/4f1f16ba-10d3-4d09-9ecc-c721aad90f24/embedded_submissions/new).
 
----
+## Anthropic Bug Bounty
 
-Thank you for helping us keep the SDKs and systems they interact with secure.
+Our Bug Bounty Program Guidelines are defined on our [HackerOne program page](https://hackerone.com/anthropic).

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]
 
@@ -134,13 +138,31 @@ module Anthropic
               content.signature = delta.signature
             in Anthropic::Models::BetaCompactionContentBlockDelta if content.type == :compaction
               content.content = delta.content
+              content.encrypted_content = delta.encrypted_content
             else
             end
           in Anthropic::Models::RawMessageDeltaEvent | Anthropic::Models::BetaRawMessageDeltaEvent
             current_snapshot.stop_reason = event.delta.stop_reason
             current_snapshot.stop_sequence = event.delta.stop_sequence
+            current_snapshot.stop_details = event.delta.stop_details unless event.delta.stop_details.nil?
             current_snapshot.usage.output_tokens = event.usage.output_tokens
 
+            # The message_delta usage is authoritative for the final counts; carry every
+            # field the event reports (only when present, so we never clobber the
+            # message_start values with nils).
+            unless event.usage.input_tokens.nil?
+              current_snapshot.usage.input_tokens = event.usage.input_tokens
+            end
+            unless event.usage.cache_creation_input_tokens.nil?
+              current_snapshot.usage.cache_creation_input_tokens = event.usage.cache_creation_input_tokens
+            end
+            unless event.usage.cache_read_input_tokens.nil?
+              current_snapshot.usage.cache_read_input_tokens = event.usage.cache_read_input_tokens
+            end
+            unless event.usage.server_tool_use.nil?
+              current_snapshot.usage.server_tool_use = event.usage.server_tool_use
+            end
+
             if event.is_a?(Anthropic::Models::BetaRawMessageDeltaEvent) && !event.usage.iterations.nil?
               current_snapshot.usage.iterations = event.usage.iterations
             end

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