anthropic 2.1.0 → 2.2.0

data/lib/anthropic/models/beta/organization/beta_analytics_federated_actor_provider.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsFederatedActorProvider
+          extend Anthropic::Internal::Type::Union
+
+          discriminator :type
+
+          variant :aws, -> { Anthropic::Beta::Organization::BetaAnalyticsFederatedActorAWSProvider }
+
+          variant :azure, -> { Anthropic::Beta::Organization::BetaAnalyticsFederatedActorAzureProvider }
+
+          variant :gcp, -> { Anthropic::Beta::Organization::BetaAnalyticsFederatedActorGCPProvider }
+
+          variant :oidc, -> { Anthropic::Beta::Organization::BetaAnalyticsFederatedActorOIDCProvider }
+
+          module Type
+            extend Anthropic::Internal::Type::Enum
+
+            AWS = :aws
+            AZURE = :azure
+            GCP = :gcp
+            OIDC = :oidc
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # @!method self.variants
+          #   @return [Array(Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorAWSProvider, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorAzureProvider, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorGCPProvider, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorOIDCProvider)]
+
+          # Creates a new instance of the variant class whose `type` matches the given
+          # value, passing the remaining arguments to its constructor.
+          #
+          # @param type [Symbol, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorProvider::Type, String]
+          #
+          # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
+          #
+          #   @option args [String] :account_id The AWS account the organization is bound to.
+          #
+          #   @option args [String] :signed_principal The AWS-signed ARN of the IAM principal that made the requests.
+          #
+          #   @option args [String] :subscription_id The Azure subscription the organization is bound to.
+          #
+          #   @option args [String] :project_number The Google Cloud project the organization is bound to.
+          #
+          #   @option args [String, nil] :issuer The federation issuer's URL.
+          #
+          # @raise [ArgumentError]
+          # @return [Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorAWSProvider, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorAzureProvider, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorGCPProvider, Anthropic::Models::Beta::Organization::BetaAnalyticsFederatedActorOIDCProvider]
+          def self.new(type:, **args)
+            case type.to_sym
+            when :aws
+              Anthropic::Beta::Organization::BetaAnalyticsFederatedActorAWSProvider.new(**args)
+            when :azure
+              Anthropic::Beta::Organization::BetaAnalyticsFederatedActorAzureProvider.new(**args)
+            when :gcp
+              Anthropic::Beta::Organization::BetaAnalyticsFederatedActorGCPProvider.new(**args)
+            when :oidc
+              Anthropic::Beta::Organization::BetaAnalyticsFederatedActorOIDCProvider.new(**args)
+            else
+              raise ArgumentError, "unknown type: #{type}"
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_grouped_cost_type.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsGroupedCostType
+          extend Anthropic::Internal::Type::Enum
+
+          CODE_EXECUTION = :code_execution
+          SESSION_USAGE = :session_usage
+          TOKENS = :tokens
+          WEB_SEARCH = :web_search
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_report_user_actor.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsReportUserActor < Anthropic::Internal::Type::BaseModel
+          # @!attribute deleted
+          #   True when the account has been deleted, or when the user is no longer a member
+          #   of the organization or its associated organizations (for example, their
+          #   membership was removed or they were deprovisioned via your identity provider).
+          #   `email_address` stays populated for removed users and is null when the account
+          #   has been deleted. `name` follows the rules described on that field. The
+          #   `user_id` is still populated for reconciliation.
+          #
+          #   @return [Boolean]
+          required :deleted, Anthropic::Internal::Type::Boolean
+
+          # @!attribute email_address
+          #   The user's current email address, including for users who are no longer members
+          #   of the organization. Null when the account has been deleted and for
+          #   system-minted service accounts.
+          #
+          #   @return [String, nil]
+          required :email_address, String, nil?: true
+
+          # @!attribute name
+          #   The user's current full name. Null when the user has not set one.
+          #   `"Deleted User"` when the account has been deleted, or when the user is no
+          #   longer a member and the organization hides removed users' names.
+          #
+          #   @return [String, nil]
+          required :name, String, nil?: true
+
+          # @!attribute type
+          #   Actor type. Always `"user_actor"`.
+          #
+          #   @return [Symbol, :user_actor]
+          required :type, const: :user_actor
+
+          # @!attribute user_id
+          #   Tagged user ID.
+          #
+          #   @return [String]
+          required :user_id, String
+
+          # @!method initialize(deleted:, email_address:, name:, user_id:, type: :user_actor)
+          #   Some parameter documentations has been truncated, see
+          #   {Anthropic::Models::Beta::Organization::BetaAnalyticsReportUserActor} for more
+          #   details.
+          #
+          #   @param deleted [Boolean] True when the account has been deleted, or when the user is no longer a member o
+          #
+          #   @param email_address [String, nil] The user's current email address, including for users who are no longer members
+          #
+          #   @param name [String, nil] The user's current full name. Null when the user has not set one. `"Deleted User
+          #
+          #   @param user_id [String] Tagged user ID.
+          #
+          #   @param type [Symbol, :user_actor] Actor type. Always `"user_actor"`.
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_service_account_actor.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        class BetaAnalyticsServiceAccountActor < Anthropic::Internal::Type::BaseModel
+          # @!attribute service_account_id
+          #   Tagged service account ID.
+          #
+          #   @return [String]
+          required :service_account_id, String
+
+          # @!attribute type
+          #
+          #   @return [Symbol, :service_account_actor]
+          required :type, const: :service_account_actor
+
+          # @!method initialize(service_account_id:, type: :service_account_actor)
+          #   @param service_account_id [String] Tagged service account ID.
+          #
+          #   @param type [Symbol, :service_account_actor]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_service_tier.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsServiceTier
+          extend Anthropic::Internal::Type::Enum
+
+          BATCH = :batch
+          FLEX = :flex
+          FLEX_DISCOUNT = :flex_discount
+          PRIORITY = :priority
+          PRIORITY_ON_DEMAND = :priority_on_demand
+          STANDARD = :standard
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_speed.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsSpeed
+          extend Anthropic::Internal::Type::Enum
+
+          FAST = :fast
+          STANDARD = :standard
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_time_bucket_width.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsTimeBucketWidth
+          extend Anthropic::Internal::Type::Enum
+
+          DAY = :"1d"
+          HOUR = :"1h"
+          MINUTE = :"1m"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_usage_cost_inference_geo.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsUsageCostInferenceGeo
+          extend Anthropic::Internal::Type::Enum
+
+          GLOBAL = :global
+          US = :us
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_usage_cost_product_filter.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        # Publicly documented product surfaces. `claude_tag` is Claude Tag, the Claude
+        # product in Slack. `chat_cowork_unified` is Chat and Cowork unified, Cowork's
+        # features inside claude.ai chat: chat and Cowork usage by a member who has it
+        # turned on is reported under this value instead of `chat` or `cowork`. It is
+        # accepted as a filter only on deployments that offer Chat and Cowork unified.
+        module BetaAnalyticsUsageCostProductFilter
+          extend Anthropic::Internal::Type::Enum
+
+          CHAT = :chat
+          CHAT_COWORK_UNIFIED = :chat_cowork_unified
+          CLAUDE_CODE = :claude_code
+          CLAUDE_CONSOLE = :claude_console
+          CLAUDE_DESIGN = :claude_design
+          CLAUDE_IN_CHROME = :claude_in_chrome
+          CLAUDE_TAG = :claude_tag
+          COWORK = :cowork
+          MANAGED_AGENTS_API = :managed_agents_api
+          MESSAGE_BATCHES_API = :message_batches_api
+          MESSAGES_API = :messages_api
+          OFFICE_AGENT = :office_agent
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_analytics_usage_cost_sort_order.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Anthropic
+  module Models
+    module Beta
+      module Organization
+        module BetaAnalyticsUsageCostSortOrder
+          extend Anthropic::Internal::Type::Enum
+
+          ASC = :asc
+          DESC = :desc
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/anthropic/models/beta/organization/beta_organization_rate_limit.rb

