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

package/dist/canvas.d.ts

@@ -1,15 +1,15 @@
+import type { CanvasJsonSchema, CanvasProviderCloseRequest, CanvasProviderInvokeActionRequest, CanvasProviderOpenRequest, CanvasProviderOpenResult } from "./generated/rpc.js";
+export type { CanvasJsonSchema, CanvasHostContext } from "./generated/rpc.js";
 /**
  * Extension-owned canvases declared via
  * `joinSession({ canvases: [createCanvas({...})] })`.
  *
- * The runtime sends provider callbacks directly as `canvas.open`,
- * `canvas.close`, and `canvas.action.invoke` JSON-RPC requests. The SDK
- * routes those requests by `canvasId` to the in-process handlers bound by
- * `createCanvas`. Re-opening with an existing `instanceId` is how the host
- * focuses an existing panel; reload is a renderer-only concern.
+ * The runtime sends provider callbacks as `canvas.open`, `canvas.close`, and
+ * `canvas.invokeAction` JSON-RPC requests via the codegen client session API
+ * pipeline. The SDK routes those requests by `canvasId` to the in-process
+ * handlers bound by `createCanvas`. Re-opening with an existing `instanceId`
+ * is how the host focuses an existing panel; reload is a renderer-only concern.
  */
-/** JSON Schema object used for canvas inputs. */
-export type CanvasJsonSchema = Record<string, unknown>;
 /**
  * A single agent-callable action contributed by a canvas. The metadata
  * (`name`, `description`, `inputSchema`) is serialized over the wire on
@@ -27,7 +27,7 @@ export interface CanvasAction {
     /** Optional JSON Schema for the action's `input` payload. */
     inputSchema?: CanvasJsonSchema;
     /** Required per-action dispatch handler. */
-    handler: (ctx: CanvasActionContext) => Promise<unknown> | unknown;
+    handler: (ctx: CanvasProviderInvokeActionRequest) => Promise<unknown> | unknown;
 }
 /**
  * Declarative metadata for a single canvas, serialized over the wire on
@@ -45,66 +45,6 @@ export interface CanvasDeclaration {
     /** Agent-invocable actions exposed via `invoke_canvas_action`. */
     actions?: Omit<CanvasAction, "handler">[];
 }
