@adhdev/daemon-core 0.7.6 → 0.7.7

package/dist/index.d.ts

@@ -1,5 +1,9 @@
-import { S as StatusResponse, D as DaemonEvent, C as CommandResult$2, a as SessionEntry, P as ProviderCategory, b as ProviderModule, R as ResolvedProvider, c as ProviderSettingSchema, d as CdpTargetFilter, e as ProviderInstance, I as InstanceContext, f as ProviderState, g as ProviderEvent, h as SessionTransport, i as StatusReportPayload, A as AvailableProviderInfo, j as AcpProviderState, k as ContentBlock } from './normalize-tKg8IiDk.js';
-export { l as AcpConfigOption, m as AcpMode, n as ActiveChatData, o as AgentEntry, p as AgentSessionStream, q as ChatMessage, r as CliProviderState, s as DetectedIde, t as DetectedIdeInfo, E as ExtensionInfo, u as ExtensionProviderState, v as IdeProviderState, M as MachineInfo, w as ManagedStatus, x as ProviderConfig, y as ProviderErrorReason, z as ProviderInfo, B as ProviderStatus, F as SessionCapability, G as SessionKind, H as SystemInfo, W as WorkspaceActivity, J as WorkspaceEntry, K as addCliHistory, L as getWorkspaceActivity, N as getWorkspaceState, O as isManagedStatusWaiting, Q as isManagedStatusWorking, T as isSetupComplete, U as loadConfig, V as markSetupComplete, X as normalizeActiveChatData, Y as normalizeManagedStatus, Z as resetConfig, _ as saveConfig, $ as updateConfig } from './normalize-tKg8IiDk.js';
+import { S as StatusResponse, D as DaemonEvent, C as CommandResult$2, a as SessionEntry, P as ProviderCategory, b as ProviderModule, R as ResolvedProvider, c as ProviderSettingSchema, d as CdpTargetFilter, e as ProviderInstance, I as InstanceContext, f as ProviderState, g as ProviderEvent, h as SessionTransport, i as StatusReportPayload, A as AvailableProviderInfo, j as ProviderResumeCapability, k as AcpProviderState, l as ContentBlock } from './normalize-auJAPmKy.js';
+export { m as AcpConfigOption, n as AcpMode, o as ActiveChatData, p as AgentEntry, q as AgentSessionStream, r as ChatMessage, s as CliProviderState, t as DetectedIde, u as DetectedIdeInfo, E as ExtensionInfo, v as ExtensionProviderState, w as IdeProviderState, M as MachineInfo, x as ManagedStatus, y as ProviderConfig, z as ProviderErrorReason, B as ProviderInfo, F as ProviderStatus, G as SessionCapability, H as SessionKind, J as SystemInfo, W as WorkspaceActivity, K as WorkspaceEntry, L as addCliHistory, N as getWorkspaceActivity, O as getWorkspaceState, Q as isManagedStatusWaiting, T as isManagedStatusWorking, U as isSetupComplete, V as loadConfig, X as markSetupComplete, Y as normalizeActiveChatData, Z as normalizeManagedStatus, _ as resetConfig, $ as saveConfig, a0 as updateConfig } from './normalize-auJAPmKy.js';
+import * as child_process from 'child_process';
+import { ChildProcess } from 'child_process';
+import * as http from 'http';
+import { SessionHostEndpoint, SessionHostCategory } from '@adhdev/session-host-core';
 
 /**
  * DaemonCore — Core daemon orchestrator interface
@@ -596,6 +600,9 @@ declare class ProviderInstanceManager {
     * Instance remove
     */
     removeInstance(id: string): void;
+    removeByCategory(category: 'cli' | 'ide' | 'extension' | 'acp', options?: {
+        dispose?: boolean;
+    }): number;
     /**
     * Import by Instance ID
     */
