anthropic 1.13.0 → 1.15.0

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

@@ -183,6 +183,12 @@ module Anthropic
               #   @return [Anthropic::Models::Beta::BetaMetadata, nil]
               optional :metadata, -> { Anthropic::Beta::BetaMetadata }
 
+              # @!attribute output_format
+              #   A schema to specify Claude's output format in responses.
+              #
+              #   @return [Anthropic::Models::Beta::BetaJSONOutputFormat, nil]
+              optional :output_format, -> { Anthropic::Beta::BetaJSONOutputFormat }, nil?: true
+
               # @!attribute service_tier
               #   Determines whether to use priority capacity (if available) or standard capacity
               #   for this request.
@@ -368,7 +374,7 @@ module Anthropic
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_tokens:, messages:, model:, container: nil, context_management: nil, mcp_servers: nil, metadata: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil)
+              # @!method initialize(max_tokens:, messages:, model:, container: nil, context_management: nil, mcp_servers: nil, metadata: nil, output_format: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params} for more
               #   details.
@@ -392,6 +398,8 @@ module Anthropic
               #
               #   @param metadata [Anthropic::Models::Beta::BetaMetadata] An object describing metadata about the request.
               #
+              #   @param output_format [Anthropic::Models::Beta::BetaJSONOutputFormat, nil]
+              #
               #   @param service_tier [Symbol, Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params::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.

data/lib/anthropic/models/tool_use_block.rb

@@ -23,18 +23,18 @@ 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
-
       response_only do
         # @api public
         #
         # Parsed input data coerced to the tool's input schema model.
         # Only present when tools are defined using the InputSchema DSL.
         optional :parsed, Anthropic::Internal::Type::Unknown
+
+        # @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
       end
 
       # @!method initialize(id:, input:, name:, type: :tool_use)

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

@@ -15,7 +15,7 @@ module Anthropic
           # can take up to 24 hours to complete.
           #
           # Learn more about the Message Batches API in our
-          # [user guide](/en/docs/build-with-claude/batch-processing)
+          # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
           #
           # @overload create(requests:, betas: nil, request_options: {})
           #
@@ -46,7 +46,7 @@ module Anthropic
           # `results_url` field in the response.
           #
           # Learn more about the Message Batches API in our
-          # [user guide](/en/docs/build-with-claude/batch-processing)
+          # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
           #
           # @overload retrieve(message_batch_id, betas: nil, request_options: {})
           #
@@ -77,7 +77,7 @@ module Anthropic
           # returned first.
           #
           # Learn more about the Message Batches API in our
-          # [user guide](/en/docs/build-with-claude/batch-processing)
+          # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
           #
           # @overload list(after_id: nil, before_id: nil, limit: nil, betas: nil, request_options: {})
           #
@@ -114,7 +114,7 @@ module Anthropic
           # like to delete an in-progress batch, you must first cancel it.
           #
           # Learn more about the Message Batches API in our
-          # [user guide](/en/docs/build-with-claude/batch-processing)
+          # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
           #
           # @overload delete(message_batch_id, betas: nil, request_options: {})
           #
@@ -149,7 +149,7 @@ module Anthropic
           # non-interruptible.
           #
           # Learn more about the Message Batches API in our
-          # [user guide](/en/docs/build-with-claude/batch-processing)
+          # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
           #
           # @overload cancel(message_batch_id, betas: nil, request_options: {})
           #
@@ -180,7 +180,7 @@ module Anthropic
           # requests. Use the `custom_id` field to match results to requests.
           #
           # Learn more about the Message Batches API in our
-          # [user guide](/en/docs/build-with-claude/batch-processing)
+          # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
           #
           # @overload results_streaming(message_batch_id, betas: nil, request_options: {})
           #

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

@@ -7,6 +7,13 @@ module Anthropic
         # @return [Anthropic::Resources::Beta::Messages::Batches]
         attr_reader :batches
 
+        # @param params [Anthropic::Models::Beta::MessageCreateParams]
+        #
+        # @return [Anthropic::Helpers::Tools::Runner]
+        def tool_runner(params)
+          Anthropic::Helpers::Tools::Runner.new(@client, params:)
+        end
+
         # See {Anthropic::Resources::Beta::Messages#stream_raw} for streaming counterpart.
         #
         # Some parameter documentations has been truncated, see
@@ -18,9 +25,10 @@ module Anthropic
         # 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)
