anthropic 1.1.1 → 1.2.0

data/lib/anthropic/models/raw_content_block_start_event.rb

@@ -5,7 +5,7 @@ module Anthropic
     class RawContentBlockStartEvent < Anthropic::Internal::Type::BaseModel
       # @!attribute content_block
       #
-      #   @return [Anthropic::Models::TextBlock, Anthropic::Models::ToolUseBlock, Anthropic::Models::ServerToolUseBlock, Anthropic::Models::WebSearchToolResultBlock, Anthropic::Models::ThinkingBlock, Anthropic::Models::RedactedThinkingBlock]
+      #   @return [Anthropic::Models::TextBlock, Anthropic::Models::ThinkingBlock, Anthropic::Models::RedactedThinkingBlock, Anthropic::Models::ToolUseBlock, Anthropic::Models::ServerToolUseBlock, Anthropic::Models::WebSearchToolResultBlock]
       required :content_block, union: -> { Anthropic::RawContentBlockStartEvent::ContentBlock }
 
       # @!attribute index
@@ -19,7 +19,7 @@ module Anthropic
       required :type, const: :content_block_start
 
       # @!method initialize(content_block:, index:, type: :content_block_start)
-      #   @param content_block [Anthropic::Models::TextBlock, Anthropic::Models::ToolUseBlock, Anthropic::Models::ServerToolUseBlock, Anthropic::Models::WebSearchToolResultBlock, Anthropic::Models::ThinkingBlock, Anthropic::Models::RedactedThinkingBlock]
+      #   @param content_block [Anthropic::Models::TextBlock, Anthropic::Models::ThinkingBlock, Anthropic::Models::RedactedThinkingBlock, Anthropic::Models::ToolUseBlock, Anthropic::Models::ServerToolUseBlock, Anthropic::Models::WebSearchToolResultBlock]
       #   @param index [Integer]
       #   @param type [Symbol, :content_block_start]
 
@@ -31,18 +31,18 @@ module Anthropic
 
         variant :text, -> { Anthropic::TextBlock }
 
+        variant :thinking, -> { Anthropic::ThinkingBlock }
+
+        variant :redacted_thinking, -> { Anthropic::RedactedThinkingBlock }
+
         variant :tool_use, -> { Anthropic::ToolUseBlock }
 
         variant :server_tool_use, -> { Anthropic::ServerToolUseBlock }
 
         variant :web_search_tool_result, -> { Anthropic::WebSearchToolResultBlock }
 
-        variant :thinking, -> { Anthropic::ThinkingBlock }
-
-        variant :redacted_thinking, -> { Anthropic::RedactedThinkingBlock }
-
         # @!method self.variants
-        #   @return [Array(Anthropic::Models::TextBlock, Anthropic::Models::ToolUseBlock, Anthropic::Models::ServerToolUseBlock, Anthropic::Models::WebSearchToolResultBlock, Anthropic::Models::ThinkingBlock, Anthropic::Models::RedactedThinkingBlock)]
+        #   @return [Array(Anthropic::Models::TextBlock, Anthropic::Models::ThinkingBlock, Anthropic::Models::RedactedThinkingBlock, Anthropic::Models::ToolUseBlock, Anthropic::Models::ServerToolUseBlock, Anthropic::Models::WebSearchToolResultBlock)]
       end
     end
   end

data/lib/anthropic/models/tool.rb

@@ -68,13 +68,19 @@ module Anthropic
         #   @return [Object, nil]
         optional :properties, Anthropic::Internal::Type::Unknown, nil?: true
 
-        # @!method initialize(properties: nil, type: :object)
+        # @!attribute required
+        #
+        #   @return [Array<String>, nil]
+        optional :required, Anthropic::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!method initialize(properties: nil, required: nil, type: :object)
         #   [JSON schema](https://json-schema.org/draft/2020-12) for this tool's input.
         #
         #   This defines the shape of the `input` that your tool accepts and that the model
         #   will produce.
         #
         #   @param properties [Object, nil]
+        #   @param required [Array<String>, nil]
         #   @param type [Symbol, :object]
       end
 

data/lib/anthropic/models/tool_union.rb

@@ -11,10 +11,43 @@ module Anthropic
 
       variant -> { Anthropic::ToolTextEditor20250124 }
 
+      variant -> { Anthropic::ToolUnion::TextEditor20250429 }
+
       variant -> { Anthropic::WebSearchTool20250305 }
 
