anthropic 1.1.1 → 1.9.0

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::ToolTextEditor20250429, Anthropic::Models::ToolTextEditor20250728, 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,10 +55,16 @@ 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
 
+        tool_models = get_structured_output_models(parsed)
+
+        unwrap = if tool_models.any?
+          ->(raw) { parse_structured_outputs!(raw, tool_models) }
+        end
+
         if options.empty? && @client.timeout == Anthropic::Client::DEFAULT_TIMEOUT_IN_SECONDS
           model = parsed[:model].to_sym
           max_tokens = parsed[:max_tokens].to_i
@@ -76,12 +82,80 @@ module Anthropic
           path: "v1/messages",
           body: parsed,
           model: Anthropic::Message,
+          unwrap: unwrap,
           options: options
         )
       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)
+
+        tool_models = get_structured_output_models(parsed)
+
+        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,
+          tool_models: tool_models
+        )
       end
 
       # See {Anthropic::Resources::Messages#create} for non-streaming counterpart.
@@ -119,7 +193,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::ToolTextEditor20250429, Anthropic::Models::ToolTextEditor20250728, 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 +245,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::ToolTextEditor20250429, Anthropic::Models::ToolTextEditor20250728, Anthropic::Models::WebSearchTool20250305>] Definitions of tools that the model may use.
       #
       # @param request_options [Anthropic::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -196,6 +270,77 @@ 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/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.9.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"
@@ -66,16 +67,27 @@ require_relative "anthropic/models/base64_pdf_source"
 require_relative "anthropic/models/beta/beta_base64_image_source"
 require_relative "anthropic/models/beta/beta_base64_pdf_block"
 require_relative "anthropic/models/beta/beta_base64_pdf_source"
+require_relative "anthropic/models/beta/beta_bash_code_execution_output_block"
+require_relative "anthropic/models/beta/beta_bash_code_execution_output_block_param"
+require_relative "anthropic/models/beta/beta_bash_code_execution_result_block"
+require_relative "anthropic/models/beta/beta_bash_code_execution_result_block_param"
+require_relative "anthropic/models/beta/beta_bash_code_execution_tool_result_block"
+require_relative "anthropic/models/beta/beta_bash_code_execution_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_bash_code_execution_tool_result_error"
+require_relative "anthropic/models/beta/beta_bash_code_execution_tool_result_error_param"
 require_relative "anthropic/models/beta/beta_cache_control_ephemeral"
 require_relative "anthropic/models/beta/beta_cache_creation"
 require_relative "anthropic/models/beta/beta_citation_char_location"
 require_relative "anthropic/models/beta/beta_citation_char_location_param"
+require_relative "anthropic/models/beta/beta_citation_config"
 require_relative "anthropic/models/beta/beta_citation_content_block_location"
 require_relative "anthropic/models/beta/beta_citation_content_block_location_param"
 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"
@@ -83,6 +95,7 @@ require_relative "anthropic/models/beta/beta_code_execution_output_block_param"
 require_relative "anthropic/models/beta/beta_code_execution_result_block"
 require_relative "anthropic/models/beta/beta_code_execution_result_block_param"
 require_relative "anthropic/models/beta/beta_code_execution_tool_20250522"
+require_relative "anthropic/models/beta/beta_code_execution_tool_20250825"
 require_relative "anthropic/models/beta/beta_code_execution_tool_result_block"
 require_relative "anthropic/models/beta/beta_code_execution_tool_result_block_content"
 require_relative "anthropic/models/beta/beta_code_execution_tool_result_block_param"
@@ -97,6 +110,7 @@ require_relative "anthropic/models/beta/beta_content_block"
 require_relative "anthropic/models/beta/beta_content_block_param"
 require_relative "anthropic/models/beta/beta_content_block_source"
 require_relative "anthropic/models/beta/beta_content_block_source_content"
