@github/copilot-sdk 0.1.26-preview.0 → 0.1.27

package/dist/client.d.ts

@@ -130,10 +130,11 @@ export declare class CopilotClient {
      * @example
      * ```typescript
      * // Basic session
-     * const session = await client.createSession();
+     * const session = await client.createSession({ onPermissionRequest: approveAll });
      *
      * // Session with model and tools
      * const session = await client.createSession({
+     *   onPermissionRequest: approveAll,
      *   model: "gpt-4",
      *   tools: [{
      *     name: "get_weather",
@@ -144,7 +145,7 @@ export declare class CopilotClient {
      * });
      * ```
      */
-    createSession(config?: SessionConfig): Promise<CopilotSession>;
+    createSession(config: SessionConfig): Promise<CopilotSession>;
     /**
      * Resumes an existing conversation session by its ID.
      *
@@ -160,15 +161,16 @@ export declare class CopilotClient {
      * @example
      * ```typescript
      * // Resume a previous session
-     * const session = await client.resumeSession("session-123");
+     * const session = await client.resumeSession("session-123", { onPermissionRequest: approveAll });
      *
      * // Resume with new tools
      * const session = await client.resumeSession("session-123", {
+     *   onPermissionRequest: approveAll,
      *   tools: [myNewTool]
      * });
      * ```
      */
-    resumeSession(sessionId: string, config?: ResumeSessionConfig): Promise<CopilotSession>;
+    resumeSession(sessionId: string, config: ResumeSessionConfig): Promise<CopilotSession>;
     /**
      * Gets the current connection state of the client.
      *
@@ -177,7 +179,7 @@ export declare class CopilotClient {
      * @example
      * ```typescript
      * if (client.getState() === "connected") {
-     *   const session = await client.createSession();
+     *   const session = await client.createSession({ onPermissionRequest: approveAll });
      * }
      * ```
      */
@@ -234,7 +236,7 @@ export declare class CopilotClient {
      * ```typescript
      * const lastId = await client.getLastSessionId();
      * if (lastId) {
-     *   const session = await client.resumeSession(lastId);
+     *   const session = await client.resumeSession(lastId, { onPermissionRequest: approveAll });
      * }
      * ```
      */

package/dist/client.js

@@ -335,10 +335,11 @@ class CopilotClient {
    * @example
    * ```typescript
    * // Basic session
-   * const session = await client.createSession();
+   * const session = await client.createSession({ onPermissionRequest: approveAll });
    *
    * // Session with model and tools
    * const session = await client.createSession({
+   *   onPermissionRequest: approveAll,
    *   model: "gpt-4",
    *   tools: [{
    *     name: "get_weather",
@@ -349,7 +350,12 @@ class CopilotClient {
    * });
    * ```
    */
-  async createSession(config = {}) {
+  async createSession(config) {
+    if (!config?.onPermissionRequest) {
+      throw new Error(
+        "An onPermissionRequest handler is required when creating a session. For example, to allow all permissions, use { onPermissionRequest: approveAll }."
+      );
+    }
     if (!this.connection) {
       if (this.options.autoStart) {
         await this.start();
@@ -387,9 +393,7 @@ class CopilotClient {
     const { sessionId, workspacePath } = response;
     const session = new CopilotSession(sessionId, this.connection, workspacePath);
     session.registerTools(config.tools);
-    if (config.onPermissionRequest) {
-      session.registerPermissionHandler(config.onPermissionRequest);
-    }
+    session.registerPermissionHandler(config.onPermissionRequest);
     if (config.onUserInputRequest) {
       session.registerUserInputHandler(config.onUserInputRequest);
     }
@@ -414,15 +418,21 @@ class CopilotClient {
    * @example
    * ```typescript
    * // Resume a previous session
-   * const session = await client.resumeSession("session-123");
+   * const session = await client.resumeSession("session-123", { onPermissionRequest: approveAll });
    *
    * // Resume with new tools
    * const session = await client.resumeSession("session-123", {
+   *   onPermissionRequest: approveAll,
    *   tools: [myNewTool]
    * });
    * ```
    */
-  async resumeSession(sessionId, config = {}) {
+  async resumeSession(sessionId, config) {
+    if (!config?.onPermissionRequest) {
+      throw new Error(
+        "An onPermissionRequest handler is required when resuming a session. For example, to allow all permissions, use { onPermissionRequest: approveAll }."
+      );
+    }
     if (!this.connection) {
       if (this.options.autoStart) {
         await this.start();
@@ -461,9 +471,7 @@ class CopilotClient {
     const { sessionId: resumedSessionId, workspacePath } = response;
     const session = new CopilotSession(resumedSessionId, this.connection, workspacePath);
     session.registerTools(config.tools);
-    if (config.onPermissionRequest) {
-      session.registerPermissionHandler(config.onPermissionRequest);
-    }
+    session.registerPermissionHandler(config.onPermissionRequest);
     if (config.onUserInputRequest) {
       session.registerUserInputHandler(config.onUserInputRequest);
     }
@@ -481,7 +489,7 @@ class CopilotClient {
    * @example
    * ```typescript
    * if (client.getState() === "connected") {
-   *   const session = await client.createSession();
+   *   const session = await client.createSession({ onPermissionRequest: approveAll });
    * }
    * ```
    */
@@ -594,7 +602,7 @@ class CopilotClient {
    * ```typescript
    * const lastId = await client.getLastSessionId();
    * if (lastId) {
-   *   const session = await client.resumeSession(lastId);
+   *   const session = await client.resumeSession(lastId, { onPermissionRequest: approveAll });
    * }
    * ```
    */

package/dist/generated/rpc.d.ts

@@ -287,6 +287,113 @@ export interface SessionFleetStartParams {
      */
     prompt?: string;
 }
+export interface SessionAgentListResult {
+    /**
+     * Available custom agents
+     */
+    agents: {
+        /**
+         * Unique identifier of the custom agent
+         */
+        name: string;
+        /**
+         * Human-readable display name
+         */
+        displayName: string;
+        /**
+         * Description of the agent's purpose
+         */
+        description: string;
+    }[];
+}
+export interface SessionAgentListParams {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+}
+export interface SessionAgentGetCurrentResult {
+    /**
+     * Currently selected custom agent, or null if using the default agent
+     */
+    agent: {
+        /**
+         * Unique identifier of the custom agent
+         */
+        name: string;
+        /**
+         * Human-readable display name
+         */
+        displayName: string;
+        /**
+         * Description of the agent's purpose
+         */
+        description: string;
+    } | null;
+}
+export interface SessionAgentGetCurrentParams {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+}
+export interface SessionAgentSelectResult {
+    /**
+     * The newly selected custom agent
+     */
+    agent: {
+        /**
+         * Unique identifier of the custom agent
+         */
+        name: string;
+        /**
+         * Human-readable display name
+         */
+        displayName: string;
+        /**
+         * Description of the agent's purpose
+         */
+        description: string;
+    };
+}
+export interface SessionAgentSelectParams {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+    /**
+     * Name of the custom agent to select
+     */
+    name: string;
+}
+export interface SessionAgentDeselectResult {
+}
+export interface SessionAgentDeselectParams {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+}
+export interface SessionCompactionCompactResult {
+    /**
+     * Whether compaction completed successfully
+     */
+    success: boolean;
+    /**
+     * Number of tokens freed by compaction
+     */
+    tokensRemoved: number;
+    /**
+     * Number of messages removed during compaction
+     */
+    messagesRemoved: number;
+}
+export interface SessionCompactionCompactParams {
+    /**
+     * Target session identifier
+     */
+    sessionId: string;
+}
 /** Create typed server-scoped RPC methods (no session required). */
 export declare function createServerRpc(connection: MessageConnection): {
     ping: (params: PingParams) => Promise<PingResult>;
@@ -323,4 +430,13 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
     fleet: {
         start: (params: Omit<SessionFleetStartParams, "sessionId">) => Promise<SessionFleetStartResult>;
     };
+    agent: {
+        list: () => Promise<SessionAgentListResult>;
+        getCurrent: () => Promise<SessionAgentGetCurrentResult>;
+        select: (params: Omit<SessionAgentSelectParams, "sessionId">) => Promise<SessionAgentSelectResult>;
+        deselect: () => Promise<SessionAgentDeselectResult>;
+    };
+    compaction: {
+        compact: () => Promise<SessionCompactionCompactResult>;
+    };
 };

package/dist/generated/rpc.js

@@ -34,6 +34,15 @@ function createSessionRpc(connection, sessionId) {
     },
     fleet: {
       start: async (params) => connection.sendRequest("session.fleet.start", { sessionId, ...params })
+    },
+    agent: {
+      list: async () => connection.sendRequest("session.agent.list", { sessionId }),
+      getCurrent: async () => connection.sendRequest("session.agent.getCurrent", { sessionId }),
+      select: async (params) => connection.sendRequest("session.agent.select", { sessionId, ...params }),
+      deselect: async () => connection.sendRequest("session.agent.deselect", { sessionId })
+    },
+    compaction: {
+      compact: async () => connection.sendRequest("session.compaction.compact", { sessionId })
     }
   };
 }

package/dist/generated/session-events.d.ts

@@ -260,6 +260,15 @@ export type SessionEvent = {
         };
         requestId?: string;
     };
+} | {
+    id: string;
+    timestamp: string;
+    parentId: string | null;
+    ephemeral?: boolean;
+    type: "session.task_complete";
+    data: {
+        summary?: string;
+    };
 } | {
     id: string;
     timestamp: string;
@@ -349,6 +358,15 @@ export type SessionEvent = {
         reasoningId: string;
         deltaContent: string;
     };
+} | {
+    id: string;
+    timestamp: string;
+    parentId: string | null;
+    ephemeral: true;
+    type: "assistant.streaming_delta";
+    data: {
+        totalResponseSizeBytes: number;
+    };
 } | {
     id: string;
     timestamp: string;
@@ -379,7 +397,6 @@ export type SessionEvent = {
     data: {
         messageId: string;
         deltaContent: string;
-        totalResponseSizeBytes?: number;
         parentToolCallId?: string;
     };
 } | {

package/dist/types.d.ts

@@ -168,7 +168,7 @@ export type SystemMessageConfig = SystemMessageAppendConfig | SystemMessageRepla
  * Permission request types from the server
  */
 export interface PermissionRequest {
-    kind: "shell" | "write" | "mcp" | "read" | "url";
+    kind: "shell" | "write" | "mcp" | "read" | "url" | "custom-tool";
     toolCallId?: string;
     [key: string]: unknown;
 }
@@ -549,7 +549,7 @@ export interface SessionConfig {
      * Handler for permission requests from the server.
      * When provided, the server will call this handler to request permission for operations.
      */
-    onPermissionRequest?: PermissionHandler;
+    onPermissionRequest: PermissionHandler;
     /**
      * Handler for user input requests from the agent.
      * When provided, enables the ask_user tool allowing the agent to ask questions.

package/package.json

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