+      class TextEditor20250429 < Anthropic::Internal::Type::BaseModel
+        # @!attribute name
+        #   Name of the tool.
+        #
+        #   This is how the tool will be called by the model and in `tool_use` blocks.
+        #
+        #   @return [Symbol, :str_replace_based_edit_tool]
+        required :name, const: :str_replace_based_edit_tool
+
+        # @!attribute type
+        #
+        #   @return [Symbol, :text_editor_20250429]
+        required :type, const: :text_editor_20250429
+
+        # @!attribute cache_control
+        #   Create a cache control breakpoint at this content block.
+        #
+        #   @return [Anthropic::Models::CacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
+
+        # @!method initialize(cache_control: nil, name: :str_replace_based_edit_tool, type: :text_editor_20250429)
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::ToolUnion::TextEditor20250429} for more details.
+        #
+        #   @param cache_control [Anthropic::Models::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
+        #
+        #   @param name [Symbol, :str_replace_based_edit_tool] Name of the tool.
+        #
+        #   @param type [Symbol, :text_editor_20250429]
+      end
+
       # @!method self.variants
-      #   @return [Array(Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305)]
+      #   @return [Array(Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::ToolUnion::TextEditor20250429, Anthropic::Models::WebSearchTool20250305)]
     end
   end
 end

data/lib/anthropic/models/tool_use_block.rb

@@ -23,6 +23,12 @@ module Anthropic
       #   @return [Symbol, :tool_use]
       required :type, const: :tool_use
 
+      # @api private
+      #
+      # Internal buffer for accumulating partial JSON during streaming.
+      # Used by streaming helpers to reconstruct complete JSON input from deltas.
+      optional :json_buf, String
+
       # @!method initialize(id:, input:, name:, type: :tool_use)
       #   @param id [String]
       #   @param input [Object]

data/lib/anthropic/models.rb

@@ -11,16 +11,16 @@ module Anthropic
       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!(:TaggedBoolean) { T.type_alias { T::Boolean } }
           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!(:TaggedInteger) { T.type_alias { Integer } }
           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!(:TaggedFloat) { T.type_alias { Float } }
           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!(:TaggedSymbol) { T.type_alias { Symbol } }
           mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
         else
         end

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

@@ -46,7 +46,7 @@ module Anthropic
         #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
-        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaCodeExecutionTool20250522>] Body param: Definitions of tools that the model may use.
+        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305>] Body param: Definitions of tools that the model may use.
         #
         # @param top_k [Integer] Body param: Only sample from the top K options for each subsequent token.
         #
@@ -62,7 +62,7 @@ module Anthropic
         def create(params)
           parsed, options = Anthropic::Beta::MessageCreateParams.dump_request(params)
           if parsed[:stream]
-            message = "Please use `#stream_raw` for the streaming use case."
+            message = "Please use `#stream` for the streaming use case."
             raise ArgumentError.new(message)
           end
 
@@ -90,7 +90,7 @@ module Anthropic
         end
 
         def stream
-          raise NotImplementedError.new("higher level helpers are coming soon!")
+          Anthropic::Streaming::MessageStream.new(raw_stream: raw_stream)
         end
 
         # See {Anthropic::Resources::Beta::Messages#create} for non-streaming counterpart.
@@ -132,7 +132,7 @@ module Anthropic
         #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
-        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaCodeExecutionTool20250522>] Body param: Definitions of tools that the model may use.
+        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305>] Body param: Definitions of tools that the model may use.
         #
         # @param top_k [Integer] Body param: Only sample from the top K options for each subsequent token.
         #
@@ -192,7 +192,7 @@ module Anthropic
         #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
-        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaCodeExecutionTool20250522>] Body param: Definitions of tools that the model may use.
+        # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaWebSearchTool20250305>] Body param: Definitions of tools that the model may use.
         #
         # @param betas [Array<String, Symbol, Anthropic::Models::AnthropicBeta>] Header param: Optional header to specify the beta version(s) you want to use.
         #

data/lib/anthropic/resources/messages.rb

@@ -6,7 +6,7 @@ module Anthropic
       # @return [Anthropic::Resources::Messages::Batches]
       attr_reader :batches
 
-      # See {Anthropic::Resources::Messages#stream_raw} for streaming counterpart.
+      # See {Anthropic::Resources::Messages#stream} for streaming counterpart.
       #
       # Some parameter documentations has been truncated, see
       # {Anthropic::Models::MessageCreateParams} for more details.
