anthropic 1.6.0 → 1.8.0

data/lib/anthropic/models/beta/message_create_params.rb

@@ -80,30 +80,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
@@ -287,7 +264,7 @@ module Anthropic
         #
         #   See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
         #
-        #   @return [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>, nil]
+        #   @return [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>, nil]
         optional :tools, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaToolUnion] }
 
         # @!attribute top_k
@@ -350,7 +327,7 @@ module Anthropic
         #
         #   @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] How the model should use the provided tools. The model can use a specific tool,
         #
-        #   @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>] 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>] 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/beta/messages/batch_create_params.rb

@@ -15,9 +15,7 @@ module Anthropic
           #
           #   @return [Array<Anthropic::Models::Beta::Messages::BatchCreateParams::Request>]
           required :requests,
-                   -> {
-                     Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::Messages::BatchCreateParams::Request]
-                   }
+                   -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::Messages::BatchCreateParams::Request] }
 
           # @!attribute betas
           #   Optional header to specify the beta version(s) you want to use.
@@ -135,30 +133,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
@@ -189,9 +164,7 @@ module Anthropic
               #
               #   @return [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>, nil]
               optional :mcp_servers,
-                       -> {
-                         Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaRequestMCPServerURLDefinition]
-                       }
+                       -> { Anthropic::Internal::Type::ArrayOf[Anthropic::Beta::BetaRequestMCPServerURLDefinition] }
 
               # @!attribute metadata
               #   An object describing metadata about the request.
@@ -356,11 +329,8 @@ module Anthropic
               #
               #   See our [guide](https://docs.anthropic.com/en/docs/tool-use) for more details.
               #
-              #   @return [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>, nil]
-              optional :tools,
-                       -> {
-                         Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaToolUnion]
-                       }
+              #   @return [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>, nil]
+              optional :tools, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::BetaToolUnion] }
 
               # @!attribute top_k
               #   Only sample from the top K options for each subsequent token.
@@ -424,7 +394,7 @@ module Anthropic
               #
               #   @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] How the model should use the provided tools. The model can use a specific tool,
               #
-              #   @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>] 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>] 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/beta/messages/beta_message_batch.rb

@@ -56,10 +56,7 @@ module Anthropic
           #   Processing status of the Message Batch.
           #
           #   @return [Symbol, Anthropic::Models::Beta::Messages::BetaMessageBatch::ProcessingStatus]
-          required :processing_status,
-                   enum: -> {
-                     Anthropic::Beta::Messages::BetaMessageBatch::ProcessingStatus
-                   }
+          required :processing_status, enum: -> { Anthropic::Beta::Messages::BetaMessageBatch::ProcessingStatus }
 
           # @!attribute request_counts
           #   Tallies requests within the Message Batch, categorized by their status.

data/lib/anthropic/models/beta_error_response.rb

@@ -8,13 +8,19 @@ module Anthropic
       #   @return [Anthropic::Models::BetaInvalidRequestError, Anthropic::Models::BetaAuthenticationError, Anthropic::Models::BetaBillingError, Anthropic::Models::BetaPermissionError, Anthropic::Models::BetaNotFoundError, Anthropic::Models::BetaRateLimitError, Anthropic::Models::BetaGatewayTimeoutError, Anthropic::Models::BetaAPIError, Anthropic::Models::BetaOverloadedError]
       required :error, union: -> { Anthropic::BetaError }
 
+      # @!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::BetaInvalidRequestError, Anthropic::Models::BetaAuthenticationError, Anthropic::Models::BetaBillingError, Anthropic::Models::BetaPermissionError, Anthropic::Models::BetaNotFoundError, Anthropic::Models::BetaRateLimitError, Anthropic::Models::BetaGatewayTimeoutError, Anthropic::Models::BetaAPIError, Anthropic::Models::BetaOverloadedError]
+      #   @param request_id [String, nil]
       #   @param type [Symbol, :error]
     end
   end

data/lib/anthropic/models/cache_control_ephemeral.rb

@@ -8,8 +8,46 @@ module Anthropic
       #   @return [Symbol, :ephemeral]
       required :type, const: :ephemeral
 
