@code-yeongyu/senpi 2026.8.24 → 2026.8.26

package/node_modules/@anthropic-ai/sdk/src/resources/beta/sessions/events.ts

@@ -1,13 +1,19 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import type { Anthropic } from '../../../client';
 import { APIResource } from '../../../core/resource';
 import * as BetaAPI from '../beta';
+import * as SessionsAPI from './sessions';
 import { APIPromise } from '../../../core/api-promise';
 import { PageCursor, type PageCursorParams, PagePromise } from '../../../core/pagination';
 import { Stream } from '../../../core/streaming';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
+import {
+  SessionToolRunner,
+  type SessionToolRunnerOptions as RunnerSessionToolRunnerOptions,
+} from '../../../lib/tools/SessionToolRunner';
 
 export class Events extends APIResource {
   /**
@@ -99,8 +105,9 @@ export class Events extends APIResource {
     params: EventStreamParams | undefined = {},
     options?: RequestOptions,
   ): APIPromise<Stream<BetaManagedAgentsStreamSessionEvents>> {
-    const { betas } = params ?? {};
+    const { betas, ...query } = params ?? {};
     return this._client.get(path`/v1/sessions/${sessionID}/events/stream?beta=true`, {
+      query,
       ...options,
       headers: buildHeaders([
         { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
@@ -109,6 +116,29 @@ export class Events extends APIResource {
       stream: true,
     }) as APIPromise<Stream<BetaManagedAgentsStreamSessionEvents>>;
   }
+
+  /**
+   * Attach to a session and dispatch every incoming `agent.tool_use` and
+   * `agent.custom_tool_use` event to a local tool registry, sending the matching
+   * result back (`user.tool_result` / `user.custom_tool_result`). The
+   * sessions-side counterpart to `client.beta.messages.toolRunner`: yields one
+   * entry per completed tool call so callers can observe each dispatch (and
+   * `break` to abort cleanly).
+   *
+   * @example
+   * ```ts
+   * import { betaAgentToolset20260401 } from '@anthropic-ai/sdk/tools/agent-toolset/node';
+   *
+   * for await (const call of client.beta.sessions.events.toolRunner(work.data.id, {
+   *   tools: [...betaAgentToolset20260401({ workdir }), myTool],
+   * })) {
+   *   console.log(`${call.name} -> ${call.isError ? 'error' : 'ok'}`);
+   * }
+   * ```
+   */
+  toolRunner(sessionID: string, opts: Omit<RunnerSessionToolRunnerOptions, 'client'>): SessionToolRunner {
+    return new SessionToolRunner(sessionID, { ...opts, client: this._client as Anthropic });
+  }
 }
 
 export type BetaManagedAgentsSessionEventsPageCursor = PageCursor<BetaManagedAgentsSessionEvent>;
@@ -139,6 +169,13 @@ export interface BetaManagedAgentsAgentCustomToolUseEvent {
   processed_at: string;
 
   type: 'agent.custom_tool_use';
+
+  /**
+   * When set, this event was cross-posted from a subagent's thread to surface its
+   * custom tool use on the primary thread's stream. Empty on the thread's own
+   * events. Echo this on a `user.custom_tool_result` event to route the result back.
+   */
+  session_thread_id?: string | null;
 }
 
 /**
@@ -165,7 +202,12 @@ export interface BetaManagedAgentsAgentMCPToolResultEvent {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -208,6 +250,14 @@ export interface BetaManagedAgentsAgentMCPToolUseEvent {
    * AgentEvaluatedPermission enum
    */
   evaluated_permission?: 'allow' | 'ask' | 'deny';
+
+  /**
+   * When set, this event was cross-posted from a subagent's thread to surface its
+   * permission request on the primary thread's stream. Empty on the thread's own
+   * events. Echo this on a `user.tool_confirmation` event to route the approval
+   * back.
+   */
+  session_thread_id?: string | null;
 }
 
 /**
@@ -222,7 +272,7 @@ export interface BetaManagedAgentsAgentMessageEvent {
   /**
    * Array of text blocks comprising the agent response.
    */
-  content: Array<BetaManagedAgentsTextBlock>;
+  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsRedactedBlock>;
 
   /**
    * A timestamp in RFC 3339 format
@@ -267,6 +317,84 @@ export interface BetaManagedAgentsAgentThreadContextCompactedEvent {
   type: 'agent.thread_context_compacted';
 }
 
+/**
+ * Delivery event written to the target thread's input stream when an
+ * agent-to-agent message arrives.
+ */
+export interface BetaManagedAgentsAgentThreadMessageReceivedEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Message content blocks.
+   */
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
+
+  /**
+   * Public `sthr_` ID of the thread that sent the message.
+   */
+  from_session_thread_id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  type: 'agent.thread_message_received';
+
+  /**
+   * Name of the callable agent this message came from. Absent when received from the
+   * primary agent.
+   */
+  from_agent_name?: string | null;
+}
+
+/**
+ * Observability event emitted to the sender's output stream when an agent-to-agent
+ * message is sent.
+ */
+export interface BetaManagedAgentsAgentThreadMessageSentEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Message content blocks.
+   */
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Public `sthr_` ID of the thread the message was sent to.
+   */
+  to_session_thread_id: string;
+
+  type: 'agent.thread_message_sent';
+
+  /**
+   * Name of the callable agent this message was sent to. Absent when sent to the
+   * primary agent.
+   */
+  to_agent_name?: string | null;
+}
+
 /**
  * Event representing the result of an agent tool execution.
  */
