@github/copilot-sdk 0.1.10-preview.0 → 0.1.10-preview.1

package/dist/client.d.ts

@@ -85,6 +85,7 @@ export declare class CopilotClient {
     private handleSessionEventNotification;
     private handleToolCallRequest;
     private executeToolCall;
+    private handlePermissionRequest;
     private normalizeToolResult;
     private isToolResultObject;
     private buildUnsupportedToolResult;

package/dist/client.js

@@ -217,11 +217,15 @@ class CopilotClient {
       availableTools: config.availableTools,
       excludedTools: config.excludedTools,
       provider: config.provider,
+      requestPermission: !!config.onPermissionRequest,
       streaming: config.streaming
     });
     const sessionId = response.sessionId;
     const session = new CopilotSession(sessionId, this.connection);
     session.registerTools(config.tools);
+    if (config.onPermissionRequest) {
+      session.registerPermissionHandler(config.onPermissionRequest);
+    }
     this.sessions.set(sessionId, session);
     return session;
   }
@@ -244,11 +248,15 @@ class CopilotClient {
         parameters: toJsonSchema(tool.parameters)
       })),
       provider: config.provider,
+      requestPermission: !!config.onPermissionRequest,
       streaming: config.streaming
     });
     const resumedSessionId = response.sessionId;
     const session = new CopilotSession(resumedSessionId, this.connection);
     session.registerTools(config.tools);
+    if (config.onPermissionRequest) {
+      session.registerPermissionHandler(config.onPermissionRequest);
+    }
     this.sessions.set(resumedSessionId, session);
     return session;
   }
