@github/copilot-sdk 1.0.2 → 1.0.4

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

@@ -5,7 +5,7 @@
 /**
  * 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 | TodosChangedEvent | 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 | BinaryAssetEvent | 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 | CanvasClosedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
+export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | ScheduleRearmedEvent | AutopilotObjectiveChangedEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PermissionsChangedEvent | PlanChangedEvent | TodosChangedEvent | 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 | BinaryAssetEvent | 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 | CanvasClosedEvent | CanvasUnavailableEvent | CanvasRecordedEvent | CanvasRemovedEvent | ExtensionsAttachmentsPushedEvent | McpAppToolCallCompleteEvent;
 /**
  * Hosting platform type of the repository (github or ado)
  */
@@ -114,6 +114,14 @@ export type UserMessageAgentMode =
  * A user message attachment — a file, directory, code selection, blob, GitHub reference, or extension-supplied context payload
  */
 export type Attachment = AttachmentFile | AttachmentDirectory | AttachmentSelection | AttachmentGitHubReference | AttachmentBlob | AttachmentExtensionContext;
+/**
+ * Why the binary data is absent: it exceeded the inline size limit, or its asset was unavailable
+ */
+export type OmittedBinaryOmittedReason = 
+/** Bytes exceeded the session's inline size limit. */
+"too_large"
+/** The referenced binary asset could not be found (e.g. a truncated log). */
+ | "asset_unavailable";
 /**
  * Type of GitHub reference
  */
@@ -124,6 +132,22 @@ export type AttachmentGitHubReferenceType =
  | "pr"
 /** GitHub discussion reference. */
  | "discussion";
+/**
+ * The system that produced a citation.
+ */
+/** @experimental */
+export type CitationProvider = 
+/** Citation produced by an Anthropic (Claude) model response. */
+"anthropic"
+/** Citation produced by an OpenAI model response. */
+ | "openai"
+/** Citation synthesized client-side by the runtime from tool output. */
+ | "client";
+/**
+ * Location within a cited source (character, page, or content-block range) that supports a span.
+ */
+/** @experimental */
+export type CitationLocation = CitationLocationChar | CitationLocationPage | CitationLocationBlock;
 /**
  * Tool call type: "function" for standard tool calls, "custom" for grammar-based tool calls. Defaults to "function" when absent.
  */
@@ -144,6 +168,14 @@ export type AssistantUsageApiEndpoint =
  | "/responses"
 /** WebSocket Responses API endpoint. */
  | "ws:/responses";
+/**
+ * For HTTP 400 failures only: whether the response carried a structured CAPI error envelope (structured_error, a deterministic validation failure) or no error body (bodyless, the transient gateway/proxy signature). Absent for non-400 failures.
+ */
+export type ModelCallFailureBadRequestKind = 
+/** The 400 response carried no error body (transient gateway/proxy signature). */
+"bodyless"
+/** The 400 response carried a structured CAPI error envelope (deterministic validation failure). */
+ | "structured_error";
 /**
  * Where the failed model call originated
  */
@@ -185,14 +217,6 @@ export type PersistedBinaryImageType =
 "image"
 /** Other binary resource data. */
  | "resource";
-/**
- * Why the binary data is absent: it exceeded the inline size limit, or its asset was unavailable
- */
-export type OmittedBinaryOmittedReason = 
-/** Bytes exceeded the session's inline size limit. */
-"too_large"
-/** The referenced binary asset could not be found (e.g. a truncated log). */
- | "asset_unavailable";
 /**
  * Binary result type discriminator. Use "image" for images and "resource" for other binary data.
  */
@@ -332,15 +356,13 @@ export type ElicitationCompletedAction =
 /** 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
+ * How the pending MCP OAuth request was completed
  */
-export type CustomNotificationPayload = string | number | boolean | null | unknown[] | {
-    [k: string]: unknown | undefined;
-};
+export type McpOauthCompletionOutcome = 
+/** The request completed with a token-backed OAuth provider. */
+"token"
+/** The request completed without an OAuth provider. */
+ | "cancelled";
 /**
  * The user's auto-mode-switch choice
  */