+require_relative "anthropic/models/beta/beta_document_block"
 require_relative "anthropic/models/beta/beta_file_document_source"
 require_relative "anthropic/models/beta/beta_file_image_source"
 require_relative "anthropic/models/beta/beta_image_block_param"
@@ -124,6 +138,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"
@@ -134,6 +149,16 @@ require_relative "anthropic/models/beta/beta_text_block_param"
 require_relative "anthropic/models/beta/beta_text_citation"
 require_relative "anthropic/models/beta/beta_text_citation_param"
 require_relative "anthropic/models/beta/beta_text_delta"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_create_result_block"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_create_result_block_param"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_str_replace_result_block"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_str_replace_result_block_param"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_tool_result_block"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_tool_result_error"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_tool_result_error_param"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_view_result_block"
+require_relative "anthropic/models/beta/beta_text_editor_code_execution_view_result_block_param"
 require_relative "anthropic/models/beta/beta_thinking_block"
 require_relative "anthropic/models/beta/beta_thinking_block_param"
 require_relative "anthropic/models/beta/beta_thinking_config_disabled"
@@ -154,12 +179,21 @@ require_relative "anthropic/models/beta/beta_tool_result_block_param"
 require_relative "anthropic/models/beta/beta_tool_text_editor_20241022"
 require_relative "anthropic/models/beta/beta_tool_text_editor_20250124"
 require_relative "anthropic/models/beta/beta_tool_text_editor_20250429"
+require_relative "anthropic/models/beta/beta_tool_text_editor_20250728"
 require_relative "anthropic/models/beta/beta_tool_union"
 require_relative "anthropic/models/beta/beta_tool_use_block"
 require_relative "anthropic/models/beta/beta_tool_use_block_param"
 require_relative "anthropic/models/beta/beta_url_image_source"
 require_relative "anthropic/models/beta/beta_url_pdf_source"
 require_relative "anthropic/models/beta/beta_usage"
+require_relative "anthropic/models/beta/beta_web_fetch_block"
+require_relative "anthropic/models/beta/beta_web_fetch_block_param"
+require_relative "anthropic/models/beta/beta_web_fetch_tool_20250910"
+require_relative "anthropic/models/beta/beta_web_fetch_tool_result_block"
+require_relative "anthropic/models/beta/beta_web_fetch_tool_result_block_param"
+require_relative "anthropic/models/beta/beta_web_fetch_tool_result_error_block"
+require_relative "anthropic/models/beta/beta_web_fetch_tool_result_error_block_param"
+require_relative "anthropic/models/beta/beta_web_fetch_tool_result_error_code"
 require_relative "anthropic/models/beta/beta_web_search_result_block"
 require_relative "anthropic/models/beta/beta_web_search_result_block_param"
 require_relative "anthropic/models/beta/beta_web_search_tool_20250305"
@@ -209,6 +243,7 @@ require_relative "anthropic/models/beta_permission_error"
 require_relative "anthropic/models/beta_rate_limit_error"
 require_relative "anthropic/models/billing_error"
 require_relative "anthropic/models/cache_control_ephemeral"
+require_relative "anthropic/models/cache_creation"
 require_relative "anthropic/models/citation_char_location"
 require_relative "anthropic/models/citation_char_location_param"
 require_relative "anthropic/models/citation_content_block_location"
@@ -217,6 +252,8 @@ require_relative "anthropic/models/citation_page_location"
 require_relative "anthropic/models/citation_page_location_param"
 require_relative "anthropic/models/citations_config_param"
 require_relative "anthropic/models/citations_delta"
+require_relative "anthropic/models/citation_search_result_location_param"
+require_relative "anthropic/models/citations_search_result_location"
 require_relative "anthropic/models/citations_web_search_result_location"
 require_relative "anthropic/models/citation_web_search_result_location_param"
 require_relative "anthropic/models/completion"