@@ -41,7 +41,7 @@ module Anthropic
       #
       # @param tool_choice [Anthropic::Models::ToolChoiceAuto, Anthropic::Models::ToolChoiceAny, Anthropic::Models::ToolChoiceTool, Anthropic::Models::ToolChoiceNone] How the model should use the provided tools. The model can use a specific tool,
       #
-      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
+      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::ToolUnion::TextEditor20250429, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
       #
       # @param top_k [Integer] Only sample from the top K options for each subsequent token.
       #
@@ -55,7 +55,7 @@ module Anthropic
       def create(params)
         parsed, options = Anthropic::MessageCreateParams.dump_request(params)
         if parsed[:stream]
-          message = "Please use `#stream_raw` for the streaming use case."
+          message = "Please use `#stream` for the streaming use case."
           raise ArgumentError.new(message)
         end
 
@@ -80,8 +80,69 @@ module Anthropic
         )
       end
 
-      def stream
-        raise NotImplementedError.new("higher level helpers are coming soon!")
+      # See {Anthropic::Resources::Messages#create} for non-streaming counterpart.
+      #
+      # Some parameter documentations has been truncated, see
+      # {Anthropic::Models::MessageCreateParams} for more details.
+      #
+      # Send a structured list of input messages with text and/or image content, and the
+      # model will generate the next message in the conversation with streaming.
+      #
+      # The Messages API can be used for either single queries or stateless multi-turn
+      # conversations.
+      #
+      # Learn more about the Messages API in our [user guide](/en/docs/initial-setup)
+      #
+      # @overload stream(max_tokens:, messages:, model:, metadata: nil, service_tier: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, request_options: {})
+      #
+      # @param max_tokens [Integer] The maximum number of tokens to generate before stopping.
+      #
+      # @param messages [Array<Anthropic::Models::MessageParam>] Input messages.
+      #
+      # @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
+      #
+      # @param metadata [Anthropic::Models::Metadata] An object describing metadata about the request.
+      #
+      # @param service_tier [Symbol, Anthropic::Models::MessageCreateParams::ServiceTier] Determines whether to use priority capacity (if available) or standard capacity
+      #
+      # @param stop_sequences [Array<String>] Custom text sequences that will cause the model to stop generating.
+      #
+      # @param system_ [String, Array<Anthropic::Models::TextBlockParam>] System prompt.
+      #
+      # @param temperature [Float] Amount of randomness injected into the response.
+      #
+      # @param thinking [Anthropic::Models::ThinkingConfigEnabled, Anthropic::Models::ThinkingConfigDisabled] Configuration for enabling Claude's extended thinking.
+      #
+      # @param tool_choice [Anthropic::Models::ToolChoiceAuto, Anthropic::Models::ToolChoiceAny, Anthropic::Models::ToolChoiceTool, Anthropic::Models::ToolChoiceNone] How the model should use the provided tools. The model can use a specific tool,
+      #
+      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
+      #
+      # @param top_k [Integer] Only sample from the top K options for each subsequent token.
+      #
+      # @param top_p [Float] Use nucleus sampling.
+      #
+      # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Anthropic::Streaming::MessageStream]
+      #
+      # @see Anthropic::Models::MessageCreateParams
+      def stream(params)
+        parsed, options = Anthropic::Models::MessageCreateParams.dump_request(params)
+        unless parsed.fetch(:stream, true)
+          message = "Please use `#create` for the non-streaming use case."
+          raise ArgumentError.new(message)
+        end
+        parsed.store(:stream, true)
+        raw_stream = @client.request(
+          method: :post,
+          path: "v1/messages",
+          headers: {"accept" => "text/event-stream"},
+          body: parsed,
+          stream: Anthropic::Internal::Stream,
+          model: Anthropic::Models::RawMessageStreamEvent,
+          options: options
+        )
+        Anthropic::Streaming::MessageStream.new(raw_stream: raw_stream)
       end
 
       # See {Anthropic::Resources::Messages#create} for non-streaming counterpart.
@@ -119,7 +180,7 @@ module Anthropic
       #
       # @param tool_choice [Anthropic::Models::ToolChoiceAuto, Anthropic::Models::ToolChoiceAny, Anthropic::Models::ToolChoiceTool, Anthropic::Models::ToolChoiceNone] How the model should use the provided tools. The model can use a specific tool,
       #
