anthropic 1.72.0 → 1.74.0

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

@@ -47,8 +47,8 @@ module Anthropic
         optional :metadata, Anthropic::Internal::Type::HashOf[String]
 
         # @!attribute multiagent
-        #   A coordinator topology: the session's primary thread orchestrates work by
-        #   spawning session threads, each running an agent drawn from the `agents` roster.
+        #   Multiagent orchestration configuration. Currently supports the `coordinator`
+        #   topology with a roster of 1-20 agents.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil]
         optional :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams }, nil?: true
@@ -81,6 +81,12 @@ module Anthropic
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
+        #   Optional header to select the Workspace for this request. The value is a
+        #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+        #
+        #   Only needed for credentials that can act on more than one Workspace. A
+        #   credential that belongs to a specific Workspace may omit it; if sent, it must
+        #   match that Workspace.
         #
         #   @return [String, nil]
         optional :workspace_id, String
@@ -99,7 +105,7 @@ module Anthropic
         #
         #   @param metadata [Hash{Symbol=>String}] Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up t
         #
-        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] A coordinator topology: the session's primary thread orchestrates work by spawni
+        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] Multiagent orchestration configuration. Currently supports the `coordinator` top
         #
         #   @param skills [Array<Anthropic::Models::Beta::BetaManagedAgentsAnthropicSkillParams, Anthropic::Models::Beta::BetaManagedAgentsCustomSkillParams>] Skills available to the agent.
         #
@@ -109,7 +115,7 @@ module Anthropic
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        #   @param workspace_id [String]
+        #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
 
@@ -173,13 +179,13 @@ module Anthropic
           #
           #   @option args [Array<Anthropic::Models::Beta::BetaManagedAgentsBashToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsEditToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGlobToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGrepToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams>, Array<Anthropic::Models::Beta::BetaManagedAgentsMCPToolConfigParams>] :configs Per-tool configuration overrides.
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration for all tools in a toolset.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration applied to all tools in this set.
           #
           #   @option args [String] :mcp_server_name Name of the MCP server. Must match a server name from the mcp_servers array. 1-2
           #
           #   @option args [String] :description Description of what the tool does, shown to the agent to help it decide when to
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema for custom tool input parameters.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema defining the expected input parameters for the tool.
           #
           #   @option args [String] :name Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
           #

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

@@ -45,11 +45,20 @@ module Anthropic
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
+        #   Optional header to select the Workspace for this request. The value is a
+        #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+        #
+        #   Only needed for credentials that can act on more than one Workspace. A
+        #   credential that belongs to a specific Workspace may omit it; if sent, it must
+        #   match that Workspace.
         #
         #   @return [String, nil]
         optional :workspace_id, String
 
         # @!method initialize(created_at_gte: nil, created_at_lte: nil, include_archived: nil, limit: nil, page: nil, betas: nil, workspace_id: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::AgentListParams} for more details.
+        #
         #   @param created_at_gte [Time] Return agents created at or after this time (inclusive).
         #
         #   @param created_at_lte [Time] Return agents created at or before this time (inclusive).
@@ -62,7 +71,7 @@ module Anthropic
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        #   @param workspace_id [String]
+        #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
       end

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

@@ -9,6 +9,7 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute agent_id
+        #   Unique identifier of the agent to retrieve.
         #
         #   @return [String]
         required :agent_id, String
@@ -27,6 +28,12 @@ module Anthropic
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
+        #   Optional header to select the Workspace for this request. The value is a
+        #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+        #
+        #   Only needed for credentials that can act on more than one Workspace. A
+        #   credential that belongs to a specific Workspace may omit it; if sent, it must
+        #   match that Workspace.
         #
         #   @return [String, nil]
         optional :workspace_id, String
@@ -35,13 +42,13 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::AgentRetrieveParams} for more details.
         #
