anthropic 1.70.0 → 1.72.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7e5a1505bf8eef1998137107e2f22fa3c394d66377fb8bababb1faf8e12415b
-  data.tar.gz: 3726f292b1a782066ad8bb0491cab33fc95efc05cc71d6ae65416b7ee094380e
+  metadata.gz: 0e7aa200569945cdf76744a8c251b760350a75834328da86c44930b40f741b31
+  data.tar.gz: 780bb11d38658bb95e1142b1c389fc82e49ad04d20cdc4c01a9c4ed54b7038dd
 SHA512:
-  metadata.gz: 996dd2601dd00f563ec9d9c2a144bddf0a6db12d6fc46b25721d2dee76174897988186596bff300b55b913d151c6728719508a68b10ab07b9e5c1d70605d0d03
-  data.tar.gz: 291ce774ca8219d97b66c5bccdee1419b1251e9a5defa41255e94329b56a83b85808da5ed41366c71d0284efab235a37cac9743ab50e1ee56f0ba7e342ebf539
+  metadata.gz: 3de8eca81334145eaf72e0bfd8e142143ce8742e341db711085acac170f16132308f3c02fdaf424bdbc7e51d0832bc1de7a79e2abed18a2d80e57a92697c3b8c
+  data.tar.gz: 5994156c894b26d1cd0d504888f2cebc5409e4ff41bf81aa17f36f643e7de6c863ee831a34dc2ba49415f9fa531ab4456c33851d7655cb6461f36b7b39192074

