@github/copilot-sdk 0.1.29 → 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.
      *
@@ -291,4 +301,16 @@ export declare class CopilotSession {
      * ```
      */
     abort(): Promise<void>;
+    /**
+     * Change the model for this session.
+     * The new model takes effect for the next message. Conversation history is preserved.
+     *
+     * @param model - Model ID to switch to
+     *
+     * @example
+     * ```typescript
+     * await session.setModel("gpt-4.1");
+     * ```
+     */
+    setModel(model: string): Promise<void>;
 }

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.
    *
@@ -383,6 +432,20 @@ class CopilotSession {
       sessionId: this.sessionId
     });
   }
+  /**
+   * Change the model for this session.
+   * The new model takes effect for the next message. Conversation history is preserved.
+   *
+   * @param model - Model ID to switch to
+   *
+   * @example
+   * ```typescript
+   * await session.setModel("gpt-4.1");
+   * ```
+   */
+  async setModel(model) {
+    await this.rpc.model.switchTo({ modelId: model });
+  }
 }
 export {
   CopilotSession

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
@@ -117,6 +123,12 @@ export interface Tool<TArgs = unknown> {
     description?: string;
     parameters?: ZodSchema<TArgs> | Record<string, unknown>;
     handler: ToolHandler<TArgs>;
+    /**
+     * When true, explicitly indicates this tool is intended to override a built-in tool
+     * of the same name. If not set and the name clashes with a built-in tool, the runtime
+     * will return an error.
+     */
+    overridesBuiltInTool?: boolean;
 }
 /**
  * Helper to define a tool with Zod schema and get type inference for the handler.
@@ -126,6 +138,7 @@ export declare function defineTool<T = unknown>(name: string, config: {
     description?: string;
     parameters?: ZodSchema<T> | Record<string, unknown>;
     handler: ToolHandler<T>;
+    overridesBuiltInTool?: boolean;
 }): Tool<T>;
 export interface ToolCallRequestPayload {
     sessionId: string;

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.29",
+  "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"
   },