anthropic 1.72.0 → 1.74.0

data/rbi/anthropic/models/beta/beta_mcp_tool.rbi

@@ -0,0 +1,52 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaMCPTool = Beta::BetaMCPTool
+
+    module Beta
+      class BetaMCPTool < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Anthropic::Beta::BetaMCPTool, Anthropic::Internal::AnyHash)
+          end
+
+        sig { returns(T::Hash[Symbol, T.anything]) }
+        attr_accessor :input_schema
+
+        sig { returns(String) }
+        attr_accessor :name
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :description
+
+        sig { params(description: String).void }
+        attr_writer :description
+
+        # A tool as an MCP server lists it: its name on that server, its description, and
+        # its input schema.
+        sig do
+          params(
+            input_schema: T::Hash[Symbol, T.anything],
+            name: String,
+            description: String
+          ).returns(T.attached_class)
+        end
+        def self.new(input_schema:, name:, description: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              input_schema: T::Hash[Symbol, T.anything],
+              name: String,
+              description: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_mcp_tool_listing_block.rbi

@@ -0,0 +1,53 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaMCPToolListingBlock = Beta::BetaMCPToolListingBlock
+
+    module Beta
+      class BetaMCPToolListingBlock < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaMCPToolListingBlock,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :mcp_server_name
+
+        sig { returns(T::Array[Anthropic::Beta::BetaMCPTool]) }
+        attr_accessor :tools
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # The tool listing the server fetched from an MCP server while producing this
+        # response. Send the assistant message back unchanged, this block included, so
+        # later requests use this listing instead of asking the MCP server again.
+        sig do
+          params(
+            mcp_server_name: String,
+            tools: T::Array[Anthropic::Beta::BetaMCPTool::OrHash],
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(mcp_server_name:, tools:, type: :mcp_tool_listing)
+        end
+
+        sig do
+          override.returns(
+            {
+              mcp_server_name: String,
+              tools: T::Array[Anthropic::Beta::BetaMCPTool],
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_mcp_tool_listing_block_param.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaMCPToolListingBlockParam = Beta::BetaMCPToolListingBlockParam
+
+    module Beta
+      class BetaMCPToolListingBlockParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaMCPToolListingBlockParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The name of the MCP server this listing came from, as `mcp_servers` declares it.
+        sig { returns(String) }
+        attr_accessor :mcp_server_name
+
+        # The server's tools, exactly as the response listed them.
+        sig { returns(T::Array[Anthropic::Beta::BetaMCPToolParam]) }
+        attr_accessor :tools
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # The tool listing an MCP server returned while an earlier response was produced,
+        # as that response carried it. Send the assistant message back unchanged, this
+        # block included, and the server uses this listing for the matching `mcp_toolset`
+        # instead of asking the MCP server again.
+        sig do
+          params(
+            mcp_server_name: String,
+            tools: T::Array[Anthropic::Beta::BetaMCPToolParam::OrHash],
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The name of the MCP server this listing came from, as `mcp_servers` declares it.
+          mcp_server_name:,
+          # The server's tools, exactly as the response listed them.
+          tools:,
+          type: :mcp_tool_listing
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              mcp_server_name: String,
+              tools: T::Array[Anthropic::Beta::BetaMCPToolParam],
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_mcp_tool_param.rbi

@@ -0,0 +1,62 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaMCPToolParam = Beta::BetaMCPToolParam
+
+    module Beta
+      class BetaMCPToolParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaMCPToolParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The tool's input schema as the MCP server lists it, verbatim.
+        sig { returns(T::Hash[Symbol, T.anything]) }
+        attr_accessor :input_schema
+
+        # The tool's name as the MCP server lists it (not prefixed with the server name).
+        sig { returns(String) }
+        attr_accessor :name
+
+        # The tool's description as the MCP server lists it.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :description
+
+        # A tool as an MCP server lists it: its name on that server, its description, and
+        # its input schema.
+        sig do
+          params(
+            input_schema: T::Hash[Symbol, T.anything],
+            name: String,
+            description: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The tool's input schema as the MCP server lists it, verbatim.
+          input_schema:,
+          # The tool's name as the MCP server lists it (not prefixed with the server name).
+          name:,
+          # The tool's description as the MCP server lists it.
+          description: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              input_schema: T::Hash[Symbol, T.anything],
+              name: String,
+              description: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_mcp_toolset.rbi

@@ -49,6 +49,13 @@ module Anthropic
         end
         attr_writer :default_config
 
+        # The server's tool listing, pinned: when present, the server is not asked for its
+        # tools before sampling and exactly these entries, with `default_config` and
+        # `configs` applied, are the toolset's tools. Copy it from the `mcp_tool_listing`
+        # block of an earlier response.
+        sig { returns(T.nilable(T::Array[Anthropic::Beta::BetaMCPToolParam])) }
+        attr_accessor :tools
+
         # Configuration for a group of tools from an MCP server.
         #
         # Allows configuring enabled status and defer_loading for all tools from an MCP
@@ -63,6 +70,8 @@ module Anthropic
                 T::Hash[Symbol, Anthropic::Beta::BetaMCPToolConfig::OrHash]
               ),
             default_config: Anthropic::Beta::BetaMCPToolDefaultConfig::OrHash,
+            tools:
+              T.nilable(T::Array[Anthropic::Beta::BetaMCPToolParam::OrHash]),
             type: Symbol
           ).returns(T.attached_class)
         end
@@ -75,6 +84,11 @@ module Anthropic
           configs: nil,
           # Default configuration applied to all tools from this server
           default_config: nil,
+          # The server's tool listing, pinned: when present, the server is not asked for its
+          # tools before sampling and exactly these entries, with `default_config` and
+          # `configs` applied, are the toolset's tools. Copy it from the `mcp_tool_listing`
+          # block of an earlier response.
+          tools: nil,
           type: :mcp_toolset
         )
         end
@@ -88,7 +102,8 @@ module Anthropic
                 T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
               configs:
                 T.nilable(T::Hash[Symbol, Anthropic::Beta::BetaMCPToolConfig]),
-              default_config: Anthropic::Beta::BetaMCPToolDefaultConfig
+              default_config: Anthropic::Beta::BetaMCPToolDefaultConfig,
+              tools: T.nilable(T::Array[Anthropic::Beta::BetaMCPToolParam])
             }
           )
         end

data/rbi/anthropic/models/beta/beta_message.rbi

@@ -17,8 +17,9 @@ module Anthropic
         sig { returns(String) }
         attr_accessor :id
 
-        # Information about the container used in the request (for the code execution
-        # tool)
+        # Information about the container used in this request.
+        #
+        # This will be non-null if a container tool (e.g. code execution) was used.
         sig { returns(T.nilable(Anthropic::Beta::BetaContainer)) }
         attr_reader :container
 
@@ -84,8 +85,8 @@ module Anthropic
         end
         attr_writer :context_management
 
-        # Response envelope for request-level diagnostics. Present (possibly null)
-        # whenever the caller supplied `diagnostics` on the request.
+        # Request-level diagnostics. `null` when the request did not supply `diagnostics`,
+        # or when it did and no prompt-cache divergence was detected.
         sig { returns(T.nilable(Anthropic::Beta::BetaDiagnostics)) }
         attr_reader :diagnostics
 
@@ -109,7 +110,9 @@ module Anthropic
         sig { returns(Symbol) }
         attr_accessor :role
 
-        # Structured information about a refusal.
+        # Structured information about why model output stopped.
+        #
+        # This is `null` when the `stop_reason` has no additional detail to report.
         sig { returns(T.nilable(Anthropic::Beta::BetaRefusalStopDetails)) }
         attr_reader :stop_details
 
@@ -228,7 +231,8 @@ module Anthropic
                   Anthropic::Beta::BetaMCPToolResultBlock::OrHash,
                   Anthropic::Beta::BetaContainerUploadBlock::OrHash,
                   Anthropic::Beta::BetaCompactionBlock::OrHash,
-                  Anthropic::Beta::BetaFallbackBlock::OrHash
+                  Anthropic::Beta::BetaFallbackBlock::OrHash,
+                  Anthropic::Beta::BetaMCPToolListingBlock::OrHash
                 )
               ],
             context_management:
