@github/copilot-sdk 1.0.0-beta.1 → 1.0.0-beta.11

package/dist/generated/session-events.d.ts

@@ -2,47 +2,168 @@
  * AUTO-GENERATED FILE - DO NOT EDIT
  * Generated from: session-events.schema.json
  */
-export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PlanChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent;
+/**
+ * Union of all session event variants emitted by the Copilot CLI runtime.
+ */
+export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PermissionsChangedEvent | PlanChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | HookProgressEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | CustomNotificationEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent | CanvasOpenedEvent | CanvasRegistryChangedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
 /**
  * Hosting platform type of the repository (github or ado)
  */
-export type WorkingDirectoryContextHostType = "github" | "ado";
+export type WorkingDirectoryContextHostType = 
+/** Repository is hosted on GitHub. */
+"github"
+/** Repository is hosted on Azure DevOps. */
+ | "ado";
+/**
+ * Allowed values for the `ContextTier` enumeration.
+ */
+export type ContextTier = 
+/** Default context tier with standard context window size. */
+"default"
+/** Extended context tier with a larger context window. */
+ | "long_context";
+/**
+ * Reasoning summary mode used for model calls, if applicable (e.g. "none", "concise", "detailed")
+ */
+export type ReasoningSummary = 
+/** Do not request reasoning summaries from the model. */
+"none"
+/** Request a concise summary of the model's reasoning. */
+ | "concise"
+/** Request a detailed summary of the model's reasoning. */
+ | "detailed";
+/**
+ * The type of operation performed on the autopilot objective state file
+ */
+export type AutopilotObjectiveChangedOperation = 
+/** Autopilot objective state file was created for a new objective. */
+"create"
+/** Autopilot objective state file was updated for an existing objective. */
+ | "update"
+/** Autopilot objective state file was deleted or cleared. */
+ | "delete";
+/**
+ * Current autopilot objective status, if one exists
+ */
+export type AutopilotObjectiveChangedStatus = 
+/** Objective is active and can drive autopilot continuations. */
+"active"
+/** Objective is paused and will not drive autopilot continuations. */
+ | "paused"
+/** Legacy objective state indicating the previous continuation cap was reached. */
+ | "cap_reached"
+/** Objective was completed by the agent. */
+ | "completed";
+/**
+ * The session mode the agent is operating in
+ */
+export type SessionMode = 
+/** The agent is responding interactively to the user. */
+"interactive"
+/** The agent is preparing a plan before making changes. */
+ | "plan"
+/** The agent is working autonomously toward task completion. */
+ | "autopilot";
 /**
  * The type of operation performed on the plan file
  */
-export type PlanChangedOperation = "create" | "update" | "delete";
+export type PlanChangedOperation = 
+/** The plan file was created. */
+"create"
+/** The plan file was updated. */
+ | "update"
+/** The plan file was deleted. */
+ | "delete";
 /**
  * Whether the file was newly created or updated
  */
-export type WorkspaceFileChangedOperation = "create" | "update";
+export type WorkspaceFileChangedOperation = 
+/** The workspace file was created. */
+"create"
+/** The workspace file was updated. */
+ | "update";
 /**
  * Origin type of the session being handed off
  */
-export type HandoffSourceType = "remote" | "local";
+export type HandoffSourceType = 
+/** The handoff originated from a remote session. */
+"remote"
+/** The handoff originated from a local session. */
+ | "local";
 /**
  * Whether the session ended normally ("routine") or due to a crash/fatal error ("error")
  */
-export type ShutdownType = "routine" | "error";
+export type ShutdownType = 
+/** The session ended normally. */
+"routine"
+/** The session ended because of a crash or fatal error. */
+ | "error";
 /**
  * The agent mode that was active when this message was sent
  */
-export type UserMessageAgentMode = "interactive" | "plan" | "autopilot" | "shell";
+export type UserMessageAgentMode = 
+/** The agent is responding interactively to the user. */
+"interactive"
+/** The agent is preparing a plan before making changes. */
+ | "plan"
+/** The agent is working autonomously toward task completion. */
+ | "autopilot"
+/** The agent is in shell-focused UI mode. */
+ | "shell";
 /**
- * A user message attachment — a file, directory, code selection, blob, or GitHub reference
+ * A user message attachment — a file, directory, code selection, blob, GitHub reference, or extension-supplied context payload
  */
-export type UserMessageAttachment = UserMessageAttachmentFile | UserMessageAttachmentDirectory | UserMessageAttachmentSelection | UserMessageAttachmentGithubReference | UserMessageAttachmentBlob;
+export type Attachment = AttachmentFile | AttachmentDirectory | AttachmentSelection | AttachmentGitHubReference | AttachmentBlob | AttachmentExtensionContext;
 /**
  * Type of GitHub reference
  */
-export type UserMessageAttachmentGithubReferenceType = "issue" | "pr" | "discussion";
+export type AttachmentGitHubReferenceType = 
+/** GitHub issue reference. */
+"issue"
+/** GitHub pull request reference. */
+ | "pr"
+/** GitHub discussion reference. */
+ | "discussion";
 /**
  * Tool call type: "function" for standard tool calls, "custom" for grammar-based tool calls. Defaults to "function" when absent.
  */
-export type AssistantMessageToolRequestType = "function" | "custom";
+export type AssistantMessageToolRequestType = 
+/** Standard function-style tool call. */
+"function"
+/** Custom grammar-based tool call. */
+ | "custom";
+/**
+ * API endpoint used for this model call, matching CAPI supported_endpoints vocabulary
+ */
+export type AssistantUsageApiEndpoint = 
+/** Chat Completions API endpoint. */
+"/chat/completions"
+/** Anthropic Messages API endpoint. */
+ | "/v1/messages"
+/** Responses API endpoint. */
+ | "/responses"
+/** WebSocket Responses API endpoint. */
+ | "ws:/responses";
 /**
  * Where the failed model call originated
  */
-export type ModelCallFailureSource = "top_level" | "subagent" | "mcp_sampling";
+export type ModelCallFailureSource = 
+/** Model call from the top-level agent. */
+"top_level"
+/** Model call from a sub-agent. */
+ | "subagent"
+/** Model call from MCP sampling. */
+ | "mcp_sampling";
+/**
+ * Finite reason code describing why the current turn was aborted
+ */
+export type AbortReason = 
+/** The local user requested the abort, for example by pressing Ctrl+C in the CLI. */
+"user_initiated"
+/** A remote command requested the abort. */
+ | "remote_command"
+/** An MCP server delivered a user.abort notification. */
+ | "user_abort";
 /**
  * A content block within a tool result, which may be text, terminal output, image, audio, or a resource
  */
@@ -50,15 +171,41 @@ export type ToolExecutionCompleteContent = ToolExecutionCompleteContentText | To
 /**
  * Theme variant this icon is intended for
  */
-export type ToolExecutionCompleteContentResourceLinkIconTheme = "light" | "dark";
+export type ToolExecutionCompleteContentResourceLinkIconTheme = 
+/** Icon intended for light themes. */
+"light"
+/** Icon intended for dark themes. */
+ | "dark";
 /**
  * The embedded resource contents, either text or base64-encoded binary
  */
 export type ToolExecutionCompleteContentResourceDetails = EmbeddedTextResourceContents | EmbeddedBlobResourceContents;
+/**
+ * Allowed values for the `ToolExecutionCompleteToolDescriptionMetaUIVisibility` enumeration.
+ */
+export type ToolExecutionCompleteToolDescriptionMetaUIVisibility = 
+/** Tool is callable by the model (LLM tool surface) */
+"model"
+/** Tool is callable by the MCP App view (iframe) via session.mcp.apps.callTool */
+ | "app";
+/**
+ * What triggered the skill invocation: `user-invoked` (explicit user action, such as via a slash command or UI affordance), `agent-invoked` (agent requested the skill), or `context-load` (loaded as part of another context, such as preloading skills configured on a custom agent or subagent)
+ */
+export type SkillInvokedTrigger = 
+/** Skill invocation requested explicitly by the user, such as via a slash command or UI affordance. */
+"user-invoked"
+/** Skill invocation requested by the agent. */
+ | "agent-invoked"
+/** Skill content loaded as part of another context, such as a configured custom agent or subagent. */
+ | "context-load";
 /**
  * Message role: "system" for system prompts, "developer" for developer-injected instructions
  */
-export type SystemMessageRole = "system" | "developer";
+export type SystemMessageRole = 
+/** System prompt message. */
+"system"
+/** Developer instruction message. */
+ | "developer";
 /**
  * Structured metadata identifying what triggered this notification
  */
@@ -66,35 +213,45 @@ export type SystemNotification = SystemNotificationAgentCompleted | SystemNotifi
 /**
  * Whether the agent completed successfully or failed
  */
-export type SystemNotificationAgentCompletedStatus = "completed" | "failed";
+export type SystemNotificationAgentCompletedStatus = 
+/** The agent completed successfully. */
+"completed"
+/** The agent failed. */
+ | "failed";
 /**
  * Details of the permission being requested
  */
-export type PermissionRequest = PermissionRequestShell | PermissionRequestWrite | PermissionRequestRead | PermissionRequestMcp | PermissionRequestUrl | PermissionRequestMemory | PermissionRequestCustomTool | PermissionRequestHook;
+export type PermissionRequest = PermissionRequestShell | PermissionRequestWrite | PermissionRequestRead | PermissionRequestMcp | PermissionRequestUrl | PermissionRequestMemory | PermissionRequestCustomTool | PermissionRequestHook | PermissionRequestExtensionManagement | PermissionRequestExtensionPermissionAccess;
 /**
  * Whether this is a store or vote memory operation
  */
-export type PermissionRequestMemoryAction = "store" | "vote";
+export type PermissionRequestMemoryAction = 
+/** Store a new memory. */
+"store"
+/** Vote on an existing memory. */
+ | "vote";
 /**
  * Vote direction (vote only)
  */
-export type PermissionRequestMemoryDirection = "upvote" | "downvote";
+export type PermissionRequestMemoryDirection = 
+/** Vote that the memory is useful or accurate. */
+"upvote"
+/** Vote that the memory is incorrect or outdated. */
+ | "downvote";
 /**
  * Derived user-facing permission prompt details for UI consumers
  */
-export type PermissionPromptRequest = PermissionPromptRequestCommands | PermissionPromptRequestWrite | PermissionPromptRequestRead | PermissionPromptRequestMcp | PermissionPromptRequestUrl | PermissionPromptRequestMemory | PermissionPromptRequestCustomTool | PermissionPromptRequestPath | PermissionPromptRequestHook;
-/**
- * Whether this is a store or vote memory operation
- */
-export type PermissionPromptRequestMemoryAction = "store" | "vote";
-/**
- * Vote direction (vote only)
- */
-export type PermissionPromptRequestMemoryDirection = "upvote" | "downvote";
+export type PermissionPromptRequest = PermissionPromptRequestCommands | PermissionPromptRequestWrite | PermissionPromptRequestRead | PermissionPromptRequestMcp | PermissionPromptRequestUrl | PermissionPromptRequestMemory | PermissionPromptRequestCustomTool | PermissionPromptRequestPath | PermissionPromptRequestHook | PermissionPromptRequestExtensionManagement | PermissionPromptRequestExtensionPermissionAccess;
 /**
  * Underlying permission kind that needs path approval
  */
-export type PermissionPromptRequestPathAccessKind = "read" | "shell" | "write";
+export type PermissionPromptRequestPathAccessKind = 
+/** Read access to a filesystem path. */
+"read"
+/** Shell command access involving a filesystem path. */
+ | "shell"
+/** Write access to a filesystem path. */
+ | "write";
 /**
  * The result of the permission request
  */
@@ -102,32 +259,146 @@ export type PermissionResult = PermissionApproved | PermissionApprovedForSession
 /**
  * The approval to add as a session-scoped rule
  */
-export type UserToolSessionApproval = UserToolSessionApprovalCommands | UserToolSessionApprovalRead | UserToolSessionApprovalWrite | UserToolSessionApprovalMcp | UserToolSessionApprovalMemory | UserToolSessionApprovalCustomTool;
+export type UserToolSessionApproval = UserToolSessionApprovalCommands | UserToolSessionApprovalRead | UserToolSessionApprovalWrite | UserToolSessionApprovalMcp | UserToolSessionApprovalMemory | UserToolSessionApprovalCustomTool | UserToolSessionApprovalExtensionManagement | UserToolSessionApprovalExtensionPermissionAccess;
 /**
  * Elicitation mode; "form" for structured input, "url" for browser-based. Defaults to "form" when absent.
  */
