@github/copilot-sdk 1.0.18-preview.3 → 1.0.18-preview.5

package/README.md

@@ -74,6 +74,9 @@ without deleting underlying sessions. Reconnecting does not reclaim a host.
 The optional `onExit` callback reports exits at most once. If the owner connection
 is lost, it reports that loss rather than claiming that listener cleanup was
 acknowledged.
+Call `const { sessions } = await host.listSessions()` to read the complete catalog
+of live and dormant sessions advertised by the host. The method returns a
+`HostListSessionsResult` containing `sessions`, not a session array directly.
 
 `host.pid` is absent for in-process listeners. The optional field is retained
 for separate host process IDs returned by legacy runtimes, never the runtime PID.
@@ -104,6 +107,10 @@ The listener follows the owning client's lifetime. Call `await host.dispose()`
 only when you want to stop it earlier; `await using host` also supports a shorter
 scope. Each disposal call forwards to the runtime, which owns idempotent cleanup.
 The AHP transport remains owned by the host.
+Set top-level `computeId` to reuse the same durable catalog for local and Mission
+Control hosting; it must agree with `githubEnvironment.computeId` when both are
+supplied. Omitted local-only identities are persisted by the runtime, not generated
+by the SDK. Published sessions remain discoverable after hosting stops.
 
 ### Application-owned sessions
 
@@ -165,8 +172,9 @@ still matches the requested identity and workspace.
 Only catalog entries marked as application-owned invoke this callback.
 If the callback is missing, restoring such an entry fails instead of falling
 back to host-owned creation.
-Published resident sessions attach directly, without invoking it or replacing
-their current registrations. Resumed sessions follow the same original-object
+Currently resident published sessions attach directly, without invoking it or replacing
+their current registrations. Dormant published application sessions require this
+resume callback to restore their tools and handlers. Resumed sessions follow the same original-object
 retention, cancellation, late-result release, and `onSessionReleased` rules.
 
 The `copilotd-hosting` library runs inside the runtime provider.
@@ -345,6 +353,11 @@ This graceful-exit timeout is separate from the shutdown RPC and post-terminatio
 ##### `forceStop(): Promise<void>`
 
 Force stop the CLI server without graceful cleanup. Use when `stop()` takes too long.
+Retained sessions are disconnected locally, and pending `sendAndWait()` calls reject
+without waiting for `session.idle` or their response timeout.
+Retirement releases session-owned tool, hook, auth/input, provider, workflow, canvas,
+and transform registrations without changing caller-owned configuration. Late
+registration and callback dispatch are rejected; callbacks already admitted may finish.
 
 ##### `createSession(config?: SessionConfig): Promise<CopilotSession>`
 

package/dist/cjs/cliVersion.js

@@ -22,7 +22,7 @@ __export(cliVersion_exports, {
   COPILOT_CLI_VERSION: () => COPILOT_CLI_VERSION
 });
 module.exports = __toCommonJS(cliVersion_exports);
-const COPILOT_CLI_VERSION = "1.0.94-3";
+const COPILOT_CLI_VERSION = "1.0.94-5";
 const COPILOT_CLI_USE_NPM_PACKAGE = false;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/client.js