@@ -29,7 +29,8 @@ module Anthropic
 
           # @!attribute models
           #   Model names this entry's limits apply to, including aliases. `null` when
-          #   `group.type` is not `"model_group"`.
+          #   `group.type` is not `"model_group"`. The list covers the models your
+          #   organization has access to, so it can differ between organizations.
           #
           #   @return [Array<String>, nil]
           required :models, Anthropic::Internal::Type::ArrayOf[String], nil?: true

data/lib/anthropic/models/beta/organization/beta_plugin.rb

@@ -135,8 +135,11 @@ module Anthropic
           required :served_version_id, String
 
           # @!attribute served_version_pinned
-          #   False while the served version follows each new version; true once it has been
-          #   pinned to one.
+          #   True once the served version has been pinned, through Update Plugin or in
+          #   claude.ai. While false, a new version normally becomes the served version when
+          #   it is stored. While the newest version is not the served version, as when a
+          #   version saved in claude.ai is waiting for its content scan, `served_version_id`
+          #   differs from `latest_version_id`.
           #
           #   @return [Boolean]
           required :served_version_pinned, Anthropic::Internal::Type::Boolean
@@ -148,8 +151,11 @@ module Anthropic
           required :type, const: :plugin
 
           # @!attribute updated_at
-          #   RFC 3339. Moves on a new version and on a served-version change; a change to the
-          #   Plugin's installation settings or shares does not move it.
+          #   RFC 3339. Moves on a served-version change (including pinning an unpinned Plugin
+          #   to the version it already serves) and, normally, on a new version. A version
+          #   saved in claude.ai that waits for its content scan moves it when it becomes the
+          #   served version, and not necessarily when it is stored. A change to the Plugin's
+          #   installation settings or shares does not move it.
           #
           #   @return [Time]
           required :updated_at, Time
