@github/copilot-sdk 0.3.0 → 1.0.0-beta.10

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

@@ -2,31 +2,106 @@
  * 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 | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantUsageEvent | 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 | 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";
+/**
+ * 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
  */
@@ -34,11 +109,53 @@ export type UserMessageAttachment = UserMessageAttachmentFile | UserMessageAttac
 /**
  * Type of GitHub reference
  */
-export type UserMessageAttachmentGithubReferenceType = "issue" | "pr" | "discussion";
+export type UserMessageAttachmentGithubReferenceType = 
+/** 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 = 
+/** 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
  */
@@ -46,80 +163,234 @@ 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
  */
-export type SystemNotification = SystemNotificationAgentCompleted | SystemNotificationAgentIdle | SystemNotificationNewInboxMessage | SystemNotificationShellCompleted | SystemNotificationShellDetachedCompleted;
+export type SystemNotification = SystemNotificationAgentCompleted | SystemNotificationAgentIdle | SystemNotificationNewInboxMessage | SystemNotificationShellCompleted | SystemNotificationShellDetachedCompleted | SystemNotificationInstructionDiscovered;
 /**
  * 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";
+export type PermissionPromptRequest = PermissionPromptRequestCommands | PermissionPromptRequestWrite | PermissionPromptRequestRead | PermissionPromptRequestMcp | PermissionPromptRequestUrl | PermissionPromptRequestMemory | PermissionPromptRequestCustomTool | PermissionPromptRequestPath | PermissionPromptRequestHook | PermissionPromptRequestExtensionManagement | PermissionPromptRequestExtensionPermissionAccess;
 /**
- * Vote direction (vote only)
+ * Underlying permission kind that needs path approval
  */
-export type PermissionPromptRequestMemoryDirection = "upvote" | "downvote";
+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";
 /**
- * Underlying permission kind that needs path approval
+ * The result of the permission request
  */
-export type PermissionPromptRequestPathAccessKind = "read" | "shell" | "write";
+export type PermissionResult = PermissionApproved | PermissionApprovedForSession | PermissionApprovedForLocation | PermissionCancelled | PermissionDeniedByRules | PermissionDeniedNoApprovalRuleAndCouldNotRequestFromUser | PermissionDeniedInteractivelyByUser | PermissionDeniedByContentExclusionPolicy | PermissionDeniedByPermissionRequestHook;
 /**
- * The outcome of the permission request
+ * The approval to add as a session-scoped rule
  */
-export type PermissionCompletedKind = "approved" | "approved-for-session" | "approved-for-location" | "denied-by-rules" | "denied-no-approval-rule-and-could-not-request-from-user" | "denied-interactively-by-user" | "denied-by-content-exclusion-policy" | "denied-by-permission-request-hook";
+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.
@@ -142,6 +413,9 @@ export interface StartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.start".
+     */
     type: "session.start";
 }
 /**
@@ -153,20 +427,31 @@ 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?: "default"
+    /** Extended context tier with a larger context window. */
+     | "long_context" | 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;
     /**
@@ -220,6 +505,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.
@@ -242,6 +530,9 @@ export interface ResumeEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.resume".
+     */
     type: "session.resume";
 }
 /**
@@ -253,16 +544,27 @@ export interface ResumeData {
      */
     alreadyInUse?: boolean;
     context?: WorkingDirectoryContext;
+    /**
+     * Context tier currently selected at resume time; null when no tier is active
+     */
+    contextTier?: "default"
+    /** Extended context tier with a larger context window. */
+     | "long_context" | 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.
+     */
+    continuePendingWork?: boolean;
     /**
      * Total number of persisted events in the session at the time of resume
      */
     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;
     /**
@@ -273,7 +575,14 @@ export interface ResumeData {
      * Model currently selected at resume time
      */
     selectedModel?: string;
