anthropic 1.61.0 → 1.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70039e0b3caf6cf562834b86cb64726a92d6b39b6c51bf25e076d901f1a336bf
-  data.tar.gz: 26532ca157534b56a16276bcc6a9b2dc85c4817bbf2cb83feb05269882be7d03
+  metadata.gz: 68e6d71ef0a8a1c6dba5ce56ca4c950073401b65fe3311ff8b305bb50f3e1895
+  data.tar.gz: ed43b20d2eb03cc4f7651213e403bb1eedd4ef682304524d82c535a9a04d680c
 SHA512:
-  metadata.gz: 0a061ad34ba81ad33b17e46e95c26d57c68660a2323c8f890541f12d13bf657a935ad0de3ceea801d31fb200f7a9f5d92b53f99d31d56cfb7904169bdba37e29
-  data.tar.gz: '08cccc073d696911273fc044c063e0cc9b65391e75f5893fed0593773667ec8449165f143c488c967a9c6507805561177a4354917c4f473ef8cd80f21d87d41a'
+  metadata.gz: 211153854d618da94e0d1c6cc4a7f8a28b4cbb6982df843301c293167115c12b4dcabea8ba618871150ba9cdebab08c4a6a17b0db164035ed907a54537713e16
+  data.tar.gz: 4df9827fe320d1f15bbdbcbfbcf2d77865506001d2b64314de497161700763fa86b500d9a114c7a8e1cb23d1a439aa0deef53e6ed16916da2e4d76ef7276fcff

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 1.62.0 (2026-08-13)
+
+Full Changelog: [v1.61.0...v1.62.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.61.0...v1.62.0)
+
+### Features
+
+* **api:** add output_behavior to dream creation (create a new memory store or update the input store in place) ([836125f](https://github.com/anthropics/anthropic-sdk-ruby/commit/836125f10cee42677d814fa7bb85f693914c6af9))
+
+
+### Bug Fixes
+
+* **bedrock:** adopt the default-credentials hook in place of the direct base-client bind ([#145](https://github.com/anthropics/anthropic-sdk-ruby/issues/145)) ([e082f28](https://github.com/anthropics/anthropic-sdk-ruby/commit/e082f280846cd00bda4f89b9fb6ad50b4a4a5feb))
+* **client:** accumulate streamed input for server tool use blocks ([#162](https://github.com/anthropics/anthropic-sdk-ruby/issues/162)) ([75382d8](https://github.com/anthropics/anthropic-sdk-ruby/commit/75382d81ebb6b3bedad92749f26e4625d8203097))
+* **client:** add models ([055b440](https://github.com/anthropics/anthropic-sdk-ruby/commit/055b440aa315cf644b08ede51a19f448fab00cbf))
+* **internal:** don't resolve lazy field types when hashing a model class ([#155](https://github.com/anthropics/anthropic-sdk-ruby/issues/155)) ([0a2c06f](https://github.com/anthropics/anthropic-sdk-ruby/commit/0a2c06fcbdb345d751ae0850cac70177cb232d53))
+* **streaming:** apply all message_delta fields when accumulating streamed messages ([#160](https://github.com/anthropics/anthropic-sdk-ruby/issues/160)) ([e537ae2](https://github.com/anthropics/anthropic-sdk-ruby/commit/e537ae23ac5c5701b47812e9062db9c3bd9f29da))
+* **vertex:** don't resolve the shared config store during client init ([#142](https://github.com/anthropics/anthropic-sdk-ruby/issues/142)) ([4108bd4](https://github.com/anthropics/anthropic-sdk-ruby/commit/4108bd4aa3fd3517b51971fdd25f15351bd8f5be))
+
+
+### Documentation
+
+* **api:** clarify that user profile name is optional for resold profiles ([e68fd57](https://github.com/anthropics/anthropic-sdk-ruby/commit/e68fd57357fed4964666d84d011b38873abff02d))
+* **client:** move truncated-docs note below the description in YARD doc blocks ([3db8b94](https://github.com/anthropics/anthropic-sdk-ruby/commit/3db8b9489cd2adb207edbb0165ea11fbacc19db4))
+* fix Symbol typo in RDoc comments ([#163](https://github.com/anthropics/anthropic-sdk-ruby/issues/163)) ([1102732](https://github.com/anthropics/anthropic-sdk-ruby/commit/1102732847ffc02eef9d2c69e233f5e6f56787d8))
+
 ## 1.61.0 (2026-08-07)
 
 Full Changelog: [v1.60.0...v1.61.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.60.0...v1.61.0)

data/README.md

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

data/lib/anthropic/client.rb

@@ -197,7 +197,7 @@ module Anthropic
 
       has_explicit_credential = api_key || auth_token || credentials || config
 
-      unless has_explicit_credential
+      if !has_explicit_credential && resolve_default_credentials?
         api_key = ENV["ANTHROPIC_API_KEY"]
         auth_token = ENV["ANTHROPIC_AUTH_TOKEN"]
       end
@@ -223,7 +223,7 @@ module Anthropic
         @credentials = credentials
       end
 
-      if @credentials.nil? && @api_key.nil? && @auth_token.nil?
+      if @credentials.nil? && @api_key.nil? && @auth_token.nil? && resolve_default_credentials?
         default_base_url = base_url || "https://api.anthropic.com"
         result = Anthropic::Credentials.default_credentials(base_url: default_base_url)
         if result
@@ -234,7 +234,7 @@ module Anthropic
       end
 
       warn_explicit_shadow(api_key: api_key, auth_token: auth_token, credentials: credentials || config)
-      warn_env_shadow(api_key: api_key, auth_token: auth_token)
+      warn_env_shadow(api_key: api_key, auth_token: auth_token) if resolve_default_credentials?
 
       if @credentials
         @token_cache = Anthropic::Credentials::TokenCache.new(@credentials)
@@ -295,6 +295,20 @@ module Anthropic
 
     private
 
+    # @api private
+    #
+    # Whether to resolve credentials from the default chain (the static
+    # +ANTHROPIC_API_KEY+ / +ANTHROPIC_AUTH_TOKEN+ env vars and the shared
+    # config store / federation auto-discovery, precedence steps 2–5 above)
+    # when no explicit credential argument is passed. Called once from
+    # {#initialize}, so overrides must not depend on subclass instance state.
+    # Subclasses that bring their own auth scheme override this to +false+ so
+    # ambient first-party credentials are never resolved or folded into
+    # requests bound for another platform's endpoint.
+    #
+    # @return [Boolean]
+    def resolve_default_credentials? = true
+
     def warn_explicit_shadow(api_key:, auth_token:, credentials:)
       return if credentials.nil?
 

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

@@ -60,7 +60,7 @@ module Anthropic
         #   the Bedrock URL rewrite and SigV4 signing happen inside the continuation, per
         #   attempt.
         #
-        def initialize( # rubocop:disable Lint/MissingSuper
+        def initialize(
           aws_region: nil,
           base_url: nil,
           max_retries: self.class::DEFAULT_MAX_RETRIES,
@@ -126,31 +126,44 @@ module Anthropic
             "https://bedrock-runtime.#{@aws_region}.amazonaws.com"
           )
 
-          @api_key = nil
-          @auth_token = @signer ? nil : api_key
-          @credentials = nil
-          @token_cache = nil
           # For AWSAuth#auth_headers: suppress key headers in SigV4 mode; in
           # API-key mode fall through to the base bearer-token handling.
           @use_sig_v4 = !@signer.nil?
           @use_bearer_auth = false
 
-          # Skip Anthropic::Client#initialize and bind BaseClient#initialize directly:
-          # the parent's initializer runs OIDC/credential-provider resolution that does
-          # not apply here.
-          Anthropic::Internal::Transport::BaseClient.instance_method(:initialize).bind(self).call(
+          # The Bedrock bearer rides the base client's `auth_token` slot;
+          # {#resolve_default_credentials?} keeps first-party credential
+          # auto-discovery out of the picture when it is absent.
+          super(
+            auth_token: @signer ? nil : api_key,
             base_url: base_url,
             timeout: timeout,
             max_retries: max_retries,
             initial_retry_delay: initial_retry_delay,
             max_retry_delay: max_retry_delay,
-            headers: {"anthropic-version" => "2023-06-01"},
             middleware: middleware
           )
+        end
+
+        # @api private
+        #
+        # Auth is SigV4 or the Bedrock bearer only — never resolve ambient
+        # first-party credentials, which would fold the shared config store's
+        # headers and bearer into requests bound for a third-party endpoint.
+        #
+        # @return [Boolean]
+        private def resolve_default_credentials? = false
 
-          @messages = Anthropic::Resources::Messages.new(client: self)
-          @completions = Anthropic::Resources::Completions.new(client: self)
-          @beta = Anthropic::Resources::Beta.new(client: self)
+        # The Models API is not available on Bedrock, so the resource the
+        # parent wires up would target routes the Bedrock host does not serve
+        # — keep it unavailable, matching the SDK's other Bedrock clients.
+        #
+        # @raise [NotImplementedError]
+        def models
+          # rubocop:disable Layout/LineLength
+          message = "Please instead use https://docs.anthropic.com/en/api/claude-on-amazon-bedrock#list-available-models to list available models on Bedrock."
+          # rubocop:enable Layout/LineLength
+          raise NotImplementedError.new(message)
         end
 
         # @api private

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

@@ -113,6 +113,16 @@ module Anthropic
                 "Models listing is not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
         end
 
+        # @api private
+        #
+        # Auth is SigV4 or the Bedrock bearer only (or skipped entirely) —
+        # never resolve ambient first-party credentials, which would fold the
+        # shared config store's headers and bearer into requests bound for a
+        # third-party endpoint.
+        #
+        # @return [Boolean]
+        private def resolve_default_credentials? = false
+
         # @api private
         #
         # @return [#call]

data/lib/anthropic/helpers/messages.rb

@@ -9,7 +9,7 @@ module Anthropic
         # Extract tool models from the request and convert them to JSON Schema
         # Returns a hash mapping tool name to Ruby model.
         #
-        # @param data [Hash{Sybmol=>Object}]
+        # @param data [Hash{Symbol=>Object}]
         #
         # @param strict [Boolean, nil]
         #
@@ -128,13 +128,13 @@ module Anthropic
 
         # @api private
         #
-        # @param raw [Hash{Sybmol=>Object}]
+        # @param raw [Hash{Symbol=>Object}]
         #
         # @param tools [Hash{String=>Class}]
         #
         # @param models [Hash{String=>Class}]
         #
-        # @return [Hash{Sybmol=>Object}]
+        # @return [Hash{Symbol=>Object}]
         def parse_input_schemas!(raw, tools:, models:)
           raw[:content]&.each do |content|
             case content

data/lib/anthropic/helpers/streaming/message_stream.rb

@@ -123,12 +123,14 @@ module Anthropic
             case (delta = event.delta)
             in Anthropic::Models::TextDelta | Anthropic::Models::BetaTextDelta if content.type == :text
               content.text += delta.text
-            in Anthropic::Models::InputJSONDelta | Anthropic::Models::BetaInputJSONDelta if content.type == :tool_use
-              json_buf = content._json_buf.to_s
+            in Anthropic::Models::InputJSONDelta | Anthropic::Models::BetaInputJSONDelta if tracks_tool_input?(content)
+              # `input` itself is the partial-JSON buffer mid-stream: it starts as the
+              # `{}` placeholder from content_block_start and holds the raw String once
+              # the first delta lands (server/MCP tool blocks have no `_json_buf`).
+              json_buf = content.input.is_a?(String) ? content.input : ""
               json_buf += delta.partial_json
 
               content.input = json_buf
-              content._json_buf = json_buf
             in Anthropic::Models::CitationsDelta | Anthropic::Models::BetaCitationsDelta if content.type == :text
               content.citations ||= []
               content.citations << delta.citation
@@ -147,7 +149,7 @@ module Anthropic
             # finished block must carry the decoded object, as in the non-streaming
             # message and the other SDKs' accumulators.
             case current_snapshot.content[event.index]
-            in {type: :tool_use, input: String => raw} => content
+            in {input: String => raw} => content if tracks_tool_input?(content)
               begin
                 content.input = decode_tool_use_input(raw)
               rescue JSON::ParserError
@@ -156,9 +158,15 @@ module Anthropic
             else
             end
           in Anthropic::Models::RawMessageDeltaEvent | Anthropic::Models::BetaRawMessageDeltaEvent
-            current_snapshot.stop_reason = event.delta.stop_reason
-            current_snapshot.stop_sequence = event.delta.stop_sequence
+            # message_start already seeds the null placeholders for these, and the
+            # generated setters cannot take a nil, so skip the ones the event omits.
+            current_snapshot.stop_reason = event.delta.stop_reason unless event.delta.stop_reason.nil?
+            current_snapshot.stop_sequence = event.delta.stop_sequence unless event.delta.stop_sequence.nil?
             current_snapshot.stop_details = event.delta.stop_details unless event.delta.stop_details.nil?
+
+            # Only reported once a container actually ran, and never on message_start.
+            current_snapshot.container = event.delta.container unless event.delta.container.nil?
+
             current_snapshot.usage.output_tokens = event.usage.output_tokens
 
             # The message_delta usage is authoritative for the final counts; carry every
@@ -176,6 +184,9 @@ module Anthropic
             unless event.usage.server_tool_use.nil?
               current_snapshot.usage.server_tool_use = event.usage.server_tool_use
             end
+            unless event.usage.output_tokens_details.nil?
+              current_snapshot.usage.output_tokens_details = event.usage.output_tokens_details
+            end
 
             if event.is_a?(Anthropic::Models::BetaRawMessageDeltaEvent)
               unless event.usage.iterations.nil?
@@ -184,6 +195,10 @@ module Anthropic
               unless event.usage.fallback_credit.nil?
                 current_snapshot.usage.fallback_credit = event.usage.fallback_credit
               end
+              # Applied context-management edits ride on the event, not on `delta`.
+              unless event.context_management.nil?
+                current_snapshot.context_management = event.context_management
+              end
             end
           else
           end
@@ -222,7 +237,7 @@ module Anthropic
                 text: delta.text,
                 snapshot: content_block.text
               )
-            in Anthropic::Models::InputJSONDelta | Anthropic::Models::BetaInputJSONDelta if content_block.type == :tool_use
+            in Anthropic::Models::InputJSONDelta | Anthropic::Models::BetaInputJSONDelta if tracks_tool_input?(content_block)
               events_to_yield << Anthropic::Streaming::InputJsonEvent.new(
                 type: :input_json,
                 partial_json: delta.partial_json,
@@ -269,7 +284,21 @@ module Anthropic
 
         # @api private
         #
-        # Decodes a tool_use block's buffered partial-JSON input. An empty buffer
+        # Content block types whose `input` streams in as input_json_delta events.
+        TOOL_INPUT_BLOCK_TYPES = [:tool_use, :server_tool_use, :mcp_tool_use].freeze
+
+        # @api private
+        #
+        # @param content_block [Object]
+        #
+        # @return [Boolean]
+        private def tracks_tool_input?(content_block)
+          TOOL_INPUT_BLOCK_TYPES.include?(content_block.type)
+        end
+
+        # @api private
+        #
+        # Decodes a tool-use block's buffered partial-JSON input. An empty buffer
         # means a no-argument tool call, which the wire encodes as an empty object.
         #
         # @param raw [String]

data/lib/anthropic/helpers/vertex/client.rb

@@ -116,6 +116,16 @@ module Anthropic
           @beta = Anthropic::Resources::Beta.new(client: self)
         end
 
+        # @api private
+        #
+        # Auth is Google OAuth (or a per-request token) only — never resolve
+        # ambient first-party credentials, which would fold the shared config
+        # store's headers and bearer into requests bound for a third-party
+        # endpoint.
+        #
+        # @return [Boolean]
+        private def resolve_default_credentials? = false
+
         # @api private
         #
         # @param req [Hash{Symbol=>Object}] .

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

@@ -210,8 +210,12 @@ module Anthropic
 
           # @api public
           #
+          # Must not resolve the lazy `type_fn`s: some runtimes (JRuby) call `Class#hash`
+          # from inside `Module#include`, before every referenced constant is loaded.
+          # Still consistent with `==`, since equal `fields` implies equal non-type entries.
+          #
           # @return [Integer]
-          def hash = fields.hash
+          def hash = known_fields.transform_values { |field| field.except(:type_fn) }.hash
         end
 
         # @api public

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

@@ -142,6 +142,43 @@ module Anthropic
 
           # @!method self.variants
           #   @return [Array(Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams)]
+
+          # 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::AgentCreateParams::Tool} for more details.
+          #
+          # @param type [Symbol, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolConfigParams>, 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 [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 [String] :name Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :agent_toolset_20260401
+              Anthropic::Beta::BetaManagedAgentsAgentToolset20260401Params.new(**args)
+            when :mcp_toolset
+              Anthropic::Beta::BetaManagedAgentsMCPToolsetParams.new(**args)
+            when :custom
+              Anthropic::Beta::BetaManagedAgentsCustomToolParams.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
         end
       end
     end

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

@@ -170,6 +170,43 @@ module Anthropic
 
           # @!method self.variants
           #   @return [Array(Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams)]
+
+          # 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::AgentUpdateParams::Tool} for more details.
+          #
+          # @param type [Symbol, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Array<Anthropic::Models::Beta::BetaManagedAgentsAgentToolConfigParams>, 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 [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 [String] :name Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaManagedAgentsAgentToolset20260401Params, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetParams, Anthropic::Models::Beta::BetaManagedAgentsCustomToolParams]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :agent_toolset_20260401
+              Anthropic::Beta::BetaManagedAgentsAgentToolset20260401Params.new(**args)
+            when :mcp_toolset
+              Anthropic::Beta::BetaManagedAgentsMCPToolsetParams.new(**args)
+            when :custom
+              Anthropic::Beta::BetaManagedAgentsCustomToolParams.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
         end
       end
     end

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

@@ -50,11 +50,11 @@ module Anthropic
         required :type, const: :advisor_message
 
         # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, model:, output_tokens:, type: :advisor_message)
+        #   Token usage for an advisor sub-inference iteration.
+        #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaAdvisorMessageIterationUsage} for more details.
         #
-        #   Token usage for an advisor sub-inference iteration.
-        #
         #   @param cache_creation [Anthropic::Models::Beta::BetaCacheCreation, nil] Breakdown of cached tokens by TTL
         #
         #   @param cache_creation_input_tokens [Integer] The number of input tokens used to create the cache entry.

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

@@ -36,6 +36,65 @@ module Anthropic
 
           # @!method self.variants
           #   @return [Array(Anthropic::Models::Beta::BetaCitationCharLocation, Anthropic::Models::Beta::BetaCitationPageLocation, Anthropic::Models::Beta::BetaCitationContentBlockLocation, Anthropic::Models::Beta::BetaCitationsWebSearchResultLocation, Anthropic::Models::Beta::BetaCitationSearchResultLocation)]
+
+          # 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::BetaCitationsDelta::Citation} for more details.
+          #
+          # @param type [Symbol, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [String] :cited_text The full text of the cited block range, concatenated.
+          #
+          #   @option args [Integer] :document_index
+          #
+          #   @option args [String, nil] :document_title
+          #
+          #   @option args [Integer] :end_char_index
+          #
+          #   @option args [String, nil] :file_id
+          #
+          #   @option args [Integer] :start_char_index
+          #
+          #   @option args [Integer] :end_page_number
+          #
+          #   @option args [Integer] :start_page_number
+          #
+          #   @option args [Integer] :end_block_index Exclusive 0-based end index of the cited block range in the source's `content` a
+          #
+          #   @option args [Integer] :start_block_index 0-based index of the first cited block in the source's `content` array.
+          #
+          #   @option args [String] :encrypted_index
+          #
+          #   @option args [String, nil] :title
+          #
+          #   @option args [String] :url
+          #
+          #   @option args [Integer] :search_result_index 0-based index of the cited search result among all `search_result` content block
+          #
+          #   @option args [String] :source
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaCitationCharLocation, Anthropic::Models::Beta::BetaCitationPageLocation, Anthropic::Models::Beta::BetaCitationContentBlockLocation, Anthropic::Models::Beta::BetaCitationsWebSearchResultLocation, Anthropic::Models::Beta::BetaCitationSearchResultLocation]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :char_location
+              Anthropic::Beta::BetaCitationCharLocation.new(**args)
+            when :page_location
+              Anthropic::Beta::BetaCitationPageLocation.new(**args)
+            when :content_block_location
+              Anthropic::Beta::BetaCitationContentBlockLocation.new(**args)
+            when :web_search_result_location
+              Anthropic::Beta::BetaCitationsWebSearchResultLocation.new(**args)
+            when :search_result_location
+              Anthropic::Beta::BetaCitationSearchResultLocation.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
         end
       end
     end

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

@@ -89,6 +89,28 @@ module Anthropic
 
           # @!method self.variants
           #   @return [Array(Anthropic::Models::Beta::BetaInputTokensTrigger, Anthropic::Models::Beta::BetaToolUsesTrigger)]
+
+          # Creates a new instance of the variant class whose `type` matches the given
+          # value, passing the remaining arguments to its constructor.
+          #
+          # @param type [Symbol, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Integer] :value
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaInputTokensTrigger, Anthropic::Models::Beta::BetaToolUsesTrigger]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :input_tokens
+              Anthropic::Beta::BetaInputTokensTrigger.new(**args)
+            when :tool_uses
+              Anthropic::Beta::BetaToolUsesTrigger.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
         end
       end
     end

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

@@ -47,6 +47,35 @@ module Anthropic
 
           # @!method self.variants
           #   @return [Array(Anthropic::Models::Beta::BetaUnrestrictedNetwork, Anthropic::Models::Beta::BetaLimitedNetwork)]
+
+          # 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::BetaCloudConfig::Networking} for more details.
+          #
+          # @param type [Symbol, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Boolean] :allow_mcp_servers Permits outbound access to MCP server endpoints configured on the agent, beyond
+          #
+          #   @option args [Boolean] :allow_package_managers Permits outbound access to public package registries (PyPI, npm, etc.) beyond th
+          #
+          #   @option args [Array<String>] :allowed_hosts Specifies domains the container can reach.
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaUnrestrictedNetwork, Anthropic::Models::Beta::BetaLimitedNetwork]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :unrestricted
+              Anthropic::Beta::BetaUnrestrictedNetwork.new(**args)
+            when :limited
+              Anthropic::Beta::BetaLimitedNetwork.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
         end
       end
     end

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

@@ -27,13 +27,13 @@ module Anthropic
         optional :packages, -> { Anthropic::Beta::BetaPackagesParams }, nil?: true
 
         # @!method initialize(networking: nil, packages: nil, type: :cloud)
-        #   Some parameter documentations has been truncated, see
-        #   {Anthropic::Models::Beta::BetaCloudConfigParams} for more details.
-        #
         #   Request params for `cloud` environment configuration.
         #
         #   Fields default to null; on update, omitted fields preserve the existing value.
         #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCloudConfigParams} for more details.
+        #
         #   @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.
@@ -59,6 +59,35 @@ module Anthropic
 
           # @!method self.variants
           #   @return [Array(Anthropic::Models::Beta::BetaUnrestrictedNetwork, Anthropic::Models::Beta::BetaLimitedNetworkParams)]
+
+          # 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::BetaCloudConfigParams::Networking} for more details.
+          #
+          # @param type [Symbol, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [Boolean, nil] :allow_mcp_servers Permits outbound access to MCP server endpoints configured on the agent, beyond
+          #
+          #   @option args [Boolean, nil] :allow_package_managers Permits outbound access to public package registries (PyPI, npm, etc.) beyond th
+          #
+          #   @option args [Array<String>, nil] :allowed_hosts Specifies domains the container can reach.
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::BetaUnrestrictedNetwork, Anthropic::Models::Beta::BetaLimitedNetworkParams]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :unrestricted
+              Anthropic::Beta::BetaUnrestrictedNetwork.new(**args)
+            when :limited
+              Anthropic::Beta::BetaLimitedNetworkParams.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
         end
       end
     end

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

@@ -43,12 +43,12 @@ module Anthropic
         optional :strict, Anthropic::Internal::Type::Boolean
 
         # @!method initialize(allowed_callers: nil, cache_control: nil, defer_loading: nil, strict: nil, name: :code_execution, type: :code_execution_20260120)
-        #   Some parameter documentations has been truncated, see
-        #   {Anthropic::Models::Beta::BetaCodeExecutionTool20260120} for more details.
-        #
         #   Code execution tool with REPL state persistence (daemon mode + gVisor
         #   checkpoint).
         #
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaCodeExecutionTool20260120} for more details.
+        #
         #   @param allowed_callers [Array<Symbol, Anthropic::Models::Beta::BetaCodeExecutionTool20260120::AllowedCaller>]
         #
         #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Create a cache control breakpoint at this content block.