anthropic 1.22.0 → 1.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0996202a97866aa77581bea57874600ea56b6c5732a86016bcc019e81e8af9f
-  data.tar.gz: 8301fcd9d00b52e4debc7c379ed286009e3251dd3ec8168e69044f4b7bcfce88
+  metadata.gz: 5e7f34d5d181c452996ffe49befe4bea248cd67a952eb8853cabf5d0ced185ef
+  data.tar.gz: 6945acf587c974e918efdbac79a408b1e3dfc787925037ca938f90cb4b601743
 SHA512:
-  metadata.gz: 7ffb5be3bb3a8396f11b911d2e48d6b444ac0699c55633492118228f21f800aceb8dc2347c01c4f2995a970657c71aa975d6f359790aa5c418dd3d8ba541be4e
-  data.tar.gz: d49e253f5fd6c083790d8ff878bfb8cee1e3e968b5c44dc2b370def67bb684a0bae7c756e426526157315e6590870bb35370d42bbb26a5f5472b13b6f3a34b5e
+  metadata.gz: f1f562c0d5bfa17193f8d4952cdf91b2ed68777f87d7a72ed4ce993a457acbdcee4bb9256329a97b4a49513216c077e404b93b06f58241344174a52d956dd84f
+  data.tar.gz: 8e28e293264fa8cf7cd2611211a98f99e524df4485f9d16455b0a6a53e7a6cab3423859c3168b6ab1ea6b18ee071f1761880592c37d4944aa99feb9ea22ec012

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # 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)

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.22.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/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

data/lib/anthropic/resources/messages.rb

@@ -22,7 +22,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, 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: {})
+      # @overload create(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: {})
       #
       # @param max_tokens [Integer] The maximum number of tokens to generate before stopping.
       #
@@ -30,6 +30,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
@@ -184,7 +186,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, 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: {})
+      # @overload stream_raw(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: {})
       #
       # @param max_tokens [Integer] The maximum number of tokens to generate before stopping.
       #
@@ -192,6 +194,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
@@ -254,12 +258,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:, output_config: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, request_options: {})
+      # @overload count_tokens(messages:, model:, cache_control: nil, output_config: nil, system_: nil, thinking: nil, tool_choice: nil, tools: nil, request_options: {})
       #
       # @param messages [Array<Anthropic::Models::MessageParam>] Input messages.
       #
       # @param model [Symbol, String, Anthropic::Models::Model] The model that will complete your prompt.\n\nSee [models](https://docs.anthropic
       #
+      # @param 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/version.rb

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

data/rbi/anthropic/models/beta/message_count_tokens_params.rbi

@@ -89,6 +89,19 @@ module Anthropic
         sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
         attr_accessor :model
 
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        sig { returns(T.nilable(Anthropic::Beta::BetaCacheControlEphemeral)) }
+        attr_reader :cache_control
+
+        sig do
+          params(
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash)
+          ).void
+        end
+        attr_writer :cache_control
+
         # Context management configuration.
         #
         # This allows you to control how Claude manages context across multiple requests,
