anthropic 1.68.0 → 1.76.0

data/lib/anthropic/models/beta/sessions/beta_managed_agents_session_thread_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,12 @@ module Anthropic
           optional :input_tokens, Integer
 
           # @!attribute list_cost
-          #   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.
           #
           #   @return [Anthropic::Models::BetaMonetaryAmount, nil]
           optional :list_cost, -> { Anthropic::BetaMonetaryAmount }, nil?: true
@@ -44,7 +49,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 of this thread. Absent
+          #   until server-tool tracking is available for the thread.
           #
           #   @return [Anthropic::Models::Beta::BetaManagedAgentsServerToolUsage, nil]
           optional :server_tool_use, -> { Anthropic::Beta::BetaManagedAgentsServerToolUsage }, nil?: true
@@ -58,17 +64,17 @@ module Anthropic
           #
           #   @param active_seconds [Float] Cumulative time in seconds this thread spent in running status. Equal to `stats.
           #
-          #   @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 this thread 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 of this thread. Absent un
         end
       end
     end

data/lib/anthropic/models/beta/sessions/beta_managed_agents_session_usage_snapshot.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.
           #
           #   @return [Anthropic::Models::BetaMonetaryAmount, nil]
           optional :list_cost, -> { Anthropic::BetaMonetaryAmount }
@@ -44,7 +45,7 @@ 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.
           #
           #   @return [Anthropic::Models::Beta::BetaManagedAgentsServerToolUsage, nil]
           optional :server_tool_use, -> { Anthropic::Beta::BetaManagedAgentsServerToolUsage }
@@ -58,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] A monetary amount in a specific currency.
+          #   @param list_cost [Anthropic::Models::BetaMonetaryAmount] 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] Cumulative count of server-executed tool invocations, broken down by tool.
+          #   @param server_tool_use [Anthropic::Models::Beta::BetaManagedAgentsServerToolUsage] Cumulative server-executed tool usage across all turns.
         end
       end
     end

data/lib/anthropic/models/beta/sessions/beta_managed_agents_span_model_request_end_event.rb

@@ -24,13 +24,13 @@ module Anthropic
           required :model_request_start_id, String
 
           # @!attribute model_usage
-          #   Token usage for a single model request.
+          #   Token usage for this model request.
           #
           #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage]
           required :model_usage, -> { Anthropic::Beta::Sessions::BetaManagedAgentsSpanModelUsage }
 
           # @!attribute processed_at
-          #   A timestamp in RFC 3339 format
+          #   Timestamp when the model request completed.
           #
           #   @return [Time]
           required :processed_at, Time
@@ -49,9 +49,9 @@ module Anthropic
           #
           #   @param model_request_start_id [String] The id of the corresponding `span.model_request_start` event.
           #
-          #   @param model_usage [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] Token usage for a single model request.
+          #   @param model_usage [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] Token usage for this model request.
           #
-          #   @param processed_at [Time] A timestamp in RFC 3339 format
+          #   @param processed_at [Time] Timestamp when the model request completed.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelRequestEndEvent::Type]
 

data/lib/anthropic/models/beta/sessions/beta_managed_agents_span_model_request_start_event.rb

@@ -12,7 +12,7 @@ module Anthropic
           required :id, String
 
           # @!attribute processed_at
-          #   A timestamp in RFC 3339 format
+          #   Timestamp when the model request started.
           #
           #   @return [Time]
           required :processed_at, Time
@@ -27,7 +27,7 @@ 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 model request started.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelRequestStartEvent::Type]
 

data/lib/anthropic/models/beta/sessions/beta_managed_agents_span_model_usage.rb

@@ -30,9 +30,8 @@ module Anthropic
           required :output_tokens, Integer
 
           # @!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 tier this request actually ran at. Mirrors `usage.speed` on
+          #   /v1/messages. Only present when the fast-mode beta is active.
           #
           #   @return [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage::Speed, nil]
           optional :speed,
@@ -54,11 +53,10 @@ module Anthropic
           #
           #   @param output_tokens [Integer] Output tokens generated by this request.
           #
-          #   @param speed [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage::Speed, nil] Inference speed mode. `fast` provides significantly faster output token generati
+          #   @param speed [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage::Speed, nil] Inference speed tier this request actually ran at. Mirrors `usage.speed` on /v1/
 
-          # 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.
           #
           # @see Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage#speed
           module Speed