@@ -291,7 +419,12 @@ export interface BetaManagedAgentsAgentToolResultEvent {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -329,6 +462,14 @@ export interface BetaManagedAgentsAgentToolUseEvent {
    * AgentEvaluatedPermission enum
    */
   evaluated_permission?: 'allow' | 'ask' | 'deny';
+
+  /**
+   * When set, this event was cross-posted from a subagent's thread to surface its
+   * permission request on the primary thread's stream. Empty on the thread's own
+   * events. Echo this on a `user.tool_confirmation` event to route the approval
+   * back.
+   */
+  session_thread_id?: string | null;
 }
 
 /**
@@ -388,6 +529,37 @@ export interface BetaManagedAgentsBillingError {
   type: 'billing_error';
 }
 
+/**
+ * An `environment_variable` credential's `auth.networking.allowed_hosts` includes
+ * a host the environment's network policy does not permit.
+ */
+export interface BetaManagedAgentsCredentialHostUnreachableError {
+  /**
+   * ID of the affected credential.
+   */
+  credential_id: string;
+
+  /**
+   * Human-readable error description.
+   */
+  message: string;
+
+  /**
+   * What the client should do next in response to this error.
+   */
+  retry_status:
+    | BetaManagedAgentsRetryStatusRetrying
+    | BetaManagedAgentsRetryStatusExhausted
+    | BetaManagedAgentsRetryStatusTerminal;
+
+  type: 'credential_host_unreachable_error';
+
+  /**
+   * ID of the vault containing the affected credential.
+   */
+  vault_id: string;
+}
+
 /**
  * Document content, either specified directly as base64 data, as text, or as a
  * reference via a URL.
@@ -422,7 +594,10 @@ export type BetaManagedAgentsEventParams =
   | BetaManagedAgentsUserMessageEventParams
   | BetaManagedAgentsUserInterruptEventParams
   | BetaManagedAgentsUserToolConfirmationEventParams
-  | BetaManagedAgentsUserCustomToolResultEventParams;
+  | BetaManagedAgentsUserCustomToolResultEventParams
+  | BetaManagedAgentsUserDefineOutcomeEventParams
+  | BetaManagedAgentsUserToolResultEventParams
+  | BetaManagedAgentsSystemMessageEventParams;
 
 /**
  * Document referenced by file ID.
@@ -448,6 +623,30 @@ export interface BetaManagedAgentsFileImageSource {
   type: 'file';
 }
 
+/**
+ * Rubric referenced by a file uploaded via the Files API.
+ */
+export interface BetaManagedAgentsFileRubric {
+  /**
+   * ID of the rubric file.
+   */
+  file_id: string;
+
+  type: 'file';
+}
+
+/**
+ * Rubric referenced by a file uploaded via the Files API.
+ */
+export interface BetaManagedAgentsFileRubricParams {
+  /**
+   * ID of the rubric file.
+   */
+  file_id: string;
+
+  type: 'file';
+}
+
 /**
  * Image content specified directly as base64 data or as a reference via a URL.
  */
@@ -591,6 +790,13 @@ export interface BetaManagedAgentsPlainTextDocumentSource {
   type: 'text';
 }
 
+/**
+ * Placeholder for content withheld by Anthropic model policy.
+ */
+export interface BetaManagedAgentsRedactedBlock {
+  type: 'redacted';
+}
+
 /**
  * This turn is dead; queued inputs are flushed and the session returns to idle.
  * Client may send a new prompt.
@@ -616,6 +822,55 @@ export interface BetaManagedAgentsRetryStatusTerminal {
   type: 'terminal';
 }
 
+/**
+ * A block containing a web search result.
+ */
+export interface BetaManagedAgentsSearchResultBlock {
+  /**
+   * Citation settings for a search result.
+   */
+  citations: BetaManagedAgentsSearchResultCitations;
+
+  /**
+   * Array of text content blocks from the search result.
+   */
+  content: Array<BetaManagedAgentsSearchResultContent>;
+
+  /**
+   * The URL source of the search result.
+   */
+  source: string;
+
+  /**
+   * The title of the search result.
+   */
+  title: string;
+
+  type: 'search_result';
+}
+
+/**
+ * Citation settings for a search result.
+ */
+export interface BetaManagedAgentsSearchResultCitations {
+  /**
+   * Whether citations are enabled for this search result.
+   */
+  enabled: boolean;
+}
+
+/**
+ * Text content within a search result.
+ */
+export interface BetaManagedAgentsSearchResultContent {
+  /**
+   * The text content.
+   */
+  text: string;
+
+  type: 'text';
+}
+
 /**
  * Events that were successfully sent to the session.
  */
@@ -628,9 +883,22 @@ export interface BetaManagedAgentsSendSessionEvents {
     | BetaManagedAgentsUserInterruptEvent
     | BetaManagedAgentsUserToolConfirmationEvent
     | BetaManagedAgentsUserCustomToolResultEvent
+    | BetaManagedAgentsUserDefineOutcomeEvent
+    | SessionsAPI.BetaManagedAgentsUserToolResultEvent
+    | SessionsAPI.BetaManagedAgentsSystemMessageEvent
   >;
 }
 
+/**
+ * The agent stopped because the session's tracked list cost reached its budget, or
+ * because its usage includes a model with no list price (which the budget cannot
+ * measure). Raise the budget to continue — or, if raising is rejected because a
+ * model has no list price, remove the budget.
+ */
+export interface BetaManagedAgentsSessionBudgetReached {
+  type: 'budget_reached';
+}
+
 /**
  * Emitted when a session has been deleted. Terminates any active event stream — no
  * further events will be emitted for this session.
@@ -677,7 +945,8 @@ export interface BetaManagedAgentsSessionErrorEvent {
     | BetaManagedAgentsModelRequestFailedError
     | BetaManagedAgentsMCPConnectionFailedError
     | BetaManagedAgentsMCPAuthenticationFailedError
-    | BetaManagedAgentsBillingError;
+    | BetaManagedAgentsBillingError
+    | BetaManagedAgentsCredentialHostUnreachableError;
 
   /**
    * A timestamp in RFC 3339 format
@@ -702,15 +971,30 @@ export type BetaManagedAgentsSessionEvent =
   | BetaManagedAgentsAgentMCPToolResultEvent
   | BetaManagedAgentsAgentToolUseEvent
   | BetaManagedAgentsAgentToolResultEvent
+  | BetaManagedAgentsAgentThreadMessageReceivedEvent
+  | BetaManagedAgentsAgentThreadMessageSentEvent
   | BetaManagedAgentsAgentThreadContextCompactedEvent
   | BetaManagedAgentsSessionErrorEvent
   | BetaManagedAgentsSessionStatusRescheduledEvent
   | BetaManagedAgentsSessionStatusRunningEvent
   | BetaManagedAgentsSessionStatusIdleEvent
   | BetaManagedAgentsSessionStatusTerminatedEvent
+  | BetaManagedAgentsSessionThreadCreatedEvent
+  | BetaManagedAgentsSpanOutcomeEvaluationStartEvent
+  | BetaManagedAgentsSpanOutcomeEvaluationEndEvent
   | BetaManagedAgentsSpanModelRequestStartEvent
   | BetaManagedAgentsSpanModelRequestEndEvent
-  | BetaManagedAgentsSessionDeletedEvent;
+  | BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent
+  | BetaManagedAgentsUserDefineOutcomeEvent
+  | BetaManagedAgentsSessionDeletedEvent
+  | BetaManagedAgentsSessionThreadStatusRunningEvent
+  | BetaManagedAgentsSessionThreadStatusIdleEvent
+  | BetaManagedAgentsSessionThreadStatusTerminatedEvent
+  | SessionsAPI.BetaManagedAgentsUserToolResultEvent
+  | BetaManagedAgentsSessionThreadStatusRescheduledEvent
+  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent
+  | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
 
 /**
  * The agent is idle waiting on one or more blocking user-input events (tool
@@ -728,8 +1012,8 @@ export interface BetaManagedAgentsSessionRequiresAction {
 }
 
 /**
- * The turn ended because the retry budget was exhausted (`max_iterations` hit or
- * an error escalated to `retry_status: 'exhausted'`).
+ * The turn ended because repeated errors exhausted the retry budget or an error
+ * escalated to `retry_status: 'exhausted'`.
  */
 export interface BetaManagedAgentsSessionRetriesExhausted {
   type: 'retries_exhausted';
@@ -755,7 +1039,8 @@ export interface BetaManagedAgentsSessionStatusIdleEvent {
   stop_reason:
     | BetaManagedAgentsSessionEndTurn
     | BetaManagedAgentsSessionRequiresAction
-    | BetaManagedAgentsSessionRetriesExhausted;
+    | BetaManagedAgentsSessionRetriesExhausted
+    | BetaManagedAgentsSessionBudgetReached;
 
   type: 'session.status_idle';
 }
@@ -812,6 +1097,198 @@ export interface BetaManagedAgentsSessionStatusTerminatedEvent {
   type: 'session.status_terminated';
 }
 
+/**
+ * Emitted when a subagent is spawned as a new thread. Written to the parent
+ * thread's output stream so clients observing the session see child creation.
+ */
+export interface BetaManagedAgentsSessionThreadCreatedEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Name of the callable agent the thread runs.
+   */
+  agent_name: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Public `sthr_` ID of the newly created thread.
+   */
+  session_thread_id: string;
+
+  type: 'session.thread_created';
+}
+
+/**
+ * A session thread has yielded and is awaiting input. Emitted on the thread's own
+ * stream and cross-posted to the primary stream for child threads.
+ */
+export interface BetaManagedAgentsSessionThreadStatusIdleEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Name of the agent the thread runs.
+   */
+  agent_name: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Public sthr\_ ID of the thread that went idle.
+   */
+  session_thread_id: string;
+
+  /**
+   * The agent completed its turn naturally and is ready for the next user message.
+   */
+  stop_reason:
+    | BetaManagedAgentsSessionEndTurn
+    | BetaManagedAgentsSessionRequiresAction
+    | BetaManagedAgentsSessionRetriesExhausted
+    | BetaManagedAgentsSessionBudgetReached;
+
+  type: 'session.thread_status_idle';
+}
+
+/**
+ * A session thread hit a transient error and is retrying automatically. Emitted on
+ * the thread's own stream and cross-posted to the primary stream for child
+ * threads.
+ */
+export interface BetaManagedAgentsSessionThreadStatusRescheduledEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Name of the agent the thread runs.
+   */
+  agent_name: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Public sthr\_ ID of the thread that is retrying.
+   */
+  session_thread_id: string;
+
+  type: 'session.thread_status_rescheduled';
+}
+
+/**
+ * A session thread has begun executing. Emitted on the thread's own stream and
+ * cross-posted to the primary stream for child threads.
+ */
+export interface BetaManagedAgentsSessionThreadStatusRunningEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Name of the agent the thread runs.
+   */
+  agent_name: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Public sthr\_ ID of the thread that started running.
+   */
+  session_thread_id: string;
+
+  type: 'session.thread_status_running';
+}
+
+/**
+ * A session thread has terminated and will accept no further input. Emitted on the
+ * thread's own stream and cross-posted to the primary stream for child threads.
+ */
+export interface BetaManagedAgentsSessionThreadStatusTerminatedEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Name of the agent the thread runs.
+   */
+  agent_name: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Public sthr\_ ID of the thread that terminated.
+   */
+  session_thread_id: string;
+
+  type: 'session.thread_status_terminated';
+}
+
+/**
+ * Point-in-time snapshot of a session's cumulative usage.
+ */
+export interface BetaManagedAgentsSessionUsageSnapshot {
+  /**
+   * Cumulative time in seconds during which the session had at least one thread in
+   * running status. Overlapping activity from concurrent threads is counted once.
+   * This is the duration the session's runtime cost is priced on.
+   */
+  active_seconds?: number;
+
+  /**
+   * Prompt-cache creation token usage broken down by cache lifetime.
+   */
+  cache_creation?: SessionsAPI.BetaManagedAgentsCacheCreationUsage;
+
+  /**
+   * Total tokens read from prompt cache.
+   */
+  cache_read_input_tokens?: number;
+
+  /**
+   * Total input tokens consumed across all turns.
+   */
+  input_tokens?: number;
+
+  /**
+   * A monetary amount in a specific currency.
+   */
+  list_cost?: BetaAPI.BetaMonetaryAmount;
+
+  /**
+   * Total output tokens generated across all turns.
+   */
+  output_tokens?: number;
+
+  /**
+   * Cumulative count of server-executed tool invocations, broken down by tool.
+   */
+  server_tool_use?: SessionsAPI.BetaManagedAgentsServerToolUsage;
+}
+
 /**
  * Emitted when a model request completes.
  */
