anthropic 1.7.0 → 1.9.0

data/lib/anthropic/models/document_block_param.rb

@@ -22,7 +22,7 @@ module Anthropic
       # @!attribute citations
       #
       #   @return [Anthropic::Models::CitationsConfigParam, nil]
-      optional :citations, -> { Anthropic::CitationsConfigParam }
+      optional :citations, -> { Anthropic::CitationsConfigParam }, nil?: true
 
       # @!attribute context
       #
@@ -39,7 +39,7 @@ module Anthropic
       #
       #   @param cache_control [Anthropic::Models::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
       #
-      #   @param citations [Anthropic::Models::CitationsConfigParam]
+      #   @param citations [Anthropic::Models::CitationsConfigParam, nil]
       #
       #   @param context [String, nil]
       #

data/lib/anthropic/models/error_response.rb

@@ -8,13 +8,19 @@ module Anthropic
       #   @return [Anthropic::Models::InvalidRequestError, Anthropic::Models::AuthenticationError, Anthropic::Models::BillingError, Anthropic::Models::PermissionError, Anthropic::Models::NotFoundError, Anthropic::Models::RateLimitError, Anthropic::Models::GatewayTimeoutError, Anthropic::Models::APIErrorObject, Anthropic::Models::OverloadedError]
       required :error, union: -> { Anthropic::ErrorObject }
 
+      # @!attribute request_id
+      #
+      #   @return [String, nil]
+      required :request_id, String, nil?: true
+
       # @!attribute type
       #
       #   @return [Symbol, :error]
       required :type, const: :error
 
-      # @!method initialize(error:, type: :error)
+      # @!method initialize(error:, request_id:, type: :error)
       #   @param error [Anthropic::Models::InvalidRequestError, Anthropic::Models::AuthenticationError, Anthropic::Models::BillingError, Anthropic::Models::PermissionError, Anthropic::Models::NotFoundError, Anthropic::Models::RateLimitError, Anthropic::Models::GatewayTimeoutError, Anthropic::Models::APIErrorObject, Anthropic::Models::OverloadedError]
+      #   @param request_id [String, nil]
       #   @param type [Symbol, :error]
     end
   end

data/lib/anthropic/models/message_count_tokens_params.rb

@@ -65,30 +65,7 @@ module Anthropic
       #   { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
       #   ```
       #
-      #   Starting with Claude 3 models, you can also send image content blocks:
-      #
-      #   ```json
-      #   {
-      #     "role": "user",
-      #     "content": [
-      #       {
-      #         "type": "image",
-      #         "source": {
-      #           "type": "base64",
-      #           "media_type": "image/jpeg",
-      #           "data": "/9j/4AAQSkZJRg..."
-      #         }
-      #       },
-      #       { "type": "text", "text": "What is in this image?" }
-      #     ]
-      #   }
-      #   ```
-      #
-      #   We currently support the `base64` source type for images, and the `image/jpeg`,
-      #   `image/png`, `image/gif`, and `image/webp` media types.
-      #
-      #   See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
-      #   more input examples.
+      #   See [input examples](https://docs.anthropic.com/en/api/messages-examples).
       #
       #   Note that if you want to include a
       #   [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use

data/lib/anthropic/models/message_create_params.rb

@@ -79,30 +79,7 @@ module Anthropic
       #   { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
       #   ```
       #
-      #   Starting with Claude 3 models, you can also send image content blocks:
-      #
-      #   ```json
-      #   {
-      #     "role": "user",
-      #     "content": [
-      #       {
-      #         "type": "image",
-      #         "source": {
-      #           "type": "base64",
-      #           "media_type": "image/jpeg",
-      #           "data": "/9j/4AAQSkZJRg..."
-      #         }
-      #       },
-      #       { "type": "text", "text": "What is in this image?" }
-      #     ]
-      #   }
-      #   ```
-      #
-      #   We currently support the `base64` source type for images, and the `image/jpeg`,
-      #   `image/png`, `image/gif`, and `image/webp` media types.
-      #
-      #   See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
-      #   more input examples.
+      #   See [input examples](https://docs.anthropic.com/en/api/messages-examples).
       #
       #   Note that if you want to include a
       #   [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use

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

@@ -123,30 +123,7 @@ module Anthropic
             #   { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
             #   ```
             #
