anthropic-sdk-beta 0.1.0.pre.beta.3

data/lib/anthropic/vertex/client.rb

@@ -0,0 +1,210 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Vertex
+    class Client < Anthropic::Client
+      DEFAULT_VERSION = "vertex-2023-10-16"
+
+      # @return [String]
+      attr_reader :region
+
+      # @return [String]
+      attr_reader :project_id
+
+      # @return [Anthropic::Resources::Messages]
+      attr_reader :messages
+
+      # @return [Anthropic::Resources::Beta]
+      attr_reader :beta
+
+      # Creates and returns a new client for interacting with the GCP Vertex API for Anthropic models.
+      #
+      # GCP credentials are resolved according to Application Default Credentials, described at
+      #   https://cloud.google.com/docs/authentication/provide-credentials-adc
+      #
+      # @param region [String, nil] Enforce the GCP Region to use. If unset, the region may be set with the CLOUD_ML_REGION environment variable.
+      #
+      # @param project_id [String, nil] Enforce the GCP Project ID to use. If unset, the project_id may be set with the ANTHROPIC_VERTEX_PROJECT_ID environment variable.
+      #
+      # @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
+      #
+      # @param timeout [Float] The number of seconds to wait for a response before timing out
+      #
+      # @param initial_retry_delay [Float] The number of seconds to wait before retrying a request
+      #
+      # @param max_retry_delay [Float] The maximum number of seconds to wait before retrying a request
+      #
+      def initialize(
+        region: ENV["CLOUD_ML_REGION"],
+        project_id: ENV["ANTHROPIC_VERTEX_PROJECT_ID"],
+        base_url: nil,
+        max_retries: DEFAULT_MAX_RETRIES,
+        timeout: DEFAULT_TIMEOUT_IN_SECONDS,
+        initial_retry_delay: DEFAULT_INITIAL_RETRY_DELAY,
+        max_retry_delay: DEFAULT_MAX_RETRY_DELAY
+      )
+        begin
+          require("googleauth")
+        rescue LoadError
+          raise <<~MSG
+
+            In order to access Anthropic models on Vertex you must require the `googleauth` gem.
+            You can install it by adding the following to your Gemfile:
+
+                gem "googleauth"
+
+            and then running `bundle install`.
+
+            Alternatively, if you are not using Bundler, simply run:
+
+                gem install googleauth
+          MSG
+        end
+
+        if region.to_s.empty?
+          raise ArgumentError,
+                "No region was given. The client should be instantiated with the `region` argument or the `CLOUD_ML_REGION` environment variable should be set."
+        end
+        @region = region
+
+        if project_id.to_s.empty?
+          raise ArgumentError,
+                "No project_id was given and it could not be resolved from credentials. The client should be instantiated with the `project_id` argument or the `ANTHROPIC_VERTEX_PROJECT_ID` environment variable should be set."
+
+        end
+        @project_id = project_id
+
+        base_url ||= ENV.fetch("ANTHROPIC_VERTEX_BASE_URL", "https://#{@region}-aiplatform.googleapis.com/v1")
+
+        super(
+          base_url: base_url,
+          timeout: timeout,
+          max_retries: max_retries,
+          initial_retry_delay: initial_retry_delay,
+          max_retry_delay: max_retry_delay,
+        )
+
+        @messages = Anthropic::Resources::Messages.new(client: self)
+        @beta = Anthropic::Resources::Beta.new(client: self)
+      end
+
+      # @private
+      #
+      # @param req [Hash{Symbol=>Object}] .
+      #
+      #   @option req [Symbol] :method
+      #
+      #   @option req [String, Array<String>] :path
+      #
+      #   @option req [Hash{String=>Array<String>, String, nil}, nil] :query
+      #
+      #   @option req [Hash{String=>String, nil}, nil] :headers
+      #
+      #   @option req [Object, nil] :body
+      #
+      #   @option req [Symbol, nil] :unwrap
+      #
+      #   @option req [Class, nil] :page
+      #
+      #   @option req [Anthropic::Converter, Class, nil] :model
+      #
+      # @param opts [Hash{Symbol=>Object}] .
+      #
+      #   @option opts [String, nil] :idempotency_key
+      #
+      #   @option opts [Hash{String=>Array<String>, String, nil}, nil] :extra_query
+      #
+      #   @option opts [Hash{String=>String, nil}, nil] :extra_headers
+      #
+      #   @option opts [Hash{Symbol=>Object}, nil] :extra_body
+      #
+      #   @option opts [Integer, nil] :max_retries
+      #
+      #   @option opts [Float, nil] :timeout
+      #
+      # @return [Hash{Symbol=>Object}]
+      #
+      private def build_request(req, opts)
+        fit_req_to_vertex_specs!(req)
+
+        request_input = super
+
+        unless request_input[:headers]["Authorization"]
+          authorization = Google::Auth.get_application_default(["https://www.googleapis.com/auth/cloud-platform"])
+          request_input[:headers] = authorization.apply(request_input[:headers])
+        end
+
+        request_input
+      end
+
+      # @private
+      #
+      # Overrides request components for Vertex-specific request-shape requirements.
+      #
+      # @param request_components [Hash{Symbol=>Object}] .
+      #
+      #   @option request_components [Symbol] :method
+      #
+      #   @option request_components [String, Array<String>] :path
+      #
+      #   @option request_components [Hash{String=>Array<String>, String, nil}, nil] :query
+      #
+      #   @option request_components [Hash{String=>String, nil}, nil] :headers
+      #
+      #   @option request_components [Object, nil] :body
+      #
+      #   @option request_components [Symbol, nil] :unwrap
+      #
+      #   @option request_components [Class, nil] :page
+      #
+      #   @option request_components [Anthropic::Converter, Class, nil] :model
+      #
+      # @return [Hash{Symbol=>Object}]
+      def fit_req_to_vertex_specs!(request_components)
+        if (body = request_components[:body]).is_a?(Hash)
+          body[:anthropic_version] ||= DEFAULT_VERSION
+
+          if (anthropic_beta = body.delete(:"anthropic-beta"))
+            request_components[:headers] ||= {}
+            request_components[:headers]["anthropic-beta"] = anthropic_beta.join(",")
+          end
+        end
+
+        if %w[
+          v1/messages
+          v1/messages?beta=true
+        ].include?(request_components[:path]) && request_components[:method] == :post
+
+          unless body.is_a?(Hash)
+            raise Anthropic::Error, "Expected json data to be a hash for post /v1/messages"
+          end
+
+          model = body.delete(:model)
+          specifier = body[:stream] ? "streamRawPredict" : "rawPredict"
+
+          request_components[:path] =
+            "projects/#{@project_id}/locations/#{region}/publishers/anthropic/models/#{model}:#{specifier}"
+
+        end
+
+        if %w[
+          v1/messages/count_tokens
+          v1/messages/count_tokens?beta=true
+        ].include?(request_components[:path]) &&
+           request_components[:method] == :post
+          request_components[:path] =
+            "projects/#{@project_id}/locations/#{region}/publishers/anthropic/models/count-tokens:rawPredict"
+
+        end
+
+        if request_components[:path].start_with?("v1/messages/batches/")
+          raise AnthropicError("The Batch API is not supported in the Vertex client yet")
+        end
+
+        request_components
+      end
+    end
+  end
+end