@@ -893,6 +1370,123 @@ export interface BetaManagedAgentsSpanModelUsage {
   speed?: 'standard' | 'fast' | null;
 }
 
+/**
+ * Emitted when an outcome evaluation cycle completes. Carries the verdict and
+ * aggregate token usage. A verdict of `needs_revision` means another evaluation
+ * cycle follows; `satisfied`, `max_iterations_reached`, `failed`, or `interrupted`
+ * are terminal — no further evaluation cycles follow.
+ */
+export interface BetaManagedAgentsSpanOutcomeEvaluationEndEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * Human-readable explanation of the verdict. For `needs_revision`, describes which
+   * criteria failed and why.
+   */
+  explanation: string;
+
+  /**
+   * 0-indexed revision cycle, matching the corresponding
+   * `span.outcome_evaluation_start`.
+   */
+  iteration: number;
+
+  /**
+   * The id of the corresponding `span.outcome_evaluation_start` event.
+   */
+  outcome_evaluation_start_id: string;
+
+  /**
+   * The `outc_` ID of the outcome being evaluated.
+   */
+  outcome_id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Evaluation verdict. 'satisfied': criteria met, session goes idle.
+   * 'needs_revision': criteria not met, another revision cycle follows.
+   * 'max_iterations_reached': evaluation budget exhausted with criteria still unmet
+   * — one final acknowledgment turn follows before the session goes idle, but no
+   * further evaluation runs. 'failed': grader determined the rubric does not apply
+   * to the deliverables. 'interrupted': user sent an interrupt while evaluation was
+   * in progress.
+   */
+  result: string;
+
+  type: 'span.outcome_evaluation_end';
+
+  /**
+   * Token usage for a single model request.
+   */
+  usage: BetaManagedAgentsSpanModelUsage;
+}
+
+/**
+ * Periodic heartbeat emitted while an outcome evaluation cycle is in progress.
+ * Distinguishes 'evaluation is actively running' from 'evaluation is stuck'
+ * between the corresponding `span.outcome_evaluation_start` and
+ * `span.outcome_evaluation_end` events.
+ */
+export interface BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * 0-indexed revision cycle, matching the corresponding
+   * `span.outcome_evaluation_start`.
+   */
+  iteration: number;
+
+  /**
+   * The `outc_` ID of the outcome being evaluated.
+   */
+  outcome_id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  type: 'span.outcome_evaluation_ongoing';
+}
+
+/**
+ * Emitted when an outcome evaluation cycle begins.
+ */
+export interface BetaManagedAgentsSpanOutcomeEvaluationStartEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * 0-indexed revision cycle. 0 is the first evaluation; 1 is the re-evaluation
+   * after the first revision; etc.
+   */
+  iteration: number;
+
+  /**
+   * The `outc_` ID of the outcome being evaluated.
+   */
+  outcome_id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  type: 'span.outcome_evaluation_start';
+}
+
 /**
  * Server-sent event in the session stream.
  */