data/lib/anthropic/models/beta/sessions/beta_managed_agents_span_outcome_evaluation_end_event.rb

@@ -38,7 +38,7 @@ module Anthropic
           required :outcome_id, String
 
           # @!attribute processed_at
-          #   A timestamp in RFC 3339 format
+          #   Timestamp when outcome evaluation ended.
           #
           #   @return [Time]
           required :processed_at, Time
@@ -62,7 +62,8 @@ module Anthropic
                    enum: -> { Anthropic::Beta::Sessions::BetaManagedAgentsSpanOutcomeEvaluationEndEvent::Type }
 
           # @!attribute usage
-          #   Token usage for a single model request.
+          #   Aggregate token usage for this evaluation cycle. Sums across all grader model
+          #   requests within the cycle.
           #
           #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage]
           required :usage, -> { Anthropic::Beta::Sessions::BetaManagedAgentsSpanModelUsage }
@@ -87,13 +88,13 @@ module Anthropic
           #
           #   @param outcome_id [String] The `outc_` ID of the outcome being evaluated.
           #
-          #   @param processed_at [Time] A timestamp in RFC 3339 format
+          #   @param processed_at [Time] Timestamp when outcome evaluation ended.
           #
           #   @param result [String] Evaluation verdict. 'satisfied': criteria met, session goes idle. 'needs_revisio
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanOutcomeEvaluationEndEvent::Type]
           #
-          #   @param usage [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] Token usage for a single model request.
+          #   @param usage [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] Aggregate token usage for this evaluation cycle. Sums across all grader model re
 
           # @see Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanOutcomeEvaluationEndEvent#type
           module Type

data/lib/anthropic/models/beta/sessions/beta_managed_agents_span_outcome_evaluation_ongoing_event.rb

@@ -25,7 +25,7 @@ module Anthropic
           required :outcome_id, String
 
           # @!attribute processed_at
-          #   A timestamp in RFC 3339 format
+          #   Timestamp when this heartbeat was emitted.
           #
           #   @return [Time]
           required :processed_at, Time
@@ -52,7 +52,7 @@ module Anthropic
           #
           #   @param outcome_id [String] The `outc_` ID of the outcome being evaluated.
           #
-          #   @param processed_at [Time] A timestamp in RFC 3339 format
+          #   @param processed_at [Time] Timestamp when this heartbeat was emitted.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent::Type]
 

data/lib/anthropic/models/beta/sessions/beta_managed_agents_span_outcome_evaluation_start_event.rb

@@ -25,7 +25,7 @@ module Anthropic
           required :outcome_id, String
 
           # @!attribute processed_at
-          #   A timestamp in RFC 3339 format
+          #   Timestamp when outcome evaluation started.
           #
           #   @return [Time]
           required :processed_at, Time
@@ -49,7 +49,7 @@ module Anthropic
           #
           #   @param outcome_id [String] The `outc_` ID of the outcome being evaluated.
           #
-          #   @param processed_at [Time] A timestamp in RFC 3339 format
+          #   @param processed_at [Time] Timestamp when outcome evaluation started.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanOutcomeEvaluationStartEvent::Type]
 

data/lib/anthropic/models/beta/sessions/beta_managed_agents_stream_session_events.rb

@@ -198,7 +198,7 @@ module Anthropic
           # {Anthropic::Models::Beta::Sessions::BetaManagedAgentsStreamSessionEvents} for
           # more details.
           #
-          # @param type [Symbol, String]
+          # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsStreamSessionEvents::Type, String]
           #
           # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
           #
@@ -206,11 +206,11 @@ module Anthropic
           #
           #   @option args [Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsImageBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsDocumentBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRedactedBlock>, Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsImageBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsDocumentBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSearchResultBlock>, Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRedactedBlock>, Array<Anthropic::Models::Beta::BetaManagedAgentsSystemContentBlock>] :content Array of content blocks comprising the user message.
           #
-          #   @option args [Time, nil, Time] :processed_at A timestamp in RFC 3339 format
+          #   @option args [Time, nil, Time] :processed_at Timestamp when the agent finished processing this message.
           #
           #   @option args [String, nil, String] :session_thread_id If absent, interrupts every non-archived thread in a multiagent session (or the
           #
-          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserToolConfirmationEvent::Result, String] :result UserToolConfirmationResult enum
+          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserToolConfirmationEvent::Result, String] :result The confirmation result: 'allow' or 'deny'.
           #
           #   @option args [String] :tool_use_id The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresp
           #