@@ -274,6 +311,7 @@ require_relative "anthropic/models/raw_message_stop_event"
 require_relative "anthropic/models/raw_message_stream_event"
 require_relative "anthropic/models/redacted_thinking_block"
 require_relative "anthropic/models/redacted_thinking_block_param"
+require_relative "anthropic/models/search_result_block_param"
 require_relative "anthropic/models/server_tool_usage"
 require_relative "anthropic/models/server_tool_use_block"
 require_relative "anthropic/models/server_tool_use_block_param"
@@ -299,6 +337,8 @@ require_relative "anthropic/models/tool_choice_none"
 require_relative "anthropic/models/tool_choice_tool"
 require_relative "anthropic/models/tool_result_block_param"
 require_relative "anthropic/models/tool_text_editor_20250124"
+require_relative "anthropic/models/tool_text_editor_20250429"
+require_relative "anthropic/models/tool_text_editor_20250728"
 require_relative "anthropic/models/tool_union"
 require_relative "anthropic/models/tool_use_block"
 require_relative "anthropic/models/tool_use_block_param"
@@ -314,6 +354,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"
@@ -324,3 +368,13 @@ 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"

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
@@ -43,10 +59,10 @@ module Anthropic
     end
 
     class APIConnectionError < Anthropic::Errors::APIError
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :status
 
-      sig { void }
+      sig { returns(NilClass) }
       attr_accessor :body
 
       # @api private

data/rbi/anthropic/helpers/bedrock/client.rbi

@@ -21,10 +21,15 @@ module Anthropic
         # @api private
         sig do
           override
-            .params(req: Anthropic::Internal::Transport::BaseClient::RequestComponents, opts: Anthropic::Internal::AnyHash)
+            .params(
+              req:
+                Anthropic::Internal::Transport::BaseClient::RequestComponents,
+              opts: Anthropic::Internal::AnyHash
+            )
             .returns(Anthropic::Internal::Transport::BaseClient::RequestInput)
         end
-        private def build_request(req, opts); end
+        private def build_request(req, opts)
+        end
 
         sig do
           params(
@@ -45,10 +50,15 @@ module Anthropic
         end
 
         sig do
-          params(request_components: Anthropic::Internal::Transport::BaseClient::RequestComponents)
-            .returns(Anthropic::Internal::Transport::BaseClient::RequestComponents)
+          params(
+            request_components:
+              Anthropic::Internal::Transport::BaseClient::RequestComponents
+          ).returns(
+            Anthropic::Internal::Transport::BaseClient::RequestComponents
+          )
+        end
+        private def fit_req_to_bedrock_specs!(request_components)
         end
-        private def fit_req_to_bedrock_specs!(request_components) end
 
         sig do
           params(
@@ -75,7 +85,8 @@ module Anthropic
           aws_secret_key: nil,
           aws_session_token: nil,
           aws_profile: nil
-        ) end
+        )
+        end
       end
     end
   end

data/rbi/anthropic/helpers/input_schema/array_of.rbi

@@ -0,0 +1,16 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      class ArrayOf < Anthropic::Internal::Type::ArrayOf
+        include Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        Elem = type_member(:out)
+
+        sig { returns(String) }
+        attr_reader :description
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # Represents a response from Anthropic's API where the model's output has been structured according to a schema predefined by the user.
+      #
+      # This class is specifically used when making requests with the `response_format` parameter set to use structured output (e.g., JSON).
+      #
+      # See {examples/input_schemas.rb} for a complete example of use
+      class BaseModel < Anthropic::Internal::Type::BaseModel
+        extend Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        class << self
+          sig { params(doc: T.nilable(String)).void }
+          attr_writer :doc
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/input_schema/boolean.rbi

