anthropic 2.2.0 → 2.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0fa0ec3e782fb7fc0c20e1c0a5e85c5c7b8b83891d1e42a3e604b22936a3e52a
-  data.tar.gz: 1ffcd5af0856f4677a04899b7c0e5c2b2703da055d14a58aa1042a710d89e466
+  metadata.gz: 19e65c78c32b38c06866fa6d8bc50f8219170fc73c7a2171c118e89a3c8fdf65
+  data.tar.gz: d2a9d4159eaf896aa79f238e7980f9fb15a523a44aa77e7165ef18bbb2bd3969
 SHA512:
-  metadata.gz: 5dc4b3c320eae3c0aad79ec29f21235792820cc8d946ad64b849a81403be3cfeac29bddd270d5db09a6744aee60ada26dc0dd1a42129d584a35377a4389ab2af
-  data.tar.gz: 06a39cffd5d2f99b951bc98e34967972c17da8a04da48395ae2d426640b71ad36649b6053f704c53112c5050861d4825664dca1947d65af7df66f64f3d2832d0
+  metadata.gz: a875dfc422ae1a9257e133e34307c40d3779f1560cb3c4b88a1193e2824f6a6b8b245ac2c459cd1a31c75a357bdfabc06a55f2f2620863b3928d54588c91cc11
+  data.tar.gz: 72a6f11b4fa46e78254ce2593557d6bdb48b4e9db948b973a1392536e05fe332b7544149095c78ca7239cc4e11fd5a7e97fc552825316c433aae0392920ce01a

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # 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

data/README.md

@@ -15,7 +15,7 @@ Add to your application's Gemfile:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 2.2.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
 

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?
@@ -309,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/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

@@ -24,8 +24,9 @@ module Anthropic
         # 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]

data/lib/anthropic/internal/tracing.rb

@@ -353,6 +353,26 @@ module Anthropic
         ORGANIZATION_WEBHOOKS_DELETE = "anthropic.organization.webhooks.delete"
         ORGANIZATION_WEBHOOKS_REGENERATE_SIGNING_SECRET =
           "anthropic.organization.webhooks.regenerate_signing_secret"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_CREATE = "anthropic.organization.claude_tag.slack_channels.create"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_RETRIEVE =
+          "anthropic.organization.claude_tag.slack_channels.retrieve"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_UPDATE = "anthropic.organization.claude_tag.slack_channels.update"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_LIST = "anthropic.organization.claude_tag.slack_channels.list"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_DELETE = "anthropic.organization.claude_tag.slack_channels.delete"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_RETRIEVE =
+          "anthropic.organization.claude_tag.slack_workspaces.retrieve"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_UPDATE =
+          "anthropic.organization.claude_tag.slack_workspaces.update"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_LIST = "anthropic.organization.claude_tag.slack_workspaces.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_RETRIEVE = "anthropic.organization.claude_tag.bundles.retrieve"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_LIST = "anthropic.organization.claude_tag.bundles.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_CREATE =
+          "anthropic.organization.claude_tag.bundles.targets.create"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_RETRIEVE =
+          "anthropic.organization.claude_tag.bundles.targets.retrieve"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_LIST = "anthropic.organization.claude_tag.bundles.targets.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_DELETE =
+          "anthropic.organization.claude_tag.bundles.targets.delete"
       end
 
       # @type [Hash{String=>String}]

data/lib/anthropic/internal/transport/base_client.rb

@@ -41,6 +41,7 @@ module Anthropic
               :page,
               :stream,
               :model,
+              :qualifiers,
               :span_name,
               :span_attributes,
               :span_created_id,
@@ -100,6 +101,8 @@ module Anthropic
           #
           #   @option request [Float] :timeout
           #
+          #   @option request [Hash{Symbol=>String}, nil] :qualifiers
+          #
           #   @option request [Array<String>, nil] :span_query
           #
           #   @option request [Array<String>, nil] :span_content_query
@@ -335,6 +338,9 @@ module Anthropic
         #
         #   @option req [Anthropic::Internal::Type::Converter, Class, nil] :model
         #
+        #   @option req [Hash{Symbol=>String}, nil] :qualifiers internal: the query pairs that tell the operation apart from the others with its
+        #   path in the OpenAPI document
+        #
         #   @option req [String, nil] :span_name
         #
         #   @option req [Hash{String=>Object}, nil] :span_attributes
@@ -428,6 +434,7 @@ module Anthropic
             body: body,
             max_retries: opts.fetch(:max_retries, @max_retries),
             timeout: timeout,
+            qualifiers: req[:qualifiers],
             user_header_keys: user_header_keys,
             # For paginated requests `model` is the page's *item* type, not the
             # response envelope's — middleware `parse` falls back to the raw
