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

package/dist/host.d.ts

@@ -1,4 +1,4 @@
-import type { HostExitedNotification, HostPublishSessionResult, HostLocalServerOptions, HostGitHubEnvironmentOptions } from "./generated/rpc.js";
+import type { HostExitedNotification, HostPublishSessionResult, HostListSessionsResult, HostLocalServerOptions, HostGitHubEnvironmentOptions } from "./generated/rpc.js";
 import type { CopilotSession } from "./session.js";
 import type { SessionConfig, ResumeSessionConfig } from "./types.js";
 /** Host-selected defaults for a fresh application-owned session. @experimental */
@@ -30,6 +30,8 @@ export type AhpHostExit = HostExitedNotification;
  * @experimental
  */
 export interface AhpHostOptions {
+    /** Stable catalog identity; must agree with githubEnvironment.computeId when both are supplied. */
+    computeId?: string;
     /** Enable a local WebSocket listener; an empty object selects loopback defaults. */
     localServer?: HostLocalServerOptions;
     /** Register a Mission Control environment and enable remote WPS connections. */
@@ -43,7 +45,7 @@ export interface AhpHostOptions {
      */
     createSession?: (request: AhpSessionCreateRequest) => Promise<CopilotSession>;
     /**
-     * Resume a durable session previously created by an application factory.
+     * Resume a durable application-owned session, including a previously published session.
      * Return the original object from this client's resumeSession, or an existing
      * attached original without reconfiguring it. Published resident sessions
      * attach directly and never invoke this callback.
@@ -62,13 +64,14 @@ export interface AhpHostOptions {
  * the owning client also stops the host; reconnecting does not reclaim it.
  * Stopping a host does not delete its underlying sessions.
  * Its durable AHP catalog is shared by successive hosts in the runtime's
- * effective Copilot home; a concurrent host for that catalog is rejected.
+ * effective Copilot home and compute identity; a concurrent host for that catalog is rejected.
  *
  * @experimental
  */
 export declare class AhpHost {
     private readonly disposeHost;
     private readonly publishHostSession;
+    private readonly listHostSessions;
     readonly hostId: string;
     /** Local WebSocket URL. Absent when only the GitHub environment is enabled. */
     readonly url: string | undefined;
@@ -80,7 +83,9 @@ export declare class AhpHost {
     readonly pid: number | undefined;
     /** Ask the runtime to stop the listener and await its cleanup, on every call. */
     dispose(): Promise<void>;
-    /** 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: string): Promise<HostPublishSessionResult>;
+    /** List all live and dormant catalog sessions advertised by this host. */
+    listSessions(): Promise<HostListSessionsResult>;
     [Symbol.asyncDispose](): Promise<void>;
 }

package/dist/host.js

@@ -1,8 +1,9 @@
 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;
@@ -11,6 +12,7 @@ class AhpHost {
   }
   disposeHost;
   publishHostSession;
+  listHostSessions;
   hostId;
   /** Local WebSocket URL. Absent when only the GitHub environment is enabled. */
   url;
@@ -24,10 +26,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/session.d.ts

@@ -69,6 +69,7 @@ export declare class CopilotSession {
     private _capabilities;
     private openCanvasInstances;
     private disconnected;
+    private readonly pendingResponseWaits;
     private readonly pendingStructuredWaits;
     private disconnecting;
     private onDisconnected?;
@@ -173,6 +174,7 @@ export declare class CopilotSession {
     sendAndWait<TResult>(options: MessageOptions | string, responseSchema: ResponseSchema<TResult>, timeout?: number): Promise<TResult>;
     sendAndWait(options: MessageOptions, timeout?: number): Promise<AssistantMessageEvent | undefined>;
     private sendAndWaitForStructuredMessage;
+    private assertConnected;
     /**
      * Subscribes to events from this session.
      *
@@ -399,6 +401,7 @@ export declare 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.

package/dist/session.js

@@ -276,6 +276,7 @@ class CopilotSession {
   _capabilities = {};
   openCanvasInstances = [];
   disconnected = false;
+  pendingResponseWaits = /* @__PURE__ */ new Set();
   pendingStructuredWaits = /* @__PURE__ */ new Set();
   disconnecting = false;
   onDisconnected;
@@ -552,6 +553,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);
@@ -575,6 +578,7 @@ class CopilotSession {
         clearTimeout(timeoutId);
       }
       unsubscribe();
+      this.pendingResponseWaits.delete(fail);
     }
   }
   async sendAndWaitForStructuredMessage(options, timeout) {
@@ -656,12 +660,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"));
     }
@@ -670,16 +683,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();
@@ -689,18 +705,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)) {
@@ -771,7 +797,8 @@ class CopilotSession {
           args,
           handler,
           traceparent,
-          tracestate
+          tracestate,
+          event.agentId || void 0
         );
       }
     } else if (event.type === "external_tool.completed") {
@@ -862,7 +889,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;
@@ -900,7 +927,9 @@ class CopilotSession {
         availableTools,
         traceparent,
         tracestate,
-        signal: controller.signal
+        signal: controller.signal,
+        agentId,
+        requestId
       });
       let result;
       if (rawResult == null) {
@@ -1061,6 +1090,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;
@@ -1101,6 +1131,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;
@@ -1156,6 +1187,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;
@@ -1348,6 +1380,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;
@@ -1359,6 +1392,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(
@@ -1380,6 +1414,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;
@@ -1395,6 +1430,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerElicitationHandler(handler) {
+    this.assertConnected();
     this.elicitationHandler = handler;
   }
   /**
@@ -1404,6 +1440,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerExitPlanModeHandler(handler) {
+    this.assertConnected();
     this.exitPlanModeHandler = handler;
   }
   /**
@@ -1413,6 +1450,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating/resuming a session.
    */
   registerAutoModeSwitchHandler(handler) {
+    this.assertConnected();
     this.autoModeSwitchHandler = handler;
   }
   /**
@@ -1451,6 +1489,7 @@ class CopilotSession {
    * @internal
    */
   async _handleExitPlanModeRequest(request) {
+    this.assertConnected();
     if (!this.exitPlanModeHandler) {
       return { approved: true };
     }
@@ -1461,6 +1500,7 @@ class CopilotSession {
    * @internal
    */
   async _handleAutoModeSwitchRequest(request) {
+    this.assertConnected();
     if (!this.autoModeSwitchHandler) {
       return "no";
     }
@@ -1572,6 +1612,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerPermissionHandler(handler) {
+    this.assertConnected();
     this.permissionHandler = handler;
   }
   /**
@@ -1584,6 +1625,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerUserInputHandler(handler) {
+    this.assertConnected();
     this.userInputHandler = handler;
   }
   /**
@@ -1593,6 +1635,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerSkillProvider(provider) {
+    this.assertConnected();
     this.skillProvider = provider;
   }
   /**
@@ -1618,6 +1661,7 @@ class CopilotSession {
     }));
   }
   requireSkillProvider() {
+    this.assertConnected();
     if (!this.skillProvider) {
       throw new Error(`No skill provider for session: ${this.sessionId}`);
     }
@@ -1658,6 +1702,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerHooks(hooks) {
+    this.assertConnected();
     this.hooks = hooks;
   }
   /**
@@ -1667,6 +1712,7 @@ class CopilotSession {
    * @internal This method is typically called internally when creating a session.
    */
   registerTransformCallbacks(callbacks) {
+    this.assertConnected();
     this.transformCallbacks = callbacks;
   }
   /**
@@ -1678,6 +1724,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);
@@ -1702,6 +1749,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");
     }
@@ -1723,6 +1771,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;
     }
@@ -1929,6 +1978,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.
@@ -1945,8 +1995,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/types.d.ts

@@ -522,6 +522,24 @@ export interface ToolInvocation {
     tracestate?: string;
     /** Aborted when the runtime completes this request or the session disconnects. */
     signal?: AbortSignal;
+    /**
+     * Sub-agent instance that issued this call (the `agentId` of its session
+     * events). `undefined` for a root-agent call, and for every call when the
+     * runtime does not attribute sub-agent tool calls.
+     *
+     * @experimental
+     */
+    agentId?: string;
+    /**
+     * Runtime request id of this call: the key
+     * `session.tools.handlePendingToolCall` and `session.tools.listPendingRequests`
+     * use. A root-agent call stays answerable after the session is resumed with
+     * pending work continued; a sub-agent's call can be answered only while that
+     * sub-agent is still running.
+     *
+     * @experimental
+     */
+    requestId?: string;
 }
 export type ToolHandler<TArgs = unknown> = (args: TArgs, invocation: ToolInvocation) => Promise<unknown> | unknown;
 /**

package/package.json

@@ -5,8 +5,8 @@
         "url": "https://github.com/github/copilot-agent-runtime.git",
         "directory": "src/sdk/nodejs"
     },
-    "version": "1.0.18-preview.3",
-    "copilotCliVersion": "1.0.94-3",
+    "version": "1.0.18-preview.5",
+    "copilotCliVersion": "1.0.94-5",
     "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
     "main": "./dist/cjs/index.js",
     "types": "./dist/index.d.ts",
@@ -81,6 +81,7 @@
         "esbuild": "^0.28.1",
         "eslint": "^9.0.0",
         "glob": "^13.0.1",
+        "hpke-js": "^1.8.0",
         "json-schema": "^0.4.0",
         "json-schema-to-typescript": "^15.0.4",
         "prettier": "^3.8.1",
@@ -103,18 +104,18 @@
         "README.md"
     ],
     "copilotRuntime": {
-        "sourceSha": "d8cd60bc89ed3ae60cc37d7877021ac49bd52492",
-        "version": "1.0.94-3",
+        "sourceSha": "fdeb5949944ebccf3bb4dda8552a21aa1a09b6f6",
+        "version": "1.0.94-5",
         "visibility": "public"
     },
     "optionalDependencies": {
-        "@github/copilot-sdk-darwin-arm64": "1.0.18-preview.3",
-        "@github/copilot-sdk-darwin-x64": "1.0.18-preview.3",
-        "@github/copilot-sdk-linux-arm64": "1.0.18-preview.3",
-        "@github/copilot-sdk-linux-x64": "1.0.18-preview.3",
-        "@github/copilot-sdk-linuxmusl-arm64": "1.0.18-preview.3",
-        "@github/copilot-sdk-linuxmusl-x64": "1.0.18-preview.3",
-        "@github/copilot-sdk-win32-arm64": "1.0.18-preview.3",
-        "@github/copilot-sdk-win32-x64": "1.0.18-preview.3"
+        "@github/copilot-sdk-darwin-arm64": "1.0.18-preview.5",
+        "@github/copilot-sdk-darwin-x64": "1.0.18-preview.5",
+        "@github/copilot-sdk-linux-arm64": "1.0.18-preview.5",
+        "@github/copilot-sdk-linux-x64": "1.0.18-preview.5",
+        "@github/copilot-sdk-linuxmusl-arm64": "1.0.18-preview.5",
+        "@github/copilot-sdk-linuxmusl-x64": "1.0.18-preview.5",
+        "@github/copilot-sdk-win32-arm64": "1.0.18-preview.5",
+        "@github/copilot-sdk-win32-x64": "1.0.18-preview.5"
     }
 }