@anthropic-ai/sdk 0.107.0 → 0.109.0

package/src/lib/sessions/accumulate.ts

@@ -0,0 +1,129 @@
+import { AnthropicError } from '../../core/error';
+import type {
+  BetaManagedAgentsAgentMessageEvent,
+  BetaManagedAgentsStreamSessionEvents,
+} from '../../resources/beta/sessions/events';
+
+export type AccumulatedEvent = BetaManagedAgentsAgentMessageEvent;
+
+/**
+ * Fold one preview event into an `agent.message` snapshot. Returns a fresh
+ * snapshot — the `msg` argument is never mutated.
+ *
+ * - `event_start` opens the preview: a new snapshot with empty content is
+ *   returned (so `msg` may be `undefined`). Returns `undefined` when the
+ *   previewed event is not an `agent.message` — this helper only tracks
+ *   `agent.message` previews.
+ * - `event_delta` is folded into `msg`: a new `delta.index` inserts the
+ *   fragment as a fresh content entry; an existing index returns a copy with
+ *   that entry appended to. An unrecognised fragment type on an existing
+ *   index passes the entry through unchanged — deltas are best-effort and the
+ *   buffered final event is canonical — but is a compile-time error via the
+ *   exhaustiveness guard, matching `MessageStream#accumulateMessage`.
+ * - `agent.message` is the buffered final event: a copy of it is returned,
+ *   replacing whatever the preview had accumulated.
+ */
+export function accumulateManagedAgentsEvent<T extends AccumulatedEvent>(
+  accumulated: AccumulatedEvent | undefined,
+  event: T,
+): T;
+export function accumulateManagedAgentsEvent(
+  accumulated: AccumulatedEvent | undefined,
+  event: BetaManagedAgentsStreamSessionEvents,
+): AccumulatedEvent | undefined;
+export function accumulateManagedAgentsEvent(
+  accumulated: AccumulatedEvent | undefined,
+  event: BetaManagedAgentsStreamSessionEvents,
+): AccumulatedEvent | undefined {
+  switch (event.type) {
+    case 'event_start': {
+      if (event.event.type === 'agent.message') {
+        return { id: event.event.id, type: 'agent.message', content: [], processed_at: '' };
+      }
+
+      return accumulated;
+    }
+
+    case 'agent.message': {
+      return { ...event, content: event.content.map((block) => ({ ...block })) };
+    }
+
+    case 'event_delta': {
+      if (accumulated === undefined) {
+        throw new AnthropicError(`event_delta for ${event.event_id} received before its event_start`);
+      }
+
+      const idx = event.delta.index ?? 0;
+      const fragment = event.delta.content;
+
+      // Indices arrive in order — the first delta at a new index opens the slot.
+      // A gap means deltas arrived out of order or were mis-routed.
+      if (idx > accumulated.content.length) {
+        throw new AnthropicError(
+          `event_delta index ${idx} is beyond the end of content (length ${accumulated.content.length})`,
+        );
+      }
+
+      const existing = accumulated.content[idx];
+      if (existing === undefined) {
+        // New index: pass the fragment through as a fresh block.
+        return { ...accumulated, content: [...accumulated.content, { ...fragment }] };
+      }
+
+      let updated = existing;
+      switch (fragment.type) {
+        case 'text':
+          if (existing.type === 'text') {
+            updated = { ...existing, text: existing.text + fragment.text };
+          }
+          break;
+        default:
+          checkNever(fragment.type);
+      }
+
+      const content = accumulated.content.slice();
+      content[idx] = updated;
+      return { ...accumulated, content };
+    }
+    case 'user.message':
+    case 'user.interrupt':
+    case 'user.tool_confirmation':
+    case 'user.tool_result':
+    case 'user.custom_tool_result':
+    case 'user.define_outcome':
+    case 'agent.thinking':
+    case 'agent.tool_use':
+    case 'agent.tool_result':
+    case 'agent.custom_tool_use':
+    case 'agent.mcp_tool_use':
+    case 'agent.mcp_tool_result':
+    case 'agent.thread_message_received':
+    case 'agent.thread_message_sent':
+    case 'agent.thread_context_compacted':
+    case 'session.error':
+    case 'session.updated':
+    case 'session.deleted':
+    case 'session.status_running':
+    case 'session.status_idle':
+    case 'session.status_rescheduled':
+    case 'session.status_terminated':
+    case 'session.thread_created':
+    case 'session.thread_status_running':
+    case 'session.thread_status_idle':
+    case 'session.thread_status_rescheduled':
+    case 'session.thread_status_terminated':
+    case 'span.model_request_start':
+    case 'span.model_request_end':
+    case 'span.outcome_evaluation_start':
+    case 'span.outcome_evaluation_ongoing':
+    case 'span.outcome_evaluation_end':
+    case 'system.message':
+      return accumulated;
+    default:
+      checkNever(event);
+      return accumulated;
+  }
+}
+
+// Compile-time exhaustiveness guard.
+function checkNever(_x: never): void {}