+        # Learn more about the Messages API in our
+        # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload create(max_tokens:, messages:, model:, container: nil, context_management: nil, mcp_servers: nil, 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, betas: nil, request_options: {})
+        # @overload create(max_tokens:, messages:, model:, container: nil, context_management: nil, mcp_servers: nil, metadata: nil, output_format: nil, service_tier: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -36,6 +44,8 @@ module Anthropic
         #
         # @param metadata [Anthropic::Models::Beta::BetaMetadata] Body param: An object describing metadata about the request.
         #
+        # @param output_format [Anthropic::Models::Beta::BetaJSONOutputFormat, nil] Body param:
+        #
         # @param service_tier [Symbol, Anthropic::Models::Beta::MessageCreateParams::ServiceTier] Body param: Determines whether to use priority capacity (if available) or standa
         #
         # @param stop_sequences [Array<String>] Body param: Custom text sequences that will cause the model to stop generating.
@@ -68,8 +78,12 @@ module Anthropic
             raise ArgumentError.new(message)
           end
 
+          tools, models = Anthropic::Helpers::Messages.distill_input_schema_models!(parsed, strict: nil)
+
+          unwrap = ->(raw) { Anthropic::Helpers::Messages.parse_input_schemas!(raw, tools:, models:) }
+
           if options.empty? && @client.timeout == Anthropic::Client::DEFAULT_TIMEOUT_IN_SECONDS
-            model = parsed[:model].to_sym
+            model = parsed[:model]&.to_sym
             max_tokens = parsed[:max_tokens].to_i
             timeout = @client.calculate_nonstreaming_timeout(
               max_tokens,
@@ -87,6 +101,7 @@ module Anthropic
             headers: parsed.slice(*header_params.keys).transform_keys(header_params),
             body: parsed.except(*header_params.keys),
             model: Anthropic::Beta::BetaMessage,
+            unwrap: unwrap,
             options: options
           )
         end
@@ -102,9 +117,10 @@ module Anthropic
         # 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)
+        # Learn more about the Messages API in our
+        # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload stream_raw(max_tokens:, messages:, model:, container: nil, context_management: nil, mcp_servers: nil, 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, betas: nil, request_options: {})
+        # @overload stream_raw(max_tokens:, messages:, model:, container: nil, context_management: nil, mcp_servers: nil, metadata: nil, output_format: nil, service_tier: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -120,6 +136,8 @@ module Anthropic
         #
         # @param metadata [Anthropic::Models::Beta::BetaMetadata] Body param: An object describing metadata about the request.
         #
+        # @param output_format [Anthropic::Models::Beta::BetaJSONOutputFormat, nil] Body param:
+        #
         # @param service_tier [Symbol, Anthropic::Models::Beta::MessageCreateParams::ServiceTier] Body param: Determines whether to use priority capacity (if available) or standa
         #
         # @param stop_sequences [Array<String>] Body param: Custom text sequences that will cause the model to stop generating.
@@ -152,16 +170,22 @@ module Anthropic
             raise ArgumentError.new(message)
           end
           parsed.store(:stream, true)
+          tools, models = Anthropic::Helpers::Messages.distill_input_schema_models!(parsed, strict: nil)
+
+          header_params = {betas: "anthropic-beta"}
           raw_stream = @client.request(
             method: :post,
             path: "v1/messages?beta=true",
-            headers: {"accept" => "text/event-stream"},
-            body: parsed,
+            headers: {
+              "accept" => "text/event-stream",
+              **parsed.slice(*header_params.keys)
+            }.transform_keys(header_params),
+            body: parsed.except(*header_params.keys),
             stream: Anthropic::Internal::Stream,
             model: Anthropic::Beta::BetaRawMessageStreamEvent,
-            options: options
+            options: {timeout: 600, **options}
           )
-          Anthropic::Streaming::MessageStream.new(raw_stream: raw_stream)
+          Anthropic::Streaming::MessageStream.new(raw_stream:, tools:, models:)
         end
 
         # See {Anthropic::Resources::Beta::Messages#create} for non-streaming counterpart.
@@ -247,9 +271,9 @@ module Anthropic
         # including tools, images, and documents, without creating it.
         #
         # Learn more about token counting in our
-        # [user guide](/en/docs/build-with-claude/token-counting)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
         #