@@ -258,8 +262,9 @@ module Anthropic
           #
           # The format and length of IDs may change over time.
           id:,
-          # Information about the container used in the request (for the code execution
-          # tool)
+          # Information about the container used in this request.
+          #
+          # This will be non-null if a container tool (e.g. code execution) was used.
           container:,
           # Content generated by the model.
           #
@@ -298,15 +303,17 @@ module Anthropic
           #
           # Information about context management strategies applied during the request.
           context_management:,
-          # Response envelope for request-level diagnostics. Present (possibly null)
-          # whenever the caller supplied `diagnostics` on the request.
+          # Request-level diagnostics. `null` when the request did not supply `diagnostics`,
+          # or when it did and no prompt-cache divergence was detected.
           diagnostics:,
           # The model that will complete your prompt.
           #
           # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
-          # Structured information about a refusal.
+          # Structured information about why model output stopped.
+          #
+          # This is `null` when the `stop_reason` has no additional detail to report.
           stop_details:,
           # The reason that we stopped.
           #

data/rbi/anthropic/models/beta/beta_message_delta_usage.rbi

@@ -23,6 +23,10 @@ module Anthropic
         attr_accessor :cache_read_input_tokens
 
         # Outcome of the `fallback_credit_token` presented on this request.
+        #
+        # Present on every response to a non-batch request that carried a
+        # `fallback_credit_token`, in either redemption mode; absent otherwise (batch
+        # items accept and ignore the token and carry no outcome object).
         sig { returns(T.nilable(Anthropic::Beta::BetaFallbackCreditUsage)) }
         attr_reader :fallback_credit
 
