@github/copilot-sdk-win32-x64 1.0.15 → 1.0.16-preview.0

package/copilot-sdk/client.d.ts

@@ -1,5 +1,6 @@
 import { createServerRpc } from "./generated/rpc.js";
 import { CopilotSession } from "./session.js";
+import { AhpHost, type AhpHostOptions } from "./host.js";
 import type { CopilotClientOptions, GetAuthStatusResponse, GetStatusResponse, ModelInfo, ResumeSessionConfig, SessionConfig, SessionLifecycleEventType, SessionLifecycleHandler, SessionListFilter, SessionMetadata, TypedSessionLifecycleHandler } from "./types.js";
 export declare class CopilotClient {
     private cliStartTimeout;
@@ -16,6 +17,9 @@ export declare class CopilotClient {
     /** Shared in-flight start; concurrent callers await it instead of spawning another CLI. */
     private startPromise;
     private sessions;
+    private hostExitCallbacks;
+    private hostSessionFactories;
+    private hostHandoffs;
     private stderrBuffer;
     /** Resolved connection mode chosen in the constructor. */
     private connectionConfig;
@@ -135,7 +139,8 @@ export declare class CopilotClient {
      * 1. Closes all active sessions (releases in-memory resources)
      * 2. Requests runtime shutdown for SDK-owned CLI processes
      * 3. Closes the JSON-RPC connection
-     * 4. Terminates the CLI server process (if spawned by this client)
+     * 4. Signals EOF to an owned stdio process and waits for host cleanup, then
+     *    terminates the process if it does not exit within the shutdown timeout
      *
      * Note: session data on disk is preserved, so sessions can be resumed later.
      * To permanently remove session data before stopping, call
@@ -242,6 +247,27 @@ export declare class CopilotClient {
      */
     resumeSession(sessionId: string, config: ResumeSessionConfig): Promise<CopilotSession>;
     private resumeSessionInternal;
+    /**
+     * Start a complete AHP listener hosted in-process by this runtime.
+     *
+     * This connection owns the host. Disposing it or disconnecting the client
+     * stops the listener without deleting sessions. The host uses a separate
+     * SDK connection to the same runtime, not another runtime process.
+     * Only one AHP host may own the catalog in an effective Copilot home
+     * at a time. Other SDK clients and sessions remain usable in that home.
+     * Select localServer, githubEnvironment, or both. An empty localServer
+     * selects 127.0.0.1 on an available port. `onExit` runs at most once; owner disconnection cannot
+     * acknowledge listener cleanup over the disconnected transport.
+     *
+     * @experimental
+     */
+    startAhpHost(options: AhpHostOptions): Promise<AhpHost>;
+    private handleHostExit;
+    private disconnectHosts;
+    private releaseHostSessions;
+    private releaseHostSession;
+    private notifyHostSessionReleased;
+    private createHostSession;
     /**
      * Sends a ping request to the server to verify connectivity.
      *