anthropic 1.80.0 → 2.3.0

data/rbi/anthropic/client.rbi

@@ -22,9 +22,6 @@ module Anthropic
     sig { returns(T.nilable(Anthropic::Credentials::TokenCache)) }
     attr_reader :token_cache
 
-    sig { returns(Anthropic::Resources::Completions) }
-    attr_reader :completions
-
     sig { returns(Anthropic::Resources::Messages) }
     attr_reader :messages
 
@@ -37,6 +34,9 @@ module Anthropic
     sig { returns(Anthropic::Resources::Skills) }
     attr_reader :skills
 
+    sig { returns(Anthropic::Resources::UserProfiles) }
+    attr_reader :user_profiles
+
     sig { returns(Anthropic::Resources::Organization) }
     attr_reader :organization
 
@@ -58,6 +58,11 @@ module Anthropic
     private def bearer_auth
     end
 
+    # @api private
+    sig { returns(T::Boolean) }
+    def message_threads?
+    end
+
     # @api private
     sig { returns(T::Boolean) }
     private def resolve_default_credentials?
@@ -74,6 +79,8 @@ module Anthropic
         api_key: T.nilable(String),
         auth_token: T.nilable(String),
         webhook_key: T.nilable(String),
+        credentials: T.untyped,
+        config: T.nilable(T::Hash[String, T.untyped]),
         base_url: T.nilable(String),
         proxy: T.nilable(T.any(String, URI::Generic)),
         max_retries: Integer,
@@ -86,12 +93,25 @@ module Anthropic
       ).returns(T.attached_class)
     end
     def self.new(
-      # Defaults to `ENV["ANTHROPIC_API_KEY"]`
-      api_key: ENV["ANTHROPIC_API_KEY"],
-      # Defaults to `ENV["ANTHROPIC_AUTH_TOKEN"]`
-      auth_token: ENV["ANTHROPIC_AUTH_TOKEN"],
+      # Defaults to `ENV["ANTHROPIC_API_KEY"]` when no explicit credential argument is
+      # passed.
+      api_key: nil,
+      # Defaults to `ENV["ANTHROPIC_AUTH_TOKEN"]` when no explicit credential argument
+      # is passed and `ANTHROPIC_API_KEY` is not set.
+      auth_token: nil,
       # Defaults to `ENV["ANTHROPIC_WEBHOOK_SIGNING_KEY"]`
       webhook_key: ENV["ANTHROPIC_WEBHOOK_SIGNING_KEY"],
+      # Credential provider — any callable returning
+      # `AccessToken.new(token:, expires_at:)`. The provider is wrapped in a
+      # `TokenCache` for thread-safe caching and proactive refresh (120s advisory / 30s
+      # mandatory before expiry). Common providers: `WorkloadIdentity`,
+      # `CredentialsFile`, `StaticToken`, or a custom lambda.
+      credentials: nil,
+      # In-memory configuration hash with the same shape as `configs/<profile>.json`.
+      # Must include an `authentication` object with a `type` field (`oidc_federation`
+      # or `user_oauth`). For `user_oauth`, must also include
+      # `authentication.credentials_path`.
+      config: nil,
       # Override the default base URL for the API, e.g.,
       # `"https://api.example.com/v2/"`. Defaults to `ENV["ANTHROPIC_BASE_URL"]`
       base_url: ENV["ANTHROPIC_BASE_URL"],

data/rbi/anthropic/helpers/aws/client.rbi

@@ -50,6 +50,19 @@ module Anthropic
         )
         end
 
+        # @api private
+        sig do
+          override
+            .params(
+              req:
+                Anthropic::Internal::Transport::BaseClient::RequestComponents,
+              opts: Anthropic::Internal::AnyHash
+            )
+            .returns(Anthropic::Internal::Transport::BaseClient::RequestInput)
+        end
+        private def build_request(req, opts)
+        end
+
         # @api private
         sig { override.returns(Anthropic::Middleware::Entry) }
         private def provider_middleware

data/rbi/anthropic/helpers/bedrock/client.rbi