+    /**
+     * True when this resume attached to a session that the runtime already had running in-memory (for example, an extension joining a session another client was actively driving). False (or omitted) for cold resumes — the runtime had to reconstitute the session from its persisted event log.
+     */
+    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.
@@ -296,17 +605,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.
@@ -329,12 +644,23 @@ export interface ErrorEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.error".
+     */
     type: "session.error";
 }
 /**
  * Error details for timeline display including message and optional diagnostic information
  */
 export interface ErrorData {
+    /**
+     * Only set on `errorType: "rate_limit"`. When `true`, the runtime will follow this error with an `auto_mode_switch.requested` event (or silently switch if `continueOnAutoMode` is enabled). UI clients can use this flag to suppress duplicate rendering of the rate-limit error when they show their own auto-mode-switch prompt.
+     */
+    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"`). For `errorType: "quota"`, this is the CAPI quota error code (e.g., `"quota_exceeded"`, `"session_quota_exceeded"`, `"billing_not_configured"`).
+     */
+    errorCode?: string;
     /**
      * Category of error (e.g., "authentication", "authorization", "quota", "rate_limit", "context_limit", "query")
      */
@@ -347,6 +673,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
      */
@@ -360,12 +690,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
@@ -379,6 +715,9 @@ export interface IdleEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.idle".
+     */
     type: "session.idle";
 }
 /**
@@ -390,12 +729,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
@@ -409,6 +754,9 @@ export interface TitleChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.title_changed".
+     */
     type: "session.title_changed";
 }
 /**
@@ -420,6 +768,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.
@@ -442,6 +928,9 @@ export interface InfoEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.info".
+     */
     type: "session.info";
 }
 /**
@@ -456,11 +945,18 @@ export interface InfoData {
      * Human-readable informational message for display in the timeline
      */
     message: string;
+    /**
+     * Optional actionable tip displayed with this message
+     */
+    tip?: string;
     /**
      * Optional URL associated with this message that the user can open in a browser
      */
     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.
@@ -483,6 +979,9 @@ export interface WarningEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.warning".
+     */
     type: "session.warning";
 }
 /**
@@ -502,6 +1001,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.
@@ -524,12 +1026,25 @@ export interface ModelChangeEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.model_change".
+     */
     type: "session.model_change";
 }
 /**
  * Model change details including previous and new model identifiers
  */
 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?: "default"
+    /** Extended context tier with a larger context window. */
+     | "long_context" | null;
     /**
      * Newly selected model identifier
      */
@@ -542,11 +1057,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.
@@ -569,21 +1089,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;
+    /**
+     * 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 {
     /**
-     * Agent mode after the change (e.g., "interactive", "plan", "autopilot")
+     * 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.
@@ -606,6 +1169,9 @@ export interface PlanChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.plan_changed".
+     */
     type: "session.plan_changed";
 }
 /**
@@ -614,6 +1180,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.
@@ -636,6 +1205,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";
 }
 /**
@@ -648,6 +1220,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.
@@ -670,6 +1245,9 @@ export interface HandoffEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.handoff".
+     */
     type: "session.handoff";
 }
 /**
@@ -716,6 +1294,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.
@@ -738,6 +1319,9 @@ export interface TruncationEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.truncation".
+     */
     type: "session.truncation";
 }
 /**
@@ -777,12 +1361,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
@@ -796,6 +1386,9 @@ export interface SnapshotRewindEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.snapshot_rewind".
+     */
     type: "session.snapshot_rewind";
 }
 /**
@@ -811,6 +1404,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.
@@ -833,6 +1429,9 @@ export interface ShutdownEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.shutdown".
+     */
     type: "session.shutdown";
 }
 /**
@@ -860,7 +1459,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
@@ -871,6 +1470,12 @@ export interface ShutdownData {
      * System message token count at shutdown
      */
     systemTokens?: number;
+    /**
+     * Session-wide per-token-type accumulated token counts
+     */
+    tokenDetails?: {
+        [k: string]: ShutdownTokenDetail | undefined;
+    };
     /**
      * Tool definitions token count at shutdown
      */
@@ -880,9 +1485,11 @@ export interface ShutdownData {
      */
     totalApiDurationMs: number;
     /**
-     * Total number of premium API requests used during the session
+     * Session-wide accumulated nano-AI units cost
+     *
+     * @experimental
      */
-    totalPremiumRequests: number;
+    totalNanoAiu?: number;
 }
 /**
  * Aggregate code change metrics for the session
@@ -901,8 +1508,23 @@ export interface ShutdownCodeChanges {
      */
     linesRemoved: number;
 }
+/**
+ * Schema for the `ShutdownModelMetric` type.
+ */
 export interface ShutdownModelMetric {
     requests: ShutdownModelMetricRequests;
+    /**
+     * Token count details per type
+     */
+    tokenDetails?: {
+        [k: string]: ShutdownModelMetricTokenDetail | undefined;
+    };
+    /**
+     * Accumulated nano-AI units cost for this model
+     *
+     * @experimental
+     */
+    totalNanoAiu?: number;
     usage: ShutdownModelMetricUsage;
 }
 /**
@@ -911,12 +1533,25 @@ 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
+     */
+    tokenCount: number;
 }
 /**
  * Token usage breakdown
@@ -943,8 +1578,20 @@ export interface ShutdownModelMetricUsage {
      */
     reasoningTokens?: number;
 }
