anthropic 1.72.0 → 1.74.0

data/lib/anthropic/models/beta/beta_managed_agents_model_config.rb

@@ -14,8 +14,9 @@ module Anthropic
         required :id, union: -> { Anthropic::Beta::BetaManagedAgentsModel }
 
         # @!attribute effort
-        #   How hard Claude works on each turn. Sets `output_config.effort` on every
-        #   Messages call the session makes.
+        #   How hard Claude works on each inference call. One of `low`, `medium`, `high`,
+        #   `xhigh`, `max`. Always present; resolved to the per-model default at save time
+        #   when not supplied.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsEffortLow, Anthropic::Models::Beta::BetaManagedAgentsEffortMedium, Anthropic::Models::Beta::BetaManagedAgentsEffortHigh, Anthropic::Models::Beta::BetaManagedAgentsEffortXhigh, Anthropic::Models::Beta::BetaManagedAgentsEffortMax, nil]
         optional :effort, union: -> { Anthropic::Beta::BetaManagedAgentsModelConfig::Effort }
@@ -29,8 +30,8 @@ module Anthropic
 
         # @!attribute speed
         #   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.
+        #   generation at premium pricing. Defaults to `standard`. Not all models support
+        #   `fast`; invalid combinations are rejected at create time.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfig::Speed, nil]
         optional :speed, enum: -> { Anthropic::Beta::BetaManagedAgentsModelConfig::Speed }
@@ -43,14 +44,15 @@ module Anthropic
         #
         #   @param id [Symbol, String, Anthropic::Models::Beta::BetaManagedAgentsModel] The model that will power your agent.
         #
-        #   @param effort [Anthropic::Models::Beta::BetaManagedAgentsEffortLow, Anthropic::Models::Beta::BetaManagedAgentsEffortMedium, Anthropic::Models::Beta::BetaManagedAgentsEffortHigh, Anthropic::Models::Beta::BetaManagedAgentsEffortXhigh, Anthropic::Models::Beta::BetaManagedAgentsEffortMax] How hard Claude works on each turn. Sets `output_config.effort` on every Message
+        #   @param effort [Anthropic::Models::Beta::BetaManagedAgentsEffortLow, Anthropic::Models::Beta::BetaManagedAgentsEffortMedium, Anthropic::Models::Beta::BetaManagedAgentsEffortHigh, Anthropic::Models::Beta::BetaManagedAgentsEffortXhigh, Anthropic::Models::Beta::BetaManagedAgentsEffortMax] How hard Claude works on each inference call. One of `low`, `medium`, `high`, `x
         #
         #   @param inference_geo [String] Geographic region for model inference. When unset, requests fall through to the
         #
         #   @param speed [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfig::Speed] Inference speed mode. `fast` provides significantly faster output token generati
 
-        # How hard Claude works on each turn. Sets `output_config.effort` on every
-        # Messages call the session makes.
+        # How hard Claude works on each inference call. One of `low`, `medium`, `high`,
+        # `xhigh`, `max`. Always present; resolved to the per-model default at save time
+        # when not supplied.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsModelConfig#effort
         module Effort
@@ -117,8 +119,8 @@ module Anthropic
         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.
+        # generation at premium pricing. Defaults to `standard`. Not all models support
+        # `fast`; invalid combinations are rejected at create time.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsModelConfig#speed
         module Speed

data/lib/anthropic/models/beta/beta_managed_agents_model_config_params.rb

@@ -34,9 +34,7 @@ module Anthropic
         optional :inference_geo, String, nil?: true
 
         # @!attribute speed
-        #   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`.
         #
         #   @return [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams::Speed, nil]
         optional :speed, enum: -> { Anthropic::Beta::BetaManagedAgentsModelConfigParams::Speed }, nil?: true
@@ -53,7 +51,7 @@ module Anthropic
         #
         #   @param inference_geo [String, nil] Geographic region for model inference. When unset, requests fall through to the
         #