-        # @overload count_tokens(messages:, model:, context_management: nil, mcp_servers: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
+        # @overload count_tokens(messages:, model:, context_management: nil, mcp_servers: nil, output_format: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
         #
         # @param messages [Array<Anthropic::Models::Beta::BetaMessageParam>] Body param: Input messages.
         #
@@ -259,6 +283,8 @@ module Anthropic
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request
         #
+        # @param output_format [Anthropic::Models::Beta::BetaJSONOutputFormat, nil] Body param:
+        #
         # @param system_ [String, Array<Anthropic::Models::Beta::BetaTextBlockParam>] Body param: System prompt.
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled] Body param: Configuration for enabling Claude's extended thinking.

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

@@ -14,7 +14,7 @@ module Anthropic
         # can take up to 24 hours to complete.
         #
         # Learn more about the Message Batches API in our
-        # [user guide](/en/docs/build-with-claude/batch-processing)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
         #
         # @overload create(requests:, request_options: {})
         #
@@ -41,7 +41,7 @@ module Anthropic
         # `results_url` field in the response.
         #
         # Learn more about the Message Batches API in our
-        # [user guide](/en/docs/build-with-claude/batch-processing)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
         #
         # @overload retrieve(message_batch_id, request_options: {})
         #
@@ -68,7 +68,7 @@ module Anthropic
         # returned first.
         #
         # Learn more about the Message Batches API in our
-        # [user guide](/en/docs/build-with-claude/batch-processing)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
         #
         # @overload list(after_id: nil, before_id: nil, limit: nil, request_options: {})
         #
@@ -101,7 +101,7 @@ module Anthropic
         # like to delete an in-progress batch, you must first cancel it.
         #
         # Learn more about the Message Batches API in our
-        # [user guide](/en/docs/build-with-claude/batch-processing)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
         #
         # @overload delete(message_batch_id, request_options: {})
         #
@@ -132,7 +132,7 @@ module Anthropic
         # non-interruptible.
         #
         # Learn more about the Message Batches API in our
-        # [user guide](/en/docs/build-with-claude/batch-processing)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
         #
         # @overload cancel(message_batch_id, request_options: {})
         #
@@ -159,7 +159,7 @@ module Anthropic
         # requests. Use the `custom_id` field to match results to requests.
         #
         # Learn more about the Message Batches API in our
-        # [user guide](/en/docs/build-with-claude/batch-processing)
+        # [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
         #
         # @overload results_streaming(message_batch_id, request_options: {})
         #

data/lib/anthropic/resources/messages.rb

@@ -17,7 +17,8 @@ module Anthropic
       # 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)
+      # Learn more about the Messages API in our
+      # [user guide](https://docs.claude.com/en/docs/initial-setup)
       #
       # @overload create(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: {})
       #
@@ -59,14 +60,12 @@ module Anthropic
           raise ArgumentError.new(message)
         end
 
-        tool_models = get_structured_output_models(parsed)
+        tools, models = Anthropic::Helpers::Messages.distill_input_schema_models!(parsed, strict: nil)
 
-        unwrap = if tool_models.any?
-          ->(raw) { parse_structured_outputs!(raw, tool_models) }
-        end
+        unwrap = ->(raw) { Anthropic::Helpers::Messages.parse_input_schemas!(raw, tools:, models:) }
 
         if options.empty? && @client.timeout == Anthropic::Client::DEFAULT_TIMEOUT_IN_SECONDS
-          model = parsed[:model].to_sym
+          model = parsed[:model]&.to_sym
           max_tokens = parsed[:max_tokens].to_i
           timeout = @client.calculate_nonstreaming_timeout(
             max_tokens,
@@ -87,6 +86,8 @@ module Anthropic
         )
       end
 
+      alias_method :parse, :create
+
       # See {Anthropic::Resources::Messages#create} for non-streaming counterpart.
       #
       # Some parameter documentations has been truncated, see
@@ -141,7 +142,7 @@ module Anthropic
         end
         parsed.store(:stream, true)
 
-        tool_models = get_structured_output_models(parsed)
+        tools, models = Anthropic::Helpers::Messages.distill_input_schema_models!(parsed, strict: nil)
 
         raw_stream = @client.request(
           method: :post,
@@ -152,10 +153,7 @@ module Anthropic
           model: Anthropic::Models::RawMessageStreamEvent,
           options: options
         )