@@ -0,0 +1,11 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      class Boolean < Anthropic::Internal::Type::Boolean
+        extend Anthropic::Helpers::InputSchema::JsonSchemaConverter
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/input_schema/enum_of.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # @example
+      #   example = Anthropic::EnumOf[:foo, :bar, :zoo]
+      #
+      # @example
+      #   example = Anthropic::EnumOf[1, 2, 3]
+      class EnumOf
+        include Anthropic::Internal::Type::Enum
+        include Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        sig do
+          params(
+            values: T.any(NilClass, T::Boolean, Integer, Float, Symbol)
+          ).returns(T.attached_class)
+        end
+        def self.[](*values)
+        end
+
+        sig do
+          returns(T::Array[T.any(NilClass, T::Boolean, Integer, Float, Symbol)])
+        end
+        attr_reader :values
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/input_schema/json_schema_converter.rbi

@@ -0,0 +1,89 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      JsonSchema = T.type_alias { Anthropic::Internal::AnyHash }
+
+      # To customize the JSON schema conversion for a type, implement the `JsonSchemaConverter` interface.
+      module JsonSchemaConverter
+        POINTER = T.let(Object.new.freeze, T.anything)
+        COUNTER = T.let(Object.new.freeze, T.anything)
+
+        Input =
+          T.type_alias do
+            T.any(
+              Anthropic::Helpers::InputSchema::JsonSchemaConverter,
+              T::Class[T.anything]
+            )
+          end
+        State =
+          T.type_alias do
+            { defs: T::Hash[Object, String], path: T::Array[String] }
+          end
+
+        # The exact JSON schema produced is subject to improvement between minor release versions.
+        sig do
+          params(
+            state: Anthropic::Helpers::InputSchema::JsonSchemaConverter::State
+          ).returns(Anthropic::Helpers::InputSchema::JsonSchema)
+        end
+        def to_json_schema_inner(state:)
+        end
+
+        # Internal helpers methods.
+        class << self
+          # @api private
+          sig do
+            params(schema: Anthropic::Helpers::InputSchema::JsonSchema).returns(
+              Anthropic::Helpers::InputSchema::JsonSchema
+            )
+          end
+          def to_nilable(schema)
+          end
+
+          # @api private
+          sig do
+            params(
+              schema: Anthropic::Helpers::InputSchema::JsonSchema,
+              meta: Anthropic::Internal::AnyHash
+            ).void
+          end
+          def assoc_meta!(schema, meta:)
+          end
+
+          # @api private
+          sig do
+            params(
+              state:
+                Anthropic::Helpers::InputSchema::JsonSchemaConverter::State,
+              type: Anthropic::Helpers::InputSchema::JsonSchemaConverter::Input,
+              blk: T.proc.returns(Anthropic::Helpers::InputSchema::JsonSchema)
+            ).void
+          end
+          def cache_def!(state, type:, &blk)
+          end
+
+          # @api private
+          sig do
+            params(
+              type: Anthropic::Helpers::InputSchema::JsonSchemaConverter::Input
+            ).returns(Anthropic::Helpers::InputSchema::JsonSchema)
+          end
+          def to_json_schema(type)
+          end
+
+          # @api private
+          sig do
+            params(
+              type: Anthropic::Helpers::InputSchema::JsonSchemaConverter::Input,
+              state: Anthropic::Helpers::InputSchema::JsonSchemaConverter::State
+            ).returns(Anthropic::Helpers::InputSchema::JsonSchema)
+          end
+          def to_json_schema_inner(type, state:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/input_schema/union_of.rbi

@@ -0,0 +1,23 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module InputSchema
+      # @example
+      #   example = Anthropic::UnionOf[Float, Anthropic::ArrayOf[Integer]]
+      class UnionOf
+        include Anthropic::Internal::Type::Union
+        include Anthropic::Helpers::InputSchema::JsonSchemaConverter
+
+        sig do
+          params(
+            variants:
+              Anthropic::Helpers::InputSchema::JsonSchemaConverter::Input
+          ).returns(T.attached_class)
+        end
+        def self.[](*variants)
+        end
+      end
+    end
+  end
+end