anthropic 1.72.0 → 1.74.0

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_status_idle_event.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of status change.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -54,7 +54,7 @@ module Anthropic
           def self.new(
             # Unique identifier for this event.
             id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of status change.
             processed_at:,
             stop_reason:,
             type:

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_status_rescheduled_event.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of status change.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -41,7 +41,7 @@ module Anthropic
           def self.new(
             # Unique identifier for this event.
             id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of status change.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_status_running_event.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of status change.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -40,7 +40,7 @@ module Anthropic
           def self.new(
             # Unique identifier for this event.
             id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of status change.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_status_terminated_event.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of status change.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -40,7 +40,7 @@ module Anthropic
           def self.new(
             # Unique identifier for this event.
             id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of status change.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread.rbi

@@ -17,8 +17,8 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # The resolved agent a session thread runs: a saved-agent snapshot, the platform
-          # advisor entry, or an inline-defined (ephemeral) agent snapshot.
+          # Resolved agent definition for this thread. Snapshot of the agent at thread
+          # creation time.
           sig do
             returns(
               Anthropic::Beta::Sessions::BetaManagedAgentsSessionThread::Agent::Variants
@@ -26,11 +26,11 @@ module Anthropic
           end
           attr_accessor :agent
 
-          # A timestamp in RFC 3339 format
+          # When the thread was archived. Null if not archived.
           sig { returns(T.nilable(Time)) }
           attr_accessor :archived_at
 
-          # A timestamp in RFC 3339 format
+          # When the thread was created.
           sig { returns(Time) }
           attr_accessor :created_at
 
@@ -42,7 +42,8 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :session_id
 
-          # Timing statistics for a session thread.
+          # Timing statistics for this thread. Null until the thread's first status
+          # transition.
           sig do
             returns(
               T.nilable(
@@ -62,7 +63,7 @@ module Anthropic
           end
           attr_writer :stats
 
-          # SessionThreadStatus enum
+          # Current execution status of the thread.
           sig do
             returns(
               Anthropic::Beta::Sessions::BetaManagedAgentsSessionThreadStatus::TaggedSymbol
@@ -77,11 +78,12 @@ module Anthropic
           end
           attr_accessor :type
 
-          # A timestamp in RFC 3339 format
+          # When the thread was last updated.
           sig { returns(Time) }
           attr_accessor :updated_at
 
-          # Cumulative token usage for a session thread across all turns.
+          # Cumulative token usage for this thread. Null until the thread's first idle
+          # transition.
           sig do
             returns(
               T.nilable(
@@ -133,25 +135,27 @@ module Anthropic
           def self.new(
             # Unique identifier for this thread.
             id:,
-            # The resolved agent a session thread runs: a saved-agent snapshot, the platform
-            # advisor entry, or an inline-defined (ephemeral) agent snapshot.
+            # Resolved agent definition for this thread. Snapshot of the agent at thread
+            # creation time.
             agent:,
-            # A timestamp in RFC 3339 format
+            # When the thread was archived. Null if not archived.
             archived_at:,
-            # A timestamp in RFC 3339 format
+            # When the thread was created.
             created_at:,
             # Parent thread that spawned this thread. Null for the primary thread.
             parent_thread_id:,
             # The session this thread belongs to.
             session_id:,
-            # Timing statistics for a session thread.
+            # Timing statistics for this thread. Null until the thread's first status
+            # transition.
             stats:,
-            # SessionThreadStatus enum
+            # Current execution status of the thread.
             status:,
             type:,
-            # A timestamp in RFC 3339 format
+            # When the thread was last updated.
             updated_at:,
-            # Cumulative token usage for a session thread across all turns.
+            # Cumulative token usage for this thread. Null until the thread's first idle
+            # transition.
             usage:
           )
           end
@@ -185,8 +189,8 @@ module Anthropic
           def to_hash
           end
 
-          # The resolved agent a session thread runs: a saved-agent snapshot, the platform
-          # advisor entry, or an inline-defined (ephemeral) agent snapshot.
+          # Resolved agent definition for this thread. Snapshot of the agent at thread
+          # creation time.
           module Agent
             extend Anthropic::Internal::Type::Union
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread_created_event.rbi

@@ -21,7 +21,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :agent_name
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the thread was created.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -53,7 +53,7 @@ module Anthropic
             id:,
             # Name of the callable agent the thread runs.
             agent_name:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the thread was created.
             processed_at:,
             # Public `sthr_` ID of the newly created thread.
             session_thread_id:,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread_status_idle_event.rbi

@@ -21,7 +21,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :agent_name
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of the status transition.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -67,7 +67,7 @@ module Anthropic
             id:,
             # Name of the agent the thread runs.
             agent_name:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of the status transition.
             processed_at:,
             # Public sthr\_ ID of the thread that went idle.
             session_thread_id:,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread_status_rescheduled_event.rbi

@@ -21,7 +21,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :agent_name
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of the status transition.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -54,7 +54,7 @@ module Anthropic
             id:,
             # Name of the agent the thread runs.
             agent_name:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of the status transition.
             processed_at:,
             # Public sthr\_ ID of the thread that is retrying.
             session_thread_id:,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread_status_running_event.rbi

@@ -21,7 +21,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :agent_name
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of the status transition.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -53,7 +53,7 @@ module Anthropic
             id:,
             # Name of the agent the thread runs.
             agent_name:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of the status transition.
             processed_at:,
             # Public sthr\_ ID of the thread that started running.
             session_thread_id:,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread_status_terminated_event.rbi

@@ -21,7 +21,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :agent_name
 
-          # A timestamp in RFC 3339 format
+          # Timestamp of the status transition.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -53,7 +53,7 @@ module Anthropic
             id:,
             # Name of the agent the thread runs.
             agent_name:,
-            # A timestamp in RFC 3339 format
+            # Timestamp of the status transition.
             processed_at:,
             # Public sthr\_ ID of the thread that terminated.
             session_thread_id:,

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_thread_usage.rbi

@@ -22,7 +22,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)
@@ -52,7 +52,12 @@ module Anthropic
           sig { params(input_tokens: Integer).void }
           attr_writer :input_tokens
 
-          # A monetary amount in a specific currency.
+          # Cumulative list cost of this thread across all turns, priced at public list
+          # rates. Absent until cost tracking is available for the thread. Each figure is
+          # rounded to the nearest cent independently and the session's aggregate
+          # `usage.list_cost` additionally includes session runtime, so per-thread costs do
+          # not sum exactly to the session figure; the session figure is authoritative and
+          # is what a budget is enforced against.
           sig { returns(T.nilable(Anthropic::BetaMonetaryAmount)) }
           attr_reader :list_cost
 
@@ -70,7 +75,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 of this thread. Absent
+          # until server-tool tracking is available for the thread.
           sig do
             returns(
               T.nilable(Anthropic::Beta::BetaManagedAgentsServerToolUsage)
@@ -109,17 +115,23 @@ module Anthropic
             # `stats.active_seconds`; surfaced here so a thread's usage carries every quantity
             # its 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 this thread across all turns, priced at public list
+            # rates. Absent until cost tracking is available for the thread. Each figure is
+            # rounded to the nearest cent independently and the session's aggregate
+            # `usage.list_cost` additionally includes session runtime, so per-thread costs do
+            # not sum exactly to the session figure; the session figure is authoritative and
+            # is what a budget is enforced against.
             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 of this thread. Absent
+            # until server-tool tracking is available for the thread.
             server_tool_use: nil
           )
           end

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_session_usage_snapshot.rbi

@@ -22,7 +22,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)
@@ -52,7 +52,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.
           sig { returns(T.nilable(Anthropic::BetaMonetaryAmount)) }
           attr_reader :list_cost
 
@@ -66,7 +67,7 @@ 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.
           sig do
             returns(
               T.nilable(Anthropic::Beta::BetaManagedAgentsServerToolUsage)
@@ -101,17 +102,18 @@ module Anthropic
             # running status. Overlapping activity from concurrent threads is counted once.
             # 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.
             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.
             server_tool_use: nil
           )
           end

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_span_model_request_end_event.rbi

@@ -25,7 +25,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :model_request_start_id
 
-          # Token usage for a single model request.
+          # Token usage for this model request.
           sig do
             returns(Anthropic::Beta::Sessions::BetaManagedAgentsSpanModelUsage)
           end
@@ -39,7 +39,7 @@ module Anthropic
           end
           attr_writer :model_usage
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the model request completed.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -70,9 +70,9 @@ module Anthropic
             is_error:,
             # The id of the corresponding `span.model_request_start` event.
             model_request_start_id:,
-            # Token usage for a single model request.
+            # Token usage for this model request.
             model_usage:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the model request completed.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_span_model_request_start_event.rbi

@@ -17,7 +17,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when the model request started.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -40,7 +40,7 @@ module Anthropic
           def self.new(
             # Unique identifier for this event.
             id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the model request started.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_span_model_usage.rbi

@@ -29,9 +29,8 @@ module Anthropic
           sig { returns(Integer) }
           attr_accessor :output_tokens
 
-          # 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 tier this request actually ran at. Mirrors `usage.speed` on
+          # /v1/messages. Only present when the fast-mode beta is active.
           sig do
             returns(
               T.nilable(
@@ -63,9 +62,8 @@ module Anthropic
             input_tokens:,
             # Output tokens generated by this request.
             output_tokens:,
-            # 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 tier this request actually ran at. Mirrors `usage.speed` on
+            # /v1/messages. Only present when the fast-mode beta is active.
             speed: nil
           )
           end
@@ -87,9 +85,8 @@ module Anthropic
           def to_hash
           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 tier this request actually ran at. Mirrors `usage.speed` on
+          # /v1/messages. Only present when the fast-mode beta is active.
           module Speed
             extend Anthropic::Internal::Type::Enum
 

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_span_outcome_evaluation_end_event.rbi

@@ -35,7 +35,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :outcome_id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when outcome evaluation ended.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -56,7 +56,8 @@ module Anthropic
           end
           attr_accessor :type
 
-          # Token usage for a single model request.
+          # Aggregate token usage for this evaluation cycle. Sums across all grader model
+          # requests within the cycle.
           sig do
             returns(Anthropic::Beta::Sessions::BetaManagedAgentsSpanModelUsage)
           end
@@ -102,7 +103,7 @@ module Anthropic
             outcome_evaluation_start_id:,
             # The `outc_` ID of the outcome being evaluated.
             outcome_id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when outcome evaluation ended.
             processed_at:,
             # Evaluation verdict. 'satisfied': criteria met, session goes idle.
             # 'needs_revision': criteria not met, another revision cycle follows.
@@ -113,7 +114,8 @@ module Anthropic
             # in progress.
             result:,
             type:,
-            # Token usage for a single model request.
+            # Aggregate token usage for this evaluation cycle. Sums across all grader model
+            # requests within the cycle.
             usage:
           )
           end

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_span_outcome_evaluation_ongoing_event.rbi

@@ -26,7 +26,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :outcome_id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when this heartbeat was emitted.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -59,7 +59,7 @@ module Anthropic
             iteration:,
             # The `outc_` ID of the outcome being evaluated.
             outcome_id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when this heartbeat was emitted.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_span_outcome_evaluation_start_event.rbi

@@ -26,7 +26,7 @@ module Anthropic
           sig { returns(String) }
           attr_accessor :outcome_id
 
-          # A timestamp in RFC 3339 format
+          # Timestamp when outcome evaluation started.
           sig { returns(Time) }
           attr_accessor :processed_at
 
@@ -56,7 +56,7 @@ module Anthropic
             iteration:,
             # The `outc_` ID of the outcome being evaluated.
             outcome_id:,
-            # A timestamp in RFC 3339 format
+            # Timestamp when outcome evaluation started.
             processed_at:,
             type:
           )

data/rbi/anthropic/models/beta/sessions/beta_managed_agents_stream_session_events.rbi

@@ -320,10 +320,7 @@ module Anthropic
               name: String,
               mcp_server_name: String,
               evaluated_permission:
-                T.any(
-                  Anthropic::Beta::Sessions::BetaManagedAgentsAgentMCPToolUseEvent::EvaluatedPermission::OrSymbol,
-                  Anthropic::Beta::Sessions::BetaManagedAgentsAgentToolUseEvent::EvaluatedPermission::OrSymbol
-                ),
+                Anthropic::Beta::Sessions::BetaManagedAgentsAgentEvaluatedPermission::OrSymbol,
               evaluation:
                 T.any(
                   Anthropic::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAlwaysAllow::OrHash,
@@ -400,13 +397,13 @@ module Anthropic
             id: nil,
             # Array of content blocks comprising the user message.
             content: nil,
-            # A timestamp in RFC 3339 format
+            # Timestamp when the agent finished processing this message.
             processed_at: nil,
             # If absent, interrupts every non-archived thread in a multiagent session (or the
             # primary alone in a single-agent session). If present, interrupts only the named
             # thread.
             session_thread_id: nil,
-            # UserToolConfirmationResult enum
+            # The confirmation result: 'allow' or 'deny'.
             result: nil,
             # The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result
             # corresponds to, which can be found in the last `session.status_idle`
@@ -429,11 +426,15 @@ module Anthropic
             name: nil,
             # Name of the MCP server providing the tool.
             mcp_server_name: nil,
-            # AgentEvaluatedPermission enum
+            # The evaluated permission policy for this tool invocation.
             evaluated_permission: nil,
-            # Names the resolved permission_policy that produced evaluated_permission, and
-            # under auto carries the judgement. Open union: clients must tolerate unknown
-            # variants.
+            # Which resolved permission_policy produced evaluated_permission: always_allow,
+            # always_ask, or auto (with the server's per-invocation judgement). Absent only
+            # when the server refused the call before any policy applied (for example, the
+            # named tool is not enabled in the session); such a refusal has
+            # evaluated_permission deny. An event recorded before this field existed reads as
+            # the arm its evaluated_permission implies (always_allow for allow, always_ask for
+            # ask).
             evaluation: nil,
             # The id of the `agent.mcp_tool_use` event this result corresponds to.
             mcp_tool_use_id: nil,
@@ -461,23 +462,27 @@ module Anthropic
             explanation: nil,
             # The id of the corresponding `span.outcome_evaluation_start` event.
             outcome_evaluation_start_id: nil,
-            # Token usage for a single model request.
+            # Aggregate token usage for this evaluation cycle. Sums across all grader model
+            # requests within the cycle.
             usage: nil,
             # The id of the corresponding `span.model_request_start` event.
             model_request_start_id: nil,
-            # Token usage for a single model request.
+            # Token usage for this model request.
             model_usage: nil,
             # What the agent should produce. Copied from the input event.
             description: nil,
             # Evaluate-then-revise cycles before giving up. Default 3, max 20.
             max_iterations: nil,
-            # Rubric for grading the quality of an outcome.
+            # How to grade the outcome. File rubrics are currently resolved to their text
+            # content; clients should handle both variants.
             rubric: nil,
-            # 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.