anthropic 1.45.0 → 1.47.0

data/rbi/anthropic/models/beta/agent_update_params.rbi

@@ -24,8 +24,7 @@ module Anthropic
         sig { returns(Integer) }
         attr_accessor :version
 
-        # 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.
         sig { returns(T.nilable(String)) }
         attr_accessor :description
 
@@ -92,7 +91,7 @@ module Anthropic
         end
         attr_writer :multiagent
 
-        # 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.
         sig { returns(T.nilable(String)) }
         attr_reader :name
 
@@ -100,7 +99,6 @@ module Anthropic
         attr_writer :name
 
         # Skills. Full replacement. Omit to preserve; send empty array or null to clear.
-        # Maximum 20.
         sig do
           returns(
             T.nilable(
@@ -115,8 +113,7 @@ module Anthropic
         end
         attr_accessor :skills
 
-        # 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.
         sig { returns(T.nilable(String)) }
         attr_accessor :system_
 
@@ -208,8 +205,7 @@ module Anthropic
           # value from a create or retrieve response. The request fails if this does not
           # match the server's current version.
           version:,
-          # 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.
           description: nil,
           # MCP servers. Full replacement. Omit to preserve; send empty array or null to
           # clear. Names must be unique. Maximum 20.
@@ -226,13 +222,11 @@ module Anthropic
           # A coordinator topology: the session's primary thread orchestrates work by
           # spawning session threads, each running an agent drawn from the `agents` roster.
           multiagent: nil,
-          # 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.
           name: nil,
           # Skills. Full replacement. Omit to preserve; send empty array or null to clear.
-          # Maximum 20.
           skills: nil,
-          # 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.
           system_: nil,
           # Tool configurations available to the agent. Full replacement. Omit to preserve;
           # send empty array or null to clear. Maximum of 128 tools across all toolsets

data/rbi/anthropic/models/beta/beta_advisor_tool_20260301.rbi

@@ -85,6 +85,16 @@ module Anthropic
         sig { params(defer_loading: T::Boolean).void }
         attr_writer :defer_loading
 
+        # 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.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :max_tokens
+
         # Maximum number of times the tool can be used in the API request.
         sig { returns(T.nilable(Integer)) }
         attr_accessor :max_uses
@@ -108,6 +118,7 @@ module Anthropic
             caching:
               T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
             defer_loading: T::Boolean,
+            max_tokens: T.nilable(Integer),
             max_uses: T.nilable(Integer),
             strict: T::Boolean,
             name: Symbol,
@@ -130,6 +141,14 @@ module Anthropic
           # If true, tool will not be included in initial system prompt. Only loaded when
           # returned via tool_reference from tool search.
           defer_loading: nil,
+          # 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.
+          max_tokens: nil,
           # Maximum number of times the tool can be used in the API request.
           max_uses: nil,
           # When true, guarantees schema validation on tool names and inputs
@@ -156,6 +175,7 @@ module Anthropic
                 T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
               caching: T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
               defer_loading: T::Boolean,
+              max_tokens: T.nilable(Integer),
               max_uses: T.nilable(Integer),
               strict: T::Boolean
             }

data/rbi/anthropic/models/beta/beta_advisor_tool_result_error.rbi

@@ -88,6 +88,11 @@ module Anthropic
               :execution_time_exceeded,
               Anthropic::Beta::BetaAdvisorToolResultError::ErrorCode::TaggedSymbol
             )
+          MODEL_NOT_FOUND =
+            T.let(
+              :model_not_found,
+              Anthropic::Beta::BetaAdvisorToolResultError::ErrorCode::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/anthropic/models/beta/beta_advisor_tool_result_error_param.rbi

@@ -88,6 +88,11 @@ module Anthropic
               :execution_time_exceeded,
               Anthropic::Beta::BetaAdvisorToolResultErrorParam::ErrorCode::TaggedSymbol
             )
+          MODEL_NOT_FOUND =
+            T.let(
+              :model_not_found,
+              Anthropic::Beta::BetaAdvisorToolResultErrorParam::ErrorCode::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/anthropic/models/beta/beta_content_block.rbi

@@ -27,7 +27,8 @@ module Anthropic
               Anthropic::Beta::BetaMCPToolUseBlock,
               Anthropic::Beta::BetaMCPToolResultBlock,
               Anthropic::Beta::BetaContainerUploadBlock,
-              Anthropic::Beta::BetaCompactionBlock
+              Anthropic::Beta::BetaCompactionBlock,
+              Anthropic::Beta::BetaFallbackBlock
             )
           end
 

data/rbi/anthropic/models/beta/beta_content_block_param.rbi

@@ -32,7 +32,8 @@ module Anthropic
               Anthropic::Beta::BetaRequestMCPToolResultBlockParam,
               Anthropic::Beta::BetaContainerUploadBlockParam,
               Anthropic::Beta::BetaCompactionBlockParam,
-              Anthropic::Beta::BetaMidConversationSystemBlockParam
+              Anthropic::Beta::BetaMidConversationSystemBlockParam,
+              Anthropic::Beta::BetaFallbackBlockParam
             )
           end
 

