anthropic 2.1.0 → 2.2.0

data/lib/anthropic.rb

@@ -662,6 +662,7 @@ require_relative "anthropic/models/beta/beta_message_content_param"
 require_relative "anthropic/models/beta/beta_message_delta_usage"
 require_relative "anthropic/models/beta/beta_message_iteration_usage"
 require_relative "anthropic/models/beta/beta_message_param"
+require_relative "anthropic/models/beta/beta_message_thread_param"
 require_relative "anthropic/models/beta/beta_message_tokens_count"
 require_relative "anthropic/models/beta/beta_metadata"
 require_relative "anthropic/models/beta/beta_model_capabilities"
@@ -749,6 +750,8 @@ require_relative "anthropic/models/beta/beta_thinking_mismatch_allowed_input_tra
 require_relative "anthropic/models/beta/beta_thinking_prefix_mismatch_behavior"
 require_relative "anthropic/models/beta/beta_thinking_turns"
 require_relative "anthropic/models/beta/beta_thinking_types"
+require_relative "anthropic/models/beta/beta_thread_continue_params"
+require_relative "anthropic/models/beta/beta_thread_create_params"
 require_relative "anthropic/models/beta/beta_token_task_budget"
 require_relative "anthropic/models/beta/beta_tool"
 require_relative "anthropic/models/beta/beta_tool_bash_20241022"
@@ -969,11 +972,23 @@ require_relative "anthropic/models/beta/model_list_params"
 require_relative "anthropic/models/beta/model_retrieve_params"
 require_relative "anthropic/models/beta/organization/analytics/apps/chat/project_list_params"
 require_relative "anthropic/models/beta/organization/analytics/artifact_list_params"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_cost_group"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_cost_group_by"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_cost_item"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_cost_metrics"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_cost_order_by"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_usage_group"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_usage_group_by"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_usage_item"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_usage_metrics"
+require_relative "anthropic/models/beta/organization/analytics/beta_analytics_usage_order_by"
 require_relative "anthropic/models/beta/organization/analytics/connector_list_params"
+require_relative "anthropic/models/beta/organization/analytics/cost_list_params"
 require_relative "anthropic/models/beta/organization/analytics/cost_report_list_params"
 require_relative "anthropic/models/beta/organization/analytics/plugin_list_params"
 require_relative "anthropic/models/beta/organization/analytics/skill_list_params"
 require_relative "anthropic/models/beta/organization/analytics/summary_list_params"
+require_relative "anthropic/models/beta/organization/analytics/usage_list_params"
 require_relative "anthropic/models/beta/organization/analytics/usage_report_list_params"
 require_relative "anthropic/models/beta/organization/analytics/user_cost_report_list_params"
 require_relative "anthropic/models/beta/organization/analytics/user_list_params"
@@ -982,6 +997,9 @@ require_relative "anthropic/models/beta/organization/api_key_list_params"
 require_relative "anthropic/models/beta/organization/api_key_retrieve_params"
 require_relative "anthropic/models/beta/organization/api_key_update_params"
 require_relative "anthropic/models/beta/organization/beta_allowed_inference_geo"
+require_relative "anthropic/models/beta/organization/beta_analytics_actor"
+require_relative "anthropic/models/beta/organization/beta_analytics_actor_type"
+require_relative "anthropic/models/beta/organization/beta_analytics_api_actor"
 require_relative "anthropic/models/beta/organization/beta_analytics_artifact_activity"
 require_relative "anthropic/models/beta/organization/beta_analytics_chat_cowork_unified_chat_metrics"
 require_relative "anthropic/models/beta/organization/beta_analytics_chat_cowork_unified_sessions_metrics"
@@ -1004,6 +1022,13 @@ require_relative "anthropic/models/beta/organization/beta_analytics_cost_type"
 require_relative "anthropic/models/beta/organization/beta_analytics_cost_users_item"
 require_relative "anthropic/models/beta/organization/beta_analytics_cowork_metrics"
 require_relative "anthropic/models/beta/organization/beta_analytics_design_metrics"