-        #   @param agent_id [String]
+        #   @param agent_id [String] Unique identifier of the agent to retrieve.
         #
         #   @param version [Integer] Agent version. Omit for the most recent version. Must be at least 1 if specified
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        #   @param workspace_id [String]
+        #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
       end

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

@@ -9,6 +9,7 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute agent_id
+        #   Unique identifier of the agent to update.
         #
         #   @return [String]
         required :agent_id, String
@@ -51,8 +52,8 @@ module Anthropic
         optional :model, union: -> { Anthropic::Beta::AgentUpdateParams::Model }
 
         # @!attribute multiagent
-        #   A coordinator topology: the session's primary thread orchestrates work by
-        #   spawning session threads, each running an agent drawn from the `agents` roster.
+        #   Multiagent orchestration configuration. Full replacement. Omit to preserve; send
+        #   null to clear.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil]
         optional :multiagent, -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams }, nil?: true
@@ -105,6 +106,12 @@ module Anthropic
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
+        #   Optional header to select the Workspace for this request. The value is a
+        #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+        #
+        #   Only needed for credentials that can act on more than one Workspace. A
+        #   credential that belongs to a specific Workspace may omit it; if sent, it must
+        #   match that Workspace.
         #
         #   @return [String, nil]
         optional :workspace_id, String
@@ -113,7 +120,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::AgentUpdateParams} for more details.
         #
-        #   @param agent_id [String]
+        #   @param agent_id [String] Unique identifier of the agent to update.
         #
         #   @param description [String, nil] Description. Omit to preserve; send empty string or null to clear.
         #
@@ -123,7 +130,7 @@ module Anthropic
         #
         #   @param model [Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] Model identifier. Accepts the [model string](https://platform.claude.com/docs/en
         #
-        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] A coordinator topology: the session's primary thread orchestrates work by spawni
+        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams, nil] Multiagent orchestration configuration. Full replacement. Omit to preserve; send
         #
         #   @param name [String] Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.
         #
@@ -137,7 +144,7 @@ module Anthropic
         #
         #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
-        #   @param workspace_id [String]
+        #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
 
@@ -201,13 +208,13 @@ module Anthropic
           #
           #   @option args [Array<Anthropic::Models::Beta::BetaManagedAgentsBashToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsEditToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGlobToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGrepToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams>, Array<Anthropic::Models::Beta::BetaManagedAgentsMCPToolConfigParams>] :configs Per-tool configuration overrides.
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration for all tools in a toolset.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration applied to all tools in this set.
           #
           #   @option args [String] :mcp_server_name Name of the MCP server. Must match a server name from the mcp_servers array. 1-2
           #
           #   @option args [String] :description Description of what the tool does, shown to the agent to help it decide when to
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema for custom tool input parameters.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema defining the expected input parameters for the tool.
           #
           #   @option args [String] :name Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
           #

data/lib/anthropic/models/beta/agents/version_list_params.rb

@@ -10,6 +10,7 @@ module Anthropic
           include Anthropic::Internal::Type::RequestParameters
 
           # @!attribute agent_id
+          #   Agent ID to list versions for.
           #
           #   @return [String]
           required :agent_id, String
@@ -33,12 +34,21 @@ module Anthropic
           optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
           # @!attribute workspace_id
+          #   Optional header to select the Workspace for this request. The value is a
+          #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+          #
+          #   Only needed for credentials that can act on more than one Workspace. A
+          #   credential that belongs to a specific Workspace may omit it; if sent, it must
+          #   match that Workspace.
           #
           #   @return [String, nil]
           optional :workspace_id, String
 
           # @!method initialize(agent_id:, limit: nil, page: nil, betas: nil, workspace_id: nil, request_options: {})
-          #   @param agent_id [String]
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Agents::VersionListParams} for more details.
+          #
+          #   @param agent_id [String] Agent ID to list versions for.
           #
           #   @param limit [Integer] Maximum results per page. Default 20, maximum 100.
           #
