@github/copilot-sdk 0.1.17 → 0.1.18

package/README.md

@@ -89,10 +89,11 @@ Create a new conversation session.
 - `model?: string` - Model to use ("gpt-5", "claude-sonnet-4.5", etc.)
 - `tools?: Tool[]` - Custom tools exposed to the CLI
 - `systemMessage?: SystemMessageConfig` - System message customization (see below)
+- `infiniteSessions?: InfiniteSessionConfig` - Configure automatic context compaction (see below)
 
 ##### `resumeSession(sessionId: string, config?: ResumeSessionConfig): Promise<CopilotSession>`
 
-Resume an existing session.
+Resume an existing session. Returns the session with `workspacePath` populated if infinite sessions were enabled.
 
 ##### `ping(message?: string): Promise<{ message: string; timestamp: number }>`
 
@@ -116,6 +117,16 @@ Delete a session and its data from disk.
 
 Represents a single conversation session.
 
+#### Properties
+
+##### `sessionId: string`
+
+The unique identifier for this session.
+
+##### `workspacePath?: string`
+
+Path to the session workspace directory when infinite sessions are enabled. Contains `checkpoints/`, `plan.md`, and `files/` subdirectories. Undefined if infinite sessions are disabled.
+
 #### Methods
 
 ##### `send(options: MessageOptions): Promise<string>`
@@ -327,6 +338,40 @@ const session = await client.createSession({
 });
 ```
 
+### Infinite Sessions
+
+By default, sessions use **infinite sessions** which automatically manage context window limits through background compaction and persist state to a workspace directory.
+
+```typescript
+// Default: infinite sessions enabled with default thresholds
+const session = await client.createSession({ model: "gpt-5" });
+
+// Access the workspace path for checkpoints and files
+console.log(session.workspacePath);
+// => ~/.copilot/session-state/{sessionId}/
+
+// Custom thresholds
+const session = await client.createSession({
+    model: "gpt-5",
+    infiniteSessions: {
+        enabled: true,
+        backgroundCompactionThreshold: 0.80, // Start compacting at 80% context usage
+        bufferExhaustionThreshold: 0.95, // Block at 95% until compaction completes
+    },
+});
+
+// Disable infinite sessions
+const session = await client.createSession({
+    model: "gpt-5",
+    infiniteSessions: { enabled: false },
+});
+```
+
+When enabled, sessions emit compaction events:
+
+- `session.compaction_start` - Background compaction started
+- `session.compaction_complete` - Compaction finished (includes token counts)
+
 ### Multiple Sessions
 
 ```typescript

package/dist/client.js

@@ -322,10 +322,11 @@ class CopilotClient {
       customAgents: config.customAgents,
       configDir: config.configDir,
       skillDirectories: config.skillDirectories,
-      disabledSkills: config.disabledSkills
+      disabledSkills: config.disabledSkills,
+      infiniteSessions: config.infiniteSessions
     });
-    const sessionId = response.sessionId;
-    const session = new CopilotSession(sessionId, this.connection);
+    const { sessionId, workspacePath } = response;
+    const session = new CopilotSession(sessionId, this.connection, workspacePath);
     session.registerTools(config.tools);
     if (config.onPermissionRequest) {
       session.registerPermissionHandler(config.onPermissionRequest);
@@ -379,8 +380,8 @@ class CopilotClient {
       skillDirectories: config.skillDirectories,
       disabledSkills: config.disabledSkills
     });
