@github/copilot-sdk 1.0.0-beta.5 → 1.0.0-beta.7

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 | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PlanChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | CustomNotificationEvent | ExternalToolRequestedEvent | ExternalToolCompletedEvent | CommandQueuedEvent | CommandExecuteEvent | CommandCompletedEvent | AutoModeSwitchRequestedEvent | AutoModeSwitchCompletedEvent | CommandsChangedEvent | CapabilitiesChangedEvent | ExitPlanModeRequestedEvent | ExitPlanModeCompletedEvent | ToolsUpdatedEvent | BackgroundTasksChangedEvent | SkillsLoadedEvent | CustomAgentsUpdatedEvent | McpServersLoadedEvent | McpServerStatusChangedEvent | ExtensionsLoadedEvent;
+export type SessionEvent = StartEvent | ResumeEvent | RemoteSteerableChangedEvent | ErrorEvent | IdleEvent | TitleChangedEvent | ScheduleCreatedEvent | ScheduleCancelledEvent | InfoEvent | WarningEvent | ModelChangeEvent | ModeChangedEvent | PlanChangedEvent | WorkspaceFileChangedEvent | HandoffEvent | TruncationEvent | SnapshotRewindEvent | ShutdownEvent | ContextChangedEvent | UsageInfoEvent | CompactionStartEvent | CompactionCompleteEvent | TaskCompleteEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent | AssistantIntentEvent | AssistantReasoningEvent | AssistantReasoningDeltaEvent | AssistantStreamingDeltaEvent | AssistantMessageEvent | AssistantMessageStartEvent | AssistantMessageDeltaEvent | AssistantTurnEndEvent | AssistantUsageEvent | ModelCallFailureEvent | AbortEvent | ToolUserRequestedEvent | ToolExecutionStartEvent | ToolExecutionPartialResultEvent | ToolExecutionProgressEvent | ToolExecutionCompleteEvent | SkillInvokedEvent | SubagentStartedEvent | SubagentCompletedEvent | SubagentFailedEvent | SubagentSelectedEvent | SubagentDeselectedEvent | HookStartEvent | HookEndEvent | SystemMessageEvent | SystemNotificationEvent | PermissionRequestedEvent | PermissionCompletedEvent | UserInputRequestedEvent | UserInputCompletedEvent | ElicitationRequestedEvent | ElicitationCompletedEvent | SamplingRequestedEvent | SamplingCompletedEvent | McpOauthRequiredEvent | McpOauthCompletedEvent | 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)
  */
@@ -150,6 +150,24 @@ export type ToolExecutionCompleteContentResourceLinkIconTheme =
  * 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
  */
@@ -308,6 +326,18 @@ export type McpServerStatus =
  | "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
  */
@@ -328,6 +358,14 @@ 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
  */
@@ -601,6 +639,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
      */
@@ -922,6 +964,12 @@ 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
      */
@@ -1320,12 +1368,10 @@ export interface ShutdownData {
     totalApiDurationMs: number;
     /**
      * Session-wide accumulated nano-AI units cost
+     *
+     * @experimental
      */
     totalNanoAiu?: number;
-    /**
-     * Total number of premium API requests used during the session
-     */
-    totalPremiumRequests: number;
 }
 /**
  * Aggregate code change metrics for the session
@@ -1357,6 +1403,8 @@ export interface ShutdownModelMetric {
     };
     /**
      * Accumulated nano-AI units cost for this model
+     *
+     * @experimental
      */
     totalNanoAiu?: number;
     usage: ShutdownModelMetricUsage;
@@ -1367,12 +1415,16 @@ 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.
@@ -1604,6 +1656,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
      */
@@ -1628,6 +1684,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
      */
@@ -1661,7 +1721,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
      */
@@ -1679,19 +1738,6 @@ export interface CompactionCompleteCompactionTokensUsed {
      */
     outputTokens?: number;
 }
-/**
- * Per-request cost and usage data from the CAPI copilot_usage response field
- */
-export interface CompactionCompleteCompactionTokensUsedCopilotUsage {
-    /**
-     * Itemized token usage breakdown
-     */
-    tokenDetails: CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail[];
-    /**
-     * Total cost in nano-AI units for this request
-     */
-    totalNanoAiu: number;
-}
 /**
  * Token usage detail for a single billing category
  */