-export type ElicitationRequestedMode = "form" | "url";
+export type ElicitationRequestedMode = 
+/** Structured form-based elicitation. */
+"form"
+/** Browser URL-based elicitation. */
+ | "url";
 /**
  * The user action: "accept" (submitted form), "decline" (explicitly refused), or "cancel" (dismissed)
  */
-export type ElicitationCompletedAction = "accept" | "decline" | "cancel";
-export type ElicitationCompletedContent = string | number | boolean | string[];
+export type ElicitationCompletedAction = 
+/** The user submitted the requested form. */
+"accept"
+/** The user explicitly declined the request. */
+ | "decline"
+/** The user dismissed the request. */
+ | "cancel";
+/**
+ * Schema for the `ElicitationCompletedContent` type.
+ */
+export type ElicitationCompletedContent = (string | number | boolean | string[]) | undefined;
+/**
+ * Source-defined JSON payload for the custom notification
+ */
+export type CustomNotificationPayload = string | number | boolean | null | unknown[] | {
+    [k: string]: unknown | undefined;
+};
+/**
+ * The user's auto-mode-switch choice
+ */
+export type AutoModeSwitchResponse = 
+/** Switch models for this request. */
+"yes"
+/** Switch models now and keep using the replacement automatically. */
+ | "yes_always"
+/** Do not switch models. */
+ | "no";
+/**
+ * Exit plan mode action
+ */
+export type ExitPlanModeAction = 
+/** Exit plan mode without starting implementation. */
+"exit_only"
+/** Exit plan mode and continue in interactive mode. */
+ | "interactive"
+/** Exit plan mode and continue autonomously. */
+ | "autopilot"
+/** Exit plan mode and continue with parallel autonomous workers. */
+ | "autopilot_fleet";
+/**
+ * Source location type (e.g., project, personal-copilot, plugin, builtin)
+ */
+export type SkillSource = 
+/** Skill defined in the current project's skill directories. */
+"project"
+/** Skill discovered from a parent directory in the current workspace tree. */
+ | "inherited"
+/** Skill defined in the user's Copilot skill directory. */
+ | "personal-copilot"
+/** Skill defined in the user's personal agents skill directory. */
+ | "personal-agents"
+/** Skill provided by an installed plugin. */
+ | "plugin"
+/** Skill loaded from a configured custom skill directory. */
+ | "custom"
+/** Skill bundled with the runtime. */
+ | "builtin";
+/**
+ * Configuration source: user, workspace, plugin, or builtin
+ */
+export type McpServerSource = 
+/** Server configured in the user's global MCP configuration. */
+"user"
+/** Server configured by the current workspace. */
+ | "workspace"
+/** Server contributed by an installed plugin. */
+ | "plugin"
+/** Server bundled with the runtime. */
+ | "builtin";
 /**
  * Connection status: connected, failed, needs-auth, pending, disabled, or not_configured
  */
-export type McpServersLoadedServerStatus = "connected" | "failed" | "needs-auth" | "pending" | "disabled" | "not_configured";
-/**
- * New connection status: connected, failed, needs-auth, pending, disabled, or not_configured
- */
-export type McpServerStatusChangedStatus = "connected" | "failed" | "needs-auth" | "pending" | "disabled" | "not_configured";
+export type McpServerStatus = 
+/** The server is connected and available. */
+"connected"
+/** The server failed to connect or initialize. */
+ | "failed"
+/** The server requires authentication before it can connect. */
+ | "needs-auth"
+/** The server connection is still being established. */
+ | "pending"
+/** The server is configured but disabled. */
+ | "disabled"
+/** The server is not configured for this session. */
+ | "not_configured";
+/**
+ * Transport mechanism: stdio, http, sse (deprecated), or memory (in-process MCP server)
+ */
+export type McpServerTransport = 
+/** Server communicates over stdio with a local child process. */
+"stdio"
+/** Server communicates over streamable HTTP. */
+ | "http"
+/** Server communicates over Server-Sent Events (deprecated). */
+ | "sse"
+/** Server is backed by an in-memory runtime implementation. */
+ | "memory";
 /**
  * Discovery source
  */
-export type ExtensionsLoadedExtensionSource = "project" | "user";
+export type ExtensionsLoadedExtensionSource = 
+/** Extension discovered from the current project. */
+"project"
+/** Extension discovered from the user's extension directory. */
+ | "user";
 /**
  * Current status: running, disabled, failed, or starting
  */
-export type ExtensionsLoadedExtensionStatus = "running" | "disabled" | "failed" | "starting";
+export type ExtensionsLoadedExtensionStatus = 
+/** The extension process is running. */
+"running"
+/** The extension is installed but disabled. */
+ | "disabled"
+/** The extension failed to start or crashed. */
+ | "failed"
+/** The extension process is starting. */
+ | "starting";
+/**
+ * Runtime-controlled routing state for the instance. "ready" when the provider connection is live; "stale" when the provider has gone away and the instance is awaiting rebinding.
+ */
+export type CanvasOpenedAvailability = 
+/** Provider connection is live; actions can be invoked. */
+"ready"
+/** Provider has gone away; the instance is awaiting rebinding. */
+ | "stale";
+/**
+ * Session event "session.start". Session initialization metadata including context and configuration
+ */
 export interface StartEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -150,6 +421,9 @@ export interface StartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.start".
+     */
     type: "session.start";
 }
 /**
@@ -161,20 +435,29 @@ export interface StartData {
      */
     alreadyInUse?: boolean;
     context?: WorkingDirectoryContext;
+    /**
+     * Context tier selected at session creation time for models with tiered context pricing; null when no tier is selected (e.g., non-tiered model)
+     */
+    contextTier?: ContextTier | null;
     /**
      * Version string of the Copilot application
      */
     copilotVersion: string;
+    /**
+     * When set, identifies a parent session whose context this session continues — e.g., a detached headless rem-agent run launched on the parent's interactive shutdown. Telemetry from this session is reported under the parent's session_id.
+     */
+    detachedFromSpawningParentSessionId?: string;
     /**
      * Identifier of the software producing the events (e.g., "copilot-agent")
      */
     producer: string;
     /**
-     * Reasoning effort level used for model calls, if applicable (e.g. "low", "medium", "high", "xhigh")
+     * Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max")
      */
     reasoningEffort?: string;
+    reasoningSummary?: ReasoningSummary;
     /**
-     * Whether this session supports remote steering via Mission Control
+     * Whether this session supports remote steering via GitHub
      */
     remoteSteerable?: boolean;
     /**
@@ -228,6 +511,9 @@ export interface WorkingDirectoryContext {
      */
     repositoryHost?: string;
 }
+/**
+ * Session event "session.resume". Session resume metadata including current context and event count
+ */
 export interface ResumeEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -250,6 +536,9 @@ export interface ResumeEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.resume".
+     */
     type: "session.resume";
 }
 /**
@@ -261,6 +550,10 @@ export interface ResumeData {
      */
     alreadyInUse?: boolean;
     context?: WorkingDirectoryContext;
+    /**
+     * Context tier currently selected at resume time; null when no tier is active
+     */
+    contextTier?: ContextTier | null;
     /**
      * When true, tool calls and permission requests left in flight by the previous session lifetime remain pending after resume and the agentic loop awaits their results. User sends are queued behind the pending work until all such requests reach a terminal state. When false (the default), any such tool calls and permission requests are immediately marked as interrupted on resume.
      */
@@ -270,11 +563,12 @@ export interface ResumeData {
      */
     eventCount: number;
     /**
-     * Reasoning effort level used for model calls, if applicable (e.g. "low", "medium", "high", "xhigh")
+     * Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max")
      */
     reasoningEffort?: string;
+    reasoningSummary?: ReasoningSummary;
     /**
-     * Whether this session supports remote steering via Mission Control
+     * Whether this session supports remote steering via GitHub
      */
     remoteSteerable?: boolean;
     /**
@@ -290,6 +584,9 @@ export interface ResumeData {
      */
     sessionWasActive?: boolean;
 }
+/**
+ * Session event "session.remote_steerable_changed". Notifies that the session's remote steering capability has changed
+ */
 export interface RemoteSteerableChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -312,17 +609,23 @@ export interface RemoteSteerableChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.remote_steerable_changed".
+     */
     type: "session.remote_steerable_changed";
 }
 /**
- * Notifies Mission Control that the session's remote steering capability has changed
+ * Notifies that the session's remote steering capability has changed
  */
 export interface RemoteSteerableChangedData {
     /**
-     * Whether this session now supports remote steering via Mission Control
+     * Whether this session now supports remote steering via GitHub
      */
     remoteSteerable: boolean;
 }
+/**
+ * Session event "session.error". Error details for timeline display including message and optional diagnostic information
+ */
 export interface ErrorEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -345,6 +648,9 @@ export interface ErrorEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.error".
+     */
     type: "session.error";
 }
 /**
@@ -356,7 +662,7 @@ export interface ErrorData {
      */
     eligibleForAutoSwitch?: boolean;
     /**
-     * Fine-grained error code from the upstream provider, when available. For `errorType: "rate_limit"`, this is one of the `RateLimitErrorCode` values (e.g., `"user_weekly_rate_limited"`, `"user_global_rate_limited"`, `"rate_limited"`, `"user_model_rate_limited"`, `"integration_rate_limited"`).
+     * Fine-grained error code from the upstream provider, when available. For `errorType: "rate_limit"`, this is one of the `RateLimitErrorCode` values (e.g., `"user_weekly_rate_limited"`, `"user_global_rate_limited"`, `"rate_limited"`, `"user_model_rate_limited"`, `"integration_rate_limited"`). For `errorType: "quota"`, this is the CAPI quota error code (e.g., `"quota_exceeded"`, `"session_quota_exceeded"`, `"billing_not_configured"`).
      */
     errorCode?: string;
     /**
@@ -371,6 +677,10 @@ export interface ErrorData {
      * GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs
      */
     providerCallId?: string;
+    /**
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
+     */
+    serviceRequestId?: string;
     /**
      * Error stack trace, when available
      */
@@ -384,12 +694,18 @@ export interface ErrorData {
      */
     url?: string;
 }
+/**
+ * Session event "session.idle". Payload indicating the session is idle with no background agents in flight
+ */
 export interface IdleEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: IdleData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -403,6 +719,9 @@ export interface IdleEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.idle".
+     */
     type: "session.idle";
 }
 /**
@@ -414,12 +733,18 @@ export interface IdleData {
      */
     aborted?: boolean;
 }
+/**
+ * Session event "session.title_changed". Session title change payload containing the new display title
+ */
 export interface TitleChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: TitleChangedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -433,6 +758,9 @@ export interface TitleChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.title_changed".
+     */
     type: "session.title_changed";
 }
 /**
@@ -444,6 +772,144 @@ export interface TitleChangedData {
      */
     title: string;
 }
+/**
+ * Session event "session.schedule_created". Scheduled prompt registered via /every or /after
+ */
+export interface ScheduleCreatedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: ScheduleCreatedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.schedule_created".
+     */
+    type: "session.schedule_created";
+}
+/**
+ * Scheduled prompt registered via /every or /after
+ */
+export interface ScheduleCreatedData {
+    /**
+     * Optional user-facing label shown in the timeline instead of the actual prompt (e.g. `/skill-name args` when the prompt is a skill invocation expansion)
+     */
+    displayPrompt?: string;
+    /**
+     * Sequential id assigned to the scheduled prompt within the session
+     */
+    id: number;
+    /**
+     * Interval between ticks in milliseconds
+     */
+    intervalMs: number;
+    /**
+     * Prompt text that gets enqueued on every tick
+     */
+    prompt: string;
+    /**
+     * Whether the schedule re-arms after each tick (`/every`) or fires once (`/after`)
+     */
+    recurring?: boolean;
+}
+/**
+ * Session event "session.schedule_cancelled". Scheduled prompt cancelled from the schedule manager dialog
+ */
+export interface ScheduleCancelledEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: ScheduleCancelledData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.schedule_cancelled".
+     */
+    type: "session.schedule_cancelled";
+}
+/**
+ * Scheduled prompt cancelled from the schedule manager dialog
+ */
+export interface ScheduleCancelledData {
+    /**
+     * Id of the scheduled prompt that was cancelled
+     */
+    id: number;
+}
+/**
+ * Session event "session.autopilot_objective_changed". Autopilot objective state file operation details indicating what changed
+ */
+export interface AutopilotObjectiveChangedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: AutopilotObjectiveChangedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.autopilot_objective_changed".
+     */
+    type: "session.autopilot_objective_changed";
+}
+/**
+ * Autopilot objective state file operation details indicating what changed
+ */
+export interface AutopilotObjectiveChangedData {
+    /**
+     * Current autopilot objective id, if one exists
+     */
+    id?: number;
+    operation: AutopilotObjectiveChangedOperation;
+    status?: AutopilotObjectiveChangedStatus;
+}
+/**
+ * Session event "session.info". Informational message for timeline display with categorization
+ */
 export interface InfoEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -466,6 +932,9 @@ export interface InfoEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.info".