+require_relative "anthropic/models/beta/organization/beta_analytics_federated_actor"
+require_relative "anthropic/models/beta/organization/beta_analytics_federated_actor_aws_provider"
+require_relative "anthropic/models/beta/organization/beta_analytics_federated_actor_azure_provider"
+require_relative "anthropic/models/beta/organization/beta_analytics_federated_actor_gcp_provider"
+require_relative "anthropic/models/beta/organization/beta_analytics_federated_actor_oidc_provider"
+require_relative "anthropic/models/beta/organization/beta_analytics_federated_actor_provider"
+require_relative "anthropic/models/beta/organization/beta_analytics_grouped_cost_type"
 require_relative "anthropic/models/beta/organization/beta_analytics_inference_geo_filter"
 require_relative "anthropic/models/beta/organization/beta_analytics_lines_of_code"
 require_relative "anthropic/models/beta/organization/beta_analytics_office_metrics"
@@ -1013,8 +1038,11 @@ require_relative "anthropic/models/beta/organization/beta_analytics_plugin_claud
 require_relative "anthropic/models/beta/organization/beta_analytics_plugin_cowork_metrics"
 require_relative "anthropic/models/beta/organization/beta_analytics_product_filter"
 require_relative "anthropic/models/beta/organization/beta_analytics_project_activity"
+require_relative "anthropic/models/beta/organization/beta_analytics_report_user_actor"
 require_relative "anthropic/models/beta/organization/beta_analytics_science_metrics"
 require_relative "anthropic/models/beta/organization/beta_analytics_server_tool_use"
+require_relative "anthropic/models/beta/organization/beta_analytics_service_account_actor"
+require_relative "anthropic/models/beta/organization/beta_analytics_service_tier"
 require_relative "anthropic/models/beta/organization/beta_analytics_single_day_activity_summary"
 require_relative "anthropic/models/beta/organization/beta_analytics_skill_activity"
 require_relative "anthropic/models/beta/organization/beta_analytics_skill_chat_cowork_unified_chat_metrics"
@@ -1024,10 +1052,15 @@ require_relative "anthropic/models/beta/organization/beta_analytics_skill_claude
 require_relative "anthropic/models/beta/organization/beta_analytics_skill_cowork_metrics"
 require_relative "anthropic/models/beta/organization/beta_analytics_skill_office_metrics"
 require_relative "anthropic/models/beta/organization/beta_analytics_skill_office_product_metrics"
+require_relative "anthropic/models/beta/organization/beta_analytics_speed"
+require_relative "anthropic/models/beta/organization/beta_analytics_time_bucket_width"
 require_relative "anthropic/models/beta/organization/beta_analytics_token_type"
 require_relative "anthropic/models/beta/organization/beta_analytics_tool_action_counts"
 require_relative "anthropic/models/beta/organization/beta_analytics_tool_actions"
 require_relative "anthropic/models/beta/organization/beta_analytics_usage_bucketed_result"
+require_relative "anthropic/models/beta/organization/beta_analytics_usage_cost_inference_geo"
+require_relative "anthropic/models/beta/organization/beta_analytics_usage_cost_product_filter"
+require_relative "anthropic/models/beta/organization/beta_analytics_usage_cost_sort_order"
 require_relative "anthropic/models/beta/organization/beta_analytics_usage_report_time_bucket"
 require_relative "anthropic/models/beta/organization/beta_analytics_usage_users_item"
 require_relative "anthropic/models/beta/organization/beta_analytics_user"
@@ -2108,10 +2141,12 @@ require_relative "anthropic/resources/beta/organization/analytics/apps/chat"
 require_relative "anthropic/resources/beta/organization/analytics/apps/chat/projects"
 require_relative "anthropic/resources/beta/organization/analytics/artifacts"
 require_relative "anthropic/resources/beta/organization/analytics/connectors"
+require_relative "anthropic/resources/beta/organization/analytics/cost"
 require_relative "anthropic/resources/beta/organization/analytics/cost_report"
 require_relative "anthropic/resources/beta/organization/analytics/plugins"
 require_relative "anthropic/resources/beta/organization/analytics/skills"
 require_relative "anthropic/resources/beta/organization/analytics/summaries"
+require_relative "anthropic/resources/beta/organization/analytics/usage"
 require_relative "anthropic/resources/beta/organization/analytics/usage_report"
 require_relative "anthropic/resources/beta/organization/analytics/user_cost_report"
 require_relative "anthropic/resources/beta/organization/analytics/users"
@@ -2191,4 +2226,5 @@ require_relative "anthropic/helpers/tools/runner"
 require_relative "anthropic/helpers/tools/base_tool"
 require_relative "anthropic/helpers/tools/mcp"
 require_relative "anthropic/helpers/tools"
+require_relative "anthropic/helpers/threads/beta_message_thread"
 require_relative "anthropic/mcp"

data/rbi/anthropic/client.rbi