@@ -133,6 +137,10 @@ module Anthropic
           # The cumulative number of input tokens read from the cache.
           cache_read_input_tokens:,
           # Outcome of the `fallback_credit_token` presented on this request.
+          #
+          # Present on every response to a non-batch request that carried a
+          # `fallback_credit_token`, in either redemption mode; absent otherwise (batch
+          # items accept and ignore the token and carry no outcome object).
           fallback_credit:,
           # The cumulative number of input tokens which were used.
           input_tokens:,

data/rbi/anthropic/models/beta/beta_model_capabilities.rbi

@@ -43,9 +43,8 @@ module Anthropic
         end
         attr_writer :code_execution
 
-        # Compaction capability details: whether the model accepts the top-level
-        # `compaction` request parameter, with one entry per supported `compaction.type`
-        # value.
+        # Server-side compaction support (the top-level `compaction` parameter) and the
+        # accepted `compaction.type` values.
         sig { returns(T.nilable(Anthropic::Beta::BetaCompactionCapability)) }
         attr_reader :compaction
 
@@ -142,9 +141,8 @@ module Anthropic
           citations:,
           # Whether the model supports code execution tools.
           code_execution:,
-          # Compaction capability details: whether the model accepts the top-level
-          # `compaction` request parameter, with one entry per supported `compaction.type`
-          # value.
+          # Server-side compaction support (the top-level `compaction` parameter) and the
+          # accepted `compaction.type` values.
           compaction:,
           # Context management support and available strategies.
           context_management:,

data/rbi/anthropic/models/beta/beta_model_info.rbi

@@ -21,7 +21,8 @@ module Anthropic
         sig { returns(T.nilable(T::Array[String])) }
         attr_accessor :allowed_fallback_models
 
-        # Model capability information.
+        # Object mapping capability names to their support details. Keys are always
+        # present for all known capabilities.
         sig { returns(T.nilable(Anthropic::Beta::BetaModelCapabilities)) }
         attr_reader :capabilities
 
@@ -76,7 +77,8 @@ module Anthropic
           # empty list means the `fallbacks` parameter is not supported for this model as
           # primary.
           allowed_fallback_models:,
-          # Model capability information.
+          # Object mapping capability names to their support details. Keys are always
+          # present for all known capabilities.
           capabilities:,
           # RFC 3339 datetime string representing the time at which the model was released.
           # May be set to an epoch value if the release date is unknown.

data/rbi/anthropic/models/beta/beta_output_behavior.rbi

@@ -5,6 +5,8 @@ module Anthropic
     BetaOutputBehavior = Beta::BetaOutputBehavior
 
     module Beta
+      # Which memory store a dream writes its result to. Defaults to `create_new` when
+      # left out of a create request.
       module BetaOutputBehavior
         extend Anthropic::Internal::Type::Union
 
@@ -61,7 +63,13 @@ module Anthropic
             memory_store_id: String
           ).returns(Anthropic::Beta::BetaOutputBehavior::Variants)
         end
