anthropic 0.4.1 → 1.1.0

data/lib/anthropic/models.rb

@@ -0,0 +1,261 @@
+# frozen_string_literal: true
+
+module Anthropic
+  [Anthropic::Internal::Type::BaseModel, *Anthropic::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, Anthropic::Internal::AnyHash) } }
+  end
+
+  Anthropic::Internal::Util.walk_namespaces(Anthropic::Models).each do |mod|
+    case mod
+    in Anthropic::Internal::Type::Enum | Anthropic::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T.all(T::Boolean, mod) } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { T.all(Integer, mod) } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { T.all(Float, mod) } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { T.all(Symbol, mod) } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  Anthropic::Internal::Util.walk_namespaces(Anthropic::Models)
+                           .lazy
+                           .grep(Anthropic::Internal::Type::Union)
+                           .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  AnthropicBeta = Anthropic::Models::AnthropicBeta
+
+  APIErrorObject = Anthropic::Models::APIErrorObject
+
+  AuthenticationError = Anthropic::Models::AuthenticationError
+
+  Base64ImageSource = Anthropic::Models::Base64ImageSource
+
+  Base64PDFSource = Anthropic::Models::Base64PDFSource
+
+  Beta = Anthropic::Models::Beta
+
+  BetaAPIError = Anthropic::Models::BetaAPIError
+
+  BetaAuthenticationError = Anthropic::Models::BetaAuthenticationError
+
+  BetaBillingError = Anthropic::Models::BetaBillingError
+
+  BetaError = Anthropic::Models::BetaError
+
+  BetaErrorResponse = Anthropic::Models::BetaErrorResponse
+
+  BetaGatewayTimeoutError = Anthropic::Models::BetaGatewayTimeoutError
+
+  BetaInvalidRequestError = Anthropic::Models::BetaInvalidRequestError
+
+  BetaNotFoundError = Anthropic::Models::BetaNotFoundError
+
+  BetaOverloadedError = Anthropic::Models::BetaOverloadedError
+
+  BetaPermissionError = Anthropic::Models::BetaPermissionError
+
+  BetaRateLimitError = Anthropic::Models::BetaRateLimitError
+
+  BillingError = Anthropic::Models::BillingError
+
+  CacheControlEphemeral = Anthropic::Models::CacheControlEphemeral
+
+  CitationCharLocation = Anthropic::Models::CitationCharLocation
+
+  CitationCharLocationParam = Anthropic::Models::CitationCharLocationParam
+
+  CitationContentBlockLocation = Anthropic::Models::CitationContentBlockLocation
+
+  CitationContentBlockLocationParam = Anthropic::Models::CitationContentBlockLocationParam
+
+  CitationPageLocation = Anthropic::Models::CitationPageLocation
+
+  CitationPageLocationParam = Anthropic::Models::CitationPageLocationParam
+
+  CitationsConfigParam = Anthropic::Models::CitationsConfigParam
+
+  CitationsDelta = Anthropic::Models::CitationsDelta
+
+  CitationsWebSearchResultLocation = Anthropic::Models::CitationsWebSearchResultLocation
+
+  CitationWebSearchResultLocationParam = Anthropic::Models::CitationWebSearchResultLocationParam
+
+  Completion = Anthropic::Models::Completion
+
+  CompletionCreateParams = Anthropic::Models::CompletionCreateParams
+
+  ContentBlock = Anthropic::Models::ContentBlock
+
+  ContentBlockParam = Anthropic::Models::ContentBlockParam
+
+  ContentBlockSource = Anthropic::Models::ContentBlockSource
+
+  ContentBlockSourceContent = Anthropic::Models::ContentBlockSourceContent
+
+  DocumentBlockParam = Anthropic::Models::DocumentBlockParam
+
+  ErrorObject = Anthropic::Models::ErrorObject
+
+  ErrorResponse = Anthropic::Models::ErrorResponse
+
+  GatewayTimeoutError = Anthropic::Models::GatewayTimeoutError
+
+  ImageBlockParam = Anthropic::Models::ImageBlockParam
+
+  InputJSONDelta = Anthropic::Models::InputJSONDelta
+
+  InvalidRequestError = Anthropic::Models::InvalidRequestError
+
+  Message = Anthropic::Models::Message
+
+  MessageCountTokensParams = Anthropic::Models::MessageCountTokensParams
+
+  MessageCountTokensTool = Anthropic::Models::MessageCountTokensTool
+
+  MessageCreateParams = Anthropic::Models::MessageCreateParams
+
+  MessageDeltaUsage = Anthropic::Models::MessageDeltaUsage
+
+  MessageParam = Anthropic::Models::MessageParam
+
+  Messages = Anthropic::Models::Messages
+
+  MessageTokensCount = Anthropic::Models::MessageTokensCount
+
+  Metadata = Anthropic::Models::Metadata
+
+  Model = Anthropic::Models::Model
+
+  ModelInfo = Anthropic::Models::ModelInfo
+
+  ModelListParams = Anthropic::Models::ModelListParams
+
+  ModelRetrieveParams = Anthropic::Models::ModelRetrieveParams
+
+  NotFoundError = Anthropic::Models::NotFoundError
+
+  OverloadedError = Anthropic::Models::OverloadedError
+
+  PermissionError = Anthropic::Models::PermissionError
+
+  PlainTextSource = Anthropic::Models::PlainTextSource
+
+  RateLimitError = Anthropic::Models::RateLimitError
+
+  RawContentBlockDelta = Anthropic::Models::RawContentBlockDelta
+
+  RawContentBlockDeltaEvent = Anthropic::Models::RawContentBlockDeltaEvent
+
+  RawContentBlockStartEvent = Anthropic::Models::RawContentBlockStartEvent
+
+  RawContentBlockStopEvent = Anthropic::Models::RawContentBlockStopEvent
+
+  RawMessageDeltaEvent = Anthropic::Models::RawMessageDeltaEvent
+
+  RawMessageStartEvent = Anthropic::Models::RawMessageStartEvent
+
+  RawMessageStopEvent = Anthropic::Models::RawMessageStopEvent
+
+  RawMessageStreamEvent = Anthropic::Models::RawMessageStreamEvent
+
+  RedactedThinkingBlock = Anthropic::Models::RedactedThinkingBlock
+
+  RedactedThinkingBlockParam = Anthropic::Models::RedactedThinkingBlockParam
+
+  ServerToolUsage = Anthropic::Models::ServerToolUsage
+
+  ServerToolUseBlock = Anthropic::Models::ServerToolUseBlock
+
+  ServerToolUseBlockParam = Anthropic::Models::ServerToolUseBlockParam
+
+  SignatureDelta = Anthropic::Models::SignatureDelta
+
+  StopReason = Anthropic::Models::StopReason
+
+  TextBlock = Anthropic::Models::TextBlock
+
+  TextBlockParam = Anthropic::Models::TextBlockParam
+
+  TextCitation = Anthropic::Models::TextCitation
+
+  TextCitationParam = Anthropic::Models::TextCitationParam
+
+  TextDelta = Anthropic::Models::TextDelta
+
+  ThinkingBlock = Anthropic::Models::ThinkingBlock
+
+  ThinkingBlockParam = Anthropic::Models::ThinkingBlockParam
+
+  ThinkingConfigDisabled = Anthropic::Models::ThinkingConfigDisabled
+
+  ThinkingConfigEnabled = Anthropic::Models::ThinkingConfigEnabled
+
+  ThinkingConfigParam = Anthropic::Models::ThinkingConfigParam
+
+  ThinkingDelta = Anthropic::Models::ThinkingDelta
+
+  Tool = Anthropic::Models::Tool
+
+  ToolBash20250124 = Anthropic::Models::ToolBash20250124
+
+  ToolChoice = Anthropic::Models::ToolChoice
+
+  ToolChoiceAny = Anthropic::Models::ToolChoiceAny
+
+  ToolChoiceAuto = Anthropic::Models::ToolChoiceAuto
+
+  ToolChoiceNone = Anthropic::Models::ToolChoiceNone
+
+  ToolChoiceTool = Anthropic::Models::ToolChoiceTool
+
+  ToolResultBlockParam = Anthropic::Models::ToolResultBlockParam
+
+  ToolTextEditor20250124 = Anthropic::Models::ToolTextEditor20250124
+
+  ToolUnion = Anthropic::Models::ToolUnion
+
+  ToolUseBlock = Anthropic::Models::ToolUseBlock
+
+  ToolUseBlockParam = Anthropic::Models::ToolUseBlockParam
+
+  URLImageSource = Anthropic::Models::URLImageSource
+
+  URLPDFSource = Anthropic::Models::URLPDFSource
+
+  Usage = Anthropic::Models::Usage
+
+  WebSearchResultBlock = Anthropic::Models::WebSearchResultBlock
+
+  WebSearchResultBlockParam = Anthropic::Models::WebSearchResultBlockParam
+
+  WebSearchTool20250305 = Anthropic::Models::WebSearchTool20250305
+
+  WebSearchToolRequestError = Anthropic::Models::WebSearchToolRequestError
+
+  WebSearchToolResultBlock = Anthropic::Models::WebSearchToolResultBlock
+
+  WebSearchToolResultBlockContent = Anthropic::Models::WebSearchToolResultBlockContent
+
+  WebSearchToolResultBlockParam = Anthropic::Models::WebSearchToolResultBlockParam
+
+  WebSearchToolResultBlockParamContent = Anthropic::Models::WebSearchToolResultBlockParamContent
+
+  WebSearchToolResultError = Anthropic::Models::WebSearchToolResultError
+end