@@ -1307,7 +1314,9 @@ interface CliAdapter {
     sendMessage(text: string): Promise<void>;
     getStatus(): any;
     getPartialResponse(): string;
+    saveAndStop?(): Promise<void>;
     shutdown(): void;
+    detach?(): void;
     cancel(): void;
     isProcessing(): boolean;
     isReady(): boolean;
@@ -1318,6 +1327,50 @@ interface CliAdapter {
     resize?(cols: number, rows: number): void;
 }
 
+interface PtySpawnOptions {
+    cwd: string;
+    env: Record<string, string>;
+    cols: number;
+    rows: number;
+}
+interface PtyRuntimeWriteOwner {
+    clientId: string;
+    ownerType: 'agent' | 'user';
+}
+interface PtyRuntimeClientInfo {
+    clientId: string;
+    type: 'daemon' | 'web' | 'local-terminal';
+    readOnly: boolean;
+}
+interface PtyRuntimeMetadata {
+    runtimeId: string;
+    runtimeKey?: string;
+    displayName?: string;
+    workspaceLabel?: string;
+    writeOwner?: PtyRuntimeWriteOwner | null;
+    attachedClients?: PtyRuntimeClientInfo[];
+}
+interface PtyRuntimeTransport {
+    readonly pid: number;
+    readonly ready: Promise<void>;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+    clearBuffer?(): void;
+    detach?(): void;
+    getMetadata?(): PtyRuntimeMetadata | null;
+    onData(callback: (data: string) => void): void;
+    onExit(callback: (info: {
+        exitCode: number;
+    }) => void): void;
+}
+interface PtyTransportFactory {
+    spawn(command: string, args: string[], options: PtySpawnOptions): PtyRuntimeTransport;
+}
+declare class NodePtyTransportFactory implements PtyTransportFactory {
+    spawn(command: string, args: string[], options: PtySpawnOptions): PtyRuntimeTransport;
+}
+
 /**
  * DaemonCliManager — CLI session creation, management, and command handling
  *
@@ -1338,11 +1391,31 @@ interface CliManagerDeps {
     /** InstanceManager — register in CLI unified status */
     getInstanceManager(): ProviderInstanceManager | null;
     getSessionRegistry?(): SessionRegistry | null;
+    createPtyTransportFactory?: (params: CliTransportFactoryParams) => PtyTransportFactory | null;
+    listHostedCliRuntimes?: () => Promise<HostedCliRuntimeDescriptor[]>;
 }
 type CommandResult = {
     success: boolean;
     [key: string]: unknown;
 };