-export interface ContextChangedEvent {
-    /**
+/**
+ * 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.
      */
     agentId?: string;
@@ -965,14 +1612,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
@@ -986,6 +1642,9 @@ export interface UsageInfoEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.usage_info".
+     */
     type: "session.usage_info";
 }
 /**
@@ -1021,6 +1680,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.
@@ -1043,6 +1705,9 @@ export interface CompactionStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.compaction_start".
+     */
     type: "session.compaction_start";
 }
 /**
@@ -1062,6 +1727,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.
@@ -1084,6 +1752,9 @@ export interface CompactionCompleteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.compaction_complete".
+     */
     type: "session.compaction_complete";
 }
 /**
@@ -1103,6 +1774,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
      */
@@ -1127,6 +1802,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
      */
@@ -1160,7 +1839,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
      */
@@ -1178,19 +1856,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-AIU (AI Units) for this request
-     */
-    totalNanoAiu: number;
-}
 /**
  * Token usage detail for a single billing category
  */
@@ -1212,6 +1877,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.
@@ -1234,6 +1902,9 @@ export interface TaskCompleteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "session.task_complete".
+     */
     type: "session.task_complete";
 }
 /**
@@ -1249,6 +1920,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.
@@ -1271,8 +1945,14 @@ 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;
     /**
@@ -1288,9 +1968,17 @@ 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[];
+    /**
+     * Parent agent task ID for background telemetry correlated to this user turn
+     */
+    parentAgentTaskId?: string;
     /**
      * Origin of this message, used for timeline filtering (e.g., "skill-pdf" for skill-injected messages that should be hidden from the user)
      */
@@ -1454,12 +2142,18 @@ export interface UserMessageAttachmentBlob {
      */
     type: "blob";
 }
+/**
+ * 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
@@ -1473,6 +2167,9 @@ export interface PendingMessagesModifiedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "pending_messages.modified".
+     */
     type: "pending_messages.modified";
 }
 /**
@@ -1480,6 +2177,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.
@@ -1502,6 +2202,9 @@ export interface AssistantTurnStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.turn_start".
+     */
     type: "assistant.turn_start";
 }
 /**
@@ -1517,12 +2220,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
@@ -1536,6 +2245,9 @@ export interface AssistantIntentEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.intent".
+     */
     type: "assistant.intent";
 }
 /**
@@ -1547,6 +2259,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.
@@ -1569,6 +2284,9 @@ export interface AssistantReasoningEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.reasoning".
+     */
     type: "assistant.reasoning";
 }
 /**
@@ -1584,12 +2302,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
@@ -1603,6 +2327,9 @@ export interface AssistantReasoningDeltaEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.reasoning_delta".
+     */
     type: "assistant.reasoning_delta";
 }
 /**
@@ -1618,12 +2345,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
@@ -1637,6 +2370,9 @@ export interface AssistantStreamingDeltaEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.streaming_delta".
+     */
     type: "assistant.streaming_delta";
 }
 /**
@@ -1648,6 +2384,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.
@@ -1670,12 +2409,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
      */
@@ -1692,6 +2446,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
      */
@@ -1717,10 +2475,18 @@ 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
      */
     toolRequests?: AssistantMessageToolRequest[];
+    /**
+     * Identifier for the agent loop turn that produced this message, matching the corresponding assistant.turn_start event
+     */
+    turnId?: string;
 }
 /**
  * A tool invocation request from the assistant
@@ -1730,7 +2496,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
@@ -1740,6 +2506,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
      */
@@ -1754,12 +2524,61 @@ 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
+     */
+    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 "assistant.message_start".
+     */
+    type: "assistant.message_start";
+}
+/**
+ * Streaming assistant message start metadata
+ */
+export interface AssistantMessageStartData {
+    /**
+     * Message ID this start event belongs to, matching subsequent deltas and assistant.message
+     */
+    messageId: string;
+    /**
+     * Generation phase this message belongs to for phased-output models
+     */
+    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
@@ -1773,6 +2592,9 @@ export interface AssistantMessageDeltaEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.message_delta".
+     */
     type: "assistant.message_delta";
 }
 /**
@@ -1793,6 +2615,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.
@@ -1815,6 +2640,9 @@ export interface AssistantTurnEndEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.turn_end".
+     */
     type: "assistant.turn_end";
 }
 /**
@@ -1826,12 +2654,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
@@ -1845,6 +2679,9 @@ export interface AssistantUsageEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "assistant.usage".
+     */
     type: "assistant.usage";
 }
 /**
@@ -1855,6 +2692,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
      */