-/** Response returned from `open`. */
-export interface CanvasOpenResponse {
-    /** URL the host should render. Optional for native canvases. */
-    url?: string;
-    /** Provider-supplied title shown in host chrome. */
-    title?: string;
-    /** Provider-supplied status text shown in host chrome. */
-    status?: string;
-}
-/** Host capabilities passed to canvas callbacks. */
-export interface CanvasHostContext {
-    capabilities?: {
-        canvases?: boolean;
-    };
-}
-/** Context handed to a canvas's `open` handler. */
-export interface CanvasOpenContext {
-    /** Session that requested the canvas. */
-    sessionId: string;
-    /** Extension id that owns the canvas. */
-    extensionId: string;
-    /** Canvas id (matches the declaring `CanvasDeclaration.id`). */
-    canvasId: string;
-    /** Stable instance id supplied by the runtime. */
-    instanceId: string;
-    /** Validated `input` payload, shaped by `CanvasDeclaration.inputSchema`. */
-    input: unknown;
-    /** Host capabilities supplied by the runtime. */
-    host?: CanvasHostContext;
-}
-/** Context handed to a canvas action handler. */
-export interface CanvasActionContext {
-    /** Session that invoked the action. */
-    sessionId: string;
-    /** Extension id that owns the canvas. */
-    extensionId: string;
-    /** Canvas id targeted by the action. */
-    canvasId: string;
-    /** Instance id targeted by the action. */
-    instanceId: string;
-    /** Action name from `CanvasAction.name`. */
-    actionName: string;
-    /** Validated `input` payload, shaped by the action's `inputSchema`. */
-    input: unknown;
-    /** Host capabilities supplied by the runtime. */
-    host?: CanvasHostContext;
-}
-/** Context handed to a canvas's `onClose` handler. */
-export interface CanvasLifecycleContext {
-    /** Session owning the canvas instance. */
-    sessionId: string;
-    /** Extension id that owns the canvas. */
-    extensionId: string;
-    /** Canvas id (matches the declaring `CanvasDeclaration.id`). */
-    canvasId: string;
-    /** Instance id this lifecycle event applies to. */
-    instanceId: string;
-    /** Host capabilities supplied by the runtime. */
-    host?: CanvasHostContext;
-}
 /** Structured error returned from canvas handlers. */
 export declare class CanvasError extends Error {
     readonly code: string;
@@ -132,13 +72,13 @@ export interface CanvasOptions {
      */
     actions?: CanvasAction[];
     /** Required. Open a new canvas instance. */
-    open: (ctx: CanvasOpenContext) => Promise<CanvasOpenResponse> | CanvasOpenResponse;
+    open: (ctx: CanvasProviderOpenRequest) => Promise<CanvasProviderOpenResult> | CanvasProviderOpenResult;
     /**
      * Optional. Notified when a canvas instance is closed by the user, the
      * agent, or the host. Fire-and-forget: the return value is ignored and
      * errors are logged but not surfaced to the runtime.
      */
-    onClose?: (ctx: CanvasLifecycleContext) => Promise<void> | void;
+    onClose?: (ctx: CanvasProviderCloseRequest) => Promise<void> | void;
 }
 /** A registered canvas: declarative metadata + in-process handler closures.
  *

package/dist/canvas.js

@@ -42,51 +42,8 @@ class Canvas {
 function createCanvas(options) {
   return new Canvas(options);
 }
-async function dispatchCanvasProviderRequest(canvas, actionName, params) {
-  switch (actionName) {
-    case "canvas.open": {
-      const result = await canvas.open({
-        sessionId: params.sessionId,
-        extensionId: params.extensionId,
-        canvasId: params.canvasId,
-        instanceId: params.instanceId,
-        input: params.input,
-        host: params.host
-      });
-      return result ?? {};
-    }
-    case "canvas.close": {
-      if (canvas.onClose) {
-        await canvas.onClose({
-          sessionId: params.sessionId,
-          extensionId: params.extensionId,
-          canvasId: params.canvasId,
-          instanceId: params.instanceId,
-          host: params.host
-        });
-      }
-      return void 0;
-    }
-    default: {
-      const perAction = canvas.actionHandlers.get(actionName);
-      if (!perAction) {
-        throw CanvasError.noHandler();
-      }
-      return perAction({
-        sessionId: params.sessionId,
-        extensionId: params.extensionId,
-        canvasId: params.canvasId,
-        instanceId: params.instanceId,
-        actionName,
-        input: params.input,
-        host: params.host
-      });
-    }
-  }
-}
 export {
   Canvas,
   CanvasError,
-  createCanvas,
-  dispatchCanvasProviderRequest
+  createCanvas
 };

package/dist/cjs/canvas.js

@@ -20,8 +20,7 @@ var canvas_exports = {};
 __export(canvas_exports, {
   Canvas: () => Canvas,
   CanvasError: () => CanvasError,
-  createCanvas: () => createCanvas,
-  dispatchCanvasProviderRequest: () => dispatchCanvasProviderRequest
+  createCanvas: () => createCanvas
 });
 module.exports = __toCommonJS(canvas_exports);
 class CanvasError extends Error {
@@ -68,52 +67,9 @@ class Canvas {
 function createCanvas(options) {
   return new Canvas(options);
 }
-async function dispatchCanvasProviderRequest(canvas, actionName, params) {
-  switch (actionName) {
-    case "canvas.open": {
-      const result = await canvas.open({
-        sessionId: params.sessionId,
-        extensionId: params.extensionId,
-        canvasId: params.canvasId,
-        instanceId: params.instanceId,
-        input: params.input,
-        host: params.host
-      });
-      return result ?? {};
-    }
-    case "canvas.close": {
-      if (canvas.onClose) {
-        await canvas.onClose({
-          sessionId: params.sessionId,
-          extensionId: params.extensionId,
-          canvasId: params.canvasId,
-          instanceId: params.instanceId,
-          host: params.host
-        });
-      }
-      return void 0;
-    }
-    default: {
-      const perAction = canvas.actionHandlers.get(actionName);
-      if (!perAction) {
-        throw CanvasError.noHandler();
-      }
-      return perAction({
-        sessionId: params.sessionId,
-        extensionId: params.extensionId,
-        canvasId: params.canvasId,
-        instanceId: params.instanceId,
-        actionName,
-        input: params.input,
-        host: params.host
-      });
-    }
-  }
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Canvas,
   CanvasError,
-  createCanvas,
-  dispatchCanvasProviderRequest
+  createCanvas
 });

package/dist/cjs/client.js

@@ -30,7 +30,6 @@ var import_node_path = require("node:path");
 var import_node_url = require("node:url");
 var import_node = require("vscode-jsonrpc/node.js");
 var import_rpc = require("./generated/rpc.js");
-var import_canvas = require("./canvas.js");
 var import_sdkProtocolVersion = require("./sdkProtocolVersion.js");
 var import_session = require("./session.js");
 var import_sessionFsProvider = require("./sessionFsProvider.js");
@@ -68,16 +67,6 @@ function toWireCustomAgents(agents) {
     return { ...rest, mcpServers: toWireMcpServers(mcpServers) };
   });
 }
-function isCanvasProviderRequestParams(params) {
-  if (!params || typeof params !== "object") {
-    return false;
-  }
-  const request = params;
-  return typeof request.sessionId === "string" && typeof request.extensionId === "string" && typeof request.canvasId === "string" && typeof request.instanceId === "string";
-}
-function isCanvasActionInvokeParams(params) {
-  return isCanvasProviderRequestParams(params) && typeof params.actionName === "string";
-}
 function extractTransformCallbacks(systemMessage) {
   if (!systemMessage || systemMessage.mode !== "customize" || !systemMessage.sections) {
     return { wirePayload: systemMessage, transformCallbacks: void 0 };
@@ -1409,18 +1398,6 @@ stderr: ${stderrOutput}`
       "systemMessage.transform",
       async (params) => await this.handleSystemMessageTransform(params)
     );
-    this.connection.onRequest(
-      "canvas.open",
-      async (params) => this.handleCanvasProviderRequest("canvas.open", params)
-    );
-    this.connection.onRequest(
-      "canvas.close",
-      async (params) => this.handleCanvasProviderRequest("canvas.close", params)
-    );
-    this.connection.onRequest(
-      "canvas.action.invoke",
-      async (params) => this.handleCanvasActionInvokeRequest(params)
-    );
     const sessions = this.sessions;
     (0, import_rpc.registerClientSessionApiHandlers)(this.connection, (sessionId) => {
       const session = sessions.get(sessionId);
@@ -1542,26 +1519,6 @@ stderr: ${stderrOutput}`
     }
     return await session._handleSystemMessageTransform(params.sections);
   }
-  async handleCanvasProviderRequest(actionName, params) {
-    if (!isCanvasProviderRequestParams(params)) {
-      throw new Error("Invalid canvas provider request payload");
-    }
-    const session = this.sessions.get(params.sessionId);
-    if (!session) {
-      throw new Error(`Session not found: ${params.sessionId}`);
-    }
-    const canvas = session.getCanvas(params.canvasId);
-    if (!canvas) {
-      throw new Error(`No canvas registered with id "${params.canvasId}"`);
-    }
-    return (0, import_canvas.dispatchCanvasProviderRequest)(canvas, actionName, params);
-  }
-  async handleCanvasActionInvokeRequest(params) {
-    if (!isCanvasActionInvokeParams(params)) {
-      throw new Error("Invalid canvas provider request payload");
-    }
-    return this.handleCanvasProviderRequest(params.actionName, params);
-  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/generated/rpc.js

@@ -275,7 +275,7 @@ function createServerRpc(connection) {
        *
        * @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: async (params) => connection.sendRequest("sessions.enrichMetadata", params),
       /**
@@ -538,7 +538,15 @@ function createSessionRpc(connection, sessionId) {
        *
        * @returns Descriptor for the saved paste file, or null when the workspace is unavailable.
        */
-      saveLargePaste: async (params) => connection.sendRequest("session.workspaces.saveLargePaste", { sessionId, ...params })
+      saveLargePaste: async (params) => connection.sendRequest("session.workspaces.saveLargePaste", { sessionId, ...params }),
+      /**
+       * Computes a diff for the session workspace.
+       *
+       * @param params Parameters for computing a workspace diff.
+       *
+       * @returns Workspace diff result for the requested mode.
+       */
+      diff: async (params) => connection.sendRequest("session.workspaces.diff", { sessionId, ...params })
     },
     /** @experimental */
     instructions: {
@@ -1458,6 +1466,21 @@ function registerClientSessionApiHandlers(connection, getHandlers) {
     if (!handler) throw new Error(`No sessionFs handler registered for session: ${params.sessionId}`);
     return handler.sqliteExists(params);
   });