-        def self.new(type:, memory_store_id: nil)
+        def self.new(
+          type:,
+          # The ID of the memory store for the dream to write its result to
+          # (`memstore_...`). It must be the memory store in the `memory_store` entry of
+          # `inputs`.
+          memory_store_id: nil
+        )
         end
       end
     end

data/rbi/anthropic/models/beta/beta_output_behavior_create_new.rbi

@@ -19,9 +19,11 @@ module Anthropic
         end
         attr_accessor :type
 
-        # The default destination: the job creates a new output memory store as a clone of
-        # the memory_store input and writes the consolidated memories into it. The input
-        # store is never mutated.
+        # Write the result to a new memory store that starts as a copy of the input memory
+        # store. This is the default.
+        #
+        # The new memory store is in the same workspace as the dream. The dream doesn't
+        # change the input memory store.
         sig do
           params(
             type: Anthropic::Beta::BetaOutputBehaviorCreateNew::Type::OrSymbol

data/rbi/anthropic/models/beta/beta_output_behavior_update_existing.rbi

@@ -14,6 +14,9 @@ module Anthropic
             )
           end
 
+        # The ID of the memory store for the dream to write its result to
+        # (`memstore_...`). It must be the memory store in the `memory_store` entry of
+        # `inputs`.
         sig { returns(String) }
         attr_accessor :memory_store_id
 
@@ -24,9 +27,11 @@ module Anthropic
         end
         attr_accessor :type
 
-        # The job writes the consolidated memories into this existing memory store instead
-        # of creating one. In EAP the store must be the job's own memory_store input, so
-        # the job consolidates the store in place.
+        # Write the result into the input memory store instead of a new memory store.
+        #
+        # The credential must be allowed to write memory stores, or the request returns a
+        # 403 error. While another `update_existing` dream on the same memory store hasn't
+        # fully stopped, the request returns a 409 error.
         sig do
           params(
             memory_store_id: String,
@@ -34,7 +39,13 @@ module Anthropic
               Anthropic::Beta::BetaOutputBehaviorUpdateExisting::Type::OrSymbol
           ).returns(T.attached_class)
         end
-        def self.new(memory_store_id:, type:)
+        def self.new(
+          # The ID of the memory store for the dream to write its result to
+          # (`memstore_...`). It must be the memory store in the `memory_store` entry of
+          # `inputs`.
+          memory_store_id:,
+          type:
+        )
         end
 
         sig do

data/rbi/anthropic/models/beta/beta_output_config.rbi

@@ -14,7 +14,10 @@ module Anthropic
             )
           end
 
-        # All possible effort levels.
+        # How much effort the model should put into its response. Higher effort levels may
+        # result in more thorough analysis but take longer.
+        #
+        # Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
         sig do
           returns(
             T.nilable(Anthropic::Beta::BetaOutputConfig::Effort::OrSymbol)
@@ -34,7 +37,7 @@ module Anthropic
         end
         attr_writer :format_
 
-        # User-configurable total token budget across contexts.
+        # Configuration for token budget tracking across contexts.
         sig { returns(T.nilable(Anthropic::Beta::BetaTokenTaskBudget)) }
         attr_reader :task_budget
 
@@ -54,12 +57,15 @@ module Anthropic
           ).returns(T.attached_class)
         end
         def self.new(
-          # All possible effort levels.
+          # How much effort the model should put into its response. Higher effort levels may
+          # result in more thorough analysis but take longer.
+          #
+          # Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
           effort: nil,
           # A schema to specify Claude's output format in responses. See
           # [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
           format_: nil,
-          # User-configurable total token budget across contexts.
+          # Configuration for token budget tracking across contexts.
           task_budget: nil
         )
         end
@@ -77,7 +83,10 @@ module Anthropic
         def to_hash
         end
 
-        # All possible effort levels.
+        # How much effort the model should put into its response. Higher effort levels may
+        # result in more thorough analysis but take longer.
+        #
+        # Valid values are `low`, `medium`, `high`, `xhigh`, or `max`.
         module Effort
           extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/beta_raw_content_block_start_event.rbi

@@ -47,7 +47,8 @@ module Anthropic
                 Anthropic::Beta::BetaMCPToolResultBlock::OrHash,
                 Anthropic::Beta::BetaContainerUploadBlock::OrHash,
                 Anthropic::Beta::BetaCompactionBlock::OrHash,