+     */
     type: "session.info";
 }
 /**
@@ -489,6 +958,9 @@ export interface InfoData {
      */
     url?: string;
 }
+/**
+ * Session event "session.warning". Warning message for timeline display with categorization
+ */
 export interface WarningEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -511,6 +983,9 @@ export interface WarningEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.warning".
+     */
     type: "session.warning";
 }
 /**
@@ -530,6 +1005,9 @@ export interface WarningData {
      */
     warningType: string;
 }
+/**
+ * Session event "session.model_change". Model change details including previous and new model identifiers
+ */
 export interface ModelChangeEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -552,6 +1030,9 @@ export interface ModelChangeEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.model_change".
+     */
     type: "session.model_change";
 }
 /**
@@ -562,6 +1043,10 @@ export interface ModelChangeData {
      * Reason the change happened, when not user-initiated. Currently `"rate_limit_auto_switch"` for changes triggered by the auto-mode-switch rate-limit recovery path. UI clients can use this to render contextual copy.
      */
     cause?: string;
+    /**
+     * Context tier after the model change; null explicitly clears a previously selected tier
+     */
+    contextTier?: ContextTier | null;
     /**
      * Newly selected model identifier
      */
@@ -574,11 +1059,16 @@ export interface ModelChangeData {
      * Reasoning effort level before the model change, if applicable
      */
     previousReasoningEffort?: string;
+    previousReasoningSummary?: ReasoningSummary;
     /**
      * Reasoning effort level after the model change, if applicable
      */
-    reasoningEffort?: string;
+    reasoningEffort?: string | null;
+    reasoningSummary?: ReasoningSummary;
 }
+/**
+ * Session event "session.mode_changed". Agent mode change details including previous and new modes
+ */
 export interface ModeChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -601,21 +1091,64 @@ export interface ModeChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.mode_changed".
+     */
     type: "session.mode_changed";
 }
 /**
  * Agent mode change details including previous and new modes
  */
 export interface ModeChangedData {
+    newMode: SessionMode;
+    previousMode: SessionMode;
+}
+/**
+ * Session event "session.permissions_changed". Permissions change details carrying the aggregate allow-all boolean transition.
+ */
+export interface PermissionsChangedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: PermissionsChangedData;
+    /**
+     * When true, the event is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
     /**
-     * Agent mode after the change (e.g., "interactive", "plan", "autopilot")
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.permissions_changed".
+     */
+    type: "session.permissions_changed";
+}
+/**
+ * Permissions change details carrying the aggregate allow-all boolean transition.
+ */
+export interface PermissionsChangedData {
+    /**
+     * Aggregate allow-all flag after the change
      */
-    newMode: string;
+    allowAllPermissions: boolean;
     /**
-     * Agent mode before the change (e.g., "interactive", "plan", "autopilot")
+     * Aggregate allow-all flag before the change
      */
-    previousMode: string;
+    previousAllowAllPermissions: boolean;
 }
+/**
+ * Session event "session.plan_changed". Plan file operation details indicating what changed
+ */
 export interface PlanChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -638,6 +1171,9 @@ export interface PlanChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.plan_changed".
+     */
     type: "session.plan_changed";
 }
 /**
@@ -646,6 +1182,9 @@ export interface PlanChangedEvent {
 export interface PlanChangedData {
     operation: PlanChangedOperation;
 }
+/**
+ * Session event "session.workspace_file_changed". Workspace file change details including path and operation type
+ */
 export interface WorkspaceFileChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -668,6 +1207,9 @@ export interface WorkspaceFileChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.workspace_file_changed".
+     */
     type: "session.workspace_file_changed";
 }
 /**
@@ -680,6 +1222,9 @@ export interface WorkspaceFileChangedData {
      */
     path: string;
 }
+/**
+ * Session event "session.handoff". Session handoff metadata including source, context, and repository information
+ */
 export interface HandoffEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -702,6 +1247,9 @@ export interface HandoffEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.handoff".
+     */
     type: "session.handoff";
 }
 /**
@@ -748,6 +1296,9 @@ export interface HandoffRepository {
      */
     owner: string;
 }
+/**
+ * Session event "session.truncation". Conversation truncation statistics including token counts and removed content metrics
+ */
 export interface TruncationEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -770,6 +1321,9 @@ export interface TruncationEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.truncation".
+     */
     type: "session.truncation";
 }
 /**
@@ -809,12 +1363,18 @@ export interface TruncationData {
      */
     tokensRemovedDuringTruncation: number;
 }
+/**
+ * Session event "session.snapshot_rewind". Session rewind details including target event and count of removed events
+ */
 export interface SnapshotRewindEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: SnapshotRewindData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -828,6 +1388,9 @@ export interface SnapshotRewindEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.snapshot_rewind".
+     */
     type: "session.snapshot_rewind";
 }
 /**
@@ -843,6 +1406,9 @@ export interface SnapshotRewindData {
      */
     upToEventId: string;
 }
+/**
+ * Session event "session.shutdown". Session termination metrics including usage statistics, code changes, and shutdown reason
+ */
 export interface ShutdownEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -865,6 +1431,9 @@ export interface ShutdownEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.shutdown".
+     */
     type: "session.shutdown";
 }
 /**
@@ -892,7 +1461,7 @@ export interface ShutdownData {
      * Per-model usage breakdown, keyed by model identifier
      */
     modelMetrics: {
-        [k: string]: ShutdownModelMetric;
+        [k: string]: ShutdownModelMetric | undefined;
     };
     /**
      * Unix timestamp (milliseconds) when the session started
@@ -907,7 +1476,7 @@ export interface ShutdownData {
      * Session-wide per-token-type accumulated token counts
      */
     tokenDetails?: {
-        [k: string]: ShutdownTokenDetail;
+        [k: string]: ShutdownTokenDetail | undefined;
     };
     /**
      * Tool definitions token count at shutdown
@@ -919,12 +1488,10 @@ export interface ShutdownData {
     totalApiDurationMs: number;
     /**
      * Session-wide accumulated nano-AI units cost
+     *
+     * @experimental
      */
     totalNanoAiu?: number;
-    /**
-     * Total number of premium API requests used during the session
-     */
-    totalPremiumRequests: number;
 }
 /**
  * Aggregate code change metrics for the session
@@ -943,16 +1510,21 @@ export interface ShutdownCodeChanges {
      */
     linesRemoved: number;
 }
+/**
+ * Schema for the `ShutdownModelMetric` type.
+ */
 export interface ShutdownModelMetric {
     requests: ShutdownModelMetricRequests;
     /**
      * Token count details per type
      */
     tokenDetails?: {
-        [k: string]: ShutdownModelMetricTokenDetail;
+        [k: string]: ShutdownModelMetricTokenDetail | undefined;
     };
     /**
      * Accumulated nano-AI units cost for this model
+     *
+     * @experimental
      */
     totalNanoAiu?: number;
     usage: ShutdownModelMetricUsage;
@@ -963,13 +1535,20 @@ export interface ShutdownModelMetric {
 export interface ShutdownModelMetricRequests {
     /**
      * Cumulative cost multiplier for requests to this model
+     *
+     * @experimental
      */
-    cost: number;
+    cost?: number;
     /**
      * Total number of API requests made to this model
+     *
+     * @experimental
      */
-    count: number;
+    count?: number;
 }
+/**
+ * Schema for the `ShutdownModelMetricTokenDetail` type.
+ */
 export interface ShutdownModelMetricTokenDetail {
     /**
      * Accumulated token count for this token type
@@ -1001,12 +1580,18 @@ export interface ShutdownModelMetricUsage {
      */
     reasoningTokens?: number;
 }
+/**
+ * Schema for the `ShutdownTokenDetail` type.
+ */
 export interface ShutdownTokenDetail {
     /**
      * Accumulated token count for this token type
      */
     tokenCount: number;
 }
+/**
+ * Session event "session.context_changed". Updated working directory and git context after the change
+ */
 export interface ContextChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1029,14 +1614,23 @@ export interface ContextChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.context_changed".
+     */
     type: "session.context_changed";
 }
+/**
+ * Session event "session.usage_info". Current context window usage statistics including token and message counts
+ */
 export interface UsageInfoEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: UsageInfoData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1050,6 +1644,9 @@ export interface UsageInfoEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.usage_info".
+     */
     type: "session.usage_info";
 }
 /**
@@ -1085,6 +1682,9 @@ export interface UsageInfoData {
      */
     toolDefinitionsTokens?: number;
 }
+/**
+ * Session event "session.compaction_start". Context window breakdown at the start of LLM-powered conversation compaction
+ */
 export interface CompactionStartEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1107,6 +1707,9 @@ export interface CompactionStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.compaction_start".
+     */
     type: "session.compaction_start";
 }
 /**
@@ -1126,6 +1729,9 @@ export interface CompactionStartData {
      */
     toolDefinitionsTokens?: number;
 }
+/**
+ * Session event "session.compaction_complete". Conversation compaction results including success status, metrics, and optional error details
+ */
 export interface CompactionCompleteEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1148,6 +1754,9 @@ export interface CompactionCompleteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.compaction_complete".
+     */
     type: "session.compaction_complete";
 }
 /**
@@ -1167,6 +1776,10 @@ export interface CompactionCompleteData {
      * Token count from non-system messages (user, assistant, tool) after compaction
      */
     conversationTokens?: number;
+    /**
+     * User-supplied focus instructions provided to a manual `/compact` invocation. Omitted for automatic compaction and for manual compaction with no focus text.
+     */
+    customInstructions?: string;
     /**
      * Error message if compaction failed
      */
@@ -1191,6 +1804,10 @@ export interface CompactionCompleteData {
      * GitHub request tracing ID (x-github-request-id header) for the compaction LLM call
      */
     requestId?: string;
+    /**
+     * Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call
+     */
+    serviceRequestId?: string;
     /**
      * Whether compaction completed successfully
      */
@@ -1224,7 +1841,6 @@ export interface CompactionCompleteCompactionTokensUsed {
      * Tokens written to prompt cache in the compaction LLM call
      */
     cacheWriteTokens?: number;
-    copilotUsage?: CompactionCompleteCompactionTokensUsedCopilotUsage;
     /**
      * Duration of the compaction LLM call in milliseconds
      */
@@ -1242,19 +1858,6 @@ export interface CompactionCompleteCompactionTokensUsed {
      */
     outputTokens?: number;
 }
-/**
- * Per-request cost and usage data from the CAPI copilot_usage response field
- */
-export interface CompactionCompleteCompactionTokensUsedCopilotUsage {
-    /**
-     * Itemized token usage breakdown
-     */
-    tokenDetails: CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail[];
-    /**
-     * Total cost in nano-AI units for this request
-     */
-    totalNanoAiu: number;
-}
 /**
  * Token usage detail for a single billing category
  */
@@ -1276,6 +1879,9 @@ export interface CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail {
      */
     tokenType: string;
 }
+/**
+ * Session event "session.task_complete". Task completion notification with summary from the agent
+ */
 export interface TaskCompleteEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1298,6 +1904,9 @@ export interface TaskCompleteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.task_complete".
+     */
     type: "session.task_complete";
 }
 /**
@@ -1313,6 +1922,9 @@ export interface TaskCompleteData {
      */
     summary?: string;
 }
+/**
+ * Session event "user.message".
+ */
 export interface UserMessageEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1335,14 +1947,20 @@ export interface UserMessageEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "user.message".
+     */
     type: "user.message";
 }
