anthropic 0.4.1 → 1.1.0

data/lib/anthropic.rb

@@ -1,72 +1,324 @@
-require "faraday"
-require "faraday/multipart"
+# frozen_string_literal: true
 
-require_relative "anthropic/http"
-require_relative "anthropic/client"
-require_relative "anthropic/version"
-
-module Anthropic
-  class Error < StandardError; end
-  class ConfigurationError < Error; end
-
-  class MiddlewareErrors < Faraday::Middleware
-    def call(env)
-      @app.call(env)
-    rescue Faraday::Error => e
-      raise e unless e.response.is_a?(Hash)
-
-      logger = Logger.new($stdout)
-      logger.formatter = proc do |_severity, _datetime, _progname, msg|
-        "\033[31mAnthropic HTTP Error (spotted in anthropic #{VERSION}): #{msg}\n\033[0m"
-      end
-      logger.error(e.response[:body])
-
-      raise e
-    end
-  end
-
-  class Configuration
-    attr_writer :access_token
-    attr_accessor :anthropic_version,
-                  :api_version,
-                  :extra_headers,
-                  :log_errors,
-                  :request_timeout,
-                  :uri_base
-
-    DEFAULT_API_VERSION = "v1".freeze
-    DEFAULT_ANTHROPIC_VERSION = "2023-06-01".freeze
-    DEFAULT_LOG_ERRORS = false
-    DEFAULT_URI_BASE = "https://api.anthropic.com/".freeze
-    DEFAULT_REQUEST_TIMEOUT = 120
+# Standard libraries.
+# rubocop:disable Lint/RedundantRequireStatement
+require "English"
+require "cgi"
+require "date"
+require "erb"
+require "etc"
+require "json"
+require "net/http"
+require "pathname"
+require "rbconfig"
+require "securerandom"
+require "set"
+require "stringio"
+require "time"
+require "uri"
+# rubocop:enable Lint/RedundantRequireStatement
 
-    def initialize
-      @access_token = nil
-      @api_version = DEFAULT_API_VERSION
-      @anthropic_version = DEFAULT_ANTHROPIC_VERSION
-      @log_errors = DEFAULT_LOG_ERRORS
-      @uri_base = DEFAULT_URI_BASE
-      @request_timeout = DEFAULT_REQUEST_TIMEOUT
-      @extra_headers = {}
-    end
-
-    def access_token
-      return @access_token if @access_token
-
-      error_text = "Anthropic access token missing! See https://github.com/alexrudall/anthropic#usage"
-      raise ConfigurationError, error_text
-    end
-  end
-
-  class << self
-    attr_writer :configuration
-  end
+# We already ship the preferred sorbet manifests in the package itself.
+# `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
+if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
+  return
+end
 
-  def self.configuration
-    @configuration ||= Anthropic::Configuration.new
-  end
+# Gems.
+require "connection_pool"
 
