anthropic 1.59.0 → 1.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a5c7920c024b325266d16d26526490511c33ee3de9136b7a0314a6d7c28f8c0a
-  data.tar.gz: 21354f0f03146858812a863149f1c02b7f961cdbd3d7726b166530d628d340eb
+  metadata.gz: 2250e8bcc591b9822aba99c4c69d00f28495b14a6f7e03ec4997a3ec8fbaa63d
+  data.tar.gz: 1875230fde738ce6d365470dc781c264ec81147d4bf7382f111ea98f43777340
 SHA512:
-  metadata.gz: be751a0e2ddaf99238b87eefb9d67fb7479542f624d42490dc009eb1b1fcdd92159bea36526d41ab07d26687ab943911b94e27941b809f6322478ffaaa0baff2
-  data.tar.gz: da3afb6cf93ae7f9a4ab4fe2bca496f80eca4222ab80638677bca0eebd6cc9c0e556f980d2214a112aec585349193b8fcf73dde751b8a087c0da56a65647fd7f
+  metadata.gz: cd7fb0d6a181129755fc38183e4fa5f77aef8f29bed1fb01b1d53f94776d05a85a00c6173f0686968a470b9991258dcc37383067380594a6345e7fd402b41eeb
+  data.tar.gz: 16f85f7c7abc63b6aa4b3cd8b3172744e9852107dd56413038ac04fd3b08529b5029812cf651ca365b4565963e776dcfa01c4c742678a47a6ab70ed195094df1

data/CHANGELOG.md

@@ -1,5 +1,102 @@
 # Changelog
 