-            #   Starting with Claude 3 models, you can also send image content blocks:
-            #
-            #   ```json
-            #   {
-            #     "role": "user",
-            #     "content": [
-            #       {
-            #         "type": "image",
-            #         "source": {
-            #           "type": "base64",
-            #           "media_type": "image/jpeg",
-            #           "data": "/9j/4AAQSkZJRg..."
-            #         }
-            #       },
-            #       { "type": "text", "text": "What is in this image?" }
-            #     ]
-            #   }
-            #   ```
-            #
-            #   We currently support the `base64` source type for images, and the `image/jpeg`,
-            #   `image/png`, `image/gif`, and `image/webp` media types.
-            #
-            #   See [examples](https://docs.anthropic.com/en/api/messages-examples#vision) for
-            #   more input examples.
+            #   See [input examples](https://docs.anthropic.com/en/api/messages-examples).
             #
             #   Note that if you want to include a
             #   [system prompt](https://docs.anthropic.com/en/docs/system-prompts), you can use
@@ -180,10 +157,7 @@ module Anthropic
             #   [service-tiers](https://docs.anthropic.com/en/api/service-tiers) for details.
             #
             #   @return [Symbol, Anthropic::Models::Messages::BatchCreateParams::Request::Params::ServiceTier, nil]
-            optional :service_tier,
-                     enum: -> {
-                       Anthropic::Messages::BatchCreateParams::Request::Params::ServiceTier
-                     }
+            optional :service_tier, enum: -> { Anthropic::Messages::BatchCreateParams::Request::Params::ServiceTier }
 
             # @!attribute stop_sequences
             #   Custom text sequences that will cause the model to stop generating.

data/lib/anthropic/models/tool_result_block_param.rb

@@ -21,7 +21,7 @@ module Anthropic
 
       # @!attribute content
       #
-      #   @return [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam>, nil]
+      #   @return [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam, Anthropic::Models::DocumentBlockParam>, nil]
       optional :content, union: -> { Anthropic::ToolResultBlockParam::Content }
 
       # @!attribute is_error
@@ -34,7 +34,7 @@ module Anthropic
       #
       #   @param cache_control [Anthropic::Models::CacheControlEphemeral, nil] Create a cache control breakpoint at this content block.
       #
-      #   @param content [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam>]
+      #   @param content [String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam, Anthropic::Models::DocumentBlockParam>]
       #
       #   @param is_error [Boolean]
       #
@@ -59,12 +59,14 @@ module Anthropic
 
           variant :search_result, -> { Anthropic::SearchResultBlockParam }
 
+          variant :document, -> { Anthropic::DocumentBlockParam }
+
           # @!method self.variants
-          #   @return [Array(Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam)]
+          #   @return [Array(Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam, Anthropic::Models::DocumentBlockParam)]
         end
 
         # @!method self.variants
-        #   @return [Array(String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam>)]
+        #   @return [Array(String, Array<Anthropic::Models::TextBlockParam, Anthropic::Models::ImageBlockParam, Anthropic::Models::SearchResultBlockParam, Anthropic::Models::DocumentBlockParam>)]
 
         # @type [Anthropic::Internal::Type::Converter]
         ContentArray =

data/lib/anthropic/models/tool_use_block.rb

@@ -29,6 +29,14 @@ module Anthropic
       # 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
+      end
+
       # @!method initialize(id:, input:, name:, type: :tool_use)
       #   @param id [String]
       #   @param input [Object]

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::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::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305>] 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::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910>] 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.
         #
@@ -128,7 +128,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::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::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305>] 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::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910>] 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.
         #
@@ -259,7 +259,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::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::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305>] 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::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910>] 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

@@ -59,6 +59,12 @@ module Anthropic
           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,6 +82,7 @@ module Anthropic
           path: "v1/messages",
           body: parsed,
           model: Anthropic::Message,
+          unwrap: unwrap,
           options: options
         )
       end
@@ -133,6 +140,9 @@ module Anthropic
           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",
@@ -142,7 +152,10 @@ module Anthropic
           model: Anthropic::Models::RawMessageStreamEvent,
           options: options
         )
-        Anthropic::Streaming::MessageStream.new(raw_stream: raw_stream)
+        Anthropic::Streaming::MessageStream.new(
+          raw_stream: raw_stream,
+          tool_models: tool_models
+        )
       end
 
       # See {Anthropic::Resources::Messages#create} for non-streaming counterpart.
@@ -257,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/version.rb

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

data/lib/anthropic.rb

@@ -67,10 +67,19 @@ 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"
@@ -86,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"
@@ -100,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"
@@ -138,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"
@@ -165,6 +186,14 @@ 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"
@@ -339,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

@@ -59,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/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