anthropic 2.1.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d88e7a1741b4ec77ffe3d32523b09d83cf522d475d477e48a48fa58648470de
-  data.tar.gz: 3672c35346dbc9afe8d2f63649e4f7e3ddcc38b1d52ad5bdcdb12f0f3a77f658
+  metadata.gz: 19e65c78c32b38c06866fa6d8bc50f8219170fc73c7a2171c118e89a3c8fdf65
+  data.tar.gz: d2a9d4159eaf896aa79f238e7980f9fb15a523a44aa77e7165ef18bbb2bd3969
 SHA512:
-  metadata.gz: 3a6d6573f1b09ae58d90b738c46b756780a6f6f2bb952febc58e114dfa5fe5fb87cb9d272b6d4ea7a2df7cf4e174ccb83891bcd2811bf1b9d1955b2bb3fa1e17
-  data.tar.gz: 2bbe046e948cb1074ea16dfc7ed7eafd70519a5db351a934fff7a75551b289a3094e1e155d4045d8f7c714843e7d71499582a8a67b5e949897fe25e9b82b4287
+  metadata.gz: a875dfc422ae1a9257e133e34307c40d3779f1560cb3c4b88a1193e2824f6a6b8b245ac2c459cd1a31c75a357bdfabc06a55f2f2620863b3928d54588c91cc11
+  data.tar.gz: 72a6f11b4fa46e78254ce2593557d6bdb48b4e9db948b973a1392536e05fe332b7544149095c78ca7239cc4e11fd5a7e97fc552825316c433aae0392920ce01a

data/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Changelog
 