data/lib/anthropic.rb

@@ -0,0 +1,265 @@
+# frozen_string_literal: true
+
+# Standard libraries.
+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"
+
+# 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/)
+  Warning.warn(
+    <<~WARN
+      \n
+      ⚠️ skipped loading of "anthropic" gem under `tapioca`.
+
+      This message is normal and expected if you are running a `tapioca` command, and does not impact `.rbi` generation.
+      \n
+    WARN
+  )
+  return
+end
+
+# Gems.
+require "connection_pool"
+
+# 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/io_like"
+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/errors"
+require_relative "anthropic/internal/transport/base_client"
+require_relative "anthropic/internal/transport/pooled_net_requester"
+require_relative "anthropic/client"
+require_relative "anthropic/bedrock/client"
+require_relative "anthropic/vertex/client"
+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_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_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_image_block_param"
+require_relative "anthropic/models/beta/beta_input_json_delta"
+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_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_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/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/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/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/resources/beta"
+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/lib/anthropic/bedrock/client.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module Anthropic
+  module Bedrock
+    class Client < Anthropic::Client
+      DEFAULT_VERSION = "bedrock-2023-05-31"
+
+      sig { returns(String) }
+      attr_reader :aws_region
+
+      sig { returns(Anthropic::Resources::Completions) }
+      attr_reader :completions
+
+      sig { returns(Anthropic::Resources::Messages) }
+      attr_reader :messages
+
+      sig { returns(Anthropic::Resources::Beta) }
+      attr_reader :beta
+
+      # @api private
+      sig do
+        override
+          .params(req: Anthropic::Internal::Transport::BaseClient::RequestComponentsShape, opts: Anthropic::Internal::AnyHash)
+          .returns(Anthropic::Internal::Transport::BaseClient::RequestInputShape)
+      end
+      private def build_request(req, opts); end
+
+      sig do
+        params(
+          aws_region: T.nilable(String),
+          aws_access_key: T.nilable(String),
+          aws_secret_key: T.nilable(String),
+          aws_session_token: T.nilable(String),
+          aws_profile: T.nilable(String)
+        ).returns(T::Array[T.anything])
+      end
+      private def resolve_region_and_credentials(
+        aws_region:,
+        aws_access_key:,
+        aws_secret_key:,
+        aws_session_token:,
+        aws_profile:
+      )
+      end
+
+      sig do
+        params(request_components: Anthropic::Internal::Transport::BaseClient::RequestComponentsShape)
+          .returns(Anthropic::Internal::Transport::BaseClient::RequestComponentsShape)
+      end
+      private def fit_req_to_bedrock_specs!(request_components) end
+
+      sig do
+        params(
+          aws_region: T.nilable(String),
+          base_url: T.nilable(String),
+          max_retries: Integer,
+          timeout: Float,
+          initial_retry_delay: Float,
+          max_retry_delay: Float,
+          aws_access_key: T.nilable(String),
+          aws_secret_key: T.nilable(String),
+          aws_session_token: T.nilable(String),
+          aws_profile: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        aws_region: nil,
+        base_url: nil,
+        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,
+        aws_access_key: nil,
+        aws_secret_key: nil,
+        aws_session_token: nil,
+        aws_profile: nil
+      ) end
+    end
+  end
+end

data/rbi/lib/anthropic/client.rbi

@@ -0,0 +1,70 @@
+# 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/"`
+      base_url: nil,
+      # Max number of retries to attempt after a failed retryable request.
+      max_retries: DEFAULT_MAX_RETRIES,
+      timeout: DEFAULT_TIMEOUT_IN_SECONDS,
+      initial_retry_delay: DEFAULT_INITIAL_RETRY_DELAY,
+      max_retry_delay: DEFAULT_MAX_RETRY_DELAY
+    ); end
+  end
+end