@@ -333,8 +341,19 @@ class CopilotClient {
       const envWithoutNodeDebug = { ...this.options.env };
       delete envWithoutNodeDebug.NODE_DEBUG;
       const isJsFile = this.options.cliPath.endsWith(".js");
-      const command = isJsFile ? "node" : this.options.cliPath;
-      const spawnArgs = isJsFile ? [this.options.cliPath, ...args] : args;
+      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];
+      } else {
+        command = this.options.cliPath;
+        spawnArgs = args;
+      }
       this.cliProcess = spawn(command, spawnArgs, {
         stdio: this.options.useStdio ? ["pipe", "pipe", "pipe"] : ["ignore", "pipe", "pipe"],
         cwd: this.options.cwd,
@@ -450,6 +469,10 @@ class CopilotClient {
       "tool.call",
       async (params) => await this.handleToolCallRequest(params)
     );
+    this.connection.onRequest(
+      "permission.request",
+      async (params) => await this.handlePermissionRequest(params)
+    );
     this.connection.onClose(() => {
       if (this.state === "connected" && this.options.autoRestart) {
         void this.reconnect();
@@ -504,6 +527,25 @@ class CopilotClient {
       };
     }
   }
+  async handlePermissionRequest(params) {
+    if (!params || typeof params.sessionId !== "string" || !params.permissionRequest) {
+      throw new Error("Invalid permission request payload");
+    }
+    const session = this.sessions.get(params.sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${params.sessionId}`);
+    }
+    try {
+      const result = await session._handlePermissionRequest(params.permissionRequest);
+      return { result };
+    } catch (_error) {
+      return {
+        result: {
+          kind: "denied-no-approval-rule-and-could-not-request-from-user"
+        }
+      };
+    }
+  }
   normalizeToolResult(result) {
     if (result === void 0 || result === null) {
       return {

package/dist/index.d.ts

@@ -6,4 +6,4 @@
 export { CopilotClient } from "./client.js";
 export { CopilotSession } from "./session.js";
 export { defineTool } from "./types.js";
-export type { ConnectionState, CopilotClientOptions, MessageOptions, ResumeSessionConfig, SessionConfig, SessionEvent, SessionEventHandler, SessionMetadata, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageReplaceConfig, Tool, ToolHandler, ToolInvocation, ToolResultObject, ZodSchema, } from "./types.js";
+export type { ConnectionState, CopilotClientOptions, MessageOptions, PermissionHandler, PermissionRequest, PermissionRequestResult, ResumeSessionConfig, SessionConfig, SessionEvent, SessionEventHandler, SessionMetadata, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageReplaceConfig, Tool, ToolHandler, ToolInvocation, ToolResultObject, ZodSchema, } from "./types.js";

package/dist/session.d.ts

@@ -2,12 +2,13 @@
  * Copilot Session - represents a single conversation session with the CLI
  */
 import type { MessageConnection } from "vscode-jsonrpc/node";
-import type { MessageOptions, SessionEvent, SessionEventHandler, Tool, ToolHandler } from "./types.js";
+import type { MessageOptions, PermissionHandler, PermissionRequestResult, SessionEvent, SessionEventHandler, Tool, ToolHandler } from "./types.js";
 export declare class CopilotSession {
     readonly sessionId: string;
     private connection;
     private eventHandlers;
     private toolHandlers;
+    private permissionHandler?;
     constructor(sessionId: string, connection: MessageConnection);
     /**
      * Send a message to this session
@@ -24,6 +25,8 @@ export declare class CopilotSession {
     _dispatchEvent(event: SessionEvent): void;
     registerTools(tools?: Tool[]): void;
     getToolHandler(name: string): ToolHandler | undefined;
+    registerPermissionHandler(handler?: PermissionHandler): void;
+    _handlePermissionRequest(request: unknown): Promise<PermissionRequestResult>;
     /**
      * Get all events/messages from this session
      */

package/dist/session.js

@@ -5,6 +5,7 @@ class CopilotSession {
   }
   eventHandlers = /* @__PURE__ */ new Set();
   toolHandlers = /* @__PURE__ */ new Map();
+  permissionHandler;
   /**
    * Send a message to this session
    */
@@ -50,6 +51,22 @@ class CopilotSession {
   getToolHandler(name) {
     return this.toolHandlers.get(name);
   }
+  registerPermissionHandler(handler) {
+    this.permissionHandler = handler;
+  }
+  async _handlePermissionRequest(request) {
+    if (!this.permissionHandler) {
+      return { kind: "denied-no-approval-rule-and-could-not-request-from-user" };
+    }
+    try {
+      const result = await this.permissionHandler(request, {
+        sessionId: this.sessionId
+      });
+      return result;
+    } catch (_error) {
+      return { kind: "denied-no-approval-rule-and-could-not-request-from-user" };
+    }
+  }
   /**
    * Get all events/messages from this session
    */
@@ -68,6 +85,7 @@ class CopilotSession {
     });
     this.eventHandlers.clear();
     this.toolHandlers.clear();
+    this.permissionHandler = void 0;
   }
   /**
    * Abort the currently processing message in this session

package/dist/types.d.ts

@@ -151,6 +151,21 @@ export interface SystemMessageReplaceConfig {
  * - Replace mode: Full control, caller provides entire system message
  */
 export type SystemMessageConfig = SystemMessageAppendConfig | SystemMessageReplaceConfig;
+/**
+ * Permission request types from the server
+ */
+export interface PermissionRequest {
+    kind: "shell" | "write" | "mcp" | "read" | "url";
+    toolCallId?: string;
+    [key: string]: unknown;
+}
+export interface PermissionRequestResult {
+    kind: "approved" | "denied-by-rules" | "denied-no-approval-rule-and-could-not-request-from-user" | "denied-interactively-by-user";
+    rules?: unknown[];
+}
+export type PermissionHandler = (request: PermissionRequest, invocation: {
+    sessionId: string;
+}) => Promise<PermissionRequestResult> | PermissionRequestResult;
 export interface SessionConfig {
     /**
      * Optional custom session ID
@@ -186,18 +201,16 @@ export interface SessionConfig {
      */
     provider?: ProviderConfig;
     /**
-     * Enable streaming of assistant message and reasoning chunks.
-     * When true, ephemeral assistant.message_delta and assistant.reasoning_delta
-     * events are sent as the response is generated. Clients should accumulate
-     * deltaContent values to build the full response.
-     * @default false
+     * Handler for permission requests from the server.
+     * When provided, the server will call this handler to request permission for operations.
      */
+    onPermissionRequest?: PermissionHandler;
     streaming?: boolean;
 }
 /**
  * Configuration for resuming a session
  */
-export type ResumeSessionConfig = Pick<SessionConfig, "tools" | "provider" | "streaming">;
+export type ResumeSessionConfig = Pick<SessionConfig, "tools" | "provider" | "streaming" | "onPermissionRequest">;
 /**
  * Configuration for a custom API provider.
  */

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.10-preview.0",
+  "version": "0.1.10-preview.1",
   "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -39,7 +39,7 @@
   "author": "GitHub",
   "license": "MIT",
   "dependencies": {
-    "@github/copilot": "^0.0.377",
+    "@github/copilot": "^0.0.378-0",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.5"
   },