@@ -226,7 +226,9 @@ module Anthropic
           #
           #   @option args [String] :mcp_server_name Name of the MCP server providing the tool.
           #
-          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentMCPToolUseEvent::EvaluatedPermission, Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolUseEvent::EvaluatedPermission] :evaluated_permission AgentEvaluatedPermission enum
+          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentEvaluatedPermission] :evaluated_permission The evaluated permission policy for this tool invocation.
+          #
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAlwaysAllow, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAlwaysAsk, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAuto] :evaluation Which resolved permission_policy produced evaluated_permission: always_allow, al
           #
           #   @option args [String] :mcp_tool_use_id The id of the `agent.mcp_tool_use` event this result corresponds to.
           #
@@ -238,9 +240,11 @@ module Anthropic
           #
           #   @option args [String, nil] :to_agent_name Name of the callable agent this message was sent to. Absent when sent to the pri
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelOverloadedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRateLimitedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRequestFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPConnectionFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPAuthenticationFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsBillingError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsCredentialHostUnreachableError] :error An unknown or unexpected error occurred during session execution. A fallback var
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelOverloadedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRateLimitedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRequestFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPConnectionFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPAuthenticationFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsBillingError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsCredentialHostUnreachableError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryAuthenticationError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryForbiddenError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryNotFoundError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryCheckoutError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryCloneError] :error
+          #
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRefusalStopDetails, nil] :stop_details Structured information about why the session stopped. `null` when there is nothi
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionEndTurn, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRequiresAction, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRetriesExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionBudgetReached] :stop_reason The agent completed its turn naturally and is ready for the next user message.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionEndTurn, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRequiresAction, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRetriesExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionBudgetReached, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRefusal] :stop_reason
           #
           #   @option args [String] :agent_name Name of the callable agent the thread runs.
           #
@@ -252,21 +256,21 @@ module Anthropic
           #
           #   @option args [String] :outcome_evaluation_start_id The id of the corresponding `span.outcome_evaluation_start` event.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot] :usage Token usage for a single model request.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot] :usage Aggregate token usage for this evaluation cycle. Sums across all grader model re
           #
           #   @option args [String] :model_request_start_id The id of the corresponding `span.model_request_start` event.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] :model_usage Token usage for a single model request.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] :model_usage Token usage for this model request.
           #
           #   @option args [String] :description What the agent should produce. Copied from the input event.
           #
           #   @option args [Integer, nil] :max_iterations Evaluate-then-revise cycles before giving up. Default 3, max 20.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric] :rubric Rubric for grading the quality of an outcome.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric] :rubric How to grade the outcome. File rubrics are currently resolved to their text cont
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil] :agent Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil] :agent The session's effective agent configuration after the update. Present only when
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] :budget A hard spend ceiling. The session stops issuing new model requests once the trac
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] :budget The session's budget after the update: the new budget when set or replaced, or n
           #
           #   @option args [Hash{Symbol=>String}] :metadata The session's full metadata bag after the update. Present when the update set no
           #

data/lib/anthropic/models/beta/sessions/beta_managed_agents_stream_session_thread_events.rb

@@ -196,7 +196,7 @@ module Anthropic
           # {Anthropic::Models::Beta::Sessions::BetaManagedAgentsStreamSessionThreadEvents}
           # for more details.
           #
-          # @param type [Symbol, String]
+          # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsStreamSessionThreadEvents::Type, String]
           #
           # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
           #
@@ -204,11 +204,11 @@ module Anthropic
           #
           #   @option args [Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsImageBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsDocumentBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRedactedBlock>, Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsImageBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsDocumentBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSearchResultBlock>, Array<Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextBlock, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRedactedBlock>, Array<Anthropic::Models::Beta::BetaManagedAgentsSystemContentBlock>] :content Array of content blocks comprising the user message.
           #
-          #   @option args [Time, nil, Time] :processed_at A timestamp in RFC 3339 format
+          #   @option args [Time, nil, Time] :processed_at Timestamp when the agent finished processing this message.
           #
           #   @option args [String, nil, String] :session_thread_id If absent, interrupts every non-archived thread in a multiagent session (or the
           #
-          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserToolConfirmationEvent::Result, String] :result UserToolConfirmationResult enum
+          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserToolConfirmationEvent::Result, String] :result The confirmation result: 'allow' or 'deny'.
           #
           #   @option args [String] :tool_use_id The id of the `agent.tool_use` or `agent.mcp_tool_use` event this result corresp
           #