@@ -1863,9 +2701,10 @@ export interface AssistantUsageData {
      * Number of tokens written to prompt cache
      */
     cacheWriteTokens?: number;
-    copilotUsage?: AssistantUsageCopilotUsage;
     /**
      * Model multiplier cost for billing purposes
+     *
+     * @experimental
      */
     cost?: number;
     /**
@@ -1902,13 +2741,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;
     /**
@@ -1916,22 +2749,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-AIU (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
@@ -1954,40 +2778,77 @@ export interface AssistantUsageCopilotUsageTokenDetail {
      */
     tokenType: string;
 }
-export interface AssistantUsageQuotaSnapshot {
+/**
+ * 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
+     */
+    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 "model.call_failure".
+     */
+    type: "model.call_failure";
+}
+/**
+ * Failed LLM API call metadata for telemetry
+ */
+export interface ModelCallFailureData {
     /**
-     * Total requests allowed by the entitlement
+     * Completion ID from the model provider (e.g., chatcmpl-abc123)
      */
-    entitlementRequests: number;
+    apiCallId?: string;
     /**
-     * Whether the user has an unlimited usage entitlement
+     * Duration of the failed API call in milliseconds
      */
-    isUnlimitedEntitlement: boolean;
+    durationMs?: number;
     /**
-     * Number of requests over the entitlement limit
+     * Raw provider/runtime error message for restricted telemetry
      */
-    overage: number;
+    errorMessage?: string;
     /**
-     * Whether overage is allowed when quota is exhausted
+     * What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls
      */
-    overageAllowedWithExhaustedQuota: boolean;
+    initiator?: string;
     /**
-     * Percentage of quota remaining (0.0 to 1.0)
+     * Model identifier used for the failed API call
      */
-    remainingPercentage: number;
+    model?: string;
     /**
-     * Date when the quota resets
+     * GitHub request tracing ID (x-github-request-id header) for server-side log correlation
      */
-    resetDate?: string;
+    providerCallId?: string;
     /**
-     * Whether usage is still permitted after quota exhaustion
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
      */
-    usageAllowedWithExhaustedQuota: boolean;
+    serviceRequestId?: string;
+    source: ModelCallFailureSource;
     /**
-     * Number of requests already consumed
+     * HTTP status code from the failed request
      */
-    usedRequests: number;
+    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.
@@ -2010,17 +2871,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.
@@ -2043,6 +2907,9 @@ export interface ToolUserRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.user_requested".
+     */
     type: "tool.user_requested";
 }
 /**
@@ -2053,7 +2920,7 @@ export interface ToolUserRequestedData {
      * Arguments for the tool invocation
      */
     arguments?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Unique identifier for this tool call
@@ -2064,6 +2931,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.
@@ -2086,6 +2956,9 @@ export interface ToolExecutionStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_start".
+     */
     type: "tool.execution_start";
 }
 /**
@@ -2096,8 +2969,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
      */
@@ -2119,13 +2996,23 @@ export interface ToolExecutionStartData {
      * Name of the tool being executed
      */
     toolName: string;
+    /**
+     * Identifier for the agent loop turn this tool was invoked in, matching the corresponding assistant.turn_start event
+     */
+    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
@@ -2139,6 +3026,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";
 }
 /**
@@ -2154,12 +3044,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
@@ -2173,6 +3069,9 @@ export interface ToolExecutionProgressEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_progress".
+     */
     type: "tool.execution_progress";
 }
 /**
@@ -2188,6 +3087,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.
@@ -2210,6 +3112,9 @@ export interface ToolExecutionCompleteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "tool.execution_complete".
+     */
     type: "tool.execution_complete";
 }
 /**
@@ -2235,6 +3140,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
      */
@@ -2243,12 +3152,17 @@ 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
+     */
+    turnId?: string;
 }
 /**
  * Error details when the tool execution failed
@@ -2279,6 +3193,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
@@ -2413,6 +3328,9 @@ export interface ToolExecutionCompleteContentResource {
      */
     type: "resource";
 }
+/**
+ * Schema for the `EmbeddedTextResourceContents` type.
+ */
 export interface EmbeddedTextResourceContents {
     /**
      * MIME type of the text content
@@ -2427,6 +3345,9 @@ export interface EmbeddedTextResourceContents {
      */
     uri: string;
 }
+/**
+ * Schema for the `EmbeddedBlobResourceContents` type.
+ */
 export interface EmbeddedBlobResourceContents {
     /**
      * Base64-encoded binary content of the resource
@@ -2441,29 +3362,147 @@ export interface EmbeddedBlobResourceContents {
      */
     uri: string;
 }