@@ -439,7 +446,7 @@ module Anthropic
             span_content_query: req[:span_content_query],
             options: opts.except(:middleware),
             middleware: request_middleware,
-            metadata: {}
+            metadata: {qualifiers: req[:qualifiers]}.compact
           }
         end
 
@@ -540,6 +547,8 @@ module Anthropic
         #
         #   @option request [Float] :timeout
         #
+        #   @option request [Hash{Symbol=>String}, nil] :qualifiers
+        #
         #   @option request [Array<String>, nil] :span_query
         #
         #   @option request [Array<String>, nil] :span_content_query
@@ -738,7 +747,7 @@ module Anthropic
         # Execute the request specified by `req`. This is the method that all resource
         # methods call into.
         #
-        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Anthropic::Internal::Type::Unknown, span_name: nil, span_attributes: nil, span_created_id: nil, span_route: nil, span_query: nil, span_content_query: nil, options: {})
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Anthropic::Internal::Type::Unknown, qualifiers: nil, span_name: nil, span_attributes: nil, span_created_id: nil, span_route: nil, span_query: nil, span_content_query: nil, options: {})
         #
         # @param method [Symbol]
         #
@@ -758,6 +767,9 @@ module Anthropic
         #
         # @param model [Anthropic::Internal::Type::Converter, Class, nil]
         #
+        # @param qualifiers [Hash{Symbol=>String}, nil] internal: the query pairs that tell the operation apart from the others with its
+        # path in the OpenAPI document
+        #
         # @param span_name [String, nil]
         #
         # @param span_attributes [Hash{String=>Object}, nil]
@@ -913,6 +925,7 @@ module Anthropic
                 T::Class[Anthropic::Internal::Type::BaseStream[T.anything, Anthropic::Internal::Type::BaseModel]]
               ),
               model: T.nilable(Anthropic::Internal::Type::Converter::Input),
+              qualifiers: T.nilable(T::Hash[Symbol, String]),
               span_name: T.nilable(String),
               span_attributes: T.nilable(T::Hash[String, T.anything]),
               span_created_id: T.nilable(T.any(String, T::Hash[String, Symbol])),
@@ -932,6 +945,7 @@ module Anthropic
               body: T.anything,
               max_retries: Integer,
               timeout: Float,
+              qualifiers: T.nilable(T::Hash[Symbol, String]),
               user_header_keys: T::Array[String],
               cast_to: T.nilable(Anthropic::Internal::Type::Converter::Input),
               stream: T.nilable(T::Class[T.anything]),

data/lib/anthropic/models/anthropic_beta.rb

@@ -113,6 +113,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::ANALYTICS_USAGE_COST_2026_08_24 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::EXPERIMENTAL_CLAUDE_TAG_2026_10_21 }
+
       variant String
 
       # @!method self.variants
@@ -178,6 +180,7 @@ module Anthropic
       WEBHOOKS_2026_10_07 = :"webhooks-2026-10-07"
       MESSAGE_THREADS_2026_08_12 = :"message-threads-2026-08-12"
       ANALYTICS_USAGE_COST_2026_08_24 = :"analytics-usage-cost-2026-08-24"
+      EXPERIMENTAL_CLAUDE_TAG_2026_10_21 = :"experimental-claude-tag-2026-10-21"
 
       # @!endgroup
     end

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

@@ -43,8 +43,16 @@ module Anthropic
         optional :strict, Anthropic::Internal::Type::Boolean
 
         # @!method initialize(allowed_callers: nil, cache_control: nil, defer_loading: nil, strict: nil, name: :code_execution, type: :code_execution_20260120)
-        #   Code execution tool with REPL state persistence (daemon mode + gVisor
-        #   checkpoint).
+        #   A `tools` entry for the code execution tool, version `code_execution_20260120`.
+        #   It adds REPL state persistence to version `code_execution_20250825`.
+        #
+        #   REPL state persistence applies with programmatic tool calling. With it, the
+        #   Python interpreter state, such as variable bindings, persists across requests
+        #   that reuse the container.
+        #
+        #   See the
+        #   [code execution tool guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions)
+        #   to learn what each tool version adds.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaCodeExecutionTool20260120} for more details.

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

@@ -10,7 +10,11 @@ module Anthropic
 
         variant -> { Anthropic::Beta::BetaCodeExecutionResultBlock }
 
-        # Code execution result with encrypted stdout for PFC + web_search results.
+        # The output and exit code of Python code that Claude ran with the code execution tool, with standard output in encrypted form.
+        #
+        # The API returns this block in place of `code_execution_result` when the code called the web search tool.
+        #
+        # See the [programmatic tool calling guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling) to learn more about programmatic tool calling.
         variant -> { Anthropic::Beta::BetaEncryptedCodeExecutionResultBlock }
 
         # @!method self.variants

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