@@ -46,7 +56,7 @@ module Anthropic
           #
           #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
           #
-          #   @param workspace_id [String]
+          #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
           #
           #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
         end

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

@@ -16,11 +16,8 @@ module Anthropic
         optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
 
         # @!attribute configs
-        #   Per-member configuration for `browser_toolset_20260801`: one optional field per
-        #   member tool, keyed by the member name — the same name the member's `tool_use`
-        #   blocks carry. Every member is an accepted key, and a member's defaults apply
-        #   wherever its key is absent. Unknown keys are rejected: the field set is this
-        #   toolset version's complete member set.
+        #   Sparse per-member overrides, keyed by member name. Absent, null, and {} are
+        #   equivalent; a member's defaults apply wherever its key is absent.
         #
         #   @return [Anthropic::Models::Beta::BetaBrowserToolsetConfigs, nil]
         optional :configs, -> { Anthropic::Beta::BetaBrowserToolsetConfigs }, nil?: true
@@ -35,7 +32,7 @@ module Anthropic
         #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
         #
-        #   @param configs [Anthropic::Models::Beta::BetaBrowserToolsetConfigs, nil] Per-member configuration for `browser_toolset_20260801`: one
+        #   @param configs [Anthropic::Models::Beta::BetaBrowserToolsetConfigs, nil] Sparse per-member overrides, keyed by member name. Absent, null, and {} are equi
         #
         #   @param type [Symbol, :browser_toolset_20260801]
       end

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

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module BetaCacheMissReason
+        extend Anthropic::Internal::Type::Union
+
+        discriminator :type
+
+        variant :model_changed, -> { Anthropic::Beta::BetaCacheMissModelChanged }
+
+        variant :system_changed, -> { Anthropic::Beta::BetaCacheMissSystemChanged }
+
+        variant :tools_changed, -> { Anthropic::Beta::BetaCacheMissToolsChanged }
+
+        variant :messages_changed, -> { Anthropic::Beta::BetaCacheMissMessagesChanged }
+
+        variant :previous_message_not_found, -> { Anthropic::Beta::BetaCacheMissPreviousMessageNotFound }
+
+        variant :unavailable, -> { Anthropic::Beta::BetaCacheMissUnavailable }
+
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          MODEL_CHANGED = :model_changed
+          SYSTEM_CHANGED = :system_changed
+          TOOLS_CHANGED = :tools_changed
+          MESSAGES_CHANGED = :messages_changed
+          PREVIOUS_MESSAGE_NOT_FOUND = :previous_message_not_found
+          UNAVAILABLE = :unavailable
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @!method self.variants
+        #   @return [Array(Anthropic::Models::Beta::BetaCacheMissModelChanged, Anthropic::Models::Beta::BetaCacheMissSystemChanged, Anthropic::Models::Beta::BetaCacheMissToolsChanged, Anthropic::Models::Beta::BetaCacheMissMessagesChanged, Anthropic::Models::Beta::BetaCacheMissPreviousMessageNotFound, Anthropic::Models::Beta::BetaCacheMissUnavailable)]
+
+        # Creates a new instance of the variant class whose `type` matches the given
+        # value, passing the remaining arguments to its constructor.
+        #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::BetaCacheMissReason} for more details.
+        #
+        # @param type [Symbol, Anthropic::Models::Beta::BetaCacheMissReason::Type, String]
+        #
+        # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+        #
+        #   @option args [Integer] :cache_missed_input_tokens Approximate number of input tokens that would have been read from cache had the
+        #
+        # @raise [ArgumentError]
+        # @return [Anthropic::Models::Beta::BetaCacheMissModelChanged, Anthropic::Models::Beta::BetaCacheMissSystemChanged, Anthropic::Models::Beta::BetaCacheMissToolsChanged, Anthropic::Models::Beta::BetaCacheMissMessagesChanged, Anthropic::Models::Beta::BetaCacheMissPreviousMessageNotFound, Anthropic::Models::Beta::BetaCacheMissUnavailable]
+        def self.new(type:, **args)
+          case type.to_sym
+          when :model_changed
+            Anthropic::Beta::BetaCacheMissModelChanged.new(**args)
+          when :system_changed
+            Anthropic::Beta::BetaCacheMissSystemChanged.new(**args)
+          when :tools_changed
+            Anthropic::Beta::BetaCacheMissToolsChanged.new(**args)
+          when :messages_changed
+            Anthropic::Beta::BetaCacheMissMessagesChanged.new(**args)
+          when :previous_message_not_found
+            Anthropic::Beta::BetaCacheMissPreviousMessageNotFound.new(**args)
+          when :unavailable
+            Anthropic::Beta::BetaCacheMissUnavailable.new(**args)
+          else
+            raise ArgumentError, "unknown type: #{type}"
+          end
+        end
+      end
+    end
+
+    BetaCacheMissReason = Beta::BetaCacheMissReason
+  end
+end

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

