anthropic 1.1.1 → 1.3.0

data/rbi/anthropic/helpers/streaming/message_stream.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module Streaming
+      RawMessageEvent =
+        T.type_alias do
+          T.any(
+            Anthropic::Models::RawMessageStartEvent,
+            Anthropic::Models::RawMessageDeltaEvent,
+            Anthropic::Models::RawMessageStopEvent,
+            Anthropic::Models::RawContentBlockStartEvent,
+            Anthropic::Models::RawContentBlockDeltaEvent,
+            Anthropic::Models::RawContentBlockStopEvent
+          )
+        end
+
+      StreamEvent =
+        T.type_alias do
+          T.any(
+            Anthropic::Streaming::RawMessageEvent,
+            Anthropic::Streaming::TextEvent,
+            Anthropic::Streaming::CitationEvent,
+            Anthropic::Streaming::ThinkingEvent,
+            Anthropic::Streaming::SignatureEvent,
+            Anthropic::Streaming::InputJsonEvent,
+            Anthropic::Streaming::MessageStopEvent,
+            Anthropic::Streaming::ContentBlockStopEvent
+          )
+        end
+
+      class MessageStream
+        include Anthropic::Internal::Type::BaseStream
+
+        Message =
+          type_member(:in) { { fixed: Anthropic::Streaming::RawMessageEvent } }
+        Elem =
+          type_member(:out) { { fixed: Anthropic::Streaming::StreamEvent } }
+
+        sig do
+          params(raw_stream: Anthropic::Internal::Stream[RawMessageEvent]).void
+        end
+        def initialize(raw_stream:)
+        end
+
+        sig { void }
+        def until_done
+        end
+
+        sig { returns(T::Enumerator[String]) }
+        def text
+        end
+
+        sig { returns(Anthropic::Models::Message) }
+        def accumulated_message
+        end
+
+        sig { returns(String) }
+        def accumulated_text
+        end
+
+        sig do
+          params(
+            event: Anthropic::Streaming::RawMessageEvent,
+            current_snapshot: T.nilable(Anthropic::Models::Message)
+          ).returns(Anthropic::Models::Message)
+        end
+        private def accumulate_event(event:, current_snapshot:)
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/vertex/client.rbi

@@ -21,16 +21,26 @@ module Anthropic
         # @api private
         sig do
           override
-            .params(req: Anthropic::Internal::Transport::BaseClient::RequestComponents, opts: Anthropic::Internal::AnyHash)
+            .params(
+              req:
+                Anthropic::Internal::Transport::BaseClient::RequestComponents,
+              opts: Anthropic::Internal::AnyHash
+            )
             .returns(Anthropic::Internal::Transport::BaseClient::RequestInput)
         end
-        private def build_request(req, opts); end
+        private def build_request(req, opts)
+        end
 
         sig do
-          params(request_components: Anthropic::Internal::Transport::BaseClient::RequestComponents)
-            .returns(Anthropic::Internal::Transport::BaseClient::RequestComponents)
+          params(
+            request_components:
+              Anthropic::Internal::Transport::BaseClient::RequestComponents
+          ).returns(
+            Anthropic::Internal::Transport::BaseClient::RequestComponents
+          )
+        end
+        private def fit_req_to_vertex_specs!(request_components)
         end
-        private def fit_req_to_vertex_specs!(request_components) end
 
         sig do
           params(
@@ -51,7 +61,8 @@ module Anthropic
           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
     end
   end

data/rbi/anthropic/internal/type/base_stream.rbi

@@ -52,10 +52,17 @@ module Anthropic
             url: URI::Generic,
             status: Integer,
             response: Net::HTTPResponse,
+            unwrap:
+              T.any(
+                Symbol,
+                Integer,
+                T::Array[T.any(Symbol, Integer)],
+                T.proc.params(arg0: T.anything).returns(T.anything)
+              ),
             stream: T::Enumerable[Message]
           ).void
         end
-        def initialize(model:, url:, status:, response:, stream:)
+        def initialize(model:, url:, status:, response:, unwrap:, stream:)
         end
 
         # @api private

data/rbi/anthropic/internal/type/boolean.rbi

@@ -22,6 +22,8 @@ module Anthropic
 
         class << self
           # @api private