+## 1.65.0 (2026-08-19)
+
+Full Changelog: [v1.64.0...v1.65.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.64.0...v1.65.0)
+
+### Features
+
+* **api:** managed agents web search config and self hosted sandbox memory ([c7a8dac](https://github.com/anthropics/anthropic-sdk-ruby/commit/c7a8dac314c1b05ef5e01d632f4d0a8c0b467e38))
+
+## 1.64.0 (2026-08-19)
+
+Full Changelog: [v1.63.0...v1.64.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.63.0...v1.64.0)
+
+### Features
+
+* **api:** Files and Skills APIs are now GA; add computer use and browser use toolsets ([6878cd5](https://github.com/anthropics/anthropic-sdk-ruby/commit/6878cd5099c99f5dc8e600ec71a40b9194d384d7))
+
+## 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)
+
+### 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)
+
+### Features
+
+* **api:** add support for session budgets, advisor tool, pinned inference location and skills auto-loading from GitHub ([3d294f2](https://github.com/anthropics/anthropic-sdk-ruby/commit/3d294f276ed76868fd62159a72e3bbfeca69c0a9))
+
+## 1.60.0 (2026-08-06)
+
+Full Changelog: [v1.59.0...v1.60.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.59.0...v1.60.0)
+
+### Features
+
+* **api:** add `mid-conversation-tool-changes-2026-07-01` beta ([f52232a](https://github.com/anthropics/anthropic-sdk-ruby/commit/f52232a5ed81f9911d0481b41b2bbe44456c421b))
+
+
+### Bug Fixes
+
+* **client:** declare `base64` gemspec dependency so `require` works under Bundler on Ruby 3.4+ ([468dd7d](https://github.com/anthropics/anthropic-sdk-ruby/commit/468dd7d5fcd5ba973825968c5f6dd6529b586201))
+* **deps:** constrain gemspec runtime dependencies to their current major ([#141](https://github.com/anthropics/anthropic-sdk-ruby/issues/141)) ([b0e644c](https://github.com/anthropics/anthropic-sdk-ruby/commit/b0e644ceac00a7f9b43632345fa99c86717b7cca))
+* **internal:** preserve coerce state strictness in discriminated union fast path ([b30146f](https://github.com/anthropics/anthropic-sdk-ruby/commit/b30146f91e58ba71a751685ea3264ee757a7cc77))
+
+
+### Chores
+
+* **api:** remove retired Claude Opus 4.1 models ([b7b2043](https://github.com/anthropics/anthropic-sdk-ruby/commit/b7b2043b8bdf38271a6269771c1869b96fb66d82))
+* **deps:** bump 6 CVE-flagged dev/test gems to CVE-clean versions ([#146](https://github.com/anthropics/anthropic-sdk-ruby/issues/146)) ([ae3a617](https://github.com/anthropics/anthropic-sdk-ruby/commit/ae3a61750cede1c854e15047c411241b82ede8de))
+* **docs:** small updates to descriptions ([b8dc207](https://github.com/anthropics/anthropic-sdk-ruby/commit/b8dc207c909f48c7b276cef6da79e99404e1b6c7))
+* **docs:** updates to a few documentation strings ([b83066a](https://github.com/anthropics/anthropic-sdk-ruby/commit/b83066acd84f805bdf475883d1b3e3029f421103))
+
 ## 1.59.0 (2026-07-24)
 
 Full Changelog: [v1.58.0...v1.59.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.58.0...v1.59.0)
@@ -235,7 +332,7 @@ Full Changelog: [v1.43.0...v1.44.0](https://github.com/anthropics/anthropic-sdk-
 
 ### Bug Fixes
 
-* **internal:** preserve path-qualified multipart filenames (SDK-40) ([#937](https://github.com/anthropics/anthropic-sdk-ruby/issues/937)) ([000e793](https://github.com/anthropics/anthropic-sdk-ruby/commit/000e793062309ee421111866f1bd56d0384277f3))
+* **internal:** preserve path-qualified multipart filenames ([#937](https://github.com/anthropics/anthropic-sdk-ruby/issues/937)) ([000e793](https://github.com/anthropics/anthropic-sdk-ruby/commit/000e793062309ee421111866f1bd56d0384277f3))
 
 
 ### Documentation

data/README.md

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

data/lib/anthropic/client.rb

@@ -48,7 +48,6 @@ module Anthropic
       "claude-4-opus-20250514": 8_192,
       "anthropic.claude-opus-4-20250514-v1:0": 8_192,
       "claude-opus-4@20250514": 8_192,
-      "claude-opus-4-1-20250805": 8192,
       "anthropic.claude-opus-4-1-20250805-v1:0": 8192,
       "claude-opus-4-1@20250805": 8192
     }.freeze
@@ -77,6 +76,12 @@ module Anthropic
     # @return [Anthropic::Resources::Models]
     attr_reader :models
 
+    # @return [Anthropic::Resources::Files]
+    attr_reader :files
+
+    # @return [Anthropic::Resources::Skills]
+    attr_reader :skills
+
     # @return [Anthropic::Resources::Beta]
     attr_reader :beta
 
@@ -198,7 +203,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
@@ -209,7 +214,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 = {}
 
@@ -224,7 +229,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
@@ -235,13 +240,20 @@ 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)
       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)
@@ -277,6 +289,8 @@ module Anthropic
       @completions = Anthropic::Resources::Completions.new(client: self)
       @messages = Anthropic::Resources::Messages.new(client: self)
       @models = Anthropic::Resources::Models.new(client: self)
+      @files = Anthropic::Resources::Files.new(client: self)
+      @skills = Anthropic::Resources::Skills.new(client: self)
       @beta = Anthropic::Resources::Beta.new(client: self)
     end
 
@@ -296,6 +310,23 @@ 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. 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
+
     def warn_explicit_shadow(api_key:, auth_token:, credentials:)
       return if credentials.nil?
 

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

@@ -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,
@@ -121,36 +121,46 @@ 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?
 
-          @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
+
+        # 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
+
+        def files
+          raise NotImplementedError, "Files are not supported on Bedrock."
+        end
 
-          @messages = Anthropic::Resources::Messages.new(client: self)
-          @completions = Anthropic::Resources::Completions.new(client: self)
-          @beta = Anthropic::Resources::Beta.new(client: self)
+        def skills
+          raise NotImplementedError, "Skills are not supported on Bedrock."
         end
 
         # @api private

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

@@ -113,6 +113,18 @@ module Anthropic
                 "Models listing is not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
         end
 
+        # Files are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported.
+        def files
+          raise NotImplementedError,
+                "Files are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+        end
+
+        # Skills are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported.
+        def skills
+          raise NotImplementedError,
+                "Skills are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
+        end
+
         # @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

@@ -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]
         #
@@ -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)
@@ -128,13 +134,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