+/**
+ * Schema for the `UserMessageData` type.
+ */
 export interface UserMessageData {
     agentMode?: UserMessageAgentMode;
     /**
      * Files, selections, or GitHub references attached to the message
      */
-    attachments?: UserMessageAttachment[];
+    attachments?: Attachment[];
     /**
      * The user's message text as displayed in the timeline
      */
@@ -1352,7 +1970,11 @@ export interface UserMessageData {
      */
     interactionId?: string;
     /**
-     * Path-backed native document attachments that stayed on the tagged_files path flow because native upload would exceed the request size limit
+     * True when this user message was auto-injected by autopilot's continuation loop rather than typed by the user; used to distinguish autopilot-driven turns in telemetry.
+     */
+    isAutopilotContinuation?: boolean;
+    /**
+     * Path-backed native document attachments that stayed on the tagged_files path flow because native upload could not read them or would exceed the request size limit
      */
     nativeDocumentPathFallbackPaths?: string[];
     /**
@@ -1375,12 +1997,12 @@ export interface UserMessageData {
 /**
  * File attachment
  */
-export interface UserMessageAttachmentFile {
+export interface AttachmentFile {
     /**
      * User-facing display name for the attachment
      */
     displayName: string;
-    lineRange?: UserMessageAttachmentFileLineRange;
+    lineRange?: AttachmentFileLineRange;
     /**
      * Absolute file path
      */
@@ -1393,7 +2015,7 @@ export interface UserMessageAttachmentFile {
 /**
  * Optional line range to scope the attachment to a specific section of the file
  */
-export interface UserMessageAttachmentFileLineRange {
+export interface AttachmentFileLineRange {
     /**
      * End line number (1-based, inclusive)
      */
@@ -1406,7 +2028,7 @@ export interface UserMessageAttachmentFileLineRange {
 /**
  * Directory attachment
  */
-export interface UserMessageAttachmentDirectory {
+export interface AttachmentDirectory {
     /**
      * User-facing display name for the attachment
      */
@@ -1423,7 +2045,7 @@ export interface UserMessageAttachmentDirectory {
 /**
  * Code selection attachment from an editor
  */
-export interface UserMessageAttachmentSelection {
+export interface AttachmentSelection {
     /**
      * User-facing display name for the selection
      */
@@ -1432,7 +2054,7 @@ export interface UserMessageAttachmentSelection {
      * Absolute path to the file containing the selection
      */
     filePath: string;
-    selection: UserMessageAttachmentSelectionDetails;
+    selection: AttachmentSelectionDetails;
     /**
      * The selected text content
      */
@@ -1445,14 +2067,14 @@ export interface UserMessageAttachmentSelection {
 /**
  * Position range of the selection within the file
  */
-export interface UserMessageAttachmentSelectionDetails {
-    end: UserMessageAttachmentSelectionDetailsEnd;
-    start: UserMessageAttachmentSelectionDetailsStart;
+export interface AttachmentSelectionDetails {
+    end: AttachmentSelectionDetailsEnd;
+    start: AttachmentSelectionDetailsStart;
 }
 /**
  * End position of the selection
  */
-export interface UserMessageAttachmentSelectionDetailsEnd {
+export interface AttachmentSelectionDetailsEnd {
     /**
      * End character offset within the line (0-based)
      */
@@ -1465,7 +2087,7 @@ export interface UserMessageAttachmentSelectionDetailsEnd {
 /**
  * Start position of the selection
  */
-export interface UserMessageAttachmentSelectionDetailsStart {
+export interface AttachmentSelectionDetailsStart {
     /**
      * Start character offset within the line (0-based)
      */
@@ -1478,12 +2100,12 @@ export interface UserMessageAttachmentSelectionDetailsStart {
 /**
  * GitHub issue, pull request, or discussion reference
  */
-export interface UserMessageAttachmentGithubReference {
+export interface AttachmentGitHubReference {
     /**
      * Issue, pull request, or discussion number
      */
     number: number;
-    referenceType: UserMessageAttachmentGithubReferenceType;
+    referenceType: AttachmentGitHubReferenceType;
     /**
      * Current state of the referenced item (e.g., open, closed, merged)
      */
@@ -1504,7 +2126,7 @@ export interface UserMessageAttachmentGithubReference {
 /**
  * Blob attachment with inline base64-encoded data
  */
-export interface UserMessageAttachmentBlob {
+export interface AttachmentBlob {
     /**
      * Base64-encoded content
      */
@@ -1522,12 +2144,53 @@ export interface UserMessageAttachmentBlob {
      */
     type: "blob";
 }
+/**
+ * Structured context contributed by an extension. Composer pills displayed in the host are forwarded back through session.send.attachments, then rendered into the model prompt as an <extension_context> XML block.
+ */
+export interface AttachmentExtensionContext {
+    /**
+     * Provider-local canvas identifier when the push was bound to a canvas instance
+     */
+    canvasId?: string;
+    /**
+     * ISO 8601 timestamp captured by the runtime when the push was accepted
+     */
+    capturedAt: string;
+    /**
+     * Owning extension identifier. Runtime-derived from the caller's connection when produced via session.extensions.sendAttachmentsToMessage; preserved verbatim on subsequent transports.
+     */
+    extensionId: string;
+    /**
+     * Open canvas instance identifier when the push was bound to a canvas instance
+     */
+    instanceId?: string;
+    /**
+     * Caller-supplied JSON payload
+     */
+    payload?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Human-readable composer pill label
+     */
+    title: string;
+    /**
+     * Attachment type discriminator
+     */
+    type: "extension_context";
+}
+/**
+ * Session event "pending_messages.modified". Empty payload; the event signals that the pending message queue has changed
+ */
 export interface PendingMessagesModifiedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: PendingMessagesModifiedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1541,6 +2204,9 @@ export interface PendingMessagesModifiedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "pending_messages.modified".
+     */
     type: "pending_messages.modified";
 }
 /**
@@ -1548,6 +2214,9 @@ export interface PendingMessagesModifiedEvent {
  */
 export interface PendingMessagesModifiedData {
 }
+/**
+ * Session event "assistant.turn_start". Turn initialization metadata including identifier and interaction tracking
+ */
 export interface AssistantTurnStartEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1570,6 +2239,9 @@ export interface AssistantTurnStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.turn_start".
+     */
     type: "assistant.turn_start";
 }
 /**
@@ -1585,12 +2257,18 @@ export interface AssistantTurnStartData {
      */
     turnId: string;
 }
+/**
+ * Session event "assistant.intent". Agent intent description for current activity or plan
+ */
 export interface AssistantIntentEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AssistantIntentData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1604,6 +2282,9 @@ export interface AssistantIntentEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.intent".
+     */
     type: "assistant.intent";
 }
 /**
@@ -1615,6 +2296,9 @@ export interface AssistantIntentData {
      */
     intent: string;
 }
+/**
+ * Session event "assistant.reasoning". Assistant reasoning content for timeline display with complete thinking text
+ */
 export interface AssistantReasoningEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1637,6 +2321,9 @@ export interface AssistantReasoningEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.reasoning".
+     */
     type: "assistant.reasoning";
 }
 /**
@@ -1652,12 +2339,18 @@ export interface AssistantReasoningData {
      */
     reasoningId: string;
 }
+/**
+ * Session event "assistant.reasoning_delta". Streaming reasoning delta for incremental extended thinking updates
+ */
 export interface AssistantReasoningDeltaEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AssistantReasoningDeltaData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1671,6 +2364,9 @@ export interface AssistantReasoningDeltaEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.reasoning_delta".
+     */
     type: "assistant.reasoning_delta";
 }
 /**
@@ -1686,12 +2382,18 @@ export interface AssistantReasoningDeltaData {
      */
     reasoningId: string;
 }
+/**
+ * Session event "assistant.streaming_delta". Streaming response progress with cumulative byte count
+ */
 export interface AssistantStreamingDeltaEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AssistantStreamingDeltaData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1705,6 +2407,9 @@ export interface AssistantStreamingDeltaEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.streaming_delta".
+     */
     type: "assistant.streaming_delta";
 }
 /**
@@ -1716,6 +2421,9 @@ export interface AssistantStreamingDeltaData {
      */
     totalResponseSizeBytes: number;
 }
+/**
+ * Session event "assistant.message". Assistant response containing text content, optional tool requests, and interaction metadata
+ */
 export interface AssistantMessageEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1738,12 +2446,27 @@ export interface AssistantMessageEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.message".
+     */
     type: "assistant.message";
 }
 /**
  * Assistant response containing text content, optional tool requests, and interaction metadata
  */
 export interface AssistantMessageData {
+    /**
+     * Raw Anthropic content array with advisor blocks (server_tool_use, advisor_tool_result) for verbatim round-tripping
+     *
+     * @experimental
+     */
+    anthropicAdvisorBlocks?: unknown[];
+    /**
+     * Anthropic advisor model ID used for this response, for timeline display on replay
+     *
+     * @experimental
+     */
+    anthropicAdvisorModel?: string;
     /**
      * The assistant's text response content
      */
@@ -1760,6 +2483,10 @@ export interface AssistantMessageData {
      * Unique identifier for this assistant message
      */
     messageId: string;
+    /**
+     * Model that produced this assistant message, if known
+     */
+    model?: string;
     /**
      * Actual output token count from the API response (completion_tokens), used for accurate token accounting
      */
@@ -1785,6 +2512,10 @@ export interface AssistantMessageData {
      * GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs
      */
     requestId?: string;
+    /**
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
+     */
+    serviceRequestId?: string;
     /**
      * Tool invocations requested by the assistant in this message
      */
@@ -1802,7 +2533,7 @@ export interface AssistantMessageToolRequest {
      * Arguments to pass to the tool, format depends on the tool
      */
     arguments?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Resolved intention summary describing what this specific call does
@@ -1812,6 +2543,10 @@ export interface AssistantMessageToolRequest {
      * Name of the MCP server hosting this tool, when the tool is an MCP tool
      */
     mcpServerName?: string;
+    /**
+     * Original tool name on the MCP server, when the tool is an MCP tool
+     */
+    mcpToolName?: string;
     /**
      * Name of the tool being invoked
      */
@@ -1826,12 +2561,18 @@ export interface AssistantMessageToolRequest {
     toolTitle?: string;
     type?: AssistantMessageToolRequestType;
 }
+/**
+ * Session event "assistant.message_start". Streaming assistant message start metadata
+ */
 export interface AssistantMessageStartEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AssistantMessageStartData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1845,6 +2586,9 @@ export interface AssistantMessageStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.message_start".
+     */
     type: "assistant.message_start";
 }
 /**
@@ -1860,12 +2604,18 @@ export interface AssistantMessageStartData {
      */
     phase?: string;
 }
+/**
+ * Session event "assistant.message_delta". Streaming assistant message delta for incremental response updates
+ */
 export interface AssistantMessageDeltaEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AssistantMessageDeltaData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1879,6 +2629,9 @@ export interface AssistantMessageDeltaEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.message_delta".
+     */
     type: "assistant.message_delta";
 }
 /**
@@ -1899,6 +2652,9 @@ export interface AssistantMessageDeltaData {
      */
     parentToolCallId?: string;
 }
+/**
+ * Session event "assistant.turn_end". Turn completion metadata including the turn identifier
+ */
 export interface AssistantTurnEndEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -1921,6 +2677,9 @@ export interface AssistantTurnEndEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.turn_end".
+     */
     type: "assistant.turn_end";
 }
 /**
@@ -1932,12 +2691,18 @@ export interface AssistantTurnEndData {
      */
     turnId: string;
 }
+/**
+ * Session event "assistant.usage". LLM API call usage metrics including tokens, costs, quotas, and billing information
+ */
 export interface AssistantUsageEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AssistantUsageData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -1951,6 +2716,9 @@ export interface AssistantUsageEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.usage".
+     */
     type: "assistant.usage";
 }
 /**
@@ -1961,6 +2729,7 @@ export interface AssistantUsageData {
      * Completion ID from the model provider (e.g., chatcmpl-abc123)
      */
     apiCallId?: string;
+    apiEndpoint?: AssistantUsageApiEndpoint;
     /**
      * Number of tokens read from prompt cache
      */
@@ -1969,9 +2738,10 @@ export interface AssistantUsageData {
      * Number of tokens written to prompt cache
      */
     cacheWriteTokens?: number;
-    copilotUsage?: AssistantUsageCopilotUsage;
     /**
      * Model multiplier cost for billing purposes
+     *
+     * @experimental
      */
     cost?: number;
     /**
@@ -2008,13 +2778,7 @@ export interface AssistantUsageData {
      */
     providerCallId?: string;
     /**
-     * Per-quota resource usage snapshots, keyed by quota identifier
-     */
-    quotaSnapshots?: {
-        [k: string]: AssistantUsageQuotaSnapshot;
-    };
-    /**
-     * Reasoning effort level used for model calls, if applicable (e.g. "low", "medium", "high", "xhigh")
+     * Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max")
      */
     reasoningEffort?: string;
     /**
@@ -2022,22 +2786,13 @@ export interface AssistantUsageData {
      */
     reasoningTokens?: number;
     /**
-     * Time to first token in milliseconds. Only available for streaming requests
-     */
-    ttftMs?: number;
-}
-/**
- * Per-request cost and usage data from the CAPI copilot_usage response field
- */
-export interface AssistantUsageCopilotUsage {
-    /**
-     * Itemized token usage breakdown
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
      */
-    tokenDetails: AssistantUsageCopilotUsageTokenDetail[];
+    serviceRequestId?: string;
     /**
-     * Total cost in nano-AI units for this request
+     * Time to first token in milliseconds. Only available for streaming requests
      */
-    totalNanoAiu: number;
+    timeToFirstTokenMs?: number;
 }
 /**
  * Token usage detail for a single billing category
@@ -2060,46 +2815,18 @@ export interface AssistantUsageCopilotUsageTokenDetail {
      */
     tokenType: string;
 }
-export interface AssistantUsageQuotaSnapshot {
-    /**
-     * Total requests allowed by the entitlement
-     */
-    entitlementRequests: number;
-    /**
-     * Whether the user has an unlimited usage entitlement
-     */
-    isUnlimitedEntitlement: boolean;
-    /**
-     * Number of requests over the entitlement limit
-     */
-    overage: number;
-    /**
-     * Whether overage is allowed when quota is exhausted
-     */
-    overageAllowedWithExhaustedQuota: boolean;
-    /**
-     * Percentage of quota remaining (0.0 to 1.0)
-     */
-    remainingPercentage: number;
-    /**
-     * Date when the quota resets
-     */
-    resetDate?: string;
-    /**
-     * Whether usage is still permitted after quota exhaustion
-     */
-    usageAllowedWithExhaustedQuota: boolean;
-    /**
-     * Number of requests already consumed
-     */
-    usedRequests: number;
-}
+/**
+ * Session event "model.call_failure". Failed LLM API call metadata for telemetry
+ */
 export interface ModelCallFailureEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ModelCallFailureData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -2113,6 +2840,9 @@ export interface ModelCallFailureEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "model.call_failure".
+     */
     type: "model.call_failure";
 }
 /**
@@ -2143,12 +2873,19 @@ export interface ModelCallFailureData {
      * GitHub request tracing ID (x-github-request-id header) for server-side log correlation
      */
     providerCallId?: string;
+    /**
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
+     */
+    serviceRequestId?: string;
     source: ModelCallFailureSource;
     /**
      * HTTP status code from the failed request
      */
     statusCode?: number;
 }
+/**
+ * Session event "abort". Turn abort information including the reason for termination
+ */
 export interface AbortEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2171,17 +2908,20 @@ export interface AbortEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "abort".
+     */
     type: "abort";
 }
 /**
  * Turn abort information including the reason for termination
  */
 export interface AbortData {
-    /**
-     * Reason the current turn was aborted (e.g., "user initiated")
-     */
-    reason: string;
+    reason: AbortReason;
 }
+/**
+ * Session event "tool.user_requested". User-initiated tool invocation request with tool name and arguments
+ */
 export interface ToolUserRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2204,6 +2944,9 @@ export interface ToolUserRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.user_requested".
+     */
     type: "tool.user_requested";
 }
 /**
@@ -2214,7 +2957,7 @@ export interface ToolUserRequestedData {
      * Arguments for the tool invocation
      */
     arguments?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Unique identifier for this tool call
@@ -2225,6 +2968,9 @@ export interface ToolUserRequestedData {
      */
     toolName: string;
 }
+/**
+ * Session event "tool.execution_start". Tool execution startup details including MCP server information when applicable
+ */
 export interface ToolExecutionStartEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2247,6 +2993,9 @@ export interface ToolExecutionStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_start".
+     */
     type: "tool.execution_start";
 }
 /**
@@ -2257,8 +3006,12 @@ export interface ToolExecutionStartData {
      * Arguments passed to the tool
      */
     arguments?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
+    /**
+     * When true, the tool output should be displayed expanded (verbatim) in the CLI timeline
+     */
+    displayVerbatim?: boolean;
     /**
      * Name of the MCP server hosting this tool, when the tool is an MCP tool
      */
@@ -2267,6 +3020,10 @@ export interface ToolExecutionStartData {
      * Original tool name on the MCP server, when the tool is an MCP tool
      */
     mcpToolName?: string;
+    /**
+     * Model identifier that generated this tool call
+     */
+    model?: string;
     /**
      * @deprecated
      * Tool call ID of the parent tool invocation when this event originates from a sub-agent
@@ -2285,12 +3042,18 @@ export interface ToolExecutionStartData {
      */
     turnId?: string;
 }
+/**
+ * Session event "tool.execution_partial_result". Streaming tool execution output for incremental result display
+ */
 export interface ToolExecutionPartialResultEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ToolExecutionPartialData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -2304,6 +3067,9 @@ export interface ToolExecutionPartialResultEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_partial_result".
+     */
     type: "tool.execution_partial_result";
 }
 /**
@@ -2319,12 +3085,18 @@ export interface ToolExecutionPartialData {
      */
     toolCallId: string;
 }
+/**
+ * Session event "tool.execution_progress". Tool execution progress notification with status message
+ */
 export interface ToolExecutionProgressEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ToolExecutionProgressData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -2338,6 +3110,9 @@ export interface ToolExecutionProgressEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_progress".
+     */
     type: "tool.execution_progress";
 }
 /**
@@ -2353,6 +3128,9 @@ export interface ToolExecutionProgressData {
      */
     toolCallId: string;
 }
+/**
+ * Session event "tool.execution_complete". Tool execution completion results including success status, detailed output, and error information
+ */
 export interface ToolExecutionCompleteEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2375,6 +3153,9 @@ export interface ToolExecutionCompleteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_complete".
+     */
     type: "tool.execution_complete";
 }
 /**
@@ -2400,6 +3181,10 @@ export interface ToolExecutionCompleteData {
      */
     parentToolCallId?: string;
     result?: ToolExecutionCompleteResult;
+    /**
+     * Whether this tool execution ran inside a sandbox container
+     */
+    sandboxed?: boolean;
     /**
      * Whether the tool execution completed successfully
      */
@@ -2408,11 +3193,12 @@ export interface ToolExecutionCompleteData {
      * Unique identifier for the completed tool call
      */
     toolCallId: string;
+    toolDescription?: ToolExecutionCompleteToolDescription;
     /**
      * Tool-specific telemetry data (e.g., CodeQL check counts, grep match counts)
      */
     toolTelemetry?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Identifier for the agent loop turn this tool was invoked in, matching the corresponding assistant.turn_start event
@@ -2448,6 +3234,7 @@ export interface ToolExecutionCompleteResult {
      * Full detailed tool result for UI/timeline display, preserving complete content such as diffs. Falls back to content when absent.
      */
     detailedContent?: string;
+    uiResource?: ToolExecutionCompleteUIResource;
 }
 /**
  * Plain text content block
@@ -2582,6 +3369,9 @@ export interface ToolExecutionCompleteContentResource {
      */
     type: "resource";
 }
+/**
+ * Schema for the `EmbeddedTextResourceContents` type.
+ */
 export interface EmbeddedTextResourceContents {
     /**
      * MIME type of the text content
@@ -2596,6 +3386,9 @@ export interface EmbeddedTextResourceContents {
      */
     uri: string;
 }
+/**
+ * Schema for the `EmbeddedBlobResourceContents` type.
+ */
 export interface EmbeddedBlobResourceContents {
     /**
      * Base64-encoded binary content of the resource
@@ -2610,6 +3403,121 @@ export interface EmbeddedBlobResourceContents {
      */
     uri: string;
 }
+/**
+ * MCP Apps UI resource content for rendering in a sandboxed iframe
+ */
+export interface ToolExecutionCompleteUIResource {
+    _meta?: ToolExecutionCompleteUIResourceMeta;
+    /**
+     * Base64-encoded HTML content
+     */
+    blob?: string;
+    /**
+     * MIME type of the content
+     */
+    mimeType: string;
+    /**
+     * HTML content as a string
+     */
+    text?: string;
+    /**
+     * The ui:// URI of the resource
+     */
+    uri: string;
+}
+/**
+ * Resource-level UI metadata (CSP, permissions, visual preferences)
+ */
+export interface ToolExecutionCompleteUIResourceMeta {
+    ui?: ToolExecutionCompleteUIResourceMetaUI;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUI` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUI {
+    csp?: ToolExecutionCompleteUIResourceMetaUICsp;
+    domain?: string;
+    permissions?: ToolExecutionCompleteUIResourceMetaUIPermissions;
+    prefersBorder?: boolean;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUICsp` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUICsp {
+    baseUriDomains?: string[];
+    connectDomains?: string[];
+    frameDomains?: string[];
+    resourceDomains?: string[];
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissions` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissions {
+    camera?: ToolExecutionCompleteUIResourceMetaUIPermissionsCamera;
+    clipboardWrite?: ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite;
+    geolocation?: ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation;
+    microphone?: ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsCamera` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsCamera {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Tool definition metadata, present for MCP tools with MCP Apps support
+ */
+export interface ToolExecutionCompleteToolDescription {
+    _meta?: ToolExecutionCompleteToolDescriptionMeta;
+    /**
+     * Tool description
+     */
+    description?: string;
+    /**
+     * Tool name
+     */
+    name: string;
+}
+/**
+ * MCP Apps metadata for UI resource association
+ */
+export interface ToolExecutionCompleteToolDescriptionMeta {
+    ui?: ToolExecutionCompleteToolDescriptionMetaUI;
+}
+/**
+ * Schema for the `ToolExecutionCompleteToolDescriptionMetaUI` type.
+ */
+export interface ToolExecutionCompleteToolDescriptionMetaUI {
+    /**
+     * URI of the UI resource
+     */
+    resourceUri?: string;
+    /**
+     * Who can access this tool
+     */
+    visibility?: ToolExecutionCompleteToolDescriptionMetaUIVisibility[];
+}
+/**
+ * Session event "skill.invoked". Skill invocation details including content, allowed tools, and plugin metadata
+ */
 export interface SkillInvokedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2632,6 +3540,9 @@ export interface SkillInvokedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "skill.invoked".
+     */
     type: "skill.invoked";
 }
 /**
@@ -2666,7 +3577,15 @@ export interface SkillInvokedData {
      * Version of the plugin this skill originated from, when applicable
      */
     pluginVersion?: string;
+    /**
+     * Source identifier for where the skill was discovered. Known values include: project (workspace skill), inherited (parent-directory skill), personal-copilot (~/.copilot/skills), personal-agents (~/.agents/skills), personal-claude (~/.claude/skills), custom (configured directory), plugin (installed plugin), builtin (bundled runtime skill), and remote (org/enterprise skill)
+     */
+    source?: string;
+    trigger?: SkillInvokedTrigger;
 }
+/**
+ * Session event "subagent.started". Sub-agent startup details including parent tool call and agent information
+ */
 export interface SubagentStartedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2689,6 +3608,9 @@ export interface SubagentStartedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.started".
+     */
     type: "subagent.started";
 }
 /**
@@ -2707,11 +3629,18 @@ export interface SubagentStartedData {
      * Internal name of the sub-agent
      */
     agentName: string;
+    /**
+     * Model the sub-agent will run with, when known at start. Surfaced in the timeline for auto-selected sub-agents (e.g. rubber-duck).
+     */
+    model?: string;
     /**
      * Tool call ID of the parent tool invocation that spawned this sub-agent
      */
     toolCallId: string;
 }
+/**
+ * Session event "subagent.completed". Sub-agent completion details for successful execution
+ */
 export interface SubagentCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2734,6 +3663,9 @@ export interface SubagentCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.completed".
+     */
     type: "subagent.completed";
 }
 /**
@@ -2769,6 +3701,9 @@ export interface SubagentCompletedData {
      */
     totalToolCalls?: number;
 }