@@ -17,14 +17,9 @@ module Anthropic
         optional :networking, union: -> { Anthropic::Beta::BetaCloudConfigParams::Networking }, nil?: true
 
         # @!attribute packages
-        #   Specify packages (and optionally their versions) available in this environment.
-        #
-        #   When versioning, use the version semantics relevant for the package manager,
-        #   e.g. for `pip` use `package==1.0.0`. You are responsible for validating the
-        #   package and version exist. Unversioned installs the latest.
-        #
-        #   Under `limited` networking, requires `networking.allow_package_managers` to be
-        #   `true`.
+        #   Package manager configuration. Under `limited` networking, requires
+        #   `networking.allow_package_managers` to be `true`. Omit on update to preserve the
+        #   existing value.
         #
         #   @return [Anthropic::Models::Beta::BetaPackagesParams, nil]
         optional :packages, -> { Anthropic::Beta::BetaPackagesParams }, nil?: true
@@ -39,7 +34,7 @@ module Anthropic
         #
         #   @param networking [Anthropic::Models::Beta::BetaUnrestrictedNetwork, Anthropic::Models::Beta::BetaLimitedNetworkParams, nil] Network configuration policy. Omit on update to preserve the existing value.
         #
-        #   @param packages [Anthropic::Models::Beta::BetaPackagesParams, nil] Specify packages (and optionally their versions) available in this environment.
+        #   @param packages [Anthropic::Models::Beta::BetaPackagesParams, nil] Package manager configuration. Under `limited` networking, requires `networking.
         #
         #   @param type [Symbol, :cloud] Environment type
 

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

@@ -27,20 +27,93 @@ module Anthropic
         #   @return [String, nil]
         optional :signature, String, nil?: true
 
-        # @!method initialize(content:, encrypted_content:, signature: nil, type: :compaction)
+        # @!attribute tool_changes
+        #   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.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaResponseToolAdditionBlock, Anthropic::Models::Beta::BetaResponseToolRemovalBlock>, nil]
+        optional :tool_changes,
+                 -> {
+                   Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaCompactionBlock::ToolChange]
+                 },
+                 nil?: true
+
+        # @!method initialize(content:, encrypted_content:, signature: nil, tool_changes: nil, type: :compaction)
         #   A compaction block returned when autocompact is triggered.
         #
         #   When content is None, it indicates the compaction failed to produce a valid
         #   summary (e.g., malformed output from the model). Clients may round-trip
         #   compaction blocks with null content; the server treats them as no-ops.
         #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCompactionBlock} for more details.
+        #
         #   @param content [String, nil] Summary of compacted content, or null if compaction failed
         #
         #   @param encrypted_content [String, nil] Opaque metadata from prior compaction, to be round-tripped verbatim
         #
         #   @param signature [String, nil] Signature over the summary, to be sent back with the block verbatim
         #