@@ -10,7 +10,7 @@ module Anthropic
 
         variant -> { Anthropic::Beta::BetaCodeExecutionResultBlockParam }
 
-        # Code execution result with encrypted stdout for PFC + web_search results.
+        # The output and exit code of Python code that Claude ran with the code execution tool, with standard output in encrypted form, sent back in a later request.
         variant -> { Anthropic::Beta::BetaEncryptedCodeExecutionResultBlockParam }
 
         # @!method self.variants

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

@@ -31,7 +31,15 @@ module Anthropic
         required :type, const: :encrypted_code_execution_result
 
         # @!method initialize(content:, encrypted_stdout:, return_code:, stderr:, type: :encrypted_code_execution_result)
-        #   Code execution result with encrypted stdout for PFC + web_search results.
+        #   The output and exit code of Python code that Claude ran with the code execution
+        #   tool, with standard output in encrypted form.
+        #
+        #   The API returns this block in place of `code_execution_result` when the code
+        #   called the web search tool.
+        #
+        #   See the
+        #   [programmatic tool calling guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/programmatic-tool-calling)
+        #   to learn more about programmatic tool calling.
         #
         #   @param content [Array<Anthropic::Models::Beta::BetaCodeExecutionOutputBlock>]
         #   @param encrypted_stdout [String]

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

@@ -31,7 +31,8 @@ module Anthropic
         required :type, const: :encrypted_code_execution_result
 
         # @!method initialize(content:, encrypted_stdout:, return_code:, stderr:, type: :encrypted_code_execution_result)
-        #   Code execution result with encrypted stdout for PFC + web_search results.
+        #   The output and exit code of Python code that Claude ran with the code execution
+        #   tool, with standard output in encrypted form, sent back in a later request.
         #
         #   @param content [Array<Anthropic::Models::Beta::BetaCodeExecutionOutputBlockParam>]
         #   @param encrypted_stdout [String]

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

@@ -17,7 +17,11 @@ module Anthropic
 
         variant -> { Anthropic::Beta::BetaCodeExecutionTool20250825 }
 
-        # Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).
+        # A `tools` entry for the code execution tool, version `code_execution_20260120`. It adds REPL state persistence to version `code_execution_20250825`.
+        #
+        # REPL state persistence applies with programmatic tool calling. With it, the Python interpreter state, such as variable bindings, persists across requests that reuse the container.
+        #
+        # See the [code execution tool guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) to learn what each tool version adds.
         variant -> { Anthropic::Beta::BetaCodeExecutionTool20260120 }
 
         # Code execution tool with REPL state persistence.

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

@@ -23,7 +23,7 @@ module Anthropic
         optional :version, String
 
         # @!method initialize(skill_id:, type:, version: nil)
-        #   Specification for a skill to be loaded in a container (request model).
+        #   Specification for a skill to be loaded in a container.
         #
         #   @param skill_id [String] Skill ID
         #

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

@@ -16,7 +16,11 @@ module Anthropic
 
         variant -> { Anthropic::Beta::BetaCodeExecutionTool20250825 }
 
-        # Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).
+        # A `tools` entry for the code execution tool, version `code_execution_20260120`. It adds REPL state persistence to version `code_execution_20250825`.
+        #
+        # REPL state persistence applies with programmatic tool calling. With it, the Python interpreter state, such as variable bindings, persists across requests that reuse the container.
+        #
+        # See the [code execution tool guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) to learn what each tool version adds.
         variant -> { Anthropic::Beta::BetaCodeExecutionTool20260120 }
 
         # Code execution tool with REPL state persistence.

data/lib/anthropic/models/beta/environments/beta_self_hosted_work_heartbeat_response.rb

@@ -7,7 +7,8 @@ module Anthropic
         # @see Anthropic::Resources::Beta::Environments::Work#heartbeat
         class BetaSelfHostedWorkHeartbeatResponse < Anthropic::Internal::Type::BaseModel
           # @!attribute last_heartbeat
-          #   RFC 3339 timestamp of the actual heartbeat from DB
+          #   RFC 3339 timestamp of the most recent heartbeat recorded for this work item, or
+          #   an empty string if none has been recorded
           #
           #   @return [String]
           required :last_heartbeat, String
@@ -39,7 +40,11 @@ module Anthropic
           # @!method initialize(last_heartbeat:, lease_extended:, state:, ttl_seconds:, type: :work_heartbeat)
           #   Response after recording a heartbeat for a work item.
           #