data/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 1.72.0 (2026-09-18)
+
+Full Changelog: [v1.71.0...v1.72.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.71.0...v1.72.0)
+
+### Features
+
+* **api:** add group with display_name to rate limits, deprecate group_type ([8155b1d](https://github.com/anthropics/anthropic-sdk-ruby/commit/8155b1d0d17408a7ca0b04e774d5ff087d9aa438))
+* **ruby:** accept the discriminator enum in union .new signatures ([f31077a](https://github.com/anthropics/anthropic-sdk-ruby/commit/f31077a956e382b5453fbde900b8f03641bd8cbb))
+
+
+### Bug Fixes
+
+* **bedrock:** skip typeless chunks and raise on event-stream error frames ([#254](https://github.com/anthropics/anthropic-sdk-ruby/issues/254)) ([ae8f6e2](https://github.com/anthropics/anthropic-sdk-ruby/commit/ae8f6e2296396528ff52249f3049fffb3b176434))
+
+
+### Chores
+
+* **docs:** add descriptions for enum values and path parameters ([929b51e](https://github.com/anthropics/anthropic-sdk-ruby/commit/929b51ebe061ef833b593f03b912c08a021be7ca))
+* **docs:** clarify the compaction tool_changes and tool change descriptions ([4bc6c5f](https://github.com/anthropics/anthropic-sdk-ruby/commit/4bc6c5f7c0c8cf4a98277ee74ca04c9a46ef2864))
+* **internal:** update CLAUDE.md branch guidance ([#261](https://github.com/anthropics/anthropic-sdk-ruby/issues/261)) ([1931e53](https://github.com/anthropics/anthropic-sdk-ruby/commit/1931e537da142e3b6f33aa6ea2781c8f8659375c))
+
+## 1.71.0 (2026-09-15)
+
+Full Changelog: [v1.70.0...v1.71.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.70.0...v1.71.0)
+
+### Features
+
+* **api:** add auto mode tool permissions for Managed Agents ([8145b1f](https://github.com/anthropics/anthropic-sdk-ruby/commit/8145b1fce049b1fe98feefad2c41ccbd911ad892))
+* **api:** add compaction parameter and signed compaction blocks (beta) ([68baa7f](https://github.com/anthropics/anthropic-sdk-ruby/commit/68baa7f15aaad3e919adf9afbb4d94a421bf3d34))
+* **api:** add enum types for workspace data-residency geo fields ([389726b](https://github.com/anthropics/anthropic-sdk-ruby/commit/389726beec073e24a676456506e675f88912bd90))
+* **api:** add thinking_mismatch_allowed entries to input_transformations (beta) ([509b7ce](https://github.com/anthropics/anthropic-sdk-ruby/commit/509b7cebde87b9cf071d549a142789bcb2b11a85))
+* **api:** add url_sources to the web fetch tool ([0a787a2](https://github.com/anthropics/anthropic-sdk-ruby/commit/0a787a28e314f48c0de64d80ac66212997ec2a35))
+* **api:** add workspace_id parameter to user profiles methods ([f0ad83c](https://github.com/anthropics/anthropic-sdk-ruby/commit/f0ad83ccc3e07e1cd15d55509fe3d0162946eecf))
+* **client:** add a `proxy` client option ([9f39c26](https://github.com/anthropics/anthropic-sdk-ruby/commit/9f39c26cbac6bb52a3fe52f47dba522ff588a3ab))
+
+
+### Bug Fixes
+
+* **api:** mark usage iteration model as nullable ([167854a](https://github.com/anthropics/anthropic-sdk-ruby/commit/167854a6801249f8aa5f0d16512dcc531c68e9e5))
+* **api:** use one input transformation type for message and delta event ([7807c32](https://github.com/anthropics/anthropic-sdk-ruby/commit/7807c32042d64c130d81a9f879e30a8c744ea4fc))
+* **client:** ignore invalid Retry-After values and validate maxRetries ([8145b1f](https://github.com/anthropics/anthropic-sdk-ruby/commit/8145b1fce049b1fe98feefad2c41ccbd911ad892))
+* **client:** retry connection errors in the async client and stop blocking in the coroutine retry loop ([8145b1f](https://github.com/anthropics/anthropic-sdk-ruby/commit/8145b1fce049b1fe98feefad2c41ccbd911ad892))
+* **client:** stop union fields raising a conversion error after an earlier variant failed to match ([9f39c26](https://github.com/anthropics/anthropic-sdk-ruby/commit/9f39c26cbac6bb52a3fe52f47dba522ff588a3ab))
+* **client:** use exponential retry backoff and fall back to it for non-positive Retry-After values ([9f39c26](https://github.com/anthropics/anthropic-sdk-ruby/commit/9f39c26cbac6bb52a3fe52f47dba522ff588a3ab))
+* **client:** use the default backoff when Retry-After is out of range ([bdf00db](https://github.com/anthropics/anthropic-sdk-ruby/commit/bdf00db3626682338ff98c9fb3b2359faecd9460))
+* coerce union values to their most specific variant ([c8240de](https://github.com/anthropics/anthropic-sdk-ruby/commit/c8240de05c210c74a31c42ae0063c69fc465d08a))
+
+
+### Chores
+
+* **client:** decode proxy credentials without the cgi library ([9023815](https://github.com/anthropics/anthropic-sdk-ruby/commit/90238157521df7ba4c0aa460c3ed51fd4453a179))
+* **deps:** remove cgi dependency ([#233](https://github.com/anthropics/anthropic-sdk-ruby/issues/233)) ([02a81dd](https://github.com/anthropics/anthropic-sdk-ruby/commit/02a81dd6c7d93e3e3a00675b409fa95d258626b5))
+* **docs:** clarify that session_thread_id on tool use events is informational ([5356110](https://github.com/anthropics/anthropic-sdk-ruby/commit/53561106e4a21cd464a9441b719310d97a2ea6b0))
+* **docs:** correct the compaction beta's parameter descriptions ([edf62b3](https://github.com/anthropics/anthropic-sdk-ruby/commit/edf62b365844022b648310732ea3ac78c2b21aaf))
+* **internal:** reorder union variants in type listings ([9f39c26](https://github.com/anthropics/anthropic-sdk-ruby/commit/9f39c26cbac6bb52a3fe52f47dba522ff588a3ab))
+* **internal:** set the gem license from the generator config ([9f39c26](https://github.com/anthropics/anthropic-sdk-ruby/commit/9f39c26cbac6bb52a3fe52f47dba522ff588a3ab))
+* **tests:** stop the mock server without failing a passing test run ([46d47b0](https://github.com/anthropics/anthropic-sdk-ruby/commit/46d47b094d0467c2a534d633b66b8c9fd1121843))
+
+
+### Documentation
+
+* **api:** clarify usage.iterations entry typing under server-side fallback ([82136a5](https://github.com/anthropics/anthropic-sdk-ruby/commit/82136a54d292f0919b5f6713bbc3153b7b766a72))
+* **api:** fix typo in temperature deprecation message ([7605285](https://github.com/anthropics/anthropic-sdk-ruby/commit/76052855d56e41189c5bc5654aa96863d5ae5307))
+* stop documenting unions with their first variant's description ([a24a371](https://github.com/anthropics/anthropic-sdk-ruby/commit/a24a37104e5ac949ba1fdef8643e083f7c7d314e))
+
 ## 1.70.0 (2026-09-10)
 
 Full Changelog: [v1.69.0...v1.70.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.69.0...v1.70.0)

data/README.md

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

data/lib/anthropic/client.rb

@@ -173,6 +173,10 @@ module Anthropic
     #   +"https://api.example.com/v2/"+. Defaults to +ENV["ANTHROPIC_BASE_URL"]+,
     #   then to the profile's +base_url+ if present, then to +https://api.anthropic.com+.
     #
+    # @param proxy [String, URI::Generic, nil] HTTP proxy URL, e.g., `"http://user:pass@proxy.example.com:8080"`. When `nil`,
+    # `net/http` reads the `http_proxy`, `https_proxy`, and `no_proxy` environment
+    # variables.
+    #
     # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
     #
     # @param timeout [Float]
@@ -191,6 +195,7 @@ module Anthropic
       credentials: nil,
       config: nil,
       base_url: nil,
+      proxy: nil,
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
@@ -279,6 +284,7 @@ module Anthropic
 
       super(
         base_url: base_url,
+        proxy: proxy,
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,

data/lib/anthropic/helpers/bedrock/event_stream.rb

@@ -61,8 +61,10 @@ module Anthropic
           #
           # `:message-type: event` frames carry a JSON payload
           # `{"bytes": "<base64>"}` wrapping the Anthropic event; emit it as
-          # an `event:`/`data:` pair. `:message-type: exception` frames carry an
-          # error payload and a `:exception-type` header — re-emit as the same
+          # an `event:`/`data:` pair, skipping chunks with no `type`.
+          # `:message-type: exception` frames (error payload plus an
+          # `:exception-type` header) and `:message-type: error` frames
+          # (`:error-code`/`:error-message` headers) are re-emitted as the same
           # `event: error` / `data: {"type":"error",...}` SSE shape the API
           # would have sent, so the stream consumer's existing error path fires.
           #
@@ -74,13 +76,21 @@ module Anthropic
             in "event"
               payload = JSON.parse(msg.payload.read, symbolize_names: true)
               inner = Base64.decode64(payload.fetch(:bytes))
-              type = JSON.parse(inner, symbolize_names: true).fetch(:type)
-              y << "event: #{type}\ndata: #{inner}\n\n"
+              case JSON.parse(inner, symbolize_names: true)
+              in {type: String => type}
+                y << "event: #{type}\ndata: #{inner}\n\n"
+              else
+              end
             in "exception"
               exc_type = msg.headers[":exception-type"]&.value
               body = msg.payload.read
               data = JSON.generate(type: "error", error: {type: exc_type, message: body})
               y << "event: error\ndata: #{data}\n\n"
+            in "error"
+              code = msg.headers[":error-code"]&.value
+              message = msg.headers[":error-message"]&.value
+              data = JSON.generate(type: "error", error: {type: code, message: message})
+              y << "event: error\ndata: #{data}\n\n"
             else
               # Unknown message-type — drop. AWS may add prelude/metadata frames.
             end

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

@@ -191,6 +191,7 @@ module Anthropic
         # @api private
         #
         # @param base_url [String]
+        # @param proxy [String, URI::Generic, nil]
         # @param timeout [Float]
         # @param max_retries [Integer]
         # @param initial_retry_delay [Float]
@@ -201,6 +202,7 @@ module Anthropic
         # @param requester [Anthropic::Internal::Transport::PooledNetRequester, nil]
         def initialize(
           base_url:,
+          proxy: nil,
           timeout: 0.0,
           max_retries: 0,
           initial_retry_delay: 0.0,
@@ -211,7 +213,7 @@ module Anthropic
           requester: nil
         )
           @middleware = Array(middleware).freeze
-          @requester = requester || Anthropic::Internal::Transport::PooledNetRequester.new
+          @requester = requester || Anthropic::Internal::Transport::PooledNetRequester.new(proxy: proxy)
           @headers = Anthropic::Internal::Util.normalized_headers(
             self.class::PLATFORM_HEADERS,
             {
@@ -365,21 +367,23 @@ module Anthropic
         private def retry_delay(headers, retry_count:)
           # Non-standard extension
           span = Float(headers["retry-after-ms"], exception: false)&.then { _1 / 1000 }
-          return span if span
 
           retry_header = headers["retry-after"]
-          return span if (span = Float(retry_header, exception: false))
-
-          span = retry_header&.then do
+          span ||= Float(retry_header, exception: false)
+          span ||= retry_header&.then do
             Time.httpdate(_1) - Time.now
           rescue ArgumentError
             nil
           end
-          return span if span
 
-          scale = retry_count**2
+          # If the API asks us to wait a certain amount of time, do what it says, however long.
+          # A non-positive value, e.g. an HTTP-date in the past, falls back to the computed backoff rather than reaching `sleep`.
+          return span if span&.positive?
+
+          # Exponential backoff capped at `max_retry_delay`, minus up to 25% jitter.
+          scale = 2**retry_count
           jitter = 1 - (0.25 * rand)
-          (@initial_retry_delay * scale * jitter).clamp(0, @max_retry_delay)
+          (@initial_retry_delay * scale).clamp(0, @max_retry_delay) * jitter
         end
 
         # @api private

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

@@ -18,9 +18,10 @@ module Anthropic
           #
           # @param cert_store [OpenSSL::X509::Store]
           # @param url [URI::Generic]
+          # @param proxy [URI::Generic, nil]
           #
           # @return [Net::HTTP]
-          def connect(cert_store:, url:)
+          def connect(cert_store:, url:, proxy: nil)
             port =
               case [url.port, url.scheme]
               in [Integer, _]
@@ -31,7 +32,23 @@ module Anthropic
                 Net::HTTP.https_default_port
               end
 
-            Net::HTTP.new(url.host, port).tap do
+            conn =
+              if proxy.nil?
+                # `net/http` falls back to the `http_proxy`/`https_proxy`/`no_proxy` environment variables.
+                Net::HTTP.new(url.host, port)
+              else
+                # `https://` targets are tunnelled through the proxy with CONNECT by `net/http` itself.
+                Net::HTTP.new(
+                  url.host,
+                  port,
+                  proxy.hostname,
+                  proxy.port,
+                  proxy.user&.then { URI.decode_uri_component(_1) },
+                  proxy.password&.then { URI.decode_uri_component(_1) }
+                )
+              end
+
+            conn.tap do
               _1.use_ssl = %w[https wss].include?(url.scheme)
               _1.max_retries = 0
 
@@ -39,6 +56,37 @@ module Anthropic
             end
           end
 
+          # @api private
+          #
+          # @param proxy [String, URI::Generic, nil]
+          #
+          # @raise [ArgumentError]
+          # @return [URI::Generic, nil]
+          def parse_proxy(proxy)
+            return nil if proxy.nil?
+
+            parsed =
+              case proxy
+              in URI::Generic
+                proxy
+              in String
+                begin
+                  URI(proxy)
+                rescue URI::InvalidURIError
+                  nil
+                end
+              else
+                nil
+              end
+
+            # The offending value is deliberately left out of the message since proxy URLs often embed credentials.
+            if parsed.nil? || parsed.scheme&.downcase != "http" || parsed.host.to_s.empty?
+              raise ArgumentError.new("Expected proxy to be an http:// URL with a host, for example http://proxy.example.com:8080")
+            end
+
+            parsed
+          end
+
           # @api private
           #
           # @param conn [Net::HTTP]
@@ -105,7 +153,7 @@ module Anthropic
           pool =
             @mutex.synchronize do
               @pools[origin] ||= ConnectionPool.new(size: @size) do
-                self.class.connect(cert_store: @cert_store, url: url)
+                self.class.connect(cert_store: @cert_store, url: url, proxy: @proxy)
               end
             end
 
@@ -194,13 +242,24 @@ module Anthropic
         # @api private
         #
         # @param size [Integer]
-        def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS)
+        # @param proxy [String, URI::Generic, nil]
+        def initialize(size: self.class::DEFAULT_MAX_CONNECTIONS, proxy: nil)
           @mutex = Mutex.new
           @size = size
+          @proxy = self.class.parse_proxy(proxy)
           @cert_store = OpenSSL::X509::Store.new.tap(&:set_default_paths)
           @pools = {}
         end
 
+        # @api private
+        #
+        # @return [String]
+        def inspect
+          # Proxy URLs often embed credentials, so never surface the password.
+          proxy = @proxy&.then { _1.password.nil? ? _1 : _1.dup.tap { |uri| uri.password = "REDACTED" } }
+          "#<#{self.class.name}:0x#{object_id.to_s(16)} size=#{@size} proxy=#{proxy.inspect}>"
+        end
+
         define_sorbet_constant!(:Request) do
           T.type_alias { {method: Symbol, url: URI::Generic, headers: T::Hash[String, String], body: T.anything, deadline: Float} }
         end

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

@@ -171,12 +171,15 @@ module Anthropic
           end
 
           exactness = state.fetch(:exactness)
+          error = state[:error]
 
           alternatives = []
           known_variants.each do |_, variant_fn|
             target = variant_fn.call
             exact = state[:exactness] = {yes: 0, no: 0, maybe: 0}
             state[:branched] += 1
+            # a variant that was tried and passed over must not leave its error behind
+            state[:error] = error
 
             coerced = Anthropic::Internal::Type::Converter.coerce(target, value, state: state)
             yes, no, maybe = exact.values
@@ -185,7 +188,7 @@ module Anthropic
               state[:exactness] = exactness
               return coerced
             elsif maybe.positive?
-              alternatives << [[-yes, -maybe, no], exact, coerced]
+              alternatives << [[-yes, -maybe, no], exact, coerced, state[:error]]
             end
           end
 
@@ -194,8 +197,9 @@ module Anthropic
             exactness[:no] += 1
             state[:error] = ArgumentError.new("no matching variant for #{value.inspect}")
             value
-          in [[_, exact, coerced], *]
+          in [[_, exact, coerced, error], *]
             exact.each { exactness[_1] += _2 }
+            state[:error] = error
             coerced
           end
             .tap { state[:exactness] = exactness }

data/lib/anthropic/internal/util.rb

@@ -318,7 +318,9 @@ module Anthropic
         #
         # @return [Hash{String=>Array<String>}]
         def decode_query(query)
-          CGI.parse(query.to_s)
+          URI.decode_www_form(query.to_s).each_with_object({}) do |(key, value), out|
+            (out[key] ||= []) << value
+          end
         end
 
         # @api private

data/lib/anthropic/models/anthropic_beta.rb

@@ -5,8 +5,6 @@ module Anthropic
     module AnthropicBeta
       extend Anthropic::Internal::Type::Union
 
-      variant String
-
       variant const: -> { Anthropic::Models::AnthropicBeta::MESSAGE_BATCHES_2024_09_24 }
 
       variant const: -> { Anthropic::Models::AnthropicBeta::PROMPT_CACHING_2024_07_31 }
@@ -97,11 +95,15 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::COMPACT_2026_09_04 }
+
+      variant String
+
       # @!method self.variants
-      #   @return [Array(String, Symbol)]
+      #   @return [Array(Symbol, String)]
 
       define_sorbet_constant!(:Variants) do
-        T.type_alias { T.any(String, Anthropic::AnthropicBeta::TaggedSymbol) }
+        T.type_alias { T.any(Anthropic::AnthropicBeta::TaggedSymbol, String) }
       end
 
       # @!group
@@ -151,6 +153,7 @@ module Anthropic
       MID_CONVERSATION_OUTPUT_CONFIG_2026_07_01 = :"mid-conversation-output-config-2026-07-01"
       THINKING_BINDING_CONTROLS_2026_08_01 = :"thinking-binding-controls-2026-08-01"
       MID_CONVERSATION_SYSTEM_CLEAR_AT_2026_08_21 = :"mid-conversation-system-clear-at-2026-08-21"
+      COMPACT_2026_09_04 = :"compact-2026-09-04"
 
       # @!endgroup
     end

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

@@ -16,7 +16,7 @@ module Anthropic
         # @!attribute betas
         #   Optional header to specify the beta version(s) you want to use.
         #
-        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        #   @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
@@ -27,7 +27,7 @@ module Anthropic
         # @!method initialize(agent_id:, betas: nil, workspace_id: nil, request_options: {})
         #   @param agent_id [String]
         #
-        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
         #   @param workspace_id [String]
         #

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

@@ -14,7 +14,7 @@ module Anthropic
         #   e.g. `claude-opus-5`, or a `model_config` object for additional configuration
         #   control
         #
-        #   @return [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams]
+        #   @return [Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel]
         required :model, union: -> { Anthropic::Beta::AgentCreateParams::Model }
 
         # @!attribute name
@@ -77,7 +77,7 @@ module Anthropic
         # @!attribute betas
         #   Optional header to specify the beta version(s) you want to use.
         #
-        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        #   @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
@@ -89,7 +89,7 @@ module Anthropic
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::AgentCreateParams} for more details.
         #
-        #   @param model [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams] Model identifier. Accepts the [model string](https://platform.claude.com/docs/en
+        #   @param model [Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] Model identifier. Accepts the [model string](https://platform.claude.com/docs/en
         #
         #   @param name [String] Human-readable name for the agent.
         #
@@ -107,7 +107,7 @@ module Anthropic
         #
         #   @param tools [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams>] Tool configurations available to the agent. Maximum of 128 tools across all tool
         #
-        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
         #   @param workspace_id [String]
         #
@@ -120,16 +120,16 @@ module Anthropic
         module Model
           extend Anthropic::Internal::Type::Union
 
+          # An object that defines additional configuration control over model use
+          variant -> { Anthropic::Beta::BetaManagedAgentsModelConfigParams }
+
           # The model that will power your agent.
           #
           # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
           variant union: -> { Anthropic::Beta::BetaManagedAgentsModel }
 
-          # An object that defines additional configuration control over model use
-          variant -> { Anthropic::Beta::BetaManagedAgentsModelConfigParams }
-
           # @!method self.variants
-          #   @return [Array(Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams)]
+          #   @return [Array(Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel)]
         end
 
         # Union type for tool configurations in the tools array.
@@ -167,7 +167,7 @@ module Anthropic
           # Some parameter documentations has been truncated, see
           # {Anthropic::Models::Beta::AgentCreateParams::Tool} for more details.
           #
-          # @param type [Symbol, String]
+          # @param type [Symbol, Anthropic::Models::Beta::AgentCreateParams::Tool::Type, String]
           #
           # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
           #

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

@@ -41,7 +41,7 @@ module Anthropic
         # @!attribute betas
         #   Optional header to specify the beta version(s) you want to use.
         #
-        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        #   @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
@@ -60,7 +60,7 @@ module Anthropic
         #
         #   @param page [String] Opaque pagination cursor from a previous response.
         #
-        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
         #   @param workspace_id [String]
         #

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

@@ -23,7 +23,7 @@ module Anthropic
         # @!attribute betas
         #   Optional header to specify the beta version(s) you want to use.
         #
-        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        #   @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
@@ -39,7 +39,7 @@ module Anthropic
         #
         #   @param version [Integer] Agent version. Omit for the most recent version. Must be at least 1 if specified
         #
-        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
         #   @param workspace_id [String]
         #

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

@@ -47,7 +47,7 @@ module Anthropic
         #   e.g. `claude-opus-5`, or a `model_config` object for additional configuration
         #   control. Omit to preserve. Cannot be cleared.
         #
-        #   @return [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, nil]
+        #   @return [Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, nil]
         optional :model, union: -> { Anthropic::Beta::AgentUpdateParams::Model }
 
         # @!attribute multiagent
@@ -101,7 +101,7 @@ module Anthropic
         # @!attribute betas
         #   Optional header to specify the beta version(s) you want to use.
         #
-        #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+        #   @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
         # @!attribute workspace_id
@@ -121,7 +121,7 @@ module Anthropic
         #
         #   @param metadata [Hash{Symbol=>String, nil}, nil] Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omi
         #
-        #   @param model [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams] Model identifier. Accepts the [model string](https://platform.claude.com/docs/en
+        #   @param 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
         #
@@ -135,7 +135,7 @@ module Anthropic
         #
         #   @param version [Integer] The agent's current version, used to prevent concurrent overwrites. Obtain this
         #
-        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
         #
         #   @param workspace_id [String]
         #
@@ -148,16 +148,16 @@ module Anthropic
         module Model
           extend Anthropic::Internal::Type::Union
 
+          # An object that defines additional configuration control over model use
+          variant -> { Anthropic::Beta::BetaManagedAgentsModelConfigParams }
+
           # The model that will power your agent.
           #
           # See [models](https://docs.anthropic.com/en/docs/models-overview) for additional details and options.
           variant union: -> { Anthropic::Beta::BetaManagedAgentsModel }
 
-          # An object that defines additional configuration control over model use
-          variant -> { Anthropic::Beta::BetaManagedAgentsModelConfigParams }
-
           # @!method self.variants
-          #   @return [Array(Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams)]
+          #   @return [Array(Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams, Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel)]
         end
 
         # Union type for tool configurations in the tools array.
@@ -195,7 +195,7 @@ module Anthropic
           # Some parameter documentations has been truncated, see
           # {Anthropic::Models::Beta::AgentUpdateParams::Tool} for more details.
           #
-          # @param type [Symbol, String]
+          # @param type [Symbol, Anthropic::Models::Beta::AgentUpdateParams::Tool::Type, String]
           #
           # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
           #

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

@@ -29,7 +29,7 @@ module Anthropic
           # @!attribute betas
           #   Optional header to specify the beta version(s) you want to use.
           #
-          #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
+          #   @return [Array<Symbol, String, Anthropic::Models::AnthropicBeta>, nil]
           optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
           # @!attribute workspace_id
@@ -44,7 +44,7 @@ module Anthropic
           #
           #   @param page [String] Opaque pagination cursor.
           #
-          #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+          #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
           #
           #   @param workspace_id [String]
           #

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

@@ -3,12 +3,6 @@
 module Anthropic
   module Models
     module Beta
-      # A tab this call's execution opened that remains open at its end — the creation
-      # delta of the `tabs` inventory, not an event log.
-      #
-      # Carries only the `tab_id`; the tab's `title` and `url` live on its `tabs` entry,
-      # which must include the same `tab_id`. A tab opened during a failed call gets no
-      # deferred `tab_opened`; it simply appears in the next result's `tabs` inventory.
       module BetaBrowserStateChange
         extend Anthropic::Internal::Type::Union
 
@@ -56,7 +50,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::BetaBrowserStateChange} for more details.
         #
-        # @param type [Symbol, String]
+        # @param type [Symbol, Anthropic::Models::Beta::BetaBrowserStateChange::Type, String]
         #
         # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
         #

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

@@ -56,7 +56,7 @@ module Anthropic
           # Some parameter documentations has been truncated, see
           # {Anthropic::Models::Beta::BetaCitationsDelta::Citation} for more details.
           #
-          # @param type [Symbol, String]
+          # @param type [Symbol, Anthropic::Models::Beta::BetaCitationsDelta::Citation::Type, String]
           #
           # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
           #