@@ -190,9 +196,9 @@ module Anthropic
           #
           #   @param served_version_id [String] The version claude.ai serves to members.
           #
-          #   @param served_version_pinned [Boolean] False while the served version follows each new version; true once it has been p
+          #   @param served_version_pinned [Boolean] True once the served version has been pinned, through Update Plugin or in claude
           #
-          #   @param updated_at [Time] RFC 3339. Moves on a new version and on a served-version change; a change to the
+          #   @param updated_at [Time] RFC 3339. Moves on a served-version change (including pinning an unpinned Plugin
           #
           #   @param type [Symbol, :plugin] Always `plugin`.
 

data/lib/anthropic/models/beta/organization/beta_plugin_content_scan.rb

@@ -6,7 +6,8 @@ module Anthropic
       module Organization
         class BetaPluginContentScan < Anthropic::Internal::Type::BaseModel
           # @!attribute assessment
-          #   The scan's verdict; set only when `status` is `completed`.
+          #   The scan's verdict; set only when `status` is `completed`. A `warn` can mean a
+          #   `fail` that was allowed in claude.ai.
           #
           #   @return [Symbol, Anthropic::Models::Beta::Organization::BetaPluginContentScan::Assessment, nil]
           required :assessment,
@@ -24,7 +25,9 @@ module Anthropic
 
           # @!attribute status
           #   `processing` while a scan runs, `completed` when it ran to completion, `errored`
-          #   when it could not run or its outcome cannot be read.
+          #   when it could not run. Once a scan of the version has completed, `content_scan`
+          #   describes the newest completed scan, even while a later scan runs. While the
+          #   scan outcome cannot be read, `status` is `errored` instead.
           #
           #   @return [Symbol, Anthropic::Models::Beta::Organization::BetaPluginContentScan::Status]
           required :status, enum: -> { Anthropic::Beta::Organization::BetaPluginContentScan::Status }
@@ -33,13 +36,14 @@ module Anthropic
           #   Some parameter documentations has been truncated, see
           #   {Anthropic::Models::Beta::Organization::BetaPluginContentScan} for more details.
           #
