@adhdev/daemon-core 0.5.8 → 0.5.17

package/dist/index.d.ts

@@ -1,3 +1,384 @@
+/**
+ * ProviderInstance — Provider runtime lifecycle
+ *
+ * provider.js = static config/scripts
+ * ProviderInstance = runtime status management + lifecycle
+ *
+ * Daemon only collects via ProviderInstance.getState(),
+ * Each Instance manages its own status.
+ */
+
+type ProviderStatus = 'idle' | 'generating' | 'waiting_approval' | 'error' | 'stopped' | 'starting';
+interface ActiveChatData {
+    id: string;
+    title: string;
+    status: string;
+    messages: ChatMessage[];
+    activeModal: {
+        message: string;
+        buttons: string[];
+    } | null;
+    inputContent?: string;
+}
+/** Standardized error reasons across all provider categories */
+type ProviderErrorReason = 'not_installed' | 'auth_failed' | 'spawn_error' | 'init_failed' | 'crash' | 'timeout' | 'cdp_error' | 'disconnected';
+/** Common fields shared by all provider categories */
+interface ProviderStateBase {
+    /** Provider type (e.g. 'gemini-cli', 'cursor', 'cline') */
+    type: string;
+    /** Provider Display name */
+    name: string;
+    /** current status */
+    status: ProviderStatus;
+    /** chat data */
+    activeChat: ActiveChatData | null;
+    /** Workspace — project path or name (all categories) */
+    workspace?: string | null;
+    /** Runtime info (real-time detection) */
+    currentModel?: string;
+    currentPlan?: string;
+    /** Error details (when status === 'error') */
+    errorMessage?: string;
+    errorReason?: ProviderErrorReason;
+    /** meta */
+    instanceId: string;
+    lastUpdated: number;
+    settings: Record<string, any>;
+    /** Event queue (cleared after daemon collects) */
+    pendingEvents: ProviderEvent[];
+}
+/** IDE provider state */
+interface IdeProviderState extends ProviderStateBase {
+    category: 'ide';
+    cdpConnected: boolean;
+    /** IDE child Extension Instance status */
+    extensions: ProviderState[];
+    currentAutoApprove?: string;
+}
+/** CLI provider state */
+interface CliProviderState extends ProviderStateBase {
+    category: 'cli';
+    /** terminal = PTY stream, chat = parsed conversation */
+    mode: 'terminal' | 'chat';
+}
+/** ACP provider state */
+interface AcpProviderState extends ProviderStateBase {
+    category: 'acp';
+    mode: 'chat';
+    /** ACP config options (model/mode selection) */
+    acpConfigOptions?: AcpConfigOption[];
+    /** ACP available modes */
+    acpModes?: AcpMode[];
+}
+/** Extension provider state */
+interface ExtensionProviderState extends ProviderStateBase {
+    category: 'extension';
+    agentStreams?: any[];
+}
+/** Discriminated union — switch on `.category` */
+type ProviderState = IdeProviderState | CliProviderState | AcpProviderState | ExtensionProviderState;
+interface ProviderEvent {
+    event: string;
+    timestamp: number;
+    [key: string]: any;
+}
+interface InstanceContext {
+    /** CDP connection (IDE/Extension) */
+    cdp?: {
+        isConnected: boolean;
+        evaluate(script: string, timeout?: number): Promise<unknown>;
+        evaluateInWebviewFrame?(expression: string, matchFn?: (bodyPreview: string) => boolean): Promise<string | null>;
+        discoverAgentWebviews?(): Promise<any[]>;
+    };
+    /** Server log transmit */
+    serverConn?: {
+        sendMessage(type: string, data: any): void;
+    };
+    /** P2P PTY output transmit */
+    onPtyData?: (data: string) => void;
+    /** Provider configvalue (resolved) */
+    settings: Record<string, any>;
+}
+interface ProviderInstance {
+    /** Provider type */
+    readonly type: string;
+    /** Provider category */
+    readonly category: 'cli' | 'ide' | 'extension' | 'acp';
+    /** initialize */
+    init(context: InstanceContext): Promise<void>;
+    /** Tick — periodic status refresh (IDE: readChat, Extension: stream collection) */
+    onTick(): Promise<void>;
+    /** Return current status */
+    getState(): ProviderState;
+    /** Receive event (external → Instance) */
+    onEvent(event: string, data?: any): void;
+    /** Update settings at runtime (called when user changes settings from dashboard) */
+    updateSettings?(newSettings: Record<string, any>): void;
+    /** cleanup */
+    dispose(): void;
+}
+
+/**
+ * Recent workspace activity — quick "pick up where you left off" (daemon-local).
+ */
+
+interface WorkspaceActivityEntry {
+    path: string;
+    lastUsedAt: number;
+    /** `active` legacy — same meaning as default */
+    kind?: 'ide' | 'cli' | 'acp' | 'default' | 'active';
+    /** IDE id or CLI/ACP provider type */
+    agentType?: string;
+}
+declare function getWorkspaceActivity(config: ADHDevConfig, limit?: number): WorkspaceActivityEntry[];
+
+/**
+ * ADHDev Launcher — Configuration
+ *
+ * Manages launcher config, server connection tokens, and user preferences.
+ */
+
+interface ADHDevConfig {
+    serverUrl: string;
+    apiToken: string | null;
+    connectionToken: string | null;
+    selectedIde: string | null;
+    configuredIdes: string[];
+    installedExtensions: string[];
+    autoConnect: boolean;
+    notifications: boolean;
+    userEmail: string | null;
+    userName: string | null;
+    setupCompleted: boolean;
+    setupDate: string | null;
+    configuredCLIs: string[];
+    enabledIdes: string[];
+    recentCliWorkspaces: string[];
+    /** Saved workspaces for IDE/CLI/ACP launch (daemon-local) */
+    workspaces?: WorkspaceEntry[];
+    /** Default workspace id (from workspaces[]) — never used implicitly for launch */
+    defaultWorkspaceId?: string | null;
+    /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
+    recentWorkspaceActivity?: WorkspaceActivityEntry[];
+    machineNickname: string | null;
+    cliHistory: CliHistoryEntry[];
+    providerSettings: Record<string, Record<string, any>>;
+    ideSettings: Record<string, {
+        extensions?: Record<string, {
+            enabled: boolean;
+        }>;
+    }>;
+}
+interface CliHistoryEntry {
+    cliType: string;
+    dir: string;
+    cliArgs?: string[];
+    timestamp: number;
+    label?: string;
+}
+/**
+ * Load configuration from disk
+ */
+declare function loadConfig(): ADHDevConfig;
+/**
+ * Save configuration to disk
+ */
+declare function saveConfig(config: ADHDevConfig): void;
+/**
+ * Update specific config fields
+ */
+declare function updateConfig(updates: Partial<ADHDevConfig>): ADHDevConfig;
+/**
+ * Mark setup as completed
+ */
+declare function markSetupComplete(ideId: string | string[], extensions: string[]): ADHDevConfig;
+/**
+ * Check if setup has been completed before
+ */
+declare function isSetupComplete(): boolean;
+/**
+ * Reset configuration
+ */
+declare function resetConfig(): void;
+/**
+ * Add CLI launch to history (max 20, dedup by cliType+dir+args)
+ */
+declare function addCliHistory(entry: Omit<CliHistoryEntry, 'timestamp'>): void;
+
+/**
+ * Saved workspaces — shared by IDE launch, CLI, ACP (daemon-local).
+ */
+
+interface WorkspaceEntry {
+    id: string;
+    path: string;
+    label?: string;
+    addedAt: number;
+}
+declare function getWorkspaceState(config: ADHDevConfig): {
+    workspaces: WorkspaceEntry[];
+    defaultWorkspaceId: string | null;
+    defaultWorkspacePath: string | null;
+};
+
+/**
+ * ADHDev Shared Types — Cross-package type definitions
+ *
+ * Types used across daemon-core, web-core, web-cloud, server, etc.
+ * Import via: import type { ... } from '@adhdev/daemon-core/types'
+ *
+ * IMPORTANT: This file must remain runtime-free (types only).
+ * Cloudflare Workers (server) can import type-only modules safely.
+ */
+
+/** IDE entry as reported by daemon to server/dashboard */
+interface ManagedIdeEntry {
+    ideType: string;
+    ideVersion: string;
+    instanceId: string;
+    workspace: string | null;
+    terminals: number;
+    aiAgents: unknown[];
+    activeChat: ActiveChatData | null;
+    chats: unknown[];
+    agentStreams: ManagedAgentStream[];
+    cdpConnected: boolean;
+    currentModel?: string;
+    currentPlan?: string;
+    currentAutoApprove?: string;
+}
+/** CLI entry as reported by daemon to server/dashboard */
+interface ManagedCliEntry {
+    id: string;
+    instanceId: string;
+    cliType: string;
+    cliName: string;
+    status: string;
+    mode: 'terminal' | 'chat';
+    workspace: string;
+    activeChat: ActiveChatData | null;
+}
+/** ACP entry as reported by daemon to server/dashboard */
+interface ManagedAcpEntry {
+    id: string;
+    acpType: string;
+    acpName: string;
+    status: string;
+    mode: 'chat';
+    workspace: string;
+    activeChat: ActiveChatData | null;
+    currentModel?: string;
+    currentPlan?: string;
+    acpConfigOptions?: AcpConfigOption[];
+    acpModes?: AcpMode[];
+    /** Error details */
+    errorMessage?: string;
+    errorReason?: 'not_installed' | 'auth_failed' | 'spawn_error' | 'init_failed' | 'crash' | 'timeout' | 'cdp_error' | 'disconnected';
+}
+/** Agent stream within an IDE (extension status) */
+interface ManagedAgentStream {
+    agentType: string;
+    agentName: string;
+    extensionId: string;
+    status: string;
+    messages: ChatMessage[];
+    inputContent: string;
+    model?: string;
+    activeModal: {
+        message: string;
+        buttons: string[];
+    } | null;
+}
+/** Available provider information */
+interface AvailableProviderInfo {
+    type: string;
+    name: string;
+    category: 'ide' | 'extension' | 'cli' | 'acp';
+    displayName: string;
+    icon: string;
+}
+/** ACP config option (model/mode/thought_level selection) */
+interface AcpConfigOption {
+    category: 'model' | 'mode' | 'thought_level' | 'other';
+    configId: string;
+    currentValue?: string;
+    options: {
+        value: string;
+        name: string;
+        description?: string;
+        group?: string;
+    }[];
+}
+/** ACP mode */
+interface AcpMode {
+    id: string;
+    name: string;
+    description?: string;
+}
+/** Machine hardware/OS info (reported by daemon, displayed by web) */
+interface MachineInfo {
+    hostname: string;
+    platform: string;
+    arch: string;
+    cpus: number;
+    totalMem: number;
+    freeMem: number;
+    /** macOS: reclaimable-inclusive; prefer for UI used% */
+    availableMem?: number;
+    loadavg: number[];
+    uptime: number;
+    release: string;
+}
+/** Detected IDE on a machine */
+interface DetectedIdeInfo {
+    type: string;
+    id?: string;
+    name: string;
+    running: boolean;
+    path?: string;
+}
+/** Workspace recent activity */
+interface WorkspaceActivity {
+    path: string;
+    lastUsedAt: number;
+    kind?: string;
+    agentType?: string;
+}
+interface StatusReportPayload {
+    /** Daemon instance ID */
+    instanceId: string;
+    /** Daemon version */
+    version: string;
+    /** Daemon mode flag */
+    daemonMode: boolean;
+    /** Machine info */
+    machine: MachineInfo;
+    /** Machine nickname (user-set) */
+    machineNickname?: string | null;
+    /** Timestamp */
+    timestamp: number;
+    /** Detected IDEs on this machine */
+    detectedIdes: DetectedIdeInfo[];
+    /** P2P state */
+    p2p?: {
+        available: boolean;
+        state: string;
+        peers: number;
+        screenshotActive?: boolean;
+    };
+    /** Managed IDE instances */
+    managedIdes: ManagedIdeEntry[];
+    /** Managed CLI instances */
+    managedClis: ManagedCliEntry[];
+    /** Managed ACP instances */
+    managedAcps: ManagedAcpEntry[];
+    /** Saved workspaces */
+    workspaces?: WorkspaceEntry[];
+    defaultWorkspaceId?: string | null;
+    defaultWorkspacePath?: string | null;
+    workspaceActivity?: WorkspaceActivity[];
+}
+
 /**
  * ContentBlock — ACP ContentBlock union type
  * Represents displayable content in messages, tool call results, etc.
@@ -44,12 +425,12 @@ interface ResourceBlock {
 interface TextResourceContents {
     uri: string;
     text: string;
-    mimeType?: string;
+    mimeType?: string | null;
 }
 interface BlobResourceContents {
     uri: string;
     blob: string;
-    mimeType?: string;
+    mimeType?: string | null;
 }
 interface ContentAnnotations {
     audience?: ('user' | 'assistant')[];
@@ -83,7 +464,7 @@ type ToolCallContent = {
 };
 interface ToolCallLocation {
     path: string;
-    line?: number;
+    line?: number | null;
 }
 type ProviderCategory = 'cli' | 'ide' | 'extension' | 'acp';
 /**
@@ -312,77 +693,20 @@ interface ProviderSettingSchema extends ProviderSettingDef {
  * Shared types referenced by daemon-core, daemon-standalone, daemon-cloud, web-core.
  * When modifying this file, also update interface contracts in AGENT_PROTOCOL.md.
  */