@@ -2256,10 +2302,14 @@ export interface AssistantMessageEvent {
 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;
     /**
@@ -2307,6 +2357,10 @@ export interface AssistantMessageData {
      * GitHub request tracing ID (x-github-request-id header) for correlating with server-side logs
      */
     requestId?: string;
+    /**
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
+     */
+    serviceRequestId?: string;
     /**
      * Tool invocations requested by the assistant in this message
      */
@@ -2529,9 +2583,10 @@ export interface AssistantUsageData {
      * Number of tokens written to prompt cache
      */
     cacheWriteTokens?: number;
-    copilotUsage?: AssistantUsageCopilotUsage;
     /**
      * Model multiplier cost for billing purposes
+     *
+     * @experimental
      */
     cost?: number;
     /**
@@ -2567,12 +2622,6 @@ export interface AssistantUsageData {
      * GitHub request tracing ID (x-github-request-id header) for server-side log correlation
      */
     providerCallId?: string;
-    /**
-     * Per-quota resource usage snapshots, keyed by quota identifier
-     */
-    quotaSnapshots?: {
-        [k: string]: AssistantUsageQuotaSnapshot | undefined;
-    };
     /**
      * Reasoning effort level used for model calls, if applicable (e.g. "none", "low", "medium", "high", "xhigh", "max")
      */
@@ -2582,22 +2631,13 @@ export interface AssistantUsageData {
      */
     reasoningTokens?: number;
     /**
-     * Time to first token in milliseconds. Only available for streaming requests
-     */
-    timeToFirstTokenMs?: number;
-}
-/**
- * Per-request cost and usage data from the CAPI copilot_usage response field
- */
-export interface AssistantUsageCopilotUsage {
-    /**
-     * Itemized token usage breakdown
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
      */
-    tokenDetails: AssistantUsageCopilotUsageTokenDetail[];
+    serviceRequestId?: string;
     /**
-     * Total cost in nano-AI units for this request
+     * Time to first token in milliseconds. Only available for streaming requests
      */
-    totalNanoAiu: number;
+    timeToFirstTokenMs?: number;
 }
 /**
  * Token usage detail for a single billing category
@@ -2620,43 +2660,6 @@ export interface AssistantUsageCopilotUsageTokenDetail {
      */
     tokenType: string;
 }
-/**
- * Schema for the `AssistantUsageQuotaSnapshot` type.
- */
-export interface AssistantUsageQuotaSnapshot {
-    /**
-     * Total requests allowed by the entitlement
-     */
-    entitlementRequests: number;
-    /**
-     * Whether the user has an unlimited usage entitlement
-     */
-    isUnlimitedEntitlement: boolean;
-    /**
-     * Number of requests over the entitlement limit
-     */
-    overage: number;
-    /**
-     * Whether overage is allowed when quota is exhausted
-     */
-    overageAllowedWithExhaustedQuota: boolean;
-    /**
-     * Percentage of quota remaining (0 to 100)
-     */
-    remainingPercentage: number;
-    /**
-     * Date when the quota resets
-     */
-    resetDate?: string;
-    /**
-     * Whether usage is still permitted after quota exhaustion
-     */
-    usageAllowedWithExhaustedQuota: boolean;
-    /**
-     * Number of requests already consumed
-     */
-    usedRequests: number;
-}
 /**
  * Session event "model.call_failure". Failed LLM API call metadata for telemetry
  */
@@ -2715,6 +2718,10 @@ export interface ModelCallFailureData {
      * GitHub request tracing ID (x-github-request-id header) for server-side log correlation
      */
     providerCallId?: string;
+    /**
+     * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation
+     */
+    serviceRequestId?: string;
     source: ModelCallFailureSource;
     /**
      * HTTP status code from the failed request
@@ -3011,6 +3018,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
      */
@@ -3019,6 +3030,7 @@ 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)
      */
@@ -3059,6 +3071,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
@@ -3227,6 +3240,118 @@ export interface EmbeddedBlobResourceContents {
      */
     uri: string;
 }
+/**
+ * MCP Apps UI resource content for rendering in a sandboxed iframe
+ */
+export interface ToolExecutionCompleteUIResource {
+    _meta?: ToolExecutionCompleteUIResourceMeta;
+    /**
+     * Base64-encoded HTML content
+     */
+    blob?: string;
+    /**
+     * MIME type of the content
+     */
+    mimeType: string;
+    /**
+     * HTML content as a string
+     */
+    text?: string;
+    /**
+     * The ui:// URI of the resource
+     */
+    uri: string;
+}
+/**
+ * Resource-level UI metadata (CSP, permissions, visual preferences)
+ */
+export interface ToolExecutionCompleteUIResourceMeta {
+    ui?: ToolExecutionCompleteUIResourceMetaUI;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUI` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUI {
+    csp?: ToolExecutionCompleteUIResourceMetaUICsp;
+    domain?: string;
+    permissions?: ToolExecutionCompleteUIResourceMetaUIPermissions;
+    prefersBorder?: boolean;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUICsp` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUICsp {
+    baseUriDomains?: string[];
+    connectDomains?: string[];
+    frameDomains?: string[];
+    resourceDomains?: string[];
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissions` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissions {
+    camera?: ToolExecutionCompleteUIResourceMetaUIPermissionsCamera;
+    clipboardWrite?: ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite;
+    geolocation?: ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation;
+    microphone?: ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsCamera` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsCamera {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsClipboardWrite {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsGeolocation {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Schema for the `ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone` type.
+ */
+export interface ToolExecutionCompleteUIResourceMetaUIPermissionsMicrophone {
+    [k: string]: unknown | undefined;
+}
+/**
+ * Tool definition metadata, present for MCP tools with MCP Apps support
+ */
+export interface ToolExecutionCompleteToolDescription {
+    _meta?: ToolExecutionCompleteToolDescriptionMeta;
+    /**
+     * Tool description
+     */
+    description?: string;
+    /**
+     * Tool name
+     */
+    name: string;
+}
+/**
+ * MCP Apps metadata for UI resource association
+ */
+export interface ToolExecutionCompleteToolDescriptionMeta {
+    ui?: ToolExecutionCompleteToolDescriptionMetaUI;
+}
+/**
+ * Schema for the `ToolExecutionCompleteToolDescriptionMetaUI` type.
+ */
+export interface ToolExecutionCompleteToolDescriptionMetaUI {
+    /**
+     * URI of the UI resource
+     */
+    resourceUri?: string;
+    /**
+     * Who can access this tool
+     */
+    visibility?: ToolExecutionCompleteToolDescriptionMetaUIVisibility[];
+}
 /**
  * Session event "skill.invoked". Skill invocation details including content, allowed tools, and plugin metadata
  */
@@ -3289,6 +3414,11 @@ 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
@@ -5695,10 +5825,18 @@ 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
@@ -6078,8 +6216,17 @@ export interface McpServersLoadedServer {
      * Server name (config key)
      */
     name: string;
+    /**
+     * Name of the plugin that supplied the effective MCP server config, only when source is plugin
+     */
+    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".
@@ -6115,6 +6262,10 @@ export interface McpServerStatusChangedEvent {
  * 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
      */
@@ -6175,3 +6326,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;
+}