anthropic 1.1.0 → 1.2.0

data/lib/anthropic/models/message_create_params.rb

@@ -109,7 +109,7 @@ module Anthropic
       #   the top-level `system` parameter — there is no `"system"` role for input
       #   messages in the Messages API.
       #
-      #   There is a limit of 100000 messages in a single request.
+      #   There is a limit of 100,000 messages in a single request.
       #
       #   @return [Array<Anthropic::Models::MessageParam>]
       required :messages, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::MessageParam] }
@@ -204,6 +204,12 @@ module Anthropic
       #   those tools using the tool input generated by the model and then optionally
       #   return results back to the model using `tool_result` content blocks.
       #
+      #   There are two types of tools: **client tools** and **server tools**. The
+      #   behavior described below applies to client tools. For
+      #   [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+      #   see their individual documentation as each has its own behavior (e.g., the
+      #   [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+      #
       #   Each tool definition includes:
       #
       #   - `name`: Name of the tool.
@@ -267,7 +273,7 @@ module Anthropic
       #
       #   See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
       #
-      #   @return [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305>, nil]
+      #   @return [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::ToolUnion::TextEditor20250429, Anthropic::Models::WebSearchTool20250305>, nil]
       optional :tools, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::ToolUnion] }
 
       # @!attribute top_k
@@ -320,7 +326,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.
       #

data/lib/anthropic/models/message_param.rb

@@ -5,7 +5,7 @@ module Anthropic
     class MessageParam < Anthropic::Internal::Type::BaseModel
       # @!attribute content
       #
-      #   @return [String, Array<Anthropic::Models::ServerToolUseBlockParam, Anthropic::Models::WebSearchToolResultBlockParam, Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::ToolUseBlockParam, Anthropic::Models::ToolResultBlockParam, Anthropic::Models::DocumentBlockParam, Anthropic::Models::ThinkingBlockParam, Anthropic::Models::RedactedThinkingBlockParam>]
+      #   @return [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::DocumentBlockParam, Anthropic::Models::ThinkingBlockParam, Anthropic::Models::RedactedThinkingBlockParam, Anthropic::Models::ToolUseBlockParam, Anthropic::Models::ToolResultBlockParam, Anthropic::Models::ServerToolUseBlockParam, Anthropic::Models::WebSearchToolResultBlockParam>]
       required :content, union: -> { Anthropic::MessageParam::Content }
 
       # @!attribute role
@@ -14,7 +14,7 @@ module Anthropic
       required :role, enum: -> { Anthropic::MessageParam::Role }
 
       # @!method initialize(content:, role:)
-      #   @param content [String, Array<Anthropic::Models::ServerToolUseBlockParam, Anthropic::Models::WebSearchToolResultBlockParam, Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::ToolUseBlockParam, Anthropic::Models::ToolResultBlockParam, Anthropic::Models::DocumentBlockParam, Anthropic::Models::ThinkingBlockParam, Anthropic::Models::RedactedThinkingBlockParam>]
+      #   @param content [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::DocumentBlockParam, Anthropic::Models::ThinkingBlockParam, Anthropic::Models::RedactedThinkingBlockParam, Anthropic::Models::ToolUseBlockParam, Anthropic::Models::ToolResultBlockParam, Anthropic::Models::ServerToolUseBlockParam, Anthropic::Models::WebSearchToolResultBlockParam>]
       #   @param role [Symbol, Anthropic::Models::MessageParam::Role]
 
       # @see Anthropic::Models::MessageParam#content
@@ -26,7 +26,7 @@ module Anthropic
         variant -> { Anthropic::Models::MessageParam::Content::ContentBlockParamArray }
 
         # @!method self.variants
-        #   @return [Array(String, Array<Anthropic::Models::ServerToolUseBlockParam, Anthropic::Models::WebSearchToolResultBlockParam, Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::ToolUseBlockParam, Anthropic::Models::ToolResultBlockParam, Anthropic::Models::DocumentBlockParam, Anthropic::Models::ThinkingBlockParam, Anthropic::Models::RedactedThinkingBlockParam>)]
+        #   @return [Array(String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::DocumentBlockParam, Anthropic::Models::ThinkingBlockParam, Anthropic::Models::RedactedThinkingBlockParam, Anthropic::Models::ToolUseBlockParam, Anthropic::Models::ToolResultBlockParam, Anthropic::Models::ServerToolUseBlockParam, Anthropic::Models::WebSearchToolResultBlockParam>)]
 
         # @type [Anthropic::Internal::Type::Converter]
         ContentBlockParamArray = Anthropic::Internal::Type::ArrayOf[union: -> {

data/lib/anthropic/models/messages/batch_create_params.rb

@@ -153,7 +153,7 @@ module Anthropic
             #   the top-level `system` parameter — there is no `"system"` role for input
             #   messages in the Messages API.
             #
-            #   There is a limit of 100000 messages in a single request.
+            #   There is a limit of 100,000 messages in a single request.
             #
             #   @return [Array<Anthropic::Models::MessageParam>]
             required :messages, -> { Anthropic::Internal::Type::ArrayOf[Anthropic::MessageParam] }
@@ -262,6 +262,12 @@ module Anthropic
             #   those tools using the tool input generated by the model and then optionally
             #   return results back to the model using `tool_result` content blocks.
             #
+            #   There are two types of tools: **client tools** and **server tools**. The
+            #   behavior described below applies to client tools. For
+            #   [server tools](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+            #   see their individual documentation as each has its own behavior (e.g., the
+            #   [web search tool](https://docs.anthropic.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+            #
             #   Each tool definition includes:
             #
             #   - `name`: Name of the tool.
@@ -325,7 +331,7 @@ module Anthropic
             #
             #   See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
             #
-            #   @return [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::WebSearchTool20250305>, nil]
+            #   @return [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::ToolUnion::TextEditor20250429, Anthropic::Models::WebSearchTool20250305>, nil]
             optional :tools, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::ToolUnion] }
 
             # @!attribute top_k
@@ -386,7 +392,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.
             #

data/lib/anthropic/models/model.rb

@@ -96,9 +96,15 @@ module Anthropic
       CLAUDE_4_OPUS_20250514 = :"claude-4-opus-20250514"
 
       # Excels at writing and complex tasks
+      # @deprecated Will reach end-of-life on January 5th, 2026. Please migrate to a newer model.
+      # Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more
+      # information.
       CLAUDE_3_OPUS_LATEST = :"claude-3-opus-latest"
 
       # Excels at writing and complex tasks
+      # @deprecated Will reach end-of-life on January 5th, 2026. Please migrate to a newer model.
+      # Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more
+      # information.
       CLAUDE_3_OPUS_20240229 = :"claude-3-opus-20240229"
 
       # Balance of speed and intelligence

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.0"
+  VERSION = "1.2.0"
 end

data/lib/anthropic.rb

@@ -20,7 +20,9 @@ require "uri"
 
 # We already ship the preferred sorbet manifests in the package itself.
 # `tapioca` currently does not offer us a way to opt out of unnecessary compilation.
-if Object.const_defined?(:Tapioca) && caller.chain([$PROGRAM_NAME]).chain(ARGV).grep(/tapioca/)
+if Object.const_defined?(:Tapioca) &&
+   caller.chain([$PROGRAM_NAME]).chain(ARGV).any?(/tapioca/) &&
+   ARGV.none?(/dsl/)
   return
 end
 
@@ -56,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"
@@ -74,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"
@@ -122,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"
@@ -312,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