@github/copilot-sdk 0.1.13-preview.0 → 0.1.14

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

@@ -3,7 +3,7 @@
  *
  * Generated from: @github/copilot/session-events.schema.json
  * Generated by: scripts/generate-session-types.ts
- * Generated at: 2026-01-13T00:08:20.716Z
+ * Generated at: 2026-01-16T00:52:51.450Z
  *
  * To update these types:
  * 1. Update the schema in copilot-agent-runtime
@@ -105,6 +105,45 @@ export type SessionEvent = {
         messagesRemovedDuringTruncation: number;
         performedBy: string;
     };
+} | {
+    id: string;
+    timestamp: string;
+    parentId: string | null;
+    ephemeral: true;
+    type: "session.usage_info";
+    data: {
+        tokenLimit: number;
+        currentTokens: number;
+        messagesLength: number;
+    };
+} | {
+    id: string;
+    timestamp: string;
+    parentId: string | null;
+    ephemeral?: boolean;
+    type: "session.compaction_start";
+    data: {};
+} | {
+    id: string;
+    timestamp: string;
+    parentId: string | null;
+    ephemeral?: boolean;
+    type: "session.compaction_complete";
+    data: {
+        success: boolean;
+        error?: string;
+        preCompactionTokens?: number;
+        postCompactionTokens?: number;
+        preCompactionMessagesLength?: number;
+        messagesRemoved?: number;
+        tokensRemoved?: number;
+        summaryContent?: string;
+        compactionTokensUsed?: {
+            input: number;
+            output: number;
+            cachedInput: number;
+        };
+    };
 } | {
     id: string;
     timestamp: string;
@@ -155,13 +194,12 @@ export type SessionEvent = {
     data: {
         reasoningId: string;
         content: string;
-        chunkContent?: string;
     };
 } | {
     id: string;
     timestamp: string;
     parentId: string | null;
-    ephemeral?: true;
+    ephemeral: true;
     type: "assistant.reasoning_delta";
     data: {
         reasoningId: string;
@@ -176,8 +214,6 @@ export type SessionEvent = {
     data: {
         messageId: string;
         content: string;
-        chunkContent?: string;
-        totalResponseSizeBytes?: number;
         toolRequests?: {
             toolCallId: string;
             name: string;
@@ -189,7 +225,7 @@ export type SessionEvent = {
     id: string;
     timestamp: string;
     parentId: string | null;
-    ephemeral?: true;
+    ephemeral: true;
     type: "assistant.message_delta";
     data: {
         messageId: string;
@@ -305,7 +341,7 @@ export type SessionEvent = {
     timestamp: string;
     parentId: string | null;
     ephemeral?: boolean;
-    type: "custom_agent.started";
+    type: "subagent.started";
     data: {
         toolCallId: string;
         agentName: string;
@@ -317,7 +353,7 @@ export type SessionEvent = {
     timestamp: string;
     parentId: string | null;
     ephemeral?: boolean;
-    type: "custom_agent.completed";
+    type: "subagent.completed";
     data: {
         toolCallId: string;
         agentName: string;
@@ -327,7 +363,7 @@ export type SessionEvent = {
     timestamp: string;
     parentId: string | null;
     ephemeral?: boolean;
-    type: "custom_agent.failed";
+    type: "subagent.failed";
     data: {
         toolCallId: string;
         agentName: string;
@@ -338,7 +374,7 @@ export type SessionEvent = {
     timestamp: string;
     parentId: string | null;
     ephemeral?: boolean;
-    type: "custom_agent.selected";
+    type: "subagent.selected";
     data: {
         agentName: string;
         agentDisplayName: string;

package/dist/index.d.ts

@@ -4,6 +4,6 @@
  * JSON-RPC based SDK for programmatic control of GitHub Copilot CLI
  */
 export { CopilotClient } from "./client.js";
-export { CopilotSession } from "./session.js";
+export { CopilotSession, type AssistantMessageEvent } from "./session.js";
 export { defineTool } from "./types.js";
 export type { ConnectionState, CopilotClientOptions, CustomAgentConfig, MCPLocalServerConfig, MCPRemoteServerConfig, MCPServerConfig, 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

@@ -4,6 +4,10 @@
  */
 import type { MessageConnection } from "vscode-jsonrpc/node";
 import type { MessageOptions, PermissionHandler, PermissionRequestResult, SessionEvent, SessionEventHandler, Tool, ToolHandler } from "./types.js";
+/** Assistant message event - the final response from the assistant. */
+export type AssistantMessageEvent = Extract<SessionEvent, {
+    type: "assistant.message";
+}>;
 /**
  * Represents a single conversation session with the Copilot CLI.
  *
@@ -16,17 +20,16 @@ import type { MessageOptions, PermissionHandler, PermissionRequestResult, Sessio
  * const session = await client.createSession({ model: "gpt-4" });
  *
  * // Subscribe to events
- * const unsubscribe = session.on((event) => {
+ * session.on((event) => {
  *   if (event.type === "assistant.message") {
  *     console.log(event.data.content);
  *   }
  * });
  *
- * // Send a message
- * await session.send({ prompt: "Hello, world!" });
+ * // Send a message and wait for completion
+ * await session.sendAndWait({ prompt: "Hello, world!" });
  *
  * // Clean up
- * unsubscribe();
  * await session.destroy();
  * ```
  */
@@ -63,6 +66,30 @@ export declare class CopilotSession {
      * ```
      */
     send(options: MessageOptions): Promise<string>;
+    /**
+     * Sends a message to this session and waits until the session becomes idle.
+     *
+     * This is a convenience method that combines {@link send} with waiting for
+     * the `session.idle` event. Use this when you want to block until the
+     * assistant has finished processing the message.
+     *
+     * Events are still delivered to handlers registered via {@link on} while waiting.
+     *
+     * @param options - The message options including the prompt and optional attachments
+     * @param timeout - Timeout in milliseconds (default: 60000). Controls how long to wait; does not abort in-flight agent work.
+     * @returns A promise that resolves with the final assistant message when the session becomes idle,
+     *          or undefined if no assistant message was received
+     * @throws Error if the timeout is reached before the session becomes idle
+     * @throws Error if the session has been destroyed or the connection fails
+     *
+     * @example
+     * ```typescript
+     * // Send and wait for completion with default 60s timeout
+     * const response = await session.sendAndWait({ prompt: "What is 2+2?" });
+     * console.log(response?.data.content); // "4"
+     * ```
+     */
+    sendAndWait(options: MessageOptions, timeout?: number): Promise<AssistantMessageEvent | undefined>;
     /**
      * Subscribes to events from this session.
      *

package/dist/session.js

@@ -40,6 +40,67 @@ class CopilotSession {
     });
     return response.messageId;
   }
+  /**
+   * Sends a message to this session and waits until the session becomes idle.
+   *
+   * This is a convenience method that combines {@link send} with waiting for
+   * the `session.idle` event. Use this when you want to block until the
+   * assistant has finished processing the message.
+   *
+   * Events are still delivered to handlers registered via {@link on} while waiting.
+   *
+   * @param options - The message options including the prompt and optional attachments
+   * @param timeout - Timeout in milliseconds (default: 60000). Controls how long to wait; does not abort in-flight agent work.
+   * @returns A promise that resolves with the final assistant message when the session becomes idle,
+   *          or undefined if no assistant message was received
+   * @throws Error if the timeout is reached before the session becomes idle
+   * @throws Error if the session has been destroyed or the connection fails
+   *
+   * @example
+   * ```typescript
+   * // Send and wait for completion with default 60s timeout
+   * const response = await session.sendAndWait({ prompt: "What is 2+2?" });
+   * console.log(response?.data.content); // "4"
+   * ```
+   */
+  async sendAndWait(options, timeout) {
+    const effectiveTimeout = timeout ?? 6e4;
+    let resolveIdle;
+    let rejectWithError;
+    const idlePromise = new Promise((resolve, reject) => {
+      resolveIdle = resolve;
+      rejectWithError = reject;
+    });
+    let lastAssistantMessage;
+    const unsubscribe = this.on((event) => {
+      if (event.type === "assistant.message") {
+        lastAssistantMessage = event;
+      } else if (event.type === "session.idle") {
+        resolveIdle();
+      } else if (event.type === "session.error") {
+        const error = new Error(event.data.message);
+        error.stack = event.data.stack;
+        rejectWithError(error);
+      }
+    });
+    try {
+      await this.send(options);
+      const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(
+          () => reject(
+            new Error(
+              `Timeout after ${effectiveTimeout}ms waiting for session.idle`
+            )
+          ),
+          effectiveTimeout
+        );
+      });
+      await Promise.race([idlePromise, timeoutPromise]);
+      return lastAssistantMessage;
+    } finally {
+      unsubscribe();
+    }
+  }
   /**
    * Subscribes to events from this session.
    *

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.13-preview.0",
+  "version": "0.1.14",
   "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.382-0",
+    "@github/copilot": "^0.0.384",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.5"
   },