@github/copilot-sdk 1.0.13-preview.2 → 1.0.13-preview.4

package/dist/client.d.ts

@@ -33,6 +33,7 @@ export declare class CopilotClient {
     private _rpc;
     private _internalRpc;
     private processExitPromise;
+    private processTransportError;
     private negotiatedProtocolVersion;
     /** Connection-level session filesystem config, set via constructor option. */
     private sessionFsConfig;
@@ -452,17 +453,6 @@ export declare class CopilotClient {
      * reusing the same `vscode-jsonrpc` framing as the stdio transport.
      */
     private connectViaFfi;
-    /**
-     * Resolves the CLI entrypoint used for in-process FFI hosting: `COPILOT_CLI_PATH`
-     * when set, otherwise the bundled platform-package entrypoint.
-     */
-    private resolveCliPathForFfi;
-    /**
-     * Returns the napi prebuilds folder name for the current host — the
-     * `<node-platform>-<arch>` convention (e.g. `win32-x64`, `darwin-arm64`,
-     * `linux-x64`, `linuxmusl-x64`) under which the runtime ships
-     * `prebuilds/<folder>/runtime.node`.
-     */
     private static getNapiPrebuildsFolder;
     private static isMusl;
     /**

package/dist/client.js

@@ -3,7 +3,7 @@ import { randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { Socket } from "node:net";
-import { dirname, isAbsolute, join } from "node:path";
+import { dirname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import {
   createMessageConnection,
@@ -20,6 +20,7 @@ import {
 } from "./generated/rpc.js";
 import { getSdkProtocolVersion } from "./sdkProtocolVersion.js";
 import { CopilotSession } from "./session.js";
+import { materializeRuntimeBundle } from "./runtimeArtifacts.js";
 import { createSessionFsAdapter } from "./sessionFsProvider.js";
 import { createCopilotRequestAdapter } from "./copilotRequestHandler.js";
 import { getTraceContext } from "./telemetry.js";
@@ -49,7 +50,7 @@ async function waitForChildExit(child, timeoutMs) {
   if (child.exitCode != null || child.signalCode != null) {
     return true;
   }
-  return new Promise((resolve) => {
+  return new Promise((resolve2) => {
     let timeout;
     let settled = false;
     const onExit = () => {
@@ -58,7 +59,7 @@ async function waitForChildExit(child, timeoutMs) {
       }
       settled = true;
       clearTimeout(timeout);
-      resolve(true);
+      resolve2(true);
     };
     timeout = setTimeout(() => {
       if (settled) {
@@ -66,7 +67,7 @@ async function waitForChildExit(child, timeoutMs) {
       }
       settled = true;
       child.off("exit", onExit);
-      resolve(false);
+      resolve2(false);
     }, timeoutMs);
     child.once("exit", onExit);
     if (child.exitCode != null || child.signalCode != null) {
@@ -189,14 +190,17 @@ function getCliPlatformPackageNames() {
   const variants = process.platform === "linux" ? ["linux", "linuxmusl"] : [process.platform];
   return variants.map((variant) => `@github/copilot-${variant}-${arch}`);
 }
-function getBundledCliPath() {
+function getBundledCliPackage() {
   const packageNames = getCliPlatformPackageNames();
   if (typeof import.meta.resolve === "function") {
     for (const packageName of packageNames) {
       try {
         const packageEntryUrl = import.meta.resolve(packageName);
         const packageEntryPath = fileURLToPath(packageEntryUrl);
-        return join(dirname(packageEntryPath), "index.js");
+        return {
+          root: dirname(packageEntryPath),
+          platform: packageName.slice("@github/copilot-".length)
+        };
       } catch {
       }
     }
@@ -208,9 +212,13 @@ function getBundledCliPath() {
   const searchPaths = req.resolve.paths("@github/copilot") ?? [];
   for (const base of searchPaths) {
     for (const packageName of packageNames) {
-      const candidate = join(base, ...packageName.split("/"), "index.js");
+      const root = join(base, ...packageName.split("/"));
+      const candidate = join(root, "index.js");
       if (existsSync(candidate)) {
-        return candidate;
+        return {
+          root,
+          platform: packageName.slice("@github/copilot-".length)
+        };
       }
     }
   }
@@ -218,6 +226,13 @@ function getBundledCliPath() {
     `Could not find a @github/copilot platform package (tried ${packageNames.join(", ")}). Searched ${searchPaths.length} paths. Ensure @github/copilot is installed, or pass cliPath/cliUrl to CopilotClient.`
   );
 }
+function getBundledRuntimePath() {
+  const bundled = getBundledCliPackage();
+  return materializeRuntimeBundle({
+    packageRoot: bundled.root,
+    platform: bundled.platform
+  });
+}
 class TeardownResilientStreamMessageWriter extends StreamMessageWriter {
   suppressWriteErrors = false;
   async write(msg) {
@@ -264,6 +279,7 @@ class CopilotClient {
   _internalRpc = null;
   processExitPromise = null;
   // Rejects when CLI process exits
+  processTransportError = null;
   negotiatedProtocolVersion = null;
   /** Connection-level session filesystem config, set via constructor option. */
   sessionFsConfig = null;
@@ -430,7 +446,14 @@ class CopilotClient {
     const connEnv = conn.kind === "stdio" || conn.kind === "tcp" ? conn.env : void 0;
     const effectiveEnv = connEnv ?? options.env ?? process.env;
     this.resolvedEnv = effectiveEnv;
-    this.resolvedCliPath = conn.kind === "stdio" || conn.kind === "tcp" ? conn.path ?? effectiveEnv.COPILOT_CLI_PATH ?? getBundledCliPath() : void 0;
+    if (conn.kind === "stdio" || conn.kind === "tcp") {
+      const explicitCliPath = conn.path ?? effectiveEnv.COPILOT_CLI_PATH;
+      if (explicitCliPath) {
+        this.resolvedCliPath = explicitCliPath;
+      } else {
+        this.resolvedCliPath = getBundledRuntimePath();
+      }
+    }
     const connArgs = conn.kind === "stdio" || conn.kind === "tcp" ? conn.args ?? [] : [];
     this.connectionExtraArgs = [...connArgs];
     this.options = {
@@ -598,6 +621,8 @@ class CopilotClient {
     if (this.state === "connected") {
       return;
     }
+    this.forceStopping = false;
+    this.processTransportError = null;
     this.state = "connecting";
     try {
       if (this.connectionConfig.kind === "inprocess") {
@@ -630,8 +655,10 @@ class CopilotClient {
       }
       this.state = "connected";
     } catch (error) {
+      const startupError = this.processTransportError ?? error;
+      await this.forceStop();
       this.state = "error";
-      throw error;
+      throw startupError;
     }
   }
   /**
@@ -676,7 +703,7 @@ class CopilotClient {
           lastError = error instanceof Error ? error : new Error(String(error));
           if (attempt < 3) {
             const delay = 100 * Math.pow(2, attempt - 1);
-            await new Promise((resolve) => setTimeout(resolve, delay));
+            await new Promise((resolve2) => setTimeout(resolve2, delay));
           }
         }
       }
@@ -743,8 +770,8 @@ class CopilotClient {
       this.socket = null;
       try {
         if (!socket.destroyed) {
-          await new Promise((resolve) => {
-            socket.once("close", () => resolve());
+          await new Promise((resolve2) => {
+            socket.once("close", () => resolve2());
             socket.end();
           });
         }
@@ -1185,6 +1212,7 @@ class CopilotClient {
         requestPermission: !!config.onPermissionRequest,
         requestUserInput: !!config.onUserInputRequest,
         requestElicitation: !!config.onElicitationRequest,
+        askUserVariant: config.askUserVariant,
         ...config.enableMcpApps ? { requestMcpApps: true } : {},
         ...config.githubMcpToolConfig != null ? { githubMcpToolConfig: config.githubMcpToolConfig } : {},
         requestExitPlanMode: !!config.onExitPlanModeRequest,
@@ -1417,6 +1445,7 @@ class CopilotClient {
         requestPermission: config.onPermissionRequest !== defaultJoinSessionPermissionHandler,
         requestUserInput: !!config.onUserInputRequest,
         requestElicitation: !!config.onElicitationRequest,
+        askUserVariant: config.askUserVariant,
         ...config.enableMcpApps ? { requestMcpApps: true } : {},
         ...config.githubMcpToolConfig != null ? { githubMcpToolConfig: config.githubMcpToolConfig } : {},
         requestExitPlanMode: !!config.onExitPlanModeRequest,
@@ -1548,8 +1577,8 @@ class CopilotClient {
   async listModels() {
     await this.modelsCacheLock;
     let resolveLock;
-    this.modelsCacheLock = new Promise((resolve) => {
-      resolveLock = resolve;
+    this.modelsCacheLock = new Promise((resolve2) => {
+      resolveLock = resolve2;
     });
     try {
       if (this.modelsCache !== null) {
@@ -1865,7 +1894,7 @@ class CopilotClient {
    * Start the CLI server process
    */
   async startCLIServer() {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       this.stderrBuffer = "";
       const args = [...this.connectionExtraArgs, "--headless", "--no-auto-update"];
       if (this.options.logLevel) {
@@ -1926,7 +1955,7 @@ class CopilotClient {
       let resolved = false;
       if (this.connectionConfig.kind === "stdio") {
         resolved = true;
-        resolve();
+        resolve2();
       } else {
         this.cliProcess.stdout?.on("data", (data) => {
           stdout += data.toString();
@@ -1934,7 +1963,7 @@ class CopilotClient {
           if (match && !resolved) {
             this.runtimePort = parseInt(match[1], 10);
             resolved = true;
-            resolve();
+            resolve2();
           }
         });
       }
@@ -1966,26 +1995,27 @@ stderr: ${stderrOutput}`
       });
       this.processExitPromise = new Promise((_, rejectProcessExit) => {
         this.cliProcess.on("exit", (code) => {
-          setTimeout(() => {
-            const stderrOutput = this.stderrBuffer.trim();
-            if (stderrOutput) {
-              rejectProcessExit(
-                new Error(
-                  `CLI server exited with code ${code}
+          if (this.messageWriter) {
+            this.messageWriter.suppressWriteErrors = true;
+          }
+          const stderrOutput = this.stderrBuffer.trim();
+          if (stderrOutput) {
+            rejectProcessExit(
+              new Error(
+                `CLI server exited with code ${code}
 stderr: ${stderrOutput}`
-                )
-              );
-            } else {
-              rejectProcessExit(
-                new Error(`CLI server exited unexpectedly with code ${code}`)
-              );
-            }
-          }, 50);
+              )
+            );
+          } else {
+            rejectProcessExit(
+              new Error(`CLI server exited unexpectedly with code ${code}`)
+            );
+          }
         });
       });
       this.processExitPromise.catch(() => {
       });