@@ -224,7 +224,9 @@ module Anthropic
           #
           #   @option args [String] :mcp_server_name Name of the MCP server providing the tool.
           #
-          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentMCPToolUseEvent::EvaluatedPermission, Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolUseEvent::EvaluatedPermission] :evaluated_permission AgentEvaluatedPermission enum
+          #   @option args [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentEvaluatedPermission] :evaluated_permission The evaluated permission policy for this tool invocation.
+          #
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAlwaysAllow, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAlwaysAsk, Anthropic::Models::Beta::Sessions::BetaManagedAgentsAgentToolEvaluationAuto] :evaluation Which resolved permission_policy produced evaluated_permission: always_allow, al
           #
           #   @option args [String] :mcp_tool_use_id The id of the `agent.mcp_tool_use` event this result corresponds to.
           #
@@ -236,9 +238,11 @@ module Anthropic
           #
           #   @option args [String, nil] :to_agent_name Name of the callable agent this message was sent to. Absent when sent to the pri
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelOverloadedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRateLimitedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRequestFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPConnectionFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPAuthenticationFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsBillingError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsCredentialHostUnreachableError] :error An unknown or unexpected error occurred during session execution. A fallback var
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelOverloadedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRateLimitedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsModelRequestFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPConnectionFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsMCPAuthenticationFailedError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsBillingError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsCredentialHostUnreachableError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryAuthenticationError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryForbiddenError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryNotFoundError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryCheckoutError, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRepositoryCloneError] :error
+          #
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRefusalStopDetails, nil] :stop_details Structured information about why the session stopped. `null` when there is nothi
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionEndTurn, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRequiresAction, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRetriesExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionBudgetReached] :stop_reason The agent completed its turn naturally and is ready for the next user message.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionEndTurn, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRequiresAction, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRetriesExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionBudgetReached, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionRefusal] :stop_reason
           #
           #   @option args [String] :agent_name Name of the callable agent the thread runs.
           #
@@ -250,21 +254,21 @@ module Anthropic
           #
           #   @option args [String] :outcome_evaluation_start_id The id of the corresponding `span.outcome_evaluation_start` event.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot] :usage Token usage for a single model request.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage, Anthropic::Models::Beta::Sessions::BetaManagedAgentsSessionUsageSnapshot] :usage Aggregate token usage for this evaluation cycle. Sums across all grader model re
           #
           #   @option args [String] :model_request_start_id The id of the corresponding `span.model_request_start` event.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] :model_usage Token usage for a single model request.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsSpanModelUsage] :model_usage Token usage for this model request.
           #
           #   @option args [String] :description What the agent should produce. Copied from the input event.
           #
           #   @option args [Integer, nil] :max_iterations Evaluate-then-revise cycles before giving up. Default 3, max 20.
           #
