@adhdev/daemon-core 0.8.34 → 0.8.36

package/dist/status/normalize.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/status/normalize.ts"],"sourcesContent":["import type { ActiveChatData } from '../providers/provider-instance.js';\n\nexport type ManagedStatus =\n    | 'idle'\n    | 'generating'\n    | 'waiting_approval'\n    | 'error'\n    | 'stopped'\n    | 'starting'\n    | 'panel_hidden'\n    | 'not_monitored'\n    | 'disconnected';\n\nconst WORKING_STATUSES = new Set([\n    'generating',\n    'streaming',\n    'loading',\n    'loading_reference',\n    'thinking',\n    'active',\n]);\n\n// Status snapshots are sent over P2P every 5s, so keep only a recent live window here.\n// Older history is fetched on demand via `chat_history`, and CLI terminals stream via runtime events.\nconst STATUS_ACTIVE_CHAT_MESSAGE_LIMIT = 60;\nconst STATUS_ACTIVE_CHAT_TOTAL_BYTES_LIMIT = 96 * 1024;\nconst STATUS_ACTIVE_CHAT_STRING_LIMIT = 4 * 1024;\nconst STATUS_ACTIVE_CHAT_FALLBACK_STRING_LIMIT = 1024;\nconst STATUS_INPUT_CONTENT_LIMIT = 2 * 1024;\nconst STATUS_MODAL_MESSAGE_LIMIT = 2 * 1024;\nconst STATUS_MODAL_BUTTON_LIMIT = 120;\n\nfunction truncateString(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(0, Math.max(0, maxChars));\n    return `${value.slice(0, maxChars - 12)}...[truncated]`;\n}\n\nfunction truncateStringTail(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(value.length - Math.max(0, maxChars));\n    return `...[truncated]${value.slice(value.length - (maxChars - 12))}`;\n}\n\nfunction trimStructuredStrings(value: unknown, maxChars: number): unknown {\n    if (typeof value === 'string') return truncateString(value, maxChars);\n    if (Array.isArray(value)) return value.map((item) => trimStructuredStrings(item, maxChars));\n    if (!value || typeof value !== 'object') return value;\n    return Object.fromEntries(\n        Object.entries(value).map(([key, nested]) => [key, trimStructuredStrings(nested, maxChars)]),\n    );\n}\n\nfunction estimateBytes(value: unknown): number {\n    try {\n        return JSON.stringify(value).length;\n    } catch {\n        return String(value ?? '').length;\n    }\n}\n\nfunction trimMessageForStatus(message: unknown, stringLimit: number): unknown {\n    if (!message || typeof message !== 'object') return message;\n    return trimStructuredStrings(message, stringLimit);\n}\n\n/**\n * Collapse timestamp / createdAt into receivedAt so downstream consumers\n * only ever need to read a single canonical time field.\n */\nfunction normalizeMessageTime(message: unknown): unknown {\n    if (!message || typeof message !== 'object') return message;\n    const msg = message as Record<string, unknown>;\n    if (msg.receivedAt == null) {\n        const fallback = msg.timestamp ?? msg.createdAt;\n        if (fallback != null) {\n            const ts = typeof fallback === 'string' ? Date.parse(fallback as string) : Number(fallback);\n            if (Number.isFinite(ts) && ts > 0) msg.receivedAt = ts;\n        }\n    }\n    return msg;\n}\n\nfunction trimMessagesForStatus(messages: unknown[] | null | undefined): unknown[] {\n    if (!Array.isArray(messages) || messages.length === 0) return [];\n\n    const recent = messages.slice(-STATUS_ACTIVE_CHAT_MESSAGE_LIMIT);\n    const kept: unknown[] = [];\n    let totalBytes = 0;\n\n    for (let i = recent.length - 1; i >= 0; i -= 1) {\n        let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], STATUS_ACTIVE_CHAT_STRING_LIMIT));\n        let size = estimateBytes(normalized);\n\n        if (size > STATUS_ACTIVE_CHAT_TOTAL_BYTES_LIMIT) {\n            normalized = normalizeMessageTime(trimMessageForStatus(recent[i], STATUS_ACTIVE_CHAT_FALLBACK_STRING_LIMIT));\n            size = estimateBytes(normalized);\n        }\n\n        if (kept.length > 0 && (totalBytes + size) > STATUS_ACTIVE_CHAT_TOTAL_BYTES_LIMIT) {\n            continue;\n        }\n\n        kept.push(normalized);\n        totalBytes += size;\n    }\n\n    return kept.reverse();\n}\n\nfunction hasApprovalButtons(activeModal?: { buttons?: unknown[] | null } | null): boolean {\n    return (activeModal?.buttons?.length ?? 0) > 0;\n}\n\nexport function normalizeManagedStatus(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): ManagedStatus {\n    if (hasApprovalButtons(opts?.activeModal)) return 'waiting_approval';\n\n    const normalized = String(status || 'idle').trim().toLowerCase();\n    if (normalized === 'waiting_approval') return 'waiting_approval';\n    if (WORKING_STATUSES.has(normalized)) return 'generating';\n    if (normalized === 'error') return 'error';\n    if (normalized === 'stopped') return 'stopped';\n    if (normalized === 'starting') return 'starting';\n    if (normalized === 'panel_hidden') return 'panel_hidden';\n    if (normalized === 'not_monitored') return 'not_monitored';\n    if (normalized === 'disconnected') return 'disconnected';\n    return 'idle';\n}\n\nexport function isManagedStatusWorking(status?: string | null): boolean {\n    return normalizeManagedStatus(status) === 'generating';\n}\n\nexport function isManagedStatusWaiting(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): boolean {\n    return normalizeManagedStatus(status, opts) === 'waiting_approval';\n}\n\nexport function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(\n    activeChat: T,\n): T {\n    if (!activeChat) return activeChat;\n    return {\n        ...activeChat,\n        status: normalizeManagedStatus(activeChat.status, { activeModal: activeChat.activeModal }),\n        messages: trimMessagesForStatus(activeChat.messages) as T extends { messages: infer M } ? M : never,\n        activeModal: activeChat.activeModal ? {\n            message: truncateString(activeChat.activeModal.message || '', STATUS_MODAL_MESSAGE_LIMIT),\n            buttons: (activeChat.activeModal.buttons || []).map((button) =>\n                truncateString(String(button || ''), STATUS_MODAL_BUTTON_LIMIT)\n            ),\n        } : activeChat.activeModal,\n        inputContent: activeChat.inputContent\n            ? truncateString(activeChat.inputContent, STATUS_INPUT_CONTENT_LIMIT)\n            : activeChat.inputContent,\n    } as T;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/status/normalize.ts"],"sourcesContent":["import type { ActiveChatData } from '../providers/provider-instance.js';\n\nexport type ManagedStatus =\n    | 'idle'\n    | 'generating'\n    | 'waiting_approval'\n    | 'error'\n    | 'stopped'\n    | 'starting'\n    | 'panel_hidden'\n    | 'not_monitored'\n    | 'disconnected';\n\nconst WORKING_STATUSES = new Set([\n    'generating',\n    'streaming',\n    'loading',\n    'loading_reference',\n    'thinking',\n    'active',\n]);\n\nexport interface NormalizeActiveChatOptions {\n    includeMessages?: boolean;\n    includeInputContent?: boolean;\n    includeActiveModal?: boolean;\n    messageLimit?: number;\n    totalBytesLimit?: number;\n    stringLimit?: number;\n    fallbackStringLimit?: number;\n}\n\n// Full snapshots are still capped, but can carry recent chat context for API/inspection use.\nconst FULL_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: true,\n    includeInputContent: true,\n    includeActiveModal: true,\n    messageLimit: 60,\n    totalBytesLimit: 96 * 1024,\n    stringLimit: 4 * 1024,\n    fallbackStringLimit: 1024,\n};\n\n// Live/metadata snapshots only need routing + UI summary. Current chat text is loaded\n// on demand via `read_chat`, and older history via `chat_history`.\nexport const LIVE_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: false,\n    includeInputContent: false,\n    includeActiveModal: false,\n    messageLimit: 0,\n    totalBytesLimit: 0,\n    stringLimit: 512,\n    fallbackStringLimit: 256,\n};\n\nconst STATUS_MODAL_MESSAGE_LIMIT = 2 * 1024;\nconst STATUS_MODAL_BUTTON_LIMIT = 120;\n\nfunction truncateString(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(0, Math.max(0, maxChars));\n    return `${value.slice(0, maxChars - 12)}...[truncated]`;\n}\n\nfunction truncateStringTail(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(value.length - Math.max(0, maxChars));\n    return `...[truncated]${value.slice(value.length - (maxChars - 12))}`;\n}\n\nfunction trimStructuredStrings(value: unknown, maxChars: number): unknown {\n    if (typeof value === 'string') return truncateString(value, maxChars);\n    if (Array.isArray(value)) return value.map((item) => trimStructuredStrings(item, maxChars));\n    if (!value || typeof value !== 'object') return value;\n    return Object.fromEntries(\n        Object.entries(value).map(([key, nested]) => [key, trimStructuredStrings(nested, maxChars)]),\n    );\n}\n\nfunction estimateBytes(value: unknown): number {\n    try {\n        return JSON.stringify(value).length;\n    } catch {\n        return String(value ?? '').length;\n    }\n}\n\nfunction trimMessageForStatus(message: unknown, stringLimit: number): unknown {\n    if (!message || typeof message !== 'object') return message;\n    return trimStructuredStrings(message, stringLimit);\n}\n\n/**\n * Collapse timestamp / createdAt into receivedAt so downstream consumers\n * only ever need to read a single canonical time field.\n */\nfunction normalizeMessageTime(message: unknown): unknown {\n    if (!message || typeof message !== 'object') return message;\n    const msg = message as Record<string, unknown>;\n    if (msg.receivedAt == null) {\n        const fallback = msg.timestamp ?? msg.createdAt;\n        if (fallback != null) {\n            const ts = typeof fallback === 'string' ? Date.parse(fallback as string) : Number(fallback);\n            if (Number.isFinite(ts) && ts > 0) msg.receivedAt = ts;\n        }\n    }\n    return msg;\n}\n\nfunction trimMessagesForStatus(\n    messages: unknown[] | null | undefined,\n    options: Required<NormalizeActiveChatOptions>,\n): unknown[] {\n    if (!options.includeMessages || options.messageLimit <= 0 || options.totalBytesLimit <= 0) return [];\n    if (!Array.isArray(messages) || messages.length === 0) return [];\n\n    const recent = messages.slice(-options.messageLimit);\n    const kept: unknown[] = [];\n    let totalBytes = 0;\n\n    for (let i = recent.length - 1; i >= 0; i -= 1) {\n        let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.stringLimit));\n        let size = estimateBytes(normalized);\n\n        if (size > options.totalBytesLimit) {\n            normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.fallbackStringLimit));\n            size = estimateBytes(normalized);\n        }\n\n        if (kept.length > 0 && (totalBytes + size) > options.totalBytesLimit) {\n            continue;\n        }\n\n        kept.push(normalized);\n        totalBytes += size;\n    }\n\n    return kept.reverse();\n}\n\nfunction hasApprovalButtons(activeModal?: { buttons?: unknown[] | null } | null): boolean {\n    return (activeModal?.buttons?.length ?? 0) > 0;\n}\n\nexport function normalizeManagedStatus(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): ManagedStatus {\n    if (hasApprovalButtons(opts?.activeModal)) return 'waiting_approval';\n\n    const normalized = String(status || 'idle').trim().toLowerCase();\n    if (normalized === 'waiting_approval') return 'waiting_approval';\n    if (WORKING_STATUSES.has(normalized)) return 'generating';\n    if (normalized === 'error') return 'error';\n    if (normalized === 'stopped') return 'stopped';\n    if (normalized === 'starting') return 'starting';\n    if (normalized === 'panel_hidden') return 'panel_hidden';\n    if (normalized === 'not_monitored') return 'not_monitored';\n    if (normalized === 'disconnected') return 'disconnected';\n    return 'idle';\n}\n\nexport function isManagedStatusWorking(status?: string | null): boolean {\n    return normalizeManagedStatus(status) === 'generating';\n}\n\nexport function isManagedStatusWaiting(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): boolean {\n    return normalizeManagedStatus(status, opts) === 'waiting_approval';\n}\n\nexport function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(\n    activeChat: T,\n    options: NormalizeActiveChatOptions = FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n): T {\n    if (!activeChat) return activeChat;\n    const resolvedOptions: Required<NormalizeActiveChatOptions> = {\n        ...FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n        ...options,\n    };\n    return {\n        ...activeChat,\n        status: normalizeManagedStatus(activeChat.status, { activeModal: activeChat.activeModal }),\n        messages: trimMessagesForStatus(activeChat.messages, resolvedOptions) as T extends { messages: infer M } ? M : never,\n        activeModal: resolvedOptions.includeActiveModal && activeChat.activeModal ? {\n            message: truncateString(activeChat.activeModal.message || '', STATUS_MODAL_MESSAGE_LIMIT),\n            buttons: (activeChat.activeModal.buttons || []).map((button) =>\n                truncateString(String(button || ''), STATUS_MODAL_BUTTON_LIMIT)\n            ),\n        } : null,\n        inputContent: resolvedOptions.includeInputContent && activeChat.inputContent\n            ? truncateString(activeChat.inputContent, 2 * 1024)\n            : undefined,\n    } as T;\n}\n"],"mappings":"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","names":[]}