+  connection.onRequest("canvas.open", async (params) => {
+    const handler = getHandlers(params.sessionId).canvas;
+    if (!handler) throw new Error(`No canvas handler registered for session: ${params.sessionId}`);
+    return handler.open(params);
+  });
+  connection.onRequest("canvas.close", async (params) => {
+    const handler = getHandlers(params.sessionId).canvas;
+    if (!handler) throw new Error(`No canvas handler registered for session: ${params.sessionId}`);
+    return handler.close(params);
+  });
+  connection.onRequest("canvas.invokeAction", async (params) => {
+    const handler = getHandlers(params.sessionId).canvas;
+    if (!handler) throw new Error(`No canvas handler registered for session: ${params.sessionId}`);
+    return handler.invokeAction(params);
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/session.js

@@ -23,6 +23,7 @@ __export(session_exports, {
 module.exports = __toCommonJS(session_exports);
 var import_node = require("vscode-jsonrpc/node.js");
 var import_rpc = require("./generated/rpc.js");
+var import_canvas = require("./canvas.js");
 var import_telemetry = require("./telemetry.js");
 function deserializeHookInput(raw) {
   if (!raw || typeof raw !== "object" || typeof raw.timestamp !== "number") {
@@ -401,22 +402,52 @@ class CopilotSession {
    */
   registerCanvases(canvases) {
     this.canvases.clear();
-    if (!canvases) {
+    if (!canvases || canvases.length === 0) {
+      delete this.clientSessionApis.canvas;
       return;
     }
     for (const canvas of canvases) {
       this.canvases.set(canvas.declaration.id, canvas);
     }
-  }
-  /**
-   * Retrieves a registered canvas by id.
-   *
-   * @param canvasId - The id of the canvas to retrieve
-   * @returns The registered Canvas if found, or undefined
-   * @internal Used by the SDK's direct `canvas.*` dispatcher.
-   */
-  getCanvas(canvasId) {
-    return this.canvases.get(canvasId);
+    const self = this;
+    this.clientSessionApis.canvas = {
+      async open(params) {
+        const canvas = self.canvases.get(params.canvasId);
+        if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
+        try {
+          return await canvas.open(params) ?? {};
+        } catch (error) {
+          throw toCanvasRpcError(error);
+        }
+      },
+      async close(params) {
+        const canvas = self.canvases.get(params.canvasId);
+        if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
+        try {
+          if (canvas.onClose) {
+            await canvas.onClose(params);
+          }
+        } catch (error) {
+          throw toCanvasRpcError(error);
+        }
+      },
+      async invokeAction(params) {
+        const canvas = self.canvases.get(params.canvasId);
+        if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
+        const handler = canvas.actionHandlers.get(params.actionName);
+        if (!handler) {
+          throw new import_canvas.CanvasError(
+            "canvas_action_no_handler",
+            "No handler implemented for this canvas action"
+          );
+        }
+        try {
+          return await handler(params);
+        } catch (error) {
+          throw toCanvasRpcError(error);
+        }
+      }
+    };
   }
   /**
    * Registers command handlers for this session.
@@ -867,6 +898,12 @@ function isToolResultObject(value) {
   ];
   return allowedResultTypes.includes(value.resultType);
 }
+function toCanvasRpcError(error) {
+  if (error instanceof import_node.ResponseError) return error;
+  const code = error instanceof import_canvas.CanvasError ? error.code : "canvas_handler_error";
+  const message = error instanceof Error ? error.message : String(error);
+  return new import_node.ResponseError(import_node.ErrorCodes.InternalError, message, { code, message });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CopilotSession

package/dist/client.d.ts

@@ -467,6 +467,4 @@ export declare class CopilotClient {
     private handleAutoModeSwitchRequest;
     private handleHooksInvoke;
     private handleSystemMessageTransform;
-    private handleCanvasProviderRequest;
-    private handleCanvasActionInvokeRequest;
 }

package/dist/client.js

@@ -17,9 +17,6 @@ import {
   createInternalServerRpc,
   registerClientSessionApiHandlers
 } from "./generated/rpc.js";
-import {
-  dispatchCanvasProviderRequest
-} from "./canvas.js";
 import { getSdkProtocolVersion } from "./sdkProtocolVersion.js";
 import { CopilotSession } from "./session.js";
 import { createSessionFsAdapter } from "./sessionFsProvider.js";
@@ -56,16 +53,6 @@ function toWireCustomAgents(agents) {
     return { ...rest, mcpServers: toWireMcpServers(mcpServers) };
   });
 }
-function isCanvasProviderRequestParams(params) {
-  if (!params || typeof params !== "object") {
-    return false;
-  }
-  const request = params;
-  return typeof request.sessionId === "string" && typeof request.extensionId === "string" && typeof request.canvasId === "string" && typeof request.instanceId === "string";
-}
-function isCanvasActionInvokeParams(params) {
-  return isCanvasProviderRequestParams(params) && typeof params.actionName === "string";
-}
 function extractTransformCallbacks(systemMessage) {
   if (!systemMessage || systemMessage.mode !== "customize" || !systemMessage.sections) {
     return { wirePayload: systemMessage, transformCallbacks: void 0 };
@@ -1397,18 +1384,6 @@ stderr: ${stderrOutput}`
       "systemMessage.transform",
       async (params) => await this.handleSystemMessageTransform(params)
     );
-    this.connection.onRequest(
-      "canvas.open",
-      async (params) => this.handleCanvasProviderRequest("canvas.open", params)
-    );
-    this.connection.onRequest(
-      "canvas.close",
-      async (params) => this.handleCanvasProviderRequest("canvas.close", params)
-    );
-    this.connection.onRequest(
-      "canvas.action.invoke",
-      async (params) => this.handleCanvasActionInvokeRequest(params)
-    );
     const sessions = this.sessions;
     registerClientSessionApiHandlers(this.connection, (sessionId) => {
       const session = sessions.get(sessionId);
@@ -1530,26 +1505,6 @@ stderr: ${stderrOutput}`
     }
     return await session._handleSystemMessageTransform(params.sections);
   }
-  async handleCanvasProviderRequest(actionName, params) {
-    if (!isCanvasProviderRequestParams(params)) {
-      throw new Error("Invalid canvas provider request payload");
-    }
-    const session = this.sessions.get(params.sessionId);
-    if (!session) {
-      throw new Error(`Session not found: ${params.sessionId}`);
-    }
-    const canvas = session.getCanvas(params.canvasId);
-    if (!canvas) {
-      throw new Error(`No canvas registered with id "${params.canvasId}"`);
-    }
-    return dispatchCanvasProviderRequest(canvas, actionName, params);
-  }
-  async handleCanvasActionInvokeRequest(params) {
-    if (!isCanvasActionInvokeParams(params)) {
-      throw new Error("Invalid canvas provider request payload");
-    }
-    return this.handleCanvasProviderRequest(params.actionName, params);
-  }
 }
 export {
   CopilotClient

package/dist/extension.d.ts

@@ -1,6 +1,6 @@
 import type { CopilotSession } from "./session.js";
 import { type ExtensionInfo, type PermissionHandler, type ResumeSessionConfig } from "./types.js";
-export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasActionContext, type CanvasDeclaration, type CanvasHostContext, type CanvasJsonSchema, type CanvasLifecycleContext, type CanvasOpenContext, type CanvasOpenResponse, type CanvasOptions, } from "./canvas.js";
+export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasDeclaration, type CanvasHostContext, type CanvasJsonSchema, type CanvasOptions, } from "./canvas.js";
 export type JoinSessionConfig = Omit<ResumeSessionConfig, "onPermissionRequest"> & {
     onPermissionRequest?: PermissionHandler;
 };

package/dist/generated/rpc.d.ts

@@ -428,6 +428,24 @@ export type McpAppsSetHostContextDetailsPlatform =
  * 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.
  *
@@ -439,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.
  *
@@ -790,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"
@@ -801,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"
@@ -823,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"
@@ -1060,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.
  *
@@ -1629,6 +1687,29 @@ export interface CanvasCloseRequest {
      */
     instanceId: string;
 }
+/**
+ * Host context supplied by the runtime.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasHostContext".
+ */
+/** @experimental */
+export interface CanvasHostContext {
+    capabilities?: CanvasHostContextCapabilities;
+}
+/**
+ * Host capabilities
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasHostContextCapabilities".
+ */
+/** @experimental */
+export interface CanvasHostContextCapabilities {
+    /**
+     * Whether canvas rendering is supported
+     */
+    canvases?: boolean;
+}
 /**
  * Canvas action invocation parameters.
  *
@@ -1653,19 +1734,14 @@ export interface CanvasInvokeActionRequest {
     };
 }
 /**
- * Canvas action invocation result.
+ * Provider-supplied action result.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "CanvasInvokeActionResult".
  */
 /** @experimental */
 export interface CanvasInvokeActionResult {
-    /**
-     * Provider-supplied action result
-     */
-    result?: {
-        [k: string]: unknown | undefined;
-    };
+    [k: string]: unknown | undefined;
 }
 /**
  * Declared canvases available in this session.
@@ -1802,6 +1878,121 @@ export interface CanvasOpenRequest {
         [k: string]: unknown | undefined;
     };
 }
+/**
+ * Canvas close parameters sent to the provider.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "CanvasProviderCloseRequest".
+ */
+/** @experimental */
+export interface CanvasProviderCloseRequest {
+    /**
+     * 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.
  *
@@ -3283,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.
      */
@@ -3323,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.
      */
@@ -3342,7 +3537,6 @@ export interface McpServerConfigHttp {
      */
     oauthPublicClient?: boolean;
     oauthGrantType?: McpServerConfigHttpOauthGrantType;
-    auth?: McpServerConfigHttpAuth;
 }
 /**
  * Additional authentication configuration for this server.
@@ -3355,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.
@@ -6211,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".
@@ -6219,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[];
 }
@@ -6267,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
@@ -6291,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;
     /**
@@ -6304,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
@@ -6320,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
@@ -6332,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
@@ -6356,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
@@ -6372,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
@@ -6385,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
@@ -6398,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
@@ -6414,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
@@ -6427,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
@@ -6443,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
@@ -6456,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
@@ -6476,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
@@ -6542,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
@@ -6554,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
@@ -6577,6 +6788,7 @@ 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.
@@ -6604,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
@@ -6620,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
@@ -6649,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
@@ -9035,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.
  *
@@ -9073,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.
  *
@@ -9240,6 +9514,7 @@ export interface SessionMcpAppsCallToolResult {
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SessionFsSqliteExistsRequest".
  */
+/** @experimental */
 export interface SessionFsSqliteExistsRequest {
     /**
      * Target session identifier
@@ -9497,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>;
         /**
@@ -9748,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: {
@@ -10606,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.
@@ -10704,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.

package/dist/generated/rpc.js

@@ -249,7 +249,7 @@ function createServerRpc(connection) {
        *
        * @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: async (params) => connection.sendRequest("sessions.enrichMetadata", params),
       /**
@@ -512,7 +512,15 @@ function createSessionRpc(connection, sessionId) {
        *
        * @returns Descriptor for the saved paste file, or null when the workspace is unavailable.
        */
-      saveLargePaste: async (params) => connection.sendRequest("session.workspaces.saveLargePaste", { sessionId, ...params })
+      saveLargePaste: async (params) => connection.sendRequest("session.workspaces.saveLargePaste", { sessionId, ...params }),
+      /**
+       * Computes a diff for the session workspace.
+       *
+       * @param params Parameters for computing a workspace diff.
+       *
+       * @returns Workspace diff result for the requested mode.
+       */
+      diff: async (params) => connection.sendRequest("session.workspaces.diff", { sessionId, ...params })
     },
     /** @experimental */
     instructions: {
@@ -1432,6 +1440,21 @@ function registerClientSessionApiHandlers(connection, getHandlers) {
     if (!handler) throw new Error(`No sessionFs handler registered for session: ${params.sessionId}`);
     return handler.sqliteExists(params);
   });
+  connection.onRequest("canvas.open", async (params) => {
+    const handler = getHandlers(params.sessionId).canvas;
+    if (!handler) throw new Error(`No canvas handler registered for session: ${params.sessionId}`);
+    return handler.open(params);
+  });
+  connection.onRequest("canvas.close", async (params) => {
+    const handler = getHandlers(params.sessionId).canvas;
+    if (!handler) throw new Error(`No canvas handler registered for session: ${params.sessionId}`);
+    return handler.close(params);
+  });
+  connection.onRequest("canvas.invokeAction", async (params) => {
+    const handler = getHandlers(params.sessionId).canvas;
+    if (!handler) throw new Error(`No canvas handler registered for session: ${params.sessionId}`);
+    return handler.invokeAction(params);
+  });
 }
 export {
   createInternalServerRpc,

package/dist/index.d.ts

@@ -6,7 +6,7 @@
 export { CopilotClient } from "./client.js";
 export { RuntimeConnection } from "./types.js";
 export { CopilotSession, type AssistantMessageEvent } from "./session.js";
-export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasActionContext, type CanvasDeclaration, type CanvasHostContext, type CanvasJsonSchema, type CanvasLifecycleContext, type CanvasOpenContext, type CanvasOpenResponse, type CanvasOptions, } from "./canvas.js";
+export { Canvas, CanvasError, createCanvas, type CanvasAction, type CanvasDeclaration, type CanvasHostContext, type CanvasJsonSchema, type CanvasOptions, } from "./canvas.js";
 export { defineTool, approveAll, convertMcpCallToolResult, createSessionFsAdapter, SYSTEM_MESSAGE_SECTIONS, } from "./types.js";
 export type * from "./generated/session-events.js";
 export type { CommandContext, CommandDefinition, CommandHandler, CloudSessionOptions, CloudSessionRepository, AutoModeSwitchHandler, AutoModeSwitchRequest, AutoModeSwitchResponse, CopilotClientOptions, StdioRuntimeConnection, TcpRuntimeConnection, UriRuntimeConnection, CustomAgentConfig, ElicitationFieldValue, ElicitationHandler, ElicitationParams, ElicitationContext, ElicitationResult, ElicitationSchema, ElicitationSchemaField, ExitPlanModeHandler, ExitPlanModeRequest, ExitPlanModeResult, ExtensionInfo, ForegroundSessionInfo, GetAuthStatusResponse, GetStatusResponse, InfiniteSessionConfig, UiInputOptions, MCPStdioServerConfig, MCPHTTPServerConfig, MCPServerConfig, DefaultAgentConfig, MessageOptions, ModelBilling, ModelCapabilities, ModelCapabilitiesOverride, ModelInfo, ModelPolicy, PermissionHandler, PermissionRequest, PermissionRequestResult, ProviderConfig, RemoteSessionMode, ResumeSessionConfig, SectionOverride, SectionOverrideAction, SectionTransformFn, SessionCapabilities, SessionConfig, SessionConfigBase, SessionEvent, SessionEventHandler, SessionEventPayload, SessionEventType, SessionLifecycleEvent, SessionLifecycleEventMetadata, SessionLifecycleEventType, SessionLifecycleHandler, SessionCreatedEvent, SessionDeletedEvent, SessionUpdatedEvent, SessionForegroundEvent, SessionBackgroundEvent, SessionContext, SessionListFilter, SessionMetadata, SessionUiApi, SessionFsConfig, SessionFsProvider, SessionFsFileInfo, SessionFsSqliteQueryResult, SessionFsSqliteQueryType, SessionFsSqliteProvider, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageCustomizeConfig, SystemMessageReplaceConfig, SystemMessageSection, TelemetryConfig, TraceContext, TraceContextProvider, Tool, ToolHandler, ToolInvocation, ToolTelemetry, ToolResultObject, TypedSessionEventHandler, TypedSessionLifecycleHandler, ZodSchema, } from "./types.js";

package/dist/session.js

@@ -1,5 +1,6 @@
-import { ConnectionError, ResponseError } from "vscode-jsonrpc/node.js";
+import { ConnectionError, ErrorCodes, ResponseError } from "vscode-jsonrpc/node.js";
 import { createSessionRpc } from "./generated/rpc.js";
+import { CanvasError } from "./canvas.js";
 import { getTraceContext } from "./telemetry.js";
 function deserializeHookInput(raw) {
   if (!raw || typeof raw !== "object" || typeof raw.timestamp !== "number") {
@@ -378,22 +379,52 @@ class CopilotSession {
    */
   registerCanvases(canvases) {
     this.canvases.clear();
-    if (!canvases) {
+    if (!canvases || canvases.length === 0) {
+      delete this.clientSessionApis.canvas;
       return;
     }
     for (const canvas of canvases) {
       this.canvases.set(canvas.declaration.id, canvas);
     }
-  }
-  /**
-   * Retrieves a registered canvas by id.
-   *
-   * @param canvasId - The id of the canvas to retrieve
-   * @returns The registered Canvas if found, or undefined
-   * @internal Used by the SDK's direct `canvas.*` dispatcher.
-   */
-  getCanvas(canvasId) {
-    return this.canvases.get(canvasId);
+    const self = this;
+    this.clientSessionApis.canvas = {
+      async open(params) {
+        const canvas = self.canvases.get(params.canvasId);
+        if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
+        try {
+          return await canvas.open(params) ?? {};
+        } catch (error) {
+          throw toCanvasRpcError(error);
+        }
+      },
+      async close(params) {
+        const canvas = self.canvases.get(params.canvasId);
+        if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
+        try {
+          if (canvas.onClose) {
+            await canvas.onClose(params);
+          }
+        } catch (error) {
+          throw toCanvasRpcError(error);
+        }
+      },
+      async invokeAction(params) {
+        const canvas = self.canvases.get(params.canvasId);
+        if (!canvas) throw new Error(`No canvas registered with id "${params.canvasId}"`);
+        const handler = canvas.actionHandlers.get(params.actionName);
+        if (!handler) {
+          throw new CanvasError(
+            "canvas_action_no_handler",
+            "No handler implemented for this canvas action"
+          );
+        }
+        try {
+          return await handler(params);
+        } catch (error) {
+          throw toCanvasRpcError(error);
+        }
+      }
+    };
   }
   /**
    * Registers command handlers for this session.
@@ -844,6 +875,12 @@ function isToolResultObject(value) {
   ];
   return allowedResultTypes.includes(value.resultType);
 }
+function toCanvasRpcError(error) {
+  if (error instanceof ResponseError) return error;
+  const code = error instanceof CanvasError ? error.code : "canvas_handler_error";
+  const message = error instanceof Error ? error.message : String(error);
+  return new ResponseError(ErrorCodes.InternalError, message, { code, message });
+}
 export {
   CopilotSession
 };

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "1.0.0-beta.7",
+  "version": "1.0.0-beta.8",
   "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
   "main": "./dist/cjs/index.js",
   "types": "./dist/index.d.ts",
@@ -56,7 +56,7 @@
   "author": "GitHub",
   "license": "MIT",
   "dependencies": {
-    "@github/copilot": "^1.0.53-2",
+    "@github/copilot": "^1.0.55-1",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.6"
   },