-                Anthropic::Beta::BetaFallbackBlock::OrHash
+                Anthropic::Beta::BetaFallbackBlock::OrHash,
+                Anthropic::Beta::BetaMCPToolListingBlock::OrHash
               ),
             index: Integer,
             type: Symbol
@@ -91,7 +92,8 @@ module Anthropic
                 Anthropic::Beta::BetaMCPToolResultBlock,
                 Anthropic::Beta::BetaContainerUploadBlock,
                 Anthropic::Beta::BetaCompactionBlock,
-                Anthropic::Beta::BetaFallbackBlock
+                Anthropic::Beta::BetaFallbackBlock,
+                Anthropic::Beta::BetaMCPToolListingBlock
               )
             end
 
@@ -192,6 +194,11 @@ module Anthropic
                 :fallback,
                 Anthropic::Beta::BetaRawContentBlockStartEvent::ContentBlock::Type::TaggedSymbol
               )
+            MCP_TOOL_LISTING =
+              T.let(
+                :mcp_tool_listing,
+                Anthropic::Beta::BetaRawContentBlockStartEvent::ContentBlock::Type::TaggedSymbol
+              )
 
             sig do
               override.returns(
@@ -292,9 +299,20 @@ module Anthropic
               is_error: T::Boolean,
               file_id: String,
               encrypted_content: T.nilable(String),
+              tool_changes:
+                T.nilable(
+                  T::Array[
+                    T.any(
+                      Anthropic::Beta::BetaResponseToolAdditionBlock::OrHash,
+                      Anthropic::Beta::BetaResponseToolRemovalBlock::OrHash
+                    )
+                  ]
+                ),
               from: Anthropic::Beta::BetaFallbackInfo::OrHash,
               to: Anthropic::Beta::BetaFallbackInfo::OrHash,
-              trigger: Anthropic::Beta::BetaFallbackRefusalTrigger::OrHash
+              trigger: Anthropic::Beta::BetaFallbackRefusalTrigger::OrHash,
+              mcp_server_name: String,
+              tools: T::Array[Anthropic::Beta::BetaMCPTool::OrHash]
             ).returns(
               Anthropic::Beta::BetaRawContentBlockStartEvent::ContentBlock::Variants
             )
@@ -348,6 +366,11 @@ module Anthropic
             file_id: nil,
             # Opaque metadata from prior compaction, to be round-tripped verbatim
             encrypted_content: nil,
+            # The tool changes of the compacted range: the `tool_addition` and `tool_removal`
+            # blocks that take the request's `tools` to the tool set in effect at the end of
+            # the range, or `[]` when the range changed no tool. Absent when the server did
+            # not compute them. Send the block back unchanged.
+            tool_changes: nil,
             # 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
@@ -357,7 +380,9 @@ module Anthropic
             # always the canonical id.
             to: nil,
             # What caused the `from` model to hand over at this hop.
-            trigger: nil
+            trigger: nil,
+            mcp_server_name: nil,
+            tools: nil
           )
           end
         end

data/rbi/anthropic/models/beta/beta_raw_message_delta_event.rbi

@@ -183,8 +183,9 @@ module Anthropic
               )
             end
 
-          # Information about the container used in the request (for the code execution
-          # tool)
+          # Information about the container used in this request.
+          #
+          # This will be non-null if a container tool (e.g. code execution) was used.
           sig { returns(T.nilable(Anthropic::Beta::BetaContainer)) }
           attr_reader :container
 
@@ -195,7 +196,9 @@ module Anthropic
           end
           attr_writer :container
 
-          # Structured information about a refusal.
+          # Structured information about why model output stopped.
+          #
+          # This is `null` when the `stop_reason` has no additional detail to report.
           sig { returns(T.nilable(Anthropic::Beta::BetaRefusalStopDetails)) }
           attr_reader :stop_details
 
@@ -225,10 +228,13 @@ module Anthropic
             ).returns(T.attached_class)
           end
           def self.new(
-            # Information about the container used in the request (for the code execution
-            # tool)
+            # Information about the container used in this request.
+            #
+            # This will be non-null if a container tool (e.g. code execution) was used.
             container:,
-            # Structured information about a refusal.
+            # Structured information about why model output stopped.
+            #
+            # This is `null` when the `stop_reason` has no additional detail to report.
             stop_details:,
             stop_reason:,
             stop_sequence: