anthropic 1.62.0 → 1.63.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68e6d71ef0a8a1c6dba5ce56ca4c950073401b65fe3311ff8b305bb50f3e1895
-  data.tar.gz: ed43b20d2eb03cc4f7651213e403bb1eedd4ef682304524d82c535a9a04d680c
+  metadata.gz: e9a5ec69ebe4f2fe1d743013098cb879401a601825c244fdb587b36c055ebfc5
+  data.tar.gz: de874bbfc686b83f328bccdc1a95f8a4e5211ad6f73895d4f117ffd9e6faf260
 SHA512:
-  metadata.gz: 211153854d618da94e0d1c6cc4a7f8a28b4cbb6982df843301c293167115c12b4dcabea8ba618871150ba9cdebab08c4a6a17b0db164035ed907a54537713e16
-  data.tar.gz: 4df9827fe320d1f15bbdbcbfbcf2d77865506001d2b64314de497161700763fa86b500d9a114c7a8e1cb23d1a439aa0deef53e6ed16916da2e4d76ef7276fcff
+  metadata.gz: 79022be4b042788f7586f77a3ab32f3036bd82733505afbe387aae2f709e3db1de135ab2de906f561915a417aa73c19576c8564c7ba1632e746b620ec358b8e4
+  data.tar.gz: cd8af8f0f3577f4558b8126607b2de05bd994584fe549792af7434eb7b791f25eda4ead4ea583b233b3bf73c2f07ed4f03ebf21338dd55af1a33bee77dd150e5