-          #   @param assessment [Symbol, Anthropic::Models::Beta::Organization::BetaPluginContentScan::Assessment, nil] The scan's verdict; set only when `status` is `completed`.
+          #   @param assessment [Symbol, Anthropic::Models::Beta::Organization::BetaPluginContentScan::Assessment, nil] The scan's verdict; set only when `status` is `completed`. A `warn` can mean a `
           #
           #   @param reason [String, nil] The primary mechanism behind a `warn` or `fail`, such as `credential-exposure` o
           #
           #   @param status [Symbol, Anthropic::Models::Beta::Organization::BetaPluginContentScan::Status] `processing` while a scan runs, `completed` when it ran to completion, `errored`
 
-          # The scan's verdict; set only when `status` is `completed`.
+          # The scan's verdict; set only when `status` is `completed`. A `warn` can mean a
+          # `fail` that was allowed in claude.ai.
           #
           # @see Anthropic::Models::Beta::Organization::BetaPluginContentScan#assessment
           module Assessment
@@ -55,7 +59,9 @@ module Anthropic
           end
 
           # `processing` while a scan runs, `completed` when it ran to completion, `errored`
-          # when it could not run or its outcome cannot be read.
+          # when it could not run. Once a scan of the version has completed, `content_scan`
+          # describes the newest completed scan, even while a later scan runs. While the
+          # scan outcome cannot be read, `status` is `errored` instead.
           #
           # @see Anthropic::Models::Beta::Organization::BetaPluginContentScan#status
           module Status

data/lib/anthropic/models/beta/organization/workspaces/beta_workspace_rate_limit.rb

@@ -25,7 +25,8 @@ module Anthropic
 
             # @!attribute models
             #   Model names this entry's limits apply to, including aliases. `null` when
-            #   `group.type` is not `"model_group"`.
+            #   `group.type` is not `"model_group"`. The list covers the models this workspace
+            #   has access to, so it can differ between workspaces.
             #
             #   @return [Array<String>, nil]
             required :models, Anthropic::Internal::Type::ArrayOf[String], nil?: true

data/lib/anthropic/models/organization/organization_rate_limit.rb

@@ -28,7 +28,8 @@ module Anthropic
 
         # @!attribute models
         #   Model names this entry's limits apply to, including aliases. `null` when
-        #   `group.type` is not `"model_group"`.
+        #   `group.type` is not `"model_group"`. The list covers the models your
+        #   organization has access to, so it can differ between organizations.
         #
         #   @return [Array<String>, nil]
         required :models, Anthropic::Internal::Type::ArrayOf[String], nil?: true

data/lib/anthropic/models/organization/workspaces/workspace_rate_limit.rb

@@ -24,7 +24,8 @@ module Anthropic
 
           # @!attribute models
           #   Model names this entry's limits apply to, including aliases. `null` when
-          #   `group.type` is not `"model_group"`.
+          #   `group.type` is not `"model_group"`. The list covers the models this workspace
+          #   has access to, so it can differ between workspaces.
           #
           #   @return [Array<String>, nil]
           required :models, Anthropic::Internal::Type::ArrayOf[String], nil?: true

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

@@ -7,14 +7,59 @@ module Anthropic
         # @return [Anthropic::Resources::Beta::Messages::Batches]
         attr_reader :batches
 
+        # Runs the tool calls of a conversation until the model gives its final reply.
+        #
+        # The runner sends its requests on a message thread, so that each request after the first
+        # carries only the messages that are new. Pass `thread: false` to send the whole history
+        # with every request instead.
+        #
         # @param params [Anthropic::Models::Beta::MessageCreateParams]
         #
+        # @option params [false, nil] :thread `false` turns the message thread off; `nil` leaves it on.
+        #
+        # @raise [ArgumentError] if `thread` is anything else
+        #
         # @return [Anthropic::Helpers::Tools::Runner]
         def tool_runner(params)
           params = params.to_h.transform_keys(&:to_sym)
           warn_thinking_enabled(params)
           max_iterations = params.delete(:max_iterations)