+/**
+ * Session event "subagent.failed". Sub-agent failure details including error message and agent information
+ */
 export interface SubagentFailedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2791,6 +3726,9 @@ export interface SubagentFailedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.failed".
+     */
     type: "subagent.failed";
 }
 /**
@@ -2830,6 +3768,9 @@ export interface SubagentFailedData {
      */
     totalToolCalls?: number;
 }
+/**
+ * Session event "subagent.selected". Custom agent selection details including name and available tools
+ */
 export interface SubagentSelectedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2852,6 +3793,9 @@ export interface SubagentSelectedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.selected".
+     */
     type: "subagent.selected";
 }
 /**
@@ -2871,6 +3815,9 @@ export interface SubagentSelectedData {
      */
     tools: string[] | null;
 }
+/**
+ * Session event "subagent.deselected". Empty payload; the event signals that the custom agent was deselected, returning to the default agent
+ */
 export interface SubagentDeselectedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2893,6 +3840,9 @@ export interface SubagentDeselectedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.deselected".
+     */
     type: "subagent.deselected";
 }
 /**
@@ -2900,6 +3850,9 @@ export interface SubagentDeselectedEvent {
  */
 export interface SubagentDeselectedData {
 }
+/**
+ * Session event "hook.start". Hook invocation start details including type and input data
+ */
 export interface HookStartEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2922,6 +3875,9 @@ export interface HookStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "hook.start".