-export interface SkillInvokedEvent {
-    /**
-     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
-     */
-    agentId?: string;
-    data: SkillInvokedData;
+/**
+ * MCP Apps UI resource content for rendering in a sandboxed iframe
+ */
+export interface ToolExecutionCompleteUIResource {
+    _meta?: ToolExecutionCompleteUIResourceMeta;
     /**
-     * When true, the event is transient and not persisted to the session event log on disk
+     * Base64-encoded HTML content
      */
-    ephemeral?: boolean;
+    blob?: string;
     /**
-     * Unique event identifier (UUID v4), generated when the event is emitted
+     * MIME type of the content
      */
-    id: string;
+    mimeType: string;
     /**
-     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     * HTML content as a string
      */
-    parentId: string | null;
+    text?: string;
     /**
-     * ISO 8601 timestamp when the event was created
+     * The ui:// URI of the resource
      */
-    timestamp: string;
-    type: "skill.invoked";
+    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.
+     */
+    agentId?: string;
+    data: SkillInvokedData;
+    /**
+     * 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 "skill.invoked".
+     */
+    type: "skill.invoked";
 }
 /**
  * Skill invocation details including content, allowed tools, and plugin metadata
@@ -2497,7 +3536,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.
@@ -2520,6 +3567,9 @@ export interface SubagentStartedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.started".
+     */
     type: "subagent.started";
 }
 /**
@@ -2538,11 +3588,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.
@@ -2565,6 +3622,9 @@ export interface SubagentCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.completed".
+     */
     type: "subagent.completed";
 }
 /**
@@ -2600,6 +3660,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.
@@ -2622,6 +3685,9 @@ export interface SubagentFailedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.failed".
+     */
     type: "subagent.failed";
 }
 /**
@@ -2661,6 +3727,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.
@@ -2683,6 +3752,9 @@ export interface SubagentSelectedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.selected".
+     */
     type: "subagent.selected";
 }
 /**
@@ -2702,6 +3774,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.
@@ -2724,6 +3799,9 @@ export interface SubagentDeselectedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "subagent.deselected".
+     */
     type: "subagent.deselected";
 }
 /**
@@ -2731,6 +3809,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.
@@ -2753,6 +3834,9 @@ export interface HookStartEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "hook.start".
+     */
     type: "hook.start";
 }
 /**
@@ -2771,9 +3855,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.
@@ -2796,6 +3883,9 @@ export interface HookEndEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "hook.end".
+     */
     type: "hook.end";
 }
 /**
@@ -2815,7 +3905,7 @@ export interface HookEndData {
      * Output data produced by the hook
      */
     output?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Whether the hook completed successfully
@@ -2835,6 +3925,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.
@@ -2857,6 +3989,9 @@ export interface SystemMessageEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "system.message".
+     */
     type: "system.message";
 }
 /**
@@ -2886,9 +4021,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.
@@ -2911,6 +4049,9 @@ export interface SystemNotificationEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "system.notification".
+     */
     type: "system.notification";
 }
 /**
@@ -2923,6 +4064,9 @@ export interface SystemNotificationData {
     content: string;
     kind: SystemNotification;
 }
+/**
+ * Schema for the `SystemNotificationAgentCompleted` type.
+ */
 export interface SystemNotificationAgentCompleted {
     /**
      * Unique identifier of the background agent
@@ -2941,8 +4085,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
@@ -2956,8 +4106,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
@@ -2968,15 +4124,21 @@ export interface SystemNotificationNewInboxMessage {
      */
     senderName: string;
     /**
-     * Category of the sender (e.g., ambient-agent, plugin, hook)
+     * Category of the sender (e.g., sidekick-agent, plugin, hook)
      */
     senderType: string;
     /**
      * 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
@@ -2990,8 +4152,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
@@ -3001,15 +4169,49 @@ 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/')
+     */
+    description?: string;
+    /**
+     * Relative path to the discovered instruction file
+     */
+    sourcePath: string;
+    /**
+     * Path of the file access that triggered discovery
+     */
+    triggerFile: string;
+    /**
+     * 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.
      */
     agentId?: string;
     data: PermissionRequestedData;
-    ephemeral: true;
+    /**
+     * 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
      */
@@ -3022,6 +4224,9 @@ export interface PermissionRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "permission.requested".
+     */
     type: "permission.requested";
 }
 /**
@@ -3084,6 +4289,9 @@ export interface PermissionRequestShell {
      */
     warning?: string;
 }