data/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 1.63.0 (2026-08-18)
+
+Full Changelog: [v1.62.0...v1.63.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.62.0...v1.63.0)
+
+### Features
+
+* **api:** additions to files and memory stores ([f4baf57](https://github.com/anthropics/anthropic-sdk-ruby/commit/f4baf57eaf96b098ec63c895c84c701294583240))
+* **api:** updates to skill, files, and user profiles ([ba0844b](https://github.com/anthropics/anthropic-sdk-ruby/commit/ba0844b290a2036cba7c0a79e500497d48096c5f))
+* **tools:** add `tool_options` to `BaseTool` (strict, cache_control, …) ([#161](https://github.com/anthropics/anthropic-sdk-ruby/issues/161)) ([df278f9](https://github.com/anthropics/anthropic-sdk-ruby/commit/df278f9170ce5ff130433602b18470248dcfa3f4))
+
+
+### Bug Fixes
+
+* **api:** remove unsupported mid_conv_system content block ([687a6da](https://github.com/anthropics/anthropic-sdk-ruby/commit/687a6da56fe9cb85753f6a819d7978580bed61c9))
+* **aws,google_cloud:** adopt the default-credentials hook in the AWS and Google Cloud clients ([#170](https://github.com/anthropics/anthropic-sdk-ruby/issues/170)) ([169fea9](https://github.com/anthropics/anthropic-sdk-ruby/commit/169fea9f5ef8d0798bc0e795e0579eae367939e2))
+* **client:** never fall back to the first-party base URL when default credentials are disabled ([#193](https://github.com/anthropics/anthropic-sdk-ruby/issues/193)) ([b6e9f56](https://github.com/anthropics/anthropic-sdk-ruby/commit/b6e9f562c2872dc5f3ca3a4d6c4025e0e75397d1))
+* **tool-runner:** forward the server-assigned container on follow-up requests ([#189](https://github.com/anthropics/anthropic-sdk-ruby/issues/189)) ([891ac9b](https://github.com/anthropics/anthropic-sdk-ruby/commit/891ac9b8f12234bfe6938086937505e27175df46))
+* **tool-runner:** replay unknown tool_use input verbatim ([#173](https://github.com/anthropics/anthropic-sdk-ruby/issues/173)) ([566a881](https://github.com/anthropics/anthropic-sdk-ruby/commit/566a8817fbe8aad5a25b4111021e39d20451ef03))
+* **tool-runner:** stop on refusal instead of executing tools ([#174](https://github.com/anthropics/anthropic-sdk-ruby/issues/174)) ([4b8d2e4](https://github.com/anthropics/anthropic-sdk-ruby/commit/4b8d2e43265d31b55eb9a6f0d3241b62fa510b2d))
+
+
+### Chores
+
+* **internal:** remove leftover prism references ([5a416d3](https://github.com/anthropics/anthropic-sdk-ruby/commit/5a416d3f2c784d697a8f9fbc99f5620102ea0c84))
+
 ## 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)

data/README.md

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

data/lib/anthropic/client.rb

@@ -208,7 +208,7 @@ module Anthropic
       @token_cache = nil
 
       base_url_is_explicit = base_url && !base_url.empty?
-      base_url ||= ENV["ANTHROPIC_BASE_URL"]
+      base_url ||= ENV["ANTHROPIC_BASE_URL"] if resolve_default_credentials?
 
       credential_headers = {}
 
@@ -240,7 +240,14 @@ module Anthropic
         @token_cache = Anthropic::Credentials::TokenCache.new(@credentials)
       end
 
-      base_url ||= "https://api.anthropic.com"
+      if resolve_default_credentials?
+        base_url ||= "https://api.anthropic.com"
+      elsif base_url.to_s.empty?
+        raise ArgumentError.new(
+          "No base_url was resolved for #{self.class.name}; " \
+          "platform clients must supply their own endpoint."
+        )
+      end
 
       if @credentials.respond_to?(:bind_base_url)
         @credentials.bind_base_url(base_url)
@@ -304,7 +311,10 @@ module Anthropic
     # {#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.
+    # requests bound for another platform's endpoint. Returning +false+ also
+    # withholds the +ANTHROPIC_BASE_URL+ / +https://api.anthropic.com+
+    # base-URL fallback, so such a subclass must pass its own +base_url+ or
+    # {#initialize} raises +ArgumentError+.
     #
     # @return [Boolean]
     def resolve_default_credentials? = true

data/lib/anthropic/errors.rb

@@ -60,6 +60,12 @@ module Anthropic
       # @return [Object, nil]
       attr_accessor :body
 
+      # @return [String, nil]
+      def request_id = headers&.[]("request-id")
+
+      # @return [String, nil]
+      def workspace_id = headers&.[]("anthropic-workspace-id")
+
       # @api private
       #
       # @param url [URI::Generic]

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

@@ -53,7 +53,7 @@ module Anthropic
         #
         # @param max_retry_delay [Float]
         #
-        def initialize( # rubocop:disable Lint/MissingSuper
+        def initialize(
           api_key: nil,
           aws_access_key: nil,
           aws_secret_access_key: nil,
@@ -84,27 +84,19 @@ module Anthropic
             derive_base_url: ->(region) { "https://aws-external-anthropic.#{region}.api.aws" }
           )
 
-          @api_key = effective_api_key
-          @auth_token = nil
-          @credentials = nil
-          @token_cache = nil
-
-          # 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(
+          # In API-key mode the gateway key rides the base client's `api_key`
+          # slot; {#resolve_default_credentials?} keeps first-party credential
+          # auto-discovery out of the picture when it is absent. The gateway
+          # serves the full first-party API, so every resource the parent wires
+          # up stays available.
+          super(
+            api_key: effective_api_key,
             base_url: resolved_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"}
+            max_retry_delay: max_retry_delay
           )
-
-          @completions = Anthropic::Resources::Completions.new(client: self)
-          @messages = Anthropic::Resources::Messages.new(client: self)
-          @models = Anthropic::Resources::Models.new(client: self)
-          @beta = Anthropic::Resources::Beta.new(client: self)
         end
 
         # @api private

data/lib/anthropic/helpers/aws_auth.rb

@@ -44,6 +44,7 @@ module Anthropic
         use_bearer_auth: false
       )
         @use_bearer_auth = use_bearer_auth
+        base_url = nil if base_url.to_s.empty?
         begin
           require("aws-sdk-core")
         rescue LoadError
@@ -119,12 +120,12 @@ module Anthropic
           end
         end
 
-        if base_url.nil? && !aws_region.to_s.empty?
+        if !base_url && !aws_region.to_s.empty?
           @aws_region ||= aws_region
           base_url = derive_base_url.call(aws_region)
         end
 
-        if base_url.nil?
+        unless base_url
           # rubocop:disable Layout/LineLength
           raise ArgumentError.new("No base_url was given and no aws_region is available to derive one. Set the `base_url` argument or provide an `aws_region`.")
           # rubocop:enable Layout/LineLength
@@ -147,6 +148,16 @@ module Anthropic
         super
       end
 
+      # @api private
+      #
+      # AWS-authenticated clients 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]
+      # @see Anthropic::Client#resolve_default_credentials?
+      private def resolve_default_credentials? = false
+
       # The AWS provider middleware entry: applies the workspace-id header and
       # SigV4 signing per attempt. Return from the including class's
       # `provider_middleware`. Pure — requests are reused across retry

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

@@ -121,10 +121,8 @@ module Anthropic
             @aws_region = aws_region
           end
 
-          base_url ||= ENV.fetch(
-            "ANTHROPIC_BEDROCK_BASE_URL",
-            "https://bedrock-runtime.#{@aws_region}.amazonaws.com"
-          )
+          base_url = ENV["ANTHROPIC_BEDROCK_BASE_URL"] if base_url.to_s.empty?
+          base_url = "https://bedrock-runtime.#{@aws_region}.amazonaws.com" if base_url.to_s.empty?
 
           # For AWSAuth#auth_headers: suppress key headers in SigV4 mode; in
           # API-key mode fall through to the base bearer-token handling.
@@ -145,15 +143,6 @@ module Anthropic
           )
         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
-
         # 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.

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

@@ -113,16 +113,6 @@ 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/google_cloud/client.rb

@@ -31,15 +31,6 @@ module Anthropic
         # @return [String, nil]
         attr_reader :workspace_id
 
-        # @return [Anthropic::Resources::Messages]
-        attr_reader :messages
-
-        # @return [Anthropic::Resources::Models]
-        attr_reader :models
-
-        # @return [Anthropic::Resources::Beta]
-        attr_reader :beta
-
         # Creates a new client for the Anthropic API on the Google Cloud gateway.
         #
         # Authentication uses Google credentials by precedence (unless
@@ -95,7 +86,7 @@ module Anthropic
         #   is applied per attempt, after user middleware.
         #
         # @raise [ArgumentError]
-        def initialize( # rubocop:disable Lint/MissingSuper
+        def initialize(
           project: ENV["ANTHROPIC_GOOGLE_CLOUD_PROJECT"] || ENV["GOOGLE_CLOUD_PROJECT"],
           location: ENV["ANTHROPIC_GOOGLE_CLOUD_LOCATION"] || "global",
           workspace_id: ENV["ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID"],
@@ -144,33 +135,31 @@ module Anthropic
           end
           @workspace_id = workspace_id
 
-          base_url = derive_base_url if base_url.nil?
-
-          # Never inherit first-party Anthropic credentials from the
-          # environment: clear the ivars `Anthropic::Client#auth_headers` reads,
-          # and bind `BaseClient#initialize` directly so the parent's
-          # credential-provider / `ANTHROPIC_BASE_URL` resolution is skipped
-          # entirely.
-          @api_key = nil
-          @auth_token = nil
-          @credentials = nil
-          @token_cache = nil
+          base_url = nil if base_url.to_s.empty?
+          base_url ||= derive_base_url
 
-          Anthropic::Internal::Transport::BaseClient.instance_method(:initialize).bind(self).call(
+          # No first-party credential is ever passed up, and
+          # {#resolve_default_credentials?} keeps the parent from discovering
+          # one; `base_url` is always resolved by this point, so the parent's
+          # `ANTHROPIC_BASE_URL` fallback never applies. The parent wires up
+          # every resource; {#completions} withholds the one the gateway does
+          # not serve.
+          super(
             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
           )
-
-          @messages = Anthropic::Resources::Messages.new(client: self)
-          @models = Anthropic::Resources::Models.new(client: self)
-          @beta = Anthropic::Resources::Beta.new(client: self)
         end
 
+        # @api private
+        #
+        # @return [Boolean]
+        # @see Anthropic::Client#resolve_default_credentials?
+        private def resolve_default_credentials? = false
+
         # The deprecated text Completions endpoint is not supported on the
         # Google Cloud gateway.
         #

data/lib/anthropic/helpers/messages.rb

@@ -38,26 +38,27 @@ module Anthropic
             # rubocop:disable Metrics/BlockLength
             mapped = tool_array.map do |tool|
               case tool
-              # BaseTool whose class declares an explicit `tool_name` (e.g. MCP-built tools):
-              in Anthropic::Helpers::Tools::BaseTool if tool.class.tool_name
+              # Runnable tool instance (an `Anthropic::BaseTool` subclass, hand-written or helper-built):
+              in Anthropic::Helpers::Tools::BaseTool
                 name = tool_api_name(tool)
+                # Helper-built tools (e.g. MCP) declare an explicit `tool_name` and only send the
+                # description they were given; hand-written tools fall back to their name.
                 description = tool.class.doc_string
+                description ||= name unless tool.class.tool_name
                 tools.store(name, tool)
                 input_schema = Anthropic::Helpers::InputSchema::JsonSchemaConverter.to_json_schema(tool)
-                extras = tool.class.tool_extra_props || {}
-                result = {name:, input_schema:, **extras}
-                result[:description] = description if description
-                result[:strict] = strict if strict
-                result
-              # Direct tool class:
+                # On a clash the derived keys win, so nothing in `tool_options` can shadow them.
+                definition =
+                  {name:, description:, input_schema:}
+                  .merge(tool.class.tool_options) { |_key, derived, _option| derived }
+                  .compact
+                definition.tap { _1.update(strict:) if strict }
+              # Input schema class used directly as a tool:
               in Anthropic::Helpers::InputSchema::JsonSchemaConverter
-                name =
-                  tool.is_a?(Anthropic::Helpers::Tools::BaseTool) ? tool_api_name(tool) : model_name(tool.name)
+                name = model_name(tool.name)
 
                 description =
                   case tool
-                  in Anthropic::Helpers::Tools::BaseTool
-                    tool.class.doc_string || name
                   in Class if tool <= Anthropic::Helpers::InputSchema::BaseModel
                     tool.doc_string || name
                   else
@@ -82,6 +83,11 @@ module Anthropic
             end
             # rubocop:enable Metrics/BlockLength
             tool_array.replace(mapped)
+          else
+          end
+
+          # Matched separately from `tools:` so a request can carry both tools and a structured output format.
+          case data
           # GA: output_config with BaseModel class as format
           in {output_config: {format: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model} => output_config}
             name = model_name(model.name)

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

@@ -25,15 +25,6 @@ module Anthropic
           # @return [String, nil]
           attr_accessor :tool_name
 
-          # @api private
-          #
-          # Extra tool-definition properties merged into the API payload (e.g.
-          # `cache_control`, `defer_loading`, `allowed_callers`, `eager_input_streaming`,
-          # `input_examples`, `strict`).
-          #
-          # @return [Hash{Symbol=>Object}, nil]
-          attr_accessor :tool_extra_props
-
           # @api public
           #
           # @param description [String]
@@ -46,10 +37,78 @@ module Anthropic
           # @model [Class<Anthropic::Helpers::InputSchema::BaseModel>]
           def input_schema(model) = (@model = model)
 
+          # @api public
+          #
+          # Declares additional properties for this tool's API definition, sent alongside the
+          # `name`, `description` and `input_schema` — e.g. `strict`, `cache_control`,
+          # `defer_loading`, `allowed_callers`, `eager_input_streaming` or `input_examples`.
+          #
+          # Options accumulate: each call merges into what was already declared, and a subclass
+          # starts from its superclass's options. Called without an argument, returns the declared
+          # options as a frozen hash.
+          #
+          # @example
+          #   class GetWeather < Anthropic::BaseTool
+          #     doc "Get the current weather in a given location"
+          #     input_schema GetWeatherInput
+          #     tool_options strict: true, cache_control: {type: :ephemeral}
+          #   end
+          #
+          # @param options [Hash{Symbol=>Object}, nil]
+          #
+          # @return [Hash{Symbol=>Object}]
+          def tool_options(options = nil)
+            if options.nil?
+              return @tool_options if @tool_options
+
+              # Nothing declared on this class: read through to the superclass (`BaseTool` has none).
+              return superclass.respond_to?(:tool_options) ? superclass.tool_options : {}.freeze
+            end
+
+            options = Anthropic::Internal::Util.coerce_hash!(options).to_h.transform_keys(&:to_sym)
+            # These either have their own declaration or are derived from the class; letting them
+            # through would desync the definition sent to the API from how responses are parsed.
+            reserved = options.keys & [:name, :description, :input_schema]
+            unless reserved.empty?
+              message =
+                "#{reserved.map { "`#{_1}`" }.join(', ')} cannot be set through `tool_options`; " \
+                "use `doc` and `input_schema` instead (the tool name is derived from the class name)."
+              raise ArgumentError.new(message)
+            end
+
+            # Frozen so the stored declaration can't drift from what was validated above.
+            @tool_options = Anthropic::Internal::Util.deep_frozen_copy(tool_options.merge(options))
+          end
+
+          # @api private
+          #
+          # @deprecated Use {.tool_options}.
+          #
+          # @return [Hash{Symbol=>Object}]
+          def tool_extra_props = tool_options
+
+          # @api private
+          #
+          # @deprecated Use {.tool_options}.
+          #
+          # @param props [Hash{Symbol=>Object}, nil]
+          def tool_extra_props=(props)
+            warn(
+              "[DEPRECATION] `tool_extra_props=` is deprecated. Use `tool_options` instead.",
+              category: :deprecated
+            )
+            tool_options(props.to_h)
+          end
+
           # @api private
           #
           # @param depth [Integer]
-          def inspect(depth: 0) = "#{name}[#{model.inspect(depth:)}]"
+          def inspect(depth: 0)
+            # Only hand-written tools carry an input schema class here; helper-built tools (e.g. MCP)
+            # hold a plain class and an undeclared schema is nil, neither of which takes `depth:`.
+            schema = model.is_a?(Anthropic::Internal::Type::Converter) ? model.inspect(depth:) : model.inspect
+            "#{name || tool_name}[#{schema}]"
+          end
         end
 
         # @api private

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

@@ -61,7 +61,7 @@ module Anthropic
             api_name, description, raw_schema = Mcp.send(:extract_tool_fields, mcp_tool)
             raise ArgumentError, "MCP tool is missing a `name`" if api_name.to_s.empty?
 
-            extras = {
+            options = {
               cache_control: cache_control,
               defer_loading: defer_loading,
               allowed_callers: allowed_callers,
@@ -75,7 +75,7 @@ module Anthropic
             klass = Class.new(self)
             klass.description(description) if description
             klass.tool_name = api_name
-            klass.tool_extra_props = extras
+            klass.tool_options(options)
             klass.mcp_input_schema = Mcp.send(:normalize_schema, raw_schema)
             klass.mcp_client = mcp_client
             klass.instance_variable_set(:@model, input_class)

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

@@ -92,6 +92,14 @@ module Anthropic
             next unless current_messages.equal?(messages)
             break if compacted
 
+            # Refusal-terminated turns are terminal: executing their tool_use blocks would fire
+            # side effects the model never confirmed, and the resulting tool_results could not be
+            # replayed coherently. Surface the refusal as the final message instead.
+            if response.stop_reason == :refusal
+              @finished = true
+              break
+            end
+
             # A `tool_removal` block only hints the model, so a call to a withdrawn tool can still
             # arrive; a name missing from this set routes down the same "not found" path as an
             # undeclared tool.
@@ -130,7 +138,10 @@ module Anthropic
             content = response.content.map do
               case _1
               in Anthropic::Beta::BetaToolUseBlock
-                raw = {**_1, input: _1.parsed}.except(:parsed)
+                # `parsed` is only set for calls to a declared tool; any other call (e.g. to an
+                # unregistered tool) must replay the `input` the API sent, never a null.
+                input = _1.parsed.nil? ? _1.input : _1.parsed
+                raw = {**_1, input:}.except(:parsed)
                 Anthropic::Internal::Type::Converter.dump(Anthropic::Beta::BetaToolUseBlock, raw)
               else
                 _1
@@ -139,6 +150,7 @@ module Anthropic
 
             messages << {role: :assistant, content:}
             messages << {role: :user, content: mapped}
+            adopt_container(response)
 
             @iteration_count += 1
 
@@ -148,6 +160,26 @@ module Anthropic
           # rubocop:enable Metrics/BlockLength
         end
 
+        # @api private
+        #
+        # Container-bound server tools reject a follow-up that drops the container the previous
+        # turn ran in, so its id is forwarded unless the caller pinned one themselves.
+        #
+        # @param response [Anthropic::Models::BetaMessage]
+        private def adopt_container(response)
+          id = response.container&.id
+          return if id.nil? || id.empty?
+
+          case (pinned = params[:container])
+          in nil
+            params[:container] = id
+          in Hash | Anthropic::Beta::BetaContainerParams if read_field(pinned, :id).nil?
+            params[:container] = {**pinned, id:}
+          else
+            nil
+          end
+        end
+
         # @api private
         #
         # Replays `tool_removal` / `tool_addition` blocks from `role: :system` messages to
@@ -175,24 +207,6 @@ module Anthropic
         #
         # @param available [Set<String>]
         private def apply_tool_change(block, available)
-          case read_field(block, :type)&.to_sym
-          in :tool_removal | :tool_addition
-            apply_tool_delta(block, available)
-          in :mid_conv_system
-            # `mid_conv_system` content is limited by the API schema to text / tool_addition /
-            # tool_removal blocks, so exactly one level is walked; anything else inside is a no-op.
-            Array(read_field(block, :content)).each { apply_tool_delta(_1, available) }
-          else
-            nil # other and unknown block types leave the set untouched (forward compatibility)
-          end
-        end
-
-        # @api private
-        #
-        # @param block [Anthropic::Beta::BetaContentBlockParam, Hash{Symbol=>Object}]
-        #
-        # @param available [Set<String>]
-        private def apply_tool_delta(block, available)
           case read_field(block, :type)&.to_sym
           in :tool_removal
             name = referenced_tool_name(read_field(block, :tool))

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

@@ -89,19 +89,20 @@ module Anthropic
           @project_id = project_id
           @authorization = nil
 
-          base_url ||= ENV.fetch(
-            "ANTHROPIC_VERTEX_BASE_URL",
-            case @region.to_s
-            when "global"
-              "https://aiplatform.googleapis.com/v1"
-            when "us"
-              "https://aiplatform.us.rep.googleapis.com/v1"
-            when "eu"
-              "https://aiplatform.eu.rep.googleapis.com/v1"
-            else
-              "https://#{@region}-aiplatform.googleapis.com/v1"
-            end
-          )
+          base_url = ENV["ANTHROPIC_VERTEX_BASE_URL"] if base_url.to_s.empty?
+          if base_url.to_s.empty?
+            base_url =
+              case @region.to_s
+              when "global"
+                "https://aiplatform.googleapis.com/v1"
+              when "us"
+                "https://aiplatform.us.rep.googleapis.com/v1"
+              when "eu"
+                "https://aiplatform.eu.rep.googleapis.com/v1"
+              else
+                "https://#{@region}-aiplatform.googleapis.com/v1"
+              end
+          end
 
           super(
             base_url: base_url,

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

@@ -19,6 +19,16 @@ module Anthropic
         # @return [Hash{String=>String}]
         attr_reader :headers
 
+        # @api public
+        #
+        # @return [String, nil]
+        def request_id = headers["request-id"]
+
+        # @api public
+        #
+        # @return [String, nil]
+        def workspace_id = headers["anthropic-workspace-id"]
+
         # @api public
         #
         # @return [void]

data/lib/anthropic/models/anthropic_beta.rb

@@ -51,6 +51,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::USER_PROFILES_2026_03_24 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::USER_PROFILES_2026_08_18 }
+
       variant const: -> { Anthropic::Models::AnthropicBeta::ADVISOR_TOOL_2026_03_01 }
 
       variant const: -> { Anthropic::Models::AnthropicBeta::MANAGED_AGENTS_2026_04_01 }
@@ -104,6 +106,7 @@ module Anthropic
       FAST_MODE_2026_02_01 = :"fast-mode-2026-02-01"
       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"
       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"

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

@@ -11,7 +11,7 @@ module Anthropic
         # @!attribute model
         #   Model identifier. Accepts the
         #   [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
-        #   e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
+        #   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]
@@ -108,7 +108,7 @@ module Anthropic
 
         # Model identifier. Accepts the
         # [model string](https://platform.claude.com/docs/en/about-claude/models/overview#latest-models-comparison),
-        # e.g. `claude-opus-4-6`, or a `model_config` object for additional configuration
+        # e.g. `claude-opus-5`, or a `model_config` object for additional configuration
         # control
         module Model
           extend Anthropic::Internal::Type::Union