+     */
     type: "hook.start";
 }
 /**
@@ -2940,9 +3896,12 @@ export interface HookStartData {
      * Input data passed to the hook
      */
     input?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
 }
+/**
+ * Session event "hook.end". Hook invocation completion details including output, success status, and error information
+ */
 export interface HookEndEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -2965,6 +3924,9 @@ export interface HookEndEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "hook.end".
+     */
     type: "hook.end";
 }
 /**
@@ -2984,7 +3946,7 @@ export interface HookEndData {
      * Output data produced by the hook
      */
     output?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Whether the hook completed successfully
@@ -3004,6 +3966,48 @@ export interface HookEndError {
      */
     stack?: string;
 }
+/**
+ * Session event "hook.progress". Ephemeral progress update from a running hook process
+ */
+export interface HookProgressEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: HookProgressData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "hook.progress".
+     */
+    type: "hook.progress";
+}
+/**
+ * Ephemeral progress update from a running hook process
+ */
+export interface HookProgressData {
+    /**
+     * Human-readable progress message from the hook process
+     */
+    message: string;
+}
+/**
+ * Session event "system.message". System/developer instruction content with role and optional template metadata
+ */
 export interface SystemMessageEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -3026,6 +4030,9 @@ export interface SystemMessageEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "system.message".
+     */
     type: "system.message";
 }
 /**
@@ -3055,9 +4062,12 @@ export interface SystemMessageMetadata {
      * Template variables used when constructing the prompt
      */
     variables?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
 }
+/**
+ * Session event "system.notification". System-generated notification for runtime events like background task completion
+ */
 export interface SystemNotificationEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -3080,6 +4090,9 @@ export interface SystemNotificationEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "system.notification".
+     */
     type: "system.notification";
 }
 /**
@@ -3092,6 +4105,9 @@ export interface SystemNotificationData {
     content: string;
     kind: SystemNotification;
 }
+/**
+ * Schema for the `SystemNotificationAgentCompleted` type.
+ */
 export interface SystemNotificationAgentCompleted {
     /**
      * Unique identifier of the background agent
@@ -3110,8 +4126,14 @@ export interface SystemNotificationAgentCompleted {
      */
     prompt?: string;
     status: SystemNotificationAgentCompletedStatus;
+    /**
+     * Type discriminator. Always "agent_completed".
+     */
     type: "agent_completed";
 }
+/**
+ * Schema for the `SystemNotificationAgentIdle` type.
+ */
 export interface SystemNotificationAgentIdle {
     /**
      * Unique identifier of the background agent
@@ -3125,8 +4147,14 @@ export interface SystemNotificationAgentIdle {
      * Human-readable description of the agent task
      */
     description?: string;
+    /**
+     * Type discriminator. Always "agent_idle".
+     */
     type: "agent_idle";
 }
+/**
+ * Schema for the `SystemNotificationNewInboxMessage` type.
+ */
 export interface SystemNotificationNewInboxMessage {
     /**
      * Unique identifier of the inbox entry
@@ -3144,8 +4172,14 @@ export interface SystemNotificationNewInboxMessage {
      * Short summary shown before the agent decides whether to read the inbox
      */
     summary: string;
+    /**
+     * Type discriminator. Always "new_inbox_message".
+     */
     type: "new_inbox_message";
 }
+/**
+ * Schema for the `SystemNotificationShellCompleted` type.
+ */
 export interface SystemNotificationShellCompleted {
     /**
      * Human-readable description of the command
@@ -3159,8 +4193,14 @@ export interface SystemNotificationShellCompleted {
      * Unique identifier of the shell session
      */
     shellId: string;
+    /**
+     * Type discriminator. Always "shell_completed".
+     */
     type: "shell_completed";
 }
+/**
+ * Schema for the `SystemNotificationShellDetachedCompleted` type.
+ */
 export interface SystemNotificationShellDetachedCompleted {
     /**
      * Human-readable description of the command
@@ -3170,8 +4210,14 @@ export interface SystemNotificationShellDetachedCompleted {
      * Unique identifier of the detached shell session
      */
     shellId: string;
+    /**
+     * Type discriminator. Always "shell_detached_completed".
+     */
     type: "shell_detached_completed";
 }
+/**
+ * Schema for the `SystemNotificationInstructionDiscovered` type.
+ */
 export interface SystemNotificationInstructionDiscovered {
     /**
      * Human-readable label for the timeline (e.g., 'AGENTS.md from packages/billing/')
@@ -3189,8 +4235,14 @@ export interface SystemNotificationInstructionDiscovered {
      * Tool command that triggered discovery (currently always 'view')
      */
     triggerTool: string;
+    /**
+     * Type discriminator. Always "instruction_discovered".
+     */
     type: "instruction_discovered";
 }
+/**
+ * Session event "permission.requested". Permission request notification requiring client approval with request details
+ */
 export interface PermissionRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -3213,6 +4265,9 @@ export interface PermissionRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "permission.requested".
+     */
     type: "permission.requested";
 }
 /**
@@ -3275,6 +4330,9 @@ export interface PermissionRequestShell {
      */
     warning?: string;
 }
+/**
+ * Schema for the `PermissionRequestShellCommand` type.
+ */
 export interface PermissionRequestShellCommand {
     /**
      * Command identifier (e.g., executable name)
@@ -3285,6 +4343,9 @@ export interface PermissionRequestShellCommand {
      */
     readOnly: boolean;
 }
+/**
+ * Schema for the `PermissionRequestShellPossibleUrl` type.
+ */
 export interface PermissionRequestShellPossibleUrl {
     /**
      * URL that may be accessed by the command
@@ -3353,7 +4414,7 @@ export interface PermissionRequestMcp {
      * Arguments to pass to the MCP tool
      */
     args?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Permission kind discriminator
@@ -3440,7 +4501,7 @@ export interface PermissionRequestCustomTool {
      * Arguments to pass to the custom tool
      */
     args?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Permission kind discriminator
@@ -3475,7 +4536,7 @@ export interface PermissionRequestHook {
      * Arguments of the tool call being gated
      */
     toolArgs?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Tool call ID that triggered this permission request
@@ -3486,6 +4547,48 @@ export interface PermissionRequestHook {
      */
     toolName: string;
 }
+/**
+ * Extension management permission request
+ */
+export interface PermissionRequestExtensionManagement {
+    /**
+     * Name of the extension being managed
+     */
+    extensionName?: string;
+    /**
+     * Permission kind discriminator
+     */
+    kind: "extension-management";
+    /**
+     * The extension management operation (scaffold, reload)
+     */
+    operation: string;
+    /**
+     * Tool call ID that triggered this permission request
+     */
+    toolCallId?: string;
+}
+/**
+ * Extension permission access request
+ */
+export interface PermissionRequestExtensionPermissionAccess {
+    /**
+     * Capabilities the extension is requesting
+     */
+    capabilities: string[];
+    /**
+     * Name of the extension requesting permission access
+     */
+    extensionName: string;
+    /**
+     * Permission kind discriminator
+     */
+    kind: "extension-permission-access";
+    /**
+     * Tool call ID that triggered this permission request
+     */
+    toolCallId?: string;
+}
 /**
  * Shell command permission prompt
  */
@@ -3624,12 +4727,12 @@ export interface PermissionPromptRequestUrl {
  * Memory operation permission prompt
  */
 export interface PermissionPromptRequestMemory {
-    action?: PermissionPromptRequestMemoryAction;
+    action?: PermissionRequestMemoryAction;
     /**
      * Source references for the stored fact (store only)
      */
     citations?: string;
-    direction?: PermissionPromptRequestMemoryDirection;
+    direction?: PermissionRequestMemoryDirection;
     /**
      * The fact being stored or voted on
      */
@@ -3659,7 +4762,7 @@ export interface PermissionPromptRequestCustomTool {
      * Arguments to pass to the custom tool
      */
     args?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Prompt kind discriminator
@@ -3712,7 +4815,7 @@ export interface PermissionPromptRequestHook {
      * Arguments of the tool call being gated
      */
     toolArgs?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Tool call ID that triggered this permission request
@@ -3723,6 +4826,51 @@ export interface PermissionPromptRequestHook {
      */
     toolName: string;
 }
+/**
+ * Extension management permission prompt
+ */
+export interface PermissionPromptRequestExtensionManagement {
+    /**
+     * Name of the extension being managed
+     */
+    extensionName?: string;
+    /**
+     * Prompt kind discriminator
+     */
+    kind: "extension-management";
+    /**
+     * The extension management operation (scaffold, reload)
+     */
+    operation: string;
+    /**
+     * Tool call ID that triggered this permission request
+     */
+    toolCallId?: string;
+}
+/**
+ * Extension permission access prompt
+ */
+export interface PermissionPromptRequestExtensionPermissionAccess {
+    /**
+     * Capabilities the extension is requesting
+     */
+    capabilities: string[];
+    /**
+     * Name of the extension requesting permission access
+     */
+    extensionName: string;
+    /**
+     * Prompt kind discriminator
+     */
+    kind: "extension-permission-access";
+    /**
+     * Tool call ID that triggered this permission request
+     */
+    toolCallId?: string;
+}
+/**
+ * Session event "permission.completed". Permission request completion notification signaling UI dismissal
+ */
 export interface PermissionCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -3745,6 +4893,9 @@ export interface PermissionCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "permission.completed".
+     */
     type: "permission.completed";
 }
 /**
@@ -3761,12 +4912,18 @@ export interface PermissionCompletedData {
      */
     toolCallId?: string;
 }
+/**
+ * Schema for the `PermissionApproved` type.
+ */
 export interface PermissionApproved {
     /**
      * The permission request was approved
      */
     kind: "approved";
 }
+/**
+ * Schema for the `PermissionApprovedForSession` type.
+ */
 export interface PermissionApprovedForSession {
     approval: UserToolSessionApproval;
     /**
@@ -3774,6 +4931,9 @@ export interface PermissionApprovedForSession {
      */
     kind: "approved-for-session";
 }
+/**
+ * Schema for the `UserToolSessionApprovalCommands` type.
+ */
 export interface UserToolSessionApprovalCommands {
     /**
      * Command identifiers approved by the user
@@ -3784,18 +4944,27 @@ export interface UserToolSessionApprovalCommands {
      */
     kind: "commands";
 }
+/**
+ * Schema for the `UserToolSessionApprovalRead` type.
+ */
 export interface UserToolSessionApprovalRead {
     /**
      * Read approval kind
      */
     kind: "read";
 }
+/**
+ * Schema for the `UserToolSessionApprovalWrite` type.
+ */
 export interface UserToolSessionApprovalWrite {
     /**
      * Write approval kind
      */
     kind: "write";
 }
+/**
+ * Schema for the `UserToolSessionApprovalMcp` type.
+ */
 export interface UserToolSessionApprovalMcp {
     /**
      * MCP tool approval kind
@@ -3810,12 +4979,18 @@ export interface UserToolSessionApprovalMcp {
      */
     toolName: string | null;
 }
+/**
+ * Schema for the `UserToolSessionApprovalMemory` type.
+ */
 export interface UserToolSessionApprovalMemory {
     /**
      * Memory approval kind
      */
     kind: "memory";
 }
+/**
+ * Schema for the `UserToolSessionApprovalCustomTool` type.
+ */
 export interface UserToolSessionApprovalCustomTool {
     /**
      * Custom tool approval kind
@@ -3826,6 +5001,35 @@ export interface UserToolSessionApprovalCustomTool {
      */
     toolName: string;
 }
+/**
+ * Schema for the `UserToolSessionApprovalExtensionManagement` type.
+ */
+export interface UserToolSessionApprovalExtensionManagement {
+    /**
+     * Extension management approval kind
+     */
+    kind: "extension-management";
+    /**
+     * Optional operation identifier
+     */
+    operation?: string;
+}
+/**
+ * Schema for the `UserToolSessionApprovalExtensionPermissionAccess` type.
+ */
+export interface UserToolSessionApprovalExtensionPermissionAccess {
+    /**
+     * Extension name
+     */
+    extensionName: string;
+    /**
+     * Extension permission access approval kind
+     */
+    kind: "extension-permission-access";
+}
+/**
+ * Schema for the `PermissionApprovedForLocation` type.
+ */
 export interface PermissionApprovedForLocation {
     approval: UserToolSessionApproval;
     /**
@@ -3837,6 +5041,9 @@ export interface PermissionApprovedForLocation {
      */
     locationKey: string;
 }
+/**
+ * Schema for the `PermissionCancelled` type.
+ */
 export interface PermissionCancelled {
     /**
      * The permission request was cancelled before a response was used
@@ -3847,6 +5054,9 @@ export interface PermissionCancelled {
      */
     reason?: string;
 }
+/**
+ * Schema for the `PermissionDeniedByRules` type.
+ */
 export interface PermissionDeniedByRules {
     /**
      * Denied because approval rules explicitly blocked it
@@ -3857,9 +5067,12 @@ export interface PermissionDeniedByRules {
      */
     rules: PermissionRule[];
 }
+/**
+ * Schema for the `PermissionRule` type.
+ */
 export interface PermissionRule {
     /**
-     * Optional rule argument matched against the request
+     * Argument value matched against the request, or null when the rule kind has no argument (e.g. 'read', 'write', 'memory').
      */
     argument: string | null;
     /**
@@ -3867,12 +5080,18 @@ export interface PermissionRule {
      */
     kind: string;
 }
+/**
+ * Schema for the `PermissionDeniedNoApprovalRuleAndCouldNotRequestFromUser` type.
+ */
 export interface PermissionDeniedNoApprovalRuleAndCouldNotRequestFromUser {
     /**
      * Denied because no approval rule matched and user confirmation was unavailable
      */
     kind: "denied-no-approval-rule-and-could-not-request-from-user";
 }
+/**
+ * Schema for the `PermissionDeniedInteractivelyByUser` type.
+ */
 export interface PermissionDeniedInteractivelyByUser {
     /**
      * Optional feedback from the user explaining the denial
@@ -3887,6 +5106,9 @@ export interface PermissionDeniedInteractivelyByUser {
      */
     kind: "denied-interactively-by-user";
 }
+/**
+ * Schema for the `PermissionDeniedByContentExclusionPolicy` type.
+ */
 export interface PermissionDeniedByContentExclusionPolicy {
     /**
      * Denied by the organization's content exclusion policy
@@ -3901,6 +5123,9 @@ export interface PermissionDeniedByContentExclusionPolicy {
      */
     path: string;
 }
+/**
+ * Schema for the `PermissionDeniedByPermissionRequestHook` type.
+ */
 export interface PermissionDeniedByPermissionRequestHook {
     /**
      * Whether to interrupt the current agent turn
@@ -3915,12 +5140,18 @@ export interface PermissionDeniedByPermissionRequestHook {
      */
     message?: string;
 }
+/**
+ * Session event "user_input.requested". User input request notification with question and optional predefined choices
+ */
 export interface UserInputRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: UserInputRequestedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -3934,6 +5165,9 @@ export interface UserInputRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "user_input.requested".
+     */
     type: "user_input.requested";
 }
 /**
@@ -3961,12 +5195,18 @@ export interface UserInputRequestedData {
      */
     toolCallId?: string;
 }
+/**
+ * Session event "user_input.completed". User input request completion with the user's response
+ */
 export interface UserInputCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: UserInputCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -3980,6 +5220,9 @@ export interface UserInputCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "user_input.completed".
+     */
     type: "user_input.completed";
 }
 /**
@@ -3999,12 +5242,18 @@ export interface UserInputCompletedData {
      */
     wasFreeform?: boolean;
 }
+/**
+ * Session event "elicitation.requested". Elicitation request; may be form-based (structured input) or URL-based (browser redirect)
+ */
 export interface ElicitationRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ElicitationRequestedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4018,6 +5267,9 @@ export interface ElicitationRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "elicitation.requested".
+     */
     type: "elicitation.requested";
 }
 /**
@@ -4046,7 +5298,7 @@ export interface ElicitationRequestedData {
      * URL to open in the user's browser (url mode only)
      */
     url?: string;