-          Anthropic::Helpers::Tools::Runner.new(@client, params:, max_iterations:)
+          thread = runner_thread(params)
+          Anthropic::Helpers::Tools::Runner.new(@client, params:, max_iterations:, thread:)
+        end
+
+        # Creates a message thread: a conversation that the API keeps between requests, so that
+        # each turn sends only the messages that are new. It sends no request.
+        #
+        # Takes the keywords of {#create} except `thread` and `stream`. `messages` is optional and
+        # seeds the history, which the first turn sends.
+        #
+        # @param params [Hash{Symbol=>Object}]
+        #
+        # @option params [Symbol] :unsupported_request_behavior What a turn does when the API cannot
+        #   serve the request on a thread: `:error` (the default) raises the error, and
+        #   `:continue_unthreaded` sends the turn again, and every later turn, with the whole
+        #   history and no thread.
+        #
+        # @raise [ArgumentError] if `thread` or `stream` is given
+        #
+        # @raise [NotImplementedError] if the client's platform has no message threads
+        #
+        # @return [Anthropic::Helpers::Threads::BetaMessageThread]
+        def thread(params)
+          unless @client.message_threads?
+            raise NotImplementedError.new(
+              "Message threads are not available on this client. Use `#create` with the whole history instead."
+            )
+          end
+
+          params = params.to_h.transform_keys(&:to_sym)
+          unsupported_request_behavior = params.delete(:unsupported_request_behavior) || :error
+          Anthropic::Helpers::Threads::BetaMessageThread.new(
+            @client,
+            params:,
+            unsupported_request_behavior:
+          )
         end
 
         # See {Anthropic::Resources::Beta::Messages#stream_raw} for streaming counterpart.
@@ -31,7 +76,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
-        # @overload create(max_tokens:, messages:, model:, cache_control: nil, compaction: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: 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, thinking: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
+        # @overload create(max_tokens:, messages:, model:, cache_control: nil, compaction: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: 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, thinking: nil, thread: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -73,6 +118,8 @@ module Anthropic
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive] Body param: Configuration for Claude's thinking.
         #
+        # @param thread [Anthropic::Models::Beta::BetaThreadCreateParams, Anthropic::Models::Beta::BetaThreadContinueParams, nil] Body param: Server-held conversation state (a Thread). `{"type": "create"}` asks
+        #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaBrowserToolset20260801, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaComputerToolset20260801, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset>] Body param: Definitions of tools that the model may use.
@@ -148,7 +195,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
-        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, compaction: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: 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, thinking: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
+        # @overload stream_raw(max_tokens:, messages:, model:, cache_control: nil, compaction: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: 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, thinking: nil, thread: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -190,6 +237,8 @@ module Anthropic
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive] Body param: Configuration for Claude's thinking.
         #
+        # @param thread [Anthropic::Models::Beta::BetaThreadCreateParams, Anthropic::Models::Beta::BetaThreadContinueParams, nil] Body param: Server-held conversation state (a Thread). `{"type": "create"}` asks
+        #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaBrowserToolset20260801, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaComputerToolset20260801, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset>] Body param: Definitions of tools that the model may use.
@@ -318,7 +367,7 @@ module Anthropic
         # Some parameter documentations has been truncated, see
         # {Anthropic::Models::Beta::MessageCreateParams} for more details.
         #
-        # @overload stream(max_tokens:, messages:, model:, cache_control: nil, compaction: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: 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, thinking: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
+        # @overload stream(max_tokens:, messages:, model:, cache_control: nil, compaction: nil, container: nil, context_management: nil, diagnostics: nil, fallback_credit_token: nil, fallbacks: 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, thinking: nil, thread: nil, tool_choice: nil, tools: nil, betas: nil, user_profile_id: nil, workspace_id: nil, request_options: {})
         #
         # @param max_tokens [Integer] Body param: The maximum number of tokens to generate before stopping.
         #