-      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
+      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::ToolUnion::TextEditor20250429, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
       #
       # @param top_k [Integer] Only sample from the top K options for each subsequent token.
       #
@@ -171,7 +232,7 @@ module Anthropic
       #
       # @param tool_choice [Anthropic::Models::ToolChoiceAuto, Anthropic::Models::ToolChoiceAny, Anthropic::Models::ToolChoiceTool, Anthropic::Models::ToolChoiceNone] How the model should use the provided tools. The model can use a specific tool,
       #
-      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
+      # @param tools [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::MessageCountTokensTool::TextEditor20250429, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
       #
       # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/anthropic/streaming.rb

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

data/lib/anthropic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Anthropic
-  VERSION = "1.1.1"
+  VERSION = "1.2.0"
 end

data/lib/anthropic.rb

@@ -58,6 +58,7 @@ require_relative "anthropic/vertex"
 require_relative "anthropic/internal/stream"
 require_relative "anthropic/internal/jsonl_stream"
 require_relative "anthropic/internal/page"
+require_relative "anthropic/models/beta/beta_request_document_block"
 require_relative "anthropic/models/anthropic_beta"
 require_relative "anthropic/models/api_error_object"
 require_relative "anthropic/models/authentication_error"
@@ -76,6 +77,8 @@ 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_citation_search_result_location"
+require_relative "anthropic/models/beta/beta_citation_search_result_location_param"
 require_relative "anthropic/models/beta/beta_citations_web_search_result_location"
 require_relative "anthropic/models/beta/beta_citation_web_search_result_location_param"
 require_relative "anthropic/models/beta/beta_code_execution_output_block"
@@ -124,6 +127,7 @@ require_relative "anthropic/models/beta/beta_redacted_thinking_block_param"
 require_relative "anthropic/models/beta/beta_request_mcp_server_tool_configuration"
 require_relative "anthropic/models/beta/beta_request_mcp_server_url_definition"
 require_relative "anthropic/models/beta/beta_request_mcp_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_search_result_block_param"
 require_relative "anthropic/models/beta/beta_server_tool_usage"
 require_relative "anthropic/models/beta/beta_server_tool_use_block"
 require_relative "anthropic/models/beta/beta_server_tool_use_block_param"
@@ -314,6 +318,10 @@ require_relative "anthropic/models/web_search_tool_result_block_content"
 require_relative "anthropic/models/web_search_tool_result_block_param"
 require_relative "anthropic/models/web_search_tool_result_block_param_content"
 require_relative "anthropic/models/web_search_tool_result_error"
+require_relative "anthropic/helpers/streaming/events"
+require_relative "anthropic/helpers/streaming/message_stream"
+require_relative "anthropic/helpers/streaming"
+require_relative "anthropic/streaming"
 require_relative "anthropic/models"
 require_relative "anthropic/resources/beta"
 require_relative "anthropic/resources/beta/files"

data/rbi/anthropic/errors.rbi

@@ -8,6 +8,22 @@ module Anthropic
     end
 
     class ConversionError < Anthropic::Errors::Error
+      sig { returns(T.nilable(StandardError)) }
+      def cause
+      end
+
+      # @api private
+      sig do
+        params(
+          on: T::Class[StandardError],
+          method: Symbol,
+          target: T.anything,
+          value: T.anything,
+          cause: T.nilable(StandardError)
+        ).returns(T.attached_class)
+      end
+      def self.new(on:, method:, target:, value:, cause: nil)
+      end
     end
 
     class APIError < Anthropic::Errors::Error

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

@@ -0,0 +1,85 @@
+# 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 { params(message: Anthropic::Models::Message, type: Symbol).returns(T.attached_class) }
+        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 { params(index: Integer, content_block: Anthropic::Models::ContentBlock, type: Symbol).returns(T.attached_class) }
+        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,59 @@
+# 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) do
+            {fixed: Anthropic::Streaming::RawMessageEvent}
+          end
+        Elem = type_member(:out) { {fixed: Anthropic::Streaming::StreamEvent} }
+
+        sig { params(raw_stream: Anthropic::Internal::Stream[RawMessageEvent]).void }
+        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 { params(event: Anthropic::Streaming::RawMessageEvent, current_snapshot: T.nilable(Anthropic::Models::Message)).returns(Anthropic::Models::Message) }
+        private def accumulate_event(event:, current_snapshot:); 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