+/**
+ * Schema for the `PermissionRequestShellCommand` type.
+ */
 export interface PermissionRequestShellCommand {
     /**
      * Command identifier (e.g., executable name)
@@ -3094,6 +4302,9 @@ export interface PermissionRequestShellCommand {
      */
     readOnly: boolean;
 }
+/**
+ * Schema for the `PermissionRequestShellPossibleUrl` type.
+ */
 export interface PermissionRequestShellPossibleUrl {
     /**
      * URL that may be accessed by the command
@@ -3162,7 +4373,7 @@ export interface PermissionRequestMcp {
      * Arguments to pass to the MCP tool
      */
     args?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Permission kind discriminator
@@ -3249,7 +4460,7 @@ export interface PermissionRequestCustomTool {
      * Arguments to pass to the custom tool
      */
     args?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Permission kind discriminator
@@ -3284,7 +4495,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
@@ -3295,6 +4506,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
  */
@@ -3433,12 +4686,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
      */
@@ -3468,7 +4721,7 @@ export interface PermissionPromptRequestCustomTool {
      * Arguments to pass to the custom tool
      */
     args?: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * Prompt kind discriminator
@@ -3521,7 +4774,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
@@ -3532,54 +4785,333 @@ export interface PermissionPromptRequestHook {
      */
     toolName: string;
 }
-export interface PermissionCompletedEvent {
+/**
+ * Extension management permission prompt
+ */
+export interface PermissionPromptRequestExtensionManagement {
     /**
-     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     * Name of the extension being managed
      */
-    agentId?: string;
-    data: PermissionCompletedData;
-    ephemeral: true;
+    extensionName?: string;
     /**
-     * Unique event identifier (UUID v4), generated when the event is emitted
+     * Prompt kind discriminator
      */
-    id: string;
+    kind: "extension-management";
     /**
-     * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event.
+     * The extension management operation (scaffold, reload)
      */
-    parentId: string | null;
+    operation: string;
     /**
-     * ISO 8601 timestamp when the event was created
+     * Tool call ID that triggered this permission request
      */
-    timestamp: string;
-    type: "permission.completed";
+    toolCallId?: string;
 }
 /**
- * Permission request completion notification signaling UI dismissal
+ * Extension permission access prompt
  */
-export interface PermissionCompletedData {
+export interface PermissionPromptRequestExtensionPermissionAccess {
     /**
-     * Request ID of the resolved permission request; clients should dismiss any UI for this request
+     * Capabilities the extension is requesting
      */
-    requestId: string;
-    result: PermissionCompletedResult;
+    capabilities: string[];
     /**
-     * Optional tool call ID associated with this permission prompt; clients may use it to correlate UI created from tool-scoped prompts
+     * 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;
 }
 /**
- * The result of the permission request
+ * Session event "permission.completed". Permission request completion notification signaling UI dismissal
  */
-export interface PermissionCompletedResult {
-    kind: PermissionCompletedKind;
-}
-export interface UserInputRequestedEvent {
+export interface PermissionCompletedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
     agentId?: string;
-    data: UserInputRequestedData;
-    ephemeral: true;
+    data: PermissionCompletedData;
+    /**
+     * 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 "permission.completed".
+     */
+    type: "permission.completed";
+}
+/**
+ * Permission request completion notification signaling UI dismissal
+ */
+export interface PermissionCompletedData {
+    /**
+     * Request ID of the resolved permission request; clients should dismiss any UI for this request
+     */
+    requestId: string;
+    result: PermissionResult;
+    /**
+     * Optional tool call ID associated with this permission prompt; clients may use it to correlate UI created from tool-scoped prompts
+     */
+    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;
+    /**
+     * Approved and remembered for the rest of the session
+     */
+    kind: "approved-for-session";
+}
+/**
+ * Schema for the `UserToolSessionApprovalCommands` type.
+ */
+export interface UserToolSessionApprovalCommands {
+    /**
+     * Command identifiers approved by the user
+     */
+    commandIdentifiers: string[];
+    /**
+     * Command approval kind
+     */
+    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
+     */
+    kind: "mcp";
+    /**
+     * MCP server name
+     */
+    serverName: string;
+    /**
+     * Optional MCP tool name, or null for all tools on the server
+     */
+    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
+     */
+    kind: "custom-tool";
+    /**
+     * Custom tool name
+     */
+    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;
+    /**
+     * Approved and persisted for this project location
+     */
+    kind: "approved-for-location";
+    /**
+     * The location key (git root or cwd) to persist the approval to
+     */
+    locationKey: string;
+}
+/**
+ * Schema for the `PermissionCancelled` type.
+ */
+export interface PermissionCancelled {
+    /**
+     * The permission request was cancelled before a response was used
+     */
+    kind: "cancelled";
+    /**
+     * Optional explanation of why the request was cancelled
+     */
+    reason?: string;
+}
+/**
+ * Schema for the `PermissionDeniedByRules` type.
+ */
+export interface PermissionDeniedByRules {
+    /**
+     * Denied because approval rules explicitly blocked it
+     */
+    kind: "denied-by-rules";
+    /**
+     * Rules that denied the request
+     */
+    rules: PermissionRule[];
+}
+/**
+ * Schema for the `PermissionRule` type.
+ */
+export interface PermissionRule {
+    /**
+     * Argument value matched against the request, or null when the rule kind has no argument (e.g. 'read', 'write', 'memory').
+     */
+    argument: string | null;
+    /**
+     * The rule kind, such as Shell or GitHubMCP
+     */
+    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
+     */
+    feedback?: string;
+    /**
+     * Whether to force-reject the current agent turn
+     */
+    forceReject?: boolean;
+    /**
+     * Denied by the user during an interactive prompt
+     */
+    kind: "denied-interactively-by-user";
+}
+/**
+ * Schema for the `PermissionDeniedByContentExclusionPolicy` type.
+ */
+export interface PermissionDeniedByContentExclusionPolicy {
+    /**
+     * Denied by the organization's content exclusion policy
+     */
+    kind: "denied-by-content-exclusion-policy";
+    /**
+     * Human-readable explanation of why the path was excluded
+     */
+    message: string;
+    /**
+     * File path that triggered the exclusion
+     */
+    path: string;
+}
+/**
+ * Schema for the `PermissionDeniedByPermissionRequestHook` type.
+ */
+export interface PermissionDeniedByPermissionRequestHook {
+    /**
+     * Whether to interrupt the current agent turn
+     */
+    interrupt?: boolean;
+    /**
+     * Denied by a permission request hook registered by an extension or plugin
+     */
+    kind: "denied-by-permission-request-hook";
+    /**
+     * Optional message from the hook explaining the denial
+     */
+    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
      */
@@ -3592,6 +5124,9 @@ export interface UserInputRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "user_input.requested".
+     */
     type: "user_input.requested";
 }
 /**
@@ -3619,12 +5154,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
@@ -3638,6 +5179,9 @@ export interface UserInputCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "user_input.completed".
+     */
     type: "user_input.completed";
 }
 /**
@@ -3657,12 +5201,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
@@ -3676,6 +5226,9 @@ export interface ElicitationRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "elicitation.requested".
+     */
     type: "elicitation.requested";
 }
 /**
@@ -3704,7 +5257,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)
@@ -3714,7 +5267,7 @@ export interface ElicitationRequestedSchema {
      * Form field definitions, keyed by field name
      */
     properties: {
-        [k: string]: unknown;
+        [k: string]: unknown | undefined;
     };
     /**
      * List of required field names
@@ -3725,12 +5278,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
@@ -3744,6 +5303,9 @@ export interface ElicitationCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "elicitation.completed".
+     */
     type: "elicitation.completed";
 }
 /**
@@ -3755,19 +5317,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
@@ -3781,6 +5349,9 @@ export interface SamplingRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "sampling.requested".
+     */
     type: "sampling.requested";
 }
 /**
@@ -3799,14 +5370,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
@@ -3820,6 +5397,9 @@ export interface SamplingCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "sampling.completed".
+     */
     type: "sampling.completed";
 }
 /**
@@ -3831,12 +5411,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
@@ -3850,6 +5436,9 @@ export interface McpOauthRequiredEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "mcp.oauth_required".
+     */
     type: "mcp.oauth_required";
 }
 /**
@@ -3878,17 +5467,27 @@ export interface McpOauthRequiredStaticClientConfig {
      * OAuth client ID for the server
      */
     clientId: string;