@@ -4,14 +4,9 @@ module Anthropic
   module Helpers
     module Bedrock
       class Client < Anthropic::Client
-        DEFAULT_VERSION = "bedrock-2023-05-31"
-
         sig { returns(String) }
         attr_reader :aws_region
 
-        sig { returns(Anthropic::Resources::Completions) }
-        attr_reader :completions
-
         sig { returns(Anthropic::Resources::Messages) }
         attr_reader :messages
 
@@ -22,6 +17,11 @@ module Anthropic
         def models
         end
 
+        # @api private
+        sig { returns(T::Boolean) }
+        def message_threads?
+        end
+
         sig { returns(T.noreturn) }
         def files
         end
@@ -30,6 +30,10 @@ module Anthropic
         def skills
         end
 
+        sig { returns(T.noreturn) }
+        def user_profiles
+        end
+
         # @api private
         sig do
           override

data/rbi/anthropic/helpers/bedrock/mantle_client.rbi

@@ -52,11 +52,12 @@ module Anthropic
         end
 
         sig { returns(T.noreturn) }
-        def completions
+        def models
         end
 
-        sig { returns(T.noreturn) }
-        def models
+        # @api private
+        sig { returns(T::Boolean) }
+        def message_threads?
         end
 
         sig { returns(T.noreturn) }
@@ -67,10 +68,19 @@ module Anthropic
         def skills
         end
 
+        sig { returns(T.noreturn) }
+        def user_profiles
+        end
+
         # @api private
         sig { override.returns(Anthropic::Middleware::Entry) }
         private def provider_middleware
         end
+
+        # @api private
+        sig { params(req: Anthropic::APIRequest).returns(Anthropic::APIRequest) }
+        private def adapt_request(req)
+        end
       end
     end
   end

data/rbi/anthropic/helpers/google_cloud/client.rbi

@@ -15,8 +15,17 @@ module Anthropic
         sig { returns(T.nilable(String)) }
         attr_reader :workspace_id
 
-        sig { returns(T.noreturn) }
-        def completions
+        # @api private
+        sig do
+          override
+            .params(
+              req:
+                Anthropic::Internal::Transport::BaseClient::RequestComponents,
+              opts: Anthropic::Internal::AnyHash
+            )
+            .returns(Anthropic::Internal::Transport::BaseClient::RequestInput)
+        end
+        private def build_request(req, opts)
         end
 
         # @api private
@@ -40,8 +49,8 @@ module Anthropic
         end
 
         # @api private
-        sig { returns(String) }
-        private def derive_base_url
+        sig { params(template: String).returns(String) }
+        private def derive_base_url(template)
         end
 
         sig do

data/rbi/anthropic/helpers/threads/beta_message_thread.rbi

