@github/copilot-sdk 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/generated/rpc.d.ts

@@ -54,6 +54,18 @@ export type AuthInfoType =
  | "token"
 /** Authentication from a Copilot API token. */
  | "copilot-api-token";
+/**
+ * Runtime-controlled routing state for an open canvas instance.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasInstanceAvailability".
+ */
+/** @experimental */
+export type CanvasInstanceAvailability = 
+/** The owning provider is currently connected and routing calls will be dispatched normally. */
+"ready"
+/** The owning provider is not currently connected. Routing calls fail with canvas_provider_unavailable until the agent re-issues open_canvas (which rehydrates via a fresh canvas.open) or the provider reconnects. */
+ | "stale";
 /**
  * Coarse command category for grouping and behavior: runtime built-in, skill-backed command, or SDK/client-owned command
  *
@@ -110,7 +122,7 @@ export type ContentFilterMode =
 /** Remove characters that can hide directives. */
  | "hidden_characters";
 /**
- * Server transport type: stdio, http, sse, or memory
+ * Server transport type: stdio, http, sse (deprecated), or memory
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "DiscoveredMcpServerType".
@@ -120,7 +132,7 @@ export type DiscoveredMcpServerType =
 "stdio"
 /** Server communicates over streamable HTTP. */
  | "http"
-/** Server communicates over Server-Sent Events. */
+/** Server communicates over Server-Sent Events (deprecated). */
  | "sse"
 /** Server is backed by an in-memory runtime implementation. */
  | "memory";
@@ -301,6 +313,114 @@ export type SessionLogLevel =
  | "warning"
 /** Error message describing a failure. */
  | "error";
+/**
+ * UI theme preference per SEP-1865
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsTheme".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsTheme = 
+/** Light UI theme */
+"light"
+/** Dark UI theme */
+ | "dark";
+/**
+ * Current display mode (SEP-1865)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsDisplayMode".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Allowed values for the `McpAppsHostContextDetailsAvailableDisplayMode` enumeration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsAvailableDisplayMode".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsAvailableDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Platform type for responsive design
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetailsPlatform".
+ */
+/** @experimental */
+export type McpAppsHostContextDetailsPlatform = 
+/** Host runs in a web browser */
+"web"
+/** Host runs as a desktop application */
+ | "desktop"
+/** Host runs on a mobile device */
+ | "mobile";
+/**
+ * UI theme preference per SEP-1865
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsTheme".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsTheme = 
+/** Light UI theme */
+"light"
+/** Dark UI theme */
+ | "dark";
+/**
+ * Current display mode (SEP-1865)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsDisplayMode".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Allowed values for the `McpAppsSetHostContextDetailsAvailableDisplayMode` enumeration.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsAvailableDisplayMode".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsAvailableDisplayMode = 
+/** Rendered inline within the host conversation surface */
+"inline"
+/** Rendered as a fullscreen overlay */
+ | "fullscreen"
+/** Rendered as a picture-in-picture floating panel */
+ | "pip";
+/**
+ * Platform type for responsive design
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextDetailsPlatform".
+ */
+/** @experimental */
+export type McpAppsSetHostContextDetailsPlatform = 
+/** Host runs in a web browser */
+"web"
+/** Host runs as a desktop application */
+ | "desktop"
+/** Host runs on a mobile device */
+ | "mobile";
 /**
  * MCP server configuration (stdio process or remote HTTP/SSE)
  *
@@ -308,6 +428,24 @@ export type SessionLogLevel =
  * via the `definition` "McpServerConfig".
  */
 export type McpServerConfig = McpServerConfigStdio | McpServerConfigHttp;
+/**
+ * OIDC token configuration. When truthy, a token is automatically gathered.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpServerConfigStdioOidc".
+ */
+export type McpServerConfigStdioOidc = boolean | {
+    [k: string]: unknown | undefined;
+};
+/**
+ * Authentication configuration for this server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpServerConfigStdioAuth".
+ */
+export type McpServerConfigStdioAuth = boolean | {
+    [k: string]: unknown | undefined;
+};
 /**
  * Remote transport type. Defaults to "http" when omitted.
  *
@@ -319,6 +457,15 @@ export type McpServerConfigHttpType =
 "http"
 /** Server-Sent Events transport. */
  | "sse";
+/**
+ * OIDC token configuration. When truthy, a token is automatically gathered.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpServerConfigHttpOidc".
+ */
+export type McpServerConfigHttpOidc = boolean | {
+    [k: string]: unknown | undefined;
+};
 /**
  * OAuth grant type to use when authenticating to the remote MCP server.
  *
@@ -670,6 +817,7 @@ export type SessionContextHostType =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsErrorCode".
  */
+/** @experimental */
 export type SessionFsErrorCode = 
 /** The requested path does not exist. */
 "ENOENT"
@@ -681,6 +829,7 @@ export type SessionFsErrorCode =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirWithTypesEntryType".
  */
+/** @experimental */
 export type SessionFsReaddirWithTypesEntryType = 
 /** The entry is a file. */
 "file"
@@ -703,6 +852,7 @@ export type SessionFsSetProviderConventions =
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSqliteQueryType".
  */
+/** @experimental */
 export type SessionFsSqliteQueryType = 
 /** Execute DDL or multi-statement SQL without returning rows. */
 "exec"
@@ -940,6 +1090,34 @@ export type UIExitPlanModeAction =
  | "autopilot"
 /** Exit plan mode and continue in autopilot mode with parallel subagent execution. */
  | "autopilot_fleet";
+/**
+ * Type of change represented by this file diff.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "WorkspaceDiffFileChangeType".
+ */
+/** @experimental */
+export type WorkspaceDiffFileChangeType = 
+/** The file was added. */
+"added"
+/** The file was modified. */
+ | "modified"
+/** The file was deleted. */
+ | "deleted"
+/** The file was renamed. */
+ | "renamed";
+/**
+ * Diff mode requested by the client.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "WorkspaceDiffMode".
+ */
+/** @experimental */
+export type WorkspaceDiffMode = 
+/** Return staged, unstaged, and untracked working tree changes. */
+"unstaged"
+/** Return changes compared with the default branch. */
+ | "branch";
 /**
  * Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration.
  *
@@ -1095,11 +1273,11 @@ export interface AgentInfo {
     model?: string;
     /**
      * MCP server configurations attached to this agent, keyed by server name. Server config shape mirrors the MCP `mcpServers` schema.
+     *
+     * @experimental
      */
     mcpServers?: {
-        [k: string]: {
-            [k: string]: unknown | undefined;
-        } | undefined;
+        [k: string]: unknown | undefined;
     };
     /**
      * Skill names preloaded into this agent's context. Omitted means none.
@@ -1469,274 +1647,621 @@ export interface GhCliAuthInfo {
     copilotUser?: CopilotUserResponse;
 }
 /**
- * Slash commands available in the session, after applying any include/exclude filters.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandList".
- */
-/** @experimental */
-export interface CommandList {
-    /**
-     * Commands available in this session
-     */
-    commands: SlashCommandInfo[];
-}
-/**
- * Schema for the `SlashCommandInfo` type.
+ * Canvas action that the agent or host can invoke. To discover the input schema for a particular action, call the list_canvas_capabilities tool.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SlashCommandInfo".
+ * via the `definition` "CanvasAction".
  */
 /** @experimental */