-  def self.configure
-    yield(configuration)
-  end
-end
+# Package files.
+require_relative "anthropic/version"
+require_relative "anthropic/internal/util"
+require_relative "anthropic/internal/type/converter"
+require_relative "anthropic/internal/type/unknown"
+require_relative "anthropic/internal/type/boolean"
+require_relative "anthropic/internal/type/file_input"
+require_relative "anthropic/internal/type/enum"
+require_relative "anthropic/internal/type/union"
+require_relative "anthropic/internal/type/array_of"
+require_relative "anthropic/internal/type/hash_of"
+require_relative "anthropic/internal/type/base_model"
+require_relative "anthropic/internal/type/base_page"
+require_relative "anthropic/internal/type/base_stream"
+require_relative "anthropic/internal/type/request_parameters"
+require_relative "anthropic/internal"
+require_relative "anthropic/request_options"
+require_relative "anthropic/file_part"
+require_relative "anthropic/errors"
+require_relative "anthropic/internal/transport/base_client"
+require_relative "anthropic/internal/transport/pooled_net_requester"
+require_relative "anthropic/client"
+require_relative "anthropic/helpers/bedrock/client"
+require_relative "anthropic/helpers/vertex/client"
+require_relative "anthropic/bedrock"
+require_relative "anthropic/vertex"
+require_relative "anthropic/internal/stream"
+require_relative "anthropic/internal/jsonl_stream"
+require_relative "anthropic/internal/page"
+require_relative "anthropic/models/anthropic_beta"
+require_relative "anthropic/models/api_error_object"
+require_relative "anthropic/models/authentication_error"
+require_relative "anthropic/models/base64_image_source"
+require_relative "anthropic/models/base64_pdf_source"
+require_relative "anthropic/models/beta/beta_base64_image_source"
+require_relative "anthropic/models/beta/beta_base64_pdf_block"
+require_relative "anthropic/models/beta/beta_base64_pdf_source"
+require_relative "anthropic/models/beta/beta_cache_control_ephemeral"
+require_relative "anthropic/models/beta/beta_cache_creation"
+require_relative "anthropic/models/beta/beta_citation_char_location"
+require_relative "anthropic/models/beta/beta_citation_char_location_param"
+require_relative "anthropic/models/beta/beta_citation_content_block_location"
+require_relative "anthropic/models/beta/beta_citation_content_block_location_param"
+require_relative "anthropic/models/beta/beta_citation_page_location"
+require_relative "anthropic/models/beta/beta_citation_page_location_param"
+require_relative "anthropic/models/beta/beta_citations_config_param"
+require_relative "anthropic/models/beta/beta_citations_delta"
+require_relative "anthropic/models/beta/beta_citations_web_search_result_location"
+require_relative "anthropic/models/beta/beta_citation_web_search_result_location_param"
+require_relative "anthropic/models/beta/beta_code_execution_output_block"
+require_relative "anthropic/models/beta/beta_code_execution_output_block_param"
+require_relative "anthropic/models/beta/beta_code_execution_result_block"
+require_relative "anthropic/models/beta/beta_code_execution_result_block_param"
+require_relative "anthropic/models/beta/beta_code_execution_tool_20250522"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_block"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_block_content"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_block_param_content"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_error"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_error_code"
+require_relative "anthropic/models/beta/beta_code_execution_tool_result_error_param"
+require_relative "anthropic/models/beta/beta_container"
+require_relative "anthropic/models/beta/beta_container_upload_block"
+require_relative "anthropic/models/beta/beta_container_upload_block_param"
+require_relative "anthropic/models/beta/beta_content_block"
+require_relative "anthropic/models/beta/beta_content_block_param"
+require_relative "anthropic/models/beta/beta_content_block_source"
+require_relative "anthropic/models/beta/beta_content_block_source_content"
+require_relative "anthropic/models/beta/beta_file_document_source"
+require_relative "anthropic/models/beta/beta_file_image_source"
+require_relative "anthropic/models/beta/beta_image_block_param"
+require_relative "anthropic/models/beta/beta_input_json_delta"
+require_relative "anthropic/models/beta/beta_mcp_tool_result_block"
+require_relative "anthropic/models/beta/beta_mcp_tool_use_block"
+require_relative "anthropic/models/beta/beta_mcp_tool_use_block_param"
+require_relative "anthropic/models/beta/beta_message"
+require_relative "anthropic/models/beta/beta_message_delta_usage"
+require_relative "anthropic/models/beta/beta_message_param"
+require_relative "anthropic/models/beta/beta_message_tokens_count"
+require_relative "anthropic/models/beta/beta_metadata"
+require_relative "anthropic/models/beta/beta_model_info"
+require_relative "anthropic/models/beta/beta_plain_text_source"
+require_relative "anthropic/models/beta/beta_raw_content_block_delta"
+require_relative "anthropic/models/beta/beta_raw_content_block_delta_event"
+require_relative "anthropic/models/beta/beta_raw_content_block_start_event"
+require_relative "anthropic/models/beta/beta_raw_content_block_stop_event"
+require_relative "anthropic/models/beta/beta_raw_message_delta_event"
+require_relative "anthropic/models/beta/beta_raw_message_start_event"
+require_relative "anthropic/models/beta/beta_raw_message_stop_event"
+require_relative "anthropic/models/beta/beta_raw_message_stream_event"
+require_relative "anthropic/models/beta/beta_redacted_thinking_block"
+require_relative "anthropic/models/beta/beta_redacted_thinking_block_param"
+require_relative "anthropic/models/beta/beta_request_mcp_server_tool_configuration"
+require_relative "anthropic/models/beta/beta_request_mcp_server_url_definition"
+require_relative "anthropic/models/beta/beta_request_mcp_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_server_tool_usage"
+require_relative "anthropic/models/beta/beta_server_tool_use_block"
+require_relative "anthropic/models/beta/beta_server_tool_use_block_param"
+require_relative "anthropic/models/beta/beta_signature_delta"
+require_relative "anthropic/models/beta/beta_stop_reason"
+require_relative "anthropic/models/beta/beta_text_block"
+require_relative "anthropic/models/beta/beta_text_block_param"
+require_relative "anthropic/models/beta/beta_text_citation"
+require_relative "anthropic/models/beta/beta_text_citation_param"
+require_relative "anthropic/models/beta/beta_text_delta"
+require_relative "anthropic/models/beta/beta_thinking_block"
+require_relative "anthropic/models/beta/beta_thinking_block_param"
+require_relative "anthropic/models/beta/beta_thinking_config_disabled"
+require_relative "anthropic/models/beta/beta_thinking_config_enabled"
+require_relative "anthropic/models/beta/beta_thinking_config_param"
+require_relative "anthropic/models/beta/beta_thinking_delta"
+require_relative "anthropic/models/beta/beta_tool"
+require_relative "anthropic/models/beta/beta_tool_bash_20241022"
+require_relative "anthropic/models/beta/beta_tool_bash_20250124"
+require_relative "anthropic/models/beta/beta_tool_choice"
+require_relative "anthropic/models/beta/beta_tool_choice_any"
+require_relative "anthropic/models/beta/beta_tool_choice_auto"
+require_relative "anthropic/models/beta/beta_tool_choice_none"
+require_relative "anthropic/models/beta/beta_tool_choice_tool"
+require_relative "anthropic/models/beta/beta_tool_computer_use_20241022"
+require_relative "anthropic/models/beta/beta_tool_computer_use_20250124"
+require_relative "anthropic/models/beta/beta_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_tool_text_editor_20241022"
+require_relative "anthropic/models/beta/beta_tool_text_editor_20250124"
+require_relative "anthropic/models/beta/beta_tool_text_editor_20250429"
+require_relative "anthropic/models/beta/beta_tool_union"
+require_relative "anthropic/models/beta/beta_tool_use_block"
+require_relative "anthropic/models/beta/beta_tool_use_block_param"
+require_relative "anthropic/models/beta/beta_url_image_source"
+require_relative "anthropic/models/beta/beta_url_pdf_source"
+require_relative "anthropic/models/beta/beta_usage"
+require_relative "anthropic/models/beta/beta_web_search_result_block"
+require_relative "anthropic/models/beta/beta_web_search_result_block_param"
+require_relative "anthropic/models/beta/beta_web_search_tool_20250305"
+require_relative "anthropic/models/beta/beta_web_search_tool_request_error"
+require_relative "anthropic/models/beta/beta_web_search_tool_result_block"
+require_relative "anthropic/models/beta/beta_web_search_tool_result_block_content"
+require_relative "anthropic/models/beta/beta_web_search_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_web_search_tool_result_block_param_content"
+require_relative "anthropic/models/beta/beta_web_search_tool_result_error"
+require_relative "anthropic/models/beta/beta_web_search_tool_result_error_code"
+require_relative "anthropic/models/beta/deleted_file"
+require_relative "anthropic/models/beta/file_delete_params"
+require_relative "anthropic/models/beta/file_download_params"
+require_relative "anthropic/models/beta/file_list_params"
+require_relative "anthropic/models/beta/file_metadata"
+require_relative "anthropic/models/beta/file_retrieve_metadata_params"
+require_relative "anthropic/models/beta/file_upload_params"
+require_relative "anthropic/models/beta/message_count_tokens_params"
+require_relative "anthropic/models/beta/message_create_params"
+require_relative "anthropic/models/beta/messages/batch_cancel_params"
+require_relative "anthropic/models/beta/messages/batch_create_params"
+require_relative "anthropic/models/beta/messages/batch_delete_params"
+require_relative "anthropic/models/beta/messages/batch_list_params"
+require_relative "anthropic/models/beta/messages/batch_results_params"
+require_relative "anthropic/models/beta/messages/batch_retrieve_params"
+require_relative "anthropic/models/beta/messages/beta_deleted_message_batch"
+require_relative "anthropic/models/beta/messages/beta_message_batch"
+require_relative "anthropic/models/beta/messages/beta_message_batch_canceled_result"
+require_relative "anthropic/models/beta/messages/beta_message_batch_errored_result"
+require_relative "anthropic/models/beta/messages/beta_message_batch_expired_result"
+require_relative "anthropic/models/beta/messages/beta_message_batch_individual_response"
+require_relative "anthropic/models/beta/messages/beta_message_batch_request_counts"
+require_relative "anthropic/models/beta/messages/beta_message_batch_result"
+require_relative "anthropic/models/beta/messages/beta_message_batch_succeeded_result"
+require_relative "anthropic/models/beta/model_list_params"
+require_relative "anthropic/models/beta/model_retrieve_params"
+require_relative "anthropic/models/beta_api_error"
+require_relative "anthropic/models/beta_authentication_error"
+require_relative "anthropic/models/beta_billing_error"
+require_relative "anthropic/models/beta_error"
+require_relative "anthropic/models/beta_error_response"
+require_relative "anthropic/models/beta_gateway_timeout_error"
+require_relative "anthropic/models/beta_invalid_request_error"
+require_relative "anthropic/models/beta_not_found_error"
+require_relative "anthropic/models/beta_overloaded_error"
+require_relative "anthropic/models/beta_permission_error"
+require_relative "anthropic/models/beta_rate_limit_error"
+require_relative "anthropic/models/billing_error"
+require_relative "anthropic/models/cache_control_ephemeral"
+require_relative "anthropic/models/citation_char_location"
+require_relative "anthropic/models/citation_char_location_param"
+require_relative "anthropic/models/citation_content_block_location"
+require_relative "anthropic/models/citation_content_block_location_param"
+require_relative "anthropic/models/citation_page_location"
+require_relative "anthropic/models/citation_page_location_param"
+require_relative "anthropic/models/citations_config_param"
+require_relative "anthropic/models/citations_delta"
+require_relative "anthropic/models/citations_web_search_result_location"
+require_relative "anthropic/models/citation_web_search_result_location_param"
+require_relative "anthropic/models/completion"
+require_relative "anthropic/models/completion_create_params"
+require_relative "anthropic/models/content_block"
+require_relative "anthropic/models/content_block_param"
+require_relative "anthropic/models/content_block_source"
+require_relative "anthropic/models/content_block_source_content"
+require_relative "anthropic/models/document_block_param"
+require_relative "anthropic/models/error_object"
+require_relative "anthropic/models/error_response"
+require_relative "anthropic/models/gateway_timeout_error"
+require_relative "anthropic/models/image_block_param"
+require_relative "anthropic/models/input_json_delta"
+require_relative "anthropic/models/invalid_request_error"
+require_relative "anthropic/models/message"
+require_relative "anthropic/models/message_count_tokens_params"
+require_relative "anthropic/models/message_count_tokens_tool"
+require_relative "anthropic/models/message_create_params"
+require_relative "anthropic/models/message_delta_usage"
+require_relative "anthropic/models/message_param"
+require_relative "anthropic/models/messages/batch_cancel_params"
+require_relative "anthropic/models/messages/batch_create_params"
+require_relative "anthropic/models/messages/batch_delete_params"
+require_relative "anthropic/models/messages/batch_list_params"
+require_relative "anthropic/models/messages/batch_results_params"
+require_relative "anthropic/models/messages/batch_retrieve_params"
+require_relative "anthropic/models/messages/deleted_message_batch"
+require_relative "anthropic/models/messages/message_batch"
+require_relative "anthropic/models/messages/message_batch_canceled_result"
+require_relative "anthropic/models/messages/message_batch_errored_result"
+require_relative "anthropic/models/messages/message_batch_expired_result"
+require_relative "anthropic/models/messages/message_batch_individual_response"
+require_relative "anthropic/models/messages/message_batch_request_counts"
+require_relative "anthropic/models/messages/message_batch_result"
+require_relative "anthropic/models/messages/message_batch_succeeded_result"
+require_relative "anthropic/models/message_tokens_count"
+require_relative "anthropic/models/metadata"
+require_relative "anthropic/models/model"
+require_relative "anthropic/models/model_info"
+require_relative "anthropic/models/model_list_params"
+require_relative "anthropic/models/model_retrieve_params"
+require_relative "anthropic/models/not_found_error"
+require_relative "anthropic/models/overloaded_error"
+require_relative "anthropic/models/permission_error"
+require_relative "anthropic/models/plain_text_source"
+require_relative "anthropic/models/rate_limit_error"
+require_relative "anthropic/models/raw_content_block_delta"
+require_relative "anthropic/models/raw_content_block_delta_event"
+require_relative "anthropic/models/raw_content_block_start_event"
+require_relative "anthropic/models/raw_content_block_stop_event"
+require_relative "anthropic/models/raw_message_delta_event"
+require_relative "anthropic/models/raw_message_start_event"
+require_relative "anthropic/models/raw_message_stop_event"
+require_relative "anthropic/models/raw_message_stream_event"
+require_relative "anthropic/models/redacted_thinking_block"
+require_relative "anthropic/models/redacted_thinking_block_param"
+require_relative "anthropic/models/server_tool_usage"
+require_relative "anthropic/models/server_tool_use_block"
+require_relative "anthropic/models/server_tool_use_block_param"
+require_relative "anthropic/models/signature_delta"
+require_relative "anthropic/models/stop_reason"
+require_relative "anthropic/models/text_block"
+require_relative "anthropic/models/text_block_param"
+require_relative "anthropic/models/text_citation"
+require_relative "anthropic/models/text_citation_param"
+require_relative "anthropic/models/text_delta"
+require_relative "anthropic/models/thinking_block"
+require_relative "anthropic/models/thinking_block_param"
+require_relative "anthropic/models/thinking_config_disabled"
+require_relative "anthropic/models/thinking_config_enabled"
+require_relative "anthropic/models/thinking_config_param"
+require_relative "anthropic/models/thinking_delta"
+require_relative "anthropic/models/tool"
+require_relative "anthropic/models/tool_bash_20250124"
+require_relative "anthropic/models/tool_choice"
+require_relative "anthropic/models/tool_choice_any"
+require_relative "anthropic/models/tool_choice_auto"
+require_relative "anthropic/models/tool_choice_none"
+require_relative "anthropic/models/tool_choice_tool"
+require_relative "anthropic/models/tool_result_block_param"
+require_relative "anthropic/models/tool_text_editor_20250124"
+require_relative "anthropic/models/tool_union"
+require_relative "anthropic/models/tool_use_block"
+require_relative "anthropic/models/tool_use_block_param"
+require_relative "anthropic/models/url_image_source"
+require_relative "anthropic/models/url_pdf_source"
+require_relative "anthropic/models/usage"
+require_relative "anthropic/models/web_search_result_block"
+require_relative "anthropic/models/web_search_result_block_param"
+require_relative "anthropic/models/web_search_tool_20250305"
+require_relative "anthropic/models/web_search_tool_request_error"
+require_relative "anthropic/models/web_search_tool_result_block"
+require_relative "anthropic/models/web_search_tool_result_block_content"
+require_relative "anthropic/models/web_search_tool_result_block_param"
+require_relative "anthropic/models/web_search_tool_result_block_param_content"
+require_relative "anthropic/models/web_search_tool_result_error"
+require_relative "anthropic/models"
+require_relative "anthropic/resources/beta"
+require_relative "anthropic/resources/beta/files"
+require_relative "anthropic/resources/beta/messages"
+require_relative "anthropic/resources/beta/messages/batches"
+require_relative "anthropic/resources/beta/models"
+require_relative "anthropic/resources/completions"
+require_relative "anthropic/resources/messages"
+require_relative "anthropic/resources/messages/batches"
+require_relative "anthropic/resources/models"