-        Anthropic::Streaming::MessageStream.new(
-          raw_stream: raw_stream,
-          tool_models: tool_models
-        )
+        Anthropic::Streaming::MessageStream.new(raw_stream:, tools:, models:)
       end
 
       # See {Anthropic::Resources::Messages#create} for non-streaming counterpart.
@@ -169,7 +167,8 @@ module Anthropic
       # 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)
+      # Learn more about the Messages API in our
+      # [user guide](https://docs.claude.com/en/docs/initial-setup)
       #
       # @overload stream_raw(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: {})
       #
@@ -231,7 +230,7 @@ module Anthropic
       # including tools, images, and documents, without creating it.
       #
       # Learn more about token counting in our
-      # [user guide](/en/docs/build-with-claude/token-counting)
+      # [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
       #
       # @overload count_tokens(messages:, model:, system_: nil, thinking: nil, tool_choice: nil, tools: nil, request_options: {})
       #
@@ -270,77 +269,6 @@ module Anthropic
         @client = client
         @batches = Anthropic::Resources::Messages::Batches.new(client: client)
       end
-
-      private
-
-      # Extract tool models from the request and convert them to JSON Schema
-      # Returns a hash mapping tool name to Ruby model.
-      def get_structured_output_models(parsed)
-        tool_models = {}
-
-        case parsed
-        in {tools: Array => tools}
-          mapped = tools.map do |tool|
-            case tool
-            # Direct tool class:
-            in Anthropic::Helpers::InputSchema::JsonSchemaConverter
-              name = tool.name.split("::").last
-              description = extract_class_description(tool)
-              tool_models.store(name, tool)
-              {
-                name: name,
-                description: description,
-                input_schema: tool.to_json_schema
-              }
-            # Tool with explicit name/description and BaseModel as input_schema:
-            in {name: String => name,
-                input_schema: Anthropic::Helpers::InputSchema::JsonSchemaConverter => model,
-                **rest}
-              tool_models.store(name, model)
-              rest.merge(
-                name: name,
-                input_schema: model.to_json_schema
-              )
-            else
-              # Any other format (pass through unchanged)
-              # This includes raw JSON schemas and any other tool definitions.
-              tool
-            end
-          end
-          tools.replace(mapped)
-        else
-        end
-
-        tool_models
-      end
-
-      # Extract class description from a BaseModel class
-      def extract_class_description(klass)
-        klass.respond_to?(:doc_string) ? klass.doc_string : nil
-      end
-
-      def parse_structured_outputs!(raw, tool_models)
-        return raw if tool_models.empty?
-
-        raw[:content]&.each do |content|
-          next unless content[:type] == "tool_use"
-
-          model = tool_models[content[:name]]
-          next unless model
-
-          begin
-            parsed_input = content[:input]
-
-            coerced = Anthropic::Internal::Type::Converter.coerce(model, parsed_input)
-
-            content.store(:parsed, coerced)
-          rescue StandardError => e
-            content.store(:parsed, {error: e.message})
-          end
-        end
-
-        raw
-      end
     end
   end
 end

data/lib/anthropic/version.rb

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

data/lib/anthropic.rb

@@ -9,6 +9,7 @@ require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -55,6 +56,17 @@ require_relative "anthropic/helpers/bedrock/client"
 require_relative "anthropic/helpers/vertex/client"
 require_relative "anthropic/bedrock"
 require_relative "anthropic/vertex"
+require_relative "anthropic/helpers/input_schema"
+require_relative "anthropic/helpers/input_schema/supported_schemas"
+require_relative "anthropic/helpers/input_schema/json_schema_converter"
+require_relative "anthropic/helpers/input_schema/base_model"
+require_relative "anthropic/helpers/input_schema/array_of"
+require_relative "anthropic/helpers/input_schema/boolean"
+require_relative "anthropic/helpers/input_schema/enum_of"
+require_relative "anthropic/helpers/input_schema/union_of"
+require_relative "anthropic/helpers/input_schema/parsed_json"
+require_relative "anthropic/input_schema"
+require_relative "anthropic/helpers/messages"
 require_relative "anthropic/internal/stream"
 require_relative "anthropic/internal/jsonl_stream"
 require_relative "anthropic/internal/page"
@@ -128,6 +140,7 @@ require_relative "anthropic/models/beta/beta_image_block_param"
 require_relative "anthropic/models/beta/beta_input_json_delta"
 require_relative "anthropic/models/beta/beta_input_tokens_clear_at_least"
 require_relative "anthropic/models/beta/beta_input_tokens_trigger"
