anthropic 1.69.0 → 1.71.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6bc25b1250c271c4d1f381c25b895565e0cd46ceddca6441b3189a472952d7d3
-  data.tar.gz: '0179d0c331dce3c2334dad1847a30231c40ab7e59555b1f9f4f6886a341b5b36'
+  metadata.gz: 6ab8d0a99df492276cdb94f8f3c392a571e30e73231906566c6d959088bf3aa4
+  data.tar.gz: 834e8acc9a1e059f0209904e7ba60ddfcc0ed67e1be8c60fcf7614656b3c24ce
 SHA512:
-  metadata.gz: d5b4dc0a8bffc5796704c5eb41825359e9d786d12f8400a16ad6febeab3b335b70574db6110e0c137ed4e38fff7eb69eafc8cb87214860f3e862b710d8d336ee
-  data.tar.gz: 6e77ca54945db63c6812a0eaf5a833ce4e37799644c54c1063be93c14ed5e39c17619ddd7e1e21d195cdaf3e1ee7242a79852b7064ced67e60d4f615ff49b01e
+  metadata.gz: 27e026c0567165a897bf257fcc9d7081b99ad1e29ce0f37fb3916688ff11f311fbc0ff081ccdef87d0a03ca793fff379a1a445aa3d206d65369dedb49f0cfcad
+  data.tar.gz: dece25375e30a2d43c8bab81bb3fcaf4cf6ed5cceda10b0aa77ac428b21a2476149e989ddcb8165e3a9695207de69d3a69bf2af23a173eef36157c5ae70a5016