package/src/resources/beta/agents/agents.ts

@@ -670,6 +670,7 @@ export interface BetaManagedAgentsMCPToolsetParams {
  * details and options.
  */
 export type BetaManagedAgentsModel =
+  | 'claude-sonnet-5'
   | 'claude-fable-5'
   | 'claude-opus-4-8'
   | 'claude-opus-4-7'

package/src/resources/beta/beta.ts

@@ -117,8 +117,29 @@ import {
 } from './user-profiles';
 import * as WebhooksAPI from './webhooks';
 import {
+  BetaWebhookAgentArchivedEventData,
+  BetaWebhookAgentCreatedEventData,
+  BetaWebhookAgentDeletedEventData,
+  BetaWebhookAgentUpdatedEventData,
+  BetaWebhookDeploymentArchivedEventData,
+  BetaWebhookDeploymentCreatedEventData,
+  BetaWebhookDeploymentDeletedEventData,
+  BetaWebhookDeploymentPausedEventData,
+  BetaWebhookDeploymentRunFailedEventData,
+  BetaWebhookDeploymentRunStartedEventData,
+  BetaWebhookDeploymentRunSucceededEventData,
+  BetaWebhookDeploymentUnpausedEventData,
+  BetaWebhookDeploymentUpdatedEventData,
+  BetaWebhookEnvironmentArchivedEventData,
+  BetaWebhookEnvironmentCreatedEventData,
+  BetaWebhookEnvironmentDeletedEventData,
+  BetaWebhookEnvironmentDeletedEventType,
+  BetaWebhookEnvironmentUpdatedEventData,
   BetaWebhookEvent,
   BetaWebhookEventData,
+  BetaWebhookMemoryStoreArchivedEventData,
+  BetaWebhookMemoryStoreCreatedEventData,
+  BetaWebhookMemoryStoreDeletedEventData,
   BetaWebhookSessionArchivedEventData,
   BetaWebhookSessionCreatedEventData,
   BetaWebhookSessionDeletedEventData,
@@ -460,11 +481,17 @@ import {
 } from './messages/messages';
 import * as SessionsAPI from './sessions/sessions';
 import {
+  BetaManagedAgentsAgentMessagePreview,
   BetaManagedAgentsAgentParams,
+  BetaManagedAgentsAgentThinkingPreview,
+  BetaManagedAgentsAgentWithOverridesParams,
   BetaManagedAgentsBranchCheckout,
   BetaManagedAgentsCacheCreationUsage,
   BetaManagedAgentsCommitCheckout,
   BetaManagedAgentsDeletedSession,
+  BetaManagedAgentsDeltaContent,
+  BetaManagedAgentsDeltaEvent,
+  BetaManagedAgentsDeltaType,
   BetaManagedAgentsFileResourceParams,
   BetaManagedAgentsGitHubRepositoryResourceParams,
   BetaManagedAgentsMemoryStoreResourceParam,
@@ -479,7 +506,9 @@ import {
   BetaManagedAgentsSessionStats,
   BetaManagedAgentsSessionUpdatedEvent,
   BetaManagedAgentsSessionUsage,
-  BetaManagedAgentsSessionsPageCursor,
+  BetaManagedAgentsSessionsBidirectionalPageCursor,
+  BetaManagedAgentsStartEvent,
+  BetaManagedAgentsStartEventPreview,
   BetaManagedAgentsSystemContentBlock,
   BetaManagedAgentsSystemMessageEvent,
   BetaManagedAgentsUserToolResultEvent,
@@ -984,11 +1013,17 @@ export declare namespace Beta {
 
   export {
     Sessions as Sessions,
+    type BetaManagedAgentsAgentMessagePreview as BetaManagedAgentsAgentMessagePreview,
     type BetaManagedAgentsAgentParams as BetaManagedAgentsAgentParams,
+    type BetaManagedAgentsAgentThinkingPreview as BetaManagedAgentsAgentThinkingPreview,
+    type BetaManagedAgentsAgentWithOverridesParams as BetaManagedAgentsAgentWithOverridesParams,
     type BetaManagedAgentsBranchCheckout as BetaManagedAgentsBranchCheckout,
     type BetaManagedAgentsCacheCreationUsage as BetaManagedAgentsCacheCreationUsage,
     type BetaManagedAgentsCommitCheckout as BetaManagedAgentsCommitCheckout,
     type BetaManagedAgentsDeletedSession as BetaManagedAgentsDeletedSession,
+    type BetaManagedAgentsDeltaContent as BetaManagedAgentsDeltaContent,
+    type BetaManagedAgentsDeltaEvent as BetaManagedAgentsDeltaEvent,
+    type BetaManagedAgentsDeltaType as BetaManagedAgentsDeltaType,
     type BetaManagedAgentsFileResourceParams as BetaManagedAgentsFileResourceParams,
     type BetaManagedAgentsGitHubRepositoryResourceParams as BetaManagedAgentsGitHubRepositoryResourceParams,
     type BetaManagedAgentsMemoryStoreResourceParam as BetaManagedAgentsMemoryStoreResourceParam,
@@ -1003,10 +1038,12 @@ export declare namespace Beta {
     type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
     type BetaManagedAgentsSessionUpdatedEvent as BetaManagedAgentsSessionUpdatedEvent,
     type BetaManagedAgentsSessionUsage as BetaManagedAgentsSessionUsage,
+    type BetaManagedAgentsStartEvent as BetaManagedAgentsStartEvent,
+    type BetaManagedAgentsStartEventPreview as BetaManagedAgentsStartEventPreview,
     type BetaManagedAgentsSystemContentBlock as BetaManagedAgentsSystemContentBlock,
     type BetaManagedAgentsSystemMessageEvent as BetaManagedAgentsSystemMessageEvent,
     type BetaManagedAgentsUserToolResultEvent as BetaManagedAgentsUserToolResultEvent,
-    type BetaManagedAgentsSessionsPageCursor as BetaManagedAgentsSessionsPageCursor,
+    type BetaManagedAgentsSessionsBidirectionalPageCursor as BetaManagedAgentsSessionsBidirectionalPageCursor,
     type SessionCreateParams as SessionCreateParams,
     type SessionRetrieveParams as SessionRetrieveParams,
     type SessionUpdateParams as SessionUpdateParams,
@@ -1143,8 +1180,29 @@ export declare namespace Beta {
 
   export {
     Webhooks as Webhooks,
+    type BetaWebhookAgentArchivedEventData as BetaWebhookAgentArchivedEventData,
+    type BetaWebhookAgentCreatedEventData as BetaWebhookAgentCreatedEventData,
+    type BetaWebhookAgentDeletedEventData as BetaWebhookAgentDeletedEventData,
+    type BetaWebhookAgentUpdatedEventData as BetaWebhookAgentUpdatedEventData,
+    type BetaWebhookDeploymentArchivedEventData as BetaWebhookDeploymentArchivedEventData,
+    type BetaWebhookDeploymentCreatedEventData as BetaWebhookDeploymentCreatedEventData,
+    type BetaWebhookDeploymentDeletedEventData as BetaWebhookDeploymentDeletedEventData,
+    type BetaWebhookDeploymentPausedEventData as BetaWebhookDeploymentPausedEventData,
+    type BetaWebhookDeploymentRunFailedEventData as BetaWebhookDeploymentRunFailedEventData,
+    type BetaWebhookDeploymentRunStartedEventData as BetaWebhookDeploymentRunStartedEventData,
+    type BetaWebhookDeploymentRunSucceededEventData as BetaWebhookDeploymentRunSucceededEventData,
+    type BetaWebhookDeploymentUnpausedEventData as BetaWebhookDeploymentUnpausedEventData,
+    type BetaWebhookDeploymentUpdatedEventData as BetaWebhookDeploymentUpdatedEventData,
+    type BetaWebhookEnvironmentArchivedEventData as BetaWebhookEnvironmentArchivedEventData,
+    type BetaWebhookEnvironmentCreatedEventData as BetaWebhookEnvironmentCreatedEventData,
+    type BetaWebhookEnvironmentDeletedEventData as BetaWebhookEnvironmentDeletedEventData,
+    type BetaWebhookEnvironmentDeletedEventType as BetaWebhookEnvironmentDeletedEventType,
+    type BetaWebhookEnvironmentUpdatedEventData as BetaWebhookEnvironmentUpdatedEventData,
     type BetaWebhookEvent as BetaWebhookEvent,
     type BetaWebhookEventData as BetaWebhookEventData,
+    type BetaWebhookMemoryStoreArchivedEventData as BetaWebhookMemoryStoreArchivedEventData,
+    type BetaWebhookMemoryStoreCreatedEventData as BetaWebhookMemoryStoreCreatedEventData,
+    type BetaWebhookMemoryStoreDeletedEventData as BetaWebhookMemoryStoreDeletedEventData,
     type BetaWebhookSessionArchivedEventData as BetaWebhookSessionArchivedEventData,
     type BetaWebhookSessionCreatedEventData as BetaWebhookSessionCreatedEventData,
     type BetaWebhookSessionDeletedEventData as BetaWebhookSessionDeletedEventData,

package/src/resources/beta/environments/work.ts

@@ -372,7 +372,8 @@ export interface BetaSelfHostedWork {
   metadata: { [key: string]: string };
 
   /**
-   * Session instance JWT secret (only included in certain retrieval paths)
+   * Credential payload used by the environment worker to execute this work item. May
+   * be populated when polling for work; null on all other retrieval paths.
    */
   secret: string | null;
 

package/src/resources/beta/index.ts

@@ -433,11 +433,17 @@ export {
 } from './models';
 export {
   Sessions,
+  type BetaManagedAgentsAgentMessagePreview,
   type BetaManagedAgentsAgentParams,
+  type BetaManagedAgentsAgentThinkingPreview,
+  type BetaManagedAgentsAgentWithOverridesParams,
   type BetaManagedAgentsBranchCheckout,
   type BetaManagedAgentsCacheCreationUsage,
   type BetaManagedAgentsCommitCheckout,
   type BetaManagedAgentsDeletedSession,
+  type BetaManagedAgentsDeltaContent,
+  type BetaManagedAgentsDeltaEvent,
+  type BetaManagedAgentsDeltaType,
   type BetaManagedAgentsFileResourceParams,
   type BetaManagedAgentsGitHubRepositoryResourceParams,
   type BetaManagedAgentsMemoryStoreResourceParam,
@@ -452,6 +458,8 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsStartEvent,
+  type BetaManagedAgentsStartEventPreview,
   type BetaManagedAgentsSystemContentBlock,
   type BetaManagedAgentsSystemMessageEvent,
   type BetaManagedAgentsUserToolResultEvent,
@@ -461,7 +469,7 @@ export {
   type SessionListParams,
   type SessionDeleteParams,
   type SessionArchiveParams,
-  type BetaManagedAgentsSessionsPageCursor,
+  type BetaManagedAgentsSessionsBidirectionalPageCursor,
 } from './sessions/index';
 export {
   Skills,
@@ -501,8 +509,29 @@ export {
 } from './vaults/index';
 export {
   Webhooks,
+  type BetaWebhookAgentArchivedEventData,
+  type BetaWebhookAgentCreatedEventData,
+  type BetaWebhookAgentDeletedEventData,
+  type BetaWebhookAgentUpdatedEventData,
+  type BetaWebhookDeploymentArchivedEventData,
+  type BetaWebhookDeploymentCreatedEventData,
+  type BetaWebhookDeploymentDeletedEventData,
+  type BetaWebhookDeploymentPausedEventData,
+  type BetaWebhookDeploymentRunFailedEventData,
+  type BetaWebhookDeploymentRunStartedEventData,
+  type BetaWebhookDeploymentRunSucceededEventData,
+  type BetaWebhookDeploymentUnpausedEventData,
+  type BetaWebhookDeploymentUpdatedEventData,
+  type BetaWebhookEnvironmentArchivedEventData,
+  type BetaWebhookEnvironmentCreatedEventData,
+  type BetaWebhookEnvironmentDeletedEventData,
+  type BetaWebhookEnvironmentDeletedEventType,
+  type BetaWebhookEnvironmentUpdatedEventData,
   type BetaWebhookEvent,
   type BetaWebhookEventData,
+  type BetaWebhookMemoryStoreArchivedEventData,
+  type BetaWebhookMemoryStoreCreatedEventData,
+  type BetaWebhookMemoryStoreDeletedEventData,
   type BetaWebhookSessionArchivedEventData,
   type BetaWebhookSessionCreatedEventData,
   type BetaWebhookSessionDeletedEventData,

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

@@ -105,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() },
@@ -1451,6 +1452,8 @@ export type BetaManagedAgentsStreamSessionEvents =
   | SessionsAPI.BetaManagedAgentsUserToolResultEvent
   | BetaManagedAgentsSessionThreadStatusRescheduledEvent
   | SessionsAPI.BetaManagedAgentsSessionUpdatedEvent
+  | SessionsAPI.BetaManagedAgentsStartEvent
+  | SessionsAPI.BetaManagedAgentsDeltaEvent
   | SessionsAPI.BetaManagedAgentsSystemMessageEvent;
 
 /**
@@ -1918,7 +1921,21 @@ 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>;
 }

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

@@ -99,11 +99,17 @@ export {
 } from './resources';
 export {
   Sessions,
+  type BetaManagedAgentsAgentMessagePreview,
   type BetaManagedAgentsAgentParams,
+  type BetaManagedAgentsAgentThinkingPreview,
+  type BetaManagedAgentsAgentWithOverridesParams,
   type BetaManagedAgentsBranchCheckout,
   type BetaManagedAgentsCacheCreationUsage,
   type BetaManagedAgentsCommitCheckout,
   type BetaManagedAgentsDeletedSession,
+  type BetaManagedAgentsDeltaContent,
+  type BetaManagedAgentsDeltaEvent,
+  type BetaManagedAgentsDeltaType,
   type BetaManagedAgentsFileResourceParams,
   type BetaManagedAgentsGitHubRepositoryResourceParams,
   type BetaManagedAgentsMemoryStoreResourceParam,
@@ -118,6 +124,8 @@ export {
   type BetaManagedAgentsSessionStats,
   type BetaManagedAgentsSessionUpdatedEvent,
   type BetaManagedAgentsSessionUsage,
+  type BetaManagedAgentsStartEvent,
+  type BetaManagedAgentsStartEventPreview,
   type BetaManagedAgentsSystemContentBlock,
   type BetaManagedAgentsSystemMessageEvent,
   type BetaManagedAgentsUserToolResultEvent,
@@ -127,7 +135,7 @@ export {
   type SessionListParams,
   type SessionDeleteParams,
   type SessionArchiveParams,
-  type BetaManagedAgentsSessionsPageCursor,
+  type BetaManagedAgentsSessionsBidirectionalPageCursor,
 } from './sessions';
 export {
   Threads,

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

@@ -116,7 +116,11 @@ import {
   Threads,
 } from './threads/threads';
 import { APIPromise } from '../../../core/api-promise';
-import { PageCursor, type PageCursorParams, PagePromise } from '../../../core/pagination';
+import {
+  BidirectionalPageCursor,
+  type BidirectionalPageCursorParams,
+  PagePromise,
+} from '../../../core/pagination';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
@@ -217,16 +221,20 @@ export class Sessions extends APIResource {
   list(
     params: SessionListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<BetaManagedAgentsSessionsPageCursor, BetaManagedAgentsSession> {
+  ): PagePromise<BetaManagedAgentsSessionsBidirectionalPageCursor, BetaManagedAgentsSession> {
     const { betas, ...query } = params ?? {};
-    return this._client.getAPIList('/v1/sessions?beta=true', PageCursor<BetaManagedAgentsSession>, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
-        options?.headers,
-      ]),
-    });
+    return this._client.getAPIList(
+      '/v1/sessions?beta=true',
+      BidirectionalPageCursor<BetaManagedAgentsSession>,
+      {
+        query,
+        ...options,
+        headers: buildHeaders([
+          { 'anthropic-beta': [...(betas ?? []), 'managed-agents-2026-04-01'].toString() },
+          options?.headers,
+        ]),
+      },
+    );
   }
 
   /**
@@ -282,7 +290,18 @@ export class Sessions extends APIResource {
   }
 }
 
-export type BetaManagedAgentsSessionsPageCursor = PageCursor<BetaManagedAgentsSession>;
+export type BetaManagedAgentsSessionsBidirectionalPageCursor =
+  BidirectionalPageCursor<BetaManagedAgentsSession>;
+
+export interface BetaManagedAgentsAgentMessagePreview {
+  /**
+   * The id the buffered agent.message will carry if it is emitted. Matches the
+   * event_id on this preview's event_delta events.
+   */
+  id: string;
+
+  type: 'agent.message';
+}
 
 /**
  * Specification for an Agent. Provide a specific `version` or use the short-form
@@ -303,6 +322,69 @@ export interface BetaManagedAgentsAgentParams {
   version?: number;
 }
 
+export interface BetaManagedAgentsAgentThinkingPreview {
+  /**
+   * The id the buffered agent.thinking will carry if it is emitted. Start-only — no
+   * event_delta events follow.
+   */
+  id: string;
+
+  type: 'agent.thinking';
+}
+
+/**
+ * Reference to an `agent` plus optional configuration overrides. Each provided
+ * field replaces the agent's value for the caller's use; the agent resource is
+ * unchanged.
+ */
+export interface BetaManagedAgentsAgentWithOverridesParams {
+  /**
+   * The `agent` ID.
+   */
+  id: string;
+
+  type: 'agent_with_overrides';
+
+  /**
+   * Replacement MCP server list. Full replacement: the provided array becomes the
+   * MCP servers. Send an empty array to clear; omit to preserve the agent's servers.
+   */
+  mcp_servers?: Array<AgentsAPI.BetaManagedAgentsURLMCPServerParams>;
+
+  /**
+   * Replacement model. Accepts the model string, e.g. `claude-opus-4-6`, or a
+   * `model_config` object. Omit to use the agent's model.
+   */
+  model?: AgentsAPI.BetaManagedAgentsModel | AgentsAPI.BetaManagedAgentsModelConfigParams;
+
+  /**
+   * Replacement skill list. Full replacement: the provided array becomes the skills.
+   * Send an empty array to clear; omit to preserve the agent's skills.
+   */
+  skills?: Array<AgentsAPI.BetaManagedAgentsSkillParams>;
+
+  /**
+   * Replacement system prompt. Up to 100,000 characters. Set to null to clear the
+   * agent's system prompt; omit to preserve it.
+   */
+  system?: string | null;
+
+  /**
+   * Replacement tool list. Full replacement: the provided array becomes the tool
+   * configuration. Send an empty array to clear; omit to preserve the agent's tools.
+   */
+  tools?: Array<
+    | AgentsAPI.BetaManagedAgentsAgentToolset20260401Params
+    | AgentsAPI.BetaManagedAgentsMCPToolsetParams
+    | AgentsAPI.BetaManagedAgentsCustomToolParams
+  >;
+
+  /**
+   * The specific `agent` version to use. Omit to use the latest version.
+   */
+  version?: number;
+}
+
 export interface BetaManagedAgentsBranchCheckout {
   /**
    * Branch name to check out.
@@ -345,6 +427,52 @@ export interface BetaManagedAgentsDeletedSession {
   type: 'session_deleted';
 }
 
+export interface BetaManagedAgentsDeltaContent {
+  /**
+   * Regular text content.
+   */
+  content: EventsAPI.BetaManagedAgentsTextBlock;
+
+  type: 'content_delta';
+
+  /**
+   * Which entry in the previewed event's content array this fragment lands in.
+   * Insert content as that entry when the index is new; append to the existing entry
+   * otherwise.
+   */
+  index?: number;
+}
+
+/**
+ * An incremental update to an event that is still being streamed. Deltas are
+ * best-effort and may stop early; when the buffered event with id == event_id is
+ * produced it carries the complete content. A model request that ends early (an
+ * error or interrupt) produces no buffered event — its terminal
+ * span.model_request_end closes the preview. Only sent on stream connections that
+ * opt in via event_deltas; never appears in event history.
+ */
+export interface BetaManagedAgentsDeltaEvent {
+  /**
+   * One fragment of the previewed event. The delta type is named for the previewed
+   * event's field it streams into: agent.message events stream content_delta
+   * fragments, each a partial element of the content array.
+   */
+  delta: BetaManagedAgentsDeltaContent;
+
+  /**
+   * The id of the event being previewed. Matches event.id on the corresponding
+   * event_start and the buffered event that reconciles the preview.
+   */
+  event_id: string;
+
+  type: 'event_delta';
+}
+
+/**
+ * EventDeltaType enum
+ */
+export type BetaManagedAgentsDeltaType = 'agent.message' | 'agent.thinking';
+
 /**
  * Mount a file uploaded via the Files API into the session.
  */
@@ -718,6 +846,30 @@ export interface BetaManagedAgentsSessionUsage {
   output_tokens?: number;
 }
 
+/**
+ * Opens a preview of a buffered event. Carries the previewed event's type and id
+ * only. Followed by zero or more event_delta events with the same event id,
+ * normally concluded by the buffered event carrying that id. If the producing
+ * model request ends without that event (an error or interrupt mid-stream), its
+ * terminal span.model_request_end closes the preview. Only sent on stream
+ * connections that opt in via event_deltas; never appears in event history.
+ */
+export interface BetaManagedAgentsStartEvent {
+  /**
+   * The previewed event's type and id. The event type determines which delta types
+   * the preview's event_delta events carry: agent.message events stream
+   * content_delta fragments; agent.thinking previews are start-only — no deltas
+   * follow, and the buffered agent.thinking with the same id concludes them.
+   */
+  event: BetaManagedAgentsStartEventPreview;
+
+  type: 'event_start';
+}
+
+export type BetaManagedAgentsStartEventPreview =
+  | BetaManagedAgentsAgentMessagePreview
+  | BetaManagedAgentsAgentThinkingPreview;
+
 /**
  * Regular text content.
  */
@@ -807,7 +959,7 @@ export interface SessionCreateParams {
    * latest version for the session, or an `agent` object with both id and version
    * specified.
    */
-  agent: string | BetaManagedAgentsAgentParams;
+  agent: string | BetaManagedAgentsAgentParams | BetaManagedAgentsAgentWithOverridesParams;
 
   /**
    * Body param: ID of the `environment` defining the container configuration for
@@ -887,7 +1039,7 @@ export interface SessionUpdateParams {
   betas?: Array<BetaAPI.AnthropicBeta>;
 }
 
-export interface SessionListParams extends PageCursorParams {
+export interface SessionListParams extends BidirectionalPageCursorParams {
   /**
    * Query param: Filter sessions created with this agent ID.
    */
@@ -973,11 +1125,17 @@ Sessions.Threads = Threads;
 
 export declare namespace Sessions {
   export {
+    type BetaManagedAgentsAgentMessagePreview as BetaManagedAgentsAgentMessagePreview,
     type BetaManagedAgentsAgentParams as BetaManagedAgentsAgentParams,
+    type BetaManagedAgentsAgentThinkingPreview as BetaManagedAgentsAgentThinkingPreview,
+    type BetaManagedAgentsAgentWithOverridesParams as BetaManagedAgentsAgentWithOverridesParams,
     type BetaManagedAgentsBranchCheckout as BetaManagedAgentsBranchCheckout,
     type BetaManagedAgentsCacheCreationUsage as BetaManagedAgentsCacheCreationUsage,
     type BetaManagedAgentsCommitCheckout as BetaManagedAgentsCommitCheckout,
     type BetaManagedAgentsDeletedSession as BetaManagedAgentsDeletedSession,
+    type BetaManagedAgentsDeltaContent as BetaManagedAgentsDeltaContent,
+    type BetaManagedAgentsDeltaEvent as BetaManagedAgentsDeltaEvent,
+    type BetaManagedAgentsDeltaType as BetaManagedAgentsDeltaType,
     type BetaManagedAgentsFileResourceParams as BetaManagedAgentsFileResourceParams,
     type BetaManagedAgentsGitHubRepositoryResourceParams as BetaManagedAgentsGitHubRepositoryResourceParams,
     type BetaManagedAgentsMemoryStoreResourceParam as BetaManagedAgentsMemoryStoreResourceParam,
@@ -992,10 +1150,12 @@ export declare namespace Sessions {
     type BetaManagedAgentsSessionStats as BetaManagedAgentsSessionStats,
     type BetaManagedAgentsSessionUpdatedEvent as BetaManagedAgentsSessionUpdatedEvent,
     type BetaManagedAgentsSessionUsage as BetaManagedAgentsSessionUsage,
+    type BetaManagedAgentsStartEvent as BetaManagedAgentsStartEvent,
+    type BetaManagedAgentsStartEventPreview as BetaManagedAgentsStartEventPreview,
     type BetaManagedAgentsSystemContentBlock as BetaManagedAgentsSystemContentBlock,
     type BetaManagedAgentsSystemMessageEvent as BetaManagedAgentsSystemMessageEvent,
     type BetaManagedAgentsUserToolResultEvent as BetaManagedAgentsUserToolResultEvent,
-    type BetaManagedAgentsSessionsPageCursor as BetaManagedAgentsSessionsPageCursor,
+    type BetaManagedAgentsSessionsBidirectionalPageCursor as BetaManagedAgentsSessionsBidirectionalPageCursor,
     type SessionCreateParams as SessionCreateParams,
     type SessionRetrieveParams as SessionRetrieveParams,
     type SessionUpdateParams as SessionUpdateParams,