-      # @!method initialize(type: :ephemeral)
+      # @!attribute ttl
+      #   The time-to-live for the cache control breakpoint.
+      #
+      #   This may be one the following values:
+      #
+      #   - `5m`: 5 minutes
+      #   - `1h`: 1 hour
+      #
+      #   Defaults to `5m`.
+      #
+      #   @return [Symbol, Anthropic::Models::CacheControlEphemeral::TTL, nil]
+      optional :ttl, enum: -> { Anthropic::CacheControlEphemeral::TTL }
+
+      # @!method initialize(ttl: nil, type: :ephemeral)
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::Models::CacheControlEphemeral} for more details.
+      #
+      #   @param ttl [Symbol, Anthropic::Models::CacheControlEphemeral::TTL] The time-to-live for the cache control breakpoint.
+      #
       #   @param type [Symbol, :ephemeral]
+
+      # The time-to-live for the cache control breakpoint.
+      #
+      # This may be one the following values:
+      #
+      # - `5m`: 5 minutes
+      # - `1h`: 1 hour
+      #
+      # Defaults to `5m`.
+      #
+      # @see Anthropic::Models::CacheControlEphemeral#ttl
+      module TTL
+        extend Anthropic::Internal::Type::Enum
+
+        TTL_5M = :"5m"
+        TTL_1H = :"1h"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/anthropic/models/cache_creation.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    class CacheCreation < Anthropic::Internal::Type::BaseModel
+      # @!attribute ephemeral_1h_input_tokens
+      #   The number of input tokens used to create the 1 hour cache entry.
+      #
+      #   @return [Integer]
+      required :ephemeral_1h_input_tokens, Integer
+
+      # @!attribute ephemeral_5m_input_tokens
+      #   The number of input tokens used to create the 5 minute cache entry.
+      #
+      #   @return [Integer]
+      required :ephemeral_5m_input_tokens, Integer
+
+      # @!method initialize(ephemeral_1h_input_tokens:, ephemeral_5m_input_tokens:)
+      #   @param ephemeral_1h_input_tokens [Integer] The number of input tokens used to create the 1 hour cache entry.
+      #
+      #   @param ephemeral_5m_input_tokens [Integer] The number of input tokens used to create the 5 minute cache entry.
+    end
+  end
+end

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/model.rb

@@ -78,8 +78,14 @@ module Anthropic
       CLAUDE_3_5_SONNET_LATEST = :"claude-3-5-sonnet-latest"
 
       # Our previous most intelligent model
+      # @deprecated Will reach end-of-life on October 22, 2025. Please migrate to a newer model.
+      # Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more
+      # information.
       CLAUDE_3_5_SONNET_20241022 = :"claude-3-5-sonnet-20241022"
 
+      # @deprecated Will reach end-of-life on October 22, 2025. Please migrate to a newer model.
+      # Visit https://docs.anthropic.com/en/docs/resources/model-deprecations for more
+      # information.
       CLAUDE_3_5_SONNET_20240620 = :"claude-3-5-sonnet-20240620"
 
       # Our most capable model

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/models/usage.rb

@@ -3,6 +3,12 @@
 module Anthropic
   module Models
     class Usage < Anthropic::Internal::Type::BaseModel
+      # @!attribute cache_creation
+      #   Breakdown of cached tokens by TTL
+      #
+      #   @return [Anthropic::Models::CacheCreation, nil]
+      required :cache_creation, -> { Anthropic::CacheCreation }, nil?: true
+
       # @!attribute cache_creation_input_tokens
       #   The number of input tokens used to create the cache entry.
       #
@@ -39,7 +45,9 @@ module Anthropic
       #   @return [Symbol, Anthropic::Models::Usage::ServiceTier, nil]
       required :service_tier, enum: -> { Anthropic::Usage::ServiceTier }, nil?: true
 
-      # @!method initialize(cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:, server_tool_use:, service_tier:)
+      # @!method initialize(cache_creation:, cache_creation_input_tokens:, cache_read_input_tokens:, input_tokens:, output_tokens:, server_tool_use:, service_tier:)
+      #   @param cache_creation [Anthropic::Models::CacheCreation, nil] Breakdown of cached tokens by TTL
+      #
       #   @param cache_creation_input_tokens [Integer, nil] The number of input tokens used to create the cache entry.
       #
       #   @param cache_read_input_tokens [Integer, nil] The number of input tokens read from the cache.

data/lib/anthropic/models.rb

@@ -77,6 +77,8 @@ module Anthropic
 
   CacheControlEphemeral = Anthropic::Models::CacheControlEphemeral
 
+  CacheCreation = Anthropic::Models::CacheCreation
+
   CitationCharLocation = Anthropic::Models::CitationCharLocation
 
   CitationCharLocationParam = Anthropic::Models::CitationCharLocationParam

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>] 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>] 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>] 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.6.0"
+  VERSION = "1.8.0"
 end