+        #   @param tool_changes [Array<Anthropic::Models::Beta::BetaResponseToolAdditionBlock, Anthropic::Models::Beta::BetaResponseToolRemovalBlock>, nil] The tool changes of the compacted range: the `tool_addition` and `tool_removal`
+        #
         #   @param type [Symbol, :compaction]
+
+        module ToolChange
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # An entry of a `compaction` block's `tool_changes`: a tool the
+          # compacted range made available, as a reference to a `tools` entry or
+          # MCP toolset, or as the tool definition in effect at the end of the
+          # range, by value. Send it back unchanged.
+          variant :tool_addition, -> { Anthropic::Beta::BetaResponseToolAdditionBlock }
+
+          # An entry of a `compaction` block's `tool_changes`: a tool of the
+          # request's `tools` (or an MCP tool or toolset) that the compacted range
+          # withdrew. Send it back unchanged.
+          variant :tool_removal, -> { Anthropic::Beta::BetaResponseToolRemovalBlock }
+
+          module Type
+            extend Anthropic::Internal::Type::Enum
+
+            TOOL_ADDITION = :tool_addition
+            TOOL_REMOVAL = :tool_removal
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaResponseToolAdditionBlock, Anthropic::Models::Beta::BetaResponseToolRemovalBlock)]
+
+          # Creates a new instance of the variant class whose `type` matches the given
+          # value, passing the remaining arguments to its constructor.
+          #
+          # Some parameter documentations has been truncated, see
+          # {Anthropic::Models::Beta::BetaCompactionBlock::ToolChange} for more details.
+          #
+          # @param type [Symbol, Anthropic::Models::Beta::BetaCompactionBlock::ToolChange::Type, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Anthropic::Models::Beta::BetaResponseToolChangeToolReference, Anthropic::Models::Beta::BetaResponseToolChangeMCPToolReference, Anthropic::Models::Beta::BetaResponseToolChangeMCPToolsetReference, Anthropic::Models::Beta::BetaToolChangeToolDefinition, Anthropic::Models::Beta::BetaResponseToolChangeToolReference, Anthropic::Models::Beta::BetaResponseToolChangeMCPToolReference, Anthropic::Models::Beta::BetaResponseToolChangeMCPToolsetReference] :tool The tool made available: a reference to a `tools` entry or MCP toolset, or a `to
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaResponseToolAdditionBlock, Anthropic::Models::Beta::BetaResponseToolRemovalBlock]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :tool_addition
+              Anthropic::Beta::BetaResponseToolAdditionBlock.new(**args)
+            when :tool_removal
+              Anthropic::Beta::BetaResponseToolRemovalBlock.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
+        end
       end
     end
 

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

@@ -33,7 +33,20 @@ module Anthropic
         #   @return [String, nil]
         optional :signature, String, nil?: true
 
-        # @!method initialize(cache_control: nil, content: nil, encrypted_content: nil, signature: nil, type: :compaction)
+        # @!attribute tool_changes
+        #   The tool changes of the compacted range, as the server returned them on this
+        #   block: the `tool_addition` and `tool_removal` entries that take the request's
+        #   `tools` to the tool set in effect at the end of the range. Send them back
+        #   unchanged with the block.
+        #
+        #   @return [Array<Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock>, nil]
+        optional :tool_changes,
+                 -> {
+                   Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaCompactionBlockParam::ToolChange]
+                 },
+                 nil?: true
+
+        # @!method initialize(cache_control: nil, content: nil, encrypted_content: nil, signature: nil, tool_changes: nil, type: :compaction)
         #   A compaction block containing summary of previous context.
         #
         #   Users should round-trip these blocks from responses to subsequent requests to
@@ -42,6 +55,9 @@ module Anthropic
         #   When content is None, the block represents a failed compaction. The server
         #   treats these as no-ops. Empty string content is not allowed.
         #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCompactionBlockParam} for more details.
