@github/copilot-sdk 0.1.21 → 0.1.23-preview.0

package/dist/client.d.ts

@@ -1,38 +1,5 @@
 import { CopilotSession } from "./session.js";
 import type { ConnectionState, CopilotClientOptions, GetAuthStatusResponse, GetStatusResponse, ModelInfo, ResumeSessionConfig, SessionConfig, SessionLifecycleEventType, SessionLifecycleHandler, SessionMetadata, TypedSessionLifecycleHandler } from "./types.js";
-/**
- * Main client for interacting with the Copilot CLI.
- *
- * The CopilotClient manages the connection to the Copilot CLI server and provides
- * methods to create and manage conversation sessions. It can either spawn a CLI
- * server process or connect to an existing server.
- *
- * @example
- * ```typescript
- * import { CopilotClient } from "@github/copilot-sdk";
- *
- * // Create a client with default options (spawns CLI server)
- * const client = new CopilotClient();
- *
- * // Or connect to an existing server
- * const client = new CopilotClient({ cliUrl: "localhost:3000" });
- *
- * // Create a session
- * const session = await client.createSession({ model: "gpt-4" });
- *
- * // Send messages and handle responses
- * session.on((event) => {
- *   if (event.type === "assistant.message") {
- *     console.log(event.data.content);
- *   }
- * });
- * await session.send({ prompt: "Hello!" });
- *
- * // Clean up
- * await session.destroy();
- * await client.stop();
- * ```
- */
 export declare class CopilotClient {
     private cliProcess;
     private connection;

package/dist/client.js

@@ -1,5 +1,8 @@
 import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
 import { Socket } from "node:net";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import {
   createMessageConnection,
   StreamMessageReader,
@@ -17,6 +20,11 @@ function toJsonSchema(parameters) {
   }
   return parameters;
 }
+function getBundledCliPath() {
+  const sdkUrl = import.meta.resolve("@github/copilot/sdk");
+  const sdkPath = fileURLToPath(sdkUrl);
+  return join(dirname(dirname(sdkPath)), "index.js");
+}
 class CopilotClient {
   cliProcess = null;
   connection = null;
@@ -69,7 +77,7 @@ class CopilotClient {
       this.isExternalServer = true;
     }
     this.options = {
-      cliPath: options.cliPath || "copilot",
+      cliPath: options.cliPath || getBundledCliPath(),
       cliArgs: options.cliArgs ?? [],
       cwd: options.cwd ?? process.cwd(),
       port: options.port || 0,
@@ -391,7 +399,11 @@ class CopilotClient {
     }
     const response = await this.connection.sendRequest("session.resume", {
       sessionId,
+      model: config.model,
       reasoningEffort: config.reasoningEffort,
+      systemMessage: config.systemMessage,
+      availableTools: config.availableTools,
+      excludedTools: config.excludedTools,
       tools: config.tools?.map((tool) => ({
         name: tool.name,
         description: tool.description,
@@ -402,11 +414,13 @@ class CopilotClient {
       requestUserInput: !!config.onUserInputRequest,
       hooks: !!(config.hooks && Object.values(config.hooks).some(Boolean)),
       workingDirectory: config.workingDirectory,
+      configDir: config.configDir,
       streaming: config.streaming,
       mcpServers: config.mcpServers,
       customAgents: config.customAgents,
       skillDirectories: config.skillDirectories,
       disabledSkills: config.disabledSkills,
+      infiniteSessions: config.infiniteSessions,
       disableResume: config.disableResume
     });
     const { sessionId: resumedSessionId, workspacePath } = response;
@@ -707,25 +721,26 @@ class CopilotClient {
       if (this.options.githubToken) {
         envWithoutNodeDebug.COPILOT_SDK_AUTH_TOKEN = this.options.githubToken;
       }
+      if (!existsSync(this.options.cliPath)) {
+        throw new Error(
+          `Copilot CLI not found at ${this.options.cliPath}. Ensure @github/copilot is installed.`
+        );
+      }
+      const stdioConfig = this.options.useStdio ? ["pipe", "pipe", "pipe"] : ["ignore", "pipe", "pipe"];
       const isJsFile = this.options.cliPath.endsWith(".js");
-      const isAbsolutePath = this.options.cliPath.startsWith("/") || /^[a-zA-Z]:/.test(this.options.cliPath);
-      let command;
-      let spawnArgs;
       if (isJsFile) {
-        command = "node";
-        spawnArgs = [this.options.cliPath, ...args];
-      } else if (process.platform === "win32" && !isAbsolutePath) {
-        command = "cmd";
-        spawnArgs = ["/c", `${this.options.cliPath}`, ...args];
+        this.cliProcess = spawn(process.execPath, [this.options.cliPath, ...args], {
+          stdio: stdioConfig,
+          cwd: this.options.cwd,
+          env: envWithoutNodeDebug
+        });
       } else {
-        command = this.options.cliPath;
-        spawnArgs = args;
+        this.cliProcess = spawn(this.options.cliPath, args, {
+          stdio: stdioConfig,
+          cwd: this.options.cwd,
+          env: envWithoutNodeDebug
+        });
       }
-      this.cliProcess = spawn(command, spawnArgs, {
-        stdio: this.options.useStdio ? ["pipe", "pipe", "pipe"] : ["ignore", "pipe", "pipe"],
-        cwd: this.options.cwd,
-        env: envWithoutNodeDebug
-      });
       let stdout = "";
       let resolved = false;
       if (this.options.useStdio) {

package/dist/session.js

@@ -96,10 +96,11 @@ class CopilotSession {
         rejectWithError(error);
       }
     });
+    let timeoutId;
     try {
       await this.send(options);
       const timeoutPromise = new Promise((_, reject) => {
-        setTimeout(
+        timeoutId = setTimeout(
           () => reject(
             new Error(
               `Timeout after ${effectiveTimeout}ms waiting for session.idle`
@@ -111,6 +112,9 @@ class CopilotSession {
       await Promise.race([idlePromise, timeoutPromise]);
       return lastAssistantMessage;
     } finally {
+      if (timeoutId !== void 0) {
+        clearTimeout(timeoutId);
+      }
       unsubscribe();
     }
   }

package/dist/types.d.ts

@@ -8,8 +8,8 @@ export type SessionEvent = GeneratedSessionEvent;
  */
 export interface CopilotClientOptions {
     /**
-     * Path to the Copilot CLI executable
-     * @default "copilot" (searches PATH)
+     * Path to the CLI executable or JavaScript entry point.
+     * If not specified, uses the bundled CLI from the @github/copilot package.
      */
     cliPath?: string;
     /**
@@ -587,7 +587,7 @@ export interface SessionConfig {
 /**
  * Configuration for resuming a session
  */
-export type ResumeSessionConfig = Pick<SessionConfig, "tools" | "provider" | "streaming" | "reasoningEffort" | "onPermissionRequest" | "onUserInputRequest" | "hooks" | "workingDirectory" | "mcpServers" | "customAgents" | "skillDirectories" | "disabledSkills"> & {
+export type ResumeSessionConfig = Pick<SessionConfig, "model" | "tools" | "systemMessage" | "availableTools" | "excludedTools" | "provider" | "streaming" | "reasoningEffort" | "onPermissionRequest" | "onUserInputRequest" | "hooks" | "workingDirectory" | "configDir" | "mcpServers" | "customAgents" | "skillDirectories" | "disabledSkills" | "infiniteSessions"> & {
     /**
      * When true, skips emitting the session.resume event.
      * Useful for reconnecting to a session without triggering resume-related side effects.
@@ -640,12 +640,31 @@ export interface MessageOptions {
      */
     prompt: string;
     /**
-     * File or directory attachments
+     * File, directory, or selection attachments
      */
     attachments?: Array<{
-        type: "file" | "directory";
+        type: "file";
         path: string;
         displayName?: string;
+    } | {
+        type: "directory";
+        path: string;
+        displayName?: string;
+    } | {
+        type: "selection";
+        filePath: string;
+        displayName: string;
+        selection?: {
+            start: {
+                line: number;
+                character: number;
+            };
+            end: {
+                line: number;
+                character: number;
+            };
+        };
+        text?: string;
     }>;
     /**
      * Message delivery mode

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.21",
+  "version": "0.1.23-preview.0",
   "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -40,9 +40,9 @@
   "author": "GitHub",
   "license": "MIT",
   "dependencies": {
-    "@github/copilot": "^0.0.402",
+    "@github/copilot": "^0.0.403",
     "vscode-jsonrpc": "^8.2.1",
-    "zod": "^4.3.5"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.2.0",
@@ -50,10 +50,10 @@
     "@typescript-eslint/parser": "^8.54.0",
     "esbuild": "^0.27.2",
     "eslint": "^9.0.0",
-    "glob": "^11.0.0",
+    "glob": "^13.0.1",
     "json-schema": "^0.4.0",
     "json-schema-to-typescript": "^15.0.4",
-    "prettier": "^3.4.0",
+    "prettier": "^3.8.1",
     "quicktype-core": "^23.2.6",
     "rimraf": "^6.1.2",
     "semver": "^7.7.3",
@@ -62,7 +62,7 @@
     "vitest": "^4.0.18"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=24.0.0"
   },
   "files": [
     "dist/**/*",