-    const resumedSessionId = response.sessionId;
-    const session = new CopilotSession(resumedSessionId, this.connection);
+    const { sessionId: resumedSessionId, workspacePath } = response;
+    const session = new CopilotSession(resumedSessionId, this.connection, workspacePath);
     session.registerTools(config.tools);
     if (config.onPermissionRequest) {
       session.registerPermissionHandler(config.onPermissionRequest);

package/dist/index.d.ts

@@ -6,4 +6,4 @@
 export { CopilotClient } from "./client.js";
 export { CopilotSession, type AssistantMessageEvent } from "./session.js";
 export { defineTool } from "./types.js";
-export type { ConnectionState, CopilotClientOptions, CustomAgentConfig, GetAuthStatusResponse, GetStatusResponse, MCPLocalServerConfig, MCPRemoteServerConfig, MCPServerConfig, MessageOptions, ModelBilling, ModelCapabilities, ModelInfo, ModelPolicy, PermissionHandler, PermissionRequest, PermissionRequestResult, ResumeSessionConfig, SessionConfig, SessionEvent, SessionEventHandler, SessionMetadata, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageReplaceConfig, Tool, ToolHandler, ToolInvocation, ToolResultObject, ZodSchema, } from "./types.js";
+export type { ConnectionState, CopilotClientOptions, CustomAgentConfig, GetAuthStatusResponse, GetStatusResponse, InfiniteSessionConfig, MCPLocalServerConfig, MCPRemoteServerConfig, MCPServerConfig, MessageOptions, ModelBilling, ModelCapabilities, ModelInfo, ModelPolicy, PermissionHandler, PermissionRequest, PermissionRequestResult, ResumeSessionConfig, SessionConfig, SessionEvent, SessionEventHandler, SessionMetadata, SystemMessageAppendConfig, SystemMessageConfig, SystemMessageReplaceConfig, Tool, ToolHandler, ToolInvocation, ToolResultObject, ZodSchema, } from "./types.js";

package/dist/session.d.ts

@@ -36,6 +36,7 @@ export type AssistantMessageEvent = Extract<SessionEvent, {
 export declare class CopilotSession {
     readonly sessionId: string;
     private connection;
+    private readonly _workspacePath?;
     private eventHandlers;
     private toolHandlers;
     private permissionHandler?;
@@ -44,9 +45,16 @@ export declare class CopilotSession {
      *
      * @param sessionId - The unique identifier for this session
      * @param connection - The JSON-RPC message connection to the Copilot CLI
+     * @param workspacePath - Path to the session workspace directory (when infinite sessions enabled)
      * @internal This constructor is internal. Use {@link CopilotClient.createSession} to create sessions.
      */
-    constructor(sessionId: string, connection: MessageConnection);
+    constructor(sessionId: string, connection: MessageConnection, _workspacePath?: string | undefined);
+    /**
+     * Path to the session workspace directory when infinite sessions are enabled.
+     * Contains checkpoints/, plan.md, and files/ subdirectories.
+     * Undefined if infinite sessions are disabled.
+     */
+    get workspacePath(): string | undefined;
     /**
      * Sends a message to this session and waits for the response.
      *

package/dist/session.js

@@ -4,15 +4,25 @@ class CopilotSession {
    *
    * @param sessionId - The unique identifier for this session
    * @param connection - The JSON-RPC message connection to the Copilot CLI
+   * @param workspacePath - Path to the session workspace directory (when infinite sessions enabled)
    * @internal This constructor is internal. Use {@link CopilotClient.createSession} to create sessions.
    */
-  constructor(sessionId, connection) {
+  constructor(sessionId, connection, _workspacePath) {
     this.sessionId = sessionId;
     this.connection = connection;
+    this._workspacePath = _workspacePath;
   }
   eventHandlers = /* @__PURE__ */ new Set();
   toolHandlers = /* @__PURE__ */ new Map();
   permissionHandler;
+  /**
+   * Path to the session workspace directory when infinite sessions are enabled.
+   * Contains checkpoints/, plan.md, and files/ subdirectories.
+   * Undefined if infinite sessions are disabled.
+   */
+  get workspacePath() {
+    return this._workspacePath;
+  }
   /**
    * Sends a message to this session and waits for the response.
    *

package/dist/types.d.ts

@@ -250,6 +250,30 @@ export interface CustomAgentConfig {
      */
     infer?: boolean;
 }
+/**
+ * Configuration for infinite sessions with automatic context compaction and workspace persistence.
+ * When enabled, sessions automatically manage context window limits through background compaction
+ * and persist state to a workspace directory.
+ */
+export interface InfiniteSessionConfig {
+    /**
+     * Whether infinite sessions are enabled.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Context utilization threshold (0.0-1.0) at which background compaction starts.
+     * Compaction runs asynchronously, allowing the session to continue processing.
+     * @default 0.80
+     */
+    backgroundCompactionThreshold?: number;
+    /**
+     * Context utilization threshold (0.0-1.0) at which the session blocks until compaction completes.
+     * This prevents context overflow when compaction hasn't finished in time.
+     * @default 0.95
+     */
+    bufferExhaustionThreshold?: number;
+}
 export interface SessionConfig {
     /**
      * Optional custom session ID
@@ -312,6 +336,12 @@ export interface SessionConfig {
      * List of skill names to disable.
      */
     disabledSkills?: string[];
+    /**
+     * Infinite session configuration for persistent workspaces and automatic compaction.
+     * When enabled (default), sessions automatically manage context limits and persist state.
+     * Set to `{ enabled: false }` to disable.
+     */
+    infiniteSessions?: InfiniteSessionConfig;
 }
 /**
  * Configuration for resuming a session

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/github/copilot-sdk.git"
   },
-  "version": "0.1.17",
+  "version": "0.1.18",
   "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.389",
+    "@github/copilot": "^0.0.394",
     "vscode-jsonrpc": "^8.2.1",
     "zod": "^4.3.5"
   },