-        #   @param speed [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams::Speed, nil] Inference speed mode. `fast` provides significantly faster output token generati
+        #   @param speed [Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams::Speed, nil] Inference speed mode. Defaults to `standard`.
 
         # How hard Claude works on each inference call. Accepts a bare level string
         # (`"high"`) or `{"type": "high"}`. On create, omitting it resolves the per-model
@@ -110,9 +108,7 @@ module Anthropic
           #   @return [Array(Symbol, Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams::Effort::BetaManagedAgentsEffortLevel, Anthropic::Models::Beta::BetaManagedAgentsEffortLow, Anthropic::Models::Beta::BetaManagedAgentsEffortMedium, Anthropic::Models::Beta::BetaManagedAgentsEffortHigh, Anthropic::Models::Beta::BetaManagedAgentsEffortXhigh, Anthropic::Models::Beta::BetaManagedAgentsEffortMax)]
         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`.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsModelConfigParams#speed
         module Speed

data/lib/anthropic/models/beta/beta_managed_agents_multiagent.rb

@@ -18,7 +18,7 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsMultiagent::Type }
 
         # @!method initialize(agents:, type:)
-        #   Resolved coordinator topology with a concrete agent roster.
+        #   Resolved multiagent orchestration configuration as returned in API responses.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsMultiagent} for more details.

data/lib/anthropic/models/beta/beta_managed_agents_multiagent_params.rb

@@ -22,8 +22,8 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsMultiagentParams::Type }
 
         # @!method initialize(agents:, 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.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsMultiagentParams} for more details.

data/lib/anthropic/models/beta/beta_managed_agents_outcome_evaluation_resource.rb

@@ -5,7 +5,8 @@ module Anthropic
     module Beta
       class BetaManagedAgentsOutcomeEvaluationResource < Anthropic::Internal::Type::BaseModel
         # @!attribute completed_at
-        #   A timestamp in RFC 3339 format
+        #   When the outcome reached a terminal result. Null while
+        #   `pending`/`running`/`evaluating`.
         #
         #   @return [Time, nil]
         required :completed_at, Time, nil?: true
@@ -56,7 +57,7 @@ module Anthropic
         #   {Anthropic::Models::Beta::BetaManagedAgentsOutcomeEvaluationResource} for more
         #   details.
         #
-        #   @param completed_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param completed_at [Time, nil] When the outcome reached a terminal result. Null while `pending`/`running`/`eval
         #
         #   @param description [String] What the agent should produce.
         #

data/lib/anthropic/models/beta/beta_managed_agents_read_tool_config_params.rb

@@ -18,7 +18,8 @@ module Anthropic
         optional :enabled, Anthropic::Internal::Type::Boolean, nil?: true
 
         # @!attribute permission_policy
-        #   Permission policy for tool execution.
+        #   Permission policy for this tool. Controls whether tool calls are auto-approved
+        #   or require confirmation.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil]
         optional :permission_policy,
@@ -39,13 +40,14 @@ module Anthropic
         #
         #   @param enabled [Boolean, nil] Whether this tool is enabled and available to Claude. Overrides the default_conf
         #
-        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for tool execution.
+        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for this tool. Controls whether tool calls are auto-approved o
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams::Type]
         #
         #   @param name [Symbol, :read] Must be "read".
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams#permission_policy
         module PermissionPolicy

data/lib/anthropic/models/beta/beta_managed_agents_schedule.rb

@@ -26,7 +26,8 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsSchedule::Type }
 
         # @!attribute last_run_at
-        #   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.
         #
         #   @return [Time, nil]
         optional :last_run_at, Time, nil?: true
@@ -42,7 +43,8 @@ module Anthropic
         optional :upcoming_runs_at, Anthropic::Internal::Type::ArrayOf[Time]
 
         # @!method initialize(expression:, timezone:, type:, last_run_at: nil, upcoming_runs_at: nil)