-interface DaemonStatus {
-    id: string;
-    type: string;
-    platform?: string;
-    hostname?: string;
-    nickname?: string;
-    cdpConnected?: boolean;
-    timestamp: number;
-    ides: IdeEntry[];
-    clis: CliEntry[];
-    acps?: AcpEntry[];
-}
-interface IdeEntry {
-    /** Format: "{daemonId}:ide:{instanceId}" */
-    id: string;
-    instanceId: string;
-    /** IDE type: "cursor", "windsurf", "vscode", etc. */
-    type: string;
-    name?: string;
-    cdpConnected?: boolean;
-    cdpPort?: number;
-    /** Current chat messages (live) */
-    chats?: ChatMessage[];
-    /** Active chat session */
-    activeChat?: Record<string, unknown> | null;
-    /** Chat history (legacy) */
-    chatHistory?: unknown[];
-    /** Agent status: 'idle' | 'working' */
-    agentStatus?: string;
-    /** Agent streams from extensions */
-    agentStreams?: AgentStreamEntry[];
-    /** Extension agents monitored via CDP */
-    extensions?: ExtensionInfo$1[];
-    /** IDE-reported workspace roots (name + path) */
-    workspaceFolders?: {
-        name: string;
-        path: string;
-    }[];
-    /** Active file path */
-    activeFile?: string | null;
-    /** Current AI model */
-    currentModel?: string;
-    /** Current AI mode/plan */
-    currentPlan?: string;
-    /** Managed agents list */
-    agents?: unknown[];
-}
-interface CliEntry {
-    /** Format: "{daemonId}:cli:{cliId}" */
-    id: string;
-    cliId: string;
-    /** CLI type: "gemini-cli", "claude-code", "codex-cli", etc. */
-    type: string;
-    name?: string;
-    /** Whether the CLI process is running */
-    isRunning?: boolean;
-    /** Active session info */
-    sessionId?: string;
-}
-interface AcpEntry {
-    /** Format: "{daemonId}:acp:{acpId}" */
+
+/** Full status response from /api/v1/status and WS events */
+interface StatusResponse extends StatusReportPayload {
+    /** For standalone API compat */
     id: string;
-    acpId: string;
-    /** Agent type: "gemini-acp", "cline-acp", etc. */
     type: string;
-    name?: string;
-    /** Process running state */
-    isRunning?: boolean;
-    /** Error state */
-    errorReason?: string;
-    errorMessage?: string;
+    platform: string;
+    hostname: string;
+    /** User display name from config */
+    userName?: string;
+    /** Available providers */
+    availableProviders: ProviderInfo[];
+    /** System info (legacy compat) */
+    system?: SystemInfo;
 }
 interface ChatMessage {
     role: string;
@@ -390,9 +714,21 @@ interface ChatMessage {
     content: string | ContentBlock[];
     kind?: string;
     id?: string;
+    index?: number;
     timestamp?: number;
+    receivedAt?: number;
     /** Tool calls associated with this message */
     toolCalls?: ToolCallInfo[];
+    /** Optional: fiber metadata */
+    _type?: string;
+    _sub?: string;
+    /** Meta information for thought/terminal logs etc */
+    meta?: {
+        label?: string;
+        isRunning?: boolean;
+    } | Record<string, any>;
+    /** Sender name for shared sessions */
+    senderName?: string;
 }
 
 interface ExtensionInfo$1 {
@@ -421,7 +757,7 @@ interface ProviderConfig {
 }
 type DaemonEvent = {
     type: 'status';
-    data: DaemonStatus;
+    data: StatusResponse;
 } | {
     type: 'chat_update';
     data: {
@@ -470,48 +806,6 @@ interface ProviderInfo {
     displayName: string;
     category: string;
 }
-/** Full status response from /api/v1/status */
-interface StatusResponse {
-    id: string;
-    type: string;
-    platform: string;
-    hostname: string;
-    timestamp: number;
-    ides: IdeEntry[];
-    clis: CliEntry[];
-    cdpConnected: boolean;
-    detectedIdes: DetectedIde[];
-    availableProviders: ProviderInfo[];
-    system: SystemInfo;
-    /** Saved workspaces (standalone WS / HTTP status) */
-    workspaces?: {
-        id: string;
-        path: string;
-        label?: string;
-        addedAt: number;
-    }[];
-    defaultWorkspaceId?: string | null;
-    defaultWorkspacePath?: string | null;
-    workspaceActivity?: {
-        path: string;
-        lastUsedAt: number;
-        kind?: string;
-        agentType?: string;
-    }[];
-}
-/** Agent stream entry within an IDE */
-interface AgentStreamEntry {
-    agentType: string;
-    agentName: string;
-    extensionId: string;
-    status: string;
-    messages: unknown[];
-    inputContent: string;
-    activeModal: {
-        message: string;
-        buttons: string[];
-    } | null;
-}
 /** Flattened agent entry from /api/v1/agents */
 interface AgentEntry {
     ideId: string;
@@ -546,123 +840,20 @@ interface IDaemonCore {
     /** Gracefully stop the daemon */
     stop(): Promise<void>;
     /** Get current daemon status snapshot */
-    getStatus(): DaemonStatus;
+    getStatus(): StatusResponse;
     /** Subscribe to status changes. Returns unsubscribe function. */
-    onStatusChange(callback: (status: DaemonStatus) => void): () => void;
+    onStatusChange(callback: (status: StatusResponse) => void): () => void;
     /** Subscribe to all daemon events. Returns unsubscribe function. */
     onEvent(callback: (event: DaemonEvent) => void): () => void;
     /** Execute a command (send_chat, new_session, etc.) */
     executeCommand(type: string, payload: any, target?: string): Promise<CommandResult$2>;
     /** Get currently detected/managed IDEs */
-    getManagedIdes(): IdeEntry[];
+    getManagedIdes(): ManagedIdeEntry[];
     /** Get currently detected/managed CLIs */
-    getManagedClis(): CliEntry[];
+    getManagedClis(): ManagedCliEntry[];
     /** Get currently detected/managed ACP agents */
-    getManagedAcps(): AcpEntry[];
-}
-
-/**
- * Saved workspaces — shared by IDE launch, CLI, ACP (daemon-local).
- */
-
-interface WorkspaceEntry {
-    id: string;
-    path: string;
-    label?: string;
-    addedAt: number;
-}
-declare function getWorkspaceState(config: ADHDevConfig): {
-    workspaces: WorkspaceEntry[];
-    defaultWorkspaceId: string | null;
-    defaultWorkspacePath: string | null;
-};
-
-/**
- * Recent workspace activity — quick "pick up where you left off" (daemon-local).
- */
-
-interface WorkspaceActivityEntry {
-    path: string;
-    lastUsedAt: number;
-    /** `active` legacy — same meaning as default */
-    kind?: 'ide' | 'cli' | 'acp' | 'default' | 'active';
-    /** IDE id or CLI/ACP provider type */
-    agentType?: string;
-}
-declare function getWorkspaceActivity(config: ADHDevConfig, limit?: number): WorkspaceActivityEntry[];
-
-/**
- * ADHDev Launcher — Configuration
- *
- * Manages launcher config, server connection tokens, and user preferences.
- */
-
-interface ADHDevConfig {
-    serverUrl: string;
-    apiToken: string | null;
-    connectionToken: string | null;
-    selectedIde: string | null;
-    configuredIdes: string[];
-    installedExtensions: string[];
-    autoConnect: boolean;
-    notifications: boolean;
-    userEmail: string | null;
-    userName: string | null;
-    setupCompleted: boolean;
-    setupDate: string | null;
-    configuredCLIs: string[];
-    enabledIdes: string[];
-    recentCliWorkspaces: string[];
-    /** Saved workspaces for IDE/CLI/ACP launch (daemon-local) */
-    workspaces?: WorkspaceEntry[];
-    /** Default workspace id (from workspaces[]) — never used implicitly for launch */
-    defaultWorkspaceId?: string | null;
-    /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
-    recentWorkspaceActivity?: WorkspaceActivityEntry[];
-    machineNickname: string | null;
-    cliHistory: CliHistoryEntry[];
-    providerSettings: Record<string, Record<string, any>>;
-    ideSettings: Record<string, {
-        extensions?: Record<string, {
-            enabled: boolean;
-        }>;
-    }>;
+    getManagedAcps(): ManagedAcpEntry[];
 }
-interface CliHistoryEntry {
-    cliType: string;
-    dir: string;
-    cliArgs?: string[];
-    timestamp: number;
-    label?: string;
-}
-/**
- * Load configuration from disk
- */
-declare function loadConfig(): ADHDevConfig;
-/**
- * Save configuration to disk
- */
-declare function saveConfig(config: ADHDevConfig): void;
-/**
- * Update specific config fields
- */
-declare function updateConfig(updates: Partial<ADHDevConfig>): ADHDevConfig;
-/**
- * Mark setup as completed
- */
-declare function markSetupComplete(ideId: string | string[], extensions: string[]): ADHDevConfig;
-/**
- * Check if setup has been completed before
- */
-declare function isSetupComplete(): boolean;
-/**
- * Reset configuration
- */
-declare function resetConfig(): void;
-/**
- * Add CLI launch to history (max 20, dedup by cliType+dir+args)
- */
-declare function addCliHistory(entry: Omit<CliHistoryEntry, 'timestamp'>): void;
 
 /**
  * ADHDev — IDE Detector (canonical implementation)
@@ -1148,106 +1339,6 @@ declare class DaemonCdpManager {
     }): Promise<Buffer | null>;
 }
 
-/**
- * ProviderInstance — Provider runtime lifecycle
- *
- * provider.js = static config/scripts
- * ProviderInstance = runtime status management + lifecycle
- *
- * Daemon only collects via ProviderInstance.getState(),
- * Each Instance manages its own status.
- */
-interface ProviderState {
-    /** Provider type (e.g. 'gemini-cli', 'cursor', 'cline') */
-    type: string;
-    /** Provider Display name */
-    name: string;
-    /** category */
-    category: 'cli' | 'ide' | 'extension' | 'acp';
-    /** current status */
-    status: 'idle' | 'generating' | 'waiting_approval' | 'error' | 'stopped' | 'starting';
-    /** CLI mode: terminal = PTY stream, chat = parsed conversation */
-    mode?: 'terminal' | 'chat';
-    /** chat data */
-    activeChat: {
-        id: string;
-        title: string;
-        status: string;
-        messages: {
-            role: string;
-            content: string;
-            timestamp?: number;
-        }[];
-        activeModal: {
-            message: string;
-            buttons: string[];
-        } | null;
-        inputContent?: string;
-    } | null;
-    /** IDE/Extension -only */
-    workspaceFolders?: {
-        name: string;
-        path: string;
-    }[];
-    activeFile?: string | null;
-    agentStreams?: any[];
-    cdpConnected?: boolean;
-    /** IDE child Extension Instance status */
-    extensions?: ProviderState[];
-    /** CLI -only */
-    workingDir?: string;
-    /** Runtime info (real-time detection from IDE/CLI) */
-    currentModel?: string;
-    currentPlan?: string;
-    currentAutoApprove?: string;
-    /** meta */
-    instanceId: string;
-    lastUpdated: number;
-    settings: Record<string, any>;
-    /** Event queue (cleared after daemon collects) */
-    pendingEvents: ProviderEvent[];
-}
-interface ProviderEvent {
-    event: string;
-    timestamp: number;
-    [key: string]: any;
-}
-interface InstanceContext {
-    /** CDP connection (IDE/Extension) */
-    cdp?: {
-        isConnected: boolean;
-        evaluate(script: string, timeout?: number): Promise<unknown>;
-        evaluateInWebviewFrame?(expression: string, matchFn?: (bodyPreview: string) => boolean): Promise<string | null>;
-        discoverAgentWebviews?(): Promise<any[]>;
-    };
-    /** Server log transmit */
-    serverConn?: {
-        sendMessage(type: string, data: any): void;
-    };
-    /** P2P PTY output transmit */
-    onPtyData?: (data: string) => void;
-    /** Provider configvalue (resolved) */
-    settings: Record<string, any>;
-}
-interface ProviderInstance {
-    /** Provider type */
-    readonly type: string;
-    /** Provider category */
-    readonly category: 'cli' | 'ide' | 'extension' | 'acp';
-    /** initialize */
-    init(context: InstanceContext): Promise<void>;
-    /** Tick — periodic status refresh (IDE: readChat, Extension: stream collection) */
-    onTick(): Promise<void>;
-    /** Return current status */
-    getState(): ProviderState;
-    /** Receive event (external → Instance) */
-    onEvent(event: string, data?: any): void;
-    /** Update settings at runtime (called when user changes settings from dashboard) */
-    updateSettings?(newSettings: Record<string, any>): void;
-    /** cleanup */
-    dispose(): void;
-}
-
 /**
  * ProviderInstanceManager — lifecycle management for all ProviderInstances
  *
@@ -1722,8 +1813,7 @@ declare class IdeProviderInstance implements ProviderInstance {
     private historyWriter;
     private ideVersion;
     private instanceId;
-    private workspaceFolders;
-    private activeFile;
+    private workspace;
     private extensions;
     constructor(provider: ProviderModule, instanceKey?: string);
     init(context: InstanceContext): Promise<void>;
@@ -1743,6 +1833,8 @@ declare class IdeProviderInstance implements ProviderInstance {
     getInstanceId(): string;
     /** all Extension Instance list */
     getExtensionInstances(): ExtensionProviderInstance[];
+    /** Set workspace from daemon launch context */
+    setWorkspace(workspace: string): void;
     private readChat;
     private getReadChatScript;
     private detectAgentTransitions;
@@ -2050,7 +2142,7 @@ declare class DaemonCommandRouter {
      */
     private executeDaemonCommand;
     /**
-     * IDE stop: CDP disconnect + remove from InstanceManager + clean instanceIdMap
+     * IDE stop: CDP disconnect + InstanceManager cleanup + optionally kill OS process
      */
     private stopIde;
 }
@@ -2061,6 +2153,7 @@ declare class DaemonCommandRouter {
  * Collect status from ProviderInstanceManager → assemble payload → transmit
  * Each Instance manages its own status/transition. This module only assembles + transmits.
  */
+
 interface StatusReporterDeps {
     serverConn: {
         isConnected(): boolean;
@@ -2091,9 +2184,10 @@ interface StatusReporterDeps {
     }>;
     detectedIdes: any[];
     ideType: string;
+    daemonVersion?: string;
     instanceManager: {
-        collectAllStates(): any[];
-        collectStatesByCategory(cat: string): any[];
+        collectAllStates(): ProviderState[];
+        collectStatesByCategory(cat: string): ProviderState[];
     };
 }
 declare class DaemonStatusReporter {
@@ -2248,6 +2342,10 @@ declare function getRecentCommands(count?: number): CommandLogEntry[];
  * adhdev launch cursor — Launch Cursor with CDP port
  * adhdev launch --workspace /path — Open specific workspace
  */
+/** Kill IDE process (graceful → force) */
+declare function killIdeProcess(ideId: string): Promise<boolean>;
+/** Check if IDE process is running */
+declare function isIdeRunning(ideId: string): boolean;
 interface LaunchOptions {
     ideId?: string;
     workspace?: string;
@@ -2370,7 +2468,10 @@ declare class ProviderCliAdapter implements CliAdapter {
     private approvalTransitionBuffer;
     private approvalExitTimeout;
     private resizeSuppressUntil;
+    private statusHistory;
+    private setStatus;
     private readonly timeouts;
+    private readonly approvalKeys;
     constructor(provider: CliProviderModule, workingDir: string, extraArgs?: string[]);
     setServerConn(serverConn: any): void;
     setOnStatusChange(callback: () => void): void;
@@ -2394,6 +2495,11 @@ declare class ProviderCliAdapter implements CliAdapter {
     */
     resolveModal(buttonIndex: number): void;
     resize(cols: number, rows: number): void;
+    /**
+    * Full debug state — exposes all internal buffers, status, and patterns for debugging.
+    * Used by DevServer /api/cli/debug endpoint.
+    */
+    getDebugState(): Record<string, any>;
 }
 
 /**
@@ -2416,6 +2522,8 @@ declare class CliProviderInstance implements ProviderInstance {
     private generatingStartedAt;
     private settings;
     private monitor;
+    private generatingDebounceTimer;
+    private generatingDebouncePending;
     private historyWriter;
     readonly instanceId: string;
     constructor(provider: ProviderModule, workingDir: string, cliArgs?: string[], instanceId?: string);
@@ -2491,7 +2599,7 @@ declare class AcpProviderInstance implements ProviderInstance {
     constructor(provider: ProviderModule, workingDir: string, cliArgs?: string[]);
     init(context: InstanceContext): Promise<void>;
     onTick(): Promise<void>;
-    getState(): ProviderState;
+    getState(): AcpProviderState;
     onEvent(event: string, data?: any): void;
     private parseConfigOptions;
     private parseModes;
@@ -2552,6 +2660,8 @@ declare class DevServer {
     private server;
     private providerLoader;
     private cdpManagers;
+    private instanceManager;
+    private cliManager;
     private logFn;
     private sseClients;
     private watchScriptPath;
@@ -2560,9 +2670,12 @@ declare class DevServer {
     private autoImplProcess;
     private autoImplSSEClients;
     private autoImplStatus;
+    private cliSSEClients;
     constructor(options: {
         providerLoader: ProviderLoader;
         cdpManagers: Map<string, DaemonCdpManager>;
+        instanceManager?: ProviderInstanceManager;
+        cliManager?: DaemonCliManager;
         logFn?: (msg: string) => void;
     });
     private log;
@@ -2621,6 +2734,23 @@ declare class DevServer {
     private getAnyCdp;
     private json;
     private readBody;
+    /** GET /api/cli/status — list all running CLI/ACP instances with state */
+    private handleCliStatus;
+    /** 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 } */
+    private handleCliSend;
+    /** POST /api/cli/stop — stop a running CLI { type } */
+    private handleCliStop;
+    /** GET /api/cli/events — SSE stream of CLI status events */
+    private handleCliSSE;
+    private sendCliSSE;
+    /** 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 } */
+    private handleCliResolve;
+    /** POST /api/cli/raw — send raw keystrokes to PTY { type, keys } */
+    private handleCliRaw;
 }
 
 /**
@@ -2745,4 +2875,4 @@ declare function initDaemonComponents(config: DaemonInitConfig): Promise<DaemonC
  */
 declare function shutdownDaemonComponents(components: DaemonComponents): Promise<void>;
 
-export { type AcpEntry, AcpProviderInstance, type AgentEntry, type AgentStreamEntry, AgentStreamPoller, type AgentStreamPollerDeps, CdpDomHandlers, type CdpInitializerConfig, type CdpScannerOptions, type CdpSetupContext, type CdpTargetFilter, type ChatMessage, type CliAdapter, type CliEntry, CliProviderInstance, type CommandContext, type CommandResult$1 as CommandResult, type CommandRouterDeps, type CommandRouterResult, type CommandResult$2 as CoreCommandResult, DAEMON_WS_PATH, DEFAULT_DAEMON_PORT, DaemonAgentStreamManager, DaemonCdpInitializer, DaemonCdpManager, DaemonCdpScanner, DaemonCliManager, DaemonCommandHandler, DaemonCommandRouter, type DaemonComponents, type DaemonCoreOptions, type DaemonEvent, type DaemonInitConfig, type DaemonStatus, DaemonStatusReporter, type DetectedIde, DevServer, type ExtensionInfo$1 as ExtensionInfo, type HostMemorySnapshot, type IDEInfo, type IDaemonCore, type IdeEntry, IdeProviderInstance, type ExtensionInfo as InstallerExtensionInfo, LOG, type LogEntry, type LogLevel, ProviderCliAdapter, type ProviderConfig, type ProviderInfo, ProviderInstanceManager, ProviderLoader, type ProviderModule, type ProviderVersionInfo, type ScopedLogger, type SetupIdeInstanceOptions, type StatusResponse, type SystemInfo, VersionArchive, type VersionHistory, type WorkspaceEntry, addCliHistory, connectCdpManager, detectAllVersions, detectCLIs, detectIDEs, getAIExtensions, getAvailableIdeIds, getHostMemorySnapshot, getLogLevel, getRecentCommands, getRecentLogs, getWorkspaceActivity, getWorkspaceState, initDaemonComponents, installExtensions, installGlobalInterceptor, isExtensionInstalled, isSetupComplete, launchIDE, launchWithCdp, loadConfig, logCommand, markSetupComplete, probeCdpPort, readChatHistory, registerExtensionProviders, resetConfig, saveConfig, setLogLevel, setupIdeInstance, shutdownDaemonComponents, updateConfig };
+export { type AcpConfigOption, type AcpMode, AcpProviderInstance, type AcpProviderState, type ActiveChatData, type AgentEntry, AgentStreamPoller, type AgentStreamPollerDeps, type AvailableProviderInfo, CdpDomHandlers, type CdpInitializerConfig, type CdpScannerOptions, type CdpSetupContext, type CdpTargetFilter, type ChatMessage, type CliAdapter, CliProviderInstance, type CliProviderState, type CommandContext, type CommandResult$1 as CommandResult, type CommandRouterDeps, type CommandRouterResult, type CommandResult$2 as CoreCommandResult, DAEMON_WS_PATH, DEFAULT_DAEMON_PORT, DaemonAgentStreamManager, DaemonCdpInitializer, DaemonCdpManager, DaemonCdpScanner, DaemonCliManager, DaemonCommandHandler, DaemonCommandRouter, type DaemonComponents, type DaemonCoreOptions, type DaemonEvent, type DaemonInitConfig, DaemonStatusReporter, type DetectedIde, type DetectedIdeInfo, DevServer, type ExtensionInfo$1 as ExtensionInfo, type ExtensionProviderState, type HostMemorySnapshot, type IDEInfo, type IDaemonCore, IdeProviderInstance, type IdeProviderState, type ExtensionInfo as InstallerExtensionInfo, LOG, type LogEntry, type LogLevel, type MachineInfo, type ManagedAcpEntry, type ManagedAgentStream, type ManagedCliEntry, type ManagedIdeEntry, ProviderCliAdapter, type ProviderConfig, type ProviderErrorReason, type ProviderInfo, ProviderInstanceManager, ProviderLoader, type ProviderModule, type ProviderStatus, type ProviderVersionInfo, type ScopedLogger, type SetupIdeInstanceOptions, type StatusReportPayload, type StatusResponse, type SystemInfo, VersionArchive, type VersionHistory, type WorkspaceActivity, type WorkspaceEntry, addCliHistory, connectCdpManager, detectAllVersions, detectCLIs, detectIDEs, getAIExtensions, getAvailableIdeIds, getHostMemorySnapshot, getLogLevel, getRecentCommands, getRecentLogs, getWorkspaceActivity, getWorkspaceState, initDaemonComponents, installExtensions, installGlobalInterceptor, isExtensionInstalled, isIdeRunning, isSetupComplete, killIdeProcess, launchIDE, launchWithCdp, loadConfig, logCommand, markSetupComplete, probeCdpPort, readChatHistory, registerExtensionProviders, resetConfig, saveConfig, setLogLevel, setupIdeInstance, shutdownDaemonComponents, updateConfig };