data/rbi/anthropic/models/beta/beta_fallback_block.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackBlock = Beta::BetaFallbackBlock
+
+    module Beta
+      class BetaFallbackBlock < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackBlock,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # 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.
+        sig { returns(Anthropic::Beta::BetaFallbackInfo) }
+        attr_reader :from
+
+        sig { params(from: Anthropic::Beta::BetaFallbackInfo::OrHash).void }
+        attr_writer :from
+
+        # The fallback model producing the content that follows this block. Its `model` is
+        # always the canonical id.
+        sig { returns(Anthropic::Beta::BetaFallbackInfo) }
+        attr_reader :to
+
+        sig { params(to: Anthropic::Beta::BetaFallbackInfo::OrHash).void }
+        attr_writer :to
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # 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.
+        sig do
+          params(
+            from: Anthropic::Beta::BetaFallbackInfo::OrHash,
+            to: Anthropic::Beta::BetaFallbackInfo::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # 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.
+          from:,
+          # The fallback model producing the content that follows this block. Its `model` is
+          # always the canonical id.
+          to:,
+          type: :fallback
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              from: Anthropic::Beta::BetaFallbackInfo,
+              to: Anthropic::Beta::BetaFallbackInfo,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_fallback_block_param.rbi

@@ -0,0 +1,81 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackBlockParam = Beta::BetaFallbackBlockParam
+
+    module Beta
+      class BetaFallbackBlockParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackBlockParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Identifies one hop of a fallback transition.
+        sig { returns(Anthropic::Beta::BetaFallbackInfoParam) }
+        attr_reader :from
+
+        sig do
+          params(from: Anthropic::Beta::BetaFallbackInfoParam::OrHash).void
+        end
+        attr_writer :from
+
+        # Identifies one hop of a fallback transition.
+        sig { returns(Anthropic::Beta::BetaFallbackInfoParam) }
+        attr_reader :to
+
+        sig { params(to: Anthropic::Beta::BetaFallbackInfoParam::OrHash).void }
+        attr_writer :to
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # 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.
+        sig do
+          params(
+            from: Anthropic::Beta::BetaFallbackInfoParam::OrHash,
+            to: Anthropic::Beta::BetaFallbackInfoParam::OrHash,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Identifies one hop of a fallback transition.
+          from:,
+          # Identifies one hop of a fallback transition.
+          to:,
+          type: :fallback
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              from: Anthropic::Beta::BetaFallbackInfoParam,
+              to: Anthropic::Beta::BetaFallbackInfoParam,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_fallback_info.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackInfo = Beta::BetaFallbackInfo
+
+    module Beta
+      class BetaFallbackInfo < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackInfo,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The model that will complete your prompt.
+        #
+        # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        # details and options.
+        sig { returns(Anthropic::Model::Variants) }
+        attr_accessor :model
+
+        # Identifies one hop of a fallback transition.
+        sig do
+          params(model: T.any(Anthropic::Model::OrSymbol, String)).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The model that will complete your prompt.
+          #
+          # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+          # details and options.
+          model:
+        )
+        end
+
+        sig { override.returns({ model: Anthropic::Model::Variants }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_fallback_info_param.rbi

@@ -0,0 +1,47 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackInfoParam = Beta::BetaFallbackInfoParam
+
+    module Beta
+      class BetaFallbackInfoParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackInfoParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The model that will complete your prompt.
+        #
+        # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        # details and options.
+        sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
+        attr_accessor :model
+
+        # Identifies one hop of a fallback transition.
+        sig do
+          params(model: T.any(Anthropic::Model::OrSymbol, String)).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The model that will complete your prompt.
+          #
+          # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+          # details and options.
+          model:
+        )
+        end
+
+        sig do
+          override.returns({ model: T.any(Anthropic::Model::OrSymbol, String) })
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_fallback_message_iteration_usage.rbi

@@ -0,0 +1,113 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaFallbackMessageIterationUsage = Beta::BetaFallbackMessageIterationUsage
+
+    module Beta
+      class BetaFallbackMessageIterationUsage < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaFallbackMessageIterationUsage,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # Breakdown of cached tokens by TTL
+        sig { returns(T.nilable(Anthropic::Beta::BetaCacheCreation)) }
+        attr_reader :cache_creation
+
+        sig do
+          params(
+            cache_creation:
+              T.nilable(Anthropic::Beta::BetaCacheCreation::OrHash)
+          ).void
+        end
+        attr_writer :cache_creation
+
+        # The number of input tokens used to create the cache entry.
+        sig { returns(Integer) }
+        attr_accessor :cache_creation_input_tokens
+
+        # The number of input tokens read from the cache.
+        sig { returns(Integer) }
+        attr_accessor :cache_read_input_tokens
+
+        # The number of input tokens which were used.
+        sig { returns(Integer) }
+        attr_accessor :input_tokens
+
+        # The model that will complete your prompt.
+        #
+        # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+        # details and options.
+        sig { returns(Anthropic::Model::Variants) }
+        attr_accessor :model
+
+        # The number of output tokens which were used.
+        sig { returns(Integer) }
+        attr_accessor :output_tokens
+
+        # Usage for the fallback-model attempt that served the response
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # 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`.
+        sig do
+          params(
+            cache_creation:
+              T.nilable(Anthropic::Beta::BetaCacheCreation::OrHash),
+            cache_creation_input_tokens: Integer,
+            cache_read_input_tokens: Integer,
+            input_tokens: Integer,
+            model: T.any(Anthropic::Model::OrSymbol, String),
+            output_tokens: Integer,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Breakdown of cached tokens by TTL
+          cache_creation:,
+          # The number of input tokens used to create the cache entry.
+          cache_creation_input_tokens:,
+          # The number of input tokens read from the cache.
+          cache_read_input_tokens:,
+          # The number of input tokens which were used.
+          input_tokens:,
+          # The model that will complete your prompt.
+          #
+          # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+          # details and options.
+          model:,
+          # The number of output tokens which were used.
+          output_tokens:,
+          # Usage for the fallback-model attempt that served the response
+          type: :fallback_message
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              cache_creation: T.nilable(Anthropic::Beta::BetaCacheCreation),
+              cache_creation_input_tokens: Integer,
+              cache_read_input_tokens: Integer,
+              input_tokens: Integer,
+              model: Anthropic::Model::Variants,
+              output_tokens: Integer,
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end