package/dist/status/reporter.d.ts

@@ -5,6 +5,7 @@
  * Each Instance manages its own status/transition. This module only assembles + transmits.
  */
 import type { DaemonCdpManager } from '../cdp/manager.js';
+import type { DaemonStatusEventPayload } from '../shared-types.js';
 import type { ProviderState } from '../providers/provider-instance.js';
 export interface StatusReporterDeps {
     serverConn: {
@@ -20,6 +21,7 @@ export interface StatusReporterDeps {
         connectedPeerCount: number;
         screenshotActive: boolean;
         sendStatus(data: any): void;
+        sendStatusEvent(event: DaemonStatusEventPayload): void;
     } | null;
     providerLoader: {
         resolve(type: string): any;
@@ -44,6 +46,7 @@ export declare class DaemonStatusReporter {
     private lastStatusSentAt;
     private statusPendingThrottle;
     private lastP2PStatusHash;
+    private lastServerStatusHash;
     private lastStatusSummary;
     private statusTimer;
     private p2pTimer;
@@ -54,6 +57,8 @@ export declare class DaemonStatusReporter {
     stopReporting(): void;
     onStatusChange(): void;
     throttledReport(): void;
+    private toDaemonStatusEventName;
+    private buildServerStatusEvent;
     emitStatusEvent(event: Record<string, unknown>): void;
     removeAgentTracking(_key: string): void;
     updateAgentStreams(_ideType: string, _streams: any[]): void;
@@ -63,6 +68,8 @@ export declare class DaemonStatusReporter {
     private summarizeLargePayloadSessions;
     sendUnifiedStatusReport(opts?: {
         p2pOnly?: boolean;
+        forceServer?: boolean;
+        reason?: string;
     }): Promise<void>;
     private sendP2PPayload;
     private simpleHash;

package/dist/status/snapshot.d.ts

@@ -6,8 +6,9 @@
  * - daemon-standalone HTTP/WS status responses
  */
 import type { DaemonCdpManager } from '../cdp/manager.js';
+import { type SessionEntryProfile } from './builders.js';
 import type { ProviderState } from '../providers/provider-instance.js';
-import type { AvailableProviderInfo, StatusReportPayload } from '../shared-types.js';
+import type { MachineInfo, StatusReportPayload } from '../shared-types.js';
 export interface StatusSnapshotOptions {
     allStates: ProviderState[];
     cdpManagers: Map<string, DaemonCdpManager>;
@@ -36,14 +37,13 @@ export interface StatusSnapshotOptions {
     }>;
     instanceId: string;
     version: string;
-    daemonMode: boolean;
     timestamp?: number;
     p2p?: StatusReportPayload['p2p'];
     machineNickname?: string | null;
+    profile?: SessionEntryProfile;
 }
-export interface StatusSnapshot extends StatusReportPayload {
-    availableProviders: AvailableProviderInfo[];
-}
+export type StatusSnapshot = StatusReportPayload;
+export declare function buildMachineInfo(profile?: 'full' | 'live' | 'metadata'): MachineInfo;
 export declare function getSessionCompletionMarker(session: {
     activeChat?: {
         messages?: Array<{

package/dist/types.d.ts

@@ -15,7 +15,7 @@ export interface StatusResponse extends StatusReportPayload {
     /** User display name from config */
     userName?: string;
     /** Available providers */
-    availableProviders: AvailableProviderInfo[];
+    availableProviders?: AvailableProviderInfo[];
     /** System info (legacy compat) */
     system?: SystemInfo;
 }

package/node_modules/@adhdev/session-host-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/session-host-core",
-  "version": "0.8.34",
+  "version": "0.8.36",
   "description": "ADHDev local session host core — session registry, protocol, buffers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.8.34",
+  "version": "0.8.36",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/agent-stream/forward.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared helper for forwarding agent stream snapshots into the IDE instance.
+ *
+ * Both cloud and standalone daemons use the same InstanceManager wiring.
+ */
+export declare function forwardAgentStreamsToIdeInstance(instanceManager: {
+    getInstance: (key: string) => any;
+}, ideType: string, streams: any[]): void;

package/src/agent-stream/index.d.ts

@@ -0,0 +1,6 @@
+export { DaemonAgentStreamManager } from './manager.js';
+export type { ManagedAgent } from './manager.js';
+export { ProviderStreamAdapter } from './provider-adapter.js';
+export * from './types.js';
+export { AgentStreamPoller } from './poller.js';
+export type { AgentStreamPollerDeps } from './poller.js';

package/src/agent-stream/manager.d.ts

@@ -0,0 +1,60 @@
+/**
+ * DaemonAgentStreamManager — manage agent streams (ported for Daemon)
+ *
+ * Agent stream manager for extension data collection.
+ * All vscode dependencies removed — pure Node.js environment.
+ *
+ * Panel focus is delegated to Extension via IPC.
+ * CDP session management uses DaemonCdpManager directly.
+ */
+import { DaemonCdpManager, AgentWebviewTarget } from '../cdp/manager.js';
+import { ProviderLoader } from '../providers/provider-loader.js';
+import { SessionRegistry } from '../sessions/registry.js';
+import type { IAgentStreamAdapter, AgentStreamState, AgentChatListItem } from './types.js';
+export interface ManagedAgent {
+    adapter: IAgentStreamAdapter;
+    runtimeSessionId: string;
+    parentSessionId: string;
+    cdpSessionId: string;
+    target: AgentWebviewTarget;
+    lastState: AgentStreamState | null;
+    lastError: string | null;
+    lastHiddenCheckTime: number;
+}
+export declare class DaemonAgentStreamManager {
+    private readonly sessionRegistry?;
+    private adaptersByType;
+    private managedBySessionId;
+    private enabled;
+    private logFn;
+    private lastDiscoveryTimeByParent;
+    private discoveryIntervalMsByParent;
+    private activeSessionIdByParent;
+    constructor(logFn?: (msg: string) => void, providerLoader?: ProviderLoader, sessionRegistry?: SessionRegistry);
+    setEnabled(enabled: boolean): void;
+    get isEnabled(): boolean;
+    getActiveSessionId(parentSessionId: string): string | null;
+    private isRecoverableSessionError;
+    private getSessionTarget;
+    resetParentSession(parentSessionId: string): void;
+    /** Panel focus based on provider.js focusPanel or extensionId (currently no-op) */
+    ensureSessionPanelOpen(_sessionId: string): Promise<void>;
+    setActiveSession(cdp: DaemonCdpManager, parentSessionId: string, sessionId: string | null): Promise<void>;
+    private resolveSessionIdForTarget;
+    private getStateError;
+    private connectManagedSession;
+    /** Agent webview discovery + session connection */
+    syncActiveSession(cdp: DaemonCdpManager, parentSessionId: string): Promise<void>;
+    /** Collect active extension session state */
+    collectActiveSession(cdp: DaemonCdpManager, parentSessionId: string): Promise<AgentStreamState | null>;
+    sendToSession(cdp: DaemonCdpManager, sessionId: string, text: string): Promise<boolean>;
+    resolveSessionAction(cdp: DaemonCdpManager, sessionId: string, action: 'approve' | 'reject', button?: string): Promise<boolean>;
+    newSession(cdp: DaemonCdpManager, sessionId: string): Promise<boolean>;
+    listSessionChats(cdp: DaemonCdpManager, sessionId: string): Promise<AgentChatListItem[]>;
+    switchConversation(cdp: DaemonCdpManager, sessionId: string, conversationId: string): Promise<boolean>;
+    focusSession(cdp: DaemonCdpManager, sessionId: string): Promise<boolean>;
+    getConnectedSessions(parentSessionId?: string): string[];
+    getManagedSession(sessionId: string): ManagedAgent | undefined;
+    dispose(cdpManagers: Map<string, DaemonCdpManager>): Promise<void>;
+    resolveSessionForAgent(parentSessionId: string, agentType: string): string | null;
+}

package/src/agent-stream/poller.d.ts

@@ -0,0 +1,41 @@
+/**
+ * AgentStreamPoller — Periodic agent stream polling + extension dynamic management
+ *
+ * Handles periodic agent stream polling and extension dynamic management.
+ *
+ * Responsibilities:
+ *   1. Refresh extension providers in CDP managers (config changes take effect immediately)
+ *   2. Dynamically add/remove IDE instance extensions based on enabled state
+ *   3. Sync agent sessions + collect agent streams
+ *   4. Auto-discover agents in connected IDEs
+ */
+import type { DaemonCdpManager } from '../cdp/manager.js';
+import type { DaemonAgentStreamManager } from './manager.js';
+import type { ProviderLoader } from '../providers/provider-loader.js';
+import type { ProviderInstanceManager } from '../providers/provider-instance-manager.js';
+import type { SessionRegistry } from '../sessions/registry.js';
+import type { AgentStreamState } from './types.js';
+export interface AgentStreamPollerDeps {
+    agentStreamManager: DaemonAgentStreamManager;
+    providerLoader: ProviderLoader;
+    instanceManager: ProviderInstanceManager;
+    cdpManagers: Map<string, DaemonCdpManager>;
+    sessionRegistry: SessionRegistry;
+    /** Callback when agent streams are updated */
+    onStreamsUpdated?: (ideType: string, streams: AgentStreamState[]) => void;
+}
+export declare class AgentStreamPoller {
+    private deps;
+    private timer;
+    constructor(deps: AgentStreamPollerDeps);
+    /** Currently active IDE type for agent streaming */
+    get activeIde(): string | null;
+    /** Reset active IDE tracking (e.g., when IDE is stopped) */
+    resetActiveIde(parentSessionId: string): void;
+    /** Start polling (idempotent — ignored if already started) */
+    start(intervalMs?: number): void;
+    /** Stop polling */
+    stop(): void;
+    /** Single poll tick — can also be called manually */
+    private tick;
+}

package/src/agent-stream/provider-adapter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ProviderStreamAdapter — generic Extension adapter based on provider.js
+ *
+ * Consolidates ClineAdapter, RooCodeAdapter, ContinueAdapter.
+ * Auto-configured using provider.js scripts + metadata.
+ */
+import type { IAgentStreamAdapter, AgentStreamState, AgentChatListItem, AgentEvaluateFn } from './types.js';
+import type { ProviderModule } from '../providers/contracts.js';
+export declare class ProviderStreamAdapter implements IAgentStreamAdapter {
+    readonly agentType: string;
+    readonly agentName: string;
+    readonly extensionId: string;
+    readonly extensionIdPattern: RegExp;
+    private provider;
+    private lastSuccessState;
+    constructor(provider: ProviderModule);
+    private callScript;
+    private hasScript;
+    private getStateTitle;
+    private parseMaybeJson;
+    private summarizeRaw;
+    private isTransportError;
+    private titlesMatch;
+    private messageCount;
+    private lastMessageSignature;
+    private verifySendOutcome;
+    private readStableBaselineState;
+    readChat(evaluate: AgentEvaluateFn): Promise<AgentStreamState>;
+    sendMessage(evaluate: AgentEvaluateFn, text: string): Promise<void>;
+    resolveAction(evaluate: AgentEvaluateFn, action: string, button?: string): Promise<boolean>;
+    newSession(evaluate: AgentEvaluateFn): Promise<void>;
+    listChats(evaluate: AgentEvaluateFn): Promise<AgentChatListItem[]>;
+    switchSession(evaluate: AgentEvaluateFn, sessionId: string): Promise<boolean>;
+    focusEditor(evaluate: AgentEvaluateFn): Promise<void>;
+    private errorState;
+}

package/src/agent-stream/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Agent Stream Types — ported for Daemon (identical to original)
+ *
+ * Agent stream types.
+ * No vscode dependency — can be used as-is.
+ */
+import type { ProviderEffect } from '../providers/contracts.js';
+/** Agent chat message */
+export interface AgentChatMessage {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp?: number;
+}
+/** Agent chat history item */
+export interface AgentChatListItem {
+    title: string;
+    id: string;
+    status?: string;
+    time?: string;
+    cost?: string;
+}
+/** Agent stream status */
+export interface AgentStreamState {
+    agentType: string;
+    agentName: string;
+    extensionId: string;
+    status: 'idle' | 'streaming' | 'waiting_approval' | 'error' | 'disconnected' | 'panel_hidden' | 'not_monitored';
+    messages: AgentChatMessage[];
+    inputContent: string;
+    title?: string;
+    /** @deprecated Use controlValues['model'] — kept for backward compatibility */
+    model?: string;
+    /** @deprecated Use controlValues['mode'] — kept for backward compatibility */
+    mode?: string;
+    activeModal?: {
+        message: string;
+        buttons: string[];
+    };
+    error?: string;
+    _error?: string;
+    /** Dynamic control current values (populated from readChat + provider controls schema) */
+    controlValues?: Record<string, string | number | boolean>;
+    /** Provider-driven UI effects from readChat */
+    effects?: ProviderEffect[];
+}
+/** Agent webview target info */
+export interface AgentWebviewTarget {
+    targetId: string;
+    extensionId: string;
+    agentType: string;
+    url: string;
+}
+/** Agent stream adapter interface */
+export interface IAgentStreamAdapter {
+    readonly agentType: string;
+    readonly agentName: string;
+    readonly extensionId: string;
+    readonly extensionIdPattern: RegExp;
+    readChat(evaluate: AgentEvaluateFn): Promise<AgentStreamState>;
+    sendMessage(evaluate: AgentEvaluateFn, text: string): Promise<void>;
+    resolveAction(evaluate: AgentEvaluateFn, action: string, button?: string): Promise<boolean>;
+    newSession(evaluate: AgentEvaluateFn): Promise<void>;
+    listChats?(evaluate: AgentEvaluateFn): Promise<AgentChatListItem[]>;
+    switchSession?(evaluate: AgentEvaluateFn, sessionId: string): Promise<boolean>;
+    focusEditor?(evaluate: AgentEvaluateFn): Promise<void>;
+    setProvider?(provider: any): void;
+}
+export type AgentEvaluateFn = (expression: string, timeoutMs?: number) => Promise<unknown>;

package/src/boot/daemon-lifecycle.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Daemon Lifecycle — Shared init + shutdown logic
+ *
+ * initDaemonComponents(): Creates all core daemon components in correct order.
+ * shutdownDaemonComponents(): Graceful shutdown of all components.
+ *
+ * Transport-specific setup (ServerConnection, P2P, HTTP/WS) remains in each daemon.
+ */
+import { DaemonCdpManager } from '../cdp/manager.js';
+import { DaemonCdpInitializer } from '../cdp/initializer.js';
+import { DaemonCommandHandler } from '../commands/handler.js';
+import { DaemonCommandRouter } from '../commands/router.js';
+import type { SessionHostControlPlane } from '../commands/router.js';
+import { DaemonCliManager, type CliTransportFactoryParams, type HostedCliRuntimeDescriptor } from '../commands/cli-manager.js';
+import { DaemonAgentStreamManager } from '../agent-stream/manager.js';
+import { AgentStreamPoller } from '../agent-stream/poller.js';
+import { ProviderLoader } from '../providers/provider-loader.js';
+import { ProviderInstanceManager } from '../providers/provider-instance-manager.js';
+import { DevServer } from '../daemon/dev-server.js';
+import { type IDEInfo } from '../detection/ide-detector.js';
+import { SessionRegistry } from '../sessions/registry.js';
+import type { PtyTransportFactory } from '../cli-adapters/pty-transport.js';
+export interface DaemonInitConfig {
+    /** ProviderLoader log function */
+    providerLogFn?: (msg: string) => void;
+    /** CLI Manager deps (transport-specific) */
+    cliManagerDeps: {
+        getServerConn: () => any;
+        getP2p: () => any;
+        onStatusChange: () => void;
+        removeAgentTracking: (key: string) => void;
+        createPtyTransportFactory?: (params: CliTransportFactoryParams) => PtyTransportFactory | null;
+        listHostedCliRuntimes?: () => Promise<HostedCliRuntimeDescriptor[]>;
+    };
+    /** CDP config */
+    enabledIdes?: string[];
+    /** Router transport-specific callbacks */
+    onStatusChange?: () => void;
+    onPostChatCommand?: () => void;
+    sessionHostControl?: SessionHostControlPlane | null;
+    getCdpLogFn?: (ideType: string) => (msg: string) => void;
+    /** Additional callback after CDP manager created (transport-specific extras) */
+    onCdpManagerSetup?: (ideType: string, manager: DaemonCdpManager, managerKey: string) => void | Promise<void>;
+    /** Poller callback (transport-specific) */
+    onStreamsUpdated?: (ideType: string, streams: any[]) => void;
+    /** Instance ticking interval (ms), default 5000 */
+    tickIntervalMs?: number;
+    /** CDP scan interval (ms), default 30000 */
+    cdpScanIntervalMs?: number;
+}
+export interface DaemonComponents {
+    providerLoader: ProviderLoader;
+    instanceManager: ProviderInstanceManager;
+    cliManager: DaemonCliManager;
+    commandHandler: DaemonCommandHandler;
+    agentStreamManager: DaemonAgentStreamManager;
+    router: DaemonCommandRouter;
+    poller: AgentStreamPoller;
+    cdpInitializer: DaemonCdpInitializer;
+    cdpManagers: Map<string, DaemonCdpManager>;
+    sessionRegistry: SessionRegistry;
+    detectedIdes: {
+        value: IDEInfo[];
+    };
+}
+export interface DaemonDevSupportOptions {
+    components: DaemonComponents;
+    logFn?: (msg: string) => void;
+}
+/**
+ * Initialize all daemon core components.
+ *
+ * Order:
+ *   1. Global log interceptor
+ *   2. ProviderLoader
+ *   3. InstanceManager + CliManager
+ *   4. Detect IDEs
+ *   5. CdpInitializer → connectAll + periodic scan + discovery
+ *   6. CommandHandler + AgentStreamManager
+ *   7. Router + Poller
+ *   8. Start instance ticking
+ */
+export declare function initDaemonComponents(config: DaemonInitConfig): Promise<DaemonComponents>;
+/**
+ * Start shared dev-only helpers:
+ * - DevServer on port 19280
+ * - Provider hot-reload watcher
+ */
+export declare function startDaemonDevSupport(options: DaemonDevSupportOptions): Promise<DevServer>;
+/**
+ * Graceful shutdown of all daemon components.
+ *
+ * Order:
+ *   1. Stop timers (poller, cdpInitializer)
+ *   2. Dispose agent stream
+ *   3. Shutdown CLIs
+ *   4. Dispose instances
+ *   5. Disconnect CDPs
+ */
+export declare function shutdownDaemonComponents(components: DaemonComponents): Promise<void>;

package/src/boot/daemon-lifecycle.ts

@@ -68,6 +68,11 @@ export interface DaemonInitConfig {
 
     /** CDP scan interval (ms), default 30000 */
     cdpScanIntervalMs?: number;
+
+    /** Canonical status identity used by on-demand snapshot commands */
+    statusInstanceId?: string;
+    statusVersion?: string;
+    statusDaemonMode?: boolean;
 }
 
 // ─── Result ───
@@ -276,6 +281,8 @@ export async function initDaemonComponents(config: DaemonInitConfig): Promise<Da
         onStatusChange: config.onStatusChange,
         onPostChatCommand: config.onPostChatCommand,
         sessionHostControl: config.sessionHostControl,
+        statusInstanceId: config.statusInstanceId,
+        statusVersion: config.statusVersion,
         getCdpLogFn: config.getCdpLogFn || ((ideType: string) => LOG.forComponent(`CDP:${ideType}`).asLogFn()),
     });
 

package/src/cdp/devtools.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CDP DOM Analysis Tools — DOM dump, query, debug
+ *
+ * Separated from daemon-commands.ts.
+ * Tools for analyzing DOM structure when developing new IDE scripts.
+ */
+import type { DaemonCdpManager } from './manager.js';
+import type { CommandResult } from '../commands/handler.js';
+type CdpGetter = (ideType?: string) => DaemonCdpManager | null;
+/**
+ * CDP DOM analysis handler
+ *
+ * Uses getCdp from DaemonCommandHandler.
+ */
+export declare class CdpDomHandlers {
+    private getCdp;
+    constructor(getCdp: CdpGetter);
+    /**
+    * CDP DOM Dump — IDE's DOM tree retrieve
+    *
+    * args:
+    * selector?: string — CSS selector to dump specific area only (default: All)
+    * depth?: number — Dump depth limit (default: 10)
+    * attrs?: boolean — Whether to include properties (default: true)
+    * maxLength?: number — Max character count (default: 200000)
+    * format?: 'html' | 'tree' | 'summary' — Output format (default: 'html')
+    * sessionId?: string — Agent webview session ID (if provided, match webview DOM)
+    */
+    handleDomDump(args: any): Promise<CommandResult>;
+    /**
+    * CDP DOM Query — CSS Test selector
+    * Check how many elements match selector and what elements they are
+    *
+    * args:
+    * selector: string — CSS selector
+    * limit?: number — Max element count to return (default: 20)
+    * content?: boolean — Whether to include text content (default: true)
+    * sessionId?: string — agent webview session ID
+    */
+    handleDomQuery(args: any): Promise<CommandResult>;
+    /**
+    * CDP DOM Debug — IDE AI panel specialized analysis
+    * Collect all essential info at once when supporting new IDE
+    *
+    * args:
+    * ideType?: string — IDE type hint
+    * sessionId?: string — agent webview session ID
+    */
+    handleDomDebug(args: any): Promise<CommandResult>;
+}
+export {};

package/src/cdp/initializer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * DaemonCdpInitializer — Unified CDP initialization + periodic scanning
+ *
+ * Unified CDP initialization + periodic scanning.
+ *
+ * Features:
+ *   1. Initial connection: connectAll() — multi-window aware
+ *   2. Periodic scan: startPeriodicScan() — auto-detect newly opened IDEs
+ *   3. Discovery: startDiscovery() — periodic agent webview discovery
+ */
+import { DaemonCdpManager } from './manager.js';
+import type { ProviderLoader } from '../providers/provider-loader.js';
+export interface CdpInitializerConfig {
+    providerLoader: ProviderLoader;
+    cdpManagers: Map<string, DaemonCdpManager>;
+    /** Filter: only connect these IDEs (empty/undefined = all) */
+    enabledIdes?: string[];
+    /** Callback when a new CDP manager is connected */
+    onConnected?: (ideType: string, manager: DaemonCdpManager, managerKey: string) => void | Promise<void>;
+    /** Callback when a stale/disconnected CDP manager is removed */
+    onDisconnected?: (ideType: string, manager: DaemonCdpManager, managerKey: string, reason: 'ide_closed' | 'target_closed' | 'target_rekeyed') => void | Promise<void>;
+}
+export declare class DaemonCdpInitializer {
+    private config;
+    private scanTimer;
+    private discoveryTimer;
+    constructor(config: CdpInitializerConfig);
+    /**
+     * Connect to all detected IDEs.
+     * Multi-window aware: creates separate CdpManager per workbench page.
+     */
+    connectAll(detectedIdes: any[]): Promise<void>;
+    /**
+     * Connect to a single IDE port.
+     * Tries multi-window first (listAllTargets), falls back to direct connect.
+     */
+    private connectIdePort;
+    private pruneStaleManagers;
+    /**
+     * Start periodic scanning for newly opened IDEs.
+     * Idempotent — ignored if already started.
+     */
+    startPeriodicScan(intervalMs?: number): void;
+    /**
+     * Start periodic agent webview discovery.
+     */
+    startDiscovery(intervalMs?: number): void;
+    /** Stop all timers */
+    stop(): void;
+}