data/lib/anthropic/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Anthropic
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Anthropic::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [Anthropic::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Anthropic::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Anthropic::Internal::Type::HashOf[Anthropic::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Anthropic::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Anthropic::Internal::Type::HashOf[Anthropic::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Anthropic::RequestOptions, Anthropic::Internal::AnyHash) }
+    end
+  end
+end

data/lib/anthropic/resources/beta/files.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Resources
+    class Beta
+      class Files
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::FileListParams} for more details.
+        #
+        # List Files
+        #
+        # @overload list(after_id: nil, before_id: nil, limit: nil, betas: nil, request_options: {})
+        #
+        # @param after_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
+        #
+        # @param before_id [String] Query param: ID of the object to use as a cursor for pagination. When provided,
+        #
+        # @param limit [Integer] Query param: Number of items to return per page.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Internal::Page<Anthropic::Models::Beta::FileMetadata>]
+        #
+        # @see Anthropic::Models::Beta::FileListParams
+        def list(params = {})
+          parsed, options = Anthropic::Beta::FileListParams.dump_request(params)
+          query_params = [:after_id, :before_id, :limit]
+          @client.request(
+            method: :get,
+            path: "v1/files?beta=true",
+            query: parsed.slice(*query_params),
+            headers: parsed.except(*query_params).transform_keys(betas: "anthropic-beta"),
+            page: Anthropic::Internal::Page,
+            model: Anthropic::Beta::FileMetadata,
+            options: {extra_headers: {"anthropic-beta" => "files-api-2025-04-14"}, **options}
+          )
+        end
+
+        # Delete File
+        #
+        # @overload delete(file_id, betas: nil, request_options: {})
+        #
+        # @param file_id [String] ID of the File.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Models::Beta::DeletedFile]
+        #
+        # @see Anthropic::Models::Beta::FileDeleteParams
+        def delete(file_id, params = {})
+          parsed, options = Anthropic::Beta::FileDeleteParams.dump_request(params)
+          @client.request(
+            method: :delete,
+            path: ["v1/files/%1$s?beta=true", file_id],
+            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            model: Anthropic::Beta::DeletedFile,
+            options: {extra_headers: {"anthropic-beta" => "files-api-2025-04-14"}, **options}
+          )
+        end
+
+        # Download File
+        #
+        # @overload download(file_id, betas: nil, request_options: {})
+        #
+        # @param file_id [String] ID of the File.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [StringIO]
+        #
+        # @see Anthropic::Models::Beta::FileDownloadParams
+        def download(file_id, params = {})
+          parsed, options = Anthropic::Beta::FileDownloadParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/files/%1$s/content?beta=true", file_id],
+            headers: {"accept" => "application/binary", **parsed}.transform_keys(betas: "anthropic-beta"),
+            model: StringIO,
+            options: {extra_headers: {"anthropic-beta" => "files-api-2025-04-14"}, **options}
+          )
+        end
+
+        # Get File Metadata
+        #
+        # @overload retrieve_metadata(file_id, betas: nil, request_options: {})
+        #
+        # @param file_id [String] ID of the File.
+        #
+        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Models::Beta::FileMetadata]
+        #
+        # @see Anthropic::Models::Beta::FileRetrieveMetadataParams
+        def retrieve_metadata(file_id, params = {})
+          parsed, options = Anthropic::Beta::FileRetrieveMetadataParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: ["v1/files/%1$s?beta=true", file_id],
+            headers: parsed.transform_keys(betas: "anthropic-beta"),
+            model: Anthropic::Beta::FileMetadata,
+            options: {extra_headers: {"anthropic-beta" => "files-api-2025-04-14"}, **options}
+          )
+        end
+
+        # Upload File
+        #
+        # @overload upload(file:, betas: nil, request_options: {})
+        #
+        # @param file [Pathname, StringIO, IO, String, Anthropic::FilePart] Body param: The file to upload
+        #
+        # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
+        #
+        # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Anthropic::Models::Beta::FileMetadata]
+        #
+        # @see Anthropic::Models::Beta::FileUploadParams
+        def upload(params)
+          parsed, options = Anthropic::Beta::FileUploadParams.dump_request(params)
+          header_params = {betas: "anthropic-beta"}
+          @client.request(
+            method: :post,
+            path: "v1/files?beta=true",
+            headers: {
+              "content-type" => "multipart/form-data",
+              **parsed.slice(*header_params.keys)
+            }.transform_keys(
+              header_params
+            ),
+            body: parsed.except(*header_params.keys),
+            model: Anthropic::Beta::FileMetadata,
+            options: {extra_headers: {"anthropic-beta" => "files-api-2025-04-14"}, **options}
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Anthropic::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end