data/manifest.yaml

@@ -0,0 +1,15 @@
+dependencies:
+  - English
+  - cgi
+  - date
+  - erb
+  - etc
+  - json
+  - net/http
+  - pathname
+  - rbconfig
+  - securerandom
+  - set
+  - stringio
+  - time
+  - uri

data/rbi/anthropic/bedrock.rbi

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

data/rbi/anthropic/client.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module Anthropic
+  class Client < Anthropic::Internal::Transport::BaseClient
+    DEFAULT_MAX_RETRIES = 2
+
+    DEFAULT_TIMEOUT_IN_SECONDS = T.let(600.0, Float)
+
+    DEFAULT_INITIAL_RETRY_DELAY = T.let(0.5, Float)
+
+    DEFAULT_MAX_RETRY_DELAY = T.let(8.0, Float)
+
+    sig { returns(T.nilable(String)) }
+    attr_reader :api_key
+
+    sig { returns(T.nilable(String)) }
+    attr_reader :auth_token
+
+    sig { returns(Anthropic::Resources::Completions) }
+    attr_reader :completions
+
+    sig { returns(Anthropic::Resources::Messages) }
+    attr_reader :messages
+
+    sig { returns(Anthropic::Resources::Models) }
+    attr_reader :models
+
+    sig { returns(Anthropic::Resources::Beta) }
+    attr_reader :beta
+
+    # @api private
+    sig { override.returns(T::Hash[String, String]) }
+    private def auth_headers
+    end
+
+    # @api private
+    sig { returns(T::Hash[String, String]) }
+    private def api_key_auth
+    end
+
+    # @api private
+    sig { returns(T::Hash[String, String]) }
+    private def bearer_auth
+    end
+
+    # Creates and returns a new client for interacting with the API.
+    sig do
+      params(
+        api_key: T.nilable(String),
+        auth_token: T.nilable(String),
+        base_url: T.nilable(String),
+        max_retries: Integer,
+        timeout: Float,
+        initial_retry_delay: Float,
+        max_retry_delay: Float
+      ).returns(T.attached_class)
+    end
+    def self.new(
+      # Defaults to `ENV["ANTHROPIC_API_KEY"]`
+      api_key: ENV["ANTHROPIC_API_KEY"],
+      # Defaults to `ENV["ANTHROPIC_AUTH_TOKEN"]`
+      auth_token: ENV["ANTHROPIC_AUTH_TOKEN"],
+      # Override the default base URL for the API, e.g.,
+      # `"https://api.example.com/v2/"`. Defaults to `ENV["ANTHROPIC_BASE_URL"]`
+      base_url: ENV["ANTHROPIC_BASE_URL"],
+      # Max number of retries to attempt after a failed retryable request.
+      max_retries: Anthropic::Client::DEFAULT_MAX_RETRIES,
+      timeout: Anthropic::Client::DEFAULT_TIMEOUT_IN_SECONDS,
+      initial_retry_delay: Anthropic::Client::DEFAULT_INITIAL_RETRY_DELAY,
+      max_retry_delay: Anthropic::Client::DEFAULT_MAX_RETRY_DELAY
+    )
+    end
+  end
+end