+## [2.3.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v2.2.0...v2.3.0) (2026-10-23)
+
+### Features
+
+* **api:** add Claude Tag endpoints for Claude Enterprise organizations
+* **google-cloud:** add user profiles and send them to the organization endpoint; `user_profiles` calls used to raise `NotImplementedError`
+
+
+### Bug Fixes
+
+* **bedrock:** `BedrockClient` with an API key takes its region from `AWS_REGION`, then `AWS_DEFAULT_REGION`, when `aws_region` is not passed
+* **client:** link the long-request error message to the SDK documentation
+
+
+### Chores
+
+* **client:** stop sending query params hardcoded in endpoint paths
+* **docs:** improve the descriptions of the code execution tool and its encrypted results
+* **docs:** reword work queue, skill and external key descriptions
+* **docs:** update descriptions of the per-user usage and cost reports
+* **internal:** carry endpoint path query params to the request layer
+* **internal:** check the repository by owner and public name in workflows
+* **internal:** lint against mixing a module into a class from outside
+* **internal:** read the beta route qualifier instead of the beta=true query
+* **internal:** remove preview build upload from CI
+* **internal:** stop expecting the beta query param in tests
+* **internal:** test that rbi and sig declare every public method
+
+
+### Documentation
+
+* **google-cloud:** update the product name
+* update the README and the example request
+
+## [2.2.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v2.1.0...v2.2.0) (2026-10-23)
+
+### Features
+
+* **api:** add support for message threads
+* **api:** add usage and cost reports by dimension, mark older reports legacy
+
+
+### Bug Fixes
+
+* **tools:** a tool runner whose messages are replaced while a reply is handled skips that turn again: no tool runs and the next request sends the new messages as they are
+* **tools:** the tool runner takes a frozen `messages` array again when no tool is called
+* **tools:** the assistant turn that the tool runner adds to `params[:messages]` can be edited again, and its blocks other than tool calls are typed blocks again
+
+
+### Chores
+
+* **ci:** update the runner label for internal CI jobs
+* **docs:** clarify plugin content scan and validation descriptions
+* **docs:** clarify plugin served_version_pinned and updated_at
+* **docs:** fix usage and cost report examples and ending_at docs
+* **docs:** rate limit model lists vary by organization and workspace
+
 ## [2.1.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v2.0.0...v2.1.0) (2026-10-21)
 
 ### Features

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 2.1.0"
+gem "anthropic", "~> 2.3.0"
 ```
 
 <!-- x-release-please-end -->
@@ -33,7 +33,7 @@ anthropic = Anthropic::Client.new(
 message = anthropic.messages.create(
   max_tokens: 1024,
   messages: [{role: "user", content: "Hello, Claude"}],
-  model: "claude-opus-5-5"
+  model: Anthropic::Model::CLAUDE_OPUS_5_5
 )
 
 puts(message.content)

data/lib/anthropic/client.rb

@@ -118,7 +118,7 @@ module Anthropic
       if expected_time > default_time || (max_nonstreaming_tokens && max_tokens > max_nonstreaming_tokens)
         raise ArgumentError.new(
           "Streaming is required for operations that may take longer than 10 minutes. " \
-          "See https://github.com/anthropics/anthropic-sdk-ruby#long-requests for more details"
+          "See https://platform.claude.com/docs/en/cli-sdks-libraries/sdks/ruby#streaming for more details"
         )
       end
 
@@ -355,6 +355,14 @@ module Anthropic
       super
     end
 
+    # @api private
+    #
+    # Whether the platform this client talks to has message threads. Platform clients whose
+    # platform has none override this.
+    #
+    # @return [Boolean]
+    def message_threads? = true
+
     private
 
     # @api private

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

@@ -28,6 +28,7 @@ module Anthropic
         #
         # @param aws_region [String, nil] Enforce the AWS Region to use. If unset, the region is set according to the
         #   AWS SDK's default resolution order, described at https://github.com/aws/aws-sdk-ruby?tab=readme-ov-file#configuration
+        #   With an API key, defaults to `ENV["AWS_REGION"]`, then `ENV["AWS_DEFAULT_REGION"]`.
         #
         # @param aws_access_key [String, nil]  Optional AWS access key to use for authentication. Overrides profile and credential provider chain
         #
@@ -118,7 +119,7 @@ module Anthropic
               credentials: @aws_credentials
             )
           else
-            @aws_region = aws_region
+            @aws_region = aws_region || env_lookup("AWS_REGION", "AWS_DEFAULT_REGION")
           end
 
           base_url = ENV["ANTHROPIC_BEDROCK_BASE_URL"] if base_url.to_s.empty?
@@ -155,6 +156,11 @@ module Anthropic
           raise NotImplementedError.new(message)
         end
 
+        # @api private
+        #
+        # @return [Boolean]
+        def message_threads? = false
+
         def files
           raise NotImplementedError, "Files are not supported on Bedrock."
         end
@@ -304,14 +310,16 @@ module Anthropic
         private def validate_bedrock_request!(request_components)
           # Id-parameterized routes pass `path` as an Array whose first element
           # is the format string (e.g. `["v1/messages/batches/%1$s", id]`).
-          case Array(request_components[:path]).first.to_s
+          path = Array(request_components[:path]).first.to_s
+          beta = request_components.dig(:qualifiers, :beta) == "true" || path.include?("?beta=true")
+          case path
           in %r{^v1/messages/batches}
             message = "The Batch API is not supported in Bedrock yet"
             raise NotImplementedError.new(message)
           in %r{v1/messages/count_tokens}
             message = "Token counting is not supported in Bedrock yet"
             raise NotImplementedError.new(message)
-          in %r{v1/models\?beta=true}
+          in %r{v1/models(\?|\z)} if beta
             # 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

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

@@ -111,6 +111,11 @@ module Anthropic
                 "Models listing is not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported."
         end
 
+        # @api private
+        #
+        # @return [Boolean]
+        def message_threads? = false
+
         # Files are not supported on Bedrock Mantle. Only Messages (/v1/messages) is supported.
         def files
           raise NotImplementedError,

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

@@ -3,14 +3,14 @@
 module Anthropic
   module Helpers
     module GoogleCloud
-      # Client for Claude Platform on Google Cloud — the first-party Anthropic
-      # API served through the Google Cloud gateway.
+      # Client for Claude Models on Google Cloud (Anthropic managed) — the
+      # first-party Anthropic API served through the Google Cloud gateway.
       #
       # This is distinct from {Anthropic::VertexClient}, which targets the
       # `:rawPredict` publisher-model API (publisher model IDs, messages
       # only). This client speaks the full first-party Anthropic API: requests
       # pass through the gateway unchanged — standard `/v1/*` paths, standard
-      # model names. The gateway does not serve the User Profiles API.
+      # model names.
       class Client < Anthropic::Client
         # OAuth2 scope required to call the gateway.
         SCOPE = "https://www.googleapis.com/auth/cloud-platform"
@@ -26,9 +26,9 @@ module Anthropic
         # served from a base with no workspace in it.
         ORGANIZATION_URL_TEMPLATE = "#{LOCATION_URL_TEMPLATE}/claudeOrganization/invoke".freeze
 
-        ORGANIZATION_PATH_PREFIX = "/v1/organizations/"
+        ORGANIZATION_PATH_PATTERN = %r{\A/v1/(?:organizations/|user_profiles(?:/|\z))}
 
-        private_constant :LOCATION_URL_TEMPLATE, :ORGANIZATION_PATH_PREFIX
+        private_constant :LOCATION_URL_TEMPLATE, :ORGANIZATION_PATH_PATTERN
 
         # @return [String, nil]
         attr_reader :project
@@ -63,7 +63,8 @@ module Anthropic
         # @param workspace_id [String, nil] Defaults to
         #   `ENV["ANTHROPIC_GOOGLE_CLOUD_WORKSPACE_ID"]`. Required when the base
         #   URL is derived, except for organization-level routes
-        #   (`/v1/organizations/`), which need no workspace ID.
+        #   (`/v1/organizations/` and `/v1/user_profiles`), which need no
+        #   workspace ID.
         #
         # @param base_url [String, nil] Override the gateway base URL for every
         #   route. Defaults to `ENV["ANTHROPIC_GOOGLE_CLOUD_BASE_URL"]`, otherwise
@@ -154,10 +155,7 @@ module Anthropic
           # 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; {#user_profiles} withholds the one the gateway does
-          # not serve, and {#build_request} refuses the user profile routes
-          # however the resource is reached.
+          # `ANTHROPIC_BASE_URL` fallback never applies.
           super(
             base_url: base_url,
             timeout: timeout,
@@ -175,13 +173,6 @@ module Anthropic
         # @see Anthropic::Client#resolve_default_credentials?
         private def resolve_default_credentials? = false
 
-        # User profiles are not supported on the Google Cloud gateway.
-        #
-        # @raise [NotImplementedError]
-        def user_profiles
-          raise NotImplementedError.new("User profiles are not supported on the Google Cloud gateway.")
-        end
-
         # @api private
         #
         # @param req [Hash{Symbol=>Object}] .
@@ -219,15 +210,8 @@ module Anthropic
         #   @option opts [Float, nil] :timeout
         #
         # @raise [ArgumentError]
-        # @raise [NotImplementedError]
         # @return [Hash{Symbol=>Object}]
         private def build_request(req, opts)
-          # Id-parameterized routes pass `path` as an Array whose first element
-          # is the format string (e.g. `["v1/user_profiles/%1$s", id]`).
-          if Array(req[:path]).first.to_s.start_with?("v1/user_profiles")
-            raise NotImplementedError.new("User profiles are not supported on the Google Cloud gateway.")
-          end
-
           request = super
           return request if @organization_base_url.nil?
 
@@ -238,7 +222,7 @@ module Anthropic
           return request unless under_base_url
 
           path = url.path.delete_prefix(base_url.path)
-          if path.start_with?(ORGANIZATION_PATH_PREFIX)
+          if path.match?(ORGANIZATION_PATH_PATTERN)
             url = url.dup
             url.path = "#{@organization_base_url.path}#{path}"
             {**request, url: url}

data/lib/anthropic/helpers/refusal_fallback.rb

@@ -225,8 +225,7 @@ module Anthropic
       return false unless req.method == :post
       return false unless req.body.is_a?(Hash)
       return false unless req.url.path&.end_with?("/v1/messages")
-      query = URI.decode_www_form(req.url.query.to_s).to_h
-      query["beta"] == "true"
+      req.metadata.dig(:qualifiers, :beta) == "true"
     end
 
     # @return [Anthropic::APIRequest] `req` with `@betas` appended to the

data/lib/anthropic/helpers/stainless_helper_header.rb

@@ -18,13 +18,15 @@ module Anthropic
       # hyphenated lowercase.
       BETA_TOOL_RUNNER = "BetaToolRunner"
       FALLBACK_REFUSAL_MIDDLEWARE = "fallback-refusal-middleware"
+      MESSAGE_THREAD = "message-thread"
 
       class << self
         # The {HEADER} value to set after appending `value` to whatever is
         # already present in `headers` — existing tags keep their position, the
         # new tag goes at the end, duplicates are dropped, joined as one
-        # comma-separated string. The backend logs the header as one opaque
-        # string, so a second header line or a clobbered value loses data.
+        # comma-separated string. The new tag is merged into the existing value
+        # rather than replacing it, because a second header line or a clobbered
+        # value loses data.
         #
         # @param headers [Hash{String => String}]
         # @param value [String]