-    [k: string]: unknown;
+    [k: string]: unknown | undefined;
 }
 /**
  * JSON Schema describing the form fields to present to the user (form mode only)
@@ -4056,7 +5308,7 @@ export interface ElicitationRequestedSchema {
      * Form field definitions, keyed by field name
      */
     properties: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * List of required field names
@@ -4067,12 +5319,18 @@ export interface ElicitationRequestedSchema {
      */
     type: "object";
 }
+/**
+ * Session event "elicitation.completed". Elicitation request completion with the user's response
+ */
 export interface ElicitationCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ElicitationCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4086,6 +5344,9 @@ export interface ElicitationCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "elicitation.completed".
+     */
     type: "elicitation.completed";
 }
 /**
@@ -4097,19 +5358,25 @@ export interface ElicitationCompletedData {
      * The submitted form data when action is 'accept'; keys match the requested schema fields
      */
     content?: {
-        [k: string]: ElicitationCompletedContent;
+        [k: string]: ElicitationCompletedContent | undefined;
     };
     /**
      * Request ID of the resolved elicitation request; clients should dismiss any UI for this request
      */
     requestId: string;
 }
+/**
+ * Session event "sampling.requested". Sampling request from an MCP server; contains the server name and a requestId for correlation
+ */
 export interface SamplingRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: SamplingRequestedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4123,6 +5390,9 @@ export interface SamplingRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "sampling.requested".
+     */
     type: "sampling.requested";
 }
 /**
@@ -4141,14 +5411,20 @@ export interface SamplingRequestedData {
      * Name of the MCP server that initiated the sampling request
      */
     serverName: string;
-    [k: string]: unknown;
+    [k: string]: unknown | undefined;
 }
+/**
+ * Session event "sampling.completed". Sampling request completion notification signaling UI dismissal
+ */
 export interface SamplingCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: SamplingCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4162,6 +5438,9 @@ export interface SamplingCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "sampling.completed".
+     */
     type: "sampling.completed";
 }
 /**
@@ -4173,12 +5452,18 @@ export interface SamplingCompletedData {
      */
     requestId: string;
 }
+/**
+ * Session event "mcp.oauth_required". OAuth authentication request for an MCP server
+ */
 export interface McpOauthRequiredEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: McpOauthRequiredData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4192,6 +5477,9 @@ export interface McpOauthRequiredEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "mcp.oauth_required".
+     */
     type: "mcp.oauth_required";
 }
 /**
@@ -4229,12 +5517,18 @@ export interface McpOauthRequiredStaticClientConfig {
      */
     publicClient?: boolean;
 }
+/**
+ * Session event "mcp.oauth_completed". MCP OAuth request completion notification
+ */
 export interface McpOauthCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: McpOauthCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4248,6 +5542,9 @@ export interface McpOauthCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "mcp.oauth_completed".
+     */
     type: "mcp.oauth_completed";
 }
 /**
@@ -4259,7 +5556,65 @@ export interface McpOauthCompletedData {
      */
     requestId: string;
 }
-export interface ExternalToolRequestedEvent {
+/**
+ * Session event "session.custom_notification". Opaque custom notification data. Consumers may branch on source and name, but payload semantics are source-defined.
+ */
+export interface CustomNotificationEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CustomNotificationData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.custom_notification".
+     */
+    type: "session.custom_notification";
+}
+/**
+ * Opaque custom notification data. Consumers may branch on source and name, but payload semantics are source-defined.
+ */
+export interface CustomNotificationData {
+    /**
+     * Source-defined custom notification name
+     */
+    name: string;
+    payload: CustomNotificationPayload;
+    /**
+     * Namespace for the custom notification producer
+     */
+    source: string;
+    subject?: CustomNotificationSubject;
+    /**
+     * Optional source-defined payload schema version
+     */
+    version?: number;
+}
+/**
+ * Optional source-defined string identifiers describing the payload subject
+ */
+export interface CustomNotificationSubject {
+    [k: string]: string | undefined;
+}
+/**
+ * Session event "external_tool.requested". External tool invocation request for client-side tool execution
+ */
+export interface ExternalToolRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
@@ -4281,6 +5636,9 @@ export interface ExternalToolRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "external_tool.requested".
+     */
     type: "external_tool.requested";
 }
 /**
@@ -4291,7 +5649,7 @@ export interface ExternalToolRequestedData {
      * Arguments to pass to the external tool
      */
     arguments?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Unique identifier for this request; used to respond via session.respondToExternalTool()
@@ -4317,13 +5675,23 @@ export interface ExternalToolRequestedData {
      * W3C Trace Context tracestate header for the execute_tool span
      */
     tracestate?: string;
+    /**
+     * Active session working directory, when known.
+     */
+    workingDirectory?: string;
 }
+/**
+ * Session event "external_tool.completed". External tool completion notification signaling UI dismissal
+ */
 export interface ExternalToolCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ExternalToolCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral?: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4337,6 +5705,9 @@ export interface ExternalToolCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "external_tool.completed".
+     */
     type: "external_tool.completed";
 }
 /**
@@ -4348,12 +5719,18 @@ export interface ExternalToolCompletedData {
      */
     requestId: string;
 }
+/**
+ * Session event "command.queued". Queued slash command dispatch request for client execution
+ */
 export interface CommandQueuedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: CommandQueuedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4367,6 +5744,9 @@ export interface CommandQueuedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "command.queued".
+     */
     type: "command.queued";
 }
 /**
@@ -4382,12 +5762,18 @@ export interface CommandQueuedData {
      */
     requestId: string;
 }
+/**
+ * Session event "command.execute". Registered command dispatch request routed to the owning client
+ */
 export interface CommandExecuteEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: CommandExecuteData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4401,6 +5787,9 @@ export interface CommandExecuteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "command.execute".
+     */
     type: "command.execute";
 }
 /**
@@ -4424,12 +5813,18 @@ export interface CommandExecuteData {
      */
     requestId: string;
 }
+/**
+ * Session event "command.completed". Queued command completion notification signaling UI dismissal
+ */
 export interface CommandCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: CommandCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4443,6 +5838,9 @@ export interface CommandCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "command.completed".
+     */
     type: "command.completed";
 }
 /**
@@ -4454,12 +5852,18 @@ export interface CommandCompletedData {
      */
     requestId: string;
 }
+/**
+ * Session event "auto_mode_switch.requested". Auto mode switch request notification requiring user approval
+ */
 export interface AutoModeSwitchRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AutoModeSwitchRequestedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4473,6 +5877,9 @@ export interface AutoModeSwitchRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "auto_mode_switch.requested".
+     */
     type: "auto_mode_switch.requested";
 }
 /**
@@ -4492,12 +5899,18 @@ export interface AutoModeSwitchRequestedData {
      */
     retryAfterSeconds?: number;
 }
+/**
+ * Session event "auto_mode_switch.completed". Auto mode switch completion notification
+ */
 export interface AutoModeSwitchCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: AutoModeSwitchCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4511,6 +5924,9 @@ export interface AutoModeSwitchCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "auto_mode_switch.completed".
+     */
     type: "auto_mode_switch.completed";
 }
 /**
@@ -4521,17 +5937,20 @@ export interface AutoModeSwitchCompletedData {
      * Request ID of the resolved request; clients should dismiss any UI for this request
      */
     requestId: string;
-    /**
-     * The user's choice: 'yes', 'yes_always', or 'no'
-     */
-    response: string;
+    response: AutoModeSwitchResponse;
 }
+/**
+ * Session event "commands.changed". SDK command registration change notification
+ */
 export interface CommandsChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: CommandsChangedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4545,6 +5964,9 @@ export interface CommandsChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "commands.changed".
+     */
     type: "commands.changed";
 }
 /**
@@ -4556,16 +5978,31 @@ export interface CommandsChangedData {
      */
     commands: CommandsChangedCommand[];
 }
+/**
+ * Schema for the `CommandsChangedCommand` type.
+ */
 export interface CommandsChangedCommand {
+    /**
+     * Optional human-readable command description.
+     */
     description?: string;
+    /**
+     * Slash command name without the leading slash.
+     */
     name: string;
 }
+/**
+ * Session event "capabilities.changed". Session capability change notification
+ */
 export interface CapabilitiesChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: CapabilitiesChangedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4579,6 +6016,9 @@ export interface CapabilitiesChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "capabilities.changed".
+     */
     type: "capabilities.changed";
 }
 /**
@@ -4591,17 +6031,31 @@ export interface CapabilitiesChangedData {
  * UI capability changes
  */
 export interface CapabilitiesChangedUI {
+    /**
+     * Whether canvas rendering is now supported
+     */
+    canvases?: boolean;
     /**
      * Whether elicitation is now supported
      */
     elicitation?: boolean;
+    /**
+     * Whether MCP Apps (SEP-1865) UI passthrough is now supported
+     */
+    mcpApps?: boolean;
 }
+/**
+ * Session event "exit_plan_mode.requested". Plan approval request with plan content and available user actions
+ */
 export interface ExitPlanModeRequestedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ExitPlanModeRequestedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4615,6 +6069,9 @@ export interface ExitPlanModeRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "exit_plan_mode.requested".