+    /**
+     * Optional non-default OAuth grant type. When set to 'client_credentials', the OAuth flow runs headlessly using the client_id + keychain-stored secret (no browser, no callback server).
+     */
+    grantType?: "client_credentials";
     /**
      * Whether this is a public OAuth client
      */
     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
@@ -3902,6 +5501,9 @@ export interface McpOauthCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "mcp.oauth_completed".
+     */
     type: "mcp.oauth_completed";
 }
 /**
@@ -3913,12 +5515,18 @@ 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: ExternalToolRequestedData;
+    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
@@ -3932,31 +5540,89 @@ export interface ExternalToolRequestedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
-    type: "external_tool.requested";
+    /**
+     * Type discriminator. Always "session.custom_notification".
+     */
+    type: "session.custom_notification";
 }
 /**
- * External tool invocation request for client-side tool execution
+ * Opaque custom notification data. Consumers may branch on source and name, but payload semantics are source-defined.
  */
-export interface ExternalToolRequestedData {
+export interface CustomNotificationData {
     /**
-     * Arguments to pass to the external tool
+     * Source-defined custom notification name
      */
-    arguments?: {
-        [k: string]: unknown;
-    };
+    name: string;
+    payload: CustomNotificationPayload;
     /**
-     * Unique identifier for this request; used to respond via session.respondToExternalTool()
+     * Namespace for the custom notification producer
      */
-    requestId: string;
+    source: string;
+    subject?: CustomNotificationSubject;
     /**
-     * Session ID that this external tool request belongs to
+     * Optional source-defined payload schema version
      */
-    sessionId: string;
+    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 {
     /**
-     * Tool call ID assigned to this external tool invocation
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
      */
-    toolCallId: string;
-    /**
+    agentId?: string;
+    data: ExternalToolRequestedData;
+    /**
+     * 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 "external_tool.requested".
+     */
+    type: "external_tool.requested";
+}
+/**
+ * External tool invocation request for client-side tool execution
+ */
+export interface ExternalToolRequestedData {
+    /**
+     * Arguments to pass to the external tool
+     */
+    arguments?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Unique identifier for this request; used to respond via session.respondToExternalTool()
+     */
+    requestId: string;
+    /**
+     * Session ID that this external tool request belongs to
+     */
+    sessionId: string;
+    /**
+     * Tool call ID assigned to this external tool invocation
+     */
+    toolCallId: string;
+    /**
      * Name of the external tool to invoke
      */
     toolName: string;
@@ -3968,14 +5634,24 @@ 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;
-    ephemeral: true;
+    /**
+     * 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
      */
@@ -3988,6 +5664,9 @@ export interface ExternalToolCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "external_tool.completed".
+     */
     type: "external_tool.completed";
 }
 /**
@@ -3999,12 +5678,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
@@ -4018,6 +5703,9 @@ export interface CommandQueuedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "command.queued".
+     */
     type: "command.queued";
 }
 /**
@@ -4033,12 +5721,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
@@ -4052,6 +5746,9 @@ export interface CommandExecuteEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "command.execute".
+     */
     type: "command.execute";
 }
 /**
@@ -4075,12 +5772,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
@@ -4094,6 +5797,9 @@ export interface CommandCompletedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "command.completed".
+     */
     type: "command.completed";
 }
 /**
@@ -4105,12 +5811,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
@@ -4124,6 +5836,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";
 }
 /**
@@ -4138,13 +5853,23 @@ export interface AutoModeSwitchRequestedData {
      * Unique identifier for this request; used to respond via session.respondToAutoModeSwitch()
      */
     requestId: string;