-        #   5-field POSIX cron schedule with computed runtime timestamps.
+        #   A recurring schedule with computed runtime timestamps. Discriminated union —
+        #   only cron is supported currently.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsSchedule} for more details.
@@ -53,7 +55,7 @@ module Anthropic
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSchedule::Type]
         #
-        #   @param last_run_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param last_run_at [Time, nil] Time the most recent scheduled run actually started. Null until one completes; p
         #
         #   @param upcoming_runs_at [Array<Time>] Up to 5 timestamps of upcoming cron occurrences. Non-empty for active and paused
 

data/lib/anthropic/models/beta/beta_managed_agents_schedule_params.rb

@@ -27,8 +27,7 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsScheduleParams::Type }
 
         # @!method initialize(expression:, timezone:, type:)
-        #   5-field POSIX cron schedule. Literal wall-clock matching in the configured
-        #   timezone.
+        #   A recurring schedule. Discriminated union — only cron is supported currently.
         #
         #   Some parameter documentations has been truncated, see
         #   {Anthropic::Models::Beta::BetaManagedAgentsScheduleParams} for more details.

data/lib/anthropic/models/beta/beta_managed_agents_schedule_trigger_context.rb

@@ -5,7 +5,9 @@ module Anthropic
     module Beta
       class BetaManagedAgentsScheduleTriggerContext < Anthropic::Internal::Type::BaseModel
         # @!attribute scheduled_at
-        #   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.
         #
         #   @return [Time]
         required :scheduled_at, Time
@@ -18,7 +20,11 @@ module Anthropic
         # @!method initialize(scheduled_at:, type:)
         #   The run was fired by the deployment's cron schedule.
         #
-        #   @param scheduled_at [Time] A timestamp in RFC 3339 format
+        #   Some parameter documentations has been truncated, see
+        #   {Anthropic::Models::Beta::BetaManagedAgentsScheduleTriggerContext} for more
+        #   details.
+        #
+        #   @param scheduled_at [Time] The UTC instant at which the cron expression matched in the configured timezone,
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsScheduleTriggerContext::Type]
 

data/lib/anthropic/models/beta/beta_managed_agents_session.rb

@@ -18,14 +18,13 @@ module Anthropic
         required :agent, -> { Anthropic::Beta::BetaManagedAgentsSessionAgent }
 
         # @!attribute archived_at
-        #   A timestamp in RFC 3339 format
+        #   When the session was archived. Null if not archived.
         #
         #   @return [Time, nil]
         required :archived_at, Time, nil?: true
 
         # @!attribute budget
-        #   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.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil]
         required :budget, -> { Anthropic::Beta::BetaManagedAgentsBudgetLimit }, nil?: true
@@ -61,7 +60,7 @@ module Anthropic
                  -> { Anthropic::Internal::Type::ArrayOf[union: Anthropic::Beta::Sessions::BetaManagedAgentsSessionResource] }
 
         # @!attribute stats
-        #   Timing statistics for a session.
+        #   Timing statistics for the session.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsSessionStats]
         required :stats, -> { Anthropic::Beta::BetaManagedAgentsSessionStats }
@@ -89,7 +88,7 @@ module Anthropic
         required :updated_at, Time
 
         # @!attribute usage
-        #   Cumulative token usage for a session across all turns.
+        #   Cumulative token usage for the session.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsSessionUsage]
         required :usage, -> { Anthropic::Beta::BetaManagedAgentsSessionUsage }
@@ -118,9 +117,9 @@ module Anthropic
         #
         #   @param agent [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent] Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session
         #
-        #   @param archived_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param archived_at [Time, nil] When the session was archived. Null if not archived.
         #
-        #   @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] A hard spend ceiling. The session stops issuing new model requests once the trac
+        #   @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] The session's enforced spend ceiling, or null when no budget is set.
         #
         #   @param created_at [Time] A timestamp in RFC 3339 format
         #