-      this.cliProcess.on("exit", (code) => {
+      this.cliProcess.on("close", (code) => {
         if (!resolved) {
           resolved = true;
           const stderrOutput = this.stderrBuffer.trim();
@@ -2027,7 +2057,13 @@ stderr: ${stderrOutput}`
   }
   /** Starts the in-process FFI runtime with SDK-managed typed options. */
   async startInProcessFfi() {
-    const entrypoint = this.resolveCliPathForFfi();
+    const explicitEntrypoint = this.resolvedEnv.COPILOT_CLI_PATH;
+    const runtimeLibrary = explicitEntrypoint ? join(
+      dirname(resolve(explicitEntrypoint)),
+      "prebuilds",
+      CopilotClient.getNapiPrebuildsFolder(explicitEntrypoint),
+      "runtime.node"
+    ) : join(dirname(getBundledRuntimePath()), "runtime.node");
     const { FfiRuntimeHost } = await import("./ffiRuntimeHost.js");
     const environment = {};
     if (this.options.gitHubToken) {
@@ -2055,12 +2091,7 @@ stderr: ${stderrOutput}`
     if (this.options.enableRemoteSessions) {
       args.push("--remote");
     }
-    const host = FfiRuntimeHost.create(
-      entrypoint,
-      CopilotClient.getNapiPrebuildsFolder(entrypoint),
-      environment,
-      args
-    );
+    const host = FfiRuntimeHost.create(runtimeLibrary, explicitEntrypoint, environment, args);
     this.ffiHost = host;
     await host.start();
   }
@@ -2080,19 +2111,6 @@ stderr: ${stderrOutput}`
     this.attachConnectionHandlers();
     this.connection.listen();
   }
-  /**
-   * Resolves the CLI entrypoint used for in-process FFI hosting: `COPILOT_CLI_PATH`
-   * when set, otherwise the bundled platform-package entrypoint.
-   */
-  resolveCliPathForFfi() {
-    return this.resolvedEnv.COPILOT_CLI_PATH ?? getBundledCliPath();
-  }
-  /**
-   * Returns the napi prebuilds folder name for the current host — the
-   * `<node-platform>-<arch>` convention (e.g. `win32-x64`, `darwin-arm64`,
-   * `linux-x64`, `linuxmusl-x64`) under which the runtime ships
-   * `prebuilds/<folder>/runtime.node`.
-   */
   static getNapiPrebuildsFolder(entrypoint) {
     const arch = process.arch;
     if (arch !== "x64" && arch !== "arm64") {
@@ -2128,6 +2146,11 @@ stderr: ${stderrOutput}`
       }
       this.state = "error";
       const reason = err instanceof Error ? err.stack ?? err.message : String(err);
+      const stderrOutput = this.stderrBuffer.trim();
+      this.processTransportError = new Error(
+        `CLI server connection failed: ${reason}${stderrOutput ? `
+stderr: ${stderrOutput}` : ""}`
+      );
       this.logDebug(`stdin pipe error: ${reason}`);
       try {
         this.connection?.dispose();
@@ -2164,7 +2187,7 @@ stderr: ${stderrOutput}`
     if (!this.runtimePort) {
       throw new Error("Server port not available");
     }
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       this.socket = new Socket();
       const connectionTimeout = setTimeout(() => {
         this.socket?.destroy();
@@ -2179,7 +2202,7 @@ stderr: ${stderrOutput}`
         );
         this.attachConnectionHandlers();
         this.connection.listen();
-        resolve();
+        resolve2();
       });
       this.socket.on("error", (error) => {
         clearTimeout(connectionTimeout);

package/dist/extension.d.ts

@@ -42,7 +42,7 @@ export type JoinSessionConfig = Omit<ResumeSessionConfig, "onPermissionRequest"
     factories?: FactoryHandle[];
 };
 export type { ExtensionInfo, FactoryLimits, FactoryMeta } from "./types.js";
-export { defineFactory, FactoryResumeError, isFactoryRunTerminal, type RunOptions, type ResumeOptions, type FactoryResumeErrorCode, type SessionFactoryApi, type FactoryAgentOptions, type FactoryContext, type FactoryDefinition, type FactoryHandle, type FactoryJsonSchema, type JsonValue, type FactoryPipelineStage, type FactoryStepOptions, type FactoryRunResult, type FactoryRunStatus, type FactoryRunSummary, type FactoryRunDetail, type FactoryProgressPage, type FactoryProgressLine, type FactoryPhaseObservation, type FactoryPhaseStatus, type FactoryAgentSummary, } from "./factory.js";
+export { defineFactory, FactoryResumeError, isFactoryRunTerminal, type RunOptions, type ResumeOptions, type FactoryResumeErrorCode, type SessionFactoryApi, type FactoryAgentOptions, type FactoryContext, type FactoryDefinition, type FactoryHandle, type FactoryJsonSchema, type JsonValue, type FactoryPipelineStage, type FactoryStepOptions, type FactoryRunResult, type FactoryRunStatus, type FactoryRunSummary, type FactoryListRunsOptions, type FactoryRunsPage, type FactoryRunDetail, type FactoryProgressPage, type FactoryProgressLine, type FactoryPhaseObservation, type FactoryPhaseStatus, type FactoryAgentSummary, } from "./factory.js";
 /**
  * Joins the current foreground session.
  *

package/dist/factory.d.ts

@@ -1,9 +1,23 @@
-import type { FactoryGetRunProgressRequest, FactoryProgressPage, FactoryRunDetail, FactoryRunResult, FactoryRunStatus, FactoryRunSummary } from "./generated/rpc.js";
+import type { FactoryGetRunProgressRequest, FactoryListRunsRequest, FactoryListRunsResult, FactoryProgressPage, FactoryRunDetail, FactoryRunResult, FactoryRunStatus, FactoryRunSummary } from "./generated/rpc.js";
 import type { ContextTier } from "./generated/session-events.js";
 import type { CopilotSession } from "./session.js";
 import type { FactoryLimits, FactoryMeta } from "./types.js";
 export type { FactoryRunResult };
 export type { FactoryAgentSummary, FactoryPhaseStatus, FactoryPhaseObservation, FactoryProgressLine, FactoryProgressPage, FactoryRunDetail, FactoryRunStatus, FactoryRunSummary, } from "./generated/rpc.js";
+/**
+ * Options for paging durable factory runs.
+ *
+ * @experimental Part of the experimental Agent Factories surface and may
+ * change or be removed in future SDK or CLI releases.
+ */
+export type FactoryListRunsOptions = FactoryListRunsRequest;
+/**
+ * A page of durable factory runs and its paging metadata.
+ *
+ * @experimental Part of the experimental Agent Factories surface and may
+ * change or be removed in future SDK or CLI releases.
+ */
+export type FactoryRunsPage = FactoryListRunsResult;
 /**
  * Whether a factory run status is terminal.
  *
@@ -165,6 +179,10 @@ export interface RunOptions<TArgs extends JsonValue = JsonValue> {
     args?: TArgs;
     /** Optional per-invocation resource ceiling overrides. */
     limits?: FactoryLimits;
+    /** Whether to notify the originating session when the factory completes. */
+    notifyOnComplete?: boolean;
+    /** Whether to emit factory phase names to the session transcript. */
+    logPhaseNames?: boolean;
     /**
      * Prior run whose persisted identity, arguments, journal, and accounting should be resumed.
      *
@@ -181,6 +199,10 @@ export interface RunOptions<TArgs extends JsonValue = JsonValue> {
 export interface ResumeOptions {
     /** Optional per-invocation resource ceiling overrides. */
     limits?: FactoryLimits;
+    /** Whether to notify the originating session when the factory completes. */
+    notifyOnComplete?: boolean;
+    /** Whether to emit factory phase names to the session transcript. */
+    logPhaseNames?: boolean;
 }
 /**
  * Machine-readable pre-execution factory resume failure.
@@ -239,8 +261,20 @@ export interface SessionFactoryApi {
     }): Promise<FactoryRunResult>;
     /**
      * List the newest default page of this session's durable factory runs.
+     *
+     * This backwards-compatible overload returns only the runs array. Pass
+     * paging options to receive the full page, including its cursors and
+     * truncation metadata.
      */
     listRuns(): Promise<FactoryRunSummary[]>;
+    /**
+     * Page this session's durable factory runs.
+     *
+     * `afterSeq` and `beforeSeq` are exclusive cursors. The result includes
+     * `oldestSeq`, `newestSeq`, `hasMoreNewer`, and `omittedOlder` so callers
+     * can continue paging without using the raw RPC client.
+     */
+    listRuns(options: FactoryListRunsOptions): Promise<FactoryRunsPage>;
     /** Read durable phases, direct agents, and the latest progress tail for a run. */
     getRunDetail(runId: string): Promise<FactoryRunDetail>;
     /** Page durable progress forward, backward, or from the latest tail. */

package/dist/ffiRuntimeHost.d.ts

@@ -16,16 +16,10 @@ export declare class FfiRuntimeHost {
     readonly sendStream: Writable;
     private constructor();
     /**
-     * Resolves the cdylib next to the given CLI entrypoint and prepares the FFI host.
-     * The cdylib is resolved as `prebuilds/<prebuildsFolder>/runtime.node` relative to
-     * the entrypoint directory (the napi-rs `<node-platform>-<arch>` layout, e.g.
-     * `linux-x64`). Throws if it cannot be found.
-     */
-    static create(cliEntrypoint: string, prebuildsFolder: string, environment: Record<string, string | undefined> | undefined, args: readonly string[]): FfiRuntimeHost;
-    /**
-     * Starts the in-process runtime: spawns the CLI worker via the native host,
-     * waits for readiness, and opens the FFI JSON-RPC connection.
+     * Loads the runtime cdylib at the given path and prepares the FFI host.
      */
+    static create(libraryPath: string, cliEntrypoint: string | undefined, environment: Record<string, string | undefined> | undefined, args: readonly string[]): FfiRuntimeHost;
+    /** Starts the in-process Rust runtime and opens the FFI JSON-RPC connection. */
     start(): Promise<void>;
     private writeFrame;
     /**

package/dist/ffiRuntimeHost.js

@@ -1,6 +1,6 @@
 import { existsSync } from "node:fs";
 import koffi from "koffi";
-import { dirname, join, resolve } from "node:path";
+import { resolve } from "node:path";
 import { PassThrough, Writable } from "node:stream";
 const SYMBOL_PREFIX = "copilot_runtime_";
 const KEEP_ALIVE_INTERVAL_MS = 1 << 30;
@@ -52,7 +52,7 @@ function loadLibrary(libraryPath) {
   return loadedLibrary;
 }
 function buildArgvJson(cliEntrypoint, args) {
-  const argv = cliEntrypoint.toLowerCase().endsWith(".js") ? ["node", cliEntrypoint, "--embedded-host", "--no-auto-update"] : [cliEntrypoint, "--embedded-host", "--no-auto-update"];
+  const argv = cliEntrypoint ? cliEntrypoint.toLowerCase().endsWith(".js") ? ["node", cliEntrypoint, "--embedded-host", "--no-auto-update"] : [cliEntrypoint, "--embedded-host", "--no-auto-update"] : [];
   argv.push(...args);
   return Buffer.from(JSON.stringify(argv), "utf8");
 }
@@ -107,24 +107,21 @@ class FfiRuntimeHost {
   /** The stream JSON-RPC writes client→server frames to. */
   sendStream;
   /**
-   * Resolves the cdylib next to the given CLI entrypoint and prepares the FFI host.
-   * The cdylib is resolved as `prebuilds/<prebuildsFolder>/runtime.node` relative to
-   * the entrypoint directory (the napi-rs `<node-platform>-<arch>` layout, e.g.
-   * `linux-x64`). Throws if it cannot be found.
+   * Loads the runtime cdylib at the given path and prepares the FFI host.
    */
-  static create(cliEntrypoint, prebuildsFolder, environment, args) {
-    const fullEntrypoint = resolve(cliEntrypoint);
-    const distDir = dirname(fullEntrypoint);
-    const libraryPath = join(distDir, "prebuilds", prebuildsFolder, "runtime.node");
-    if (!existsSync(libraryPath)) {
-      throw new Error(`FFI runtime library not found. Looked for '${libraryPath}'.`);
+  static create(libraryPath, cliEntrypoint, environment, args) {
+    const fullLibraryPath = resolve(libraryPath);
+    if (!existsSync(fullLibraryPath)) {
+      throw new Error(`FFI runtime library not found at '${fullLibraryPath}'.`);
     }
-    return new FfiRuntimeHost(libraryPath, fullEntrypoint, environment, args);
+    return new FfiRuntimeHost(
+      fullLibraryPath,
+      cliEntrypoint ? resolve(cliEntrypoint) : void 0,
+      environment,
+      args
+    );
   }
-  /**
-   * Starts the in-process runtime: spawns the CLI worker via the native host,
-   * waits for readiness, and opens the FFI JSON-RPC connection.
-   */
+  /** Starts the in-process Rust runtime and opens the FFI JSON-RPC connection. */
   async start() {
     const argvJson = buildArgvJson(this.cliEntrypoint, this.args);
     const envJson = buildEnvJson(this.environment);
@@ -144,9 +141,7 @@ class FfiRuntimeHost {
       );
     });
     if (!this.serverId) {
-      throw new Error(
-        `copilot_runtime_host_start failed (library '${this.libraryPath}', entrypoint '${this.cliEntrypoint}').`
-      );
+      throw new Error(`copilot_runtime_host_start failed (library '${this.libraryPath}').`);
     }
     this.outboundCallback = koffi.register(
       (_userData, bytesPtr, bytesLen) => this.feedInbound(bytesPtr, bytesLen),

package/dist/generated/rpc.d.ts

@@ -3,7 +3,7 @@
  * Generated from: api.schema.json
  */
 import type { MessageConnection } from "vscode-jsonrpc/node.js";
-import type { AbortReason, Attachment, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerSource, McpServerStatus, ModelChangeSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js";
+import type { AbortReason, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerSource, McpServerStatus, ModelChangeSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js";
 /** A value that can be represented losslessly on the SDK JSON wire. */
 export type JsonValue = null | boolean | number | string | JsonValue[] | {
     [key: string]: JsonValue;
@@ -5180,6 +5180,7 @@ export interface CanvasProviderUnregisterRequest {
  */
 /** @experimental */
 export interface CapiSessionOptions {
+    autoTier?: AutoTier;
     /**
      * Whether to use WebSocket transport for the CAPI Responses API. Enabled by default when the model advertises `ws:/responses` support; set to `false` to force the HTTP Responses transport in environments where WebSockets are blocked (e.g. behind a proxy). Setting this to `false` is equivalent to the `COPILOT_CLI_DISABLE_WEBSOCKET_RESPONSES` environment variable.
      */
@@ -6463,6 +6464,10 @@ export interface EnqueueCommandParams {
      * Slash-prefixed command string to enqueue, e.g. '/compact' or '/model gpt-4'. Queued FIFO with any in-flight items; if the session is idle, processing kicks off immediately.
      */
     command: string;
+    /**
+     * Optional user-facing text for the queue row. The command string is shown when omitted.
+     */
+    displayText?: string | null;
 }
 /**
  * Indicates whether the command was accepted into the local execution queue.
@@ -15877,6 +15882,27 @@ export interface SandboxConfigAuth {
      */
     gh?: boolean;
 }
+/**
+ * Managed sandbox enforcement state for a session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SandboxEnforcementStatus".
+ */
+/** @experimental */
+export interface SandboxEnforcementStatus {
+    /**
+     * Whether the effective managed policy requires an available sandbox backend.
+     */
+    required: boolean;
+    /**
+     * Whether an enforcement failure has permanently blocked the session.
+     */
+    blocked: boolean;
+    /**
+     * The first sandbox enforcement failure that blocked the session.
+     */
+    reason?: string;
+}
 /**
  * Register an absolute-time scheduled prompt.
  *
@@ -22160,7 +22186,7 @@ export declare function createServerRpc(connection: MessageConnection): {
         disable: (params: DiscoveredExtensionsDisableRequest) => Promise<void>;
     };
     /**
-     * Registers the calling SDK client as the per-entrypoint extension launch provider. Call before creating any sessions. When omitted, the runtime temporarily falls back to its built-in Node launcher for backward compatibility.
+     * Registers the calling SDK client as the per-entrypoint extension launch provider. Call before creating any sessions. When omitted, the runtime uses its built-in extension launcher.
      *
      * @experimental
      */
@@ -22655,6 +22681,15 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
      * @experimental
      */
     sendMessages: (params: SendMessagesRequest) => Promise<SendMessagesResult>;
+    /** @experimental */
+    sandbox: {
+        /**
+         * Returns whether managed policy requires sandbox enforcement and whether an enforcement failure has permanently blocked the session.
+         *
+         * @returns Managed sandbox enforcement state for a session.
+         */
+        getEnforcementStatus: () => Promise<SandboxEnforcementStatus>;
+    };
     /**
      * Aborts the current agent turn.
      *

package/dist/generated/rpc.js

@@ -172,7 +172,7 @@ function createServerRpc(connection) {
       disable: async (params) => connection.sendRequest("extensions.disable", params)
     },
     /**
-     * Registers the calling SDK client as the per-entrypoint extension launch provider. Call before creating any sessions. When omitted, the runtime temporarily falls back to its built-in Node launcher for backward compatibility.
+     * Registers the calling SDK client as the per-entrypoint extension launch provider. Call before creating any sessions. When omitted, the runtime uses its built-in extension launcher.
      *
      * @experimental
      */
@@ -745,6 +745,15 @@ function createSessionRpc(connection, sessionId) {
      * @experimental
      */
     sendMessages: async (params) => connection.sendRequest("session.sendMessages", { sessionId, ...params }),
+    /** @experimental */
+    sandbox: {
+      /**
+       * Returns whether managed policy requires sandbox enforcement and whether an enforcement failure has permanently blocked the session.
+       *
+       * @returns Managed sandbox enforcement state for a session.
+       */
+      getEnforcementStatus: async () => connection.sendRequest("session.sandbox.getEnforcementStatus", { sessionId })
+    },
     /**
      * Aborts the current agent turn.
      *