+require_relative "anthropic/models/beta/beta_json_output_format"
 require_relative "anthropic/models/beta/beta_mcp_tool_result_block"
 require_relative "anthropic/models/beta/beta_mcp_tool_use_block"
 require_relative "anthropic/models/beta/beta_mcp_tool_use_block_param"
@@ -412,13 +425,6 @@ require_relative "anthropic/resources/completions"
 require_relative "anthropic/resources/messages"
 require_relative "anthropic/resources/messages/batches"
 require_relative "anthropic/resources/models"
-require_relative "anthropic/helpers/input_schema"
-require_relative "anthropic/helpers/input_schema/property_mapping"
-require_relative "anthropic/helpers/input_schema/json_schema_converter"
-require_relative "anthropic/helpers/input_schema/base_model"
-require_relative "anthropic/helpers/input_schema/array_of"
-require_relative "anthropic/helpers/input_schema/boolean"
-require_relative "anthropic/helpers/input_schema/enum_of"
-require_relative "anthropic/helpers/input_schema/union_of"
-require_relative "anthropic/helpers/input_schema/parsed_json"
-require_relative "anthropic/input_schema"
+require_relative "anthropic/helpers/tools/runner"
+require_relative "anthropic/helpers/tools/base_tool"
+require_relative "anthropic/helpers/tools"

data/manifest.yaml

@@ -6,6 +6,7 @@ dependencies:
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/anthropic/helpers/input_schema/base_model.rbi

@@ -12,8 +12,13 @@ module Anthropic
         extend Anthropic::Helpers::InputSchema::JsonSchemaConverter
 
         class << self
-          sig { params(doc: T.nilable(String)).void }
-          attr_writer :doc
+          # @api public
+          #
+          sig { params(description: String).returns(T.class_of(String)) }
+          def description(description)
+          end
+
+          alias_method :doc, :description
         end
       end
     end

data/rbi/anthropic/helpers/tools/base_tool.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module Tools
+      # @api private
+      #
+      class BaseTool
+        include Anthropic::Internal::Type::Converter
+        include Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        class << self
+          # @api public
+          #
+          sig { returns(T.class_of(Anthropic::Helpers::InputSchema::BaseModel)) }
+          attr_reader :model
+
+          sig { returns(T.class_of(String)) }
+          attr_reader :doc_string
+
+          # @api public
+          #
+          sig { params(description: String).returns(T.class_of(String)) }
+          def description(description)
+          end
+
+          alias_method :doc, :description
+
+          # @api public
+          #
+          sig { params(model: T.class_of(Anthropic::Helpers::InputSchema::BaseModel)).returns(T.class_of(Anthropic::Helpers::InputSchema::BaseModel)) }
+          def input_schema(model) = (@model = model)
+        end
+
+        # @api public
+        #
+        # Override the `#parse` method to customize the pre-processing of the tool call argument
+        #
+        sig { params(value: T.anything).returns(T.anything) }
+        def parse(value)
+        end
+
+        # @api public
+        #
+        sig { params(parsed: Anthropic::Helpers::InputSchema::BaseModel).returns(T.anything) }
+        def call(parsed)
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/tools/runner.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module Tools
+      # @api private
+      #
+      class Runner
+        sig { returns(Anthropic::Models::Beta::MessageCreateParams) }
+        attr_accessor :params
+
+        sig { returns(T::Boolean) }
+        def finished?; end
+
+        sig { params(messages: Anthropic::Models::Beta::BetaMessageParam).void }
+        def feed_messages(*messages); end
+
+        sig { returns(Anthropic::Models::BetaMessage) }
+        def next_message; end
+
+        sig { returns(T::Array[Anthropic::Models::BetaMessage]) }
+        def run_until_finished; end
+
+        sig do
+          params(
+            blk: T.proc.params(arg0: Anthropic::Models::BetaMessage).void
+          ).void
+        end
+        def each_message(&blk); end
+
+        sig do
+          params(
+            blk: T.proc.params(arg0: Anthropic::Streaming::MessageStream).void
+          ).void
+        end
+        def each_streaming(&blk); end
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/tools.rbi

@@ -0,0 +1,5 @@
+# typed: strong
+
+module Anthropic
+  BaseTool = Anthropic::Helpers::Tools::BaseTool
+end

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

@@ -184,6 +184,11 @@ module Anthropic
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/anthropic/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module Anthropic
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private