@@ -1713,7 +1713,7 @@ class CopilotClient {
    * This connection owns the host. Disposing it or disconnecting the client
    * stops the listener without deleting sessions. The host uses a separate
    * SDK connection to the same runtime, not another runtime process.
-   * Only one AHP host may own the catalog in an effective Copilot home
+   * Only one AHP host may own a compute-scoped catalog in an effective Copilot home
    * at a time. Other SDK clients and sessions remain usable in that home.
    * Select localServer, githubEnvironment, or both. An empty localServer
    * selects 127.0.0.1 on an available port. `onExit` runs at most once; owner disconnection cannot
@@ -1731,6 +1731,7 @@ class CopilotClient {
     const rpc = this.rpc;
     const hostId = (0, import_node_crypto.randomUUID)();
     const {
+      computeId,
       localServer,
       githubEnvironment,
       onExit,
@@ -1751,6 +1752,7 @@ class CopilotClient {
     try {
       const info = await rpc.host.start({
         hostId,
+        computeId,
         localServer,
         githubEnvironment,
         sessionFactory: createSession ? true : void 0,
@@ -1761,7 +1763,8 @@ class CopilotClient {
         async () => {
           await rpc.host.dispose({ hostId });
         },
-        (sessionId) => rpc.host.publishSession({ hostId, sessionId })
+        (sessionId) => rpc.host.publishSession({ hostId, sessionId }),
+        () => rpc.host.listSessions({ hostId })
       );
     } catch (error) {
       this.hostExitCallbacks.delete(hostId);

package/dist/cjs/generated/rpc.js

@@ -65,6 +65,14 @@ function createServerRpc(connection) {
        * @returns The existing runtime identity and its resource on the listener.
        */
       publishSession: async (params) => connection.sendRequest("host.publishSession", params),
+      /**
+       * Reads the complete advertised live and dormant session catalog of an existing host owned by this connection. Does not start hosting, subscribe to sessions, or guarantee resumability.
+       *
+       * @param params Reads a running host's catalog or the runtime's saved default catalog.
+       *
+       * @returns The complete live and dormant advertised catalog, without subscribing to sessions.
+       */
+      listSessions: async (params) => connection.sendRequest("host.listSessions", params),
       /**
        * Starts a connection-owned AHP host with explicit localServer and/or githubEnvironment transports as a supervised SDK participant.
        *
@@ -2710,6 +2718,12 @@ function createSessionRpc(connection, sessionId) {
        * @returns Indicates whether the external tool call result was handled successfully.
        */
       handlePendingToolCall: async (params) => connection.sendRequest("session.tools.handlePendingToolCall", { ...params, sessionId }),
+      /**
+       * Lists the external tool calls of the session and its sub-agents that are still waiting for session.tools.handlePendingToolCall.
+       *
+       * @returns External tool calls still waiting for a result.
+       */
+      listPendingRequests: async () => connection.sendRequest("session.tools.listPendingRequests", { sessionId }),
       /**
        * Resolves, builds, and validates the runtime tool list for the session.
        *
@@ -3399,6 +3413,27 @@ function createSessionRpc(connection, sessionId) {
       getMetrics: async () => connection.sendRequest("session.usage.getMetrics", { sessionId })
     },
     /** @experimental */
+    quota: {
+      /**
+       * Gets the session's current quota and account projection without making a network request.
+       *
+       * @returns The incumbent session-owned quota and account projection.
+       */
+      get: async () => connection.sendRequest("session.quota.get", { sessionId }),
+      /**
+       * Refreshes the session's provider model catalog bypassing its cache, folds quota snapshots into session state, and returns the updated projection. Failures leave the last known quota intact.
+       *
+       * @returns The incumbent session-owned quota and account projection.
+       */
+      refresh: async () => connection.sendRequest("session.quota.refresh", { sessionId }),
+      /**
+       * Returns and clears the session's pending quota warnings. Reading or refreshing quota does not drain warnings.
+       *
+       * @returns Pending warnings returned and cleared by session.quota.takeWarnings.
+       */
+      takeWarnings: async () => connection.sendRequest("session.quota.takeWarnings", { sessionId })
+    },
+    /** @experimental */
     limitPrediction: {
       /**
        * Predicts an AI-credit session limit for the session's resolved model. Returns an unavailable result instead of falling back when the current model is unresolved auto.
@@ -3585,7 +3620,11 @@ function createInternalSessionRpc(connection, sessionId) {
        *
        * @returns The model identifier active on the session after the switch.
        */
-      applyStartupOverlay: async (params) => connection.sendRequest("session.model.applyStartupOverlay", { ...params, sessionId })
+      applyStartupOverlay: async (params) => connection.sendRequest("session.model.applyStartupOverlay", { ...params, sessionId }),
+      /**
+       * Clears an unchanged startup model/provider seed before default-model resolution. Never clears a resumed or user-selected model.
+       */
+      clearStartupSeed: async (params) => connection.sendRequest("session.model.clearStartupSeed", { ...params, sessionId })
     },
     /** @experimental */
     mcp: {
@@ -3752,6 +3791,15 @@ function createInternalSessionRpc(connection, sessionId) {
       process: async () => connection.sendRequest("session.queue.process", { sessionId })
     },
     /** @experimental */
+    usage: {
+      /**
+       * Internal host-only replacement of absolute code-change totals reported by a relay host.
+       *
+       * @param params Internal absolute code-change totals reported by the owning host.
+       */
+      setCodeChanges: async (params) => connection.sendRequest("session.usage.setCodeChanges", { ...params, sessionId })
+    },
+    /** @experimental */
     schedule: {
       /**
        * Hydrates the native schedule registry from persisted session events.

package/dist/cjs/host.js

@@ -23,9 +23,10 @@ __export(host_exports, {
 module.exports = __toCommonJS(host_exports);
 class AhpHost {
   /** @internal */
-  constructor(info, disposeHost, publishHostSession) {
+  constructor(info, disposeHost, publishHostSession, listHostSessions) {
     this.disposeHost = disposeHost;
     this.publishHostSession = publishHostSession;
+    this.listHostSessions = listHostSessions;
     this.hostId = info.hostId;
     this.url = info.url;
     this.environmentId = info.environmentId;
@@ -34,6 +35,7 @@ class AhpHost {
   }
   disposeHost;
   publishHostSession;
+  listHostSessions;
   hostId;
   /** Local WebSocket URL. Absent when only the GitHub environment is enabled. */
   url;
@@ -47,10 +49,14 @@ class AhpHost {
   dispose() {
     return this.disposeHost();
   }
-  /** Publish an existing session attached to this client, until this listener stops. */
+  /** Publish an attached application session into the durable compute-scoped host catalog. */
   publishSession(sessionId) {
     return this.publishHostSession(sessionId);
   }
+  /** List all live and dormant catalog sessions advertised by this host. */
+  listSessions() {
+    return this.listHostSessions();
+  }
   async [Symbol.asyncDispose]() {
     await this.dispose();
   }

package/dist/cjs/session.js

@@ -294,6 +294,7 @@ class CopilotSession {
   _capabilities = {};
   openCanvasInstances = [];
   disconnected = false;
+  pendingResponseWaits = /* @__PURE__ */ new Set();
   pendingStructuredWaits = /* @__PURE__ */ new Set();
   disconnecting = false;
   onDisconnected;
@@ -570,6 +571,8 @@ class CopilotSession {
         resolveOutcome({ kind: "error", error });
       }
     });
+    const fail = (error) => resolveOutcome({ kind: "error", error });
+    this.pendingResponseWaits.add(fail);
     let timeoutId;
     try {
       await this.send(options);
@@ -593,6 +596,7 @@ class CopilotSession {
         clearTimeout(timeoutId);
       }
       unsubscribe();
+      this.pendingResponseWaits.delete(fail);
     }
   }
   async sendAndWaitForStructuredMessage(options, timeout) {
@@ -674,12 +678,21 @@ class CopilotSession {
       this.pendingStructuredWaits.delete(fail);
     }
   }
+  assertConnected() {
+    if (this.disconnected) {
+      throw new Error("Session is disconnected");
+    }
+  }
   /** @internal */
   _markDisconnected() {
     if (this.disconnected) {
       return;
     }
     this.disconnected = true;
+    for (const fail of this.pendingResponseWaits) {
+      fail(new Error("Session disconnected while waiting for a response"));
+    }
+    this.pendingResponseWaits.clear();
     for (const fail of this.pendingStructuredWaits) {
       fail(new Error("Session disconnected while waiting for a structured response"));
     }
@@ -688,16 +701,19 @@ class CopilotSession {
       controller.abort();
     }
     this.pendingExternalTools.clear();
-    this._runOnDisconnected();
     this.eventHandlers.clear();
     this.typedEventHandlers.clear();
     this.toolHandlers.clear();
     this.permissionHandler = void 0;
+    this.mcpAuthHandler = void 0;
     this.userInputHandler = void 0;
     this.elicitationHandler = void 0;
     this.exitPlanModeHandler = void 0;
     this.autoModeSwitchHandler = void 0;
     this.skillProvider = void 0;
+    this.hooks = void 0;
+    this.traceContextProvider = void 0;
+    this.bearerTokenProviders.clear();
     this.commandHandlers.clear();
     this.canvases.clear();
     this.workflows.clear();
@@ -707,18 +723,28 @@ class CopilotSession {
       }
     }
     this.workflowAbortControllers.clear();
-    this.transformCallbacks?.clear();
+    this.transformCallbacks = void 0;
+    delete this.clientSessionApis.providerToken;
+    delete this.clientSessionApis.canvas;
+    delete this.clientSessionApis.workflow;
+    delete this.clientSessionApis.sessionFs;
+    this._runOnDisconnected();
   }
   /** @internal */
   _runOnDisconnected() {
-    this.onDisconnected?.();
+    const callback = this.onDisconnected;
     this.onDisconnected = void 0;
+    callback?.();
   }
   /** @internal */
   _setOnDisconnected(callback) {
+    this.assertConnected();
     this.onDisconnected = callback;
   }
   on(eventTypeOrHandler, handler) {
+    if (this.disconnected) {
+      throw new Error("Session is disconnected");
+    }
     if (typeof eventTypeOrHandler === "string" && handler) {
       const eventType = eventTypeOrHandler;
       if (!this.typedEventHandlers.has(eventType)) {
@@ -789,7 +815,8 @@ class CopilotSession {
           args,
           handler,
           traceparent,
-          tracestate
+          tracestate,
+          event.agentId || void 0
         );
       }
     } else if (event.type === "external_tool.completed") {
@@ -880,7 +907,7 @@ class CopilotSession {
    * Executes a tool handler and sends the result back via RPC.
    * @internal
    */
-  async _executeToolAndRespond(requestId, toolName, toolCallId, args, handler, traceparent, tracestate) {
+  async _executeToolAndRespond(requestId, toolName, toolCallId, args, handler, traceparent, tracestate, agentId) {
     const controller = new AbortController();
     if (this.disconnected || this.pendingExternalTools.has(requestId)) {
       return;
@@ -918,7 +945,9 @@ class CopilotSession {
         availableTools,
         traceparent,
         tracestate,
-        signal: controller.signal
+        signal: controller.signal,
+        agentId,
+        requestId
       });
       let result;
       if (rawResult == null) {
@@ -1079,6 +1108,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session with tools.
    */
   registerTools(tools) {
+    this.assertConnected();
     this.toolHandlers.clear();
     if (!tools) {
       return;
@@ -1119,6 +1149,7 @@ class CopilotSession {
    * @internal Called by the SDK when creating/resuming a session with `canvases`.
    */
   registerCanvases(canvases) {
+    this.assertConnected();
     this.canvases.clear();
     if (!canvases || canvases.length === 0) {
       delete this.clientSessionApis.canvas;
@@ -1174,6 +1205,7 @@ class CopilotSession {
    * @internal Called by the SDK when an extension joins a session.
    */
   registerWorkflows(workflows) {
+    this.assertConnected();
     this.workflows.clear();
     if (!workflows || workflows.length === 0) {
       delete this.clientSessionApis.workflow;
@@ -1366,6 +1398,7 @@ class CopilotSession {
    * @internal This method is called internally when creating/resuming a session.
    */
   registerBearerTokenProviders(providers) {
+    this.assertConnected();
     this.bearerTokenProviders.clear();
     if (!providers || providers.size === 0) {
       delete this.clientSessionApis.providerToken;
@@ -1377,6 +1410,7 @@ class CopilotSession {
     const self = this;
     this.clientSessionApis.providerToken = {
       async getToken(params) {
+        self.assertConnected();
         const callback = self.bearerTokenProviders.get(params.providerName);
         if (!callback) {
           throw new Error(
@@ -1398,6 +1432,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerCommands(commands) {
+    this.assertConnected();
     this.commandHandlers.clear();
     if (!commands) {
       return;
@@ -1413,6 +1448,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerElicitationHandler(handler) {
+    this.assertConnected();
     this.elicitationHandler = handler;
   }
   /**
@@ -1422,6 +1458,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerExitPlanModeHandler(handler) {
+    this.assertConnected();
     this.exitPlanModeHandler = handler;
   }
   /**
@@ -1431,6 +1468,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerAutoModeSwitchHandler(handler) {
+    this.assertConnected();
     this.autoModeSwitchHandler = handler;
   }
   /**
@@ -1469,6 +1507,7 @@ class CopilotSession {
    * @internal
    */
   async _handleExitPlanModeRequest(request) {
+    this.assertConnected();
     if (!this.exitPlanModeHandler) {
       return { approved: true };
     }
@@ -1479,6 +1518,7 @@ class CopilotSession {
    * @internal
    */
   async _handleAutoModeSwitchRequest(request) {
+    this.assertConnected();
     if (!this.autoModeSwitchHandler) {
       return "no";
     }
@@ -1590,6 +1630,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerPermissionHandler(handler) {
+    this.assertConnected();
     this.permissionHandler = handler;
   }
   /**
@@ -1602,6 +1643,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerUserInputHandler(handler) {
+    this.assertConnected();
     this.userInputHandler = handler;
   }
   /**
@@ -1611,6 +1653,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerSkillProvider(provider) {
+    this.assertConnected();
     this.skillProvider = provider;
   }
   /**
@@ -1636,6 +1679,7 @@ class CopilotSession {
     }));
   }
   requireSkillProvider() {
+    this.assertConnected();
     if (!this.skillProvider) {
       throw new Error(`No skill provider for session: ${this.sessionId}`);
     }
@@ -1676,6 +1720,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerHooks(hooks) {
+    this.assertConnected();
     this.hooks = hooks;
   }
   /**
@@ -1685,6 +1730,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerTransformCallbacks(callbacks) {
+    this.assertConnected();
     this.transformCallbacks = callbacks;
   }
   /**
@@ -1696,6 +1742,7 @@ class CopilotSession {
    * @internal This method is for internal use by the SDK.
    */
   async _handleSystemMessageTransform(sections) {
+    this.assertConnected();
     const result = {};
     for (const [sectionId, { content }] of Object.entries(sections)) {
       const callback = this.transformCallbacks?.get(sectionId);
@@ -1720,6 +1767,7 @@ class CopilotSession {
    * @internal This method is for internal use by the SDK.
    */
   async _handleUserInputRequest(request) {
+    this.assertConnected();
     if (!this.userInputHandler) {
       throw new Error("User input requested but no handler registered");
     }
@@ -1741,6 +1789,7 @@ class CopilotSession {
    * @internal This method is for internal use by the SDK.
    */
   async _handleHooksInvoke(hookType, input) {
+    this.assertConnected();
     if (!this.hooks) {
       return void 0;
     }
@@ -1947,6 +1996,7 @@ class CopilotSession {
    * replace tools while the session is idle.
    *
    * @param tools - The complete set of tools this client supplies
+   * @throws Error if the session disconnects before the replacement is applied
    *
    * @experimental Wraps the experimental `session.tools.set` RPC and may change
    * or be removed in a future release.
@@ -1963,8 +2013,10 @@ class CopilotSession {
    * ```
    */
   async setTools(tools) {
+    this.assertConnected();
     const definitions = tools.map(toToolDefinition);
     const replacement = this.setToolsQueue.then(async () => {
+      this.assertConnected();
       await this.rpc.tools.set({ tools: definitions });
       this.registerTools(tools);
     });

package/dist/cliVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const COPILOT_CLI_VERSION = "1.0.94-3";
+export declare const COPILOT_CLI_VERSION = "1.0.94-5";
 export declare const COPILOT_CLI_USE_NPM_PACKAGE = false;

package/dist/cliVersion.js

@@ -1,4 +1,4 @@
-const COPILOT_CLI_VERSION = "1.0.94-3";
+const COPILOT_CLI_VERSION = "1.0.94-5";
 const COPILOT_CLI_USE_NPM_PACKAGE = false;
 export {
   COPILOT_CLI_USE_NPM_PACKAGE,

package/dist/client.d.ts

@@ -254,7 +254,7 @@ export declare class CopilotClient {
      * This connection owns the host. Disposing it or disconnecting the client
      * stops the listener without deleting sessions. The host uses a separate
      * SDK connection to the same runtime, not another runtime process.
-     * Only one AHP host may own the catalog in an effective Copilot home
+     * Only one AHP host may own a compute-scoped catalog in an effective Copilot home
      * at a time. Other SDK clients and sessions remain usable in that home.
      * Select localServer, githubEnvironment, or both. An empty localServer
      * selects 127.0.0.1 on an available port. `onExit` runs at most once; owner disconnection cannot

package/dist/client.js

@@ -1693,7 +1693,7 @@ class CopilotClient {
    * This connection owns the host. Disposing it or disconnecting the client
    * stops the listener without deleting sessions. The host uses a separate
    * SDK connection to the same runtime, not another runtime process.
-   * Only one AHP host may own the catalog in an effective Copilot home
+   * Only one AHP host may own a compute-scoped catalog in an effective Copilot home
    * at a time. Other SDK clients and sessions remain usable in that home.
    * Select localServer, githubEnvironment, or both. An empty localServer
    * selects 127.0.0.1 on an available port. `onExit` runs at most once; owner disconnection cannot
@@ -1711,6 +1711,7 @@ class CopilotClient {
     const rpc = this.rpc;
     const hostId = randomUUID();
     const {
+      computeId,
       localServer,
       githubEnvironment,
       onExit,
@@ -1731,6 +1732,7 @@ class CopilotClient {
     try {
       const info = await rpc.host.start({
         hostId,
+        computeId,
         localServer,
         githubEnvironment,
         sessionFactory: createSession ? true : void 0,
@@ -1741,7 +1743,8 @@ class CopilotClient {
         async () => {
           await rpc.host.dispose({ hostId });
         },
-        (sessionId) => rpc.host.publishSession({ hostId, sessionId })
+        (sessionId) => rpc.host.publishSession({ hostId, sessionId }),
+        () => rpc.host.listSessions({ hostId })
       );
     } catch (error) {
       this.hostExitCallbacks.delete(hostId);