anthropic 1.6.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7ddce47b08338bf4a2eb932fddbcc85b24d713f50b3ce167d459b39fa644f4ce
-  data.tar.gz: a2512742b5e084705306598a0f46c71abd407f0ad364bfd7f294fd22226ee91f
+  metadata.gz: 66fd9539680e78df8e330ac6a5c6efc4848f35c6878eb56ef0b491511562ecf1
+  data.tar.gz: 43ef2cdd7fd4f7d95d889115dbf302edb8355681283aec9b76f80f7b1734ee67
 SHA512:
-  metadata.gz: 67bbb70c8f49c7b42226f47ace877d55dba4b8544d8d2ec26bd669114fa78f77ad2a3445d40bc35acaab70e342f37621d0ee92a29a4b80b21ecd34666a4b3da1
-  data.tar.gz: 140d00ea5c494d0330c26f3345422b8f8efc4d7d31e8e206271dc02598e6c63387749ed4bb140b93e64eaf66bd85bb3f78b25f6767fc50d973b05e2d85f16da6
+  metadata.gz: 55fb0db67745e8506eb2a2ae9708908cf72f1f16eb795d1a4279962864d25e5f972b3be3f53cdacb0293ef17c9c8e84a65643158604c1e50de28fc44aaa7e494
+  data.tar.gz: 1d479ce6f1b913816cf60d1778f039d874ce701077d1ed6187c9df5e7ba3ce0254da280753c55607343b64ef62aae72c72540a3e28ce5de49a7117b14e326bca

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 1.7.0 (2025-08-13)
+
+Full Changelog: [v1.6.0...v1.7.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.6.0...v1.7.0)
+
+### Features
+
+* **api:** makes 1 hour TTL Cache Control generally available ([c2dbf3b](https://github.com/anthropics/anthropic-sdk-ruby/commit/c2dbf3bcc3137b53db4d0a5779a014d4c59609bc))
+
+
+### Chores
+
+* deprecate older claude-3-5 sonnet models ([#679](https://github.com/anthropics/anthropic-sdk-ruby/issues/679)) ([4a3fb20](https://github.com/anthropics/anthropic-sdk-ruby/commit/4a3fb2042b20ca34346e2fa914c77713e664b922))
+
 ## 1.6.0 (2025-08-12)
 
 Full Changelog: [v1.5.0...v1.6.0](https://github.com/anthropics/anthropic-sdk-ruby/compare/v1.5.0...v1.6.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.6.0"
+gem "anthropic", "~> 1.7.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/anthropic/models/cache_control_ephemeral.rb

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

data/lib/anthropic/models/cache_creation.rb

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

data/lib/anthropic/models/model.rb

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

data/lib/anthropic/models/usage.rb

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

data/lib/anthropic/models.rb

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

data/lib/anthropic/version.rb

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

data/lib/anthropic.rb

@@ -214,6 +214,7 @@ require_relative "anthropic/models/beta_permission_error"
 require_relative "anthropic/models/beta_rate_limit_error"
 require_relative "anthropic/models/billing_error"
 require_relative "anthropic/models/cache_control_ephemeral"
+require_relative "anthropic/models/cache_creation"
 require_relative "anthropic/models/citation_char_location"
 require_relative "anthropic/models/citation_char_location_param"
 require_relative "anthropic/models/citation_content_block_location"

data/rbi/anthropic/models/cache_control_ephemeral.rbi

@@ -11,13 +11,78 @@ module Anthropic
       sig { returns(Symbol) }
       attr_accessor :type
 
-      sig { params(type: Symbol).returns(T.attached_class) }
-      def self.new(type: :ephemeral)
+      # The time-to-live for the cache control breakpoint.
+      #
+      # This may be one the following values:
+      #
+      # - `5m`: 5 minutes
+      # - `1h`: 1 hour
+      #
+      # Defaults to `5m`.
+      sig do
+        returns(T.nilable(Anthropic::CacheControlEphemeral::TTL::OrSymbol))
       end
+      attr_reader :ttl
 
-      sig { override.returns({ type: Symbol }) }
+      sig { params(ttl: Anthropic::CacheControlEphemeral::TTL::OrSymbol).void }
+      attr_writer :ttl
+
+      sig do
+        params(
+          ttl: Anthropic::CacheControlEphemeral::TTL::OrSymbol,
+          type: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The time-to-live for the cache control breakpoint.
+        #
+        # This may be one the following values:
+        #
+        # - `5m`: 5 minutes
+        # - `1h`: 1 hour
+        #
+        # Defaults to `5m`.
+        ttl: nil,
+        type: :ephemeral
+      )
+      end
+
+      sig do
+        override.returns(
+          { type: Symbol, ttl: Anthropic::CacheControlEphemeral::TTL::OrSymbol }
+        )
+      end
       def to_hash
       end
+
+      # The time-to-live for the cache control breakpoint.
+      #
+      # This may be one the following values:
+      #
+      # - `5m`: 5 minutes
+      # - `1h`: 1 hour
+      #
+      # Defaults to `5m`.
+      module TTL
+        extend Anthropic::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Anthropic::CacheControlEphemeral::TTL) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TTL_5M =
+          T.let(:"5m", Anthropic::CacheControlEphemeral::TTL::TaggedSymbol)
+        TTL_1H =
+          T.let(:"1h", Anthropic::CacheControlEphemeral::TTL::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[Anthropic::CacheControlEphemeral::TTL::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
     end
   end
 end

data/rbi/anthropic/models/cache_creation.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    class CacheCreation < Anthropic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Anthropic::CacheCreation, Anthropic::Internal::AnyHash)
+        end
+
+      # The number of input tokens used to create the 1 hour cache entry.
+      sig { returns(Integer) }
+      attr_accessor :ephemeral_1h_input_tokens
+
+      # The number of input tokens used to create the 5 minute cache entry.
+      sig { returns(Integer) }
+      attr_accessor :ephemeral_5m_input_tokens
+
+      sig do
+        params(
+          ephemeral_1h_input_tokens: Integer,
+          ephemeral_5m_input_tokens: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The number of input tokens used to create the 1 hour cache entry.
+        ephemeral_1h_input_tokens:,
+        # The number of input tokens used to create the 5 minute cache entry.
+        ephemeral_5m_input_tokens:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            ephemeral_1h_input_tokens: Integer,
+            ephemeral_5m_input_tokens: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/anthropic/models/usage.rbi

@@ -6,6 +6,15 @@ module Anthropic
       OrHash =
         T.type_alias { T.any(Anthropic::Usage, Anthropic::Internal::AnyHash) }
 
+      # Breakdown of cached tokens by TTL
+      sig { returns(T.nilable(Anthropic::CacheCreation)) }
+      attr_reader :cache_creation
+
+      sig do
+        params(cache_creation: T.nilable(Anthropic::CacheCreation::OrHash)).void
+      end
+      attr_writer :cache_creation
+
       # The number of input tokens used to create the cache entry.
       sig { returns(T.nilable(Integer)) }
       attr_accessor :cache_creation_input_tokens
@@ -39,6 +48,7 @@ module Anthropic
 
       sig do
         params(
+          cache_creation: T.nilable(Anthropic::CacheCreation::OrHash),
           cache_creation_input_tokens: T.nilable(Integer),
           cache_read_input_tokens: T.nilable(Integer),
           input_tokens: Integer,
@@ -48,6 +58,8 @@ module Anthropic
         ).returns(T.attached_class)
       end
       def self.new(
+        # Breakdown of cached tokens by TTL
+        cache_creation:,
         # The number of input tokens used to create the cache entry.
         cache_creation_input_tokens:,
         # The number of input tokens read from the cache.
@@ -66,6 +78,7 @@ module Anthropic
       sig do
         override.returns(
           {
+            cache_creation: T.nilable(Anthropic::CacheCreation),
             cache_creation_input_tokens: T.nilable(Integer),
             cache_read_input_tokens: T.nilable(Integer),
             input_tokens: Integer,

data/rbi/anthropic/models.rbi

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

data/sig/anthropic/models/cache_control_ephemeral.rbs

@@ -1,13 +1,37 @@
 module Anthropic
   module Models
-    type cache_control_ephemeral = { type: :ephemeral }
+    type cache_control_ephemeral =
+      { type: :ephemeral, ttl: Anthropic::Models::CacheControlEphemeral::ttl }
 
     class CacheControlEphemeral < Anthropic::Internal::Type::BaseModel
       attr_accessor type: :ephemeral
 
-      def initialize: (?type: :ephemeral) -> void
+      attr_reader ttl: Anthropic::Models::CacheControlEphemeral::ttl?
 
-      def to_hash: -> { type: :ephemeral }
+      def ttl=: (
+        Anthropic::Models::CacheControlEphemeral::ttl
+      ) -> Anthropic::Models::CacheControlEphemeral::ttl
+
+      def initialize: (
+        ?ttl: Anthropic::Models::CacheControlEphemeral::ttl,
+        ?type: :ephemeral
+      ) -> void
+
+      def to_hash: -> {
+        type: :ephemeral,
+        ttl: Anthropic::Models::CacheControlEphemeral::ttl
+      }
+
+      type ttl = :"5m" | :"1h"
+
+      module TTL
+        extend Anthropic::Internal::Type::Enum
+
+        TTL_5M: :"5m"
+        TTL_1H: :"1h"
+
+        def self?.values: -> ::Array[Anthropic::Models::CacheControlEphemeral::ttl]
+      end
     end
   end
 end

data/sig/anthropic/models/cache_creation.rbs

@@ -0,0 +1,25 @@
+module Anthropic
+  module Models
+    type cache_creation =
+      {
+        :ephemeral_1h_input_tokens => Integer,
+        :ephemeral_5m_input_tokens => Integer
+      }
+
+    class CacheCreation < Anthropic::Internal::Type::BaseModel
+      attr_accessor ephemeral_1h_input_tokens: Integer
+
+      attr_accessor ephemeral_5m_input_tokens: Integer
+
+      def initialize: (
+        ephemeral_1h_input_tokens: Integer,
+        ephemeral_5m_input_tokens: Integer
+      ) -> void
+
+      def to_hash: -> {
+        :ephemeral_1h_input_tokens => Integer,
+        :ephemeral_5m_input_tokens => Integer
+      }
+    end
+  end
+end

data/sig/anthropic/models/usage.rbs

@@ -2,6 +2,7 @@ module Anthropic
   module Models
     type usage =
       {
+        cache_creation: Anthropic::CacheCreation?,
         cache_creation_input_tokens: Integer?,
         cache_read_input_tokens: Integer?,
         input_tokens: Integer,
@@ -11,6 +12,8 @@ module Anthropic
       }
 
     class Usage < Anthropic::Internal::Type::BaseModel
+      attr_accessor cache_creation: Anthropic::CacheCreation?
+
       attr_accessor cache_creation_input_tokens: Integer?
 
       attr_accessor cache_read_input_tokens: Integer?
@@ -24,6 +27,7 @@ module Anthropic
       attr_accessor service_tier: Anthropic::Models::Usage::service_tier?
 
       def initialize: (
+        cache_creation: Anthropic::CacheCreation?,
         cache_creation_input_tokens: Integer?,
         cache_read_input_tokens: Integer?,
         input_tokens: Integer,
@@ -33,6 +37,7 @@ module Anthropic
       ) -> void
 
       def to_hash: -> {
+        cache_creation: Anthropic::CacheCreation?,
         cache_creation_input_tokens: Integer?,
         cache_read_input_tokens: Integer?,
         input_tokens: Integer,

data/sig/anthropic/models.rbs

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anthropic
 version: !ruby/object:Gem::Version
-  version: 1.6.0
+  version: 1.7.0
 platform: ruby
 authors:
 - Anthropic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-12 00:00:00.000000000 Z
+date: 2025-08-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -221,6 +221,7 @@ files:
 - lib/anthropic/models/beta_rate_limit_error.rb
 - lib/anthropic/models/billing_error.rb
 - lib/anthropic/models/cache_control_ephemeral.rb
+- lib/anthropic/models/cache_creation.rb
 - lib/anthropic/models/citation_char_location.rb
 - lib/anthropic/models/citation_char_location_param.rb
 - lib/anthropic/models/citation_content_block_location.rb
@@ -529,6 +530,7 @@ files:
 - rbi/anthropic/models/beta_rate_limit_error.rbi
 - rbi/anthropic/models/billing_error.rbi
 - rbi/anthropic/models/cache_control_ephemeral.rbi
+- rbi/anthropic/models/cache_creation.rbi
 - rbi/anthropic/models/citation_char_location.rbi
 - rbi/anthropic/models/citation_char_location_param.rbi
 - rbi/anthropic/models/citation_content_block_location.rbi
@@ -836,6 +838,7 @@ files:
 - sig/anthropic/models/beta_rate_limit_error.rbs
 - sig/anthropic/models/billing_error.rbs
 - sig/anthropic/models/cache_control_ephemeral.rbs
+- sig/anthropic/models/cache_creation.rbs
 - sig/anthropic/models/citation_char_location.rbs
 - sig/anthropic/models/citation_char_location_param.rbs
 - sig/anthropic/models/citation_content_block_location.rbs