@@ -908,15 +1502,49 @@ export type BetaManagedAgentsStreamSessionEvents =
   | BetaManagedAgentsAgentMCPToolResultEvent
   | BetaManagedAgentsAgentToolUseEvent
   | BetaManagedAgentsAgentToolResultEvent
+  | BetaManagedAgentsAgentThreadMessageReceivedEvent
+  | BetaManagedAgentsAgentThreadMessageSentEvent
   | BetaManagedAgentsAgentThreadContextCompactedEvent
   | BetaManagedAgentsSessionErrorEvent
   | BetaManagedAgentsSessionStatusRescheduledEvent
   | BetaManagedAgentsSessionStatusRunningEvent
   | BetaManagedAgentsSessionStatusIdleEvent
   | BetaManagedAgentsSessionStatusTerminatedEvent
+  | BetaManagedAgentsSessionThreadCreatedEvent
+  | BetaManagedAgentsSpanOutcomeEvaluationStartEvent
+  | BetaManagedAgentsSpanOutcomeEvaluationEndEvent
   | BetaManagedAgentsSpanModelRequestStartEvent
   | BetaManagedAgentsSpanModelRequestEndEvent
-  | BetaManagedAgentsSessionDeletedEvent;
+  | BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent
+  | BetaManagedAgentsUserDefineOutcomeEvent
+  | BetaManagedAgentsSessionDeletedEvent
+  | BetaManagedAgentsSessionThreadStatusRunningEvent
+  | BetaManagedAgentsSessionThreadStatusIdleEvent
+  | BetaManagedAgentsSessionThreadStatusTerminatedEvent
+  | SessionsAPI.BetaManagedAgentsUserToolResultEvent
+  | BetaManagedAgentsSessionThreadStatusRescheduledEvent
+  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
+  | SessionsAPI.BetaManagedAgentsStartEvent
+  | SessionsAPI.BetaManagedAgentsDeltaEvent
+  | SessionsAPI.BetaManagedAgentsSystemMessageEvent
+  | SessionsAPI.BetaManagedAgentsSessionUsageEvent;
+
+/**
+ * Privileged context for the accompanying turn and all subsequent turns, appended
+ * to the session's system context as a `role: "system"` turn rather than replacing
+ * the top-level system prompt. At most one per request: it must be the final event
+ * and immediately follow the `user.message`, `user.tool_result`, or
+ * `user.custom_tool_result` it accompanies. Only supported on models that accept
+ * mid-conversation system messages.
+ */
+export interface BetaManagedAgentsSystemMessageEventParams {
+  /**
+   * System content blocks to append. Text-only.
+   */
+  content: Array<SessionsAPI.BetaManagedAgentsSystemContentBlock>;
+
+  type: 'system.message';
+}
 
 /**
  * Regular text content.
@@ -930,6 +1558,31 @@ export interface BetaManagedAgentsTextBlock {
   type: 'text';
 }
 
+/**
+ * Rubric content provided inline as text.
+ */
+export interface BetaManagedAgentsTextRubric {
+  /**
+   * Rubric content. Plain text or markdown — the grader treats it as freeform text.
+   */
+  content: string;
+
+  type: 'text';
+}
+
+/**
+ * Rubric content provided inline as text.
+ */
+export interface BetaManagedAgentsTextRubricParams {
+  /**
+   * Rubric content. Plain text or markdown — the grader treats it as freeform text.
+   * Maximum 262144 characters.
+   */
+  content: string;
+
+  type: 'text';
+}
+
 /**
  * An unknown or unexpected error occurred during session execution. A fallback
  * variant; clients that don't recognize a new error code can match on
@@ -998,7 +1651,12 @@ export interface BetaManagedAgentsUserCustomToolResultEvent {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -1009,6 +1667,12 @@ export interface BetaManagedAgentsUserCustomToolResultEvent {
    * A timestamp in RFC 3339 format
    */
   processed_at?: string | null;
