anthropic 1.72.0 → 1.74.0

data/rbi/anthropic/models/beta/beta_managed_agents_model_config_params.rbi

@@ -51,9 +51,7 @@ module Anthropic
         sig { returns(T.nilable(String)) }
         attr_accessor :inference_geo
 
-        # Inference speed mode. `fast` provides significantly faster output token
-        # generation at premium pricing. Not all models support `fast`; invalid
-        # combinations are rejected at create time.
+        # Inference speed mode. Defaults to `standard`.
         sig do
           returns(
             T.nilable(
@@ -100,9 +98,7 @@ module Anthropic
           # workspace's default_inference_geo. On update, `model` is whole-object
           # replacement — omitting inference_geo clears it.
           inference_geo: nil,
-          # Inference speed mode. `fast` provides significantly faster output token
-          # generation at premium pricing. Not all models support `fast`; invalid
-          # combinations are rejected at create time.
+          # Inference speed mode. Defaults to `standard`.
           speed: nil
         )
         end
@@ -227,9 +223,7 @@ module Anthropic
           end
         end
 
-        # Inference speed mode. `fast` provides significantly faster output token
-        # generation at premium pricing. Not all models support `fast`; invalid
-        # combinations are rejected at create time.
+        # Inference speed mode. Defaults to `standard`.
         module Speed
           extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/beta_managed_agents_multiagent.rbi

@@ -32,7 +32,7 @@ module Anthropic
         end
         attr_accessor :type
 
-        # Resolved coordinator topology with a concrete agent roster.
+        # Resolved multiagent orchestration configuration as returned in API responses.
         sig do
           params(
             agents:

data/rbi/anthropic/models/beta/beta_managed_agents_multiagent_params.rbi

@@ -41,8 +41,8 @@ module Anthropic
         end
         attr_accessor :type
 
-        # A coordinator topology: the session's primary thread orchestrates work by
-        # spawning session threads, each running an agent drawn from the `agents` roster.
+        # Multiagent orchestration configuration. Currently supports the `coordinator`
+        # topology.
         sig do
           params(
             agents:

data/rbi/anthropic/models/beta/beta_managed_agents_outcome_evaluation_resource.rbi

@@ -15,7 +15,8 @@ module Anthropic
             )
           end
 
-        # A timestamp in RFC 3339 format
+        # When the outcome reached a terminal result. Null while
+        # `pending`/`running`/`evaluating`.
         sig { returns(T.nilable(Time)) }
         attr_accessor :completed_at
 
@@ -64,7 +65,8 @@ module Anthropic
           ).returns(T.attached_class)
         end
         def self.new(
-          # A timestamp in RFC 3339 format
+          # When the outcome reached a terminal result. Null while
+          # `pending`/`running`/`evaluating`.
           completed_at:,
           # What the agent should produce.
           description:,

data/rbi/anthropic/models/beta/beta_managed_agents_read_tool_config_params.rbi

@@ -24,7 +24,8 @@ module Anthropic
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :enabled
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         sig do
           returns(
             T.nilable(
@@ -76,7 +77,8 @@ module Anthropic
           # Whether this tool is enabled and available to Claude. Overrides the
           # default_config setting.
           enabled: nil,
-          # Permission policy for tool execution.
+          # Permission policy for this tool. Controls whether tool calls are auto-approved
+          # or require confirmation.
           permission_policy: nil,
           type: nil,
           # Must be "read".
@@ -105,7 +107,8 @@ module Anthropic
         def to_hash
         end
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         module PermissionPolicy
           extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/beta_managed_agents_schedule.rbi

@@ -33,7 +33,8 @@ module Anthropic
         end
         attr_accessor :type
 
-        # A timestamp in RFC 3339 format
+        # Time the most recent scheduled run actually started. Null until one completes;
+        # preserved after the deployment is archived. Manual runs do not update this.
         sig { returns(T.nilable(Time)) }
         attr_accessor :last_run_at
 
@@ -48,7 +49,8 @@ module Anthropic
         sig { params(upcoming_runs_at: T::Array[Time]).void }
         attr_writer :upcoming_runs_at
 
-        # 5-field POSIX cron schedule with computed runtime timestamps.
+        # A recurring schedule with computed runtime timestamps. Discriminated union —
+        # only cron is supported currently.
         sig do
           params(
             expression: String,
@@ -68,7 +70,8 @@ module Anthropic
           # IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
           timezone:,
           type:,
-          # A timestamp in RFC 3339 format
+          # Time the most recent scheduled run actually started. Null until one completes;
+          # preserved after the deployment is archived. Manual runs do not update this.
           last_run_at: nil,
           # Up to 5 timestamps of upcoming cron occurrences. Non-empty for active and paused
           # deployments (reflects what the schedule would do if unpaused); empty once the

data/rbi/anthropic/models/beta/beta_managed_agents_schedule_params.rbi

@@ -34,8 +34,7 @@ module Anthropic
         end
         attr_accessor :type
 
-        # 5-field POSIX cron schedule. Literal wall-clock matching in the configured
-        # timezone.
+        # A recurring schedule. Discriminated union — only cron is supported currently.
         sig do
           params(
             expression: String,

data/rbi/anthropic/models/beta/beta_managed_agents_schedule_trigger_context.rbi

@@ -15,7 +15,9 @@ module Anthropic
             )
           end
 
-        # A timestamp in RFC 3339 format
+        # The UTC instant at which the cron expression matched in the configured timezone,
+        # before jitter is applied. At most one run is recorded per (`deployment_id`,
+        # `scheduled_at`) pair.
         sig { returns(Time) }
         attr_accessor :scheduled_at
 
@@ -35,7 +37,9 @@ module Anthropic
           ).returns(T.attached_class)
         end
         def self.new(
-          # A timestamp in RFC 3339 format
+          # The UTC instant at which the cron expression matched in the configured timezone,
+          # before jitter is applied. At most one run is recorded per (`deployment_id`,
+          # `scheduled_at`) pair.
           scheduled_at:,
           type:
         )

data/rbi/anthropic/models/beta/beta_managed_agents_session.rbi

@@ -29,12 +29,11 @@ module Anthropic
         end
         attr_writer :agent
 
-        # A timestamp in RFC 3339 format
+        # When the session was archived. Null if not archived.
         sig { returns(T.nilable(Time)) }
         attr_accessor :archived_at
 
-        # A hard spend ceiling. The session stops issuing new model requests once the
-        # tracked list cost reaches `max_list_cost`.
+        # The session's enforced spend ceiling, or null when no budget is set.
         sig do
           returns(T.nilable(Anthropic::Beta::BetaManagedAgentsBudgetLimit))
         end
@@ -78,7 +77,7 @@ module Anthropic
         end
         attr_accessor :resources
 
-        # Timing statistics for a session.
+        # Timing statistics for the session.
         sig { returns(Anthropic::Beta::BetaManagedAgentsSessionStats) }
         attr_reader :stats
 
@@ -109,7 +108,7 @@ module Anthropic
         sig { returns(Time) }
         attr_accessor :updated_at
 
-        # Cumulative token usage for a session across all turns.
+        # Cumulative token usage for the session.
         sig { returns(Anthropic::Beta::BetaManagedAgentsSessionUsage) }
         attr_reader :usage
 
@@ -168,10 +167,9 @@ module Anthropic
           # Resolved `agent` definition for a `session`. Snapshot of the `agent` at
           # `session` creation time.
           agent:,
-          # A timestamp in RFC 3339 format
+          # When the session was archived. Null if not archived.
           archived_at:,
-          # A hard spend ceiling. The session stops issuing new model requests once the
-          # tracked list cost reaches `max_list_cost`.
+          # The session's enforced spend ceiling, or null when no budget is set.
           budget:,
           # A timestamp in RFC 3339 format
           created_at:,
@@ -181,7 +179,7 @@ module Anthropic
           # session.
           outcome_evaluations:,
           resources:,
-          # Timing statistics for a session.
+          # Timing statistics for the session.
           stats:,
           # SessionStatus enum
           status:,
@@ -189,7 +187,7 @@ module Anthropic
           type:,
           # A timestamp in RFC 3339 format
           updated_at:,
-          # Cumulative token usage for a session across all turns.
+          # Cumulative token usage for the session.
           usage:,
           # Vault IDs attached to the session at creation. Empty when no vaults were
           # supplied.

data/rbi/anthropic/models/beta/beta_managed_agents_session_agent.rbi

@@ -38,8 +38,8 @@ module Anthropic
         end
         attr_writer :model
 
-        # Resolved coordinator topology with full agent definitions for each roster
-        # member.
+        # Resolved multiagent orchestration configuration. Null when the agent is
+        # single-threaded.
         sig do
           returns(
             T.nilable(
@@ -136,8 +136,8 @@ module Anthropic
           mcp_servers:,
           # Model identifier and configuration.
           model:,
-          # Resolved coordinator topology with full agent definitions for each roster
-          # member.
+          # Resolved multiagent orchestration configuration. Null when the agent is
+          # single-threaded.
           multiagent:,
           name:,
           skills:,

data/rbi/anthropic/models/beta/beta_managed_agents_session_agent_update.rbi

@@ -223,7 +223,7 @@ module Anthropic
             type:,
             # Per-tool configuration overrides.
             configs: nil,
-            # Default configuration for all tools in a toolset.
+            # Default configuration applied to all tools in this set.
             default_config: nil,
             # Name of the MCP server. Must match a server name from the mcp_servers array.
             # 1-255 characters.
@@ -231,7 +231,7 @@ module Anthropic
             # Description of what the tool does, shown to the agent to help it decide when to
             # use the tool.
             description: nil,
-            # JSON Schema for custom tool input parameters.
+            # JSON Schema defining the expected input parameters for the tool.
             input_schema: nil,
             # Unique name for the tool. 1-128 characters; letters, digits, underscores, and
             # hyphens.

data/rbi/anthropic/models/beta/beta_managed_agents_session_resource_config.rbi

@@ -107,7 +107,8 @@ module Anthropic
           # The memory store ID (memstore\_...). Must belong to the caller's organization
           # and workspace.
           memory_store_id: nil,
-          # Access mode for an attached memory store.
+          # Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts
+          # the store as a read-only filesystem.
           access: nil,
           # Per-attachment guidance for the agent on how to use this store. Rendered into
           # the memory section of the system prompt. Max 4096 chars.

data/rbi/anthropic/models/beta/beta_managed_agents_session_updated_event.rbi

@@ -19,7 +19,7 @@ module Anthropic
         sig { returns(String) }
         attr_accessor :id
 
-        # A timestamp in RFC 3339 format
+        # Timestamp when the update was applied.
         sig { returns(Time) }
         attr_accessor :processed_at
 
@@ -30,8 +30,9 @@ module Anthropic
         end
         attr_accessor :type
 
-        # Resolved `agent` definition for a `session`. Snapshot of the `agent` at
-        # `session` creation time.
+        # The session's effective agent configuration after the update. Present only when
+        # the update changed `agent` (tools or mcp_servers); when present it is the full
+        # materialised snapshot, not a diff.
         sig do
           returns(T.nilable(Anthropic::Beta::BetaManagedAgentsSessionAgent))
         end
@@ -45,8 +46,9 @@ module Anthropic
         end
         attr_writer :agent
 
-        # A hard spend ceiling. The session stops issuing new model requests once the
-        # tracked list cost reaches `max_list_cost`.
+        # The session's budget after the update: the new budget when set or replaced, or
+        # null when the update removed it. Present only when the update changed the
+        # budget.
         sig do
           returns(T.nilable(Anthropic::Beta::BetaManagedAgentsBudgetLimit))
         end
@@ -92,14 +94,16 @@ module Anthropic
         def self.new(
           # Unique identifier for this event.
           id:,
-          # A timestamp in RFC 3339 format
+          # Timestamp when the update was applied.
           processed_at:,
           type:,
-          # Resolved `agent` definition for a `session`. Snapshot of the `agent` at
-          # `session` creation time.
+          # The session's effective agent configuration after the update. Present only when
+          # the update changed `agent` (tools or mcp_servers); when present it is the full
+          # materialised snapshot, not a diff.
           agent: nil,
-          # A hard spend ceiling. The session stops issuing new model requests once the
-          # tracked list cost reaches `max_list_cost`.
+          # The session's budget after the update: the new budget when set or replaced, or
+          # null when the update removed it. Present only when the update changed the
+          # budget.
           budget: nil,
           # The session's full metadata bag after the update. Present when the update set
           # non-empty metadata; absent when metadata was unchanged or cleared to empty.

data/rbi/anthropic/models/beta/beta_managed_agents_session_usage.rbi

@@ -24,7 +24,7 @@ module Anthropic
         sig { params(active_seconds: Float).void }
         attr_writer :active_seconds
 
-        # Prompt-cache creation token usage broken down by cache lifetime.
+        # Tokens used to create prompt cache entries, broken down by cache TTL.
         sig do
           returns(
             T.nilable(Anthropic::Beta::BetaManagedAgentsCacheCreationUsage)
@@ -54,7 +54,8 @@ module Anthropic
         sig { params(input_tokens: Integer).void }
         attr_writer :input_tokens
 
-        # A monetary amount in a specific currency.
+        # Cumulative list cost of the session across all turns, priced at public list
+        # rates. Absent until cost tracking is available for the session.
         sig { returns(T.nilable(Anthropic::BetaMonetaryAmount)) }
         attr_reader :list_cost
 
@@ -72,7 +73,8 @@ module Anthropic
         sig { params(output_tokens: Integer).void }
         attr_writer :output_tokens
 
-        # Cumulative count of server-executed tool invocations, broken down by tool.
+        # Cumulative server-executed tool usage across all turns. Absent until server-tool
+        # tracking is available for the session.
         sig do
           returns(T.nilable(Anthropic::Beta::BetaManagedAgentsServerToolUsage))
         end
@@ -110,17 +112,19 @@ module Anthropic
           # unlike `stats.active_seconds`, which sums each thread's own active time. This is
           # the duration the session's runtime cost is priced on.
           active_seconds: nil,
-          # Prompt-cache creation token usage broken down by cache lifetime.
+          # Tokens used to create prompt cache entries, broken down by cache TTL.
           cache_creation: nil,
           # Total tokens read from prompt cache.
           cache_read_input_tokens: nil,
           # Total input tokens consumed across all turns.
           input_tokens: nil,
-          # A monetary amount in a specific currency.
+          # Cumulative list cost of the session across all turns, priced at public list
+          # rates. Absent until cost tracking is available for the session.
           list_cost: nil,
           # Total output tokens generated across all turns.
           output_tokens: nil,
-          # Cumulative count of server-executed tool invocations, broken down by tool.
+          # Cumulative server-executed tool usage across all turns. Absent until server-tool
+          # tracking is available for the session.
           server_tool_use: nil
         )
         end

data/rbi/anthropic/models/beta/beta_managed_agents_session_usage_event.rbi

@@ -19,7 +19,7 @@ module Anthropic
         sig { returns(String) }
         attr_accessor :id
 
-        # A timestamp in RFC 3339 format
+        # Timestamp when the snapshot was taken.
         sig { returns(Time) }
         attr_accessor :processed_at
 
@@ -30,7 +30,7 @@ module Anthropic
         end
         attr_accessor :type
 
-        # Point-in-time snapshot of a session's cumulative usage.
+        # The session's cumulative usage at the snapshot time.
         sig do
           returns(
             Anthropic::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot
@@ -46,8 +46,8 @@ module Anthropic
         end
         attr_writer :usage
 
-        # A hard spend ceiling. The session stops issuing new model requests once the
-        # tracked list cost reaches `max_list_cost`.
+        # The session's configured budget at the snapshot time, or null when the session
+        # has no budget.
         sig do
           returns(T.nilable(Anthropic::Beta::BetaManagedAgentsBudgetLimit))
         end
@@ -77,13 +77,13 @@ module Anthropic
         def self.new(
           # Unique identifier for this event.
           id:,
-          # A timestamp in RFC 3339 format
+          # Timestamp when the snapshot was taken.
           processed_at:,
           type:,
-          # Point-in-time snapshot of a session's cumulative usage.
+          # The session's cumulative usage at the snapshot time.
           usage:,
-          # A hard spend ceiling. The session stops issuing new model requests once the
-          # tracked list cost reaches `max_list_cost`.
+          # The session's configured budget at the snapshot time, or null when the session
+          # has no budget.
           budget: nil
         )
         end

data/rbi/anthropic/models/beta/beta_managed_agents_system_content_block.rbi

@@ -26,7 +26,7 @@ module Anthropic
         end
         attr_accessor :type
 
-        # Regular text content.
+        # Content block in a mid-conversation system message. Text-only.
         sig do
           params(
             text: String,

data/rbi/anthropic/models/beta/beta_managed_agents_system_message_event.rbi

@@ -34,7 +34,7 @@ module Anthropic
         end
         attr_accessor :type
 
-        # A timestamp in RFC 3339 format
+        # Timestamp when this system message was processed.
         sig { returns(T.nilable(Time)) }
         attr_accessor :processed_at
 
@@ -58,7 +58,7 @@ module Anthropic
           # System content blocks. Text-only.
           content:,
           type:,
-          # A timestamp in RFC 3339 format
+          # Timestamp when this system message was processed.
           processed_at: nil
         )
         end

data/rbi/anthropic/models/beta/beta_managed_agents_trigger_context.rbi

@@ -70,7 +70,9 @@ module Anthropic
         end
         def self.new(
           type:,
-          # A timestamp in RFC 3339 format
+          # The UTC instant at which the cron expression matched in the configured timezone,
+          # before jitter is applied. At most one run is recorded per (`deployment_id`,
+          # `scheduled_at`) pair.
           scheduled_at: nil
         )
         end

data/rbi/anthropic/models/beta/beta_managed_agents_user_tool_result_event.rbi

@@ -64,7 +64,7 @@ module Anthropic
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :is_error
 
-        # A timestamp in RFC 3339 format
+        # Timestamp when this result was processed.
         sig { returns(T.nilable(Time)) }
         attr_accessor :processed_at
 
@@ -109,7 +109,7 @@ module Anthropic
           content: nil,
           # Whether the tool execution resulted in an error.
           is_error: nil,
-          # A timestamp in RFC 3339 format
+          # Timestamp when this result was processed.
           processed_at: nil,
           # Set by the server to the subagent thread this result was routed to. Omitted when
           # it was routed to the primary thread.
@@ -273,13 +273,13 @@ module Anthropic
             type:,
             # The text content.
             text: nil,
-            # Union type for image source variants.
+            # The source of the image data.
             source: nil,
             # Additional context about the document for the model.
             context: nil,
             # The title of the document.
             title: nil,
-            # Citation settings for a search result.
+            # Citation settings for this search result.
             citations: nil,
             # Array of text content blocks from the search result.
             content: nil

data/rbi/anthropic/models/beta/beta_managed_agents_vault.rbi

@@ -18,7 +18,7 @@ module Anthropic
         sig { returns(String) }
         attr_accessor :id
 
-        # A timestamp in RFC 3339 format
+        # When the vault was archived. Null if not archived.
         sig { returns(T.nilable(Time)) }
         attr_accessor :archived_at
 
@@ -58,7 +58,7 @@ module Anthropic
         def self.new(
           # Unique identifier for the vault.
           id:,
-          # A timestamp in RFC 3339 format
+          # When the vault was archived. Null if not archived.
           archived_at:,
           # A timestamp in RFC 3339 format
           created_at:,

data/rbi/anthropic/models/beta/beta_managed_agents_web_fetch_tool_config_params.rbi

@@ -49,7 +49,8 @@ module Anthropic
         sig { returns(T.nilable(Integer)) }
         attr_accessor :max_content_tokens
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         sig do
           returns(
             T.nilable(
@@ -117,7 +118,8 @@ module Anthropic
           # Maximum number of tokens of fetched text content to include in context per call.
           # Does not apply to binary content such as PDFs.
           max_content_tokens: nil,
-          # Permission policy for tool execution.
+          # Permission policy for this tool. Controls whether tool calls are auto-approved
+          # or require confirmation.
           permission_policy: nil,
           type: nil,
           # Must be "web_fetch".
@@ -149,7 +151,8 @@ module Anthropic
         def to_hash
         end
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         module PermissionPolicy
           extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/beta_managed_agents_web_search_tool_config_params.rbi

@@ -44,7 +44,8 @@ module Anthropic
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :enabled
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         sig do
           returns(
             T.nilable(
@@ -124,7 +125,8 @@ module Anthropic
           # Whether this tool is enabled and available to Claude. Overrides the
           # default_config setting.
           enabled: nil,
-          # Permission policy for tool execution.
+          # Permission policy for this tool. Controls whether tool calls are auto-approved
+          # or require confirmation.
           permission_policy: nil,
           type: nil,
           # Approximate user location for search result localization.
@@ -159,7 +161,8 @@ module Anthropic
         def to_hash
         end
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         module PermissionPolicy
           extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/beta_managed_agents_write_tool_config_params.rbi

@@ -24,7 +24,8 @@ module Anthropic
         sig { returns(T.nilable(T::Boolean)) }
         attr_accessor :enabled
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         sig do
           returns(
             T.nilable(
@@ -76,7 +77,8 @@ module Anthropic
           # Whether this tool is enabled and available to Claude. Overrides the
           # default_config setting.
           enabled: nil,
-          # Permission policy for tool execution.
+          # Permission policy for this tool. Controls whether tool calls are auto-approved
+          # or require confirmation.
           permission_policy: nil,
           type: nil,
           # Must be "write".
@@ -105,7 +107,8 @@ module Anthropic
         def to_hash
         end
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         module PermissionPolicy
           extend Anthropic::Internal::Type::Union