@anthropic-ai/sdk 0.95.2 → 0.97.0

package/src/resources/beta/messages/messages.ts

@@ -562,6 +562,54 @@ export interface BetaCacheCreation {
   ephemeral_5m_input_tokens: number;
 }
 
+export interface BetaCacheMissMessagesChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'messages_changed';
+}
+
+export interface BetaCacheMissModelChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'model_changed';
+}
+
+export interface BetaCacheMissPreviousMessageNotFound {
+  type: 'previous_message_not_found';
+}
+
+export interface BetaCacheMissSystemChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'system_changed';
+}
+
+export interface BetaCacheMissToolsChanged {
+  /**
+   * Approximate number of input tokens that would have been read from cache had the
+   * prefix matched the previous request.
+   */
+  cache_missed_input_tokens: number;
+
+  type: 'tools_changed';
+}
+
+export interface BetaCacheMissUnavailable {
+  type: 'unavailable';
+}
+
 export interface BetaCitationCharLocation {
   cited_text: string;
 
@@ -1131,11 +1179,6 @@ export interface BetaCompactionBlock {
  * treats these as no-ops. Empty string content is not allowed.
  */
 export interface BetaCompactionBlockParam {
-  /**
-   * Summary of previously compacted content, or null if compaction failed
-   */
-  content: string | null;
-
   type: 'compaction';
 
   /**
@@ -1143,6 +1186,11 @@ export interface BetaCompactionBlockParam {
    */
   cache_control?: BetaCacheControlEphemeral | null;
 
+  /**
+   * Summary of previously compacted content, or null if compaction failed
+   */
+  content?: string | null;
+
   /**
    * Opaque metadata from prior compaction, to be round-tripped verbatim
    */
@@ -1330,6 +1378,42 @@ export interface BetaCountTokensContextManagementResponse {
   original_input_tokens: number;
 }
 
+/**
+ * Response envelope for request-level diagnostics. Present (possibly null)
+ * whenever the caller supplied `diagnostics` on the request.
+ */
+export interface BetaDiagnostics {
+  /**
+   * Explains why the prompt cache could not fully reuse the prefix from the request
+   * identified by `diagnostics.previous_message_id`. `null` means diagnosis is still
+   * pending — the response was serialized before the background comparison
+   * completed.
+   */
+  cache_miss_reason:
+    | BetaCacheMissModelChanged
+    | BetaCacheMissSystemChanged
+    | BetaCacheMissToolsChanged
+    | BetaCacheMissMessagesChanged
+    | BetaCacheMissPreviousMessageNotFound
+    | BetaCacheMissUnavailable
+    | null;
+}
+
+/**
+ * Request-level diagnostics. Currently carries the previous response id for
+ * prompt-cache divergence reporting.
+ */
+export interface BetaDiagnosticsParam {
+  /**
+   * The `id` (`msg_...`) from this client's previous /v1/messages response. The
+   * server compares that request's prompt fingerprint against this one and returns
+   * `diagnostics.cache_miss_reason` when the prompt-cache prefix could not be
+   * reused. Pass `null` on the first turn to opt in without a prior message to
+   * compare.
+   */
+  previous_message_id?: string | null;
+}
+
 /**
  * Tool invocation directly from the model.
  */
@@ -1746,6 +1830,12 @@ export interface BetaMessage {
    */
   context_management: BetaContextManagementResponse | null;
 
+  /**
+   * Response envelope for request-level diagnostics. Present (possibly null)
+   * whenever the caller supplied `diagnostics` on the request.
+   */
+  diagnostics: BetaDiagnostics | null;
+
   /**
    * The model that will complete your prompt.\n\nSee
    * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
@@ -3947,6 +4037,12 @@ export interface MessageCreateParamsBase {
    */
   context_management?: BetaContextManagementConfig | null;
 
+  /**
+   * Body param: Request-level diagnostics. Currently carries the previous response
+   * id for prompt-cache divergence reporting.
+   */
+  diagnostics?: BetaDiagnosticsParam | null;
+
   /**
    * Body param: Specifies the geographic region for inference processing. If not
    * specified, the workspace's `default_inference_geo` is used.
@@ -4465,6 +4561,12 @@ export declare namespace Messages {
     type BetaBashCodeExecutionToolResultErrorParam as BetaBashCodeExecutionToolResultErrorParam,
     type BetaCacheControlEphemeral as BetaCacheControlEphemeral,
     type BetaCacheCreation as BetaCacheCreation,
+    type BetaCacheMissMessagesChanged as BetaCacheMissMessagesChanged,
+    type BetaCacheMissModelChanged as BetaCacheMissModelChanged,
+    type BetaCacheMissPreviousMessageNotFound as BetaCacheMissPreviousMessageNotFound,
+    type BetaCacheMissSystemChanged as BetaCacheMissSystemChanged,
+    type BetaCacheMissToolsChanged as BetaCacheMissToolsChanged,
+    type BetaCacheMissUnavailable as BetaCacheMissUnavailable,
     type BetaCitationCharLocation as BetaCitationCharLocation,
     type BetaCitationCharLocationParam as BetaCitationCharLocationParam,
     type BetaCitationConfig as BetaCitationConfig,
@@ -4512,6 +4614,8 @@ export declare namespace Messages {
     type BetaContextManagementConfig as BetaContextManagementConfig,
     type BetaContextManagementResponse as BetaContextManagementResponse,
     type BetaCountTokensContextManagementResponse as BetaCountTokensContextManagementResponse,
+    type BetaDiagnostics as BetaDiagnostics,
+    type BetaDiagnosticsParam as BetaDiagnosticsParam,
     type BetaDirectCaller as BetaDirectCaller,
     type BetaDocumentBlock as BetaDocumentBlock,
     type BetaEncryptedCodeExecutionResultBlock as BetaEncryptedCodeExecutionResultBlock,

package/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 {
   /**
@@ -109,6 +115,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>;
@@ -172,7 +201,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.
@@ -374,7 +408,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.
@@ -514,7 +553,8 @@ export type BetaManagedAgentsEventParams =
   | BetaManagedAgentsUserInterruptEventParams
   | BetaManagedAgentsUserToolConfirmationEventParams
   | BetaManagedAgentsUserCustomToolResultEventParams
-  | BetaManagedAgentsUserDefineOutcomeEventParams;
+  | BetaManagedAgentsUserDefineOutcomeEventParams
+  | BetaManagedAgentsUserToolResultEventParams;
 
 /**
  * Document referenced by file ID.
@@ -732,6 +772,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.
  */
@@ -745,6 +834,7 @@ export interface BetaManagedAgentsSendSessionEvents {
     | BetaManagedAgentsUserToolConfirmationEvent
     | BetaManagedAgentsUserCustomToolResultEvent
     | BetaManagedAgentsUserDefineOutcomeEvent
+    | SessionsAPI.BetaManagedAgentsUserToolResultEvent
   >;
 }
 
@@ -838,7 +928,9 @@ export type BetaManagedAgentsSessionEvent =
   | BetaManagedAgentsSessionThreadStatusRunningEvent
   | BetaManagedAgentsSessionThreadStatusIdleEvent
   | BetaManagedAgentsSessionThreadStatusTerminatedEvent
-  | BetaManagedAgentsSessionThreadStatusRescheduledEvent;
+  | SessionsAPI.BetaManagedAgentsUserToolResultEvent
+  | BetaManagedAgentsSessionThreadStatusRescheduledEvent
+  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent;
 
 /**
  * The agent is idle waiting on one or more blocking user-input events (tool
@@ -1321,7 +1413,9 @@ export type BetaManagedAgentsStreamSessionEvents =
   | BetaManagedAgentsSessionThreadStatusRunningEvent
   | BetaManagedAgentsSessionThreadStatusIdleEvent
   | BetaManagedAgentsSessionThreadStatusTerminatedEvent
-  | BetaManagedAgentsSessionThreadStatusRescheduledEvent;
+  | SessionsAPI.BetaManagedAgentsUserToolResultEvent
+  | BetaManagedAgentsSessionThreadStatusRescheduledEvent
+  | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent;
 
 /**
  * Regular text content.
@@ -1428,7 +1522,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.
@@ -1464,7 +1563,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.
@@ -1675,6 +1779,38 @@ 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: Return events created after this time (exclusive).
@@ -1734,7 +1870,13 @@ export interface EventStreamParams {
   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,
@@ -1765,6 +1907,9 @@ export declare namespace Events {
     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 BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,
@@ -1804,6 +1949,7 @@ export declare namespace Events {
     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,

package/src/resources/beta/sessions/index.ts

@@ -31,6 +31,9 @@ export {
   type BetaManagedAgentsRetryStatusExhausted,
   type BetaManagedAgentsRetryStatusRetrying,
   type BetaManagedAgentsRetryStatusTerminal,
+  type BetaManagedAgentsSearchResultBlock,
+  type BetaManagedAgentsSearchResultCitations,
+  type BetaManagedAgentsSearchResultContent,
   type BetaManagedAgentsSendSessionEvents,
   type BetaManagedAgentsSessionDeletedEvent,
   type BetaManagedAgentsSessionEndTurn,
@@ -70,6 +73,7 @@ export {
   type BetaManagedAgentsUserMessageEventParams,
   type BetaManagedAgentsUserToolConfirmationEvent,
   type BetaManagedAgentsUserToolConfirmationEventParams,
+  type BetaManagedAgentsUserToolResultEventParams,
   type EventListParams,
   type EventSendParams,
   type EventStreamParams,
@@ -107,9 +111,12 @@ export {
   type BetaManagedAgentsOutcomeEvaluationResource,
   type BetaManagedAgentsSession,
   type BetaManagedAgentsSessionAgent,
+  type BetaManagedAgentsSessionAgentUpdate,
   type BetaManagedAgentsSessionMultiagentCoordinator,
   type BetaManagedAgentsSessionStats,
+  type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsUserToolResultEvent,
   type SessionCreateParams,
   type SessionRetrieveParams,
   type SessionUpdateParams,
@@ -121,7 +128,6 @@ export {
 export {
   Threads,
   type BetaManagedAgentsSessionThread,
-  type BetaManagedAgentsSessionThreadAgent,
   type BetaManagedAgentsSessionThreadStats,
   type BetaManagedAgentsSessionThreadStatus,
   type BetaManagedAgentsSessionThreadUsage,

package/src/resources/beta/sessions/sessions.ts

@@ -34,6 +34,9 @@ import {
   BetaManagedAgentsRetryStatusExhausted,
   BetaManagedAgentsRetryStatusRetrying,
   BetaManagedAgentsRetryStatusTerminal,
+  BetaManagedAgentsSearchResultBlock,
+  BetaManagedAgentsSearchResultCitations,
+  BetaManagedAgentsSearchResultContent,
   BetaManagedAgentsSendSessionEvents,
   BetaManagedAgentsSessionDeletedEvent,
   BetaManagedAgentsSessionEndTurn,
@@ -74,6 +77,7 @@ import {
   BetaManagedAgentsUserMessageEventParams,
   BetaManagedAgentsUserToolConfirmationEvent,
   BetaManagedAgentsUserToolConfirmationEventParams,
+  BetaManagedAgentsUserToolResultEventParams,
   EventListParams,
   EventSendParams,
   EventStreamParams,
@@ -99,7 +103,6 @@ import {
 import * as ThreadsAPI from './threads/threads';
 import {
   BetaManagedAgentsSessionThread,
-  BetaManagedAgentsSessionThreadAgent,
   BetaManagedAgentsSessionThreadStats,
   BetaManagedAgentsSessionThreadStatus,
   BetaManagedAgentsSessionThreadUsage,
@@ -480,9 +483,9 @@ export interface BetaManagedAgentsOutcomeEvaluationResource {
   outcome_id: string;
 
   /**
-   * Current evaluation state. 'pending' before the agent begins work; 'running'
-   * while producing or revising; 'evaluating' while the grader scores;
-   * 'satisfied'/'max_iterations_reached'/'failed'/'interrupted' are terminal.
+   * Current evaluation state. `pending` before the agent begins work; `running`
+   * while producing or revising; `evaluating` while the grader scores;
+   * `satisfied`/`max_iterations_reached`/`failed`/`interrupted` are terminal.
    */
   result: string;
 
@@ -593,6 +596,29 @@ export interface BetaManagedAgentsSessionAgent {
   version: number;
 }
 
+/**
+ * Mid-session agent configuration update. Only `tools` and `mcp_servers` are
+ * updatable. Full replacement: the provided array becomes the new value. To
+ * preserve existing entries, GET the session, modify the array, and POST it back.
+ */
+export interface BetaManagedAgentsSessionAgentUpdate {
+  /**
+   * Replacement MCP server list. Full replacement: the provided array becomes the
+   * new value. Send an empty array to clear; omit to preserve.
+   */
+  mcp_servers?: Array<AgentsAPI.BetaManagedAgentsURLMCPServerParams>;
+
+  /**
+   * Replacement tool list. Full replacement: the provided array becomes the new
+   * value. Send an empty array to clear; omit to preserve.
+   */
+  tools?: Array<
+    | AgentsAPI.BetaManagedAgentsAgentToolset20260401Params
+    | AgentsAPI.BetaManagedAgentsMCPToolsetParams
+    | AgentsAPI.BetaManagedAgentsCustomToolParams
+  >;
+}
+
 /**
  * Resolved coordinator topology with full agent definitions for each roster
  * member.
@@ -601,7 +627,7 @@ export interface BetaManagedAgentsSessionMultiagentCoordinator {
   /**
    * Full `agent` definitions the coordinator may spawn as session threads.
    */
-  agents: Array<ThreadsAPI.BetaManagedAgentsSessionThreadAgent>;
+  agents: Array<AgentsAPI.BetaManagedAgentsSessionThreadAgent>;
 
   type: 'coordinator';
 }
@@ -623,6 +649,42 @@ export interface BetaManagedAgentsSessionStats {
   duration_seconds?: number;
 }
 
+/**
+ * Emitted when an UpdateSession request changed at least one field. Carries only
+ * the fields that changed; absent fields were not part of the update. The new
+ * configuration applies from the next turn.
+ */
+export interface BetaManagedAgentsSessionUpdatedEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at: string;
+
+  type: 'session.updated';
+
+  /**
+   * Resolved `agent` definition for a `session`. Snapshot of the `agent` at
+   * `session` creation time.
+   */
+  agent?: BetaManagedAgentsSessionAgent | null;
+
+  /**
+   * 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.
+   */
+  metadata?: { [key: string]: string };
+
+  /**
+   * The session's new title. Present only when the update changed it.
+   */
+  title?: string | null;
+}
+
 /**
  * Cumulative token usage for a session across all turns.
  */
@@ -648,6 +710,54 @@ export interface BetaManagedAgentsSessionUsage {
   output_tokens?: number;
 }
 
+/**
+ * Event sent by the client 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 BetaManagedAgentsUserToolResultEvent {
+  /**
+   * Unique identifier for this event.
+   */
+  id: string;
+
+  /**
+   * 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<
+    | EventsAPI.BetaManagedAgentsTextBlock
+    | EventsAPI.BetaManagedAgentsImageBlock
+    | EventsAPI.BetaManagedAgentsDocumentBlock
+    | EventsAPI.BetaManagedAgentsSearchResultBlock
+  >;
+
+  /**
+   * Whether the tool execution resulted in an error.
+   */
+  is_error?: boolean | null;
+
+  /**
+   * A timestamp in RFC 3339 format
+   */
+  processed_at?: string | null;
+
+  /**
+   * Routes this result to a subagent thread. Copy from the `agent.tool_use` event's
+   * `session_thread_id`.
+   */
+  session_thread_id?: string | null;
+}
+
 export interface SessionCreateParams {
   /**
    * Body param: Agent identifier. Accepts the `agent` ID string, which pins the
@@ -703,6 +813,14 @@ export interface SessionRetrieveParams {
 }
 
 export interface SessionUpdateParams {
+  /**
+   * Body param: Mid-session agent configuration update. Only `tools` and
+   * `mcp_servers` are updatable. Full replacement: the provided array becomes the
+   * new value. To preserve existing entries, GET the session, modify the array, and
+   * POST it back.
+   */
+  agent?: BetaManagedAgentsSessionAgentUpdate;
+
   /**
    * Body param: Metadata patch. Set a key to a string to upsert it, or to null to
    * delete it. Omit the field to preserve.
@@ -821,9 +939,12 @@ export declare namespace Sessions {
     type BetaManagedAgentsOutcomeEvaluationResource as BetaManagedAgentsOutcomeEvaluationResource,
     type BetaManagedAgentsSession as BetaManagedAgentsSession,
     type BetaManagedAgentsSessionAgent as BetaManagedAgentsSessionAgent,
+    type BetaManagedAgentsSessionAgentUpdate as BetaManagedAgentsSessionAgentUpdate,
     type BetaManagedAgentsSessionMultiagentCoordinator as BetaManagedAgentsSessionMultiagentCoordinator,
     type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
+    type BetaManagedAgentsSessionUpdatedEvent as BetaManagedAgentsSessionUpdatedEvent,
     type BetaManagedAgentsSessionUsage as BetaManagedAgentsSessionUsage,
+    type BetaManagedAgentsUserToolResultEvent as BetaManagedAgentsUserToolResultEvent,
     type BetaManagedAgentsSessionsPageCursor as BetaManagedAgentsSessionsPageCursor,
     type SessionCreateParams as SessionCreateParams,
     type SessionRetrieveParams as SessionRetrieveParams,
@@ -864,6 +985,9 @@ export declare namespace Sessions {
     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 BetaManagedAgentsSessionDeletedEvent as BetaManagedAgentsSessionDeletedEvent,
     type BetaManagedAgentsSessionEndTurn as BetaManagedAgentsSessionEndTurn,
@@ -903,6 +1027,7 @@ export declare namespace Sessions {
     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,
@@ -929,7 +1054,6 @@ export declare namespace Sessions {
   export {
     Threads as Threads,
     type BetaManagedAgentsSessionThread as BetaManagedAgentsSessionThread,
-    type BetaManagedAgentsSessionThreadAgent as BetaManagedAgentsSessionThreadAgent,
     type BetaManagedAgentsSessionThreadStats as BetaManagedAgentsSessionThreadStats,
     type BetaManagedAgentsSessionThreadStatus as BetaManagedAgentsSessionThreadStatus,
     type BetaManagedAgentsSessionThreadUsage as BetaManagedAgentsSessionThreadUsage,