+
+  /**
+   * Routes this result to a subagent thread. Copy from the `agent.custom_tool_use`
+   * event's `session_thread_id`.
+   */
+  session_thread_id?: string | null;
 }
 
 /**
@@ -1028,7 +1692,12 @@ export interface BetaManagedAgentsUserCustomToolResultEventParams {
   /**
    * The result content returned by the tool.
    */
-  content?: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
 
   /**
    * Whether the tool execution resulted in an error.
@@ -1036,6 +1705,68 @@ export interface BetaManagedAgentsUserCustomToolResultEventParams {
   is_error?: boolean | null;
 }
 
+/**
+ * Echo of a `user.define_outcome` input event. Carries the server-generated
+ * `outcome_id` that subsequent `span.outcome_evaluation_*` events reference.
+ */
+export interface BetaManagedAgentsUserDefineOutcomeEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * What the agent should produce. Copied from the input event.
+   */
+  description: string;
+
+  /**
+   * Evaluate-then-revise cycles before giving up. Default 3, max 20.
+   */
+  max_iterations: number | null;
+
+  /**
+   * Server-generated `outc_` ID for this outcome. Referenced by
+   * `span.outcome_evaluation_*` events and the session's `outcome_evaluations` list.
+   */
+  outcome_id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  /**
+   * Rubric for grading the quality of an outcome.
+   */
+  rubric: BetaManagedAgentsFileRubric | BetaManagedAgentsTextRubric;
+
+  type: 'user.define_outcome';
+}
+
+/**
+ * Parameters for defining an outcome the agent should work toward. The agent
+ * begins work on receipt.
+ */
+export interface BetaManagedAgentsUserDefineOutcomeEventParams {
+  /**
+   * What the agent should produce. This is the task specification.
+   */
+  description: string;
+
+  /**
+   * Rubric for grading the quality of an outcome.
+   */
+  rubric: BetaManagedAgentsFileRubricParams | BetaManagedAgentsTextRubricParams;
+
+  type: 'user.define_outcome';
+
+  /**
+   * Eval→revision cycles before giving up. Default 3, max 20.
+   */
+  max_iterations?: number | null;
+}
+
 /**
  * An interrupt event that pauses agent execution and returns control to the user.
  */