+          #
+          # Coerce value to Boolean if possible, otherwise return the original value.
           sig do
             override
               .params(

data/rbi/anthropic/internal/type/converter.rbi

@@ -15,12 +15,14 @@ module Anthropic
         CoerceState =
           T.type_alias do
             {
-              strictness: T.any(T::Boolean, Symbol),
+              translate_names: T::Boolean,
+              strictness: T::Boolean,
               exactness: {
                 yes: Integer,
                 no: Integer,
                 maybe: Integer
               },
+              error: T::Class[StandardError],
               branched: Integer
             }
           end
@@ -88,6 +90,15 @@ module Anthropic
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(translate_names: T::Boolean).returns(
+              Anthropic::Internal::Type::Converter::CoerceState
+            )
+          end
+          def self.new_coerce_state(translate_names: true)
+          end
+
           # @api private
           #
           # Based on `target`, transform `value` into `target`, to the extent possible:
@@ -109,14 +120,11 @@ module Anthropic
           def self.coerce(
             target,
             value,
-            # The `strictness` is one of `true`, `false`, or `:strong`. This informs the
-            # coercion strategy when we have to decide between multiple possible conversion
-            # targets:
+            # The `strictness` is one of `true`, `false`. This informs the coercion strategy
+            # when we have to decide between multiple possible conversion targets:
             #
             # - `true`: the conversion must be exact, with minimum coercion.
             # - `false`: the conversion can be approximate, with some coercion.
-            # - `:strong`: the conversion must be exact, with no coercion, and raise an error
-            #   if not possible.
             #
             # The `exactness` is `Hash` with keys being one of `yes`, `no`, or `maybe`. For
             # any given conversion attempt, the exactness will be updated based on how closely
@@ -128,15 +136,7 @@ module Anthropic
             # - `no`: the value cannot be converted to the target type.
             #
             # See implementation below for more details.
-            state: {
-              strictness: true,
-              exactness: {
-                yes: 0,
-                no: 0,
-                maybe: 0
-              },
-              branched: 0
-            }
+            state: Anthropic::Internal::Type::Converter.new_coerce_state
           )
           end
 

data/rbi/anthropic/internal/type/union.rbi

@@ -78,6 +78,11 @@ module Anthropic
         end
 
         # @api private
+        #
+        # Tries to efficiently coerce the given value to one of the known variants.
+        #
+        # If the value cannot match any of the known variants, the coercion is considered
+        # non-viable and returns the original value.
         sig do
           override
             .params(

data/rbi/anthropic/internal/type/unknown.rbi

@@ -22,6 +22,8 @@ module Anthropic
 
         class << self
           # @api private
+          #
+          # No coercion needed for Unknown type.
           sig do
             override
               .params(

data/rbi/anthropic/internal/util.rbi

@@ -332,6 +332,8 @@ module Anthropic
         end
 
         # @api private
+        #
+        # https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.1.md#special-considerations-for-multipart-content
         sig do
           params(body: T.anything).returns([String, T::Enumerable[String]])
         end

data/rbi/anthropic/models/beta/beta_base64_pdf_block.rbi

@@ -5,134 +5,7 @@ module Anthropic
     BetaBase64PDFBlock = Beta::BetaBase64PDFBlock
 
     module Beta
-      class BetaBase64PDFBlock < Anthropic::Internal::Type::BaseModel
-        OrHash =
-          T.type_alias do
-            T.any(
-              Anthropic::Beta::BetaBase64PDFBlock,
-              Anthropic::Internal::AnyHash
-            )
-          end
-
-        sig do
-          returns(
-            T.any(
-              Anthropic::Beta::BetaBase64PDFSource,
-              Anthropic::Beta::BetaPlainTextSource,
-              Anthropic::Beta::BetaContentBlockSource,
-              Anthropic::Beta::BetaURLPDFSource,
-              Anthropic::Beta::BetaFileDocumentSource
-            )
-          )
-        end
-        attr_accessor :source
-
-        sig { returns(Symbol) }
-        attr_accessor :type
-
-        # Create a cache control breakpoint at this content block.
-        sig { returns(T.nilable(Anthropic::Beta::BetaCacheControlEphemeral)) }
-        attr_reader :cache_control
-
-        sig do
-          params(
-            cache_control:
-              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash)
-          ).void
-        end
-        attr_writer :cache_control
-
-        sig { returns(T.nilable(Anthropic::Beta::BetaCitationsConfigParam)) }
-        attr_reader :citations
-
-        sig do
-          params(
-            citations: Anthropic::Beta::BetaCitationsConfigParam::OrHash
-          ).void
-        end
-        attr_writer :citations
-
-        sig { returns(T.nilable(String)) }
-        attr_accessor :context
-
-        sig { returns(T.nilable(String)) }
-        attr_accessor :title
-
-        sig do
-          params(
-            source:
-              T.any(
-                Anthropic::Beta::BetaBase64PDFSource::OrHash,
-                Anthropic::Beta::BetaPlainTextSource::OrHash,
-                Anthropic::Beta::BetaContentBlockSource::OrHash,
-                Anthropic::Beta::BetaURLPDFSource::OrHash,
-                Anthropic::Beta::BetaFileDocumentSource::OrHash
-              ),
-            cache_control:
-              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
-            citations: Anthropic::Beta::BetaCitationsConfigParam::OrHash,
-            context: T.nilable(String),
-            title: T.nilable(String),
-            type: Symbol
-          ).returns(T.attached_class)
-        end
-        def self.new(
-          source:,
-          # Create a cache control breakpoint at this content block.
-          cache_control: nil,
-          citations: nil,
-          context: nil,
-          title: nil,
-          type: :document
-        )
-        end
-
-        sig do
-          override.returns(
-            {
-              source:
-                T.any(
-                  Anthropic::Beta::BetaBase64PDFSource,
-                  Anthropic::Beta::BetaPlainTextSource,
-                  Anthropic::Beta::BetaContentBlockSource,
-                  Anthropic::Beta::BetaURLPDFSource,
-                  Anthropic::Beta::BetaFileDocumentSource
-                ),
-              type: Symbol,
-              cache_control:
-                T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
-              citations: Anthropic::Beta::BetaCitationsConfigParam,
-              context: T.nilable(String),
-              title: T.nilable(String)
-            }
-          )
-        end
-        def to_hash
-        end
-
-        module Source
-          extend Anthropic::Internal::Type::Union
-
-          Variants =
-            T.type_alias do
-              T.any(
-                Anthropic::Beta::BetaBase64PDFSource,
-                Anthropic::Beta::BetaPlainTextSource,
-                Anthropic::Beta::BetaContentBlockSource,
-                Anthropic::Beta::BetaURLPDFSource,
-                Anthropic::Beta::BetaFileDocumentSource
-              )
-            end
-
-          sig do
-            override.returns(
-              T::Array[Anthropic::Beta::BetaBase64PDFBlock::Source::Variants]
-            )
-          end
-          def self.variants
-          end
-        end
-      end
+      BetaBase64PDFBlock = Anthropic::Models::Beta::BetaRequestDocumentBlock
     end
   end
 end

data/rbi/anthropic/models/beta/beta_citation_search_result_location.rbi

@@ -0,0 +1,78 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaCitationSearchResultLocation = Beta::BetaCitationSearchResultLocation
+
+    module Beta
+      class BetaCitationSearchResultLocation < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaCitationSearchResultLocation,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :cited_text
+
+        sig { returns(Integer) }
+        attr_accessor :end_block_index
+
+        sig { returns(Integer) }
+        attr_accessor :search_result_index
+
+        sig { returns(String) }
+        attr_accessor :source
+
+        sig { returns(Integer) }
+        attr_accessor :start_block_index
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :title
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig do
+          params(
+            cited_text: String,
+            end_block_index: Integer,
+            search_result_index: Integer,
+            source: String,
+            start_block_index: Integer,
+            title: T.nilable(String),
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          cited_text:,
+          end_block_index:,
+          search_result_index:,
+          source:,
+          start_block_index:,
+          title:,
+          type: :search_result_location
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              cited_text: String,
+              end_block_index: Integer,
+              search_result_index: Integer,
+              source: String,
+              start_block_index: Integer,
+              title: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_citation_search_result_location_param.rbi

@@ -0,0 +1,79 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaCitationSearchResultLocationParam =
+      Beta::BetaCitationSearchResultLocationParam
+
+    module Beta
+      class BetaCitationSearchResultLocationParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaCitationSearchResultLocationParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :cited_text
+
+        sig { returns(Integer) }
+        attr_accessor :end_block_index
+
+        sig { returns(Integer) }
+        attr_accessor :search_result_index
+
+        sig { returns(String) }
+        attr_accessor :source
+
+        sig { returns(Integer) }
+        attr_accessor :start_block_index
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :title
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig do
+          params(
+            cited_text: String,
+            end_block_index: Integer,
+            search_result_index: Integer,
+            source: String,
+            start_block_index: Integer,
+            title: T.nilable(String),
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          cited_text:,
+          end_block_index:,
+          search_result_index:,
+          source:,
+          start_block_index:,
+          title:,
+          type: :search_result_location
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              cited_text: String,
+              end_block_index: Integer,
+              search_result_index: Integer,
+              source: String,
+              start_block_index: Integer,
+              title: T.nilable(String),
+              type: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_citations_delta.rbi

@@ -27,7 +27,8 @@ module Anthropic
                 Anthropic::Beta::BetaCitationCharLocation::OrHash,
                 Anthropic::Beta::BetaCitationPageLocation::OrHash,
                 Anthropic::Beta::BetaCitationContentBlockLocation::OrHash,
-                Anthropic::Beta::BetaCitationsWebSearchResultLocation::OrHash
+                Anthropic::Beta::BetaCitationsWebSearchResultLocation::OrHash,
+                Anthropic::Beta::BetaCitationSearchResultLocation::OrHash
               ),
             type: Symbol
           ).returns(T.attached_class)
@@ -55,7 +56,8 @@ module Anthropic
                 Anthropic::Beta::BetaCitationCharLocation,
                 Anthropic::Beta::BetaCitationPageLocation,
                 Anthropic::Beta::BetaCitationContentBlockLocation,
-                Anthropic::Beta::BetaCitationsWebSearchResultLocation
+                Anthropic::Beta::BetaCitationsWebSearchResultLocation,
+                Anthropic::Beta::BetaCitationSearchResultLocation
               )
             end
 

data/rbi/anthropic/models/beta/beta_content_block.rbi

@@ -13,15 +13,15 @@ module Anthropic
           T.type_alias do
             T.any(
               Anthropic::Beta::BetaTextBlock,
+              Anthropic::Beta::BetaThinkingBlock,
+              Anthropic::Beta::BetaRedactedThinkingBlock,
               Anthropic::Beta::BetaToolUseBlock,
               Anthropic::Beta::BetaServerToolUseBlock,
               Anthropic::Beta::BetaWebSearchToolResultBlock,
               Anthropic::Beta::BetaCodeExecutionToolResultBlock,
               Anthropic::Beta::BetaMCPToolUseBlock,
               Anthropic::Beta::BetaMCPToolResultBlock,
-              Anthropic::Beta::BetaContainerUploadBlock,
-              Anthropic::Beta::BetaThinkingBlock,
-              Anthropic::Beta::BetaRedactedThinkingBlock
+              Anthropic::Beta::BetaContainerUploadBlock
             )
           end
 

data/rbi/anthropic/models/beta/beta_content_block_param.rbi

@@ -12,18 +12,19 @@ module Anthropic
         Variants =
           T.type_alias do
             T.any(
+              Anthropic::Beta::BetaTextBlockParam,
+              Anthropic::Beta::BetaImageBlockParam,
+              Anthropic::Beta::BetaRequestDocumentBlock,
+              Anthropic::Beta::BetaSearchResultBlockParam,
+              Anthropic::Beta::BetaThinkingBlockParam,
+              Anthropic::Beta::BetaRedactedThinkingBlockParam,
+              Anthropic::Beta::BetaToolUseBlockParam,
+              Anthropic::Beta::BetaToolResultBlockParam,
               Anthropic::Beta::BetaServerToolUseBlockParam,
               Anthropic::Beta::BetaWebSearchToolResultBlockParam,
               Anthropic::Beta::BetaCodeExecutionToolResultBlockParam,
               Anthropic::Beta::BetaMCPToolUseBlockParam,
               Anthropic::Beta::BetaRequestMCPToolResultBlockParam,
-              Anthropic::Beta::BetaTextBlockParam,
-              Anthropic::Beta::BetaImageBlockParam,
-              Anthropic::Beta::BetaToolUseBlockParam,
-              Anthropic::Beta::BetaToolResultBlockParam,
-              Anthropic::Beta::BetaBase64PDFBlock,
-              Anthropic::Beta::BetaThinkingBlockParam,
-              Anthropic::Beta::BetaRedactedThinkingBlockParam,
               Anthropic::Beta::BetaContainerUploadBlockParam
             )
           end

data/rbi/anthropic/models/beta/beta_message.rbi

@@ -84,6 +84,10 @@ module Anthropic
         # - `"max_tokens"`: we exceeded the requested `max_tokens` or the model's maximum
         # - `"stop_sequence"`: one of your provided custom `stop_sequences` was generated
         # - `"tool_use"`: the model invoked one or more tools
+        # - `"pause_turn"`: we paused a long-running turn. You may provide the response
+        #   back as-is in a subsequent request to let the model continue.
+        # - `"refusal"`: when streaming classifiers intervene to handle potential policy
+        #   violations
         #
         # In non-streaming mode this value is always non-null. In streaming mode, it is
         # null in the `message_start` event and non-null otherwise.
@@ -134,15 +138,15 @@ module Anthropic
               T::Array[
                 T.any(
                   Anthropic::Beta::BetaTextBlock::OrHash,
+                  Anthropic::Beta::BetaThinkingBlock::OrHash,
+                  Anthropic::Beta::BetaRedactedThinkingBlock::OrHash,
                   Anthropic::Beta::BetaToolUseBlock::OrHash,
                   Anthropic::Beta::BetaServerToolUseBlock::OrHash,
                   Anthropic::Beta::BetaWebSearchToolResultBlock::OrHash,
                   Anthropic::Beta::BetaCodeExecutionToolResultBlock::OrHash,
                   Anthropic::Beta::BetaMCPToolUseBlock::OrHash,
                   Anthropic::Beta::BetaMCPToolResultBlock::OrHash,
-                  Anthropic::Beta::BetaContainerUploadBlock::OrHash,
-                  Anthropic::Beta::BetaThinkingBlock::OrHash,
-                  Anthropic::Beta::BetaRedactedThinkingBlock::OrHash
+                  Anthropic::Beta::BetaContainerUploadBlock::OrHash
                 )
               ],
             model: T.any(Anthropic::Model::OrSymbol, String),
@@ -206,6 +210,10 @@ module Anthropic
           # - `"max_tokens"`: we exceeded the requested `max_tokens` or the model's maximum
           # - `"stop_sequence"`: one of your provided custom `stop_sequences` was generated
           # - `"tool_use"`: the model invoked one or more tools
+          # - `"pause_turn"`: we paused a long-running turn. You may provide the response
+          #   back as-is in a subsequent request to let the model continue.
+          # - `"refusal"`: when streaming classifiers intervene to handle potential policy
+          #   violations
           #
           # In non-streaming mode this value is always non-null. In streaming mode, it is
           # null in the `message_start` event and non-null otherwise.

data/rbi/anthropic/models/beta/beta_raw_content_block_start_event.rbi

@@ -33,15 +33,15 @@ module Anthropic
             content_block:
               T.any(
                 Anthropic::Beta::BetaTextBlock::OrHash,
+                Anthropic::Beta::BetaThinkingBlock::OrHash,
+                Anthropic::Beta::BetaRedactedThinkingBlock::OrHash,
                 Anthropic::Beta::BetaToolUseBlock::OrHash,
                 Anthropic::Beta::BetaServerToolUseBlock::OrHash,
                 Anthropic::Beta::BetaWebSearchToolResultBlock::OrHash,
                 Anthropic::Beta::BetaCodeExecutionToolResultBlock::OrHash,
                 Anthropic::Beta::BetaMCPToolUseBlock::OrHash,
                 Anthropic::Beta::BetaMCPToolResultBlock::OrHash,
-                Anthropic::Beta::BetaContainerUploadBlock::OrHash,
-                Anthropic::Beta::BetaThinkingBlock::OrHash,
-                Anthropic::Beta::BetaRedactedThinkingBlock::OrHash
+                Anthropic::Beta::BetaContainerUploadBlock::OrHash
               ),
             index: Integer,
             type: Symbol
@@ -76,15 +76,15 @@ module Anthropic
             T.type_alias do
               T.any(
                 Anthropic::Beta::BetaTextBlock,
+                Anthropic::Beta::BetaThinkingBlock,
+                Anthropic::Beta::BetaRedactedThinkingBlock,
                 Anthropic::Beta::BetaToolUseBlock,
                 Anthropic::Beta::BetaServerToolUseBlock,
                 Anthropic::Beta::BetaWebSearchToolResultBlock,
                 Anthropic::Beta::BetaCodeExecutionToolResultBlock,
                 Anthropic::Beta::BetaMCPToolUseBlock,
                 Anthropic::Beta::BetaMCPToolResultBlock,
-                Anthropic::Beta::BetaContainerUploadBlock,
-                Anthropic::Beta::BetaThinkingBlock,
-                Anthropic::Beta::BetaRedactedThinkingBlock
+                Anthropic::Beta::BetaContainerUploadBlock
               )
             end