@@ -445,14 +467,6 @@ export type ExtensionsLoadedExtensionStatus =
  | "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
  */
@@ -895,6 +909,10 @@ export interface ScheduleCreatedData {
      * Whether the schedule re-arms after each tick (`/every`) or fires once (`/after`)
      */
     recurring?: boolean;
+    /**
+     * True for a self-paced (`dynamic`) schedule: no fixed cadence; the model arms each next run via the `manage_schedule` `wakeup` action. `nextRunAt` is model-controlled rather than auto-computed.
+     */
+    selfPaced?: boolean;
     /**
      * IANA timezone the `cron` expression is evaluated in
      */
@@ -939,6 +957,49 @@ export interface ScheduleCancelledData {
      */
     id: number;
 }
+/**
+ * Session event "session.schedule_rearmed". Self-paced schedule re-armed for its next run
+ */
+export interface ScheduleRearmedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: ScheduleRearmedData;
+    /**
+     * 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_rearmed".
+     */
+    type: "session.schedule_rearmed";
+}
+/**
+ * Self-paced schedule re-armed for its next run
+ */
+export interface ScheduleRearmedData {
+    /**
+     * Id of the self-paced schedule that was re-armed
+     */
+    id: number;
+    /**
+     * Absolute time (epoch milliseconds) the model armed the next run to fire
+     */
+    nextRunAt: number;
+}
 /**
  * Session event "session.autopilot_objective_changed". Autopilot objective state file operation details indicating what changed
  */