@@ -132,7 +131,7 @@ module Anthropic
         #
         #   @param resources [Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsGitHubRepositoryResource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileResource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMemoryStoreResource>]
         #
-        #   @param stats [Anthropic::Models::Beta::BetaManagedAgentsSessionStats] Timing statistics for a session.
+        #   @param stats [Anthropic::Models::Beta::BetaManagedAgentsSessionStats] Timing statistics for the session.
         #
         #   @param status [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSession::Status] SessionStatus enum
         #
@@ -142,7 +141,7 @@ module Anthropic
         #
         #   @param updated_at [Time] A timestamp in RFC 3339 format
         #
-        #   @param usage [Anthropic::Models::Beta::BetaManagedAgentsSessionUsage] Cumulative token usage for a session across all turns.
+        #   @param usage [Anthropic::Models::Beta::BetaManagedAgentsSessionUsage] Cumulative token usage for the session.
         #
         #   @param vault_ids [Array<String>] Vault IDs attached to the session at creation. Empty when no vaults were supplie
         #

data/lib/anthropic/models/beta/beta_managed_agents_session_agent.rb

@@ -27,8 +27,8 @@ module Anthropic
         required :model, -> { Anthropic::Beta::BetaManagedAgentsModelConfig }
 
         # @!attribute multiagent
-        #   Resolved coordinator topology with full agent definitions for each roster
-        #   member.
+        #   Resolved multiagent orchestration configuration. Null when the agent is
+        #   single-threaded.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsSessionMultiagentCoordinator, nil]
         required :multiagent,
@@ -84,7 +84,7 @@ module Anthropic
         #
         #   @param model [Anthropic::Models::Beta::BetaManagedAgentsModelConfig] Model identifier and configuration.
         #
-        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsSessionMultiagentCoordinator, nil] Resolved coordinator topology with full agent definitions for each roster member
+        #   @param multiagent [Anthropic::Models::Beta::BetaManagedAgentsSessionMultiagentCoordinator, nil] Resolved multiagent orchestration configuration. Null when the agent is single-t
         #
         #   @param name [String]
         #

data/lib/anthropic/models/beta/beta_managed_agents_session_agent_update.rb

@@ -74,13 +74,13 @@ module Anthropic
           #
           #   @option args [Array<Anthropic::Models::Beta::BetaManagedAgentsBashToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsEditToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsReadToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWriteToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGlobToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsGrepToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams, Anthropic::Models::Beta::BetaManagedAgentsWebSearchToolConfigParams>, Array<Anthropic::Models::Beta::BetaManagedAgentsMCPToolConfigParams>] :configs Per-tool configuration overrides.
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration for all tools in a toolset.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsAgentToolsetDefaultConfigParams, nil, Anthropic::Models::Beta::BetaManagedAgentsMCPToolsetDefaultConfigParams, nil] :default_config Default configuration applied to all tools in this set.
           #
           #   @option args [String] :mcp_server_name Name of the MCP server. Must match a server name from the mcp_servers array. 1-2
           #
           #   @option args [String] :description Description of what the tool does, shown to the agent to help it decide when to
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema for custom tool input parameters.
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsCustomToolInputSchema] :input_schema JSON Schema defining the expected input parameters for the tool.
           #
           #   @option args [String] :name Unique name for the tool. 1-128 characters; letters, digits, underscores, and hy
           #

data/lib/anthropic/models/beta/beta_managed_agents_session_resource_config.rb

@@ -54,7 +54,7 @@ module Anthropic
         #   @option args [String] :memory_store_id The memory store ID (memstore\_...). Must belong to the caller's organization
         #   and
         #
-        #   @option args [Symbol, Anthropic::Models::Beta::BetaManagedAgentsMemoryStoreResourceConfig::Access, nil] :access Access mode for an attached memory store.
+        #   @option args [Symbol, Anthropic::Models::Beta::BetaManagedAgentsMemoryStoreResourceConfig::Access, nil] :access Access mode for the mounted store. Defaults to `read_write`. `read_only` mounts
         #
         #   @option args [String, nil] :instructions Per-attachment guidance for the agent on how to use this store. Rendered into th
         #

