anthropic 1.25.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bfde8fb8238b702db1198ffaaa13365d3274c4222f67795ef642cdf3400071b
-  data.tar.gz: 971877b395273eca3fbadf30a18b30b94adb797b423ef0ed0a05e9bb53e487bb
+  metadata.gz: 72c6d580e9df64dc561e9dcd1b5ea9cd9ad18d46293c64dc25f8e6cd971ed8dc
+  data.tar.gz: a1124fb9148fc390060d8d9a6f333eb698fb65beaa5e81a7f57c5a02b95fcb16
 SHA512:
-  metadata.gz: 991b93e8ddf7187a7b08598ca4f5b3b374f680337f1efb2a7ad5160e3ff0f2da5271320177a0abcf169e61a2502a56553d994449a1f493beebe80a49b0c3ed40
-  data.tar.gz: b4778e9aec53cc412a43baadd0c382c130e3e16bc72f260eed7927bb0d04cd8707eec9582030abda572ccf104ce7537382bea6b771668354bcadad5ec0f78b2e
+  metadata.gz: a687549d5a637357f3ffd5b8da67529da52410168e7cab51e4485c3c120a15f4dbba7b07d957f5920866f78db44f6bd790cab398a6d07b5a4da3298d0c8038f0
+  data.tar.gz: 19245fd17062f33dbc20dc2ba59e5f6c33be3605bd37d3b27af34813cee0e4b37feedcc217d3cb3b7ef354492220dd39dacb71009eb43f7fe90920762e11adda

data/CHANGELOG.md

@@ -1,5 +1,52 @@
 # 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)
+
+### Features
+
+* add .type field to APIStatusError for uniform error identification ([#847](https://github.com/anthropics/anthropic-sdk-ruby/issues/847)) ([4c57783](https://github.com/anthropics/anthropic-sdk-ruby/commit/4c577837697516dc339100fe52be915afe544102))
+
+
+### Bug Fixes
+
+* **internal:** correct multipart form field name encoding ([0fed236](https://github.com/anthropics/anthropic-sdk-ruby/commit/0fed236eabd481a034739c6f7abab75bc3a875c2))
+* variable name typo ([550b1ed](https://github.com/anthropics/anthropic-sdk-ruby/commit/550b1ed8af220d6749040c44f608b0b6b8910aaf))
+
+
+### Chores
+
+* **ci:** run builds on CI even if only spec metadata changed ([8faa86f](https://github.com/anthropics/anthropic-sdk-ruby/commit/8faa86f76c7fbc80082ac07768e14af831566f62))
+* **ci:** skip lint on metadata-only changes ([16064d4](https://github.com/anthropics/anthropic-sdk-ruby/commit/16064d40c434ba29c0943c6dd0402c0b58fcbb3d))
+* **ci:** support opting out of skipping builds on metadata-only commits ([e184024](https://github.com/anthropics/anthropic-sdk-ruby/commit/e18402452192c17170a6933ab0bb060a7e0ba073))
+* **internal:** update gitignore ([5f3d363](https://github.com/anthropics/anthropic-sdk-ruby/commit/5f3d363e741a966fa6ec3e04ed675eab27aedd77))
+* **tests:** bump steady to v0.19.4 ([4a17d4d](https://github.com/anthropics/anthropic-sdk-ruby/commit/4a17d4deff2d696f78c9c503f99dcbd9c7146153))
+* **tests:** bump steady to v0.19.5 ([a4bcfd7](https://github.com/anthropics/anthropic-sdk-ruby/commit/a4bcfd76f9384c02bfb074ed57de8aba2face020))
+* **tests:** bump steady to v0.19.6 ([e34f523](https://github.com/anthropics/anthropic-sdk-ruby/commit/e34f5236c9d2aa6fa78c7562af7f89aa70fe373b))
+* **tests:** bump steady to v0.19.7 ([577310d](https://github.com/anthropics/anthropic-sdk-ruby/commit/577310d77b14972f657d5946b661298cadbff31a))
+* **tests:** bump steady to v0.20.1 ([dcf51d2](https://github.com/anthropics/anthropic-sdk-ruby/commit/dcf51d293d46d719c0fe09b4410dcb5445adcabc))
+* **tests:** bump steady to v0.20.2 ([5c52306](https://github.com/anthropics/anthropic-sdk-ruby/commit/5c523068dadf801f50b1d39d53bbcce07a5d0722))
+
 ## 1.25.0 (2026-03-18)
 
 Full Changelog: [v1.24.0...v1.25.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.24.0...v1.25.0)

data/README.md

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

@@ -121,6 +121,9 @@ module Anthropic
     end
 
     class APIStatusError < Anthropic::Errors::APIError
+      # @return [Anthropic::ErrorType::TaggedSymbol, nil]
+      attr_reader :type
+
       # @api private
       #
       # @param url [URI::Generic]
@@ -133,6 +136,9 @@ module Anthropic
       #
       # @return [self]
       def self.for(url:, status:, headers:, body:, request:, response:, message: nil)
+        error_type = body.dig(:error, :type) if body.is_a?(Hash)
+        error_type = error_type.to_sym if error_type.is_a?(String)
+
         kwargs =
           {
             url: url,
@@ -141,7 +147,8 @@ module Anthropic
             body: body,
             request: request,
             response: response,
-            message: message
+            message: message,
+            type: error_type
           }
 
         case status
@@ -179,7 +186,9 @@ module Anthropic
       # @param request [nil]
       # @param response [nil]
       # @param message [String, nil]
-      def initialize(url:, status:, headers:, body:, request:, response:, message: nil)
+      # @param type [Anthropic::ErrorType::TaggedSymbol, nil]
+      def initialize(url:, status:, headers:, body:, request:, response:, message: nil, type: nil)
+        @type = type
         message ||= {url: url.to_s, status: status, body: body}
         super(
           url: url,

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

@@ -157,7 +157,7 @@ module Anthropic
           in Hash | nil => coerced
             coerced
           else
-            message = "Expected a #{Hash} or #{Anthropic::Internal::Type::BaseModel}, got #{data.inspect}"
+            message = "Expected a #{Hash} or #{Anthropic::Internal::Type::BaseModel}, got #{input.inspect}"
             raise ArgumentError.new(message)
           end
         end
@@ -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
@@ -571,16 +585,15 @@ module Anthropic
           y << "Content-Disposition: form-data"
 
           unless key.nil?
-            name = ERB::Util.url_encode(key.to_s)
-            y << "; name=\"#{name}\""
+            y << "; name=\"#{key}\""
           end
 
           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/anthropic_beta.rb

@@ -47,6 +47,8 @@ module Anthropic
 
       variant const: -> { Anthropic::Models::AnthropicBeta::FAST_MODE_2026_02_01 }
 
+      variant const: -> { Anthropic::Models::AnthropicBeta::OUTPUT_300K_2026_03_24 }
+
       # @!method self.variants
       #   @return [Array(String, Symbol)]
 
@@ -76,6 +78,7 @@ module Anthropic
       MODEL_CONTEXT_WINDOW_EXCEEDED_2025_08_26 = :"model-context-window-exceeded-2025-08-26"
       SKILLS_2025_10_02 = :"skills-2025-10-02"
       FAST_MODE_2026_02_01 = :"fast-mode-2026-02-01"
+      OUTPUT_300K_2026_03_24 = :"output-300k-2026-03-24"
 
       # @!endgroup
     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.