data/rbi/anthropic/errors.rbi

@@ -0,0 +1,162 @@
+# typed: strong
+
+module Anthropic
+  module Errors
+    class Error < StandardError
+      sig { returns(T.nilable(StandardError)) }
+      attr_accessor :cause
+    end
+
+    class ConversionError < Anthropic::Errors::Error
+    end
+
+    class APIError < Anthropic::Errors::Error
+      sig { returns(URI::Generic) }
+      attr_accessor :url
+
+      sig { returns(T.nilable(Integer)) }
+      attr_accessor :status
+
+      sig { returns(T.nilable(T.anything)) }
+      attr_accessor :body
+
+      # @api private
+      sig do
+        params(
+          url: URI::Generic,
+          status: T.nilable(Integer),
+          body: T.nilable(Object),
+          request: NilClass,
+          response: NilClass,
+          message: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        url:,
+        status: nil,
+        body: nil,
+        request: nil,
+        response: nil,
+        message: nil
+      )
+      end
+    end
+
+    class APIConnectionError < Anthropic::Errors::APIError
+      sig { void }
+      attr_accessor :status
+
+      sig { void }
+      attr_accessor :body
+
+      # @api private
+      sig do
+        params(
+          url: URI::Generic,
+          status: NilClass,
+          body: NilClass,
+          request: NilClass,
+          response: NilClass,
+          message: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        url:,
+        status: nil,
+        body: nil,
+        request: nil,
+        response: nil,
+        message: "Connection error."
+      )
+      end
+    end
+
+    class APITimeoutError < Anthropic::Errors::APIConnectionError
+      # @api private
+      sig do
+        params(
+          url: URI::Generic,
+          status: NilClass,
+          body: NilClass,
+          request: NilClass,
+          response: NilClass,
+          message: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        url:,
+        status: nil,
+        body: nil,
+        request: nil,
+        response: nil,
+        message: "Request timed out."
+      )
+      end
+    end
+
+    class APIStatusError < Anthropic::Errors::APIError
+      # @api private
+      sig do
+        params(
+          url: URI::Generic,
+          status: Integer,
+          body: T.nilable(Object),
+          request: NilClass,
+          response: NilClass,
+          message: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.for(url:, status:, body:, request:, response:, message: nil)
+      end
+
+      sig { returns(Integer) }
+      attr_accessor :status
+
+      # @api private
+      sig do
+        params(
+          url: URI::Generic,
+          status: Integer,
+          body: T.nilable(Object),
+          request: NilClass,
+          response: NilClass,
+          message: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(url:, status:, body:, request:, response:, message: nil)
+      end
+    end
+
+    class BadRequestError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 400
+    end
+
+    class AuthenticationError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 401
+    end
+
+    class PermissionDeniedError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 403
+    end
+
+    class NotFoundError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 404
+    end
+
+    class ConflictError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 409
+    end
+
+    class UnprocessableEntityError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 422
+    end
+
+    class RateLimitError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = 429
+    end
+
+    class InternalServerError < Anthropic::Errors::APIStatusError
+      HTTP_STATUS = T.let((500..), T::Range[Integer])
+    end
+  end
+end