-          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric] :rubric Rubric for grading the quality of an outcome.
+          #   @option args [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric] :rubric How to grade the outcome. File rubrics are currently resolved to their text cont
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil] :agent Resolved `agent` definition for a `session`. Snapshot of the `agent` at `session
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsSessionAgent, nil] :agent The session's effective agent configuration after the update. Present only when
           #
-          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] :budget A hard spend ceiling. The session stops issuing new model requests once the trac
+          #   @option args [Anthropic::Models::Beta::BetaManagedAgentsBudgetLimit, nil] :budget The session's budget after the update: the new budget when set or replaced, or n
           #
           #   @option args [Hash{Symbol=>String}] :metadata The session's full metadata bag after the update. Present when the update set no
           #

data/lib/anthropic/models/beta/sessions/beta_managed_agents_unknown_error.rb

@@ -12,7 +12,7 @@ module Anthropic
           required :message, String
 
           # @!attribute retry_status
-          #   What the client should do next in response to this error.
+          #   What the client should do next.
           #
           #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusRetrying, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusTerminal]
           required :retry_status,
@@ -30,11 +30,11 @@ module Anthropic
           #
           #   @param message [String] Human-readable error description.
           #
-          #   @param retry_status [Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusRetrying, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusTerminal] What the client should do next in response to this error.
+          #   @param retry_status [Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusRetrying, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusExhausted, Anthropic::Models::Beta::Sessions::BetaManagedAgentsRetryStatusTerminal] What the client should do next.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError::Type]
 
-          # What the client should do next in response to this error.
+          # What the client should do next.
           #
           # @see Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError#retry_status
           module RetryStatus
@@ -68,7 +68,7 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
-            # @param type [Symbol, String]
+            # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUnknownError::RetryStatus::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #

data/lib/anthropic/models/beta/sessions/beta_managed_agents_user_custom_tool_result_event.rb

@@ -39,14 +39,14 @@ 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
 
           # @!attribute session_thread_id
-          #   Routes this result to a subagent thread. Copy from the `agent.custom_tool_use`
-          #   event's `session_thread_id`.
+          #   Set by the server to the subagent thread this result was routed to. Omitted when
+          #   it was routed to the primary thread.
           #
           #   @return [String, nil]
           optional :session_thread_id, String, nil?: true
@@ -68,9 +68,9 @@ 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] Routes this result to a subagent thread. Copy from the `agent.custom_tool_use` e
+          #   @param session_thread_id [String, nil] Set by the server to the subagent thread this result was routed to. Omitted when
 
           # @see Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserCustomToolResultEvent#type
           module Type
@@ -119,19 +119,19 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
-            # @param type [Symbol, String]
+            # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserCustomToolResultEvent::Content::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #
             #   @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/sessions/beta_managed_agents_user_custom_tool_result_event_params.rb

@@ -95,19 +95,19 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
-            # @param type [Symbol, String]
+            # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserCustomToolResultEventParams::Content::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #
             #   @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/sessions/beta_managed_agents_user_define_outcome_event.rb

@@ -31,13 +31,14 @@ module Anthropic
           required :outcome_id, String
 
           # @!attribute processed_at
-          #   A timestamp in RFC 3339 format
+          #   Timestamp when the outcome was accepted.
           #
           #   @return [Time]
           required :processed_at, Time
 
           # @!attribute rubric
-          #   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.
           #
           #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric]
           required :rubric, union: -> { Anthropic::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEvent::Rubric }
@@ -63,13 +64,14 @@ module Anthropic
           #
           #   @param outcome_id [String] Server-generated `outc_` ID for this outcome. Referenced by `span.outcome_evalua
           #
-          #   @param processed_at [Time] A timestamp in RFC 3339 format
+          #   @param processed_at [Time] Timestamp when the outcome was accepted.
           #
-          #   @param rubric [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric] Rubric for grading the quality of an outcome.
+          #   @param rubric [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubric, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubric] How to grade the outcome. File rubrics are currently resolved to their text cont
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEvent::Type]
 
-          # 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.
           #
           # @see Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEvent#rubric
           module Rubric
@@ -99,7 +101,7 @@ module Anthropic
             # Creates a new instance of the variant class whose `type` matches the given
             # value, passing the remaining arguments to its constructor.
             #
-            # @param type [Symbol, String]
+            # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEvent::Rubric::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #

data/lib/anthropic/models/beta/sessions/beta_managed_agents_user_define_outcome_event_params.rb

@@ -12,7 +12,7 @@ module Anthropic
           required :description, String
 
           # @!attribute rubric
-          #   Rubric for grading the quality of an outcome.
+          #   How to grade the outcome. Text or file reference.
           #
           #   @return [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubricParams, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubricParams]
           required :rubric,
@@ -36,13 +36,13 @@ module Anthropic
           #
           #   @param description [String] What the agent should produce. This is the task specification.
           #
-          #   @param rubric [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubricParams, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubricParams] Rubric for grading the quality of an outcome.
+          #   @param rubric [Anthropic::Models::Beta::Sessions::BetaManagedAgentsFileRubricParams, Anthropic::Models::Beta::Sessions::BetaManagedAgentsTextRubricParams] How to grade the outcome. Text or file reference.
           #
           #   @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEventParams::Type]
           #
           #   @param max_iterations [Integer, nil] Eval→revision cycles before giving up. Default 3, max 20.
 
-          # Rubric for grading the quality of an outcome.
+          # How to grade the outcome. Text or file reference.
           #
           # @see Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEventParams#rubric
           module Rubric
@@ -76,7 +76,7 @@ module Anthropic
             # {Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEventParams::Rubric}
             # for more details.
             #
-            # @param type [Symbol, String]
+            # @param type [Symbol, Anthropic::Models::Beta::Sessions::BetaManagedAgentsUserDefineOutcomeEventParams::Rubric::Type, String]
             #
             # @param args [Hash{Symbol=>Object}] Attributes for the chosen variant.
             #