-export interface SlashCommandInfo {
+export interface CanvasAction {
     /**
-     * Canonical command name without a leading slash
+     * Action name exposed by the canvas provider
      */
     name: string;
     /**
-     * Canonical aliases without leading slashes
-     */
-    aliases?: string[];
-    /**
-     * Human-readable command description
-     */
-    description: string;
-    kind: SlashCommandKind;
-    input?: SlashCommandInput;
-    /**
-     * Whether the command may run while an agent turn is active
-     */
-    allowDuringAgentExecution: boolean;
-    /**
-     * Whether the command is experimental
+     * Description of the action
      */
-    experimental?: boolean;
+    description?: string;
+    inputSchema?: CanvasJsonSchema;
 }
 /**
- * Optional unstructured input hint
+ * JSON Schema for canvas open input
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "SlashCommandInput".
+ * via the `definition` "CanvasJsonSchema".
  */
 /** @experimental */
-export interface SlashCommandInput {
-    /**
-     * Hint to display when command input has not been provided
-     */
-    hint: string;
-    /**
-     * When true, the command requires non-empty input; clients should render the input hint as required
-     */
-    required?: boolean;
-    completion?: SlashCommandInputCompletion;
-    /**
-     * When true, clients should pass the full text after the command name as a single argument rather than splitting on whitespace
-     */
-    preserveMultilineInput?: boolean;
+export interface CanvasJsonSchema {
+    [k: string]: unknown | undefined;
 }
 /**
- * Pending command request ID and an optional error if the client handler failed.
+ * Canvas close parameters.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandsHandlePendingCommandRequest".
+ * via the `definition` "CanvasCloseRequest".
  */
 /** @experimental */
-export interface CommandsHandlePendingCommandRequest {
-    /**
-     * Request ID from the command invocation event
-     */
-    requestId: string;
+export interface CanvasCloseRequest {
     /**
-     * Error message if the command handler failed
+     * Open canvas instance identifier
      */
-    error?: string;
+    instanceId: string;
 }
 /**
- * Indicates whether the pending client-handled command was completed successfully.
+ * Host context supplied by the runtime.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandsHandlePendingCommandResult".
+ * via the `definition` "CanvasHostContext".
  */
 /** @experimental */
-export interface CommandsHandlePendingCommandResult {
-    /**
-     * Whether the command was handled successfully
-     */
-    success: boolean;
+export interface CanvasHostContext {
+    capabilities?: CanvasHostContextCapabilities;
 }
 /**
- * Slash command name and optional raw input string to invoke.
+ * Host capabilities
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandsInvokeRequest".
+ * via the `definition` "CanvasHostContextCapabilities".
  */
 /** @experimental */
-export interface CommandsInvokeRequest {
-    /**
-     * Command name. Leading slashes are stripped and the name is matched case-insensitively.
-     */
-    name: string;
+export interface CanvasHostContextCapabilities {
     /**
-     * Raw input after the command name
+     * Whether canvas rendering is supported
      */
-    input?: string;
+    canvases?: boolean;
 }
 /**
- * Optional filters controlling which command sources to include in the listing.
+ * Canvas action invocation parameters.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandsListRequest".
+ * via the `definition` "CanvasInvokeActionRequest".
  */
 /** @experimental */
-export interface CommandsListRequest {
+export interface CanvasInvokeActionRequest {
     /**
-     * Include runtime built-in commands
+     * Open canvas instance identifier
      */
-    includeBuiltins?: boolean;
+    instanceId: string;
     /**
-     * Include enabled user-invocable skills and commands
+     * Action name to invoke
      */
-    includeSkills?: boolean;
+    actionName: string;
     /**
-     * Include commands registered by protocol clients, including SDK clients and extensions
+     * Action input
      */
-    includeClientCommands?: boolean;
+    input?: {
+        [k: string]: unknown | undefined;
+    };
 }
 /**
- * Queued-command request ID and the result indicating whether the host executed it (and whether to stop processing further queued commands).
+ * Provider-supplied action result.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandsRespondToQueuedCommandRequest".
+ * via the `definition` "CanvasInvokeActionResult".
  */
 /** @experimental */
-export interface CommandsRespondToQueuedCommandRequest {
-    /**
-     * Request ID from the `command.queued` event the host is responding to.
-     */
-    requestId: string;
-    result: QueuedCommandResult;
+export interface CanvasInvokeActionResult {
+    [k: string]: unknown | undefined;
 }
 /**
- * Schema for the `QueuedCommandHandled` type.
+ * Declared canvases available in this session.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "QueuedCommandHandled".
+ * via the `definition` "CanvasList".
  */
 /** @experimental */
-export interface QueuedCommandHandled {
-    /**
-     * The host actually executed the queued command.
-     */
-    handled: true;
+export interface CanvasList {
     /**
-     * When true, the runtime will not process subsequent queued commands until a new request comes in.
+     * Declared canvases available in this session
      */
-    stopProcessingQueue?: boolean;
+    canvases: DiscoveredCanvas[];
 }
 /**
- * Schema for the `QueuedCommandNotHandled` type.
+ * Canvas available in the current session.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "QueuedCommandNotHandled".
+ * via the `definition` "DiscoveredCanvas".
  */
 /** @experimental */
-export interface QueuedCommandNotHandled {
+export interface DiscoveredCanvas {
     /**
-     * The host did not execute the queued command. Unblocks the queue without claiming the command was processed (e.g. when the handler threw before completing).
+     * Human-readable canvas name
      */
-    handled: false;
+    displayName: string;
+    /**
+     * Short, single-sentence description shown to the agent in canvas catalogs.
+     */
+    description: string;
+    inputSchema?: CanvasJsonSchema;
+    /**
+     * Actions the agent or host may invoke on an open instance
+     */
+    actions?: CanvasAction[];
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Owning extension display name, when available
+     */
+    extensionName?: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
 }
 /**
- * Indicates whether the queued-command response was matched to a pending request.
+ * Live open-canvas snapshot.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "CommandsRespondToQueuedCommandResult".
+ * via the `definition` "CanvasListOpenResult".
  */
 /** @experimental */
-export interface CommandsRespondToQueuedCommandResult {
+export interface CanvasListOpenResult {
     /**
-     * Whether a pending queued command with the given request ID was found and resolved. False when the request was already resolved, cancelled, or unknown.
+     * Currently open canvas instances
      */
-    success: boolean;
+    openCanvases: OpenCanvasInstance[];
 }
 /**
- * Metadata for a connected remote session.
+ * Open canvas instance snapshot.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectedRemoteSessionMetadata".
+ * via the `definition` "OpenCanvasInstance".
  */
 /** @experimental */
-export interface ConnectedRemoteSessionMetadata {
+export interface OpenCanvasInstance {
     /**
-     * SDK session ID for the connected remote session.
+     * Stable caller-supplied canvas instance identifier
      */
-    sessionId: string;
+    instanceId: string;
     /**
-     * Optional friendly session name.
+     * Owning provider identifier
      */
-    name?: string;
+    extensionId: string;
     /**
-     * Optional session summary.
+     * Owning extension display name, when available
      */
-    summary?: string;
+    extensionName?: string;
     /**
-     * Session start time as an ISO 8601 string.
+     * Provider-local canvas identifier
      */
-    startTime: string;
+    canvasId: string;
     /**
-     * Last session update time as an ISO 8601 string.
+     * Rendered title
      */
-    modifiedTime: string;
-    repository: ConnectedRemoteSessionMetadataRepository;
+    title?: string;
     /**
-     * Pull request number associated with the session.
+     * Provider-supplied status text
      */
-    pullRequestNumber?: number;
+    status?: string;
     /**
-     * Original remote resource identifier.
+     * URL for web-rendered canvases
      */
-    resourceId?: string;
-    kind: ConnectedRemoteSessionMetadataKind;
+    url?: string;
     /**
-     * Remote session staleness deadline as an ISO 8601 string.
+     * Input supplied when the instance was opened
      */
-    staleAt?: string;
+    input?: {
+        [k: string]: unknown | undefined;
+    };
     /**
-     * Remote session state returned by the backing service.
+     * Whether this snapshot came from an idempotent reopen
      */
-    state?: string;
+    reopen: boolean;
+    availability: CanvasInstanceAvailability;
 }
 /**
- * Repository associated with the connected remote session.
+ * Canvas open parameters.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectedRemoteSessionMetadataRepository".
+ * via the `definition` "CanvasOpenRequest".
  */
 /** @experimental */
-export interface ConnectedRemoteSessionMetadataRepository {
+export interface CanvasOpenRequest {
     /**
-     * Repository owner or organization login.
+     * Owning provider identifier. Optional when the canvasId is unique across providers; required to disambiguate when multiple providers register the same canvasId.
      */
-    owner: string;
+    extensionId?: string;
     /**
-     * Repository name.
+     * Provider-local canvas identifier
      */
-    name: string;
+    canvasId: string;
     /**
-     * Branch associated with the remote session.
+     * Caller-supplied stable instance identifier
      */
-    branch: string;
+    instanceId: string;
+    /**
+     * Canvas open input
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
 }
 /**
- * Remote session connection parameters.
+ * Canvas close parameters sent to the provider.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "ConnectRemoteSessionParams".
+ * via the `definition` "CanvasProviderCloseRequest".
  */
 /** @experimental */
-export interface ConnectRemoteSessionParams {
+export interface CanvasProviderCloseRequest {
     /**
-     * Session ID to connect to.
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Canvas instance identifier
+     */
+    instanceId: string;
+    host?: CanvasHostContext;
+}
+/**
+ * Canvas action invocation parameters sent to the provider.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasProviderInvokeActionRequest".
+ */
+/** @experimental */
+export interface CanvasProviderInvokeActionRequest {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Canvas instance identifier
+     */
+    instanceId: string;
+    /**
+     * Action name to invoke
+     */
+    actionName: string;
+    /**
+     * Action input
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+    host?: CanvasHostContext;
+}
+/**
+ * Canvas open parameters sent to the provider.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasProviderOpenRequest".
+ */
+/** @experimental */
+export interface CanvasProviderOpenRequest {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * Owning provider identifier
+     */
+    extensionId: string;
+    /**
+     * Provider-local canvas identifier
+     */
+    canvasId: string;
+    /**
+     * Stable caller-supplied canvas instance identifier
+     */
+    instanceId: string;
+    /**
+     * Canvas open input
+     */
+    input?: {
+        [k: string]: unknown | undefined;
+    };
+    host?: CanvasHostContext;
+}
+/**
+ * Canvas open result returned by the provider.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasProviderOpenResult".
+ */
+/** @experimental */
+export interface CanvasProviderOpenResult {
+    /**
+     * URL for web-rendered canvases
+     */
+    url?: string;
+    /**
+     * Provider-supplied title
+     */
+    title?: string;
+    /**
+     * Provider-supplied status text
+     */
+    status?: string;
+}
+/**
+ * Slash commands available in the session, after applying any include/exclude filters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandList".
+ */
+/** @experimental */
+export interface CommandList {
+    /**
+     * Commands available in this session
+     */
+    commands: SlashCommandInfo[];
+}
+/**
+ * Schema for the `SlashCommandInfo` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SlashCommandInfo".
+ */
+/** @experimental */
+export interface SlashCommandInfo {
+    /**
+     * Canonical command name without a leading slash
+     */
+    name: string;
+    /**
+     * Canonical aliases without leading slashes
+     */
+    aliases?: string[];
+    /**
+     * Human-readable command description
+     */
+    description: string;
+    kind: SlashCommandKind;
+    input?: SlashCommandInput;
+    /**
+     * Whether the command may run while an agent turn is active
+     */
+    allowDuringAgentExecution: boolean;
+    /**
+     * Whether the command is experimental
+     */
+    experimental?: boolean;
+}
+/**
+ * Optional unstructured input hint
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SlashCommandInput".
+ */
+/** @experimental */
+export interface SlashCommandInput {
+    /**
+     * Hint to display when command input has not been provided
+     */
+    hint: string;
+    /**
+     * When true, the command requires non-empty input; clients should render the input hint as required
+     */
+    required?: boolean;
+    completion?: SlashCommandInputCompletion;
+    /**
+     * When true, clients should pass the full text after the command name as a single argument rather than splitting on whitespace
+     */
+    preserveMultilineInput?: boolean;
+}
+/**
+ * Pending command request ID and an optional error if the client handler failed.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandsHandlePendingCommandRequest".
+ */
+/** @experimental */
+export interface CommandsHandlePendingCommandRequest {
+    /**
+     * Request ID from the command invocation event
+     */
+    requestId: string;
+    /**
+     * Error message if the command handler failed
+     */
+    error?: string;
+}
+/**
+ * Indicates whether the pending client-handled command was completed successfully.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandsHandlePendingCommandResult".
+ */
+/** @experimental */
+export interface CommandsHandlePendingCommandResult {
+    /**
+     * Whether the command was handled successfully
+     */
+    success: boolean;
+}
+/**
+ * Slash command name and optional raw input string to invoke.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandsInvokeRequest".
+ */
+/** @experimental */
+export interface CommandsInvokeRequest {
+    /**
+     * Command name. Leading slashes are stripped and the name is matched case-insensitively.
+     */
+    name: string;
+    /**
+     * Raw input after the command name
+     */
+    input?: string;
+}
+/**
+ * Optional filters controlling which command sources to include in the listing.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandsListRequest".
+ */
+/** @experimental */
+export interface CommandsListRequest {
+    /**
+     * Include runtime built-in commands
+     */
+    includeBuiltins?: boolean;
+    /**
+     * Include enabled user-invocable skills and commands
+     */
+    includeSkills?: boolean;
+    /**
+     * Include commands registered by protocol clients, including SDK clients and extensions
+     */
+    includeClientCommands?: boolean;
+}
+/**
+ * Queued-command request ID and the result indicating whether the host executed it (and whether to stop processing further queued commands).
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandsRespondToQueuedCommandRequest".
+ */
+/** @experimental */
+export interface CommandsRespondToQueuedCommandRequest {
+    /**
+     * Request ID from the `command.queued` event the host is responding to.
+     */
+    requestId: string;
+    result: QueuedCommandResult;
+}
+/**
+ * Schema for the `QueuedCommandHandled` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QueuedCommandHandled".
+ */
+/** @experimental */
+export interface QueuedCommandHandled {
+    /**
+     * The host actually executed the queued command.
+     */
+    handled: true;
+    /**
+     * When true, the runtime will not process subsequent queued commands until a new request comes in.
+     */
+    stopProcessingQueue?: boolean;
+}
+/**
+ * Schema for the `QueuedCommandNotHandled` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "QueuedCommandNotHandled".
+ */
+/** @experimental */
+export interface QueuedCommandNotHandled {
+    /**
+     * The host did not execute the queued command. Unblocks the queue without claiming the command was processed (e.g. when the handler threw before completing).
+     */
+    handled: false;
+}
+/**
+ * Indicates whether the queued-command response was matched to a pending request.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CommandsRespondToQueuedCommandResult".
+ */
+/** @experimental */
+export interface CommandsRespondToQueuedCommandResult {
+    /**
+     * Whether a pending queued command with the given request ID was found and resolved. False when the request was already resolved, cancelled, or unknown.
+     */
+    success: boolean;
+}
+/**
+ * Metadata for a connected remote session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectedRemoteSessionMetadata".
+ */
+/** @experimental */
+export interface ConnectedRemoteSessionMetadata {
+    /**
+     * SDK session ID for the connected remote session.
+     */
+    sessionId: string;
+    /**
+     * Optional friendly session name.
+     */
+    name?: string;
+    /**
+     * Optional session summary.
+     */
+    summary?: string;
+    /**
+     * Session start time as an ISO 8601 string.
+     */
+    startTime: string;
+    /**
+     * Last session update time as an ISO 8601 string.
+     */
+    modifiedTime: string;
+    repository: ConnectedRemoteSessionMetadataRepository;
+    /**
+     * Pull request number associated with the session.
+     */
+    pullRequestNumber?: number;
+    /**
+     * Original remote resource identifier.
+     */
+    resourceId?: string;
+    kind: ConnectedRemoteSessionMetadataKind;
+    /**
+     * Remote session staleness deadline as an ISO 8601 string.
+     */
+    staleAt?: string;
+    /**
+     * Remote session state returned by the backing service.
+     */
+    state?: string;
+}
+/**
+ * Repository associated with the connected remote session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectedRemoteSessionMetadataRepository".
+ */
+/** @experimental */
+export interface ConnectedRemoteSessionMetadataRepository {
+    /**
+     * Repository owner or organization login.
+     */
+    owner: string;
+    /**
+     * Repository name.
+     */
+    name: string;
+    /**
+     * Branch associated with the remote session.
+     */
+    branch: string;
+}
+/**
+ * Remote session connection parameters.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectRemoteSessionParams".
+ */
+/** @experimental */
+export interface ConnectRemoteSessionParams {
+    /**
+     * Session ID to connect to.
      */
     sessionId: string;
 }
@@ -1992,9 +2517,7 @@ export interface ExternalToolTextResultForLlm {
      * Optional tool-specific telemetry
      */
     toolTelemetry?: {
-        [k: string]: {
-            [k: string]: unknown | undefined;
-        } | undefined;
+        [k: string]: unknown | undefined;
     };
     /**
      * Base64-encoded binary results returned to the model
@@ -2027,6 +2550,12 @@ export interface ExternalToolTextResultForLlmBinaryResultsForLlm {
      * Human-readable description of the binary data
      */
     description?: string;
+    /**
+     * Optional metadata from the producing tool.
+     */
+    metadata?: {
+        [k: string]: unknown | undefined;
+    };
 }
 /**
  * Plain text content block
@@ -2489,134 +3018,402 @@ export interface InstalledPluginSourceUrl {
     path?: string;
 }
 /**
- * Schema for the `InstalledPluginSourceLocal` type.
+ * Schema for the `InstalledPluginSourceLocal` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstalledPluginSourceLocal".
+ */
+/** @experimental */
+export interface InstalledPluginSourceLocal {
+    /**
+     * Constant value. Always "local".
+     */
+    source: "local";
+    path: string;
+}
+/**
+ * Instruction sources loaded for the session, in merge order.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionsGetSourcesResult".
+ */
+/** @experimental */
+export interface InstructionsGetSourcesResult {
+    /**
+     * Instruction sources for the session
+     */
+    sources: InstructionsSources[];
+}
+/**
+ * Schema for the `InstructionsSources` type.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "InstructionsSources".
+ */
+/** @experimental */
+export interface InstructionsSources {
+    /**
+     * Unique identifier for this source (used for toggling)
+     */
+    id: string;
+    /**
+     * Human-readable label
+     */
+    label: string;
+    /**
+     * File path relative to repo or absolute for home
+     */
+    sourcePath: string;
+    /**
+     * Raw content of the instruction file
+     */
+    content: string;
+    type: InstructionsSourcesType;
+    location: InstructionsSourcesLocation;
+    /**
+     * Glob pattern(s) from frontmatter — when set, this instruction applies only to matching files
+     */
+    applyTo?: string[];
+    /**
+     * Short description (body after frontmatter) for use in instruction tables
+     */
+    description?: string;
+    /**
+     * When true, this source starts disabled and must be toggled on by the user
+     */
+    defaultDisabled?: boolean;
+}
+/**
+ * Message text, optional severity level, persistence flag, optional follow-up URL, and optional tip.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "LogRequest".
+ */
+/** @experimental */
+export interface LogRequest {
+    /**
+     * Human-readable message
+     */
+    message: string;
+    level?: SessionLogLevel;
+    /**
+     * Domain category for this log entry (e.g., "mcp", "subscription", "policy", "model"). Maps to `infoType`/`warningType`/`errorType` on the emitted event. Defaults to "notification".
+     */
+    type?: string;
+    /**
+     * When true, the message is transient and not persisted to the session event log on disk
+     */
+    ephemeral?: boolean;
+    /**
+     * Optional URL the user can open in their browser for more details
+     */
+    url?: string;
+    /**
+     * Optional actionable tip displayed alongside the message. Only honored on `level: "info"`.
+     */
+    tip?: string;
+}
+/**
+ * Identifier of the session event that was emitted for the log message.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "LogResult".
+ */
+/** @experimental */
+export interface LogResult {
+    /**
+     * The unique identifier of the emitted session event
+     */
+    eventId: string;
+}
+/**
+ * Parameters for (re)loading the merged LSP configuration set.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "LspInitializeRequest".
+ */
+/** @experimental */
+export interface LspInitializeRequest {
+    /**
+     * Working directory used to load project-level LSP configs. Defaults to the session working directory when omitted.
+     */
+    workingDirectory?: string;
+    /**
+     * Git root used as the boundary when traversing for project-level LSP configs (supports monorepos).
+     */
+    gitRoot?: string;
+    /**
+     * Force re-initialization even when LSP configs were already loaded for the working directory.
+     */
+    force?: boolean;
+}
+/**
+ * MCP server, tool name, and arguments to invoke from an MCP App view.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsCallToolRequest".
+ */
+/** @experimental */
+export interface McpAppsCallToolRequest {
+    /**
+     * MCP server hosting the tool
+     */
+    serverName: string;
+    /**
+     * MCP tool name
+     */
+    toolName: string;
+    /**
+     * Tool arguments
+     */
+    arguments?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing.
+     */
+    originServerName: string;
+}
+/**
+ * Capability negotiation snapshot
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseCapability".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseCapability {
+    /**
+     * Whether the session has the `mcp-apps` capability
+     */
+    sessionHasMcpApps: boolean;
+    /**
+     * Whether the MCP_APPS feature flag (or COPILOT_MCP_APPS env override) is on
+     */
+    featureFlagEnabled: boolean;
+    /**
+     * Whether the runtime advertises `extensions.io.modelcontextprotocol/ui` to MCP servers
+     */
+    advertised: boolean;
+}
+/**
+ * MCP server to diagnose MCP Apps wiring for.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseRequest".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseRequest {
+    /**
+     * MCP server to probe
+     */
+    serverName: string;
+}
+/**
+ * Diagnostic snapshot of MCP Apps wiring for the named server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseResult".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseResult {
+    capability: McpAppsDiagnoseCapability;
+    server: McpAppsDiagnoseServer;
+}
+/**
+ * What the server returned for this session
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsDiagnoseServer".
+ */
+/** @experimental */
+export interface McpAppsDiagnoseServer {
+    /**
+     * Whether the named server is currently connected
+     */
+    connected: boolean;
+    /**
+     * Total tools returned by the server's tools/list
+     */
+    toolCount: number;
+    /**
+     * Tools whose `_meta.ui` is populated (resourceUri and/or visibility set)
+     */
+    toolsWithUiMeta: number;
+    /**
+     * Up to 5 tool names with `_meta.ui` for quick inspection
+     */
+    sampleToolNames: string[];
+}
+/**
+ * Current host context advertised to MCP App guests.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContext".
+ */
+/** @experimental */
+export interface McpAppsHostContext {
+    context: McpAppsHostContextDetails;
+}
+/**
+ * Current host context
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsHostContextDetails".
+ */
+/** @experimental */
+export interface McpAppsHostContextDetails {
+    theme?: McpAppsHostContextDetailsTheme;
+    /**
+     * BCP-47 locale, e.g. 'en-US'
+     */
+    locale?: string;
+    /**
+     * IANA timezone, e.g. 'America/New_York'
+     */
+    timeZone?: string;
+    displayMode?: McpAppsHostContextDetailsDisplayMode;
+    /**
+     * Display modes the host supports
+     */
+    availableDisplayModes?: McpAppsHostContextDetailsAvailableDisplayMode[];
+    platform?: McpAppsHostContextDetailsPlatform;
+    /**
+     * Host application identifier
+     */
+    userAgent?: string;
+    [k: string]: unknown | undefined;
+}
+/**
+ * MCP server to list app-callable tools for.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "InstalledPluginSourceLocal".
+ * via the `definition` "McpAppsListToolsRequest".
  */
 /** @experimental */
-export interface InstalledPluginSourceLocal {
+export interface McpAppsListToolsRequest {
     /**
-     * Constant value. Always "local".
+     * MCP server hosting the app
      */
-    source: "local";
-    path: string;
+    serverName: string;
+    /**
+     * **Required.** Server whose ui:// view issued the request. Per SEP-1865 ('callable by the app from this server only'), the call is rejected when this differs from `serverName`, and rejected outright when missing.
+     */
+    originServerName: string;
 }
 /**
- * Instruction sources loaded for the session, in merge order.
+ * App-callable tools from the named MCP server.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "InstructionsGetSourcesResult".
+ * via the `definition` "McpAppsListToolsResult".
  */
 /** @experimental */
-export interface InstructionsGetSourcesResult {
+export interface McpAppsListToolsResult {
     /**
-     * Instruction sources for the session
+     * App-callable tools from the server
      */
-    sources: InstructionsSources[];
+    tools: {
+        [k: string]: unknown | undefined;
+    }[];
 }
 /**
- * Schema for the `InstructionsSources` type.
+ * MCP server and resource URI to fetch.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "InstructionsSources".
+ * via the `definition` "McpAppsReadResourceRequest".
  */
 /** @experimental */
-export interface InstructionsSources {
-    /**
-     * Unique identifier for this source (used for toggling)
-     */
-    id: string;
-    /**
-     * Human-readable label
-     */
-    label: string;
-    /**
-     * File path relative to repo or absolute for home
-     */
-    sourcePath: string;
+export interface McpAppsReadResourceRequest {
     /**
-     * Raw content of the instruction file
-     */
-    content: string;
-    type: InstructionsSourcesType;
-    location: InstructionsSourcesLocation;
-    /**
-     * Glob pattern(s) from frontmatter — when set, this instruction applies only to matching files
+     * Name of the MCP server hosting the resource
      */
-    applyTo?: string[];
+    serverName: string;
     /**
-     * Short description (body after frontmatter) for use in instruction tables
+     * Resource URI (typically ui://...)
      */
-    description?: string;
+    uri: string;
+}
+/**
+ * Resource contents returned by the MCP server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsReadResourceResult".
+ */
+/** @experimental */
+export interface McpAppsReadResourceResult {
     /**
-     * When true, this source starts disabled and must be toggled on by the user
+     * Resource contents returned by the server
      */
-    defaultDisabled?: boolean;
+    contents: McpAppsResourceContent[];
 }
 /**
- * Message text, optional severity level, persistence flag, optional follow-up URL, and optional tip.
+ * Schema for the `McpAppsResourceContent` type.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "LogRequest".
+ * via the `definition` "McpAppsResourceContent".
  */
 /** @experimental */
-export interface LogRequest {
+export interface McpAppsResourceContent {
     /**
-     * Human-readable message
+     * The resource URI (typically ui://...)
      */
-    message: string;
-    level?: SessionLogLevel;
+    uri: string;
     /**
-     * Domain category for this log entry (e.g., "mcp", "subscription", "policy", "model"). Maps to `infoType`/`warningType`/`errorType` on the emitted event. Defaults to "notification".
+     * MIME type of the content
      */
-    type?: string;
+    mimeType?: string;
     /**
-     * When true, the message is transient and not persisted to the session event log on disk
+     * Text content (e.g. HTML)
      */
-    ephemeral?: boolean;
+    text?: string;
     /**
-     * Optional URL the user can open in their browser for more details
+     * Base64-encoded binary content
      */
-    url?: string;
+    blob?: string;
     /**
-     * Optional actionable tip displayed alongside the message. Only honored on `level: "info"`.
+     * Resource-level metadata (CSP, permissions, etc.)
      */
-    tip?: string;
+    _meta?: {
+        [k: string]: unknown | undefined;
+    };
 }
 /**
- * Identifier of the session event that was emitted for the log message.
+ * Host context advertised to MCP App guests
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "LogResult".
+ * via the `definition` "McpAppsSetHostContextDetails".
  */
 /** @experimental */
-export interface LogResult {
+export interface McpAppsSetHostContextDetails {
+    theme?: McpAppsSetHostContextDetailsTheme;
     /**
-     * The unique identifier of the emitted session event
+     * BCP-47 locale, e.g. 'en-US'
      */
-    eventId: string;
-}
-/**
- * Parameters for (re)loading the merged LSP configuration set.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "LspInitializeRequest".
- */
-/** @experimental */
-export interface LspInitializeRequest {
+    locale?: string;
     /**
-     * Working directory used to load project-level LSP configs. Defaults to the session working directory when omitted.
+     * IANA timezone, e.g. 'America/New_York'
      */
-    workingDirectory?: string;
+    timeZone?: string;
+    displayMode?: McpAppsSetHostContextDetailsDisplayMode;
     /**
-     * Git root used as the boundary when traversing for project-level LSP configs (supports monorepos).
+     * Display modes the host supports
      */
-    gitRoot?: string;
+    availableDisplayModes?: McpAppsSetHostContextDetailsAvailableDisplayMode[];
+    platform?: McpAppsSetHostContextDetailsPlatform;
     /**
-     * Force re-initialization even when LSP configs were already loaded for the working directory.
+     * Host application identifier
      */
-    force?: boolean;
+    userAgent?: string;
+    [k: string]: unknown | undefined;
+}
+/**
+ * Host context to advertise to MCP App guests.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpAppsSetHostContextRequest".
+ */
+/** @experimental */
+export interface McpAppsSetHostContextRequest {
+    context: McpAppsSetHostContextDetails;
 }
 /**
  * The requestId previously passed to executeSampling that should be cancelled.
@@ -2677,6 +3474,8 @@ export interface McpServerConfigStdio {
      * Timeout in milliseconds for tool calls to this server.
      */
     timeout?: number;
+    oidc?: McpServerConfigStdioOidc;
+    auth?: McpServerConfigStdioAuth;
     /**
      * Executable command used to start the Stdio MCP server process.
      */
@@ -2717,6 +3516,8 @@ export interface McpServerConfigHttp {
      * Timeout in milliseconds for tool calls to this server.
      */
     timeout?: number;
+    oidc?: McpServerConfigHttpOidc;
+    auth?: McpServerConfigHttpAuth;
     /**
      * URL of the remote MCP server endpoint.
      */
@@ -2736,7 +3537,6 @@ export interface McpServerConfigHttp {
      */
     oauthPublicClient?: boolean;
     oauthGrantType?: McpServerConfigHttpOauthGrantType;
-    auth?: McpServerConfigHttpAuth;
 }
 /**
  * Additional authentication configuration for this server.
@@ -2749,6 +3549,7 @@ export interface McpServerConfigHttpAuth {
      * Fixed port for the OAuth redirect callback server.
      */
     redirectPort?: number;
+    [k: string]: unknown | undefined;
 }
 /**
  * MCP server names to disable for new sessions.
@@ -3357,21 +4158,50 @@ export interface ModelBilling {
  */
 export interface ModelBillingTokenPrices {
     /**
-     * Price per billing batch of input tokens in nano-AIUs (1 nano-AIU = 0.000000001 AIU, 1 AIU = $0.01 USD)
+     * AI Credits cost per billing batch of input tokens
      */
     inputPrice?: number;
     /**
-     * Price per billing batch of output tokens in nano-AIUs (1 nano-AIU = 0.000000001 AIU, 1 AIU = $0.01 USD)
+     * AI Credits cost per billing batch of output tokens
      */
     outputPrice?: number;
     /**
-     * Price per billing batch of cached tokens in nano-AIUs (1 nano-AIU = 0.000000001 AIU, 1 AIU = $0.01 USD)
+     * AI Credits cost per billing batch of cached tokens
      */
     cachePrice?: number;
     /**
      * Number of tokens per standard billing batch
      */
     batchSize?: number;
+    /**
+     * Maximum context window tokens for the default tier
+     */
+    contextMax?: number;
+    longContext?: ModelBillingTokenPricesLongContext;
+}
+/**
+ * Long context tier pricing (available for models with extended context windows)
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelBillingTokenPricesLongContext".
+ */
+export interface ModelBillingTokenPricesLongContext {
+    /**
+     * AI Credits cost per billing batch of input tokens
+     */
+    inputPrice?: number;
+    /**
+     * AI Credits cost per billing batch of output tokens
+     */
+    outputPrice?: number;
+    /**
+     * AI Credits cost per billing batch of cached tokens
+     */
+    cachePrice?: number;
+    /**
+     * Maximum context window tokens for the long context tier
+     */
+    contextMax?: number;
 }
 /**
  * Override individual model capabilities resolved by the runtime
@@ -5426,12 +6256,6 @@ export interface SendRequest {
      * If set, the request will fail if the named tool is not available when this message is among the user messages at the start of the current exchange
      */
     requiredTool?: string;
-    /**
-     * Optional provenance tag copied to the resulting user.message event. Supported values are `system`, `command-*`, and `schedule-*`.
-     */
-    source?: {
-        [k: string]: unknown | undefined;
-    };
     agentMode?: SendAgentMode;
     /**
      * Custom HTTP headers to include in outbound model requests for this turn. Merged with session-level provider headers; per-turn headers augment and overwrite session-level headers with the same key.
@@ -5582,7 +6406,7 @@ export interface SessionContext {
     branch?: string;
 }
 /**
- * The same metadata records, with summary and context fields backfilled where available.
+ * The enriched metadata records, with summary and context fields backfilled where available. Sessions confirmed empty and unnamed are omitted.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionEnrichMetadataResult".
@@ -5590,7 +6414,7 @@ export interface SessionContext {
 /** @experimental */
 export interface SessionEnrichMetadataResult {
     /**
-     * Same records, with summary and context backfilled
+     * Enriched records, with summary and context backfilled. Sessions confirmed empty and unnamed may be omitted.
      */
     sessions: SessionMetadata[];
 }
@@ -5638,6 +6462,7 @@ export interface SessionMetadata {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsAppendFileRequest".
  */
+/** @experimental */
 export interface SessionFsAppendFileRequest {
     /**
      * Target session identifier
@@ -5662,6 +6487,7 @@ export interface SessionFsAppendFileRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsError".
  */
+/** @experimental */
 export interface SessionFsError {
     code: SessionFsErrorCode;
     /**
@@ -5675,6 +6501,7 @@ export interface SessionFsError {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsExistsRequest".
  */
+/** @experimental */
 export interface SessionFsExistsRequest {
     /**
      * Target session identifier
@@ -5691,6 +6518,7 @@ export interface SessionFsExistsRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsExistsResult".
  */
+/** @experimental */
 export interface SessionFsExistsResult {
     /**
      * Whether the path exists
@@ -5703,6 +6531,7 @@ export interface SessionFsExistsResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsMkdirRequest".
  */
+/** @experimental */
 export interface SessionFsMkdirRequest {
     /**
      * Target session identifier
@@ -5727,6 +6556,7 @@ export interface SessionFsMkdirRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirRequest".
  */
+/** @experimental */
 export interface SessionFsReaddirRequest {
     /**
      * Target session identifier
@@ -5743,6 +6573,7 @@ export interface SessionFsReaddirRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirResult".
  */
+/** @experimental */
 export interface SessionFsReaddirResult {
     /**
      * Entry names in the directory
@@ -5756,6 +6587,7 @@ export interface SessionFsReaddirResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirWithTypesEntry".
  */
+/** @experimental */
 export interface SessionFsReaddirWithTypesEntry {
     /**
      * Entry name
@@ -5769,6 +6601,7 @@ export interface SessionFsReaddirWithTypesEntry {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirWithTypesRequest".
  */
+/** @experimental */
 export interface SessionFsReaddirWithTypesRequest {
     /**
      * Target session identifier
@@ -5785,6 +6618,7 @@ export interface SessionFsReaddirWithTypesRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReaddirWithTypesResult".
  */
+/** @experimental */
 export interface SessionFsReaddirWithTypesResult {
     /**
      * Directory entries with type information
@@ -5798,6 +6632,7 @@ export interface SessionFsReaddirWithTypesResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReadFileRequest".
  */
+/** @experimental */
 export interface SessionFsReadFileRequest {
     /**
      * Target session identifier
@@ -5814,6 +6649,7 @@ export interface SessionFsReadFileRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsReadFileResult".
  */
+/** @experimental */
 export interface SessionFsReadFileResult {
     /**
      * File content as UTF-8 string
@@ -5827,6 +6663,7 @@ export interface SessionFsReadFileResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsRenameRequest".
  */
+/** @experimental */
 export interface SessionFsRenameRequest {
     /**
      * Target session identifier
@@ -5847,6 +6684,7 @@ export interface SessionFsRenameRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsRmRequest".
  */
+/** @experimental */
 export interface SessionFsRmRequest {
     /**
      * Target session identifier
@@ -5913,6 +6751,7 @@ export interface SessionFsSetProviderResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSqliteExistsResult".
  */
+/** @experimental */
 export interface SessionFsSqliteExistsResult {
     /**
      * Whether the session database already exists
@@ -5925,6 +6764,7 @@ export interface SessionFsSqliteExistsResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSqliteQueryRequest".
  */
+/** @experimental */
 export interface SessionFsSqliteQueryRequest {
     /**
      * Target session identifier
@@ -5948,14 +6788,13 @@ export interface SessionFsSqliteQueryRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSqliteQueryResult".
  */
+/** @experimental */
 export interface SessionFsSqliteQueryResult {
     /**
      * For SELECT: array of row objects. For others: empty array.
      */
     rows: {
-        [k: string]: {
-            [k: string]: unknown | undefined;
-        } | undefined;
+        [k: string]: unknown | undefined;
     }[];
     /**
      * Column names from the result set
@@ -5977,6 +6816,7 @@ export interface SessionFsSqliteQueryResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsStatRequest".
  */
+/** @experimental */
 export interface SessionFsStatRequest {
     /**
      * Target session identifier
@@ -5993,6 +6833,7 @@ export interface SessionFsStatRequest {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsStatResult".
  */
+/** @experimental */
 export interface SessionFsStatResult {
     /**
      * Whether the path is a file
@@ -6022,6 +6863,7 @@ export interface SessionFsStatResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsWriteFileRequest".
  */
+/** @experimental */
 export interface SessionFsWriteFileRequest {
     /**
      * Target session identifier
@@ -6720,6 +7562,8 @@ export interface SessionUpdateOptionsParams {
     isExperimentalMode?: boolean;
     /**
      * Custom model-provider configuration (BYOK). Opaque shape; see `ProviderConfig` in the runtime.
+     *
+     * @experimental
      */
     provider?: {
         [k: string]: unknown | undefined;
@@ -6750,6 +7594,8 @@ export interface SessionUpdateOptionsParams {
     shellProcessFlags?: string[];
     /**
      * Sandbox configuration shape; opaque to SDK consumers. See `SandboxConfig` in the runtime.
+     *
+     * @experimental
      */
     sandboxConfig?: {
         [k: string]: unknown | undefined;
@@ -6829,10 +7675,10 @@ export interface SessionUpdateOptionsParams {
     eventsLogDirectory?: string;
     /**
      * Additional content-exclusion policies to merge into the session's policy set. Opaque shape; see `ContentExclusionApiResponse` in the runtime.
+     *
+     * @experimental
      */
-    additionalContentExclusionPolicies?: {
-        [k: string]: unknown | undefined;
-    }[];
+    additionalContentExclusionPolicies?: unknown[];
     /**
      * Whether to expose the `manage_schedule` tool to the agent. The runtime always owns the per-session schedule registry; this flag only controls tool exposure (typically gated to staff users).
      */
@@ -7667,9 +8513,7 @@ export interface Tool {
      * JSON Schema for the tool's input parameters
      */
     parameters?: {
-        [k: string]: {
-            [k: string]: unknown | undefined;
-        } | undefined;
+        [k: string]: unknown | undefined;
     };
     /**
      * Optional instructions for how to use this tool effectively
@@ -8406,6 +9250,55 @@ export interface UsageMetricsModelMetricTokenDetail {
      */
     tokenCount: number;
 }
+/**
+ * A single changed file and its unified diff.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "WorkspaceDiffFileChange".
+ */
+/** @experimental */
+export interface WorkspaceDiffFileChange {
+    /**
+     * Path to the changed file, relative to the workspace root.
+     */
+    path: string;
+    /**
+     * Unified diff content for the file. Empty when the diff was truncated.
+     */
+    diff: string;
+    changeType: WorkspaceDiffFileChangeType;
+    /**
+     * Original file path for renamed files.
+     */
+    oldPath?: string;
+    /**
+     * Whether the diff content was omitted because it exceeded the per-file size limit.
+     */
+    isTruncated?: boolean;
+}
+/**
+ * Workspace diff result for the requested mode.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "WorkspaceDiffResult".
+ */
+/** @experimental */
+export interface WorkspaceDiffResult {
+    requestedMode: WorkspaceDiffMode;
+    mode: WorkspaceDiffMode;
+    /**
+     * Changed files and their unified diffs.
+     */
+    changes: WorkspaceDiffFileChange[];
+    /**
+     * Default branch used for a branch diff, when branch mode was requested.
+     */
+    baseBranch?: string;
+    /**
+     * Whether a requested branch diff fell back to unstaged changes because branch diff failed.
+     */
+    isFallback: boolean;
+}
 /**
  * Schema for the `WorkspacesCheckpoints` type.
  *
@@ -8444,6 +9337,16 @@ export interface WorkspacesCreateFileRequest {
      */
     content: string;
 }
+/**
+ * Parameters for computing a workspace diff.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "WorkspacesDiffRequest".
+ */
+/** @experimental */
+export interface WorkspacesDiffRequest {
+    mode: WorkspaceDiffMode;
+}
 /**
  * Current workspace metadata for the session, including its absolute filesystem path when available.
  *
@@ -8595,12 +9498,23 @@ export interface WorkspacesSaveLargePasteResult {
         sizeBytes: number;
     } | null;
 }
+/**
+ * Standard MCP CallToolResult
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionMcpAppsCallToolResult".
+ */
+/** @experimental */
+export interface SessionMcpAppsCallToolResult {
+    [k: string]: unknown | undefined;
+}
 /**
  * Identifies the target session.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSqliteExistsRequest".
  */
+/** @experimental */
 export interface SessionFsSqliteExistsRequest {
     /**
      * Target session identifier
@@ -8858,7 +9772,7 @@ export declare function createServerRpc(connection: MessageConnection): {
          *
          * @param params Session metadata records to enrich with summary and context information.
          *
-         * @returns The same metadata records, with summary and context fields backfilled where available.
+         * @returns The enriched metadata records, with summary and context fields backfilled where available. Sessions confirmed empty and unnamed are omitted.
          */
         enrichMetadata: (params: SessionsEnrichMetadataRequest) => Promise<SessionEnrichMetadataResult>;
         /**
@@ -8941,6 +9855,43 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
         setCredentials: (params: SessionSetCredentialsParams) => Promise<SessionSetCredentialsResult>;
     };
     /** @experimental */
+    canvas: {
+        /**
+         * Lists canvases declared for the session.
+         *
+         * @returns Declared canvases available in this session.
+         */
+        list: () => Promise<CanvasList>;
+        /**
+         * Lists currently open canvas instances for the live session.
+         *
+         * @returns Live open-canvas snapshot.
+         */
+        listOpen: () => Promise<CanvasListOpenResult>;
+        /**
+         * Opens or focuses a canvas instance.
+         *
+         * @param params Canvas open parameters.
+         *
+         * @returns Open canvas instance snapshot.
+         */
+        open: (params: CanvasOpenRequest) => Promise<OpenCanvasInstance>;
+        /**
+         * Closes an open canvas instance.
+         *
+         * @param params Canvas close parameters.
+         */
+        close: (params: CanvasCloseRequest) => Promise<void>;
+        /**
+         * Invokes an action on an open canvas instance.
+         *
+         * @param params Canvas action invocation parameters.
+         *
+         * @returns Canvas action invocation result.
+         */
+        invokeAction: (params: CanvasInvokeActionRequest) => Promise<CanvasInvokeActionResult>;
+    };
+    /** @experimental */
     model: {
         /**
          * Gets the currently selected model for the session.
@@ -9072,6 +10023,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @returns Descriptor for the saved paste file, or null when the workspace is unavailable.
          */
         saveLargePaste: (params: WorkspacesSaveLargePasteRequest) => Promise<WorkspacesSaveLargePasteResult>;
+        /**
+         * Computes a diff for the session workspace.
+         *
+         * @param params Parameters for computing a workspace diff.
+         *
+         * @returns Workspace diff result for the requested mode.
+         */
+        diff: (params: WorkspacesDiffRequest) => Promise<WorkspaceDiffResult>;
     };
     /** @experimental */
     instructions: {
@@ -9309,6 +10268,53 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
              */
             login: (params: McpOauthLoginRequest) => Promise<McpOauthLoginResult>;
         };
+        /** @experimental */
+        apps: {
+            /**
+             * Fetch an MCP resource (typically a `ui://` MCP App bundle, per SEP-1865) from a connected server. Requires the `mcp-apps` session capability.
+             *
+             * @param params MCP server and resource URI to fetch.
+             *
+             * @returns Resource contents returned by the MCP server.
+             */
+            readResource: (params: McpAppsReadResourceRequest) => Promise<McpAppsReadResourceResult>;
+            /**
+             * List tools that an MCP App view is allowed to call (SEP-1865 visibility filter). Returns tools whose `_meta.ui.visibility` is unset (default `["model","app"]`) or includes `"app"`.
+             *
+             * @param params MCP server to list app-callable tools for.
+             *
+             * @returns App-callable tools from the named MCP server.
+             */
+            listTools: (params: McpAppsListToolsRequest) => Promise<McpAppsListToolsResult>;
+            /**
+             * Call an MCP tool from an MCP App view (SEP-1865). Enforces the visibility check that prevents an app iframe from invoking model-only tools. Returns the standard MCP `CallToolResult`.
+             *
+             * @param params MCP server, tool name, and arguments to invoke from an MCP App view.
+             *
+             * @returns Standard MCP CallToolResult
+             */
+            callTool: (params: McpAppsCallToolRequest) => Promise<SessionMcpAppsCallToolResult>;
+            /**
+             * Replace the host context returned to MCP App guests on `ui/initialize`. Hosts use this to advertise theme, locale, or other metadata to the guest UI.
+             *
+             * @param params Host context to advertise to MCP App guests.
+             */
+            setHostContext: (params: McpAppsSetHostContextRequest) => Promise<void>;
+            /**
+             * Read the current host context advertised to MCP App guests.
+             *
+             * @returns Current host context advertised to MCP App guests.
+             */
+            getHostContext: () => Promise<McpAppsHostContext>;
+            /**
+             * Diagnose MCP Apps wiring for a specific MCP server. Reports the session capability, feature-flag state, advertised extension, and how many tools have `_meta.ui` populated.
+             *
+             * @param params MCP server to diagnose MCP Apps wiring for.
+             *
+             * @returns Diagnostic snapshot of MCP Apps wiring for the named server.
+             */
+            diagnose: (params: McpAppsDiagnoseRequest) => Promise<McpAppsDiagnoseResult>;
+        };
     };
     /** @experimental */
     plugins: {
@@ -9883,6 +10889,7 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
     };
 };
 /** Handler for `sessionFs` client session API methods. */
+/** @experimental */
 export interface SessionFsHandler {
     /**
      * Reads a file from the client-provided session filesystem.
@@ -9981,9 +10988,36 @@ export interface SessionFsHandler {
      */
     sqliteExists(params: SessionFsSqliteExistsRequest): Promise<SessionFsSqliteExistsResult>;
 }
+/** Handler for `canvas` client session API methods. */
+/** @experimental */
+export interface CanvasHandler {
+    /**
+     * Opens a canvas instance on the provider.
+     *
+     * @param params Canvas open parameters sent to the provider.
+     *
+     * @returns Canvas open result returned by the provider.
+     */
+    open(params: CanvasProviderOpenRequest): Promise<CanvasProviderOpenResult>;
+    /**
+     * Closes a canvas instance on the provider.
+     *
+     * @param params Canvas close parameters sent to the provider.
+     */
+    close(params: CanvasProviderCloseRequest): Promise<void>;
+    /**
+     * Invokes an action on an open canvas instance via the provider.
+     *
+     * @param params Canvas action invocation parameters sent to the provider.
+     *
+     * @returns Provider-supplied action result.
+     */
+    invokeAction(params: CanvasProviderInvokeActionRequest): Promise<CanvasInvokeActionResult>;
+}
 /** All client session API handler groups. */
 export interface ClientSessionApiHandlers {
     sessionFs?: SessionFsHandler;
+    canvas?: CanvasHandler;
 }
 /**
  * Register client session API handlers on a JSON-RPC connection.