+        #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
         #
         #   @param content [String, nil] Summary of previously compacted content, or null if compaction failed
@@ -50,7 +66,70 @@ module Anthropic
         #
         #   @param signature [String, nil] The block's signature as returned, to be sent back verbatim
         #
+        #   @param tool_changes [Array<Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock>, nil] The tool changes of the compacted range, as the server returned them on this blo
+        #
         #   @param type [Symbol, :compaction]
+
+        module ToolChange
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # Mid-conversation directive to make a tool available.
+          #
+          # ``tool`` is a reference to a tool (or MCP toolset) declared in the
+          # request's ``tools``. Under the ``inline-tools-2026-09-15`` beta it may
+          # instead be a reference to a tool defined earlier in ``messages``, or a
+          # ``tool_definition`` object that carries an inline tool definition in
+          # ``definition`` (the same object a ``tools`` entry holds). An ``mcp_toolset``
+          # definition also requires the ``mcp-client-2026-09-15`` beta. The tool is
+          # offered to the model from this point in the conversation onward.
+          variant :tool_addition, -> { Anthropic::Beta::BetaRequestToolAdditionBlock }
+
+          # Mid-conversation directive to withdraw a tool.
+          #
+          # ``tool`` references a tool (or MCP toolset) by name: one declared in the
+          # request's ``tools`` or defined earlier in ``messages``. It is no longer
+          # offered to the model from this point in the conversation onward.
+          variant :tool_removal, -> { Anthropic::Beta::BetaRequestToolRemovalBlock }
+
+          module Type
+            extend Anthropic::Internal::Type::Enum
+
+            TOOL_ADDITION = :tool_addition
+            TOOL_REMOVAL = :tool_removal
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock)]
+
+          # Creates a new instance of the variant class whose `type` matches the given
+          # value, passing the remaining arguments to its constructor.
+          #
+          # @param type [Symbol, Anthropic::Models::Beta::BetaCompactionBlockParam::ToolChange::Type, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference, Anthropic::Models::Beta::BetaToolChangeToolDefinitionParam, Anthropic::Models::Beta::BetaToolChangeToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolReference, Anthropic::Models::Beta::BetaToolChangeMCPToolsetReference] :tool
+          #
+          #   @option args [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] :cache_control Create a cache control breakpoint at this content block.
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaRequestToolAdditionBlock, Anthropic::Models::Beta::BetaRequestToolRemovalBlock]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :tool_addition
+              Anthropic::Beta::BetaRequestToolAdditionBlock.new(**args)
+            when :tool_removal
+              Anthropic::Beta::BetaRequestToolRemovalBlock.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
+        end
       end
     end
 

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

@@ -16,11 +16,8 @@ module Anthropic
         optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
 
         # @!attribute configs
-        #   Per-member configuration for `computer_toolset_20260801`: one optional field per
-        #   member tool, keyed by the member name — the same name the member's `tool_use`
-        #   blocks carry. Every member is an accepted key, and a member's defaults apply
-        #   wherever its key is absent. Unknown keys are rejected: the field set is this
-        #   toolset version's complete member set.
+        #   Sparse per-member overrides, keyed by member name. Absent, null, and {} are
+        #   equivalent; a member's defaults apply wherever its key is absent.
         #
         #   @return [Anthropic::Models::Beta::BetaComputerToolsetConfigs, nil]
         optional :configs, -> { Anthropic::Beta::BetaComputerToolsetConfigs }, nil?: true
@@ -38,7 +35,7 @@ module Anthropic
         #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
         #
-        #   @param configs [Anthropic::Models::Beta::BetaComputerToolsetConfigs, nil] Per-member configuration for `computer_toolset_20260801`: one
+        #   @param configs [Anthropic::Models::Beta::BetaComputerToolsetConfigs, nil] Sparse per-member overrides, keyed by member name. Absent, null, and {} are equi
         #
         #   @param type [Symbol, :computer_toolset_20260801]
       end