@@ -360,6 +409,8 @@ module Anthropic
         #
         # @param thinking [Anthropic::Models::Beta::BetaThinkingConfigEnabled, Anthropic::Models::Beta::BetaThinkingConfigDisabled, Anthropic::Models::Beta::BetaThinkingConfigBetweenTools, Anthropic::Models::Beta::BetaThinkingConfigAdaptive] Body param: Configuration for Claude's thinking.
         #
+        # @param thread [Anthropic::Models::Beta::BetaThreadCreateParams, Anthropic::Models::Beta::BetaThreadContinueParams, nil] Body param: Server-held conversation state (a Thread). `{"type": "create"}` asks
+        #
         # @param tool_choice [Anthropic::Models::Beta::BetaToolChoiceAuto, Anthropic::Models::Beta::BetaToolChoiceAny, Anthropic::Models::Beta::BetaToolChoiceTool, Anthropic::Models::Beta::BetaToolChoiceNone] Body param: How the model should use the provided tools. The model can use a spe
         #
         # @param tools [Array<Anthropic::Models::Beta::BetaTool, Anthropic::Models::Beta::BetaToolBash20241022, Anthropic::Models::Beta::BetaToolBash20250124, Anthropic::Models::Beta::BetaCodeExecutionTool20250522, Anthropic::Models::Beta::BetaCodeExecutionTool20250825, Anthropic::Models::Beta::BetaCodeExecutionTool20260120, Anthropic::Models::Beta::BetaCodeExecutionTool20260521, Anthropic::Models::Beta::BetaBrowserToolset20260801, Anthropic::Models::Beta::BetaToolComputerUse20241022, Anthropic::Models::Beta::BetaMemoryTool20250818, Anthropic::Models::Beta::BetaToolComputerUse20250124, Anthropic::Models::Beta::BetaToolTextEditor20241022, Anthropic::Models::Beta::BetaToolComputerUse20251124, Anthropic::Models::Beta::BetaComputerToolset20260801, Anthropic::Models::Beta::BetaToolTextEditor20250124, Anthropic::Models::Beta::BetaToolTextEditor20250429, Anthropic::Models::Beta::BetaToolTextEditor20250728, Anthropic::Models::Beta::BetaWebSearchTool20250305, Anthropic::Models::Beta::BetaWebFetchTool20250910, Anthropic::Models::Beta::BetaWebSearchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260209, Anthropic::Models::Beta::BetaWebFetchTool20260309, Anthropic::Models::Beta::BetaWebSearchTool20260318, Anthropic::Models::Beta::BetaWebFetchTool20260318, Anthropic::Models::Beta::BetaAdvisorTool20260301, Anthropic::Models::Beta::BetaToolSearchToolBm25_20251119, Anthropic::Models::Beta::BetaToolSearchToolRegex20251119, Anthropic::Models::Beta::BetaMCPToolset>] Body param: Definitions of tools that the model may use.
@@ -381,6 +432,29 @@ module Anthropic
 
         private
 
+        # The message thread of a tool runner, `nil` when the runner sends the whole history with
+        # every request. Removes `thread` from `params`.
+        #
+        # @param params [Hash{Symbol=>Object}]
+        #
+        # @return [Anthropic::Helpers::Threads::BetaMessageThread, nil]
+        def runner_thread(params)
+          thread = params.delete(:thread)
+          unless thread.nil? || thread == false
+            raise ArgumentError.new(
+              "`thread` on a tool runner can only be `false`, got #{thread.inspect}. " \
+              "The runner sets `thread` for each request itself."
+            )
+          end
+          return nil if thread == false || !@client.message_threads?
+
+          Anthropic::Helpers::Threads::BetaMessageThread.new(
+            @client,
+            params: {},
+            unsupported_request_behavior: :continue_unthreaded
+          )
+        end
+
         def warn_thinking_enabled(parsed)
           if Anthropic::Resources::Messages::MODELS_TO_WARN_WITH_THINKING_ENABLED.include?(parsed[:model]) &&
              parsed[:thinking] &&