data/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 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)
+
+### Features
+
+* **api:** add auto mode tool permissions for Managed Agents ([701e04e](https://github.com/anthropics/anthropic-sdk-ruby/commit/701e04e901f83c69c16adb2e8a01a6131fa3cbae))
+* **api:** add content_too_large web_fetch tool error code ([549aa74](https://github.com/anthropics/anthropic-sdk-ruby/commit/549aa748e91d951a73fadd9df5292ed6552538b8))
+* **api:** add the user-profiles-2026-09-04 beta value and external_user_details to user profiles ([2fe372b](https://github.com/anthropics/anthropic-sdk-ruby/commit/2fe372b7c6595a1ab05729c03fb702aaa745285e))
+* **api:** support mounting public GitHub repositories without an authorization_token in Managed Agents sessions ([b139c7f](https://github.com/anthropics/anthropic-sdk-ruby/commit/b139c7fd4483c76fd6d4abcee38f8bdc6b840923))
+
+
+### Chores
+
+* **client:** clean up the unused idempotency request option ([ba199a6](https://github.com/anthropics/anthropic-sdk-ruby/commit/ba199a6ff19ef8accb0abccc021eca12a65ebb30))
+* **client:** keep the idempotency_key request option as a deprecated no-op ([#240](https://github.com/anthropics/anthropic-sdk-ruby/issues/240)) ([3d4ef46](https://github.com/anthropics/anthropic-sdk-ruby/commit/3d4ef46e2ce17cb5f56a522f928ccae526fce341))
+* **docs:** correct the environment scope field description ([26d3ca3](https://github.com/anthropics/anthropic-sdk-ruby/commit/26d3ca3d191d2beba46571c3eb979016b257ee6e))
+* **internal:** restore package version ([485111e](https://github.com/anthropics/anthropic-sdk-ruby/commit/485111e6bb59301dd53f7cfd55ec2d3c0add6509))
+* **internal:** run rubocop without per-CPU workers when formatting ([4ab6095](https://github.com/anthropics/anthropic-sdk-ruby/commit/4ab6095c81f5d1e53da4cbe799295fd094c4cdc2))
+* **internal:** stop stamping the package version into generated files ([d485203](https://github.com/anthropics/anthropic-sdk-ruby/commit/d4852032656ee4f3cf623274bbd55fe8b3b95514))
+
 ## 1.69.0 (2026-09-04)
 
 Full Changelog: [v1.68.0...v1.69.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.68.0...v1.69.0)

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.69.0"
+gem "anthropic", "~> 1.71.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/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,
             {
@@ -269,8 +271,6 @@ module Anthropic
         #
         # @param opts [Hash{Symbol=>Object}] .
         #
-        #   @option opts [String, nil] :idempotency_key
-        #
         #   @option opts [Hash{String=>Array<String>, String, nil}, nil] :extra_query
         #
         #   @option opts [Hash{String=>String, nil}, nil] :extra_headers
@@ -367,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
@@ -660,8 +662,6 @@ module Anthropic
         #
         # @param options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil] .
         #
-        #   @option options [String, nil] :idempotency_key
-        #
         #   @option options [Hash{String=>Array<String>, String, nil}, nil] :extra_query
         #
         #   @option options [Hash{String=>String, nil}, nil] :extra_headers

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 }
@@ -53,6 +51,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::USER_PROFILES_2026_08_18 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::USER_PROFILES_2026_09_04 }
+
       variant const: -> { Anthropic::Models::AnthropicBeta::ADVISOR_TOOL_2026_03_01 }
 
       variant const: -> { Anthropic::Models::AnthropicBeta::MANAGED_AGENTS_2026_04_01 }
@@ -95,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
@@ -127,6 +131,7 @@ module Anthropic
       OUTPUT_300K_2026_03_24 = :"output-300k-2026-03-24"
       USER_PROFILES_2026_03_24 = :"user-profiles-2026-03-24"
       USER_PROFILES_2026_08_18 = :"user-profiles-2026-08-18"
+      USER_PROFILES_2026_09_04 = :"user-profiles-2026-09-04"
       ADVISOR_TOOL_2026_03_01 = :"advisor-tool-2026-03-01"
       MANAGED_AGENTS_2026_04_01 = :"managed-agents-2026-04-01"
       CACHE_DIAGNOSIS_2026_04_07 = :"cache-diagnosis-2026-04-07"
@@ -148,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.

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.

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
 

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

@@ -5,7 +5,6 @@ module Anthropic
     module Beta
       class BetaCodeExecutionToolResultBlock < Anthropic::Internal::Type::BaseModel
         # @!attribute content
-        #   Code execution result with encrypted stdout for PFC + web_search results.
         #
         #   @return [Anthropic::Models::Beta::BetaCodeExecutionToolResultError, Anthropic::Models::Beta::BetaCodeExecutionResultBlock, Anthropic::Models::Beta::BetaEncryptedCodeExecutionResultBlock]
         required :content, union: -> { Anthropic::Beta::BetaCodeExecutionToolResultBlockContent }
@@ -21,10 +20,8 @@ module Anthropic
         required :type, const: :code_execution_tool_result
 
         # @!method initialize(content:, tool_use_id:, type: :code_execution_tool_result)
-        #   @param content [Anthropic::Models::Beta::BetaCodeExecutionToolResultError, Anthropic::Models::Beta::BetaCodeExecutionResultBlock, Anthropic::Models::Beta::BetaEncryptedCodeExecutionResultBlock] Code execution result with encrypted stdout for PFC + web_search results.
-        #
+        #   @param content [Anthropic::Models::Beta::BetaCodeExecutionToolResultError, Anthropic::Models::Beta::BetaCodeExecutionResultBlock, Anthropic::Models::Beta::BetaEncryptedCodeExecutionResultBlock]
         #   @param tool_use_id [String]
-        #
         #   @param type [Symbol, :code_execution_tool_result]
       end
     end

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

@@ -3,7 +3,6 @@
 module Anthropic
   module Models
     module Beta
-      # Code execution result with encrypted stdout for PFC + web_search results.
       module BetaCodeExecutionToolResultBlockContent
         extend Anthropic::Internal::Type::Union