anthropic 1.68.0 → 1.76.0

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
@@ -286,6 +286,9 @@ module Anthropic
           method, uninterpolated_path = req.fetch_values(:method, :path)
 
           path = Anthropic::Internal::Util.interpolate_path(uninterpolated_path)
+          # Only a path that starts with a scheme (`https:`) can change host. Other paths, `/x` and `//host/x` included,
+          # resolve under the base URL's path: `./` replaces their leading slashes so `/https://x` is not read as a URL.
+          path = path.sub(%r{\A/*}, "./") unless path.match?(/\A[a-z][a-z0-9+.-]*:/i)
 
           query = Anthropic::Internal::Util.deep_merge(req[:query].to_h, opts[:extra_query].to_h)
 
@@ -367,21 +370,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
@@ -598,6 +603,7 @@ module Anthropic
             ensure
               self.class.reap_connection!(status, stream: stream)
             end
+            decoded = decoded.string if decoded.is_a?(StringIO)
 
             raise Anthropic::Errors::APIStatusError.for(
               url: adapted_url,
@@ -659,8 +665,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/file_input.rb

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

data/lib/anthropic/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,23 @@ 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 const: -> { Anthropic::Models::AnthropicBeta::INLINE_TOOLS_2026_09_15 }
+
+      variant const: -> { Anthropic::Models::AnthropicBeta::MCP_CLIENT_2026_09_15 }
+
+      variant const: -> { Anthropic::Models::AnthropicBeta::CE_PLUGINS_2026_09_01 }
+
+      variant const: -> { Anthropic::Models::AnthropicBeta::SPEND_LIMIT_READS_2026_09_26 }
+
+      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 +139,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 +161,11 @@ 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"
+      INLINE_TOOLS_2026_09_15 = :"inline-tools-2026-09-15"
+      MCP_CLIENT_2026_09_15 = :"mcp-client-2026-09-15"
+      CE_PLUGINS_2026_09_01 = :"ce-plugins-2026-09-01"
+      SPEND_LIMIT_READS_2026_09_26 = :"spend-limit-reads-2026-09-26"
 
       # @!endgroup
     end

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

@@ -9,6 +9,7 @@ module Anthropic
         include Anthropic::Internal::Type::RequestParameters
 
         # @!attribute agent_id
+        #   Unique identifier of the agent to archive.
         #
         #   @return [String]
         required :agent_id, String
@@ -16,13 +17,29 @@ 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] }
 
-        # @!method initialize(agent_id:, betas: nil, request_options: {})
-        #   @param agent_id [String]
+        # @!attribute workspace_id
+        #   Optional header to select the Workspace for this request. The value is a
+        #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
         #
-        #   @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #   Only needed for credentials that can act on more than one Workspace. A
+        #   credential that belongs to a specific Workspace may omit it; if sent, it must
+        #   match that Workspace.
+        #
+        #   @return [String, nil]
+        optional :workspace_id, String
+
+        # @!method initialize(agent_id:, betas: nil, workspace_id: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::AgentArchiveParams} for more details.
+        #
+        #   @param agent_id [String] Unique identifier of the agent to archive.
+        #
+        #   @param betas [Array<Symbol, String, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        #   @param workspace_id [String] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
       end

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

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

@@ -41,10 +41,24 @@ 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] }
 
-        # @!method initialize(created_at_gte: nil, created_at_lte: nil, include_archived: nil, limit: nil, page: nil, betas: nil, request_options: {})
+        # @!attribute workspace_id
+        #   Optional header to select the Workspace for this request. The value is a
+        #   Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`).
+        #
+        #   Only needed for credentials that can act on more than one Workspace. A
+        #   credential that belongs to a specific Workspace may omit it; if sent, it must
+        #   match that Workspace.
+        #
+        #   @return [String, nil]
+        optional :workspace_id, String
+
+        # @!method initialize(created_at_gte: nil, created_at_lte: nil, include_archived: nil, limit: nil, page: nil, betas: nil, workspace_id: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::AgentListParams} for more details.
+        #
         #   @param created_at_gte [Time] Return agents created at or after this time (inclusive).
         #
         #   @param created_at_lte [Time] Return agents created at or before this time (inclusive).
@@ -55,7 +69,9 @@ 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] Optional header to select the Workspace for this request. The value is a Workspa
         #
         #   @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}]
       end

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

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