-          #   @param last_heartbeat [String] RFC 3339 timestamp of the actual heartbeat from DB
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Environments::BetaSelfHostedWorkHeartbeatResponse} for
+          #   more details.
+          #
+          #   @param last_heartbeat [String] RFC 3339 timestamp of the most recent heartbeat recorded for this work item, or
           #
           #   @param lease_extended [Boolean] Whether the heartbeat succeeded in extending the lease
           #

data/lib/anthropic/models/beta/environments/beta_self_hosted_work_queue_stats.rb

@@ -7,7 +7,7 @@ module Anthropic
         # @see Anthropic::Resources::Beta::Environments::Work#stats
         class BetaSelfHostedWorkQueueStats < Anthropic::Internal::Type::BaseModel
           # @!attribute depth
-          #   Number of work items waiting to be picked up (lag from consumer group)
+          #   Number of work items waiting to be picked up
           #
           #   @return [Integer]
           required :depth, Integer
@@ -41,13 +41,11 @@ module Anthropic
           # @!method initialize(depth:, oldest_queued_at:, pending:, workers_polling:, type: :work_queue_stats)
           #   Statistics about the work queue for an environment.
           #
-          #   Uses Redis Stream consumer group metrics for O(1) queries.
-          #
           #   Some parameter documentations has been truncated, see
           #   {Anthropic::Models::Beta::Environments::BetaSelfHostedWorkQueueStats} for more
           #   details.
           #
-          #   @param depth [Integer] Number of work items waiting to be picked up (lag from consumer group)
+          #   @param depth [Integer] Number of work items waiting to be picked up
           #
           #   @param oldest_queued_at [String, nil] RFC 3339 timestamp of oldest item in the work stream (includes both queued and p
           #

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

@@ -386,7 +386,11 @@ module Anthropic
 
           variant -> { Anthropic::Beta::BetaCodeExecutionTool20250825 }
 
-          # Code execution tool with REPL state persistence (daemon mode + gVisor checkpoint).
+          # A `tools` entry for the code execution tool, version `code_execution_20260120`. It adds REPL state persistence to version `code_execution_20250825`.
+          #
+          # REPL state persistence applies with programmatic tool calling. With it, the Python interpreter state, such as variable bindings, persists across requests that reuse the container.
+          #
+          # See the [code execution tool guide](https://platform.claude.com/docs/en/agents-and-tools/tool-use/code-execution-tool#tool-versions) to learn what each tool version adds.
           variant -> { Anthropic::Beta::BetaCodeExecutionTool20260120 }
 
           # Code execution tool with REPL state persistence.

data/lib/anthropic/models/beta/organization/beta_claude_tag_default_setting_source.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaClaudeTagDefaultSettingSource < Anthropic::Internal::Type::BaseModel
+          # @!attribute type
+          #
+          #   @return [Symbol, :default]
+          required :type, const: :default
+
+          # @!method initialize(type: :default)
+          #   No settings level sets a value, and the built-in default applies.
+          #
+          #   @param type [Symbol, :default]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_claude_tag_guest_policy.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        # What Claude does in a channel while a Slack guest is in it, for everyone in the
+        # channel. It changes nothing in a channel without Slack guests. More types can be
+        # added.
+        module BetaClaudeTagGuestPolicy
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          # Claude answers in the channel.
+          variant :allow, -> { Anthropic::Beta::Organization::BetaClaudeTagGuestPolicyAllow }
+
+          # Claude does not answer in the channel.
+          variant :restrict, -> { Anthropic::Beta::Organization::BetaClaudeTagGuestPolicyRestrict }
+
+          # Claude answers with only the Bundles attached to the channel itself.
+          variant :channel_only, -> { Anthropic::Beta::Organization::BetaClaudeTagGuestPolicyChannelOnly }
+
+          module Type
+            extend Anthropic::Internal::Type::Enum
+
+            ALLOW = :allow
+            RESTRICT = :restrict
+            CHANNEL_ONLY = :channel_only
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicyAllow, Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicyRestrict, Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicyChannelOnly)]
+
+          # Creates a new instance of the variant class whose `type` matches the given
+          # value, passing the remaining arguments to its constructor.
+          #
+          # @param type [Symbol, Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicy::Type, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicyAllow, Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicyRestrict, Anthropic::Models::Beta::Organization::BetaClaudeTagGuestPolicyChannelOnly]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :allow
+              Anthropic::Beta::Organization::BetaClaudeTagGuestPolicyAllow.new(**args)
+            when :restrict
+              Anthropic::Beta::Organization::BetaClaudeTagGuestPolicyRestrict.new(**args)
+            when :channel_only
+              Anthropic::Beta::Organization::BetaClaudeTagGuestPolicyChannelOnly.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
+        end
+      end
+    end
+  end
+end