@@ -0,0 +1,100 @@
+# typed: strong
+
+module Anthropic
+  module Helpers
+    module Threads
+      # A conversation that the API keeps between requests, so that each turn sends only
+      # the messages that are new. Create one with `client.beta.messages.thread(...)`.
+      #
+      # A thread runs one turn at a time and is not safe for concurrent use.
+      class BetaMessageThread
+        # The whole history: every message that was sent, every reply, and the messages
+        # staged for the next turn.
+        sig { returns(T::Array[T::Hash[Symbol, T.anything]]) }
+        def messages
+        end
+
+        # The reply the next turn continues from, or `nil` when the next turn starts a new
+        # thread.
+        sig { returns(T.nilable(String)) }
+        def previous_message_id
+        end
+
+        # What `client.beta.messages.thread` takes to create a thread that behaves the
+        # same, with `messages` set to the whole history.
+        sig { returns(T::Hash[Symbol, T.anything]) }
+        def params
+        end
+
+        # Stages messages for the next turn without sending them.
+        sig do
+          params(
+            messages:
+              T.any(
+                Anthropic::Beta::BetaMessageParam::Variants,
+                Anthropic::Beta::BetaMessage,
+                Anthropic::Internal::AnyHash
+              )
+          ).void
+        end
+        def append(*messages)
+        end
+
+        # Changes the thread's request fields for every later turn, where `nil` removes a
+        # field. It sends no request. `system_` and `tools` cannot change once a turn has
+        # created the thread.
+        sig { params(params: T.anything).void }
+        def update(**params)
+        end
+
+        # Returns a new, independent thread with this thread's history and request fields.
+        # It sends no request.
+        sig { returns(Anthropic::Helpers::Threads::BetaMessageThread) }
+        def fork
+        end
+
+        # Creates a tool runner that runs over this thread. It sends no request.
+        sig do
+          params(max_iterations: T.nilable(Integer)).returns(
+            Anthropic::Helpers::Tools::Runner
+          )
+        end
+        def tool_runner(max_iterations: nil)
+        end
+
+        # Sends the messages staged with `#append`, followed by `messages`, as one turn
+        # and returns the reply. `params` takes the keywords of `#update` and applies to
+        # this turn only.
+        sig do
+          params(
+            messages:
+              T.any(
+                Anthropic::Beta::BetaMessageParam::Variants,
+                Anthropic::Beta::BetaMessage,
+                Anthropic::Internal::AnyHash
+              ),
+            params: T.anything
+          ).returns(Anthropic::Beta::BetaMessage)
+        end
+        def send_message(*messages, **params)
+        end
+
+        # Sends the next turn like `#send_message` and returns the stream of the reply.
+        # The turn is in progress until the stream ends or is closed.
+        sig do
+          params(
+            messages:
+              T.any(
+                Anthropic::Beta::BetaMessageParam::Variants,
+                Anthropic::Beta::BetaMessage,
+                Anthropic::Internal::AnyHash
+              ),
+            params: T.anything
+          ).returns(Anthropic::Streaming::MessageStream)
+        end
+        def stream(*messages, **params)
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/helpers/tools/runner.rbi

@@ -15,7 +15,11 @@ module Anthropic
 
         sig do
           params(
-            messages: Anthropic::Models::Beta::BetaMessageParam::OrHash
+            messages:
+              T.any(
+                Anthropic::Beta::BetaMessageParam::Variants,
+                Anthropic::Internal::AnyHash
+              )
           ).void
         end
         def feed_messages(*messages)

data/rbi/anthropic/helpers/vertex/client.rbi

@@ -4,8 +4,6 @@ module Anthropic
   module Helpers
     module Vertex
       class Client < Anthropic::Client
-        DEFAULT_VERSION = "vertex-2023-10-16"
-
         sig { returns(String) }
         attr_reader :region
 
@@ -23,6 +21,11 @@ module Anthropic
         private def resolve_default_credentials?
         end
 
+        # @api private
+        sig { returns(T::Boolean) }
+        def message_threads?
+        end
+
         sig { returns(T.noreturn) }
         def files
         end
@@ -31,6 +34,10 @@ module Anthropic
         def skills
         end
 
+        sig { returns(T.noreturn) }
+        def user_profiles
+        end
+
         # @api private
         sig do
           override

data/rbi/anthropic/internal/report_page_cursor.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Anthropic
+  module Internal
+    class ReportPageCursor
+      include Anthropic::Internal::Type::BasePage
+
+      Elem = type_member
+
+      sig { returns(T.nilable(T::Array[Elem])) }
+      attr_accessor :data
+
+      sig { returns(T.nilable(String)) }
+      attr_accessor :next_page_
+
+      sig { returns(T::Boolean) }
+      attr_accessor :has_more
+
+      sig { returns(T.nilable(Time)) }
+      attr_accessor :data_refreshed_at
+
+      # @api private
+      sig { returns(String) }
+      def inspect
+      end
+    end
+  end
+end

data/rbi/anthropic/internal/tracing.rbi

@@ -94,7 +94,6 @@ module Anthropic
       # The span name of each SDK method. Code that names a span through these fails to
       # load once no method has the name.
       module SpanName
-        COMPLETIONS_CREATE = "anthropic.completions.create"
         MESSAGES_CREATE = "anthropic.messages.create"
         MESSAGES_COUNT_TOKENS = "anthropic.messages.count_tokens"
         MESSAGES_BATCHES_CREATE = "anthropic.messages.batches.create"