data/lib/anthropic/models/beta/beta_managed_agents_session_updated_event.rb

@@ -11,7 +11,7 @@ module Anthropic
         required :id, String
 
         # @!attribute processed_at
-        #   A timestamp in RFC 3339 format
+        #   Timestamp when the update was applied.
         #
         #   @return [Time]
         required :processed_at, Time
@@ -22,15 +22,17 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsSessionUpdatedEvent::Type }
 
         # @!attribute agent
-        #   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.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil]
         optional :agent, -> { Anthropic::Beta::BetaManagedAgentsSessionAgent }, nil?: true
 
         # @!attribute budget
-        #   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.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil]
         optional :budget, -> { Anthropic::Beta::BetaManagedAgentsBudgetLimit }, nil?: true
@@ -59,13 +61,13 @@ module Anthropic
         #
         #   @param id [String] Unique identifier for this event.
         #
-        #   @param processed_at [Time] A timestamp in RFC 3339 format
+        #   @param processed_at [Time] Timestamp when the update was applied.
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSessionUpdatedEvent::Type]
         #
-        #   @param agent [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil] Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session
+        #   @param agent [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil] The session's effective agent configuration after the update. Present only when
         #
-        #   @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] A hard spend ceiling. The session stops issuing new model requests once the trac
+        #   @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] The session's budget after the update: the new budget when set or replaced, or n
         #
         #   @param metadata [Hash{Symbol=>String}] The session's full metadata bag after the update. Present when the update set no
         #

data/lib/anthropic/models/beta/beta_managed_agents_session_usage.rb

@@ -14,7 +14,7 @@ module Anthropic
         optional :active_seconds, Float
 
         # @!attribute cache_creation
-        #   Prompt-cache creation token usage broken down by cache lifetime.
+        #   Tokens used to create prompt cache entries, broken down by cache TTL.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsCacheCreationUsage, nil]
         optional :cache_creation, -> { Anthropic::Beta::BetaManagedAgentsCacheCreationUsage }
@@ -32,7 +32,8 @@ module Anthropic
         optional :input_tokens, Integer
 
         # @!attribute list_cost
-        #   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.
         #
         #   @return [Anthropic::Models::BetaMonetaryAmount, nil]
         optional :list_cost, -> { Anthropic::BetaMonetaryAmount }, nil?: true
@@ -44,7 +45,8 @@ module Anthropic
         optional :output_tokens, Integer
 
         # @!attribute server_tool_use
-        #   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.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsServerToolUsage, nil]
         optional :server_tool_use, -> { Anthropic::Beta::BetaManagedAgentsServerToolUsage }, nil?: true
@@ -57,17 +59,17 @@ module Anthropic
         #
         #   @param active_seconds [Float] Cumulative time in seconds during which the session had at least one thread in r
         #
-        #   @param cache_creation [Anthropic::Models::Beta::BetaManagedAgentsCacheCreationUsage] Prompt-cache creation token usage broken down by cache lifetime.
+        #   @param cache_creation [Anthropic::Models::Beta::BetaManagedAgentsCacheCreationUsage] Tokens used to create prompt cache entries, broken down by cache TTL.
         #
         #   @param cache_read_input_tokens [Integer] Total tokens read from prompt cache.
         #
         #   @param input_tokens [Integer] Total input tokens consumed across all turns.
         #
-        #   @param list_cost [Anthropic::Models::BetaMonetaryAmount, nil] A monetary amount in a specific currency.
+        #   @param list_cost [Anthropic::Models::BetaMonetaryAmount, nil] Cumulative list cost of the session across all turns, priced at public list rate
         #
         #   @param output_tokens [Integer] Total output tokens generated across all turns.
         #
