@github/copilot-sdk 1.0.18-preview.2 → 1.0.18-preview.4

package/README.md

@@ -345,6 +345,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-2";
+const COPILOT_CLI_VERSION = "1.0.94-4";
 const COPILOT_CLI_USE_NPM_PACKAGE = false;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/cjs/generated/rpc.js

@@ -2710,6 +2710,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 +3405,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 +3612,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 +3783,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/session.js

@@ -82,12 +82,12 @@ function isOpenCanvasInstance(value) {
   const instance = value;
   return typeof instance.instanceId === "string" && instance.instanceId.length > 0 && typeof instance.extensionId === "string" && instance.extensionId.length > 0 && typeof instance.canvasId === "string" && instance.canvasId.length > 0;
 }
-const FACTORY_LOG_FLUSH_DELAY_MS = 10;
-const MAX_FACTORY_FANOUT_ITEMS = 4096;
+const WORKFLOW_LOG_FLUSH_DELAY_MS = 10;
+const MAX_WORKFLOW_FANOUT_ITEMS = 4096;
 function assertWorkflowFanoutSize(kind, size) {
-  if (size > MAX_FACTORY_FANOUT_ITEMS) {
+  if (size > MAX_WORKFLOW_FANOUT_ITEMS) {
     throw new Error(
-      `${kind}() accepts at most ${MAX_FACTORY_FANOUT_ITEMS} items; got ${size}.`
+      `${kind}() accepts at most ${MAX_WORKFLOW_FANOUT_ITEMS} items; got ${size}.`
     );
   }
 }
@@ -208,7 +208,7 @@ class WorkflowProgressBuffer {
       this.flushTimer = void 0;
       void this.flush().catch(() => {
       });
-    }, FACTORY_LOG_FLUSH_DELAY_MS);
+    }, WORKFLOW_LOG_FLUSH_DELAY_MS);
     this.flushTimer.unref?.();
   }
   clearFlushTimer() {
@@ -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)) {
@@ -1079,6 +1105,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 +1146,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 +1202,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 +1395,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 +1407,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 +1429,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 +1445,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerElicitationHandler(handler) {
+    this.assertConnected();
     this.elicitationHandler = handler;
   }
   /**
@@ -1422,6 +1455,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerExitPlanModeHandler(handler) {
+    this.assertConnected();
     this.exitPlanModeHandler = handler;
   }
   /**
@@ -1431,6 +1465,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerAutoModeSwitchHandler(handler) {
+    this.assertConnected();
     this.autoModeSwitchHandler = handler;
   }
   /**
@@ -1469,6 +1504,7 @@ class CopilotSession {
    * @internal
    */
   async _handleExitPlanModeRequest(request) {
+    this.assertConnected();
     if (!this.exitPlanModeHandler) {
       return { approved: true };
     }
@@ -1479,6 +1515,7 @@ class CopilotSession {
    * @internal
    */
   async _handleAutoModeSwitchRequest(request) {
+    this.assertConnected();
     if (!this.autoModeSwitchHandler) {
       return "no";
     }
@@ -1590,6 +1627,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerPermissionHandler(handler) {
+    this.assertConnected();
     this.permissionHandler = handler;
   }
   /**
@@ -1602,6 +1640,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerUserInputHandler(handler) {
+    this.assertConnected();
     this.userInputHandler = handler;
   }
   /**
@@ -1611,6 +1650,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerSkillProvider(provider) {
+    this.assertConnected();
     this.skillProvider = provider;
   }
   /**
@@ -1636,6 +1676,7 @@ class CopilotSession {
     }));
   }
   requireSkillProvider() {
+    this.assertConnected();
     if (!this.skillProvider) {
       throw new Error(`No skill provider for session: ${this.sessionId}`);
     }
@@ -1676,6 +1717,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerHooks(hooks) {
+    this.assertConnected();
     this.hooks = hooks;
   }
   /**
@@ -1685,6 +1727,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerTransformCallbacks(callbacks) {
+    this.assertConnected();
     this.transformCallbacks = callbacks;
   }
   /**
@@ -1696,6 +1739,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 +1764,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 +1786,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 +1993,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 +2010,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-2";
+export declare const COPILOT_CLI_VERSION = "1.0.94-4";
 export declare const COPILOT_CLI_USE_NPM_PACKAGE = false;

package/dist/cliVersion.js

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