@github/copilot-sdk 0.1.22 → 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,
@@ -713,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/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;
     /**

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.22",
+  "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",
@@ -62,7 +62,7 @@
     "vitest": "^4.0.18"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=24.0.0"
   },
   "files": [
     "dist/**/*",