@adhdev/daemon-core 0.7.33 → 0.7.36

package/dist/{normalize-auJAPmKy.d.mts → normalize-DVI4Lo5I.d.mts}

@@ -469,6 +469,31 @@ interface WorkspaceActivityEntry {
 }
 declare function getWorkspaceActivity(config: ADHDevConfig, limit?: number): WorkspaceActivityEntry[];
 
+/**
+ * Unified recent activity — machine-facing "pick up where you left off".
+ *
+ * Unlike cliHistory or workspaceActivity, this is task/session oriented:
+ * - one normalized row shape for IDE / CLI / ACP
+ * - deduped by kind + providerType + workspace
+ * - optionally linked to a live sessionId when known
+ */
+
+interface RecentActivityEntry {
+    id: string;
+    kind: 'ide' | 'cli' | 'acp';
+    providerType: string;
+    providerName: string;
+    workspace?: string | null;
+    currentModel?: string;
+    sessionId?: string | null;
+    title?: string;
+    lastUsedAt: number;
+}
+declare function appendRecentActivity(config: ADHDevConfig, entry: Omit<RecentActivityEntry, 'id' | 'lastUsedAt'> & {
+    lastUsedAt?: number;
+}): ADHDevConfig;
+declare function getRecentActivity(config: ADHDevConfig, limit?: number): RecentActivityEntry[];
+
 /**
  * ADHDev Launcher — Configuration
  *
@@ -503,6 +528,8 @@ interface ADHDevConfig {
     defaultWorkspaceId?: string | null;
     /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
     recentWorkspaceActivity?: WorkspaceActivityEntry[];
+    /** Unified recent activity across IDE / CLI / ACP launch flows */
+    recentActivity?: RecentActivityEntry[];
     machineNickname: string | null;
     /**
      * Stable local machine ID (prefix: `mach_`) — generated locally on first run.
@@ -651,6 +678,8 @@ interface SessionEntry {
     currentAutoApprove?: string;
     acpConfigOptions?: AcpConfigOption[];
     acpModes?: AcpMode[];
+    controlValues?: Record<string, string | number | boolean>;
+    providerControls?: ProviderControlSchema[];
     errorMessage?: string;
     errorReason?: ProviderErrorReason;
 }
@@ -680,6 +709,26 @@ interface AcpMode {
     name: string;
     description?: string;
 }
+/** Provider control schema (daemon → frontend) */
+interface ProviderControlSchema {
+    id: string;
+    type: 'select' | 'toggle' | 'cycle' | 'slider' | 'action';
+    label: string;
+    icon?: string;
+    placement: 'bar' | 'header' | 'menu';
+    options?: { value: string; label: string; description?: string; group?: string }[];
+    dynamic?: boolean;
+    listScript?: string;
+    setScript?: string;
+    readFrom?: string;
+    defaultValue?: string | number | boolean;
+    invokeScript?: string;
+    resultDisplay?: 'toast' | 'inline' | 'none';
+    min?: number;
+    max?: number;
+    step?: number;
+    order?: number;
+}
 /** Machine hardware/OS info (reported by daemon, displayed by web) */
 interface MachineInfo {
     hostname: string;
@@ -709,6 +758,18 @@ interface WorkspaceActivity {
     kind?: string;
     agentType?: string;
 }
+interface RecentSessionEntry {
+    id: string;
+    sessionId?: string | null;
+    providerType: string;
+    providerName: string;
+    kind: 'ide' | 'cli' | 'acp';
+    title: string;
+    workspace?: string | null;
+    currentModel?: string;
+    status?: SessionEntry['status'];
+    lastUsedAt: number;
+}
 interface StatusReportPayload {
     /** Daemon instance ID */
     instanceId: string;
@@ -738,6 +799,7 @@ interface StatusReportPayload {
     defaultWorkspaceId?: string | null;
     defaultWorkspacePath?: string | null;
     workspaceActivity?: WorkspaceActivity[];
+    recentSessions?: RecentSessionEntry[];
 }
 
 /**
@@ -882,4 +944,4 @@ declare function isManagedStatusWaiting(status?: string | null, opts?: {
 }): boolean;
 declare function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(activeChat: T): T;
 
-export { saveConfig as $, type AvailableProviderInfo as A, type ProviderInfo as B, type CommandResult as C, type DaemonEvent as D, type ExtensionInfo as E, type ProviderStatus as F, type SessionCapability as G, type SessionKind as H, type InstanceContext as I, type SystemInfo as J, type WorkspaceEntry as K, addCliHistory as L, type MachineInfo as M, getWorkspaceActivity as N, getWorkspaceState as O, type ProviderCategory as P, isManagedStatusWaiting as Q, type ResolvedProvider as R, type StatusResponse as S, isManagedStatusWorking as T, isSetupComplete as U, loadConfig as V, type WorkspaceActivity as W, markSetupComplete as X, normalizeActiveChatData as Y, normalizeManagedStatus as Z, resetConfig as _, type SessionEntry as a, updateConfig as a0, type ProviderModule as b, type ProviderSettingSchema as c, type CdpTargetFilter as d, type ProviderInstance as e, type ProviderState as f, type ProviderEvent as g, type SessionTransport as h, type StatusReportPayload as i, type ProviderResumeCapability as j, type AcpProviderState as k, type ContentBlock as l, type AcpConfigOption as m, type AcpMode as n, type ActiveChatData as o, type AgentEntry as p, type AgentSessionStream as q, type ChatMessage as r, type CliProviderState as s, type DetectedIde as t, type DetectedIdeInfo as u, type ExtensionProviderState as v, type IdeProviderState as w, type ManagedStatus as x, type ProviderConfig as y, type ProviderErrorReason as z };
+export { markSetupComplete as $, type AvailableProviderInfo as A, type ProviderErrorReason as B, type CommandResult as C, type DaemonEvent as D, type ExtensionInfo as E, type ProviderInfo as F, type ProviderStatus as G, type RecentActivityEntry as H, type InstanceContext as I, type SessionCapability as J, type SessionKind as K, type SystemInfo as L, type MachineInfo as M, type WorkspaceEntry as N, addCliHistory as O, type ProviderCategory as P, appendRecentActivity as Q, type ResolvedProvider as R, type StatusResponse as S, getRecentActivity as T, getWorkspaceActivity as U, getWorkspaceState as V, type WorkspaceActivity as W, isManagedStatusWaiting as X, isManagedStatusWorking as Y, isSetupComplete as Z, loadConfig as _, type SessionEntry as a, normalizeActiveChatData as a0, normalizeManagedStatus as a1, resetConfig as a2, saveConfig as a3, updateConfig as a4, type ProviderModule as b, type ProviderSettingSchema as c, type CdpTargetFilter as d, type ProviderInstance as e, type ProviderState as f, type ProviderEvent as g, type SessionTransport as h, type StatusReportPayload as i, type ProviderResumeCapability as j, type AcpProviderState as k, type ContentBlock as l, type AcpConfigOption as m, type AcpMode as n, type ActiveChatData as o, type AgentEntry as p, type AgentSessionStream as q, type ChatMessage as r, type CliProviderState as s, type DetectedIde as t, type DetectedIdeInfo as u, type ExtensionProviderState as v, type IdeProviderState as w, type ManagedStatus as x, type ProviderConfig as y, type ProviderControlSchema as z };

package/dist/{normalize-auJAPmKy.d.ts → normalize-DVI4Lo5I.d.ts}

@@ -469,6 +469,31 @@ interface WorkspaceActivityEntry {
 }
 declare function getWorkspaceActivity(config: ADHDevConfig, limit?: number): WorkspaceActivityEntry[];
 
+/**
+ * Unified recent activity — machine-facing "pick up where you left off".
+ *
+ * Unlike cliHistory or workspaceActivity, this is task/session oriented:
+ * - one normalized row shape for IDE / CLI / ACP
+ * - deduped by kind + providerType + workspace
+ * - optionally linked to a live sessionId when known
+ */
+
+interface RecentActivityEntry {
+    id: string;
+    kind: 'ide' | 'cli' | 'acp';
+    providerType: string;
+    providerName: string;
+    workspace?: string | null;
+    currentModel?: string;
+    sessionId?: string | null;
+    title?: string;
+    lastUsedAt: number;
+}
+declare function appendRecentActivity(config: ADHDevConfig, entry: Omit<RecentActivityEntry, 'id' | 'lastUsedAt'> & {
+    lastUsedAt?: number;
+}): ADHDevConfig;
+declare function getRecentActivity(config: ADHDevConfig, limit?: number): RecentActivityEntry[];
+
 /**
  * ADHDev Launcher — Configuration
  *
@@ -503,6 +528,8 @@ interface ADHDevConfig {
     defaultWorkspaceId?: string | null;
     /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
     recentWorkspaceActivity?: WorkspaceActivityEntry[];
+    /** Unified recent activity across IDE / CLI / ACP launch flows */
+    recentActivity?: RecentActivityEntry[];
     machineNickname: string | null;
     /**
      * Stable local machine ID (prefix: `mach_`) — generated locally on first run.
@@ -651,6 +678,8 @@ interface SessionEntry {
     currentAutoApprove?: string;
     acpConfigOptions?: AcpConfigOption[];
     acpModes?: AcpMode[];
+    controlValues?: Record<string, string | number | boolean>;
+    providerControls?: ProviderControlSchema[];
     errorMessage?: string;
     errorReason?: ProviderErrorReason;
 }
@@ -680,6 +709,26 @@ interface AcpMode {
     name: string;
     description?: string;
 }
+/** Provider control schema (daemon → frontend) */
+interface ProviderControlSchema {
+    id: string;
+    type: 'select' | 'toggle' | 'cycle' | 'slider' | 'action';
+    label: string;
+    icon?: string;
+    placement: 'bar' | 'header' | 'menu';
+    options?: { value: string; label: string; description?: string; group?: string }[];
+    dynamic?: boolean;
+    listScript?: string;
+    setScript?: string;
+    readFrom?: string;
+    defaultValue?: string | number | boolean;
+    invokeScript?: string;
+    resultDisplay?: 'toast' | 'inline' | 'none';
+    min?: number;
+    max?: number;
+    step?: number;
+    order?: number;
+}
 /** Machine hardware/OS info (reported by daemon, displayed by web) */
 interface MachineInfo {
     hostname: string;
@@ -709,6 +758,18 @@ interface WorkspaceActivity {
     kind?: string;
     agentType?: string;
 }
+interface RecentSessionEntry {
+    id: string;
+    sessionId?: string | null;
+    providerType: string;
+    providerName: string;
+    kind: 'ide' | 'cli' | 'acp';
+    title: string;
+    workspace?: string | null;
+    currentModel?: string;
+    status?: SessionEntry['status'];
+    lastUsedAt: number;
+}
 interface StatusReportPayload {
     /** Daemon instance ID */
     instanceId: string;
@@ -738,6 +799,7 @@ interface StatusReportPayload {
     defaultWorkspaceId?: string | null;
     defaultWorkspacePath?: string | null;
     workspaceActivity?: WorkspaceActivity[];
+    recentSessions?: RecentSessionEntry[];
 }
 
 /**
@@ -882,4 +944,4 @@ declare function isManagedStatusWaiting(status?: string | null, opts?: {
 }): boolean;
 declare function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(activeChat: T): T;
 
-export { saveConfig as $, type AvailableProviderInfo as A, type ProviderInfo as B, type CommandResult as C, type DaemonEvent as D, type ExtensionInfo as E, type ProviderStatus as F, type SessionCapability as G, type SessionKind as H, type InstanceContext as I, type SystemInfo as J, type WorkspaceEntry as K, addCliHistory as L, type MachineInfo as M, getWorkspaceActivity as N, getWorkspaceState as O, type ProviderCategory as P, isManagedStatusWaiting as Q, type ResolvedProvider as R, type StatusResponse as S, isManagedStatusWorking as T, isSetupComplete as U, loadConfig as V, type WorkspaceActivity as W, markSetupComplete as X, normalizeActiveChatData as Y, normalizeManagedStatus as Z, resetConfig as _, type SessionEntry as a, updateConfig as a0, type ProviderModule as b, type ProviderSettingSchema as c, type CdpTargetFilter as d, type ProviderInstance as e, type ProviderState as f, type ProviderEvent as g, type SessionTransport as h, type StatusReportPayload as i, type ProviderResumeCapability as j, type AcpProviderState as k, type ContentBlock as l, type AcpConfigOption as m, type AcpMode as n, type ActiveChatData as o, type AgentEntry as p, type AgentSessionStream as q, type ChatMessage as r, type CliProviderState as s, type DetectedIde as t, type DetectedIdeInfo as u, type ExtensionProviderState as v, type IdeProviderState as w, type ManagedStatus as x, type ProviderConfig as y, type ProviderErrorReason as z };
+export { markSetupComplete as $, type AvailableProviderInfo as A, type ProviderErrorReason as B, type CommandResult as C, type DaemonEvent as D, type ExtensionInfo as E, type ProviderInfo as F, type ProviderStatus as G, type RecentActivityEntry as H, type InstanceContext as I, type SessionCapability as J, type SessionKind as K, type SystemInfo as L, type MachineInfo as M, type WorkspaceEntry as N, addCliHistory as O, type ProviderCategory as P, appendRecentActivity as Q, type ResolvedProvider as R, type StatusResponse as S, getRecentActivity as T, getWorkspaceActivity as U, getWorkspaceState as V, type WorkspaceActivity as W, isManagedStatusWaiting as X, isManagedStatusWorking as Y, isSetupComplete as Z, loadConfig as _, type SessionEntry as a, normalizeActiveChatData as a0, normalizeManagedStatus as a1, resetConfig as a2, saveConfig as a3, updateConfig as a4, type ProviderModule as b, type ProviderSettingSchema as c, type CdpTargetFilter as d, type ProviderInstance as e, type ProviderState as f, type ProviderEvent as g, type SessionTransport as h, type StatusReportPayload as i, type ProviderResumeCapability as j, type AcpProviderState as k, type ContentBlock as l, type AcpConfigOption as m, type AcpMode as n, type ActiveChatData as o, type AgentEntry as p, type AgentSessionStream as q, type ChatMessage as r, type CliProviderState as s, type DetectedIde as t, type DetectedIdeInfo as u, type ExtensionProviderState as v, type IdeProviderState as w, type ManagedStatus as x, type ProviderConfig as y, type ProviderControlSchema as z };

package/dist/status/normalize.d.mts

@@ -1 +1 @@
-export { x as ManagedStatus, Q as isManagedStatusWaiting, T as isManagedStatusWorking, Y as normalizeActiveChatData, Z as normalizeManagedStatus } from '../normalize-auJAPmKy.mjs';
+export { x as ManagedStatus, X as isManagedStatusWaiting, Y as isManagedStatusWorking, a0 as normalizeActiveChatData, a1 as normalizeManagedStatus } from '../normalize-DVI4Lo5I.mjs';

package/dist/status/normalize.d.ts

@@ -1 +1 @@
-export { x as ManagedStatus, Q as isManagedStatusWaiting, T as isManagedStatusWorking, Y as normalizeActiveChatData, Z as normalizeManagedStatus } from '../normalize-auJAPmKy.js';
+export { x as ManagedStatus, X as isManagedStatusWaiting, Y as isManagedStatusWorking, a0 as normalizeActiveChatData, a1 as normalizeManagedStatus } from '../normalize-DVI4Lo5I.js';

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

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/session-host-core",
-  "version": "0.7.33",
+  "version": "0.7.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.7.33",
+  "version": "0.7.36",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/agent-stream/manager.ts

@@ -67,6 +67,15 @@ export class DaemonAgentStreamManager {
         return this.activeSessionIdByParent.get(parentSessionId) || null;
     }
 
+    private isRecoverableSessionError(message: string): boolean {
+        return message.includes('timeout')
+            || message.includes('not connected')
+            || message.includes('Session')
+            || message.includes('Target closed')
+            || message.includes('execution context')
+            || message.includes('context with specified id');
+    }
+
     private getSessionTarget(sessionId: string) {
         return this.sessionRegistry?.get(sessionId);
     }
@@ -186,6 +195,10 @@ export class DaemonAgentStreamManager {
                 cdp.evaluateInSessionFrame(agent.cdpSessionId, expr, timeout);
             const state = await agent.adapter.readChat(evaluate);
             LOG.debug('AgentStream', `[AgentStream] readChat(${type}) result: status=${state.status} msgs=${state.messages?.length || 0} model=${state.model || ''}${state.status === 'error' ? ' error=' + JSON.stringify((state as any).error || (state as any)._error || 'unknown') : ''}`);
+            const stateError = String((state as any).error || (state as any)._error || '');
+            if (state.status === 'error' && this.isRecoverableSessionError(stateError)) {
+                throw new Error(stateError);
+            }
             agent.lastState = state;
             agent.lastError = null;
             if (state.status === 'panel_hidden') {
@@ -196,7 +209,7 @@ export class DaemonAgentStreamManager {
             const errorMsg = (e as Error)?.message || String(e);
             this.logFn(`[AgentStream] readChat(${type}) error: ${errorMsg.slice(0, 200)}`);
             agent.lastError = errorMsg;
-            if (errorMsg.includes('timeout') || errorMsg.includes('not connected') || errorMsg.includes('Session')) {
+            if (this.isRecoverableSessionError(errorMsg)) {
                 try { await cdp.detachAgent(agent.cdpSessionId); } catch { }
                 this.managedBySessionId.delete(activeSessionId);
                 this.lastDiscoveryTimeByParent.set(parentSessionId, 0);

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

@@ -40,12 +40,33 @@ export class ProviderStreamAdapter implements IAgentStreamAdapter {
         return typeof (this.provider.scripts as any)?.[name] === 'function';
     }
 
+    private summarizeRaw(raw: unknown): string {
+        try {
+            if (typeof raw === 'string') return raw.replace(/\s+/g, ' ').trim().slice(0, 240);
+            if (raw == null) return String(raw);
+            return JSON.stringify(raw).replace(/\s+/g, ' ').trim().slice(0, 240);
+        } catch {
+            return Object.prototype.toString.call(raw);
+        }
+    }
+
+    private isTransportError(reason: string): boolean {
+        return /Session with given id not found/i.test(reason)
+            || /CDP not connected/i.test(reason)
+            || /Target closed/i.test(reason)
+            || /WebSocket not open/i.test(reason)
+            || /not connected/i.test(reason)
+            || /execution context/i.test(reason)
+            || /Cannot find context with specified id/i.test(reason);
+    }
+
     async readChat(evaluate: AgentEvaluateFn): Promise<AgentStreamState> {
         const script = this.callScript('readChat');
         if (!script) return this.errorState('readChat script not available');
 
+        let raw: unknown = null;
         try {
-            const raw = await evaluate(script) as string;
+            raw = await evaluate(script) as string;
             const data = typeof raw === 'string' ? JSON.parse(raw) : raw;
             if (data?.error) {
                 const state = this.errorState(data.error);
@@ -65,12 +86,33 @@ export class ProviderStreamAdapter implements IAgentStreamAdapter {
                 mode: data.mode,
                 activeModal: data.activeModal,
             };
+            // Build controlValues from provider controls schema
+            if (this.provider.controls?.length) {
+                const cv: Record<string, string | number | boolean> = {};
+                for (const ctrl of this.provider.controls) {
+                    if (!ctrl.readFrom) continue; // action type — no value
+                    const val = data[ctrl.readFrom];
+                    if (val !== undefined && val !== null) {
+                        cv[ctrl.id] = typeof val === 'object' ? (val.name || val.id || String(val)) : val;
+                    }
+                }
+                // Also include model/mode as fallback controls
+                if (data.model && !cv['model']) cv['model'] = data.model;
+                if (data.mode && !cv['mode']) cv['mode'] = data.mode;
+                if (Object.keys(cv).length > 0) state.controlValues = cv;
+            }
             if (state.messages.length > 0) {
                 this.lastSuccessState = state;
             }
             return state;
-        } catch {
-            const state = this.errorState(`Failed to parse ${this.agentName} state`);
+        } catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            if (this.isTransportError(reason)) {
+                throw (error instanceof Error ? error : new Error(reason));
+            }
+            const preview = this.summarizeRaw(raw);
+            const detail = preview ? ` (reason=${reason}; raw=${preview})` : ` (reason=${reason})`;
+            const state = this.errorState(`Failed to parse ${this.agentName} state${detail}`);
             if (this.lastSuccessState?.messages?.length) {
                 state.messages = this.lastSuccessState.messages;
             }

package/src/agent-stream/types.ts

@@ -29,9 +29,13 @@ export interface AgentStreamState {
     status: 'idle' | 'streaming' | 'waiting_approval' | 'error' | 'disconnected' | 'panel_hidden' | 'not_monitored';
     messages: AgentChatMessage[];
     inputContent: 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[] };
+    /** Dynamic control current values (populated from readChat + provider controls schema) */
+    controlValues?: Record<string, string | number | boolean>;
 }
 
 /** Agent webview target info */

package/src/cli-adapters/terminal-screen.ts

@@ -19,6 +19,21 @@ import { XtermTerminalBackend } from './terminal-backends/xterm-backend.js';
 const DEFAULT_SCROLLBACK = 2000;
 const loggedTerminalBackends = new Set<string>();
 
+export function getTerminalBackendRuntimeStatus(): {
+    backend: TerminalViewportBackendKind;
+    preference: TerminalViewportBackendPreference;
+    ghosttyAvailable: boolean;
+} {
+    const preference = resolveTerminalBackendPreference();
+    const ghosttyAvailable = isGhosttyVtBackendAvailable();
+    const backend: TerminalViewportBackendKind = (
+        preference === 'ghostty-vt' || (preference === 'auto' && ghosttyAvailable)
+            ? 'ghostty-vt'
+            : 'xterm'
+    );
+    return { backend, preference, ghosttyAvailable };
+}
+
 function createTerminalBackend(
     options: TerminalViewportBackendOptions,
     preference: TerminalViewportBackendPreference,

package/src/commands/cli-manager.ts

@@ -14,6 +14,7 @@ import { detectCLI } from '../detection/cli-detector.js';
 import { loadConfig, saveConfig, addCliHistory } from '../config/config.js';
 import { getWorkspaceState, resolveLaunchDirectory } from '../config/workspaces.js';
 import { appendWorkspaceActivity } from '../config/workspace-activity.js';
+import { appendRecentActivity } from '../config/recent-activity.js';
 import { CliProviderInstance } from '../providers/cli-provider-instance.js';
 import { AcpProviderInstance } from '../providers/acp-provider-instance.js';
 import type { ProviderInstanceManager } from '../providers/provider-instance-manager.js';
@@ -109,6 +110,22 @@ export class DaemonCliManager {
         }
     }
 
+    private persistRecentActivity(entry: {
+        kind: 'ide' | 'cli' | 'acp';
+        providerType: string;
+        providerName: string;
+        workspace?: string;
+        currentModel?: string;
+        sessionId?: string;
+        title?: string;
+    }): void {
+        try {
+            saveConfig(appendRecentActivity(loadConfig(), entry));
+        } catch (e) {
+            console.error(colorize('red', `  ✗ Failed to save recent activity: ${e}`));
+        }
+    }
+
     private getTransportFactory(
         runtimeId: string,
         providerType: string,
@@ -300,6 +317,15 @@ export class DaemonCliManager {
             }
 
             try { addCliHistory({ category: 'acp', cliType: normalizedType, dir: resolvedDir, workspace: resolvedDir, cliArgs, model: initialModel }); } catch (e) { LOG.warn('CLI', `ACP history save failed: ${(e as Error)?.message}`); }
+            this.persistRecentActivity({
+                kind: 'acp',
+                providerType: normalizedType,
+                providerName: provider.displayName || provider.name || normalizedType,
+                workspace: resolvedDir,
+                currentModel: initialModel,
+                sessionId,
+                title: provider.displayName || provider.name || normalizedType,
+            });
             this.deps.onStatusChange();
             return;
         }
@@ -368,6 +394,15 @@ export class DaemonCliManager {
         }
 
         try { addCliHistory({ category: 'cli', cliType, dir: resolvedDir, workspace: resolvedDir, cliArgs, model: initialModel }); } catch (e) { LOG.warn('CLI', `CLI history save failed: ${(e as Error)?.message}`); }
+        this.persistRecentActivity({
+            kind: 'cli',
+            providerType: normalizedType,
+            providerName: provider?.displayName || provider?.name || normalizedType,
+            workspace: resolvedDir,
+            currentModel: initialModel,
+            sessionId: key,
+            title: provider?.displayName || provider?.name || normalizedType,
+        });
 
         this.deps.onStatusChange();
     }

package/src/commands/router.ts

@@ -20,6 +20,7 @@ import { loadConfig, saveConfig, updateConfig } from '../config/config.js';
 import { resolveIdeLaunchWorkspace } from '../config/workspaces.js';
 import { appendWorkspaceActivity } from '../config/workspace-activity.js';
 import { addCliHistory } from '../config/config.js';
+import { appendRecentActivity, buildRecentActivityKey, markRecentSessionSeen } from '../config/recent-activity.js';
 import { detectIDEs } from '../detection/ide-detector.js';
 import { SessionRegistry } from '../sessions/registry.js';
 import { LOG } from '../logging/logger.js';
@@ -240,9 +241,26 @@ export class DaemonCommandRouter {
                 this.deps.onIdeConnected?.();
                 if (result.success && resolvedWorkspace) {
                     try {
-                        saveConfig(appendWorkspaceActivity(loadConfig(), resolvedWorkspace, {
+                        let next = appendWorkspaceActivity(loadConfig(), resolvedWorkspace, {
                             kind: 'ide',
                             agentType: result.ideId,
+                        });
+                        next = appendRecentActivity(next, {
+                            kind: 'ide',
+                            providerType: result.ideId || ideKey,
+                            providerName: result.ideId || ideKey,
+                            workspace: resolvedWorkspace,
+                            title: result.ideId || ideKey,
+                        });
+                        saveConfig(next);
+                    } catch { /* ignore activity persist errors */ }
+                } else if (result.success && (result.ideId || ideKey)) {
+                    try {
+                        saveConfig(appendRecentActivity(loadConfig(), {
+                            kind: 'ide',
+                            providerType: result.ideId || ideKey,
+                            providerName: result.ideId || ideKey,
+                            title: result.ideId || ideKey,
                         }));
                     } catch { /* ignore activity persist errors */ }
                 }
@@ -264,6 +282,31 @@ export class DaemonCommandRouter {
                 return { success: true, userName: name };
             }
 
+            case 'mark_recent_seen': {
+                const kind = args?.kind;
+                const providerType = args?.providerType;
+                if (!kind || !providerType) {
+                    return { success: false, error: 'kind and providerType are required' };
+                }
+                const recentKey = args?.recentKey || buildRecentActivityKey({
+                    kind,
+                    providerType,
+                    workspace: args?.workspace || null,
+                });
+                const next = markRecentSessionSeen(
+                    loadConfig(),
+                    recentKey,
+                    typeof args?.seenAt === 'number' ? args.seenAt : Date.now(),
+                );
+                saveConfig(next);
+                this.deps.onStatusChange?.();
+                return {
+                    success: true,
+                    recentKey,
+                    seenAt: next.recentSessionReads?.[recentKey] || Date.now(),
+                };
+            }
+
             // ─── Daemon Self-Upgrade ───
             case 'daemon_upgrade': {
                 LOG.info('Upgrade', 'Remote upgrade requested from dashboard');

package/src/commands/workspace-commands.ts

@@ -24,10 +24,11 @@ export function handleWorkspaceList(): WorkspaceCommandResult {
 export function handleWorkspaceAdd(args: any): WorkspaceCommandResult {
     const rawPath = (args?.path || args?.dir || '').trim();
     const label = (args?.label || '').trim() || undefined;
+    const createIfMissing = args?.createIfMissing === true;
     if (!rawPath) return { success: false, error: 'path required' };
 
     const config = loadConfig();
-    const result = W.addWorkspaceEntry(config, rawPath, label);
+    const result = W.addWorkspaceEntry(config, rawPath, label, { createIfMissing });
     if ('error' in result) return { success: false, error: result.error };
 
     let cfg = appendWorkspaceActivity(result.config, result.entry.path, {});

package/src/config/config.d.ts

@@ -5,8 +5,10 @@
  */
 import type { WorkspaceEntry } from './workspaces.js';
 import type { WorkspaceActivityEntry } from './workspace-activity.js';
+import type { RecentActivityEntry } from './recent-activity.js';
 export type { WorkspaceEntry } from './workspaces.js';
 export type { WorkspaceActivityEntry } from './workspace-activity.js';
+export type { RecentActivityEntry } from './recent-activity.js';
 export interface ADHDevConfig {
     serverUrl: string;
     apiToken: string | null;
@@ -35,6 +37,8 @@ export interface ADHDevConfig {
     defaultWorkspaceId?: string | null;
     /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
     recentWorkspaceActivity?: WorkspaceActivityEntry[];
+    /** Unified recent activity across IDE / CLI / ACP launch flows */
+    recentActivity?: RecentActivityEntry[];
     machineNickname: string | null;
     /**
      * Stable local machine ID (prefix: `mach_`) — generated locally on first run.

package/src/config/config.ts

@@ -11,8 +11,10 @@ import { randomUUID } from 'crypto';
 import { migrateWorkspacesFromRecent } from './workspaces.js';
 import type { WorkspaceEntry } from './workspaces.js';
 import type { WorkspaceActivityEntry } from './workspace-activity.js';
+import type { RecentActivityEntry } from './recent-activity.js';
 export type { WorkspaceEntry } from './workspaces.js';
 export type { WorkspaceActivityEntry } from './workspace-activity.js';
+export type { RecentActivityEntry } from './recent-activity.js';
 
 export interface ADHDevConfig {
  // Server connection
@@ -59,8 +61,12 @@ export interface ADHDevConfig {
  /** Default workspace id (from workspaces[]) — never used implicitly for launch */
     defaultWorkspaceId?: string | null;
 
- /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
+    /** Recently used workspaces (IDE / CLI / ACP / default) for quick resume */
     recentWorkspaceActivity?: WorkspaceActivityEntry[];
+    /** Unified recent activity across IDE / CLI / ACP launch flows */
+    recentActivity?: RecentActivityEntry[];
+    /** Last seen timestamps for machine-facing recent/session entries */
+    recentSessionReads?: Record<string, number>;
 
  // Machine nickname (user-customizable label for this machine)
     machineNickname: string | null;
@@ -138,6 +144,8 @@ const DEFAULT_CONFIG: ADHDevConfig = {
     workspaces: [],
     defaultWorkspaceId: null,
     recentWorkspaceActivity: [],
+    recentActivity: [],
+    recentSessionReads: {},
     machineNickname: null,
     machineId: undefined,
     machineSecret: null,