-        #   @param server_tool_use [Anthropic::Models::Beta::BetaManagedAgentsServerToolUsage, nil] Cumulative count of server-executed tool invocations, broken down by tool.
+        #   @param server_tool_use [Anthropic::Models::Beta::BetaManagedAgentsServerToolUsage, nil] Cumulative server-executed tool usage across all turns. Absent until server-tool
       end
     end
 

data/lib/anthropic/models/beta/beta_managed_agents_session_usage_event.rb

@@ -11,7 +11,7 @@ module Anthropic
         required :id, String
 
         # @!attribute processed_at
-        #   A timestamp in RFC 3339 format
+        #   Timestamp when the snapshot was taken.
         #
         #   @return [Time]
         required :processed_at, Time
@@ -22,14 +22,14 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsSessionUsageEvent::Type }
 
         # @!attribute usage
-        #   Point-in-time snapshot of a session's cumulative usage.
+        #   The session's cumulative usage at the snapshot time.
         #
         #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot]
         required :usage, -> { Anthropic::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot }
 
         # @!attribute budget
-        #   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.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil]
         optional :budget, -> { Anthropic::Beta::BetaManagedAgentsBudgetLimit }, nil?: true
@@ -42,13 +42,13 @@ module Anthropic
         #
         #   @param id [String] Unique identifier for this event.
         #
-        #   @param processed_at [Time] A timestamp in RFC 3339 format
+        #   @param processed_at [Time] Timestamp when the snapshot was taken.
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSessionUsageEvent::Type]
         #
-        #   @param usage [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot] Point-in-time snapshot of a session's cumulative usage.
+        #   @param usage [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot] The session's cumulative usage at the snapshot time.
         #
-        #   @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] A hard spend ceiling. The session stops issuing new model requests once the trac
+        #   @param budget [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] The session's configured budget at the snapshot time, or null when the session h
 
         # @see Anthropic::Models::Beta::BetaManagedAgentsSessionUsageEvent#type
         module Type

data/lib/anthropic/models/beta/beta_managed_agents_system_content_block.rb

@@ -16,7 +16,7 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsSystemContentBlock::Type }
 
         # @!method initialize(text:, type:)
-        #   Regular text content.
+        #   Content block in a mid-conversation system message. Text-only.
         #
         #   @param text [String] The text content.
         #

data/lib/anthropic/models/beta/beta_managed_agents_system_message_event.rb

@@ -23,7 +23,7 @@ module Anthropic
         required :type, enum: -> { Anthropic::Beta::BetaManagedAgentsSystemMessageEvent::Type }
 
         # @!attribute processed_at
-        #   A timestamp in RFC 3339 format
+        #   Timestamp when this system message was processed.
         #
         #   @return [Time, nil]
         optional :processed_at, Time, nil?: true
@@ -38,7 +38,7 @@ module Anthropic
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsSystemMessageEvent::Type]
         #
-        #   @param processed_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param processed_at [Time, nil] Timestamp when this system message was processed.
 
         # @see Anthropic::Models::Beta::BetaManagedAgentsSystemMessageEvent#type
         module Type

data/lib/anthropic/models/beta/beta_managed_agents_trigger_context.rb

@@ -31,11 +31,14 @@ module Anthropic
         # Creates a new instance of the variant class whose `type` matches the given
         # value, passing the remaining arguments to its constructor.
         #
+        # Some parameter documentations has been truncated, see
+        # {Anthropic::Models::Beta::BetaManagedAgentsTriggerContext} for more details.
+        #
         # @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsTriggerContext::Type, String]
         #
         # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
         #
-        #   @option args [Time] :scheduled_at A timestamp in RFC 3339 format
+        #   @option args [Time] :scheduled_at The UTC instant at which the cron expression matched in the configured timezone,
         #
         # @raise [ArgumentError]
         # @return [Anthropic::Models::Beta::BetaManagedAgentsScheduleTriggerContext, Anthropic::Models::Beta::BetaManagedAgentsManualTriggerContext]