+interface CliTransportFactoryParams {
+    runtimeId: string;
+    providerType: string;
+    workspace: string;
+    cliArgs?: string[];
+    attachExisting?: boolean;
+}
+interface HostedCliRuntimeDescriptor {
+    runtimeId: string;
+    runtimeKey?: string;
+    displayName?: string;
+    workspaceLabel?: string;
+    lifecycle?: 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted';
+    recoveryState?: string | null;
+    cliType: string;
+    workspace: string;
+    cliArgs?: string[];
+}
 declare class DaemonCliManager {
     readonly adapters: Map<string, CliAdapter>;
     private deps;
@@ -1350,10 +1423,16 @@ declare class DaemonCliManager {
     constructor(deps: CliManagerDeps, providerLoader: ProviderLoader);
     getCliKey(cliType: string, dir: string): string;
     private persistRecentDir;
+    private getTransportFactory;
     private createAdapter;
+    private startCliExitMonitor;
+    private registerCliInstance;
     startSession(cliType: string, workingDir: string, cliArgs?: string[], initialModel?: string): Promise<void>;
     stopSession(key: string): Promise<void>;
+    stopSessionWithMode(key: string, mode: 'hard' | 'save'): Promise<void>;
     shutdownAll(): void;
+    detachAll(): void;
+    restoreHostedSessions(records?: HostedCliRuntimeDescriptor[]): Promise<number>;
     /**
     * Search for CLI adapter. Priority order:
     * 0. sessionId (UUID direct match)
@@ -1788,6 +1867,7 @@ interface CliScripts {
     /** Parse approval modal from PTY output → ModalInfo | null */
     parseApproval?: (input: {
         buffer: string;
+        screenText?: string;
         rawBuffer?: string;
         tail: string;
     }) => {
@@ -1840,6 +1920,7 @@ interface CliProviderModule {
         /** Output settle debounce before evaluating status (default 300ms) */
         outputSettle?: number;
     };
+    resume?: ProviderResumeCapability;
 }
 declare class ProviderCliAdapter implements CliAdapter {
     private extraArgs;
@@ -1848,6 +1929,7 @@ declare class ProviderCliAdapter implements CliAdapter {
     workingDir: string;
     private provider;
     private ptyProcess;
+    private transportFactory;
     private messages;
     private committedMessages;
     private structuredMessages;
@@ -1908,7 +1990,7 @@ declare class ProviderCliAdapter implements CliAdapter {
     private readonly sendKey;
     private readonly submitStrategy;
     private static readonly SCRIPT_STATUS_DEBOUNCE_MS;
-    constructor(provider: CliProviderModule, workingDir: string, extraArgs?: string[]);
+    constructor(provider: CliProviderModule, workingDir: string, extraArgs?: string[], transportFactory?: PtyTransportFactory);
     /** Inject CLI scripts after construction (e.g. when resolved by ProviderLoader) */
     setCliScripts(scripts: CliScripts): void;
     setServerConn(serverConn: any): void;
@@ -1919,6 +2001,7 @@ declare class ProviderCliAdapter implements CliAdapter {
     private handleOutput;
     private scheduleSettle;
     private armApprovalExitTimeout;
+    private looksLikeVisibleIdlePrompt;
     private evaluateSettled;
     private finishResponse;
     private commitCurrentTranscript;
@@ -1940,8 +2023,12 @@ declare class ProviderCliAdapter implements CliAdapter {
     resolveAction(data: any): Promise<void>;
     sendMessage(text: string): Promise<void>;
     getPartialResponse(): string;
+    getRuntimeMetadata(): PtyRuntimeMetadata | null;
     cancel(): void;
+    saveAndStop(): Promise<void>;
+    private waitForStopped;
     shutdown(): void;
+    detach(): void;
     clearHistory(): void;
     isProcessing(): boolean;
     isReady(): boolean;
@@ -1976,7 +2063,7 @@ declare class CliProviderInstance implements ProviderInstance {
     private lastApprovalEventAt;
     private historyWriter;
     readonly instanceId: string;
-    constructor(provider: ProviderModule, workingDir: string, cliArgs?: string[], instanceId?: string);
+    constructor(provider: ProviderModule, workingDir: string, cliArgs?: string[], instanceId?: string, transportFactory?: PtyTransportFactory);
     init(context: InstanceContext): Promise<void>;
     onTick(): Promise<void>;
     getState(): ProviderState;
@@ -2094,35 +2181,52 @@ declare class AcpProviderInstance implements ProviderInstance {
 }
 
 /**
- * Dev Server — HTTP API for Provider debugging + script development
- *
- * Enabled with `adhdev daemon --dev`
- * Port: 19280 (fixed)
- *
- * API list:
- * GET /api/providers — loaded provider list
- * POST /api/providers/:type/script — specific script execute
- * POST /api/cdp/evaluate — Execute JS expression
- * POST /api/cdp/dom/query — Test selector
- * GET /api/cdp/screenshot — screenshot
- * POST /api/scripts/run — Execute provider script (name + params)
- * GET /api/status — All status (CDP connection, provider etc)
+ * Context passed from the main DevServer to handler modules.
+ * Provides access to shared dependencies and utility methods.
  */
+interface DevServerContext {
+    readonly providerLoader: ProviderLoader;
+    readonly cdpManagers: Map<string, DaemonCdpManager>;
+    readonly instanceManager: ProviderInstanceManager | null;
+    readonly cliManager: DaemonCliManager | null;
+    getCdp(ideType?: string): DaemonCdpManager | null;
+    json(res: http.ServerResponse, status: number, data: any): void;
+    readBody(req: http.IncomingMessage): Promise<any>;
+    log(msg: string): void;
+    autoImplSSEClients: http.ServerResponse[];
+    sendAutoImplSSE(msg: {
+        event: string;
+        data: any;
+    }): void;
+    autoImplStatus: {
+        running: boolean;
+        type: string | null;
+        progress: any[];
+    };
+    autoImplProcess: child_process.ChildProcess | null;
+    sendCliSSE(data: any): void;
+    findProviderDir(type: string): string | null;
+    getLatestScriptVersionDir(scriptsDir: string): string | null;
+}
 
-declare class DevServer {
+declare class DevServer implements DevServerContext {
     private server;
-    private providerLoader;
-    private cdpManagers;
-    private instanceManager;
-    private cliManager;
+    providerLoader: ProviderLoader;
+    cdpManagers: Map<string, DaemonCdpManager>;
+    instanceManager: ProviderInstanceManager | null;
+    cliManager: DaemonCliManager | null;
     private logFn;
     private sseClients;
     private watchScriptPath;
     private watchScriptName;
     private watchTimer;
-    private autoImplProcess;
-    private autoImplSSEClients;
-    private autoImplStatus;
+    autoImplProcess: ChildProcess | null;
+    autoImplSSEClients: http.ServerResponse[];
+    autoImplStatus: {
+        running: boolean;
+        type: string | null;
+        progress: any[];
+    };
     private cliSSEClients;
     constructor(options: {
         providerLoader: ProviderLoader;
@@ -2131,7 +2235,7 @@ declare class DevServer {
         cliManager?: DaemonCliManager;
         logFn?: (msg: string) => void;
     });
-    private log;
+    log(msg: string): void;
     private readonly routes;
     private matchRoute;
     private getEndpointList;
@@ -2157,7 +2261,7 @@ declare class DevServer {
     private handleWatchStart;
     private handleWatchStop;
     /** Find the provider directory on disk */
-    private findProviderDir;
+    findProviderDir(type: string): string | null;
     /** GET /api/providers/:type/files — list all files in provider directory */
     private handleListFiles;
     /** GET /api/providers/:type/file?path=scripts.js — read a file */
@@ -2180,26 +2284,25 @@ declare class DevServer {
     private handleFindCommon;
     private handleFindByText;
     private handleDomContext;
-    private getDefaultAutoImplReference;
-    private resolveAutoImplReference;
-    private getLatestScriptVersionDir;
+    getLatestScriptVersionDir(scriptsDir: string): string | null;
     private resolveAutoImplWritableProviderDir;
-    private loadAutoImplReferenceScripts;
     private handleAutoImplement;
     private buildAutoImplPrompt;
     private buildCliAutoImplPrompt;
     private handleAutoImplSSE;
     private handleAutoImplCancel;
-    private sendAutoImplSSE;
+    sendAutoImplSSE(msg: {
+        event: string;
+        data: any;
+    }): void;
     /** Get CDP manager — matching IDE when ideType specified, first connected one otherwise.
      *  DevServer is a debugging tool so first-connected fallback is acceptable,
      *  but callers should pass ideType when possible. */
-    private getCdp;
-    private json;
-    private readBody;
+    getCdp(ideType?: string): DaemonCdpManager | null;
+    json(res: http.ServerResponse, status: number, data: any): void;
+    readBody(req: http.IncomingMessage): Promise<any>;
     /** GET /api/cli/status — list all running CLI/ACP instances with state */
     private handleCliStatus;
-    private findCliTarget;
     /** POST /api/cli/launch — launch a CLI agent { type, workingDir?, args? } */
     private handleCliLaunch;
     /** POST /api/cli/send — send message to a running CLI { type, text } */
@@ -2208,7 +2311,7 @@ declare class DevServer {
     private handleCliStop;
     /** GET /api/cli/events — SSE stream of CLI status events */
     private handleCliSSE;
-    private sendCliSSE;
+    sendCliSSE(data: any): void;
     /** GET /api/cli/debug/:type — full internal debug state of a CLI adapter */
     private handleCliDebug;
     /** POST /api/cli/resolve — resolve an approval modal { type, buttonIndex } */
@@ -2217,6 +2320,23 @@ declare class DevServer {
     private handleCliRaw;
 }
 
+interface SessionHostPtyTransportFactoryOptions {
+    endpoint?: SessionHostEndpoint;
+    appName?: string;
+    clientId: string;
+    runtimeId: string;
+    providerType: string;
+    category?: SessionHostCategory;
+    workspace: string;
+    meta?: Record<string, unknown>;
+    attachExisting?: boolean;
+}
+declare class SessionHostPtyTransportFactory implements PtyTransportFactory {
+    private readonly options;
+    constructor(options: SessionHostPtyTransportFactoryOptions);
+    spawn(command: string, args: string[], spawnOptions: PtySpawnOptions): PtyRuntimeTransport;
+}
+
 /**
  * ADHDev Launcher — Extension Installer
  *
@@ -2347,4 +2467,4 @@ declare function startDaemonDevSupport(options: DaemonDevSupportOptions): Promis
  */
 declare function shutdownDaemonComponents(components: DaemonComponents): Promise<void>;
 
-export { AcpProviderInstance, AcpProviderState, AgentStreamPoller, type AgentStreamPollerDeps, AvailableProviderInfo, CdpDomHandlers, type CdpInitializerConfig, type CdpScannerOptions, type CdpSetupContext, CdpTargetFilter, type CliAdapter, CliProviderInstance, type CommandContext, type CommandResult$1 as CommandResult, type CommandRouterDeps, type CommandRouterResult, CommandResult$2 as CoreCommandResult, DAEMON_WS_PATH, DEFAULT_DAEMON_PORT, DaemonAgentStreamManager, DaemonCdpInitializer, DaemonCdpManager, DaemonCdpScanner, DaemonCliManager, DaemonCommandHandler, DaemonCommandRouter, type DaemonComponents, type DaemonCoreOptions, type DaemonDevSupportOptions, DaemonEvent, type DaemonInitConfig, DaemonStatusReporter, DevServer, type HostMemorySnapshot, type IDEInfo, type IDaemonCore, IdeProviderInstance, type ExtensionInfo as InstallerExtensionInfo, LOG, type LogEntry, type LogLevel, ProviderCliAdapter, ProviderInstanceManager, ProviderLoader, ProviderModule, type ProviderVersionInfo, type ScopedLogger, SessionEntry, SessionTransport, type SetupIdeInstanceOptions, StatusReportPayload, StatusResponse, type StatusSnapshot, type StatusSnapshotOptions, VersionArchive, type VersionHistory, buildSessionEntries, buildStatusSnapshot, connectCdpManager, detectAllVersions, detectCLIs, detectIDEs, findCdpManager, forwardAgentStreamsToIdeInstance, getAIExtensions, getAvailableIdeIds, getHostMemorySnapshot, getLogLevel, getRecentCommands, getRecentLogs, hasCdpManager, initDaemonComponents, installExtensions, installGlobalInterceptor, isCdpConnected, isExtensionInstalled, isIdeRunning, killIdeProcess, launchIDE, launchWithCdp, logCommand, probeCdpPort, readChatHistory, registerExtensionProviders, setLogLevel, setupIdeInstance, shutdownDaemonComponents, startDaemonDevSupport };
+export { AcpProviderInstance, AcpProviderState, AgentStreamPoller, type AgentStreamPollerDeps, AvailableProviderInfo, CdpDomHandlers, type CdpInitializerConfig, type CdpScannerOptions, type CdpSetupContext, CdpTargetFilter, type CliAdapter, CliProviderInstance, type CliTransportFactoryParams, type CommandContext, type CommandResult$1 as CommandResult, type CommandRouterDeps, type CommandRouterResult, CommandResult$2 as CoreCommandResult, DAEMON_WS_PATH, DEFAULT_DAEMON_PORT, DaemonAgentStreamManager, DaemonCdpInitializer, DaemonCdpManager, DaemonCdpScanner, DaemonCliManager, DaemonCommandHandler, DaemonCommandRouter, type DaemonComponents, type DaemonCoreOptions, type DaemonDevSupportOptions, DaemonEvent, type DaemonInitConfig, DaemonStatusReporter, DevServer, type HostMemorySnapshot, type HostedCliRuntimeDescriptor, type IDEInfo, type IDaemonCore, IdeProviderInstance, type ExtensionInfo as InstallerExtensionInfo, LOG, type LogEntry, type LogLevel, NodePtyTransportFactory, ProviderCliAdapter, ProviderInstanceManager, ProviderLoader, ProviderModule, ProviderResumeCapability, type ProviderVersionInfo, type PtyRuntimeTransport, type PtySpawnOptions, type PtyTransportFactory, type ScopedLogger, SessionEntry, SessionHostPtyTransportFactory, SessionTransport, type SetupIdeInstanceOptions, StatusReportPayload, StatusResponse, type StatusSnapshot, type StatusSnapshotOptions, VersionArchive, type VersionHistory, buildSessionEntries, buildStatusSnapshot, connectCdpManager, detectAllVersions, detectCLIs, detectIDEs, findCdpManager, forwardAgentStreamsToIdeInstance, getAIExtensions, getAvailableIdeIds, getHostMemorySnapshot, getLogLevel, getRecentCommands, getRecentLogs, hasCdpManager, initDaemonComponents, installExtensions, installGlobalInterceptor, isCdpConnected, isExtensionInstalled, isIdeRunning, killIdeProcess, launchIDE, launchWithCdp, logCommand, probeCdpPort, readChatHistory, registerExtensionProviders, setLogLevel, setupIdeInstance, shutdownDaemonComponents, startDaemonDevSupport };