@@ -118,6 +117,13 @@ module Anthropic
         SKILLS_VERSIONS_RETRIEVE = "anthropic.skills.versions.retrieve"
         SKILLS_VERSIONS_LIST = "anthropic.skills.versions.list"
         SKILLS_VERSIONS_DELETE = "anthropic.skills.versions.delete"
+        USER_PROFILES_CREATE = "anthropic.user_profiles.create"
+        USER_PROFILES_RETRIEVE = "anthropic.user_profiles.retrieve"
+        USER_PROFILES_UPDATE = "anthropic.user_profiles.update"
+        USER_PROFILES_LIST = "anthropic.user_profiles.list"
+        USER_PROFILES_DELETE = "anthropic.user_profiles.delete"
+        USER_PROFILES_ACTION_URLS_CREATE =
+          "anthropic.user_profiles.action_urls.create"
         ORGANIZATION_RETRIEVE = "anthropic.organization.retrieve"
         ORGANIZATION_API_KEYS_RETRIEVE =
           "anthropic.organization.api_keys.retrieve"
@@ -195,6 +201,8 @@ module Anthropic
         ORGANIZATION_WORKSPACES_LIST = "anthropic.organization.workspaces.list"
         ORGANIZATION_WORKSPACES_ARCHIVE =
           "anthropic.organization.workspaces.archive"
+        ORGANIZATION_WORKSPACES_RATE_LIMITS_UPDATE =
+          "anthropic.organization.workspaces.rate_limits.update"
         ORGANIZATION_WORKSPACES_RATE_LIMITS_LIST =
           "anthropic.organization.workspaces.rate_limits.list"
         ORGANIZATION_WORKSPACES_MEMBERS_RETRIEVE =
@@ -309,10 +317,6 @@ module Anthropic
         MEMORY_STORES_MEMORY_VERSIONS_REDACT =
           "anthropic.memory_stores.memory_versions.redact"
         SKILLS_VERSIONS_DOWNLOAD = "anthropic.skills.versions.download"
-        USER_PROFILES_CREATE = "anthropic.user_profiles.create"
-        USER_PROFILES_RETRIEVE = "anthropic.user_profiles.retrieve"
-        USER_PROFILES_UPDATE = "anthropic.user_profiles.update"
-        USER_PROFILES_LIST = "anthropic.user_profiles.list"
         USER_PROFILES_CREATE_ENROLLMENT_URL =
           "anthropic.user_profiles.create_enrollment_url"
         DREAMS_CREATE = "anthropic.dreams.create"
@@ -345,6 +349,10 @@ module Anthropic
           "anthropic.organization.analytics.skills.list"
         ORGANIZATION_ANALYTICS_ARTIFACTS_LIST =
           "anthropic.organization.analytics.artifacts.list"
+        ORGANIZATION_ANALYTICS_USAGE_LIST =
+          "anthropic.organization.analytics.usage.list"
+        ORGANIZATION_ANALYTICS_COST_LIST =
+          "anthropic.organization.analytics.cost.list"
         ORGANIZATION_ANALYTICS_USAGE_REPORT_LIST =
           "anthropic.organization.analytics.usage_report.list"
         ORGANIZATION_ANALYTICS_USER_USAGE_REPORT_LIST =
@@ -442,6 +450,42 @@ module Anthropic
           "anthropic.organization.telemetry_destinations.workspaces.add"
         ORGANIZATION_TELEMETRY_DESTINATIONS_WORKSPACES_REMOVE =
           "anthropic.organization.telemetry_destinations.workspaces.remove"