+     */
     type: "exit_plan_mode.requested";
 }
 /**
@@ -4622,17 +6079,14 @@ export interface ExitPlanModeRequestedEvent {
  */
 export interface ExitPlanModeRequestedData {
     /**
-     * Available actions the user can take (e.g., approve, edit, reject)
+     * Available actions the user can take
      */
-    actions: string[];
+    actions: ExitPlanModeAction[];
     /**
      * Full content of the plan file
      */
     planContent: string;
-    /**
-     * The recommended action for the user to take
-     */
-    recommendedAction: string;
+    recommendedAction: ExitPlanModeAction;
     /**
      * Unique identifier for this request; used to respond via session.respondToExitPlanMode()
      */
@@ -4642,12 +6096,18 @@ export interface ExitPlanModeRequestedData {
      */
     summary: string;
 }
+/**
+ * Session event "exit_plan_mode.completed". Plan mode exit completion with the user's approval decision and optional feedback
+ */
 export interface ExitPlanModeCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ExitPlanModeCompletedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4661,6 +6121,9 @@ export interface ExitPlanModeCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "exit_plan_mode.completed".
+     */
     type: "exit_plan_mode.completed";
 }
 /**
@@ -4683,17 +6146,20 @@ export interface ExitPlanModeCompletedData {
      * Request ID of the resolved exit plan mode request; clients should dismiss any UI for this request
      */
     requestId: string;
-    /**
-     * Which action the user selected (e.g. 'autopilot', 'interactive', 'exit_only')
-     */
-    selectedAction?: string;
+    selectedAction?: ExitPlanModeAction;
 }
+/**
+ * Session event "session.tools_updated".
+ */
 export interface ToolsUpdatedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ToolsUpdatedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4707,17 +6173,32 @@ export interface ToolsUpdatedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.tools_updated".
+     */
     type: "session.tools_updated";
 }
+/**
+ * Schema for the `ToolsUpdatedData` type.
+ */
 export interface ToolsUpdatedData {
+    /**
+     * Identifier of the model the resolved tools apply to.
+     */
     model: string;
 }
+/**
+ * Session event "session.background_tasks_changed".
+ */
 export interface BackgroundTasksChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: BackgroundTasksChangedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4731,16 +6212,28 @@ export interface BackgroundTasksChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.background_tasks_changed".
+     */
     type: "session.background_tasks_changed";
 }
+/**
+ * Schema for the `BackgroundTasksChangedData` type.
+ */
 export interface BackgroundTasksChangedData {
 }
+/**
+ * Session event "session.skills_loaded".
+ */
 export interface SkillsLoadedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: SkillsLoadedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4754,14 +6247,23 @@ export interface SkillsLoadedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.skills_loaded".
+     */
     type: "session.skills_loaded";
 }
+/**
+ * Schema for the `SkillsLoadedData` type.
+ */
 export interface SkillsLoadedData {
     /**
      * Array of resolved skill metadata
      */
     skills: SkillsLoadedSkill[];
 }
+/**
+ * Schema for the `SkillsLoadedSkill` type.
+ */
 export interface SkillsLoadedSkill {
     /**
      * Description of what the skill does
@@ -4779,21 +6281,24 @@ export interface SkillsLoadedSkill {
      * Absolute path to the skill file, if available
      */
     path?: string;
-    /**
-     * Source location type of the skill (e.g., project, personal, plugin)
-     */
-    source: string;
+    source: SkillSource;
     /**
      * Whether the skill can be invoked by the user as a slash command
      */
     userInvocable: boolean;
 }
+/**
+ * Session event "session.custom_agents_updated".
+ */
 export interface CustomAgentsUpdatedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: CustomAgentsUpdatedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4807,8 +6312,14 @@ export interface CustomAgentsUpdatedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.custom_agents_updated".
+     */
     type: "session.custom_agents_updated";
 }
+/**
+ * Schema for the `CustomAgentsUpdatedData` type.
+ */
 export interface CustomAgentsUpdatedData {
     /**
      * Array of loaded custom agent metadata
@@ -4823,6 +6334,9 @@ export interface CustomAgentsUpdatedData {
      */
     warnings: string[];
 }
+/**
+ * Schema for the `CustomAgentsUpdatedAgent` type.
+ */
 export interface CustomAgentsUpdatedAgent {
     /**
      * Description of what the agent does
@@ -4849,20 +6363,26 @@ export interface CustomAgentsUpdatedAgent {
      */
     source: string;
     /**
-     * List of tool names available to this agent
+     * List of tool names available to this agent, or null when all tools are available
      */
-    tools: string[];
+    tools: string[] | null;
     /**
      * Whether the agent can be selected by the user
      */
     userInvocable: boolean;
 }
+/**
+ * Session event "session.mcp_servers_loaded".
+ */
 export interface McpServersLoadedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: McpServersLoadedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4876,14 +6396,23 @@ export interface McpServersLoadedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.mcp_servers_loaded".
+     */
     type: "session.mcp_servers_loaded";
 }
+/**
+ * Schema for the `McpServersLoadedData` type.
+ */
 export interface McpServersLoadedData {
     /**
      * Array of MCP server status summaries
      */
     servers: McpServersLoadedServer[];
 }
+/**
+ * Schema for the `McpServersLoadedServer` type.
+ */
 export interface McpServersLoadedServer {
     /**
      * Error message if the server failed to connect
@@ -4894,17 +6423,29 @@ export interface McpServersLoadedServer {
      */
     name: string;
     /**
-     * Configuration source: user, workspace, plugin, or builtin
+     * Name of the plugin that supplied the effective MCP server config, only when source is plugin
      */
-    source?: string;
-    status: McpServersLoadedServerStatus;
+    pluginName?: string;
+    /**
+     * Version of the plugin that supplied the effective MCP server config, only when source is plugin
+     */
+    pluginVersion?: string;
+    source?: McpServerSource;
+    status: McpServerStatus;
+    transport?: McpServerTransport;
 }
+/**
+ * Session event "session.mcp_server_status_changed".
+ */
 export interface McpServerStatusChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: McpServerStatusChangedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4918,21 +6459,37 @@ export interface McpServerStatusChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.mcp_server_status_changed".
+     */
     type: "session.mcp_server_status_changed";
 }
+/**
+ * Schema for the `McpServerStatusChangedData` type.
+ */
 export interface McpServerStatusChangedData {
+    /**
+     * Error message if the server entered a failed state
+     */
+    error?: string;
     /**
      * Name of the MCP server whose status changed
      */
     serverName: string;
-    status: McpServerStatusChangedStatus;
+    status: McpServerStatus;
 }
+/**
+ * Session event "session.extensions_loaded".
+ */
 export interface ExtensionsLoadedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
     data: ExtensionsLoadedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
     ephemeral: true;
     /**
      * Unique event identifier (UUID v4), generated when the event is emitted
@@ -4946,14 +6503,23 @@ export interface ExtensionsLoadedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.extensions_loaded".
+     */
     type: "session.extensions_loaded";
 }
+/**
+ * Schema for the `ExtensionsLoadedData` type.
+ */
 export interface ExtensionsLoadedData {
     /**
      * Array of discovered extensions and their status
      */
     extensions: ExtensionsLoadedExtension[];
 }
+/**
+ * Schema for the `ExtensionsLoadedExtension` type.
+ */
 export interface ExtensionsLoadedExtension {
     /**
      * Source-qualified extension ID (e.g., 'project:my-ext', 'user:auth-helper')
@@ -4966,3 +6532,304 @@ export interface ExtensionsLoadedExtension {
     source: ExtensionsLoadedExtensionSource;
     status: ExtensionsLoadedExtensionStatus;
 }
+/**
+ * Session event "session.canvas.opened".
+ */
+export interface CanvasOpenedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CanvasOpenedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.canvas.opened".
+     */
+    type: "session.canvas.opened";
+}
+/**
+ * Schema for the `CanvasOpenedData` type.
+ */
+export interface CanvasOpenedData {
+    availability: CanvasOpenedAvailability;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Owning extension display name, when available
+     */
+    extensionName?: string;
+    /**
+     * Input supplied when the instance was opened
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Stable caller-supplied canvas instance identifier
+     */
+    instanceId: string;
+    /**
+     * Whether this notification represents an idempotent reopen
+     */
+    reopen: boolean;
+    /**
+     * Provider-supplied status text
+     */
+    status?: string;
+    /**
+     * Rendered title
+     */
+    title?: string;
+    /**
+     * URL for web-rendered canvases
+     */
+    url?: string;
+}
+/**
+ * Session event "session.canvas.registry_changed".
+ */
+export interface CanvasRegistryChangedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CanvasRegistryChangedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.canvas.registry_changed".
+     */
+    type: "session.canvas.registry_changed";
+}
+/**
+ * Schema for the `CanvasRegistryChangedData` type.
+ */
+export interface CanvasRegistryChangedData {
+    /**
+     * Canvas declarations currently available
+     */
+    canvases: CanvasRegistryChangedCanvas[];
+}
+/**
+ * Schema for the `CanvasRegistryChangedCanvas` type.
+ */
+export interface CanvasRegistryChangedCanvas {
+    /**
+     * Actions the agent or host may invoke
+     */
+    actions?: CanvasRegistryChangedCanvasAction[];
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Short, single-sentence description shown to the agent in canvas catalogs.
+     */
+    description: string;
+    /**
+     * Human-readable canvas name
+     */
+    displayName: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Owning extension display name, when available
+     */
+    extensionName?: string;
+    /**
+     * JSON Schema for canvas open input
+     */
+    inputSchema?: {
+        [k: string]: unknown | undefined;
+    };
+}
+/**
+ * Schema for the `CanvasRegistryChangedCanvasAction` type.
+ */
+export interface CanvasRegistryChangedCanvasAction {
+    /**
+     * Action description
+     */
+    description?: string;
+    /**
+     * JSON Schema for action input
+     */
+    inputSchema?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Action name
+     */
+    name: string;
+}
+/**
+ * Session event "session.extensions.attachments_pushed".
+ */
+export interface ExtensionsAttachmentsPushedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: ExtensionsAttachmentsPushedData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "session.extensions.attachments_pushed".
+     */
+    type: "session.extensions.attachments_pushed";
+}
+/**
+ * Schema for the `ExtensionsAttachmentsPushedData` type.
+ */
+export interface ExtensionsAttachmentsPushedData {
+    /**
+     * Attachments contributed by an extension; the host should surface these as composer pills and forward them via the next session.send call.
+     */
+    attachments: Attachment[];
+}
+/**
+ * Session event "mcp_app.tool_call_complete". MCP App view called a tool on a connected MCP server (SEP-1865)
+ */
+export interface McpAppToolCallCompleteEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: McpAppToolCallCompleteData;
+    /**
+     * Always true for events that are transient and not persisted to the session event log on disk.
+     */
+    ephemeral: true;
+    /**
+     * Unique event identifier (UUID v4), generated when the event is emitted
+     */
+    id: string;
+    /**
+     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     */
+    parentId: string | null;
+    /**
+     * ISO 8601 timestamp when the event was created
+     */
+    timestamp: string;
+    /**
+     * Type discriminator. Always "mcp_app.tool_call_complete".
+     */
+    type: "mcp_app.tool_call_complete";
+}
+/**
+ * MCP App view called a tool on a connected MCP server (SEP-1865)
+ */
+export interface McpAppToolCallCompleteData {
+    /**
+     * Arguments passed to the tool by the app view, if any
+     */
+    arguments?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Wall-clock duration of the underlying tools/call in milliseconds
+     */
+    durationMs: number;
+    error?: McpAppToolCallCompleteError;
+    /**
+     * Standard MCP CallToolResult returned by the server. Present whether or not the call set isError.
+     */
+    result?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Name of the MCP server hosting the tool
+     */
+    serverName: string;
+    /**
+     * True when the call completed without throwing AND the MCP CallToolResult did not set isError
+     */
+    success: boolean;
+    toolMeta?: McpAppToolCallCompleteToolMeta;
+    /**
+     * MCP tool name that was invoked
+     */
+    toolName: string;
+}
+/**
+ * Set when the underlying tools/call threw an error before returning a CallToolResult
+ */
+export interface McpAppToolCallCompleteError {
+    /**
+     * Human-readable error message
+     */
+    message: string;
+}
+/**
+ * The tool's `_meta.ui` block at the time of the call, so consumers can decide whether to forward the result to the model without re-listing tools.
+ */
+export interface McpAppToolCallCompleteToolMeta {
+    ui?: McpAppToolCallCompleteToolMetaUI;
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `McpAppToolCallCompleteToolMetaUI` type.
+ */
+export interface McpAppToolCallCompleteToolMetaUI {
+    /**
+     * `ui://` URI declared by the tool's `_meta.ui.resourceUri`
+     */
+    resourceUri?: string;
+    /**
+     * Tool visibility per SEP-1865 (typically a subset of `["model","app"]`)
+     */
+    visibility?: string[];
+    [k: string]: unknown | undefined;
+}