@@ -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?

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

@@ -17,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

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

@@ -55,6 +55,11 @@ module Anthropic
         def models
         end
 
+        # @api private
+        sig { returns(T::Boolean) }
+        def message_threads?
+        end
+
         sig { returns(T.noreturn) }
         def files
         end

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/vertex/client.rbi

@@ -21,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

data/rbi/anthropic/internal/tracing.rbi

@@ -349,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 =

data/rbi/anthropic/models/anthropic_beta.rbi

@@ -227,6 +227,16 @@ module Anthropic
         )
       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
+        )
     end
   end
 end

data/rbi/anthropic/models/beta/beta_message_thread_param.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaMessageThreadParam = Beta::BetaMessageThreadParam
+
+    module Beta
+      # Server-held conversation state (a Thread). `{"type": "create"}` asks the server
+      # to hold this conversation's state under the response's `id`;
+      # `{"type": "continue", "previous_message_id": ...}` resumes from a previous
+      # response so only the new turn's messages are sent. The response shape is
+      # unchanged.
+      module BetaMessageThreadParam
+        extend Anthropic::Internal::Type::Union
+
+        Variants =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaThreadCreateParams,
+              Anthropic::Beta::BetaThreadContinueParams
+            )
+          end
+
+        module Type
+          extend Anthropic::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Anthropic::Beta::BetaMessageThreadParam::Type)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          CREATE =
+            T.let(
+              :create,
+              Anthropic::Beta::BetaMessageThreadParam::Type::TaggedSymbol
+            )
+          CONTINUE =
+            T.let(
+              :continue,
+              Anthropic::Beta::BetaMessageThreadParam::Type::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Anthropic::Beta::BetaMessageThreadParam::Type::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        sig do
+          override.returns(
+            T::Array[Anthropic::Beta::BetaMessageThreadParam::Variants]
+          )
+        end
+        def self.variants
+        end
+
+        # Creates a new instance of the variant class whose `type` matches the given
+        # value, passing the remaining arguments to its constructor.
+        sig do
+          params(
+            type: Anthropic::Beta::BetaMessageThreadParam::Type::OrSymbol,
+            previous_message_id: String
+          ).returns(Anthropic::Beta::BetaMessageThreadParam::Variants)
+        end
+        def self.new(
+          type:,
+          # The `id` of the previous response in this Thread.
+          previous_message_id: nil
+        )
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_thread_continue_params.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaThreadContinueParams = Beta::BetaThreadContinueParams
+
+    module Beta
+      class BetaThreadContinueParams < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaThreadContinueParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        # The `id` of the previous response in this Thread.
+        sig { returns(String) }
+        attr_accessor :previous_message_id
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Resume from the response named by `previous_message_id`.
+        sig do
+          params(previous_message_id: String, type: Symbol).returns(
+            T.attached_class
+          )
+        end
+        def self.new(
+          # The `id` of the previous response in this Thread.
+          previous_message_id:,
+          type: :continue
+        )
+        end
+
+        sig { override.returns({ previous_message_id: String, type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/anthropic/models/beta/beta_thread_create_params.rbi

@@ -0,0 +1,31 @@
+# typed: strong
+
+module Anthropic
+  module Models
+    BetaThreadCreateParams = Beta::BetaThreadCreateParams
+
+    module Beta
+      class BetaThreadCreateParams < Anthropic::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Anthropic::Beta::BetaThreadCreateParams,
+              Anthropic::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Symbol) }
+        attr_accessor :type
+
+        # Start holding conversation state under this response's `id`.
+        sig { params(type: Symbol).returns(T.attached_class) }
+        def self.new(type: :create)
+        end
+
+        sig { override.returns({ type: Symbol }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

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

@@ -398,6 +398,23 @@ module Anthropic
         end
         attr_writer :thinking
 
+        # Server-held conversation state (a Thread). `{"type": "create"}` asks the server
+        # to hold this conversation's state under the response's `id`;
+        # `{"type": "continue", "previous_message_id": ...}` resumes from a previous
+        # response so only the new turn's messages are sent. The response shape is
+        # unchanged.
+        sig do
+          returns(
+            T.nilable(
+              T.any(
+                Anthropic::Beta::BetaThreadCreateParams,
+                Anthropic::Beta::BetaThreadContinueParams
+              )
+            )
+          )
+        end
+        attr_accessor :thread
+
         # How the model should use the provided tools. The model can use a specific tool,
         # any available tool, decide by itself, or not use tools at all.
         sig do
@@ -680,6 +697,13 @@ module Anthropic
                 Anthropic::Beta::BetaThinkingConfigBetweenTools::OrHash,
                 Anthropic::Beta::BetaThinkingConfigAdaptive::OrHash
               ),
+            thread:
+              T.nilable(
+                T.any(
+                  Anthropic::Beta::BetaThreadCreateParams::OrHash,
+                  Anthropic::Beta::BetaThreadContinueParams::OrHash
+                )
+              ),
             tool_choice:
               T.any(
                 Anthropic::Beta::BetaToolChoiceAuto::OrHash,
@@ -925,6 +949,12 @@ module Anthropic
           # [thinking](https://platform.claude.com/docs/en/build-with-claude/thinking#configuring-thinking)
           # for each model's behavior.
           thinking: nil,
+          # Server-held conversation state (a Thread). `{"type": "create"}` asks the server
+          # to hold this conversation's state under the response's `id`;
+          # `{"type": "continue", "previous_message_id": ...}` resumes from a previous
+          # response so only the new turn's messages are sent. The response shape is
+          # unchanged.
+          thread: nil,
           # How the model should use the provided tools. The model can use a specific tool,
           # any available tool, decide by itself, or not use tools at all.
           tool_choice: nil,
@@ -1072,6 +1102,13 @@ module Anthropic
                   Anthropic::Beta::BetaThinkingConfigBetweenTools,
                   Anthropic::Beta::BetaThinkingConfigAdaptive
                 ),
+              thread:
+                T.nilable(
+                  T.any(
+                    Anthropic::Beta::BetaThreadCreateParams,
+                    Anthropic::Beta::BetaThreadContinueParams
+                  )
+                ),
               tool_choice:
                 T.any(
                   Anthropic::Beta::BetaToolChoiceAuto,

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

@@ -611,6 +611,23 @@ module Anthropic
               end
               attr_writer :thinking
 
+              # Server-held conversation state (a Thread). `{"type": "create"}` asks the server
+              # to hold this conversation's state under the response's `id`;
+              # `{"type": "continue", "previous_message_id": ...}` resumes from a previous
+              # response so only the new turn's messages are sent. The response shape is
+              # unchanged.
+              sig do
+                returns(
+                  T.nilable(
+                    T.any(
+                      Anthropic::Beta::BetaThreadCreateParams,
+                      Anthropic::Beta::BetaThreadContinueParams
+                    )
+                  )
+                )
+              end
+              attr_accessor :thread
+
               # How the model should use the provided tools. The model can use a specific tool,
               # any available tool, decide by itself, or not use tools at all.
               sig do
@@ -872,6 +889,13 @@ module Anthropic
                       Anthropic::Beta::BetaThinkingConfigBetweenTools::OrHash,
                       Anthropic::Beta::BetaThinkingConfigAdaptive::OrHash
                     ),
+                  thread:
+                    T.nilable(
+                      T.any(
+                        Anthropic::Beta::BetaThreadCreateParams::OrHash,
+                        Anthropic::Beta::BetaThreadContinueParams::OrHash
+                      )
+                    ),
                   tool_choice:
                     T.any(
                       Anthropic::Beta::BetaToolChoiceAuto::OrHash,
@@ -1122,6 +1146,12 @@ module Anthropic
                 # [thinking](https://platform.claude.com/docs/en/build-with-claude/thinking#configuring-thinking)
                 # for each model's behavior.
                 thinking: nil,
+                # Server-held conversation state (a Thread). `{"type": "create"}` asks the server
+                # to hold this conversation's state under the response's `id`;
+                # `{"type": "continue", "previous_message_id": ...}` resumes from a previous
+                # response so only the new turn's messages are sent. The response shape is
+                # unchanged.
+                thread: nil,
                 # How the model should use the provided tools. The model can use a specific tool,
                 # any available tool, decide by itself, or not use tools at all.
                 tool_choice: nil,
@@ -1271,6 +1301,13 @@ module Anthropic
                         Anthropic::Beta::BetaThinkingConfigBetweenTools,
                         Anthropic::Beta::BetaThinkingConfigAdaptive
                       ),
+                    thread:
+                      T.nilable(
+                        T.any(
+                          Anthropic::Beta::BetaThreadCreateParams,
+                          Anthropic::Beta::BetaThreadContinueParams
+                        )
+                      ),
                     tool_choice:
                       T.any(
                         Anthropic::Beta::BetaToolChoiceAuto,