@@ -405,6 +418,8 @@ module Anthropic
           params(
             messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
             context_management:
               T.nilable(Anthropic::Beta::BetaContextManagementConfig::OrHash),
             mcp_servers:
@@ -534,6 +549,9 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
+          # Top-level cache control automatically applies a cache_control marker to the last
+          # cacheable block in the request.
+          cache_control: nil,
           # Context management configuration.
           #
           # This allows you to control how Claude manages context across multiple requests,
@@ -658,6 +676,8 @@ module Anthropic
             {
               messages: T::Array[Anthropic::Beta::BetaMessageParam],
               model: T.any(Anthropic::Model::OrSymbol, String),
+              cache_control:
+                T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
               context_management:
                 T.nilable(Anthropic::Beta::BetaContextManagementConfig),
               mcp_servers:

data/rbi/anthropic/models/beta/message_create_params.rbi

@@ -99,6 +99,19 @@ module Anthropic
         sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
         attr_accessor :model
 
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        sig { returns(T.nilable(Anthropic::Beta::BetaCacheControlEphemeral)) }
+        attr_reader :cache_control
+
+        sig do
+          params(
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash)
+          ).void
+        end
+        attr_writer :cache_control
+
         # Container identifier for reuse across requests.
         sig do
           returns(
@@ -511,6 +524,8 @@ module Anthropic
             max_tokens: Integer,
             messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
             container:
               T.nilable(
                 T.any(Anthropic::Beta::BetaContainerParams::OrHash, String)
@@ -657,6 +672,9 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
+          # Top-level cache control automatically applies a cache_control marker to the last
+          # cacheable block in the request.
+          cache_control: nil,
           # Container identifier for reuse across requests.
           container: nil,
           # Context management configuration.
@@ -832,6 +850,8 @@ module Anthropic
               max_tokens: Integer,
               messages: T::Array[Anthropic::Beta::BetaMessageParam],
               model: T.any(Anthropic::Model::OrSymbol, String),
+              cache_control:
+                T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
               container:
                 T.nilable(T.any(Anthropic::Beta::BetaContainerParams, String)),
               context_management:

data/rbi/anthropic/models/beta/messages/batch_create_params.rbi

@@ -240,6 +240,23 @@ module Anthropic
               sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
               attr_accessor :model
 
+              # Top-level cache control automatically applies a cache_control marker to the last
+              # cacheable block in the request.
+              sig do
+                returns(T.nilable(Anthropic::Beta::BetaCacheControlEphemeral))
+              end
+              attr_reader :cache_control
+
+              sig do
+                params(
+                  cache_control:
+                    T.nilable(
+                      Anthropic::Beta::BetaCacheControlEphemeral::OrHash
+                    )
+                ).void
+              end
+              attr_writer :cache_control
+
               # Container identifier for reuse across requests.
               sig do
                 returns(
@@ -661,6 +678,10 @@ module Anthropic
                   max_tokens: Integer,
                   messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
                   model: T.any(Anthropic::Model::OrSymbol, String),
+                  cache_control:
+                    T.nilable(
+                      Anthropic::Beta::BetaCacheControlEphemeral::OrHash
+                    ),
                   container:
                     T.nilable(
                       T.any(
@@ -814,6 +835,9 @@ module Anthropic
                 # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
                 # details and options.
                 model:,
+                # Top-level cache control automatically applies a cache_control marker to the last
+                # cacheable block in the request.
+                cache_control: nil,
                 # Container identifier for reuse across requests.
                 container: nil,
                 # Context management configuration.
@@ -990,6 +1014,8 @@ module Anthropic
                     max_tokens: Integer,
                     messages: T::Array[Anthropic::Beta::BetaMessageParam],
                     model: T.any(Anthropic::Model::OrSymbol, String),
+                    cache_control:
+                      T.nilable(Anthropic::Beta::BetaCacheControlEphemeral),
                     container:
                       T.nilable(
                         T.any(Anthropic::Beta::BetaContainerParams, String)

data/rbi/anthropic/models/message_count_tokens_params.rbi

@@ -88,6 +88,18 @@ module Anthropic
       sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
       attr_accessor :model
 
+      # Top-level cache control automatically applies a cache_control marker to the last
+      # cacheable block in the request.
+      sig { returns(T.nilable(Anthropic::CacheControlEphemeral)) }
+      attr_reader :cache_control
+
+      sig do
+        params(
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash)
+        ).void
+      end
+      attr_writer :cache_control
+
       # Configuration options for the model's output, such as the output format.
       sig { returns(T.nilable(Anthropic::OutputConfig)) }
       attr_reader :output_config
@@ -309,6 +321,7 @@ module Anthropic
         params(
           messages: T::Array[Anthropic::MessageParam::OrHash],
           model: T.any(Anthropic::Model::OrSymbol, String),
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash),
           output_config: Anthropic::OutputConfig::OrHash,
           system_: Anthropic::MessageCountTokensParams::System::Variants,
           thinking:
@@ -418,6 +431,9 @@ module Anthropic
         # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         # details and options.
         model:,
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        cache_control: nil,
         # Configuration options for the model's output, such as the output format.
         output_config: nil,
         # System prompt.
@@ -524,6 +540,7 @@ module Anthropic
           {
             messages: T::Array[Anthropic::MessageParam],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control: T.nilable(Anthropic::CacheControlEphemeral),
             output_config: Anthropic::OutputConfig,
             system_: Anthropic::MessageCountTokensParams::System::Variants,
             thinking:

data/rbi/anthropic/models/message_create_params.rbi

@@ -95,6 +95,18 @@ module Anthropic
       sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
       attr_accessor :model
 
+      # Top-level cache control automatically applies a cache_control marker to the last
+      # cacheable block in the request.
+      sig { returns(T.nilable(Anthropic::CacheControlEphemeral)) }
+      attr_reader :cache_control
+
+      sig do
+        params(
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash)
+        ).void
+      end
+      attr_writer :cache_control
+
       # Container identifier for reuse across requests.
       sig { returns(T.nilable(String)) }
       attr_accessor :container
@@ -405,6 +417,7 @@ module Anthropic
           max_tokens: Integer,
           messages: T::Array[Anthropic::MessageParam::OrHash],
           model: T.any(Anthropic::Model::OrSymbol, String),
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash),
           container: T.nilable(String),
           inference_geo: T.nilable(String),
           metadata: Anthropic::Metadata::OrHash,
@@ -530,6 +543,9 @@ module Anthropic
         # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         # details and options.
         model:,
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        cache_control: nil,
         # Container identifier for reuse across requests.
         container: nil,
         # Specifies the geographic region for inference processing. If not specified, the
@@ -687,6 +703,7 @@ module Anthropic
             max_tokens: Integer,
             messages: T::Array[Anthropic::MessageParam],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control: T.nilable(Anthropic::CacheControlEphemeral),
             container: T.nilable(String),
             inference_geo: T.nilable(String),
             metadata: Anthropic::Metadata,

data/rbi/anthropic/models/messages/batch_create_params.rbi

@@ -207,6 +207,19 @@ module Anthropic
             sig { returns(T.any(Anthropic::Model::OrSymbol, String)) }
             attr_accessor :model
 
+            # Top-level cache control automatically applies a cache_control marker to the last
+            # cacheable block in the request.
+            sig { returns(T.nilable(Anthropic::CacheControlEphemeral)) }
+            attr_reader :cache_control
+
+            sig do
+              params(
+                cache_control:
+                  T.nilable(Anthropic::CacheControlEphemeral::OrHash)
+              ).void
+            end
+            attr_writer :cache_control
+
             # Container identifier for reuse across requests.
             sig { returns(T.nilable(String)) }
             attr_accessor :container
@@ -540,6 +553,8 @@ module Anthropic
                 max_tokens: Integer,
                 messages: T::Array[Anthropic::MessageParam::OrHash],
                 model: T.any(Anthropic::Model::OrSymbol, String),
+                cache_control:
+                  T.nilable(Anthropic::CacheControlEphemeral::OrHash),
                 container: T.nilable(String),
                 inference_geo: T.nilable(String),
                 metadata: Anthropic::Metadata::OrHash,
@@ -667,6 +682,9 @@ module Anthropic
               # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
               # details and options.
               model:,
+              # Top-level cache control automatically applies a cache_control marker to the last
+              # cacheable block in the request.
+              cache_control: nil,
               # Container identifier for reuse across requests.
               container: nil,
               # Specifies the geographic region for inference processing. If not specified, the
@@ -827,6 +845,7 @@ module Anthropic
                   max_tokens: Integer,
                   messages: T::Array[Anthropic::MessageParam],
                   model: T.any(Anthropic::Model::OrSymbol, String),
+                  cache_control: T.nilable(Anthropic::CacheControlEphemeral),
                   container: T.nilable(String),
                   inference_geo: T.nilable(String),
                   metadata: Anthropic::Metadata,

data/rbi/anthropic/resources/beta/messages.rbi

@@ -320,6 +320,8 @@ module Anthropic
             max_tokens: Integer,
             messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
             container:
               T.nilable(
                 T.any(Anthropic::Beta::BetaContainerParams::OrHash, String)
@@ -467,6 +469,9 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
+          # Body param: Top-level cache control automatically applies a cache_control marker
+          # to the last cacheable block in the request.
+          cache_control: nil,
           # Body param: Container identifier for reuse across requests.
           container: nil,
           # Body param: Context management configuration.
@@ -655,6 +660,8 @@ module Anthropic
             max_tokens: Integer,
             messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
             container:
               T.nilable(
                 T.any(Anthropic::Beta::BetaContainerParams::OrHash, String)
@@ -806,6 +813,9 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
+          # Body param: Top-level cache control automatically applies a cache_control marker
+          # to the last cacheable block in the request.
+          cache_control: nil,
           # Body param: Container identifier for reuse across requests.
           container: nil,
           # Body param: Context management configuration.
@@ -990,6 +1000,8 @@ module Anthropic
           params(
             messages: T::Array[Anthropic::Beta::BetaMessageParam::OrHash],
             model: T.any(Anthropic::Model::OrSymbol, String),
+            cache_control:
+              T.nilable(Anthropic::Beta::BetaCacheControlEphemeral::OrHash),
             context_management:
               T.nilable(Anthropic::Beta::BetaContextManagementConfig::OrHash),
             mcp_servers:
@@ -1119,6 +1131,9 @@ module Anthropic
           # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
           # details and options.
           model:,
+          # Body param: Top-level cache control automatically applies a cache_control marker
+          # to the last cacheable block in the request.
+          cache_control: nil,
           # Body param: Context management configuration.
           #
           # This allows you to control how Claude manages context across multiple requests,

data/rbi/anthropic/resources/messages.rbi

@@ -21,6 +21,7 @@ module Anthropic
           max_tokens: Integer,
           messages: T::Array[Anthropic::MessageParam::OrHash],
           model: T.any(Anthropic::Model::OrSymbol, String),
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash),
           container: T.nilable(String),
           inference_geo: T.nilable(String),
           metadata: Anthropic::Metadata::OrHash,
@@ -147,6 +148,9 @@ module Anthropic
         # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         # details and options.
         model:,
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        cache_control: nil,
         # Container identifier for reuse across requests.
         container: nil,
         # Specifies the geographic region for inference processing. If not specified, the
@@ -607,6 +611,7 @@ module Anthropic
           max_tokens: Integer,
           messages: T::Array[Anthropic::MessageParam::OrHash],
           model: T.any(Anthropic::Model::OrSymbol, String),
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash),
           container: T.nilable(String),
           inference_geo: T.nilable(String),
           metadata: Anthropic::Metadata::OrHash,
@@ -737,6 +742,9 @@ module Anthropic
         # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         # details and options.
         model:,
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        cache_control: nil,
         # Container identifier for reuse across requests.
         container: nil,
         # Specifies the geographic region for inference processing. If not specified, the
@@ -902,6 +910,7 @@ module Anthropic
         params(
           messages: T::Array[Anthropic::MessageParam::OrHash],
           model: T.any(Anthropic::Model::OrSymbol, String),
+          cache_control: T.nilable(Anthropic::CacheControlEphemeral::OrHash),
           output_config: Anthropic::OutputConfig::OrHash,
           system_: Anthropic::MessageCountTokensParams::System::Variants,
           thinking:
@@ -1011,6 +1020,9 @@ module Anthropic
         # [models](https://docs.anthropic.com/en/docs/models-overview) for additional
         # details and options.
         model:,
+        # Top-level cache control automatically applies a cache_control marker to the last
+        # cacheable block in the request.
+        cache_control: nil,
         # Configuration options for the model's output, such as the output format.
         output_config: nil,
         # System prompt.

data/sig/anthropic/models/beta/message_count_tokens_params.rbs

@@ -5,6 +5,7 @@ module Anthropic
         {
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           context_management: Anthropic::Beta::BetaContextManagementConfig?,
           mcp_servers: ::Array[Anthropic::Beta::BetaRequestMCPServerURLDefinition],
           output_config: Anthropic::Beta::BetaOutputConfig,
@@ -26,6 +27,8 @@ module Anthropic
 
         attr_accessor model: Anthropic::Models::model
 
+        attr_accessor cache_control: Anthropic::Beta::BetaCacheControlEphemeral?
+
         attr_accessor context_management: Anthropic::Beta::BetaContextManagementConfig?
 
         attr_reader mcp_servers: ::Array[Anthropic::Beta::BetaRequestMCPServerURLDefinition]?
@@ -77,6 +80,7 @@ module Anthropic
         def initialize: (
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          ?cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           ?context_management: Anthropic::Beta::BetaContextManagementConfig?,
           ?mcp_servers: ::Array[Anthropic::Beta::BetaRequestMCPServerURLDefinition],
           ?output_config: Anthropic::Beta::BetaOutputConfig,
@@ -93,6 +97,7 @@ module Anthropic
         def to_hash: -> {
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           context_management: Anthropic::Beta::BetaContextManagementConfig?,
           mcp_servers: ::Array[Anthropic::Beta::BetaRequestMCPServerURLDefinition],
           output_config: Anthropic::Beta::BetaOutputConfig,

data/sig/anthropic/models/beta/message_create_params.rbs

@@ -6,6 +6,7 @@ module Anthropic
           max_tokens: Integer,
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           container: Anthropic::Models::Beta::MessageCreateParams::container?,
           context_management: Anthropic::Beta::BetaContextManagementConfig?,
           inference_geo: String?,
@@ -37,6 +38,8 @@ module Anthropic
 
         attr_accessor model: Anthropic::Models::model
 
+        attr_accessor cache_control: Anthropic::Beta::BetaCacheControlEphemeral?
+
         attr_accessor container: Anthropic::Models::Beta::MessageCreateParams::container?
 
         attr_accessor context_management: Anthropic::Beta::BetaContextManagementConfig?
@@ -121,6 +124,7 @@ module Anthropic
           max_tokens: Integer,
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          ?cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           ?container: Anthropic::Models::Beta::MessageCreateParams::container?,
           ?context_management: Anthropic::Beta::BetaContextManagementConfig?,
           ?inference_geo: String?,
@@ -146,6 +150,7 @@ module Anthropic
           max_tokens: Integer,
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           container: Anthropic::Models::Beta::MessageCreateParams::container?,
           context_management: Anthropic::Beta::BetaContextManagementConfig?,
           inference_geo: String?,

data/sig/anthropic/models/beta/messages/batch_create_params.rbs

@@ -59,6 +59,7 @@ module Anthropic
                 max_tokens: Integer,
                 messages: ::Array[Anthropic::Beta::BetaMessageParam],
                 model: Anthropic::Models::model,
+                cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
                 container: Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params::container?,
                 context_management: Anthropic::Beta::BetaContextManagementConfig?,
                 inference_geo: String?,
@@ -86,6 +87,8 @@ module Anthropic
 
               attr_accessor model: Anthropic::Models::model
 
+              attr_accessor cache_control: Anthropic::Beta::BetaCacheControlEphemeral?
+
               attr_accessor container: Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params::container?
 
               attr_accessor context_management: Anthropic::Beta::BetaContextManagementConfig?
@@ -168,6 +171,7 @@ module Anthropic
                 max_tokens: Integer,
                 messages: ::Array[Anthropic::Beta::BetaMessageParam],
                 model: Anthropic::Models::model,
+                ?cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
                 ?container: Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params::container?,
                 ?context_management: Anthropic::Beta::BetaContextManagementConfig?,
                 ?inference_geo: String?,
@@ -192,6 +196,7 @@ module Anthropic
                 max_tokens: Integer,
                 messages: ::Array[Anthropic::Beta::BetaMessageParam],
                 model: Anthropic::Models::model,
+                cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
                 container: Anthropic::Models::Beta::Messages::BatchCreateParams::Request::Params::container?,
                 context_management: Anthropic::Beta::BetaContextManagementConfig?,
                 inference_geo: String?,

data/sig/anthropic/models/message_count_tokens_params.rbs

@@ -4,6 +4,7 @@ module Anthropic
       {
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        cache_control: Anthropic::CacheControlEphemeral?,
         output_config: Anthropic::OutputConfig,
         system_: Anthropic::Models::MessageCountTokensParams::system_,
         thinking: Anthropic::Models::thinking_config_param,
@@ -20,6 +21,8 @@ module Anthropic
 
       attr_accessor model: Anthropic::Models::model
 
+      attr_accessor cache_control: Anthropic::CacheControlEphemeral?
+
       attr_reader output_config: Anthropic::OutputConfig?
 
       def output_config=: (Anthropic::OutputConfig) -> Anthropic::OutputConfig
@@ -51,6 +54,7 @@ module Anthropic
       def initialize: (
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        ?cache_control: Anthropic::CacheControlEphemeral?,
         ?output_config: Anthropic::OutputConfig,
         ?system_: Anthropic::Models::MessageCountTokensParams::system_,
         ?thinking: Anthropic::Models::thinking_config_param,
@@ -62,6 +66,7 @@ module Anthropic
       def to_hash: -> {
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        cache_control: Anthropic::CacheControlEphemeral?,
         output_config: Anthropic::OutputConfig,
         system_: Anthropic::Models::MessageCountTokensParams::system_,
         thinking: Anthropic::Models::thinking_config_param,

data/sig/anthropic/models/message_create_params.rbs

@@ -5,6 +5,7 @@ module Anthropic
         max_tokens: Integer,
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        cache_control: Anthropic::CacheControlEphemeral?,
         container: String?,
         inference_geo: String?,
         metadata: Anthropic::Metadata,
@@ -31,6 +32,8 @@ module Anthropic
 
       attr_accessor model: Anthropic::Models::model
 
+      attr_accessor cache_control: Anthropic::CacheControlEphemeral?
+
       attr_accessor container: String?
 
       attr_accessor inference_geo: String?
@@ -93,6 +96,7 @@ module Anthropic
         max_tokens: Integer,
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        ?cache_control: Anthropic::CacheControlEphemeral?,
         ?container: String?,
         ?inference_geo: String?,
         ?metadata: Anthropic::Metadata,
@@ -113,6 +117,7 @@ module Anthropic
         max_tokens: Integer,
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        cache_control: Anthropic::CacheControlEphemeral?,
         container: String?,
         inference_geo: String?,
         metadata: Anthropic::Metadata,

data/sig/anthropic/models/messages/batch_create_params.rbs

@@ -47,6 +47,7 @@ module Anthropic
               max_tokens: Integer,
               messages: ::Array[Anthropic::MessageParam],
               model: Anthropic::Models::model,
+              cache_control: Anthropic::CacheControlEphemeral?,
               container: String?,
               inference_geo: String?,
               metadata: Anthropic::Metadata,
@@ -70,6 +71,8 @@ module Anthropic
 
             attr_accessor model: Anthropic::Models::model
 
+            attr_accessor cache_control: Anthropic::CacheControlEphemeral?
+
             attr_accessor container: String?
 
             attr_accessor inference_geo: String?
@@ -138,6 +141,7 @@ module Anthropic
               max_tokens: Integer,
               messages: ::Array[Anthropic::MessageParam],
               model: Anthropic::Models::model,
+              ?cache_control: Anthropic::CacheControlEphemeral?,
               ?container: String?,
               ?inference_geo: String?,
               ?metadata: Anthropic::Metadata,
@@ -158,6 +162,7 @@ module Anthropic
               max_tokens: Integer,
               messages: ::Array[Anthropic::MessageParam],
               model: Anthropic::Models::model,
+              cache_control: Anthropic::CacheControlEphemeral?,
               container: String?,
               inference_geo: String?,
               metadata: Anthropic::Metadata,

data/sig/anthropic/resources/beta/messages.rbs

@@ -8,6 +8,7 @@ module Anthropic
           max_tokens: Integer,
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          ?cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           ?container: Anthropic::Models::Beta::MessageCreateParams::container?,
           ?context_management: Anthropic::Beta::BetaContextManagementConfig?,
           ?inference_geo: String?,
@@ -33,6 +34,7 @@ module Anthropic
           max_tokens: Integer,
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          ?cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           ?container: Anthropic::Models::Beta::MessageCreateParams::container?,
           ?context_management: Anthropic::Beta::BetaContextManagementConfig?,
           ?inference_geo: String?,
@@ -57,6 +59,7 @@ module Anthropic
         def count_tokens: (
           messages: ::Array[Anthropic::Beta::BetaMessageParam],
           model: Anthropic::Models::model,
+          ?cache_control: Anthropic::Beta::BetaCacheControlEphemeral?,
           ?context_management: Anthropic::Beta::BetaContextManagementConfig?,
           ?mcp_servers: ::Array[Anthropic::Beta::BetaRequestMCPServerURLDefinition],
           ?output_config: Anthropic::Beta::BetaOutputConfig,

data/sig/anthropic/resources/messages.rbs

@@ -7,6 +7,7 @@ module Anthropic
         max_tokens: Integer,
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        ?cache_control: Anthropic::CacheControlEphemeral?,
         ?container: String?,
         ?inference_geo: String?,
         ?metadata: Anthropic::Metadata,
@@ -27,6 +28,7 @@ module Anthropic
         max_tokens: Integer,
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        ?cache_control: Anthropic::CacheControlEphemeral?,
         ?container: String?,
         ?inference_geo: String?,
         ?metadata: Anthropic::Metadata,
@@ -46,6 +48,7 @@ module Anthropic
       def count_tokens: (
         messages: ::Array[Anthropic::MessageParam],
         model: Anthropic::Models::model,
+        ?cache_control: Anthropic::CacheControlEphemeral?,
         ?output_config: Anthropic::OutputConfig,
         ?system_: Anthropic::Models::MessageCountTokensParams::system_,
         ?thinking: Anthropic::Models::thinking_config_param,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anthropic
 version: !ruby/object:Gem::Version
-  version: 1.22.0
+  version: 1.23.0
 platform: ruby
 authors:
 - Anthropic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-18 00:00:00.000000000 Z
+date: 2026-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi