anthropic 1.1.1 → 1.9.0

data/rbi/anthropic/helpers/streaming/events.rbi

@@ -0,0 +1,95 @@
+# typed: strong
+# frozen_string_literal: true
+# typed: true
+
+module Anthropic
+  module Helpers
+    module Streaming
+      class TextEvent < Anthropic::Internal::Type::BaseModel
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { returns(String) }
+        attr_accessor :text
+
+        sig { returns(String) }
+        attr_accessor :snapshot
+      end
+
+      class CitationEvent < Anthropic::Internal::Type::BaseModel
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { returns(Anthropic::CitationsDelta::Citation::Variants) }
+        attr_accessor :citation
+
+        sig { returns(T::Array[Anthropic::CitationsDelta::Citation::Variants]) }
+        attr_accessor :snapshot
+      end
+
+      class ThinkingEvent < Anthropic::Internal::Type::BaseModel
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { returns(String) }
+        attr_accessor :thinking
+
+        sig { returns(String) }
+        attr_accessor :snapshot
+      end
+
+      class SignatureEvent < Anthropic::Internal::Type::BaseModel
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { returns(String) }
+        attr_accessor :signature
+      end
+
+      class InputJsonEvent < Anthropic::Internal::Type::BaseModel
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { returns(String) }
+        attr_accessor :partial_json
+
+        sig { returns(T.untyped) }
+        attr_accessor :snapshot
+      end
+
+      class MessageStopEvent < Anthropic::Models::RawMessageStopEvent
+        sig { returns(Anthropic::Models::Message) }
+        attr_accessor :message
+
+        sig do
+          params(message: Anthropic::Models::Message, type: Symbol).returns(
+            T.attached_class
+          )
+        end
+        def self.new(message:, type: :message_stop)
+        end
+      end
+
+      class ContentBlockStopEvent < Anthropic::Models::RawContentBlockStopEvent
+        sig { returns(Integer) }
+        attr_accessor :index
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { returns(Anthropic::Models::ContentBlock) }
+        attr_accessor :content_block
+
+        sig do
+          params(
+            index: Integer,
+            content_block: Anthropic::Models::ContentBlock,
+            type: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(index:, content_block:, type: :content_block_stop)
+        end
+      end
+    end
+  end
+end

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/structured_output.rbi

@@ -0,0 +1,16 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    # Helpers for the structured output API.
+    #
+    # see https://platform.Anthropic.com/docs/guides/structured-outputs
+    # see https://json-schema.org
+    #
+    # Based on the DSL in {Anthropic::Internal::Type}, but currently only support the limited subset of JSON schema types used in structured output APIs.
+    #
+    # Supported types: {NilClass} {String} {Symbol} {Integer} {Float} {Anthropic::Boolean}, {Anthropic::EnumOf}, {Anthropic::UnionOf}, {Anthropic::ArrayOf}, {Anthropic::BaseModel}
+    module InputSchema
+    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/input_schema.rbi

@@ -0,0 +1,12 @@
+# typed: strong
+# frozen_string_literal: true
+
+module Anthropic
+  # Convenience aliases for input schema classes
+  InputSchema = Anthropic::Helpers::InputSchema
+  ArrayOf = Anthropic::Helpers::InputSchema::ArrayOf
+  BaseModel = Anthropic::Helpers::InputSchema::BaseModel
+  Boolean = Anthropic::Helpers::InputSchema::Boolean
+  EnumOf = Anthropic::Helpers::InputSchema::EnumOf
+  UnionOf = Anthropic::Helpers::InputSchema::UnionOf
+end

data/rbi/anthropic/internal/transport/base_client.rbi

@@ -222,7 +222,7 @@ module Anthropic
             send_retry_header: T::Boolean
           ).returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
         end
-        private def send_request(
+        def send_request(
           request,
           redirect_count:,
           retry_count:,

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,69 @@ module Anthropic
           def self.type_info(spec)
           end
 
+          # @api private
+          sig do
+            params(
+              type_info:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Anthropic::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Anthropic::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(Anthropic::Internal::Type::Converter::Input),
+                  Anthropic::Internal::Type::Converter::Input
+                ),
+              spec:
+                T.any(
+                  {
+                    const:
+                      T.nilable(
+                        T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+                      ),
+                    enum:
+                      T.nilable(
+                        T.proc.returns(
+                          Anthropic::Internal::Type::Converter::Input
+                        )
+                      ),
+                    union:
+                      T.nilable(
+                        T.proc.returns(
+                          Anthropic::Internal::Type::Converter::Input
+                        )
+                      )
+                  },
+                  T.proc.returns(Anthropic::Internal::Type::Converter::Input),
+                  Anthropic::Internal::Type::Converter::Input
+                )
+            ).returns(Anthropic::Internal::AnyHash)
+          end
+          def self.meta_info(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 +174,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 +190,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

@@ -16,7 +16,8 @@ module Anthropic
             T::Array[
               [
                 T.nilable(Symbol),
-                T.proc.returns(Anthropic::Internal::Type::Converter::Input)
+                T.proc.returns(Anthropic::Internal::Type::Converter::Input),
+                Anthropic::Internal::AnyHash
               ]
             ]
           )
@@ -25,7 +26,13 @@ module Anthropic
         end
 
         # @api private
-        sig { returns(T::Array[[T.nilable(Symbol), T.anything]]) }
+        sig do
+          returns(
+            T::Array[
+              [T.nilable(Symbol), T.anything, Anthropic::Internal::AnyHash]
+            ]
+          )
+        end
         protected def derefed_variants
         end
 
@@ -78,6 +85,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/anthropic_beta.rbi

@@ -73,6 +73,8 @@ module Anthropic
           :"extended-cache-ttl-2025-04-11",
           Anthropic::AnthropicBeta::TaggedSymbol
         )
+      CONTEXT_1M_2025_08_07 =
+        T.let(:"context-1m-2025-08-07", Anthropic::AnthropicBeta::TaggedSymbol)
     end
   end
 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_bash_code_execution_output_block.rbi

@@ -0,0 +1,33 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaBashCodeExecutionOutputBlock = Beta::BetaBashCodeExecutionOutputBlock
+
+    module Beta
+      class BetaBashCodeExecutionOutputBlock < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaBashCodeExecutionOutputBlock,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :file_id
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { params(file_id: String, type: Symbol).returns(T.attached_class) }
+        def self.new(file_id:, type: :bash_code_execution_output)
+        end
+
+        sig { override.returns({ file_id: String, type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_bash_code_execution_output_block_param.rbi

@@ -0,0 +1,34 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaBashCodeExecutionOutputBlockParam =
+      Beta::BetaBashCodeExecutionOutputBlockParam
+
+    module Beta
+      class BetaBashCodeExecutionOutputBlockParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaBashCodeExecutionOutputBlockParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :file_id
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        sig { params(file_id: String, type: Symbol).returns(T.attached_class) }
+        def self.new(file_id:, type: :bash_code_execution_output)
+        end
+
+        sig { override.returns({ file_id: String, type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end