+        ORGANIZATION_WEBHOOKS_CREATE = "anthropic.organization.webhooks.create"
+        ORGANIZATION_WEBHOOKS_RETRIEVE =
+          "anthropic.organization.webhooks.retrieve"
+        ORGANIZATION_WEBHOOKS_UPDATE = "anthropic.organization.webhooks.update"
+        ORGANIZATION_WEBHOOKS_LIST = "anthropic.organization.webhooks.list"
+        ORGANIZATION_WEBHOOKS_DELETE = "anthropic.organization.webhooks.delete"
+        ORGANIZATION_WEBHOOKS_REGENERATE_SIGNING_SECRET =
+          "anthropic.organization.webhooks.regenerate_signing_secret"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_CREATE =
+          "anthropic.organization.claude_tag.slack_channels.create"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_RETRIEVE =
+          "anthropic.organization.claude_tag.slack_channels.retrieve"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_UPDATE =
+          "anthropic.organization.claude_tag.slack_channels.update"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_LIST =
+          "anthropic.organization.claude_tag.slack_channels.list"
+        ORGANIZATION_CLAUDE_TAG_SLACK_CHANNELS_DELETE =
+          "anthropic.organization.claude_tag.slack_channels.delete"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_RETRIEVE =
+          "anthropic.organization.claude_tag.slack_workspaces.retrieve"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_UPDATE =
+          "anthropic.organization.claude_tag.slack_workspaces.update"
+        ORGANIZATION_CLAUDE_TAG_SLACK_WORKSPACES_LIST =
+          "anthropic.organization.claude_tag.slack_workspaces.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_RETRIEVE =
+          "anthropic.organization.claude_tag.bundles.retrieve"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_LIST =
+          "anthropic.organization.claude_tag.bundles.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_CREATE =
+          "anthropic.organization.claude_tag.bundles.targets.create"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_RETRIEVE =
+          "anthropic.organization.claude_tag.bundles.targets.retrieve"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_LIST =
+          "anthropic.organization.claude_tag.bundles.targets.list"
+        ORGANIZATION_CLAUDE_TAG_BUNDLES_TARGETS_DELETE =
+          "anthropic.organization.claude_tag.bundles.targets.delete"
       end
 
       CLIENT_ATTRIBUTES = T.let(T.unsafe(nil), T::Hash[String, String])

data/rbi/anthropic/internal/transport/base_client.rbi

@@ -59,6 +59,7 @@ module Anthropic
                   ]
                 ),
               model: T.nilable(Anthropic::Internal::Type::Converter::Input),
+              qualifiers: T.nilable(T::Hash[Symbol, String]),
               span_name: T.nilable(String),
               span_attributes: T.nilable(T::Hash[String, T.anything]),
               span_created_id:
@@ -79,6 +80,7 @@ module Anthropic
               body: T.anything,
               max_retries: Integer,
               timeout: Float,
+              qualifiers: T.nilable(T::Hash[Symbol, String]),
               user_header_keys: T::Array[String],
               cast_to: T.nilable(Anthropic::Internal::Type::Converter::Input),
               stream: T.nilable(T::Class[T.anything]),
@@ -340,7 +342,7 @@ module Anthropic
         # Execute the request specified by `req`. This is the method that all resource
         # methods call into.
         #
-        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Anthropic::Internal::Type::Unknown, span_name: nil, span_attributes: nil, span_created_id: nil, span_route: nil, span_query: nil, span_content_query: nil, options: {})
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Anthropic::Internal::Type::Unknown, qualifiers: nil, span_name: nil, span_attributes: nil, span_created_id: nil, span_route: nil, span_query: nil, span_content_query: nil, options: {})
         sig do
           params(
             method: Symbol,
@@ -390,6 +392,7 @@ module Anthropic
                 ]
               ),
             model: T.nilable(Anthropic::Internal::Type::Converter::Input),
+            qualifiers: T.nilable(T::Hash[Symbol, String]),
             span_name: T.nilable(String),
             span_attributes: T.nilable(T::Hash[String, T.anything]),
             span_created_id: T.nilable(T.any(String, T::Hash[String, Symbol])),
@@ -409,6 +412,7 @@ module Anthropic
           page: nil,
           stream: nil,
           model: Anthropic::Internal::Type::Unknown,
+          qualifiers: nil,
           span_name: nil,
           span_attributes: nil,
           span_created_id: nil,

data/rbi/anthropic/internal/type/base_page.rbi

@@ -25,6 +25,8 @@ module Anthropic
         def to_enum
         end
 
