anthropic 1.21.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0cb095656f34acdf22be107efb79087c1a80fea2d873f11010fb374d8965d7b
-  data.tar.gz: 706ea210c80c1ba1462fa7ee93b23dd8a8067aeddbb37c0b549d7cc7402832a7
+  metadata.gz: 5e7f34d5d181c452996ffe49befe4bea248cd67a952eb8853cabf5d0ced185ef
+  data.tar.gz: 6945acf587c974e918efdbac79a408b1e3dfc787925037ca938f90cb4b601743
 SHA512:
-  metadata.gz: a35a161860f9e605e035c773160948f014185031108c81f108dc1b54656ae655ef9a0455d39eb79aaf1dbe4ef0a5d9c3268bd2293cd6601568efc11adff7a8f8
-  data.tar.gz: 3259249d2d3ac3c716f6d365e71d91dab168a634dc679d256647d22d161ddce1991da94f04c47c034572d3fe63d42cc2c9be16fa22d23eb53a530995d70b44fd
+  metadata.gz: f1f562c0d5bfa17193f8d4952cdf91b2ed68777f87d7a72ed4ce993a457acbdcee4bb9256329a97b4a49513216c077e404b93b06f58241344174a52d956dd84f
+  data.tar.gz: 8e28e293264fa8cf7cd2611211a98f99e524df4485f9d16455b0a6a53e7a6cab3423859c3168b6ab1ea6b18ee071f1761880592c37d4944aa99feb9ea22ec012

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.23.0 (2026-02-19)
+
+Full Changelog: [v1.22.0...v1.23.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.22.0...v1.23.0)
+
+### Features
+
+* **api:** Add top-level cache control (automatic caching) ([612806b](https://github.com/anthropics/anthropic-sdk-ruby/commit/612806bddee36afc3976fa6a4723b0c6df7e6012))
+* **api:** Deprecate haiku-3 ([66ac4a8](https://github.com/anthropics/anthropic-sdk-ruby/commit/66ac4a8ceca44fc2b4d3a68c1ce87c0c05bea5f5))
+
+
+### Chores
+
+* update mock server docs ([56f16bd](https://github.com/anthropics/anthropic-sdk-ruby/commit/56f16bd36802f804fb6a62735c330ebc22a11fe0))
+
+## 1.22.0 (2026-02-18)
+
+Full Changelog: [v1.21.0...v1.22.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.21.0...v1.22.0)
+
+### Features
+
+* **api:** fix shared UserLocation and error code types ([b1e9684](https://github.com/anthropics/anthropic-sdk-ruby/commit/b1e9684d4eb5e9af91798d8e22e28f003312ffe6))
+
 ## 1.21.0 (2026-02-18)
 
 Full Changelog: [v1.20.0...v1.21.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.20.0...v1.21.0)

data/README.md

@@ -15,7 +15,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "anthropic", "~> 1.21.0"
+gem "anthropic", "~> 1.23.0"
 ```
 
 <!-- x-release-please-end -->

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

@@ -86,6 +86,13 @@ module Anthropic
         #   @return [Symbol, String, Anthropic::Models::Model]
         required :model, union: -> { Anthropic::Model }
 
+        # @!attribute cache_control
+        #   Top-level cache control automatically applies a cache_control marker to the last
+        #   cacheable block in the request.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
         # @!attribute context_management
         #   Context management configuration.
         #
@@ -245,7 +252,7 @@ module Anthropic
         #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
-        # @!method initialize(messages:, model:, context_management: nil, mcp_servers: nil, output_config: nil, output_format: nil, speed: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
+        # @!method initialize(messages:, model:, cache_control: nil, context_management: nil, mcp_servers: nil, output_config: nil, output_format: nil, speed: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MessageCountTokensParams} for more details.
         #
@@ -253,6 +260,8 @@ module Anthropic
         #
         #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
         #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
+        #
         #   @param context_management [Anthropic::Models::Beta::BetaContextManagementConfig, nil] Context management configuration.
         #
         #   @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] MCP servers to be utilized in this request

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

@@ -100,6 +100,13 @@ module Anthropic
         #   @return [Symbol, String, Anthropic::Models::Model]
         required :model, union: -> { Anthropic::Model }
 
+        # @!attribute cache_control
+        #   Top-level cache control automatically applies a cache_control marker to the last
+        #   cacheable block in the request.
+        #
+        #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+        optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
         # @!attribute container
         #   Container identifier for reuse across requests.
         #
@@ -340,7 +347,7 @@ module Anthropic
         #   @return [Array<String, Symbol, Anthropic::Models::AnthropicBeta>, nil]
         optional :betas, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::AnthropicBeta] }
 
-        # @!method initialize(max_tokens:, messages:, model:, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
+        # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
@@ -350,6 +357,8 @@ module Anthropic
         #
         #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
         #
+        #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
+        #
         #   @param container [Anthropic::Models::Beta::BetaContainerParams, String, nil] Container identifier for reuse across requests.
         #
         #   @param context_management [Anthropic::Models::Beta::BetaContextManagementConfig, nil] Context management configuration.

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

@@ -153,6 +153,13 @@ module Anthropic
               #   @return [Symbol, String, Anthropic::Models::Model]
               required :model, union: -> { Anthropic::Model }
 
+              # @!attribute cache_control
+              #   Top-level cache control automatically applies a cache_control marker to the last
+              #   cacheable block in the request.
+              #
+              #   @return [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil]
+              optional :cache_control, -> { Anthropic::Beta::BetaCacheControlEphemeral }, nil?: true
+
               # @!attribute container
               #   Container identifier for reuse across requests.
               #
@@ -402,7 +409,7 @@ module Anthropic
               #   @return [Float, nil]
               optional :top_p, Float
 
-              # @!method initialize(max_tokens:, messages:, model:, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil)
+              # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil)
               #   Some parameter documentations has been truncated, see
               #   {Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params} for more
               #   details.
@@ -418,6 +425,8 @@ module Anthropic
               #
               #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
               #
+              #   @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
+              #
               #   @param container [Anthropic::Models::Beta::BetaContainerParams, String, nil] Container identifier for reuse across requests.
               #
               #   @param context_management [Anthropic::Models::Beta::BetaContextManagementConfig, nil] Context management configuration.

data/lib/anthropic/models/message_count_tokens_params.rb

@@ -85,6 +85,13 @@ module Anthropic
       #   @return [Symbol, String, Anthropic::Models::Model]
       required :model, union: -> { Anthropic::Model }
 
+      # @!attribute cache_control
+      #   Top-level cache control automatically applies a cache_control marker to the last
+      #   cacheable block in the request.
+      #
+      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
+
       # @!attribute output_config
       #   Configuration options for the model's output, such as the output format.
       #
@@ -202,7 +209,7 @@ module Anthropic
       #   @return [Array<Anthropic::Models::Tool, Anthropic::Models::ToolBash20250124, Anthropic::Models::CodeExecutionTool20250522, Anthropic::Models::CodeExecutionTool20250825, Anthropic::Models::CodeExecutionTool20260120, Anthropic::Models::MemoryTool20250818, Anthropic::Models::ToolTextEditor20250124, Anthropic::Models::ToolTextEditor20250429, Anthropic::Models::ToolTextEditor20250728, Anthropic::Models::WebSearchTool20250305, Anthropic::Models::WebFetchTool20250910, Anthropic::Models::WebSearchTool20260209, Anthropic::Models::WebFetchTool20260209, Anthropic::Models::ToolSearchToolBm25_20251119, Anthropic::Models::ToolSearchToolRegex20251119>, nil]
       optional :tools, -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::MessageCountTokensTool] }
 
-      # @!method initialize(messages:, model:, output_config: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, request_options: {})
+      # @!method initialize(messages:, model:, cache_control: nil, output_config: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Anthropic::Models::MessageCountTokensParams} for more details.
       #
@@ -210,6 +217,8 @@ module Anthropic
       #
       #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
       #
+      #   @param cache_control [Anthropic::Models::CacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
+      #
       #   @param output_config [Anthropic::Models::OutputConfig] Configuration options for the model's output, such as the output format.
       #
       #   @param system_ [String, Array<Anthropic::Models::TextBlockParam>] System prompt.

data/lib/anthropic/models/message_create_params.rb

@@ -99,6 +99,13 @@ module Anthropic
       #   @return [Symbol, String, Anthropic::Models::Model]
       required :model, union: -> { Anthropic::Model }
 
+      # @!attribute cache_control
+      #   Top-level cache control automatically applies a cache_control marker to the last
+      #   cacheable block in the request.
+      #
+      #   @return [Anthropic::Models::CacheControlEphemeral, nil]
+      optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
+
       # @!attribute container
       #   Container identifier for reuse across requests.
       #
@@ -298,7 +305,7 @@ module Anthropic
       #   @return [Float, nil]
       optional :top_p, Float
 
-      # @!method initialize(max_tokens:, messages:, model:, container: nil, inference_geo: nil, metadata: nil, output_config: 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: {})
+      # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, inference_geo: nil, metadata: nil, output_config: 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: {})
       #   Some parameter documentations has been truncated, see
       #   {Anthropic::Models::MessageCreateParams} for more details.
       #
@@ -308,6 +315,8 @@ module Anthropic
       #
       #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
       #
+      #   @param cache_control [Anthropic::Models::CacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
+      #
       #   @param container [String, nil] Container identifier for reuse across requests.
       #
       #   @param inference_geo [String, nil] Specifies the geographic region for inference processing. If not specified, the

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

@@ -143,6 +143,13 @@ module Anthropic
             #   @return [Symbol, String, Anthropic::Models::Model]
             required :model, union: -> { Anthropic::Model }
 
+            # @!attribute cache_control
+            #   Top-level cache control automatically applies a cache_control marker to the last
+            #   cacheable block in the request.
+            #
+            #   @return [Anthropic::Models::CacheControlEphemeral, nil]
+            optional :cache_control, -> { Anthropic::CacheControlEphemeral }, nil?: true
+
             # @!attribute container
             #   Container identifier for reuse across requests.
             #
@@ -352,7 +359,7 @@ module Anthropic
             #   @return [Float, nil]
             optional :top_p, Float
 
-            # @!method initialize(max_tokens:, messages:, model:, container: nil, inference_geo: nil, metadata: nil, output_config: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil)
+            # @!method initialize(max_tokens:, messages:, model:, cache_control: nil, container: nil, inference_geo: nil, metadata: nil, output_config: nil, service_tier: nil, stop_sequences: nil, stream: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil)
             #   Some parameter documentations has been truncated, see
             #   {Anthropic::Models::Messages::BatchCreateParams::Request::Params} for more
             #   details.
@@ -368,6 +375,8 @@ module Anthropic
             #
             #   @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
             #
+            #   @param cache_control [Anthropic::Models::CacheControlEphemeral, nil] Top-level cache control automatically applies a cache_control marker to the last
+            #
             #   @param container [String, nil] Container identifier for reuse across requests.
             #
             #   @param inference_geo [String, nil] Specifies the geographic region for inference processing. If not specified, the

data/lib/anthropic/models/user_location.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    class UserLocation < Anthropic::Internal::Type::BaseModel
+      # @!attribute type
+      #
+      #   @return [Symbol, :approximate]
+      required :type, const: :approximate
+
+      # @!attribute city
+      #   The city of the user.
+      #
+      #   @return [String, nil]
+      optional :city, String, nil?: true
+
+      # @!attribute country
+      #   The two letter
+      #   [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the
+      #   user.
+      #
+      #   @return [String, nil]
+      optional :country, String, nil?: true
+
+      # @!attribute region
+      #   The region of the user.
+      #
+      #   @return [String, nil]
+      optional :region, String, nil?: true
+
+      # @!attribute timezone
+      #   The [IANA timezone](https://nodatime.org/TimeZones) of the user.
+      #
+      #   @return [String, nil]
+      optional :timezone, String, nil?: true
+
+      # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: :approximate)
+      #   Some parameter documentations has been truncated, see
+      #   {Anthropic::Models::UserLocation} for more details.
+      #
+      #   @param city [String, nil] The city of the user.
+      #
+      #   @param country [String, nil] The two letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha
+      #
+      #   @param region [String, nil] The region of the user.
+      #
+      #   @param timezone [String, nil] The [IANA timezone](https://nodatime.org/TimeZones) of the user.
+      #
+      #   @param type [Symbol, :approximate]
+    end
+  end
+end

data/lib/anthropic/models/web_search_tool_20250305.rb

@@ -65,8 +65,8 @@ module Anthropic
       #   Parameters for the user's location. Used to provide more relevant search
       #   results.
       #
-      #   @return [Anthropic::Models::WebSearchTool20250305::UserLocation, nil]
-      optional :user_location, -> { Anthropic::WebSearchTool20250305::UserLocation }, nil?: true
+      #   @return [Anthropic::Models::UserLocation, nil]
+      optional :user_location, -> { Anthropic::UserLocation }, nil?: true
 
       # @!method initialize(allowed_callers: nil, allowed_domains: nil, blocked_domains: nil, cache_control: nil, defer_loading: nil, max_uses: nil, strict: nil, user_location: nil, name: :web_search, type: :web_search_20250305)
       #   Some parameter documentations has been truncated, see
@@ -86,7 +86,7 @@ module Anthropic
       #
       #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs
       #
-      #   @param user_location [Anthropic::Models::WebSearchTool20250305::UserLocation, nil] Parameters for the user's location. Used to provide more relevant search results
+      #   @param user_location [Anthropic::Models::UserLocation, nil] Parameters for the user's location. Used to provide more relevant search results
       #
       #   @param name [Symbol, :web_search] Name of the tool.
       #
@@ -103,56 +103,8 @@ module Anthropic
         #   @return [Array<Symbol>]
       end
 
-      # @see Anthropic::Models::WebSearchTool20250305#user_location
-      class UserLocation < Anthropic::Internal::Type::BaseModel
-        # @!attribute type
-        #
-        #   @return [Symbol, :approximate]
-        required :type, const: :approximate
-
-        # @!attribute city
-        #   The city of the user.
-        #
-        #   @return [String, nil]
-        optional :city, String, nil?: true
-
-        # @!attribute country
-        #   The two letter
-        #   [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the
-        #   user.
-        #
-        #   @return [String, nil]
-        optional :country, String, nil?: true
-
-        # @!attribute region
-        #   The region of the user.
-        #
-        #   @return [String, nil]
-        optional :region, String, nil?: true
-
-        # @!attribute timezone
-        #   The [IANA timezone](https://nodatime.org/TimeZones) of the user.
-        #
-        #   @return [String, nil]
-        optional :timezone, String, nil?: true
-
-        # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: :approximate)
-        #   Some parameter documentations has been truncated, see
-        #   {Anthropic::Models::WebSearchTool20250305::UserLocation} for more details.
-        #
-        #   Parameters for the user's location. Used to provide more relevant search
-        #   results.
-        #
-        #   @param city [String, nil] The city of the user.
-        #
-        #   @param country [String, nil] The two letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha
-        #
-        #   @param region [String, nil] The region of the user.
-        #
-        #   @param timezone [String, nil] The [IANA timezone](https://nodatime.org/TimeZones) of the user.
-        #
-        #   @param type [Symbol, :approximate]
-      end
+      # @deprecated Use {Anthropic::Models::UserLocation} instead.
+      UserLocation = Anthropic::Models::UserLocation
     end
   end
 end

data/lib/anthropic/models/web_search_tool_20260209.rb

@@ -65,8 +65,8 @@ module Anthropic
       #   Parameters for the user's location. Used to provide more relevant search
       #   results.
       #
-      #   @return [Anthropic::Models::WebSearchTool20260209::UserLocation, nil]
-      optional :user_location, -> { Anthropic::WebSearchTool20260209::UserLocation }, nil?: true
+      #   @return [Anthropic::Models::UserLocation, nil]
+      optional :user_location, -> { Anthropic::UserLocation }, nil?: true
 
       # @!method initialize(allowed_callers: nil, allowed_domains: nil, blocked_domains: nil, cache_control: nil, defer_loading: nil, max_uses: nil, strict: nil, user_location: nil, name: :web_search, type: :web_search_20260209)
       #   Some parameter documentations has been truncated, see
@@ -86,7 +86,7 @@ module Anthropic
       #
       #   @param strict [Boolean] When true, guarantees schema validation on tool names and inputs
       #
-      #   @param user_location [Anthropic::Models::WebSearchTool20260209::UserLocation, nil] Parameters for the user's location. Used to provide more relevant search results
+      #   @param user_location [Anthropic::Models::UserLocation, nil] Parameters for the user's location. Used to provide more relevant search results
       #
       #   @param name [Symbol, :web_search] Name of the tool.
       #
@@ -103,56 +103,8 @@ module Anthropic
         #   @return [Array<Symbol>]
       end
 
-      # @see Anthropic::Models::WebSearchTool20260209#user_location
-      class UserLocation < Anthropic::Internal::Type::BaseModel
-        # @!attribute type
-        #
-        #   @return [Symbol, :approximate]
-        required :type, const: :approximate
-
-        # @!attribute city
-        #   The city of the user.
-        #
-        #   @return [String, nil]
-        optional :city, String, nil?: true
-
-        # @!attribute country
-        #   The two letter
-        #   [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the
-        #   user.
-        #
-        #   @return [String, nil]
-        optional :country, String, nil?: true
-
-        # @!attribute region
-        #   The region of the user.
-        #
-        #   @return [String, nil]
-        optional :region, String, nil?: true
-
-        # @!attribute timezone
-        #   The [IANA timezone](https://nodatime.org/TimeZones) of the user.
-        #
-        #   @return [String, nil]
-        optional :timezone, String, nil?: true
-
-        # @!method initialize(city: nil, country: nil, region: nil, timezone: nil, type: :approximate)
-        #   Some parameter documentations has been truncated, see
-        #   {Anthropic::Models::WebSearchTool20260209::UserLocation} for more details.
-        #
-        #   Parameters for the user's location. Used to provide more relevant search
-        #   results.
-        #
-        #   @param city [String, nil] The city of the user.
-        #
-        #   @param country [String, nil] The two letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha
-        #
-        #   @param region [String, nil] The region of the user.
-        #
-        #   @param timezone [String, nil] The [IANA timezone](https://nodatime.org/TimeZones) of the user.
-        #
-        #   @param type [Symbol, :approximate]
-      end
+      # @deprecated Use {Anthropic::Models::UserLocation} instead.
+      UserLocation = Anthropic::Models::UserLocation
     end
   end
 end

data/lib/anthropic/models/web_search_tool_request_error.rb

@@ -5,8 +5,8 @@ module Anthropic
     class WebSearchToolRequestError < Anthropic::Internal::Type::BaseModel
       # @!attribute error_code
       #
-      #   @return [Symbol, Anthropic::Models::WebSearchToolRequestError::ErrorCode]
-      required :error_code, enum: -> { Anthropic::WebSearchToolRequestError::ErrorCode }
+      #   @return [Symbol, Anthropic::Models::WebSearchToolResultErrorCode]
+      required :error_code, enum: -> { Anthropic::WebSearchToolResultErrorCode }
 
       # @!attribute type
       #
@@ -14,23 +14,8 @@ module Anthropic
       required :type, const: :web_search_tool_result_error
 
       # @!method initialize(error_code:, type: :web_search_tool_result_error)
-      #   @param error_code [Symbol, Anthropic::Models::WebSearchToolRequestError::ErrorCode]
+      #   @param error_code [Symbol, Anthropic::Models::WebSearchToolResultErrorCode]
       #   @param type [Symbol, :web_search_tool_result_error]
-
-      # @see Anthropic::Models::WebSearchToolRequestError#error_code
-      module ErrorCode
-        extend Anthropic::Internal::Type::Enum
-
-        INVALID_TOOL_INPUT = :invalid_tool_input
-        UNAVAILABLE = :unavailable
-        MAX_USES_EXCEEDED = :max_uses_exceeded
-        TOO_MANY_REQUESTS = :too_many_requests
-        QUERY_TOO_LONG = :query_too_long
-        REQUEST_TOO_LARGE = :request_too_large
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/anthropic/models/web_search_tool_result_error.rb

@@ -5,8 +5,8 @@ module Anthropic
     class WebSearchToolResultError < Anthropic::Internal::Type::BaseModel
       # @!attribute error_code
       #
-      #   @return [Symbol, Anthropic::Models::WebSearchToolResultError::ErrorCode]
-      required :error_code, enum: -> { Anthropic::WebSearchToolResultError::ErrorCode }
+      #   @return [Symbol, Anthropic::Models::WebSearchToolResultErrorCode]
+      required :error_code, enum: -> { Anthropic::WebSearchToolResultErrorCode }
 
       # @!attribute type
       #
@@ -14,23 +14,8 @@ module Anthropic
       required :type, const: :web_search_tool_result_error
 
       # @!method initialize(error_code:, type: :web_search_tool_result_error)
-      #   @param error_code [Symbol, Anthropic::Models::WebSearchToolResultError::ErrorCode]
+      #   @param error_code [Symbol, Anthropic::Models::WebSearchToolResultErrorCode]
       #   @param type [Symbol, :web_search_tool_result_error]
-
-      # @see Anthropic::Models::WebSearchToolResultError#error_code
-      module ErrorCode
-        extend Anthropic::Internal::Type::Enum
-
-        INVALID_TOOL_INPUT = :invalid_tool_input
-        UNAVAILABLE = :unavailable
-        MAX_USES_EXCEEDED = :max_uses_exceeded
-        TOO_MANY_REQUESTS = :too_many_requests
-        QUERY_TOO_LONG = :query_too_long
-        REQUEST_TOO_LARGE = :request_too_large
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/anthropic/models/web_search_tool_result_error_code.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module WebSearchToolResultErrorCode
+      extend Anthropic::Internal::Type::Enum
+
+      INVALID_TOOL_INPUT = :invalid_tool_input
+      UNAVAILABLE = :unavailable
+      MAX_USES_EXCEEDED = :max_uses_exceeded
+      TOO_MANY_REQUESTS = :too_many_requests
+      QUERY_TOO_LONG = :query_too_long
+      REQUEST_TOO_LARGE = :request_too_large
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+
+    # @deprecated Use {Anthropic::Models::WebSearchToolResultErrorCode} instead.
+    WebSearchToolRequestError::ErrorCode = Anthropic::Models::WebSearchToolResultErrorCode
+
+    # @deprecated Use {Anthropic::Models::WebSearchToolResultErrorCode} instead.
+    WebSearchToolResultError::ErrorCode = Anthropic::Models::WebSearchToolResultErrorCode
+  end
+end

data/lib/anthropic/models.rb

@@ -378,6 +378,8 @@ module Anthropic
 
   Usage = Anthropic::Models::Usage
 
+  UserLocation = Anthropic::Models::UserLocation
+
   WebFetchBlock = Anthropic::Models::WebFetchBlock
 
   WebFetchBlockParam = Anthropic::Models::WebFetchBlockParam
@@ -415,4 +417,6 @@ module Anthropic
   WebSearchToolResultBlockParamContent = Anthropic::Models::WebSearchToolResultBlockParamContent
 
   WebSearchToolResultError = Anthropic::Models::WebSearchToolResultError
+
+  WebSearchToolResultErrorCode = Anthropic::Models::WebSearchToolResultErrorCode
 end

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

@@ -32,7 +32,7 @@ module Anthropic
         # Learn more about the Messages API in our
         # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload create(max_tokens:, messages:, model:, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
+        # @overload create(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -40,6 +40,8 @@ module Anthropic
         #
         # @param model [Symbol, String, Anthropic::Models::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
         #
+        # @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Body param: Top-level cache control automatically applies a cache_control marker
+        #
         # @param container [Anthropic::Models::Beta::BetaContainerParams, String, nil] Body param: Container identifier for reuse across requests.
         #
         # @param context_management [Anthropic::Models::Beta::BetaContextManagementConfig, nil] Body param: Context management configuration.
@@ -136,7 +138,7 @@ module Anthropic
         # Learn more about the Messages API in our
         # [user guide](https://docs.claude.com/en/docs/initial-setup)
         #
-        # @overload stream_raw(max_tokens:, messages:, model:, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
+        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, container: nil, context_management: nil, inference_geo: nil, mcp_servers: nil, metadata: nil, output_config: nil, output_format: nil, service_tier: nil, speed: nil, stop_sequences: nil, system_: nil, temperature: nil, thinking: nil, tool_choice: nil, tools: nil, top_k: nil, top_p: nil, betas: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -144,6 +146,8 @@ module Anthropic
         #
         # @param model [Symbol, String, Anthropic::Models::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
         #
+        # @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Body param: Top-level cache control automatically applies a cache_control marker
+        #
         # @param container [Anthropic::Models::Beta::BetaContainerParams, String, nil] Body param: Container identifier for reuse across requests.
         #
         # @param context_management [Anthropic::Models::Beta::BetaContextManagementConfig, nil] Body param: Context management configuration.
@@ -307,12 +311,14 @@ module Anthropic
         # Learn more about token counting in our
         # [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
         #
-        # @overload count_tokens(messages:, model:, context_management: nil, mcp_servers: nil, output_config: nil, output_format: nil, speed: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
+        # @overload count_tokens(messages:, model:, cache_control: nil, context_management: nil, mcp_servers: nil, output_config: nil, output_format: nil, speed: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, betas: nil, request_options: {})
         #
         # @param messages [Array<Anthropic::Models::Beta::BetaMessageParam>] Body param: Input messages.
         #
         # @param model [Symbol, String, Anthropic::Models::Model] Body param: The model that will complete your prompt.\n\nSee [models](https://do
         #
+        # @param cache_control [Anthropic::Models::Beta::BetaCacheControlEphemeral, nil] Body param: Top-level cache control automatically applies a cache_control marker
+        #
         # @param context_management [Anthropic::Models::Beta::BetaContextManagementConfig, nil] Body param: Context management configuration.
         #
         # @param mcp_servers [Array<Anthropic::Models::Beta::BetaRequestMCPServerURLDefinition>] Body param: MCP servers to be utilized in this request