@github/copilot-sdk 0.1.30 → 0.1.31-unstable.0

package/dist/sdkProtocolVersion.d.ts

@@ -2,7 +2,7 @@
  * The SDK protocol version.
  * This must match the version expected by the copilot-agent-runtime server.
  */
-export declare const SDK_PROTOCOL_VERSION = 2;
+export declare const SDK_PROTOCOL_VERSION = 3;
 /**
  * Gets the SDK protocol version.
  * @returns The protocol version number

package/dist/sdkProtocolVersion.js

@@ -1,4 +1,4 @@
-const SDK_PROTOCOL_VERSION = 2;
+const SDK_PROTOCOL_VERSION = 3;
 function getSdkProtocolVersion() {
   return SDK_PROTOCOL_VERSION;
 }

package/dist/session.d.ts

@@ -4,7 +4,7 @@
  */
 import type { MessageConnection } from "vscode-jsonrpc/node";
 import { createSessionRpc } from "./generated/rpc.js";
-import type { MessageOptions, PermissionHandler, PermissionRequestResult, SessionEvent, SessionEventHandler, SessionEventType, SessionHooks, Tool, ToolHandler, TypedSessionEventHandler, UserInputHandler, UserInputResponse } from "./types.js";
+import type { MessageOptions, PermissionHandler, SessionEvent, SessionEventHandler, SessionEventType, SessionHooks, Tool, ToolHandler, TypedSessionEventHandler, UserInputHandler, UserInputResponse } from "./types.js";
 /** Assistant message event - the final response from the assistant. */
 export type AssistantMessageEvent = Extract<SessionEvent, {
     type: "assistant.message";
@@ -155,11 +155,29 @@ export declare class CopilotSession {
     on(handler: SessionEventHandler): () => void;
     /**
      * Dispatches an event to all registered handlers.
+     * Also handles broadcast request events internally (external tool calls, permissions).
      *
      * @param event - The session event to dispatch
      * @internal This method is for internal use by the SDK.
      */
     _dispatchEvent(event: SessionEvent): void;
+    /**
+     * Handles broadcast request events by executing local handlers and responding via RPC.
+     * Handlers are dispatched as fire-and-forget — rejections propagate as unhandled promise
+     * rejections, consistent with standard EventEmitter / event handler semantics.
+     * @internal
+     */
+    private _handleBroadcastEvent;
+    /**
+     * Executes a tool handler and sends the result back via RPC.
+     * @internal
+     */
+    private _executeToolAndRespond;
+    /**
+     * Executes a permission handler and sends the result back via RPC.
+     * @internal
+     */
+    private _executePermissionAndRespond;
     /**
      * Registers custom tool handlers for this session.
      *
@@ -208,14 +226,6 @@ export declare class CopilotSession {
      * @internal This method is typically called internally when creating a session.
      */
     registerHooks(hooks?: SessionHooks): void;
-    /**
-     * Handles a permission request from the Copilot CLI.
-     *
-     * @param request - The permission request data from the CLI
-     * @returns A promise that resolves with the permission decision
-     * @internal This method is for internal use by the SDK.
-     */
-    _handlePermissionRequest(request: unknown): Promise<PermissionRequestResult>;
     /**
      * Handles a user input request from the Copilot CLI.
      *

package/dist/session.js

@@ -152,11 +152,13 @@ class CopilotSession {
   }
   /**
    * Dispatches an event to all registered handlers.
+   * Also handles broadcast request events internally (external tool calls, permissions).
    *
    * @param event - The session event to dispatch
    * @internal This method is for internal use by the SDK.
    */
   _dispatchEvent(event) {
+    this._handleBroadcastEvent(event);
     const typedHandlers = this.typedEventHandlers.get(event.type);
     if (typedHandlers) {
       for (const handler of typedHandlers) {
@@ -173,6 +175,73 @@ class CopilotSession {
       }
     }
   }
+  /**
+   * Handles broadcast request events by executing local handlers and responding via RPC.
+   * Handlers are dispatched as fire-and-forget — rejections propagate as unhandled promise
+   * rejections, consistent with standard EventEmitter / event handler semantics.
+   * @internal
+   */
+  _handleBroadcastEvent(event) {
+    if (event.type === "external_tool.requested") {
+      const { requestId, toolName } = event.data;
+      const args = event.data.arguments;
+      const toolCallId = event.data.toolCallId;
+      const handler = this.toolHandlers.get(toolName);
+      if (handler) {
+        void this._executeToolAndRespond(requestId, toolName, toolCallId, args, handler);
+      }
+    } else if (event.type === "permission.requested") {
+      const { requestId, permissionRequest } = event.data;
+      if (this.permissionHandler) {
+        void this._executePermissionAndRespond(requestId, permissionRequest);
+      }
+    }
+  }
+  /**
+   * Executes a tool handler and sends the result back via RPC.
+   * @internal
+   */
+  async _executeToolAndRespond(requestId, toolName, toolCallId, args, handler) {
+    try {
+      const rawResult = await handler(args, {
+        sessionId: this.sessionId,
+        toolCallId,
+        toolName,
+        arguments: args
+      });
+      let result;
+      if (rawResult == null) {
+        result = "";
+      } else if (typeof rawResult === "string") {
+        result = rawResult;
+      } else {
+        result = JSON.stringify(rawResult);
+      }
+      await this.rpc.tools.handlePendingToolCall({ requestId, result });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      await this.rpc.tools.handlePendingToolCall({ requestId, error: message });
+    }
+  }
+  /**
+   * Executes a permission handler and sends the result back via RPC.
+   * @internal
+   */
+  async _executePermissionAndRespond(requestId, permissionRequest) {
+    try {
+      const result = await this.permissionHandler(permissionRequest, {
+        sessionId: this.sessionId
+      });
+      await this.rpc.permissions.handlePendingPermissionRequest({ requestId, result });
+    } catch (_error) {
+      await this.rpc.permissions.handlePendingPermissionRequest({
+        requestId,
+        result: {
+          kind: "denied-no-approval-rule-and-could-not-request-from-user"
+        }
+      });
+    }
+  }
   /**
    * Registers custom tool handlers for this session.
    *
@@ -237,26 +306,6 @@ class CopilotSession {
   registerHooks(hooks) {
     this.hooks = hooks;
   }
-  /**
-   * Handles a permission request from the Copilot CLI.
-   *
-   * @param request - The permission request data from the CLI
-   * @returns A promise that resolves with the permission decision
-   * @internal This method is for internal use by the SDK.
-   */
-  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" };
-    }
-  }
   /**
    * Handles a user input request from the Copilot CLI.
    *

package/dist/types.d.ts

@@ -32,6 +32,12 @@ export interface CopilotClientOptions {
      * @default true
      */
     useStdio?: boolean;
+    /**
+     * When true, indicates the SDK is running as a child process of the Copilot CLI server, and should
+     * use its own stdio for communicating with the existing parent process. Can only be used in combination
+     * with useStdio: true.
+     */
+    isChildProcess?: boolean;
     /**
      * URL of an existing Copilot CLI server to connect to over TCP
      * When provided, the client will not spawn a CLI process

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.30",
+  "version": "0.1.31-unstable.0",
   "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./extension": {
+      "import": "./dist/extension.js",
+      "types": "./dist/extension.d.ts"
     }
   },
   "type": "module",
@@ -40,7 +44,7 @@
   "author": "GitHub",
   "license": "MIT",
   "dependencies": {
-    "@github/copilot": "^0.0.420",
+    "@github/copilot": "^0.0.421",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.6"
   },