@@ -1920,6 +1981,10 @@ export interface CompactionCompleteData {
      * Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call
      */
     serviceRequestId?: string;
+    /**
+     * For failed compaction only: the HTTP status code of the compaction LLM call failure, when it carried one. Absent for successful compaction and for failures without an HTTP status (e.g. an empty model response or a transport error).
+     */
+    statusCode?: number;
     /**
      * Whether compaction completed successfully
      */
@@ -2110,15 +2175,32 @@ export interface UserMessageData {
  * File attachment
  */
 export interface AttachmentFile {
+    /**
+     * Internal: content-addressed id of the session.binary_asset event holding this attachment's model-facing bytes (e.g. "sha256:..."). Absent externally.
+     */
+    assetId?: string;
+    /**
+     * Internal: decoded byte length of the attachment's model-facing bytes. Absent externally.
+     */
+    byteLength?: number;
     /**
      * User-facing display name for the attachment
      */
     displayName: string;
     lineRange?: AttachmentFileLineRange;
+    /**
+     * Internal: MIME type of the file's model-facing bytes (post-resize for images). Set when the file's bytes are interned to an asset. Absent externally.
+     */
+    mimeType?: string;
+    omittedReason?: OmittedBinaryOmittedReason;
     /**
      * Absolute file path
      */
     path: string;
+    /**
+     * Frozen rendered line this attachment contributed to the <tagged_files> prompt block (e.g. "* /path (123 lines)"). Captured at send time so resumed history reproduces the exact text the model saw, independent of later filesystem changes. Present only for attachments routed to <tagged_files> (mutually exclusive with assetId, which marks bytes sent natively).
+     */
+    taggedFilesEntry?: string;
     /**
      * Attachment type discriminator
      */
@@ -2149,6 +2231,10 @@ export interface AttachmentDirectory {
      * Absolute directory path
      */
     path: string;
+    /**
+     * Frozen rendered line this attachment contributed to the <tagged_files> prompt block (e.g. "* /path (12 items)"). Captured at send time so resumed history reproduces the exact text the model saw, independent of later filesystem changes.
+     */
+    taggedFilesEntry?: string;
     /**
      * Attachment type discriminator
      */
@@ -2240,9 +2326,17 @@ export interface AttachmentGitHubReference {
  */
 export interface AttachmentBlob {
     /**
-     * Base64-encoded content
+     * Internal: content-addressed id of the session.binary_asset event holding this attachment's model-facing bytes (e.g. "sha256:..."). Absent externally.
      */
-    data: string;
+    assetId?: string;
+    /**
+     * Internal: decoded byte length of the attachment's model-facing bytes. Absent externally.
+     */
+    byteLength?: number;
+    /**
+     * Base64-encoded content. Present on input and for external consumers; replaced by an internal `assetId` reference in persisted events when interned to a content-addressed asset.
+     */
+    data?: string;
     /**
      * User-facing display name for the attachment
      */
@@ -2251,6 +2345,7 @@ export interface AttachmentBlob {
      * MIME type of the inline data
      */
     mimeType: string;
+    omittedReason?: OmittedBinaryOmittedReason;
     /**
      * Attachment type discriminator
      */
@@ -2571,6 +2666,12 @@ export interface AssistantMessageData {
      * Provider's completion / response identifier; shared across all chunks of a single API call. Used to group multi-chunk assistant utterances.
      */
     apiCallId?: string;
+    /**
+     * Provider-agnostic citations linking spans of this message's content to the sources that support them. Experimental; only populated when citation emission is enabled.
+     *
+     * @experimental
+     */
+    citations?: Citations;
     /**
      * The assistant's text response content
      */
@@ -2630,6 +2731,136 @@ export interface AssistantMessageData {
      */
     turnId?: string;
 }
+/**
+ * Provider-agnostic citations linking spans of the assistant's response to their supporting sources.
+ */
+/** @experimental */
+export interface Citations {
+    /**
+     * Deduplicated set of sources referenced by the citation spans.
+     */
+    sources: CitationSource[];
+    /**
+     * Spans of generated text annotated with the sources that support them.
+     */
+    spans: CitationSpan[];
+}
+/**
+ * A source that backs one or more cited spans in the assistant's response.
+ */
+/** @experimental */
+export interface CitationSource {
+    /**
+     * Stable, turn-scoped identifier for this source, referenced by CitationReference.sourceId.
+     */
+    id: string;
+    /**
+     * File path relative to the agent's workspace root, when the source is a file.
+     */
+    path?: string;
+    provider: CitationProvider;
+    /**
+     * Human-readable title of the source.
+     */
+    title?: string;
+    /**
+     * URL of the source, when it is a web resource.
+     */
+    url?: string;
+}
+/**
+ * A contiguous span of generated assistant text and the source references that support it.
+ */
+/** @experimental */
+export interface CitationSpan {
+    /**
+     * End offset of the cited span within the final assistant message content (UTF-16 code units, zero-based, exclusive).
+     */
+    endIndex: number;
+    /**
+     * The sources that support this span of generated text.
+     */
+    references: CitationReference[];
+    /**
+     * Start offset of the cited span within the final assistant message content (UTF-16 code units, zero-based, inclusive).
+     */
+    startIndex: number;
+}
+/**
+ * A single citation occurrence linking a span of generated text to a supporting source.
+ */
+/** @experimental */
+export interface CitationReference {
+    /**
+     * The exact text from the source that supports the cited span, when provided by the model.
+     */
+    citedText?: string;
+    location?: CitationLocation;
+    /**
+     * Provider-native citation correlation data (e.g. Anthropic search_result_index / document_index), passed through opaquely for debugging and forward compatibility.
+     */
+    providerMetadata?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Identifier of the CitationSource this reference points to (CitationSource.id).
+     */
+    sourceId: string;
+}
+/**
+ * A character range within the source's text content.
+ */
+/** @experimental */
+export interface CitationLocationChar {
+    /**
+     * End character offset within the source text (zero-based, exclusive).
+     */
+    endIndex: number;
+    /**
+     * Start character offset within the source text (zero-based, inclusive).
+     */
+    startIndex: number;
+    /**
+     * Citation location type discriminator
+     */
+    type: "char";
+}
+/**
+ * A page range within a paginated source document.
+ */
+/** @experimental */
+export interface CitationLocationPage {
+    /**
+     * Last page number of the cited range (inclusive).
+     */
+    endPage: number;
+    /**
+     * First page number of the cited range.
+     */
+    startPage: number;
+    /**
+     * Citation location type discriminator
+     */
+    type: "page";
+}
+/**
+ * A content-block range within a structured source document.
+ */
+/** @experimental */
+export interface CitationLocationBlock {
+    /**
+     * Index of the last content block of the cited range (zero-based, exclusive).
+     */
+    endBlock: number;
+    /**
+     * Index of the first content block of the cited range (zero-based, inclusive).
+     */
+    startBlock: number;
+    /**
+     * Citation location type discriminator
+     */
+    type: "block";
+}
 /**
  * Neutral provider-tagged server-side tool-use payload (tool search, advisor) for verbatim round-tripping
  */
@@ -2989,14 +3220,23 @@ export interface ModelCallFailureData {
      * Completion ID from the model provider (e.g., chatcmpl-abc123)
      */
     apiCallId?: string;
+    badRequestKind?: ModelCallFailureBadRequestKind;
     /**
      * Duration of the failed API call in milliseconds
      */
     durationMs?: number;
+    /**
+     * For HTTP 400 failures only: the `code` from the CAPI error envelope (e.g. 'model_max_prompt_tokens_exceeded') identifying which deterministic validation failure occurred. Raw server-controlled string, emitted only through restricted telemetry. Absent for bodyless or non-400 failures.
+     */
+    errorCode?: string;
     /**
      * Raw provider/runtime error message for restricted telemetry
      */
     errorMessage?: string;
+    /**
+     * For HTTP 400 failures only: the `type` from the CAPI error envelope (e.g. 'websocket_error'), a coarser companion to errorCode for envelopes that carry no code. Raw server-controlled string, emitted only through restricted telemetry. Absent for bodyless or non-400 failures.
+     */
+    errorType?: string;
     /**
      * What initiated this API call (e.g., "sub-agent", "mcp-sampling"); absent for user-initiated calls
      */
@@ -3009,6 +3249,7 @@ export interface ModelCallFailureData {
      * GitHub request tracing ID (x-github-request-id header) for server-side log correlation
      */
     providerCallId?: string;
+    requestFingerprint?: ModelCallFailureRequestFingerprint;
     /**
      * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
      */
@@ -3019,6 +3260,39 @@ export interface ModelCallFailureData {
      */
     statusCode?: number;
 }
+/**
+ * Content-free structural summary of the failing request for diagnosing malformed 4xx calls
+ */
+export interface ModelCallFailureRequestFingerprint {
+    /**
+     * Total number of image content parts
+     */
+    imagePartCount: number;
+    /**
+     * Image parts whose media type cannot be determined (rejected by strict providers)
+     */
+    imagePartsMissingMediaType: number;
+    /**
+     * Role of the final message in the request
+     */
+    lastMessageRole?: string;
+    /**
+     * Total number of messages in the request
+     */
+    messageCount: number;
+    /**
+     * Tool calls whose name is missing or empty (rejected by strict providers)
+     */
+    namelessToolCallCount: number;
+    /**
+     * Total number of tool calls across assistant messages
+     */
+    toolCallCount: number;
+    /**
+     * Number of "tool" result messages in the request
+     */
+    toolResultMessageCount: number;
+}
 /**
  * Session event "abort". Turn abort information including the reason for termination
  */
@@ -3398,6 +3672,12 @@ export interface ToolExecutionCompleteResult {
      * @experimental
      */
     binaryResultsForLlm?: PersistedBinaryResult[];
+    /**
+     * Provider-neutral source material this tool makes available to the model as citable content. Persisted so it survives session resume. Experimental.
+     *
+     * @experimental
+     */
+    citableSources?: CitableSource[];
     /**
      * Concise tool result text sent to the LLM for chat completion, potentially truncated for token efficiency
      */
@@ -3497,6 +3777,32 @@ export interface BinaryAssetReference {
     mimeType: string;
     type: BinaryAssetReferenceType;
 }
+/**
+ * A source supplied by a tool that should be made available to the model as citable content.
+ */
+/** @experimental */
+export interface CitableSource {
+    /**
+     * The source text made available to the model as citable content.
+     */
+    content: string;
+    /**
+     * Stable identifier for this source within the tool result. Used for deduplication and may be used by future provider integrations to correlate response citations back to the originating source.
+     */
+    id: string;
+    /**
+     * File path relative to the agent's workspace root, when the source is a file.
+     */
+    path?: string;
+    /**
+     * Human-readable title of the source.
+     */
+    title?: string;
+    /**
+     * URL of the source, when it is a web resource.
+     */
+    url?: string;
+}
 /**
  * Plain text content block
  */
@@ -3723,25 +4029,21 @@ export interface ToolExecutionCompleteUIResourceMetaUIPermissions {
  * 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
@@ -4653,6 +4955,14 @@ export interface PermissionRequestShell {
      * URLs that may be accessed by the command
      */
     possibleUrls: PermissionRequestShellPossibleUrl[];
+    /**
+     * True when the model has requested to run this command outside the sandbox (it set requestSandboxBypass: true and the host opted in via sandbox.allowBypass). This is a request, not a grant: the command runs unsandboxed only if the user approves this permission request. Hosts should highlight the elevated risk in the approval UI.
+     */
+    requestSandboxBypass?: boolean;
+    /**
+     * Model-provided justification for the sandbox-bypass request. Only meaningful when requestSandboxBypass is true.
+     */
+    requestSandboxBypassReason?: string;
     /**
      * Tool call ID that triggered this permission request
      */
@@ -5012,7 +5322,12 @@ export interface PermissionPromptRequestRead {
  * MCP tool invocation permission prompt
  */
 export interface PermissionPromptRequestMcp {
-    args?: unknown;
+    /**
+     * Arguments to pass to the MCP tool
+     */
+    args?: {
+        [k: string]: unknown | undefined;
+    };
     /**
      * Prompt kind discriminator
      */
@@ -5630,7 +5945,6 @@ export interface ElicitationRequestedData {
      * URL to open in the user's browser (url mode only)
      */
     url?: string;
-    [k: string]: unknown | undefined;
 }
 /**
  * JSON Schema describing the form fields to present to the user (form mode only)
@@ -5697,6 +6011,12 @@ export interface ElicitationCompletedData {
      */
     requestId: string;
 }
+/**
+ * Schema for the `ElicitationCompletedContent` type.
+ */
+export interface ElicitationCompletedContent {
+    [k: string]: unknown | undefined;
+}
 /**
  * Session event "sampling.requested". Sampling request from an MCP server; contains the server name and a requestId for correlation
  */
@@ -5734,7 +6054,9 @@ export interface SamplingRequestedData {
     /**
      * The JSON-RPC request ID from the MCP protocol
      */
-    mcpRequestId: string | number;
+    mcpRequestId: {
+        [k: string]: unknown | undefined;
+    };
     /**
      * Unique identifier for this sampling request; used to respond via session.respondToSampling()
      */
@@ -5743,7 +6065,6 @@ export interface SamplingRequestedData {
      * Name of the MCP server that initiated the sampling request
      */
     serverName: string;
-    [k: string]: unknown | undefined;
 }
 /**
  * Session event "sampling.completed". Sampling request completion notification signaling UI dismissal
@@ -5819,9 +6140,13 @@ export interface McpOauthRequiredEvent {
  */
 export interface McpOauthRequiredData {
     /**
-     * Unique identifier for this OAuth request; used to respond via session.respondToMcpOAuth()
+     * Unique identifier for this OAuth request; used to respond via session.mcp.oauth.handlePendingRequest
      */
     requestId: string;
+    /**
+     * Raw OAuth protected-resource metadata document fetched for the MCP server, if available
+     */
+    resourceMetadata?: string;
     /**
      * Display name of the MCP server that requires OAuth
      */
@@ -5831,6 +6156,7 @@ export interface McpOauthRequiredData {
      */
     serverUrl: string;
     staticClientConfig?: McpOauthRequiredStaticClientConfig;
+    wwwAuthenticateParams?: McpOauthWWWAuthenticateParams;
 }
 /**
  * Static OAuth client configuration, if the server specifies one
@@ -5849,6 +6175,23 @@ export interface McpOauthRequiredStaticClientConfig {
      */
     publicClient?: boolean;
 }
+/**
+ * OAuth WWW-Authenticate parameters parsed from an MCP auth challenge
+ */
+export interface McpOauthWWWAuthenticateParams {
+    /**
+     * OAuth error from the WWW-Authenticate error parameter, if present
+     */
+    error?: string;
+    /**
+     * Protected resource metadata URL from the WWW-Authenticate resource_metadata parameter
+     */
+    resourceMetadataUrl: string;
+    /**
+     * Requested OAuth scopes from the WWW-Authenticate scope parameter, if present
+     */
+    scope?: string;
+}
 /**
  * Session event "mcp.oauth_completed". MCP OAuth request completion notification
  */
@@ -5883,6 +6226,7 @@ export interface McpOauthCompletedEvent {
  * MCP OAuth request completion notification
  */
 export interface McpOauthCompletedData {
+    outcome: McpOauthCompletionOutcome;
     /**
      * Request ID of the resolved OAuth request
      */
@@ -5937,6 +6281,12 @@ export interface CustomNotificationData {
      */
     version?: number;
 }
+/**
+ * Source-defined JSON payload for the custom notification
+ */
+export interface CustomNotificationPayload {
+    [k: string]: unknown | undefined;
+}
 /**
  * Optional source-defined string identifiers describing the payload subject
  */
@@ -6597,6 +6947,10 @@ export interface SkillsLoadedData {
  * Schema for the `SkillsLoadedSkill` type.
  */
 export interface SkillsLoadedSkill {
+    /**
+     * Optional freeform hint describing the skill's expected arguments, from the `argument-hint` frontmatter field
+     */
+    argumentHint?: string;
     /**
      * Description of what the skill does
      */
@@ -6867,6 +7221,7 @@ export interface ExtensionsLoadedExtension {
 /**
  * Session event "session.canvas.opened".
  */
+/** @experimental */
 export interface CanvasOpenedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -6897,8 +7252,8 @@ export interface CanvasOpenedEvent {
 /**
  * Schema for the `CanvasOpenedData` type.
  */
+/** @experimental */
 export interface CanvasOpenedData {
-    availability: CanvasOpenedAvailability;
     /**
      * Provider-local canvas identifier
      */
@@ -6921,10 +7276,6 @@ export interface CanvasOpenedData {
      * Stable caller-supplied canvas instance identifier
      */
     instanceId: string;
-    /**
-     * Whether this notification represents an idempotent reopen
-     */
-    reopen: boolean;
     /**
      * Provider-supplied status text
      */
@@ -6941,6 +7292,7 @@ export interface CanvasOpenedData {
 /**
  * Session event "session.canvas.registry_changed".
  */
+/** @experimental */
 export interface CanvasRegistryChangedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -6971,6 +7323,7 @@ export interface CanvasRegistryChangedEvent {
 /**
  * Schema for the `CanvasRegistryChangedData` type.
  */
+/** @experimental */
 export interface CanvasRegistryChangedData {
     /**
      * Canvas declarations currently available
@@ -6980,6 +7333,7 @@ export interface CanvasRegistryChangedData {
 /**
  * Schema for the `CanvasRegistryChangedCanvas` type.
  */
+/** @experimental */
 export interface CanvasRegistryChangedCanvas {
     /**
      * Actions the agent or host may invoke
@@ -7015,6 +7369,7 @@ export interface CanvasRegistryChangedCanvas {
 /**
  * Schema for the `CanvasRegistryChangedCanvasAction` type.
  */
+/** @experimental */
 export interface CanvasRegistryChangedCanvasAction {
     /**
      * Action description
@@ -7034,6 +7389,7 @@ export interface CanvasRegistryChangedCanvasAction {
 /**
  * Session event "session.canvas.closed".
  */
+/** @experimental */
 export interface CanvasClosedEvent {
     /**
      * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
@@ -7064,6 +7420,7 @@ export interface CanvasClosedEvent {
 /**
  * Schema for the `CanvasClosedData` type.
  */
+/** @experimental */
 export interface CanvasClosedData {
     /**
      * Provider-local canvas identifier
@@ -7078,6 +7435,163 @@ export interface CanvasClosedData {
      */
     instanceId: string;
 }
+/**
+ * Session event "session.canvas.unavailable". Transient signal that an open canvas instance's provider has dropped (for example the extension is reloading mid-session). The host should keep the panel mounted and surface a reconnecting affordance rather than tearing it down; a subsequent `session.canvas.opened` for the same instanceId clears the affordance once the provider reconnects with a fresh url. Ephemeral and never persisted, so it is never replayed on cold resume.
+ */
+/** @experimental */
+export interface CanvasUnavailableEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CanvasUnavailableData;
+    /**
+     * 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.unavailable".
+     */
+    type: "session.canvas.unavailable";
+}
+/**
+ * Transient signal that an open canvas instance's provider has dropped (for example the extension is reloading mid-session). The host should keep the panel mounted and surface a reconnecting affordance rather than tearing it down; a subsequent `session.canvas.opened` for the same instanceId clears the affordance once the provider reconnects with a fresh url. Ephemeral and never persisted, so it is never replayed on cold resume.
+ */
+/** @experimental */
+export interface CanvasUnavailableData {
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Stable caller-supplied identifier of the canvas instance whose provider became unavailable
+     */
+    instanceId: string;
+}
+/**
+ * Session event "session.canvas.recorded". Durable record that a canvas instance is open, used to restore open canvases on cold session resume. Intentionally omits the transient url and availability.
+ */
+/** @experimental */
+export interface CanvasRecordedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CanvasRecordedData;
+    /**
+     * 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.canvas.recorded".
+     */
+    type: "session.canvas.recorded";
+}
+/**
+ * Durable record that a canvas instance is open, used to restore open canvases on cold session resume. Intentionally omits the transient url and availability.
+ */
+/** @experimental */
+export interface CanvasRecordedData {
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Input supplied when the instance was opened
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * Stable caller-supplied canvas instance identifier
+     */
+    instanceId: string;
+    /**
+     * Rendered title
+     */
+    title?: string;
+}
+/**
+ * Session event "session.canvas.removed". Durable record that a canvas instance was closed, superseding a prior instance_recorded during resume replay.
+ */
+/** @experimental */
+export interface CanvasRemovedEvent {
+    /**
+     * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events.
+     */
+    agentId?: string;
+    data: CanvasRemovedData;
+    /**
+     * 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.canvas.removed".
+     */
+    type: "session.canvas.removed";
+}
+/**
+ * Durable record that a canvas instance was closed, superseding a prior instance_recorded during resume replay.
+ */
+/** @experimental */
+export interface CanvasRemovedData {
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Stable caller-supplied identifier of the canvas instance that was closed
+     */
+    instanceId: string;
+}
 /**
  * Session event "session.extensions.attachments_pushed".
  */
@@ -7196,7 +7710,6 @@ export interface McpAppToolCallCompleteError {
  */
 export interface McpAppToolCallCompleteToolMeta {
     ui?: McpAppToolCallCompleteToolMetaUI;
-    [k: string]: unknown | undefined;
 }
 /**
  * Schema for the `McpAppToolCallCompleteToolMetaUI` type.
@@ -7210,5 +7723,4 @@ export interface McpAppToolCallCompleteToolMetaUI {
      * Tool visibility per SEP-1865 (typically a subset of `["model","app"]`)
      */
     visibility?: string[];
-    [k: string]: unknown | undefined;
 }