anthropic 1.73.0 → 1.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0814f7989dfdce90cdc7535edcba2765bcbb40ed802424357334ff1087e860e
-  data.tar.gz: b3eef636f0f74f2d42c8d56c784461214c2575616afc4fbf5750f95affb325a0
+  metadata.gz: b42acaa5fbcc24fe2574af40d17c100634efb986cf30ee24a5a327f295f6b922
+  data.tar.gz: b456d0a9bf98c97af0788edd55b6fac69c5607f8df31ed178fedca5d7e76eeff
 SHA512:
-  metadata.gz: '0668735fb6de38f7ca8f71985eb642a7ec67b770317604c6a4bbfd5685a57aa6c4caf3c919b6571247c99ba51bdf6419ce59329b1e4ae6070ad271a8e7559fe4'
-  data.tar.gz: 237c52d786dbfe007938ad70ec8c54e888fad60bcab49c0f2eb48b4ad082252ddd2fbc76c65e7b777385efd0fe89775bf3c9f9e7dcc82ddc4847ceb1bf130930
+  metadata.gz: d998d3c2656dbe442adfb80bbb6c86d2b70e87112a9b06eb2dfa6588bdff72ac5f5a95fc7157f762ba06a5cb9bf13272f88c08a6ca435f1de9e71845626e0d60
+  data.tar.gz: fea464ecbbe55f09643d33a9d4ac92f2d8355dc7364c5fac63d30707ec99b6da7f48e8c9413e4bda296154205de9b674b84db8c993a88c62b0c4f76a6781be00

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## 1.74.0 (2026-09-28)
+
+Full Changelog: [v1.73.0...v1.74.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.73.0...v1.74.0)
+
+### Features
+
+* **api:** add between_tools thinking type ([9b24118](https://github.com/anthropics/anthropic-sdk-ruby/commit/9b24118fb51616ba540d461db518dac5daf12f4b))
+* **api:** add claude-sonnet-5-5 ([d4c258e](https://github.com/anthropics/anthropic-sdk-ruby/commit/d4c258e340ccb9b459f5de72c6dbbd0e0c4ad049))
+* **api:** add include_inherited and source to workspace rate limits ([fb110e9](https://github.com/anthropics/anthropic-sdk-ruby/commit/fb110e9a38e7f60e12079a7b88db302c3c767182))
+* **api:** add typed event type values to the Managed Agents events list filter ([38ead1d](https://github.com/anthropics/anthropic-sdk-ruby/commit/38ead1d22356559e0f16149f6208930f6f5342c8))
+* **api:** cache diagnostics GA — diagnostics on Message / MessageCreateParams ([0bee370](https://github.com/anthropics/anthropic-sdk-ruby/commit/0bee370f64c82f51dbd8ed3d4fc03bfa7c8ad9d1))
+
+
+### Bug Fixes
+
+* **client:** keep base URL path for `request` paths starting with `/` ([2e70130](https://github.com/anthropics/anthropic-sdk-ruby/commit/2e70130a8b68e250fbdd7574ada78581c8f48cd5))
+* **client:** send no placeholder filename for unnamed file uploads ([d870615](https://github.com/anthropics/anthropic-sdk-ruby/commit/d870615ecb13e85cb190a1982ceb92856b7b0726))
+* **helpers:** degrade between_tools thinking to disabled on fallback hops ([#276](https://github.com/anthropics/anthropic-sdk-ruby/issues/276)) ([00fa84e](https://github.com/anthropics/anthropic-sdk-ruby/commit/00fa84e4063124357e7e16cbb5242086ddf1f108))
+* **messages:** add the diagnostics parameter to sig and def ([#272](https://github.com/anthropics/anthropic-sdk-ruby/issues/272)) ([ec8e144](https://github.com/anthropics/anthropic-sdk-ruby/commit/ec8e144410c4e59114e1d6ad74edd436113ed7ef))
+
+
+### Chores
+
+* **api:** deprecate the betas param on GA models and completions methods ([d5426bc](https://github.com/anthropics/anthropic-sdk-ruby/commit/d5426bc99a1504957ae6f7c1b5703c88aa3c6c93))
+* **ci:** run CI on larger runners ([07801fb](https://github.com/anthropics/anthropic-sdk-ruby/commit/07801fbdf64e515bc502e41d953689cf714860dd))
+* **docs:** clarify that stream: true returns the raw event stream ([30fd670](https://github.com/anthropics/anthropic-sdk-ruby/commit/30fd670fb5d63fc98842e728b0694435b0ecc684))
+* **docs:** make Managed Agents actor descriptions resource-neutral ([b1d2865](https://github.com/anthropics/anthropic-sdk-ruby/commit/b1d2865d7acbaf7d26e0053740550213ae66377b))
+* **docs:** restore the research-preview notice on the Dream type ([7f1a792](https://github.com/anthropics/anthropic-sdk-ruby/commit/7f1a7924d4c43bb185892c5873f6f2335759ae32))
+* **tools:** remove client-side compaction control ([#271](https://github.com/anthropics/anthropic-sdk-ruby/issues/271)) ([bdfa3ad](https://github.com/anthropics/anthropic-sdk-ruby/commit/bdfa3ad52df49e4de76fc68d490870eea7464cc0))
+
+
+### Documentation
+
+* **api:** prefer each field's own description over its shared type's ([e5b841b](https://github.com/anthropics/anthropic-sdk-ruby/commit/e5b841bbd6bda136fa47c052cd943e9025515692))
+
 ## 1.73.0 (2026-09-22)
 
 Full Changelog: [v1.72.0...v1.73.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.72.0...v1.73.0)

data/README.md

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

data/lib/anthropic/helpers/refusal_fallback.rb

@@ -26,7 +26,8 @@ module Anthropic
   # against the original params (a set field overrides, an explicit `nil`
   # unsets, an absent field keeps the original value) — passing along the
   # refusal's `fallback_credit_token` — until a model accepts or the chain is
-  # exhausted. A message served by a
+  # exhausted. A `between_tools` thinking config is sent to a fallback as
+  # `disabled` unless the entry sets `thinking` itself. A message served by a
   # fallback carries a `fallback` content block prepended at each model
   # boundary; an exhausted chain surfaces the final refusal verbatim.
   #
@@ -39,7 +40,8 @@ module Anthropic
   # model boundary, monotonic block indices, and per-hop `usage.iterations` on
   # the final `message_delta`. Only `model` is honored from each entry on this
   # path: the credit token is redeemable only against the refused request's
-  # body, so the other per-entry overrides would be rejected.
+  # body, so the other per-entry overrides would be rejected. A
+  # `between_tools` thinking config is always sent as `disabled` on this path.
   #
   # Credit tokens are sent in the object form with `mode: :best_effort`, so a
   # failing redemption never rejects the retry — it proceeds at normal price
@@ -69,7 +71,8 @@ module Anthropic
     #   the non-streaming path the remaining keys (`max_tokens:`, `thinking:`,
     #   …) patch the original request body for that hop — a value overrides
     #   the param, an explicit `nil` unsets it, an absent key keeps the
-    #   original value.
+    #   original value (an absent `thinking:` sends `between_tools` as
+    #   `disabled`).
     # @param betas [Array<String>] betas added to the `anthropic-beta` header
     #   of every `/v1/messages` request this middleware handles. Defaults to
     #   `["fallback-credit-2026-07-01"]`; pass `[]` to send none.
@@ -133,7 +136,7 @@ module Anthropic
           # Only `model` is honored on the streaming path so the credit token
           # — redeemable only against the refused request's body — stays valid
           # for the spliced hops.
-          body.merge(model: @fallbacks.fetch(start_index).fetch(:model))
+          degrade_between_tools(body.merge(model: @fallbacks.fetch(start_index).fetch(:model)))
         else
           apply_fallback(body, @fallbacks.fetch(start_index))
         end
@@ -165,6 +168,7 @@ module Anthropic
     # @return [Hash{Symbol=>Object}]
     def apply_fallback(body, entry)
       patched = patch(body, entry)
+      patched = degrade_between_tools(patched) unless entry.key?(:thinking)
       override = entry[:output_config]
       return patched if override.nil?
 
@@ -172,6 +176,16 @@ module Anthropic
       merged.empty? ? patched.except(:output_config) : patched.merge(output_config: merged)
     end
 
+    # The fallback model may not accept `between_tools` thinking, so a hop that
+    # carries it sends `disabled` instead.
+    #
+    # @param body [Hash{Symbol=>Object}]
+    # @return [Hash{Symbol=>Object}]
+    def degrade_between_tools(body)
+      return body unless hash_of(body[:thinking])[:type].to_s == "between_tools"
+      body.merge(thinking: {type: :disabled})
+    end
+
     # @param base [Hash{Symbol=>Object}]
     # @param overrides [Hash{Symbol=>Object}] a value sets the key, an
     #   explicit `nil` deletes it, an absent key keeps `base`'s value
@@ -388,7 +402,7 @@ module Anthropic
         model = @fallbacks.fetch(hop).fetch(:model).to_s
         has_next = hop + 1 < @fallbacks.length
 
-        res_b, sent, failed = issue_hop(req, nxt, body, model, token, base, partial)
+        res_b, sent, failed = issue_hop(req, nxt, degrade_between_tools(body), model, token, base, partial)
 
         if failed
           next if has_next

data/lib/anthropic/helpers/tools/runner.rb

@@ -191,15 +191,10 @@ module Anthropic
             messages = current_messages
             brk, response = blk.call(params)
 
-            # Store the response for compaction check
             @last_response = response
 
-            # Check and perform compaction if needed
-            compacted = check_and_compact?
-
-            # Skip tool processing if we just compacted or if messages were modified
+            # Skip tool processing if messages were modified
             next unless current_messages.equal?(messages)
-            break if compacted
 
             next_step = determine_next_step_from_stop_reason(response.stop_reason)
 
@@ -571,101 +566,6 @@ module Anthropic
           end
         end
 
-        # Check token usage and compact messages if threshold exceeded
-        #
-        # @return [Boolean] true if compaction occurred, false otherwise
-        # @api private
-        private def check_and_compact?
-          return false unless @compaction_control&.[](:enabled)
-          return false unless @last_response
-
-          # Calculate total tokens used
-          usage = @last_response.usage
-          total_input_tokens = (
-            usage.input_tokens.to_i +
-            usage.cache_creation_input_tokens.to_i +
-            usage.cache_read_input_tokens.to_i
-          )
-          tokens_used = total_input_tokens + usage.output_tokens.to_i
-
-          # Check if we've exceeded the threshold
-          threshold = @compaction_control[:context_token_threshold] || DEFAULT_THRESHOLD
-          return false if tokens_used < threshold
-
-          # Warn once about compaction (only if no callback provided)
-          if @compaction_control[:on_compact].nil? && !@compaction_warned
-            warn(
-              "[anthropic-ruby] Context compaction triggered (#{tokens_used} tokens). " \
-              "Use compaction_control: { on_compact: ->(before, after) { ... } } for details."
-            )
-            @compaction_warned = true
-          end
-
-          # Prepare compaction request
-          model = @compaction_control[:model] || params[:model]
-          summary_prompt = @compaction_control[:summary_prompt] || DEFAULT_SUMMARY_PROMPT
-
-          # Prepare messages for compaction - handle tool_use blocks to avoid 400 errors
-          messages_for_compaction = current_messages.dup
-
-          # If last message is from assistant with tool_use blocks, we need to filter them out
-          # because tool_use blocks require corresponding tool_result blocks
-          if messages_for_compaction.last&.[](:role) == :assistant
-            last_msg = messages_for_compaction.last
-            content = last_msg[:content]
-
-            if content.is_a?(Array)
-              # Filter out tool_use blocks, keep text/thinking blocks
-              non_tool_blocks = content.reject do |block|
-                (block.is_a?(Hash) && block[:type] == :tool_use) ||
-                  block.is_a?(Anthropic::Beta::BetaToolUseBlock)
-              end
-
-              if non_tool_blocks.empty?
-                # If no content remains after filtering, remove the entire message
-                messages_for_compaction.pop
-              else
-                # Keep the message but with filtered content
-                last_msg[:content] = non_tool_blocks
-              end
-            end
-          end
-
-          messages = [
-            *messages_for_compaction,
-            {role: :user, content: summary_prompt}
-          ]
-
-          # Get summary from Claude
-          response = @client.beta.messages.create(
-            with_helper_header(
-              {model: model, messages: messages, max_tokens: params[:max_tokens]},
-              "compaction"
-            )
-          )
-
-          # Validate that compaction response is text
-          first_content = response.content.first
-          unless first_content.is_a?(Anthropic::Beta::BetaTextBlock)
-            raise "Compaction response content is not of type 'text', got: #{first_content.class}"
-          end
-
-          tokens_after = response.usage.output_tokens.to_i
-
-          # Invoke callback if provided
-          @compaction_control[:on_compact]&.call(tokens_used, tokens_after)
-
-          # Replace message history with just the summary
-          self.params = {
-            **params,
-            messages: [
-              {role: :user, content: response.content}
-            ]
-          }
-
-          true
-        end
-
         # @api private
         #
         # @param client [Anthropic::Client]
@@ -673,17 +573,13 @@ module Anthropic
         # @param params [Anthropic::Models::Beta::MessageCreateParams]
         #
         # @param max_iterations [Integer, nil]
-        #
-        # @param compaction_control [Hash, nil]
-        def initialize(client, params:, max_iterations: nil, compaction_control: nil)
+        def initialize(client, params:, max_iterations: nil)
           @client = client
           @params = params.to_h
           reject_compaction_param!(@params)
           @finished = false
           @max_iterations = max_iterations
           @iteration_count = 0
-          @compaction_control = compaction_control
-          @compaction_warned = false
           @last_response = nil
           @pending_tool_changes = []
           @tool_overrides = {}

data/lib/anthropic/internal/transport/base_client.rb

@@ -286,6 +286,9 @@ module Anthropic
           method, uninterpolated_path = req.fetch_values(:method, :path)
 
           path = Anthropic::Internal::Util.interpolate_path(uninterpolated_path)
+          # Only a path that starts with a scheme (`https:`) can change host. Other paths, `/x` and `//host/x` included,
+          # resolve under the base URL's path: `./` replaces their leading slashes so `/https://x` is not read as a URL.
+          path = path.sub(%r{\A/*}, "./") unless path.match?(/\A[a-z][a-z0-9+.-]*:/i)
 
           query = Anthropic::Internal::Util.deep_merge(req[:query].to_h, opts[:extra_query].to_h)
 

data/lib/anthropic/internal/type/file_input.rb

@@ -85,11 +85,10 @@ module Anthropic
             case value
             in StringIO | String
               # https://datatracker.ietf.org/doc/html/rfc7578#section-4.2
-              # while not required, a filename is recommended, and in practice many servers do expect this
-              Anthropic::FilePart.new(value, filename: "upload")
+              Anthropic::FilePart.new(value, filename: "")
             in IO
               state[:can_retry] = false
-              value.to_path.nil? ? Anthropic::FilePart.new(value, filename: "upload") : value
+              value.to_path.nil? ? Anthropic::FilePart.new(value, filename: "") : value
             in Anthropic::FilePart if value.content.is_a?(IO)
               state[:can_retry] = false
               value

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
@@ -105,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.
         #
@@ -179,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_update_params.rb

@@ -52,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
@@ -130,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.
         #
@@ -208,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/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_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

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

@@ -5,19 +5,19 @@ module Anthropic
     module Beta
       class BetaContextManagementCapability < Anthropic::Internal::Type::BaseModel
         # @!attribute clear_thinking_20251015
-        #   Indicates whether a capability is supported.
+        #   Whether the clear_thinking_20251015 strategy is supported.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :clear_thinking_20251015, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
 
         # @!attribute clear_tool_uses_20250919
-        #   Indicates whether a capability is supported.
+        #   Whether the clear_tool_uses_20250919 strategy is supported.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :clear_tool_uses_20250919, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
 
         # @!attribute compact_20260112
-        #   Indicates whether a capability is supported.
+        #   Whether the compact_20260112 strategy is supported.
         #
         #   @return [Anthropic::Models::Beta::BetaCapabilitySupport, nil]
         required :compact_20260112, -> { Anthropic::Beta::BetaCapabilitySupport }, nil?: true
@@ -31,11 +31,11 @@ module Anthropic
         # @!method initialize(clear_thinking_20251015:, clear_tool_uses_20250919:, compact_20260112:, supported:)
         #   Context management capability details.
         #
-        #   @param clear_thinking_20251015 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param clear_thinking_20251015 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the clear_thinking_20251015 strategy is supported.
         #
-        #   @param clear_tool_uses_20250919 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param clear_tool_uses_20250919 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the clear_tool_uses_20250919 strategy is supported.
         #
-        #   @param compact_20260112 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Indicates whether a capability is supported.
+        #   @param compact_20260112 [Anthropic::Models::Beta::BetaCapabilitySupport, nil] Whether the compact_20260112 strategy is supported.
         #
         #   @param supported [Boolean] Whether this capability is supported by the model.
       end