data/lib/anthropic/models/beta/beta_managed_agents_user_tool_result_event.rb

@@ -38,7 +38,7 @@ module Anthropic
         optional :is_error, Anthropic::Internal::Type::Boolean, nil?: true
 
         # @!attribute processed_at
-        #   A timestamp in RFC 3339 format
+        #   Timestamp when this result was processed.
         #
         #   @return [Time, nil]
         optional :processed_at, Time, nil?: true
@@ -69,7 +69,7 @@ module Anthropic
         #
         #   @param is_error [Boolean, nil] Whether the tool execution resulted in an error.
         #
-        #   @param processed_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param processed_at [Time, nil] Timestamp when this result was processed.
         #
         #   @param session_thread_id [String, nil] Set by the server to the subagent thread this result was routed to. Omitted when
 
@@ -126,13 +126,13 @@ module Anthropic
           #
           #   @option args [String] :text The text content.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsBase64ImageSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsURLImageSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileImageSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsBase64DocumentSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsPlainTextDocumentSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsURLDocumentSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileDocumentSource, String] :source Union type for image source variants.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsBase64ImageSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsURLImageSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileImageSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsBase64DocumentSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsPlainTextDocumentSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsURLDocumentSource, Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileDocumentSource, String] :source The source of the image data.
           #
           #   @option args [String, nil] :context Additional context about the document for the model.
           #
           #   @option args [String, nil, String] :title The title of the document.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSearchResultCitations] :citations Citation settings for a search result.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSearchResultCitations] :citations Citation settings for this search result.
           #
           #   @option args [Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsSearchResultContent>] :content Array of text content blocks from the search result.
           #

data/lib/anthropic/models/beta/beta_managed_agents_vault.rb

@@ -12,7 +12,7 @@ module Anthropic
         required :id, String
 
         # @!attribute archived_at
-        #   A timestamp in RFC 3339 format
+        #   When the vault was archived. Null if not archived.
         #
         #   @return [Time, nil]
         required :archived_at, Time, nil?: true
@@ -51,7 +51,7 @@ module Anthropic
         #
         #   @param id [String] Unique identifier for the vault.
         #
-        #   @param archived_at [Time, nil] A timestamp in RFC 3339 format
+        #   @param archived_at [Time, nil] When the vault was archived. Null if not archived.
         #
         #   @param created_at [Time] A timestamp in RFC 3339 format
         #

data/lib/anthropic/models/beta/beta_managed_agents_web_fetch_tool_config_params.rb

@@ -43,7 +43,8 @@ module Anthropic
         optional :max_content_tokens, Integer, nil?: true
 
         # @!attribute permission_policy
-        #   Permission policy for tool execution.
+        #   Permission policy for this tool. Controls whether tool calls are auto-approved
+        #   or require confirmation.
         #
         #   @return [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil]
         optional :permission_policy,
@@ -70,13 +71,14 @@ module Anthropic
         #
         #   @param max_content_tokens [Integer, nil] Maximum number of tokens of fetched text content to include in context per call.
         #
-        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for tool execution.
+        #   @param permission_policy [Anthropic::Models::Beta::BetaManagedAgentsAlwaysAllowPolicy, Anthropic::Models::Beta::BetaManagedAgentsAlwaysAskPolicy, Anthropic::Models::Beta::BetaManagedAgentsAutoPolicy, nil] Permission policy for this tool. Controls whether tool calls are auto-approved o
         #
         #   @param type [Symbol, Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams::Type]
         #
         #   @param name [Symbol, :web_fetch] Must be "web_fetch".
 
-        # Permission policy for tool execution.
+        # Permission policy for this tool. Controls whether tool calls are auto-approved
+        # or require confirmation.
         #
         # @see Anthropic::Models::Beta::BetaManagedAgentsWebFetchToolConfigParams#permission_policy
         module PermissionPolicy