@@ -1051,6 +1782,13 @@ export interface BetaManagedAgentsUserInterruptEvent {
    * A timestamp in RFC 3339 format
    */
   processed_at?: string | null;
+
+  /**
+   * 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?: string | null;
 }
 
 /**
@@ -1058,6 +1796,13 @@ export interface BetaManagedAgentsUserInterruptEvent {
  */
 export interface BetaManagedAgentsUserInterruptEventParams {
   type: 'user.interrupt';
+
+  /**
+   * 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?: string | null;
 }
 
 /**
@@ -1072,7 +1817,12 @@ export interface BetaManagedAgentsUserMessageEvent {
   /**
    * Array of content blocks comprising the user message.
    */
-  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
 
   type: 'user.message';
 
@@ -1089,7 +1839,12 @@ export interface BetaManagedAgentsUserMessageEventParams {
   /**
    * Array of content blocks for the user message.
    */
-  content: Array<BetaManagedAgentsTextBlock | BetaManagedAgentsImageBlock | BetaManagedAgentsDocumentBlock>;
+  content: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsRedactedBlock
+  >;
 
   type: 'user.message';
 }
@@ -1128,6 +1883,13 @@ export interface BetaManagedAgentsUserToolConfirmationEvent {
    * A timestamp in RFC 3339 format
    */
   processed_at?: string | null;
+
+  /**
+   * When set, the confirmation routes to this subagent's thread rather than the
+   * primary. Echo this from the `session_thread_id` on the `agent.tool_use` or
+   * `agent.mcp_tool_use` event that prompted the approval.
+   */
+  session_thread_id?: string | null;
 }
 
 /**
@@ -1156,13 +1918,76 @@ export interface BetaManagedAgentsUserToolConfirmationEventParams {
   deny_message?: string | null;
 }
 
+/**
+ * Parameters for providing the result of an agent-toolset tool execution. Only
+ * valid on `self_hosted` environments, where sandbox-routed tools are executed by
+ * the client rather than the server.
+ */
+export interface BetaManagedAgentsUserToolResultEventParams {
+  /**
+   * The id of the `agent.tool_use` event this result corresponds to, which can be
+   * found in the last `session.status_idle`
+   * [event's](https://platform.claude.com/docs/en/api/beta/sessions/events/list#beta_managed_agents_session_requires_action.event_ids)
+   * `stop_reason.event_ids` field.
+   */
+  tool_use_id: string;
+
+  type: 'user.tool_result';
+
+  /**
+   * The result content returned by the tool.
+   */
+  content?: Array<
+    | BetaManagedAgentsTextBlock
+    | BetaManagedAgentsImageBlock
+    | BetaManagedAgentsDocumentBlock
+    | BetaManagedAgentsSearchResultBlock
+  >;
+
+  /**
+   * Whether the tool execution resulted in an error.
+   */
+  is_error?: boolean | null;
+}
+
 export interface EventListParams extends PageCursorParams {
   /**
-   * Query param: Sort direction for results, ordered by created_at. Defaults to asc
-   * (chronological).
+   * Query param: Return events created after this time (exclusive). Compared against
+   * the event's `processed_at` value.
+   */
+  'created_at[gt]'?: string;
+
+  /**
+   * Query param: Return events created at or after this time (inclusive). Compared
+   * against the event's `processed_at` value.
+   */
+  'created_at[gte]'?: string;
+
+  /**
+   * Query param: Return events created before this time (exclusive). Compared
+   * against the event's `processed_at` value.
+   */
+  'created_at[lt]'?: string;
+
+  /**
+   * Query param: Return events created at or before this time (inclusive). Compared
+   * against the event's `processed_at` value.
+   */
+  'created_at[lte]'?: string;
+
+  /**
+   * Query param: Sort direction for results, ordered by the event's `processed_at`.
+   * Defaults to asc (chronological).
    */
   order?: 'asc' | 'desc';
 
+  /**
+   * Query param: Filter by event type. Values match the `type` field on returned
+   * events (for example, `user.message` or `agent.tool_use`). Omit to return all
+   * event types.
+   */
+  types?: Array<string>;
+
   /**
    * Header param: Optional header to specify the beta version(s) you want to use.
    */
@@ -1183,12 +2008,32 @@ export interface EventSendParams {
 
 export interface EventStreamParams {
   /**
-   * Optional header to specify the beta version(s) you want to use.
+   * Query param: When set, this connection also receives streaming deltas
+   * (`event_start`, `event_delta`) while an event is being produced, before the
+   * event itself arrives. Deltas are best-effort; when the final event is produced
+   * it carries the complete content. A model request that ends early (an error or
+   * interrupt) produces no final event — its terminal `span.model_request_end`
+   * closes the preview. Accepts one or more event types to preview and may be
+   * repeated: `agent.message` streams `content_delta` fragments; `agent.thinking` is
+   * start-only — a signal that the agent has begun extended thinking, concluded by
+   * the `agent.thinking` event itself. Only previews of the requested event types
+   * are sent.
+   */
+  event_deltas?: Array<SessionsAPI.BetaManagedAgentsDeltaType>;
+
+  /**
+   * Header param: Optional header to specify the beta version(s) you want to use.
    */
   betas?: Array<BetaAPI.AnthropicBeta>;
 }
 
+export { SessionToolRunner, type SessionToolRunnerOptions } from '../../../lib/tools/SessionToolRunner';
+
+Events.SessionToolRunner = SessionToolRunner;
+
 export declare namespace Events {
+  export { SessionToolRunner };
+
   export {
     type BetaManagedAgentsAgentCustomToolUseEvent as BetaManagedAgentsAgentCustomToolUseEvent,
     type BetaManagedAgentsAgentMCPToolResultEvent as BetaManagedAgentsAgentMCPToolResultEvent,
@@ -1196,15 +2041,20 @@ export declare namespace Events {
     type BetaManagedAgentsAgentMessageEvent as BetaManagedAgentsAgentMessageEvent,
     type BetaManagedAgentsAgentThinkingEvent as BetaManagedAgentsAgentThinkingEvent,
     type BetaManagedAgentsAgentThreadContextCompactedEvent as BetaManagedAgentsAgentThreadContextCompactedEvent,
+    type BetaManagedAgentsAgentThreadMessageReceivedEvent as BetaManagedAgentsAgentThreadMessageReceivedEvent,
+    type BetaManagedAgentsAgentThreadMessageSentEvent as BetaManagedAgentsAgentThreadMessageSentEvent,
     type BetaManagedAgentsAgentToolResultEvent as BetaManagedAgentsAgentToolResultEvent,
     type BetaManagedAgentsAgentToolUseEvent as BetaManagedAgentsAgentToolUseEvent,
     type BetaManagedAgentsBase64DocumentSource as BetaManagedAgentsBase64DocumentSource,
     type BetaManagedAgentsBase64ImageSource as BetaManagedAgentsBase64ImageSource,
     type BetaManagedAgentsBillingError as BetaManagedAgentsBillingError,
+    type BetaManagedAgentsCredentialHostUnreachableError as BetaManagedAgentsCredentialHostUnreachableError,
     type BetaManagedAgentsDocumentBlock as BetaManagedAgentsDocumentBlock,
     type BetaManagedAgentsEventParams as BetaManagedAgentsEventParams,
     type BetaManagedAgentsFileDocumentSource as BetaManagedAgentsFileDocumentSource,
     type BetaManagedAgentsFileImageSource as BetaManagedAgentsFileImageSource,
+    type BetaManagedAgentsFileRubric as BetaManagedAgentsFileRubric,
+    type BetaManagedAgentsFileRubricParams as BetaManagedAgentsFileRubricParams,
     type BetaManagedAgentsImageBlock as BetaManagedAgentsImageBlock,
     type BetaManagedAgentsMCPAuthenticationFailedError as BetaManagedAgentsMCPAuthenticationFailedError,
     type BetaManagedAgentsMCPConnectionFailedError as BetaManagedAgentsMCPConnectionFailedError,
@@ -1212,10 +2062,15 @@ export declare namespace Events {
     type BetaManagedAgentsModelRateLimitedError as BetaManagedAgentsModelRateLimitedError,
     type BetaManagedAgentsModelRequestFailedError as BetaManagedAgentsModelRequestFailedError,
     type BetaManagedAgentsPlainTextDocumentSource as BetaManagedAgentsPlainTextDocumentSource,
+    type BetaManagedAgentsRedactedBlock as BetaManagedAgentsRedactedBlock,
     type BetaManagedAgentsRetryStatusExhausted as BetaManagedAgentsRetryStatusExhausted,
     type BetaManagedAgentsRetryStatusRetrying as BetaManagedAgentsRetryStatusRetrying,
     type BetaManagedAgentsRetryStatusTerminal as BetaManagedAgentsRetryStatusTerminal,
+    type BetaManagedAgentsSearchResultBlock as BetaManagedAgentsSearchResultBlock,
+    type BetaManagedAgentsSearchResultCitations as BetaManagedAgentsSearchResultCitations,
+    type BetaManagedAgentsSearchResultContent as BetaManagedAgentsSearchResultContent,
     type BetaManagedAgentsSendSessionEvents as BetaManagedAgentsSendSessionEvents,
+    type BetaManagedAgentsSessionBudgetReached as BetaManagedAgentsSessionBudgetReached,
     type BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,
     type BetaManagedAgentsSessionErrorEvent as BetaManagedAgentsSessionErrorEvent,
@@ -1226,22 +2081,37 @@ export declare namespace Events {
     type BetaManagedAgentsSessionStatusRescheduledEvent as BetaManagedAgentsSessionStatusRescheduledEvent,
     type BetaManagedAgentsSessionStatusRunningEvent as BetaManagedAgentsSessionStatusRunningEvent,
     type BetaManagedAgentsSessionStatusTerminatedEvent as BetaManagedAgentsSessionStatusTerminatedEvent,
+    type BetaManagedAgentsSessionThreadCreatedEvent as BetaManagedAgentsSessionThreadCreatedEvent,
+    type BetaManagedAgentsSessionThreadStatusIdleEvent as BetaManagedAgentsSessionThreadStatusIdleEvent,
+    type BetaManagedAgentsSessionThreadStatusRescheduledEvent as BetaManagedAgentsSessionThreadStatusRescheduledEvent,
+    type BetaManagedAgentsSessionThreadStatusRunningEvent as BetaManagedAgentsSessionThreadStatusRunningEvent,
+    type BetaManagedAgentsSessionThreadStatusTerminatedEvent as BetaManagedAgentsSessionThreadStatusTerminatedEvent,
+    type BetaManagedAgentsSessionUsageSnapshot as BetaManagedAgentsSessionUsageSnapshot,
     type BetaManagedAgentsSpanModelRequestEndEvent as BetaManagedAgentsSpanModelRequestEndEvent,
     type BetaManagedAgentsSpanModelRequestStartEvent as BetaManagedAgentsSpanModelRequestStartEvent,
     type BetaManagedAgentsSpanModelUsage as BetaManagedAgentsSpanModelUsage,
+    type BetaManagedAgentsSpanOutcomeEvaluationEndEvent as BetaManagedAgentsSpanOutcomeEvaluationEndEvent,
+    type BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent as BetaManagedAgentsSpanOutcomeEvaluationOngoingEvent,
+    type BetaManagedAgentsSpanOutcomeEvaluationStartEvent as BetaManagedAgentsSpanOutcomeEvaluationStartEvent,
     type BetaManagedAgentsStreamSessionEvents as BetaManagedAgentsStreamSessionEvents,
+    type BetaManagedAgentsSystemMessageEventParams as BetaManagedAgentsSystemMessageEventParams,
     type BetaManagedAgentsTextBlock as BetaManagedAgentsTextBlock,
+    type BetaManagedAgentsTextRubric as BetaManagedAgentsTextRubric,
+    type BetaManagedAgentsTextRubricParams as BetaManagedAgentsTextRubricParams,
     type BetaManagedAgentsUnknownError as BetaManagedAgentsUnknownError,
     type BetaManagedAgentsURLDocumentSource as BetaManagedAgentsURLDocumentSource,
     type BetaManagedAgentsURLImageSource as BetaManagedAgentsURLImageSource,
     type BetaManagedAgentsUserCustomToolResultEvent as BetaManagedAgentsUserCustomToolResultEvent,
     type BetaManagedAgentsUserCustomToolResultEventParams as BetaManagedAgentsUserCustomToolResultEventParams,
+    type BetaManagedAgentsUserDefineOutcomeEvent as BetaManagedAgentsUserDefineOutcomeEvent,
+    type BetaManagedAgentsUserDefineOutcomeEventParams as BetaManagedAgentsUserDefineOutcomeEventParams,
     type BetaManagedAgentsUserInterruptEvent as BetaManagedAgentsUserInterruptEvent,
     type BetaManagedAgentsUserInterruptEventParams as BetaManagedAgentsUserInterruptEventParams,
     type BetaManagedAgentsUserMessageEvent as BetaManagedAgentsUserMessageEvent,
     type BetaManagedAgentsUserMessageEventParams as BetaManagedAgentsUserMessageEventParams,
     type BetaManagedAgentsUserToolConfirmationEvent as BetaManagedAgentsUserToolConfirmationEvent,
     type BetaManagedAgentsUserToolConfirmationEventParams as BetaManagedAgentsUserToolConfirmationEventParams,
+    type BetaManagedAgentsUserToolResultEventParams as BetaManagedAgentsUserToolResultEventParams,
     type BetaManagedAgentsSessionEventsPageCursor as BetaManagedAgentsSessionEventsPageCursor,
     type EventListParams as EventListParams,
     type EventSendParams as EventSendParams,