+        alias_method :enum_for, :to_enum
+
         # @api private
         sig do
           params(

data/rbi/anthropic/internal/type/base_stream.rbi

@@ -45,6 +45,8 @@ module Anthropic
         def to_enum
         end
 
+        alias_method :enum_for, :to_enum
+
         # @api private
         sig do
           params(

data/rbi/anthropic/internal/type/request_parameters.rbi

@@ -12,6 +12,10 @@ module Anthropic
         sig { params(request_options: Anthropic::RequestOptions::OrHash).void }
         attr_writer :request_options
 
+        sig { params(mod: Module).void }
+        def self.included(mod)
+        end
+
         # @api private
         module Converter
           # @api private

data/rbi/anthropic/models/anthropic_beta.rbi

@@ -225,6 +225,23 @@ module Anthropic
           :"telemetry-destinations-2026-08-11",
           Anthropic::AnthropicBeta::TaggedSymbol
         )
+      WEBHOOKS_2026_10_07 =
+        T.let(:"webhooks-2026-10-07", Anthropic::AnthropicBeta::TaggedSymbol)
+      MESSAGE_THREADS_2026_08_12 =
+        T.let(
+          :"message-threads-2026-08-12",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
+      ANALYTICS_USAGE_COST_2026_08_24 =
+        T.let(
+          :"analytics-usage-cost-2026-08-24",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
+      EXPERIMENTAL_CLAUDE_TAG_2026_10_21 =
+        T.let(
+          :"experimental-claude-tag-2026-10-21",
+          Anthropic::AnthropicBeta::TaggedSymbol
+        )
     end
   end
 end

data/rbi/anthropic/models/assistant_message_param.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    class AssistantMessageParam < Anthropic::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Anthropic::AssistantMessageParam, Anthropic::Internal::AnyHash)
+        end
+
+      sig { returns(Anthropic::MessageContentParam::Variants) }
+      attr_accessor :content
+
+      sig { returns(Symbol) }
+      attr_accessor :role
+
+      sig do
+        params(
+          content: Anthropic::MessageContentParam::Variants,
+          role: Symbol
+        ).returns(T.attached_class)
+      end
+      def self.new(content:, role: :assistant)
+      end
+
+      sig do
+        override.returns(
+          { content: Anthropic::MessageContentParam::Variants, role: Symbol }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_assistant_message_param.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaAssistantMessageParam = Beta::BetaAssistantMessageParam
+
+    module Beta
+      class BetaAssistantMessageParam < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaAssistantMessageParam,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Anthropic::Beta::BetaMessageContentParam::Variants) }
+        attr_accessor :content
+
+        sig { returns(Symbol) }
+        attr_accessor :role
+
+        sig do
+          params(
+            content: Anthropic::Beta::BetaMessageContentParam::Variants,
+            role: Symbol
+          ).returns(T.attached_class)
+        end
+        def self.new(content:, role: :assistant)
+        end
+
+        sig do
+          override.returns(
+            {
+              content: Anthropic::Beta::BetaMessageContentParam::Variants,
+              role: Symbol
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_cache_miss_messages_changed.rbi

@@ -22,6 +22,13 @@ module Anthropic
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # A `cache_miss_reason` for a request whose `messages` differ from the previous
+        # request's in an earlier entry, instead of only having entries appended. The
+        # `model`, `system`, and `tools` match.
+        #
+        # See the
+        # [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types)
+        # to learn what to change for each reason.
         sig do
           params(cache_missed_input_tokens: Integer, type: Symbol).returns(
             T.attached_class

data/rbi/anthropic/models/beta/beta_cache_miss_model_changed.rbi

@@ -22,6 +22,12 @@ module Anthropic
         sig { returns(Symbol) }
         attr_accessor :type
 
+        # A `cache_miss_reason` for a request whose `model` or `speed` differs from the
+        # previous request's.
+        #
+        # See the
+        # [cache diagnostics guide](https://platform.claude.com/docs/en/build-with-claude/cache-diagnostics#cache-miss-reason-types)
+        # to learn what to change for each reason.
         sig do
           params(cache_missed_input_tokens: Integer, type: Symbol).returns(
             T.attached_class