+    /**
+     * Seconds until the rate limit resets, when known. Lets clients render a humanized reset time alongside the prompt.
+     */
+    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
@@ -4158,6 +5883,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";
 }
 /**
@@ -4168,17 +5896,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
@@ -4192,6 +5923,9 @@ export interface CommandsChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "commands.changed".
+     */
     type: "commands.changed";
 }
 /**
@@ -4203,16 +5937,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
@@ -4226,6 +5975,9 @@ export interface CapabilitiesChangedEvent {
      * ISO 8601 timestamp when the event was created
      */
     timestamp: string;
+    /**
+     * Type discriminator. Always "capabilities.changed".
+     */
     type: "capabilities.changed";
 }
 /**
@@ -4238,17 +5990,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
@@ -4262,6 +6028,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";
 }
 /**
@@ -4269,17 +6038,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()
      */
@@ -4289,12 +6055,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
@@ -4308,6 +6080,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";
 }
 /**
@@ -4330,17 +6105,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
@@ -4354,17 +6132,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
@@ -4378,16 +6171,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
@@ -4401,14 +6206,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
@@ -4426,21 +6240,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
@@ -4454,8 +6271,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
@@ -4470,6 +6293,9 @@ export interface CustomAgentsUpdatedData {
      */
     warnings: string[];
 }
+/**
+ * Schema for the `CustomAgentsUpdatedAgent` type.
+ */
 export interface CustomAgentsUpdatedAgent {
     /**
      * Description of what the agent does
@@ -4496,20 +6322,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
@@ -4523,14 +6355,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
@@ -4541,17 +6382,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
@@ -4565,21 +6418,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
@@ -4593,14 +6462,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')
@@ -4613,3 +6491,265 @@ 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 "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;
+}