anthropic 1.26.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8765d87a8f2c333c114221a23ca51b9562d6364e6585bb517660192974a193d4
-  data.tar.gz: dfcba061b31eb9a056a0b0cbfe5a0f96b93277a52162d3945f2615d26eea81a4
+  metadata.gz: 72c6d580e9df64dc561e9dcd1b5ea9cd9ad18d46293c64dc25f8e6cd971ed8dc
+  data.tar.gz: a1124fb9148fc390060d8d9a6f333eb698fb65beaa5e81a7f57c5a02b95fcb16
 SHA512:
-  metadata.gz: 04b8f406fe7f06a6d9bc6331030486a1283d099c0e19eb2975fd7a987f911280a7a6e13d277d4d412fd478fa98a3316c114a9ff3cf98c0fb4c028b9d218f8592
-  data.tar.gz: 727738003e679d0fd5ca540fc918e85f8eccfb67a8f47d45996aaec6ddb58d14ec5ceed23df33197aafb7a779730019cdc27b2ec61aaacb4e549dcd9957905b9
+  metadata.gz: a687549d5a637357f3ffd5b8da67529da52410168e7cab51e4485c3c120a15f4dbba7b07d957f5920866f78db44f6bd790cab398a6d07b5a4da3298d0c8038f0
+  data.tar.gz: 19245fd17062f33dbc20dc2ba59e5f6c33be3605bd37d3b27af34813cee0e4b37feedcc217d3cb3b7ef354492220dd39dacb71009eb43f7fe90920762e11adda

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.27.0 (2026-04-01)
+
+Full Changelog: [v1.26.0...v1.27.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.26.0...v1.27.0)
+
+### Features
+
+* **api:** add structured stop_details to message responses ([5e636fd](https://github.com/anthropics/anthropic-sdk-ruby/commit/5e636fd9ce945bd52f92d99e21e6bb8b9c212238))
+* bedrock api key auth ([#880](https://github.com/anthropics/anthropic-sdk-ruby/issues/880)) ([93f9b87](https://github.com/anthropics/anthropic-sdk-ruby/commit/93f9b870184a3519270cacec10ceeaa85e9f548c))
+
+
+### Bug Fixes
+
+* align path encoding with RFC 3986 section 3.3 ([280f489](https://github.com/anthropics/anthropic-sdk-ruby/commit/280f4894bb96af3890cb142df1e6bd0fae53fbcd))
+
+
+### Chores
+
+* **internal:** client updates ([151043a](https://github.com/anthropics/anthropic-sdk-ruby/commit/151043a45a4f332fb176038799f499be358db44a))
+
 ## 1.26.0 (2026-03-31)
 
 Full Changelog: [v1.25.0...v1.26.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.25.0...v1.26.0)

data/README.md

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

data/lib/anthropic/aws.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Anthropic
+  AWSClient = Anthropic::Helpers::AWS::Client
+end

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

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    module AWS
+      class Client < Anthropic::Client
+        include Anthropic::Helpers::AWSAuth
+
+        # @return [String, nil]
+        attr_reader :aws_region
+
+        # @return [String, nil]
+        attr_reader :workspace_id
+
+        # Creates and returns a new client for interacting with Anthropic models via the AWS gateway.
+        #
+        # AWS credentials are resolved in priority order:
+        #   1. `api_key` constructor arg → API key mode (x-api-key header, no SigV4)
+        #   2. `aws_access_key` + `aws_secret_access_key` args → SigV4 with explicit credentials
+        #   3. `aws_profile` arg → SigV4 with named AWS profile
+        #   4. `ANTHROPIC_AWS_API_KEY` env var → API key mode (only when no platform auth args given)
+        #   5. Default AWS credential chain (env vars → shared config → instance profile) → SigV4
+        #
+        # When `skip_auth` is true, all auth is skipped and workspace_id is not required.
+        #
+        # @param api_key [String, nil] Anthropic API key (bypasses SigV4, uses x-api-key header)
+        #
+        # @param aws_access_key [String, nil] AWS access key ID for SigV4 signing
+        #
+        # @param aws_secret_access_key [String, nil] AWS secret access key for SigV4 signing
+        #
+        # @param aws_session_token [String, nil] Optional AWS session token for temporary credentials
+        #
+        # @param aws_profile [String, nil] AWS profile name (uses SigV4 with named profile)
+        #
+        # @param aws_region [String, nil] AWS region for the gateway URL and SigV4 signing.
+        #   Defaults to `ENV["AWS_REGION"]`, then `ENV["AWS_DEFAULT_REGION"]`. Required in SigV4 mode.
+        #
+        # @param workspace_id [String, nil] Anthropic workspace ID, sent as `anthropic-workspace-id` header.
+        #   Defaults to `ENV["ANTHROPIC_AWS_WORKSPACE_ID"]`
+        #
+        # @param skip_auth [Boolean] When true, skip all auth (no SigV4, no API key) and do not
+        #   require workspace_id. Useful for testing or when auth is handled externally.
+        #
+        # @param base_url [String, nil] Override the default base URL for the API.
+        #   Defaults to `ENV["ANTHROPIC_AWS_BASE_URL"]`, then `https://aws-external-anthropic.{region}.api.aws`.
+        #
+        # @param max_retries [Integer] Max number of retries to attempt after a failed retryable request.
+        #
+        # @param timeout [Float]
+        #
+        # @param initial_retry_delay [Float]
+        #
+        # @param max_retry_delay [Float]
+        #
+        def initialize(
+          api_key: nil,
+          aws_access_key: nil,
+          aws_secret_access_key: nil,
+          aws_session_token: nil,
+          aws_profile: nil,
+          aws_region: ENV["AWS_REGION"] || ENV["AWS_DEFAULT_REGION"],
+          workspace_id: ENV["ANTHROPIC_AWS_WORKSPACE_ID"],
+          skip_auth: false,
+          base_url: ENV["ANTHROPIC_AWS_BASE_URL"],
+          max_retries: self.class::DEFAULT_MAX_RETRIES,
+          timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
+          initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
+          max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
+        )
+          effective_api_key, resolved_base_url = setup_aws_auth(
+            api_key: api_key,
+            aws_access_key: aws_access_key,
+            aws_secret_access_key: aws_secret_access_key,
+            aws_session_token: aws_session_token,
+            aws_profile: aws_profile,
+            aws_region: aws_region,
+            workspace_id: workspace_id,
+            skip_auth: skip_auth,
+            base_url: base_url,
+            service_name: "aws-external-anthropic",
+            env_api_key: "ANTHROPIC_AWS_API_KEY",
+            env_workspace_id: "ANTHROPIC_AWS_WORKSPACE_ID",
+            derive_base_url: ->(region) { "https://aws-external-anthropic.#{region}.api.aws" }
+          )
+
+          super(
+            api_key: effective_api_key,
+            base_url: resolved_base_url,
+            max_retries: max_retries,
+            timeout: timeout,
+            initial_retry_delay: initial_retry_delay,
+            max_retry_delay: max_retry_delay
+          )
+        end
+
+        # @api private
+        private def transform_request(request)
+          aws_auth_transform_request(request)
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/helpers/aws_auth.rb

@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Helpers
+    # Shared AWS authentication module used by both the AWS gateway client and the
+    # Bedrock Mantle client. Provides SigV4 signing, credential resolution, and
+    # config handling parameterized by service name and environment variable names.
+    module AWSAuth
+      # Sets up AWS authentication state. Call from the including class's `initialize`.
+      #
+      # @param api_key [String, nil]
+      # @param aws_access_key [String, nil]
+      # @param aws_secret_access_key [String, nil]
+      # @param aws_session_token [String, nil]
+      # @param aws_profile [String, nil]
+      # @param aws_region [String, nil]
+      # @param workspace_id [String, nil]
+      # @param skip_auth [Boolean]
+      # @param base_url [String, nil]
+      # @param service_name [String] AWS service name for SigV4 signing
+      # @param env_api_key [String] Primary env var for API key
+      # @param env_api_key_fallback [String, nil] Fallback env var for API key
+      # @param env_workspace_id [String] Primary env var for workspace ID
+      # @param env_workspace_id_fallback [String, nil] Fallback env var for workspace ID
+      # @param derive_base_url [Proc] Lambda that takes region and returns default base URL
+      #
+      # @return [Array(String, String)] [effective_api_key, resolved_base_url]
+      private def setup_aws_auth(
+        api_key:,
+        aws_access_key:,
+        aws_secret_access_key:,
+        aws_session_token:,
+        aws_profile:,
+        aws_region:,
+        workspace_id:,
+        skip_auth:,
+        base_url:,
+        service_name:,
+        env_api_key:,
+        env_workspace_id:,
+        derive_base_url:,
+        env_api_key_fallback: nil,
+        env_workspace_id_fallback: nil
+      )
+        begin
+          require("aws-sdk-core")
+        rescue LoadError
+          message = <<~MSG
+
+            In order to use Anthropic AWS clients you must require the `aws-sdk-core` gem.
+            You can install it by adding the following to your Gemfile:
+
+                gem "aws-sdk-core"
+
+            and then running `bundle install`.
+
+            Alternatively, if you are not using Bundler, simply run:
+
+                gem install aws-sdk-core
+          MSG
+
+          raise RuntimeError.new(message)
+        end
+
+        if (aws_access_key && !aws_secret_access_key) || (!aws_access_key && aws_secret_access_key)
+          raise ArgumentError.new("Both aws_access_key and aws_secret_access_key must be provided together")
+        end
+
+        @skip_auth = skip_auth
+
+        if @skip_auth
+          effective_api_key = nil
+          @use_sig_v4 = false
+        else
+          # Resolve auth mode. Explicit platform auth args suppress the API key env var check.
+          has_platform_auth = aws_access_key || aws_secret_access_key || aws_profile
+          env_key = env_lookup(env_api_key, env_api_key_fallback)
+          effective_api_key = api_key || (has_platform_auth ? nil : env_key)
+          @use_sig_v4 = effective_api_key.nil?
+        end
+
+        if @use_sig_v4
+          if aws_region.to_s.empty?
+            # rubocop:disable Layout/LineLength
+            raise ArgumentError.new("No aws_region was given. Set the `aws_region` argument or the `AWS_REGION` / `AWS_DEFAULT_REGION` environment variable.")
+            # rubocop:enable Layout/LineLength
+          end
+
+          @aws_region = aws_region
+          credentials = resolve_credentials(
+            aws_access_key: aws_access_key,
+            aws_secret_access_key: aws_secret_access_key,
+            aws_session_token: aws_session_token,
+            aws_profile: aws_profile
+          )
+          @signer = Aws::Sigv4::Signer.new(
+            service: service_name,
+            region: @aws_region,
+            credentials_provider: credentials
+          )
+        end
+
+        # Workspace ID: constructor > primary env > fallback env
+        resolved_workspace_id = workspace_id
+        if resolved_workspace_id.to_s.empty?
+          resolved_workspace_id = env_lookup(env_workspace_id, env_workspace_id_fallback)
+        end
+        @workspace_id = resolved_workspace_id.to_s.empty? ? nil : resolved_workspace_id.to_s
+
+        unless @skip_auth
+          if @workspace_id.nil?
+            # rubocop:disable Layout/LineLength
+            raise ArgumentError.new("No workspace ID found. Set the `workspace_id` argument or the `#{env_workspace_id}` environment variable.")
+            # rubocop:enable Layout/LineLength
+          end
+        end
+
+        if base_url.nil? && !aws_region.to_s.empty?
+          @aws_region ||= aws_region
+          base_url = derive_base_url.call(aws_region)
+        end
+
+        if base_url.nil?
+          # 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
+        end
+
+        [effective_api_key, base_url]
+      end
+
+      # Override the base client's auth_headers to prevent ANTHROPIC_API_KEY
+      # from leaking as an x-api-key header in SigV4 mode. The server rejects
+      # requests that contain both Authorization (SigV4) and x-api-key headers.
+      #
+      # @return [Hash{String=>String}]
+      private def auth_headers
+        return {} if @use_sig_v4
+        super
+      end
+
+      # Applies workspace-id header and SigV4 signing to the request.
+      # Call from the including class's `transform_request`.
+      #
+      # @param request [Hash{Symbol=>Object}]
+      # @return [Hash{Symbol=>Object}]
+      private def aws_auth_transform_request(request)
+        headers = request.fetch(:headers)
+
+        headers["anthropic-workspace-id"] = @workspace_id if @workspace_id
+
+        return request unless @use_sig_v4
+
+        sliced = request.slice(:method, :url, :body).transform_keys(method: :http_method)
+        signed = @signer.sign_request({**sliced, headers: headers})
+        headers = Anthropic::Internal::Util.normalized_headers(headers, signed.headers)
+        headers.delete("connection")
+        {**request, headers: headers}
+      end
+
+      # Resolves AWS credentials from explicit args, profile, env vars, or default chain.
+      #
+      # @param aws_access_key [String, nil]
+      # @param aws_secret_access_key [String, nil]
+      # @param aws_session_token [String, nil]
+      # @param aws_profile [String, nil]
+      #
+      # @return [Aws::Credentials, Aws::SharedCredentials, Aws::InstanceProfileCredentials]
+      private def resolve_credentials(
+        aws_access_key:,
+        aws_secret_access_key:,
+        aws_session_token:,
+        aws_profile:
+      )
+        if aws_access_key && aws_secret_access_key
+          return Aws::Credentials.new(aws_access_key, aws_secret_access_key, aws_session_token)
+        end
+
+        if aws_profile
+          return Aws::SharedCredentials.new(profile_name: aws_profile)
+        end
+
+        # Default credential chain: env vars → shared config file → instance profile
+        if ENV["AWS_ACCESS_KEY_ID"] && ENV["AWS_SECRET_ACCESS_KEY"]
+          return Aws::Credentials.new(
+            ENV["AWS_ACCESS_KEY_ID"],
+            ENV["AWS_SECRET_ACCESS_KEY"],
+            ENV["AWS_SESSION_TOKEN"]
+          )
+        end
+
+        begin
+          shared = Aws::SharedCredentials.new
+          return shared if shared.set?
+        rescue StandardError
+          nil
+        end
+
+        # Fall back to instance profile (EC2/ECS/Lambda metadata service)
+        Aws::InstanceProfileCredentials.new
+      end
+
+      # Returns the first non-empty value from the given env var names.
+      #
+      # @param names [Array<String, nil>]
+      # @return [String, nil]
+      private def env_lookup(*names)
+        names.each do |name|
+          next if name.nil?
+          val = ENV[name]
+          return val unless val.to_s.empty?
+        end
+        nil
+      end
+    end
+  end
+end

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

@@ -21,6 +21,9 @@ module Anthropic
         # @return [Aws::Credentials]
         attr_reader :aws_credentials
 
+        # @return [String, nil]
+        def api_key = @auth_token
+
         # Creates and returns a new client for interacting with the AWS Bedrock API for Anthropic models.
         #
         # AWS credentials are resolved according to the AWS SDK's default resolution order, described at
@@ -37,6 +40,9 @@ module Anthropic
         #
         # @param aws_profile [String, nil] Optional AWS profile to use for authentication. Overrides the credential provider chain
         #
+        # @param api_key [String, nil] Optional API key for Bearer token authentication. Mutually exclusive with AWS
+        #   credentials. Falls back to the `AWS_BEARER_TOKEN_BEDROCK` environment variable if not provided.
+        #
         # @param base_url [String, nil] Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
         #
         # @param max_retries [Integer] The maximum number of times to retry a request if it fails
@@ -57,41 +63,55 @@ module Anthropic
           aws_access_key: nil,
           aws_secret_key: nil,
           aws_session_token: nil,
-          aws_profile: nil
+          aws_profile: nil,
+          api_key: nil
         )
-          begin
-            require("aws-sdk-bedrockruntime")
-          rescue LoadError
-            message = <<~MSG
+          api_key ||= ENV["AWS_BEARER_TOKEN_BEDROCK"]
 
-              In order to access Anthropic models on Bedrock you must require the `aws-sdk-bedrockruntime` gem.
-              You can install it by adding the following to your Gemfile:
+          has_aws_credentials = !aws_access_key.nil? || !aws_secret_key.nil? || !aws_session_token.nil? || !aws_profile.nil?
+          if !api_key.nil? && has_aws_credentials
+            raise ArgumentError.new(
+              "Cannot specify both `api_key` and AWS credentials (`aws_access_key`, `aws_secret_key`, `aws_session_token`, `aws_profile`)"
+            )
+          end
 
-                  gem "aws-sdk-bedrockruntime"
+          if api_key.nil?
+            begin
+              require("aws-sdk-bedrockruntime")
+            rescue LoadError
+              message = <<~MSG
 
-              and then running `bundle install`.
+                In order to access Anthropic models on Bedrock you must require the `aws-sdk-bedrockruntime` gem.
+                You can install it by adding the following to your Gemfile:
 
-              Alternatively, if you are not using Bundler, simply run:
+                    gem "aws-sdk-bedrockruntime"
 
-                  gem install aws-sdk-bedrockruntime
-            MSG
+                and then running `bundle install`.
 
-            raise RuntimeError.new(message)
-          end
+                Alternatively, if you are not using Bundler, simply run:
 
-          @aws_region, @aws_credentials = resolve_region_and_credentials(
-            aws_region: aws_region,
-            aws_secret_key: aws_secret_key,
-            aws_access_key: aws_access_key,
-            aws_session_token: aws_session_token,
-            aws_profile: aws_profile
-          )
+                    gem install aws-sdk-bedrockruntime
+              MSG
 
-          @signer = Aws::Sigv4::Signer.new(
-            service: "bedrock",
-            region: @aws_region,
-            credentials: @aws_credentials
-          )
+              raise RuntimeError.new(message)
+            end
+
+            @aws_region, @aws_credentials = resolve_region_and_credentials(
+              aws_region: aws_region,
+              aws_secret_key: aws_secret_key,
+              aws_access_key: aws_access_key,
+              aws_session_token: aws_session_token,
+              aws_profile: aws_profile
+            )
+
+            @signer = Aws::Sigv4::Signer.new(
+              service: "bedrock",
+              region: @aws_region,
+              credentials: @aws_credentials
+            )
+          else
+            @aws_region = aws_region
+          end
 
           base_url ||= ENV.fetch(
             "ANTHROPIC_BEDROCK_BASE_URL",
@@ -99,6 +119,8 @@ module Anthropic
           )
 
           super(
+            api_key: nil,
+            auth_token: api_key,
             base_url: base_url,
             timeout: timeout,
             max_retries: max_retries,
@@ -172,6 +194,8 @@ module Anthropic
         #
         # @return [Hash{Symbol, Object}]
         private def transform_request(request)
+          return request if @auth_token
+
           headers = request.fetch(:headers)
           sliced = super.slice(:method, :url, :body).transform_keys(method: :http_method)
           signed = @signer.sign_request({**sliced, headers: headers})

data/lib/anthropic/internal/util.rb

@@ -237,6 +237,11 @@ module Anthropic
         end
       end
 
+      # @type [Regexp]
+      #
+      # https://www.rfc-editor.org/rfc/rfc3986.html#section-3.3
+      RFC_3986_NOT_PCHARS = /[^A-Za-z0-9\-._~!$&'()*+,;=:@]+/
+
       class << self
         # @api private
         #
@@ -247,6 +252,15 @@ module Anthropic
           "#{uri.scheme}://#{uri.host}#{":#{uri.port}" unless uri.port == uri.default_port}"
         end
 
+        # @api private
+        #
+        # @param path [String, Integer]
+        #
+        # @return [String]
+        def encode_path(path)
+          path.to_s.gsub(Anthropic::Internal::Util::RFC_3986_NOT_PCHARS) { ERB::Util.url_encode(_1) }
+        end
+
         # @api private
         #
         # @param path [String, Array<String>]
@@ -259,7 +273,7 @@ module Anthropic
           in []
             ""
           in [String => p, *interpolations]
-            encoded = interpolations.map { ERB::Util.url_encode(_1) }
+            encoded = interpolations.map { encode_path(_1) }
             format(p, *encoded)
           end
         end
@@ -576,10 +590,10 @@ module Anthropic
 
           case val
           in Anthropic::FilePart unless val.filename.nil?
-            filename = ERB::Util.url_encode(val.filename)
+            filename = encode_path(val.filename)
             y << "; filename=\"#{filename}\""
           in Pathname | IO
-            filename = ERB::Util.url_encode(::File.basename(val.to_path))
+            filename = encode_path(::File.basename(val.to_path))
             y << "; filename=\"#{filename}\""
           else
           end

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

@@ -95,6 +95,12 @@ module Anthropic
         #   @return [Symbol, :assistant]
         required :role, const: :assistant
 
+        # @!attribute stop_details
+        #   Structured information about a refusal.
+        #
+        #   @return [Anthropic::Models::Beta::BetaRefusalStopDetails, nil]
+        required :stop_details, -> { Anthropic::Beta::BetaRefusalStopDetails }, nil?: true
+
         # @!attribute stop_reason
         #   The reason that we stopped.
         #
@@ -152,7 +158,7 @@ module Anthropic
         #   @return [Anthropic::Models::Beta::BetaUsage]
         required :usage, -> { Anthropic::Beta::BetaUsage }
 
-        # @!method initialize(id:, container:, content:, context_management:, model:, stop_reason:, stop_sequence:, usage:, role: :assistant, type: :message)
+        # @!method initialize(id:, container:, content:, context_management:, model:, stop_details:, stop_reason:, stop_sequence:, usage:, role: :assistant, type: :message)
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaMessage} for more details.
         #
@@ -166,6 +172,8 @@ module Anthropic
         #
         #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
         #
+        #   @param stop_details [Anthropic::Models::Beta::BetaRefusalStopDetails, nil] Structured information about a refusal.
+        #
         #   @param stop_reason [Symbol, Anthropic::Models::Beta::BetaStopReason, nil] The reason that we stopped.
         #
         #   @param stop_sequence [String, nil] Which custom stop sequence was generated, if any.

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

@@ -61,6 +61,12 @@ module Anthropic
           #   @return [Anthropic::Models::Beta::BetaContainer, nil]
           required :container, -> { Anthropic::Beta::BetaContainer }, nil?: true
 
+          # @!attribute stop_details
+          #   Structured information about a refusal.
+          #
+          #   @return [Anthropic::Models::Beta::BetaRefusalStopDetails, nil]
+          required :stop_details, -> { Anthropic::Beta::BetaRefusalStopDetails }, nil?: true
+
           # @!attribute stop_reason
           #
           #   @return [Symbol, Anthropic::Models::Beta::BetaStopReason, nil]
@@ -71,12 +77,14 @@ module Anthropic
           #   @return [String, nil]
           required :stop_sequence, String, nil?: true
 
-          # @!method initialize(container:, stop_reason:, stop_sequence:)
+          # @!method initialize(container:, stop_details:, stop_reason:, stop_sequence:)
           #   Some parameter documentations has been truncated, see
           #   {Anthropic::Models::Beta::BetaRawMessageDeltaEvent::Delta} for more details.
           #
           #   @param container [Anthropic::Models::Beta::BetaContainer, nil] Information about the container used in the request (for the code execution tool
           #
+          #   @param stop_details [Anthropic::Models::Beta::BetaRefusalStopDetails, nil] Structured information about a refusal.
+          #
           #   @param stop_reason [Symbol, Anthropic::Models::Beta::BetaStopReason, nil]
           #
           #   @param stop_sequence [String, nil]

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

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      class BetaRefusalStopDetails < Anthropic::Internal::Type::BaseModel
+        # @!attribute category
+        #   The policy category that triggered the refusal.
+        #
+        #   `null` when the refusal doesn't map to a named category.
+        #
+        #   @return [Symbol, Anthropic::Models::Beta::BetaRefusalStopDetails::Category, nil]
+        required :category, enum: -> { Anthropic::Beta::BetaRefusalStopDetails::Category }, nil?: true
+
+        # @!attribute explanation
+        #   Human-readable explanation of the refusal.
+        #
+        #   This text is not guaranteed to be stable. `null` when no explanation is
+        #   available for the category.
+        #
+        #   @return [String, nil]
+        required :explanation, String, nil?: true
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :refusal]
+        required :type, const: :refusal
+
+        # @!method initialize(category:, explanation:, type: :refusal)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaRefusalStopDetails} for more details.
+        #
+        #   Structured information about a refusal.
+        #
+        #   @param category [Symbol, Anthropic::Models::Beta::BetaRefusalStopDetails::Category, nil] The policy category that triggered the refusal.
+        #
+        #   @param explanation [String, nil] Human-readable explanation of the refusal.
+        #
+        #   @param type [Symbol, :refusal]
+
+        # The policy category that triggered the refusal.
+        #
+        # `null` when the refusal doesn't map to a named category.
+        #
+        # @see Anthropic::Models::Beta::BetaRefusalStopDetails#category
+        module Category
+          extend Anthropic::Internal::Type::Enum
+
+          CYBER = :cyber
+          BIO = :bio
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+
+    BetaRefusalStopDetails = Beta::BetaRefusalStopDetails
+  end
+end