@adhdev/daemon-core 0.7.45 → 0.7.46

package/src/config/chat-history.ts

@@ -21,11 +21,22 @@ interface HistoryMessage {
     receivedAt: number;   // epoch ms
     role: 'user' | 'assistant' | 'system';
     content: string;
+    kind?: string;
     agent: string;        // e.g. 'antigravity', 'cursor', 'gemini-cli'
     instanceId?: string;  // IDE instance UUID (distinguishes windows of the same agent type)
+    historySessionId?: string; // Persistent provider-side conversation/session key
     sessionTitle?: string;
 }
 
+export interface SavedHistorySessionSummary {
+    historySessionId: string;
+    sessionTitle?: string;
+    messageCount: number;
+    firstMessageAt: number;
+    lastMessageAt: number;
+    preview?: string;
+}
+
 export class ChatHistoryWriter {
 /** Last seen message count per agent (deduplication) */
     private lastSeenCounts = new Map<string, number>();
@@ -43,15 +54,17 @@ export class ChatHistoryWriter {
  */
     appendNewMessages(
         agentType: string,
-        messages: Array<{ role: string; content: string; receivedAt?: number }>,
+        messages: Array<{ role: string; content: string; receivedAt?: number; kind?: string; historyDedupKey?: string }>,
         sessionTitle?: string,
         instanceId?: string,
+        historySessionId?: string,
     ): void {
         if (!messages || messages.length === 0) return;
 
         try {
- // dedup key: agentType + instanceId
-            const dedupKey = instanceId ? `${agentType}:${instanceId}` : agentType;
+ // dedup key: agentType + persistent history key (fallback: runtime instanceId)
+            const effectiveHistoryKey = historySessionId || instanceId;
+            const dedupKey = effectiveHistoryKey ? `${agentType}:${effectiveHistoryKey}` : agentType;
             let seenHashes = this.lastSeenHashes.get(dedupKey);
             if (!seenHashes) {
                 seenHashes = new Set<string>();
@@ -61,7 +74,7 @@ export class ChatHistoryWriter {
  // Filter new messages
             const newMessages: HistoryMessage[] = [];
             for (const msg of messages) {
-                const hash = `${msg.role}:${(msg.content || '').slice(0, 50)}`;
+                const hash = msg.historyDedupKey || `${msg.kind || 'standard'}:${msg.role}:${(msg.content || '').slice(0, 50)}`;
                 if (seenHashes.has(hash)) continue;
                 seenHashes.add(hash);
                 newMessages.push({
@@ -69,20 +82,22 @@ export class ChatHistoryWriter {
                     receivedAt: msg.receivedAt || Date.now(),
                     role: msg.role as 'user' | 'assistant' | 'system',
                     content: msg.content || '',
+                    kind: typeof msg.kind === 'string' ? msg.kind : undefined,
                     agent: agentType,
                     instanceId,
+                    historySessionId: effectiveHistoryKey,
                     sessionTitle,
                 });
             }
 
             if (newMessages.length === 0) return;
 
- // Append to file — separate file if instanceId exists
+ // Append to file — keyed by persistent history session when available
             const dir = path.join(HISTORY_DIR, this.sanitize(agentType));
             fs.mkdirSync(dir, { recursive: true });
 
             const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
-            const filePrefix = instanceId ? `${this.sanitize(instanceId)}_` : '';
+            const filePrefix = effectiveHistoryKey ? `${this.sanitize(effectiveHistoryKey)}_` : '';
             const filePath = path.join(dir, `${filePrefix}${date}.jsonl`);
             const lines = newMessages.map(m => JSON.stringify(m)).join('\n') + '\n';
             fs.appendFileSync(filePath, lines, 'utf-8');
@@ -92,7 +107,7 @@ export class ChatHistoryWriter {
             if (messages.length < prevCount * 0.5 && prevCount > 3) {
                 seenHashes.clear();
                 for (const msg of messages) {
-                    seenHashes.add(`${msg.role}:${(msg.content || '').slice(0, 50)}`);
+                    seenHashes.add(msg.historyDedupKey || `${msg.kind || 'standard'}:${msg.role}:${(msg.content || '').slice(0, 50)}`);
                 }
             }
             this.lastSeenCounts.set(dedupKey, messages.length);
@@ -107,6 +122,101 @@ export class ChatHistoryWriter {
         }
     }
 
+    appendSystemMarker(
+        agentType: string,
+        content: string,
+        options: {
+            sessionTitle?: string;
+            instanceId?: string;
+            historySessionId?: string;
+            dedupKey?: string;
+            receivedAt?: number;
+        } = {},
+    ): void {
+        this.appendNewMessages(
+            agentType,
+            [{
+                role: 'system',
+                kind: 'system',
+                content,
+                receivedAt: options.receivedAt,
+                historyDedupKey: options.dedupKey,
+            }],
+            options.sessionTitle,
+            options.instanceId,
+            options.historySessionId,
+        );
+    }
+
+    promoteHistorySession(
+        agentType: string,
+        previousHistorySessionId: string,
+        nextHistorySessionId: string,
+    ): void {
+        const fromId = String(previousHistorySessionId || '').trim();
+        const toId = String(nextHistorySessionId || '').trim();
+        if (!fromId || !toId || fromId === toId) return;
+
+        try {
+            const fromDedupKey = `${agentType}:${fromId}`;
+            const toDedupKey = `${agentType}:${toId}`;
+            const fromHashes = this.lastSeenHashes.get(fromDedupKey);
+            if (fromHashes?.size) {
+                const nextHashes = this.lastSeenHashes.get(toDedupKey) || new Set<string>();
+                for (const hash of fromHashes) nextHashes.add(hash);
+                this.lastSeenHashes.set(toDedupKey, nextHashes);
+                this.lastSeenHashes.delete(fromDedupKey);
+            }
+            const fromCount = this.lastSeenCounts.get(fromDedupKey);
+            if (typeof fromCount === 'number') {
+                this.lastSeenCounts.set(toDedupKey, Math.max(fromCount, this.lastSeenCounts.get(toDedupKey) || 0));
+                this.lastSeenCounts.delete(fromDedupKey);
+            }
+
+            const dir = path.join(HISTORY_DIR, this.sanitize(agentType));
+            if (!fs.existsSync(dir)) return;
+
+            const fromPrefix = `${this.sanitize(fromId)}_`;
+            const toPrefix = `${this.sanitize(toId)}_`;
+            const files = fs.readdirSync(dir).filter((file) => file.startsWith(fromPrefix) && file.endsWith('.jsonl'));
+
+            for (const file of files) {
+                const sourcePath = path.join(dir, file);
+                const targetPath = path.join(dir, `${toPrefix}${file.slice(fromPrefix.length)}`);
+                const sourceLines = fs.readFileSync(sourcePath, 'utf-8').split('\n').filter(Boolean);
+                const rewritten = sourceLines
+                    .map((line) => {
+                        try {
+                            const parsed = JSON.parse(line) as HistoryMessage;
+                            if (parsed.historySessionId !== fromId) return null;
+                            return JSON.stringify({
+                                ...parsed,
+                                historySessionId: toId,
+                            });
+                        } catch {
+                            return null;
+                        }
+                    })
+                    .filter((line): line is string => !!line);
+                if (rewritten.length === 0) {
+                    fs.unlinkSync(sourcePath);
+                    continue;
+                }
+
+                const existing = fs.existsSync(targetPath)
+                    ? new Set(fs.readFileSync(targetPath, 'utf-8').split('\n').filter(Boolean))
+                    : new Set<string>();
+                const nextLines = rewritten.filter((line) => !existing.has(line));
+                if (nextLines.length > 0) {
+                    fs.appendFileSync(targetPath, `${nextLines.join('\n')}\n`, 'utf-8');
+                }
+                fs.unlinkSync(sourcePath);
+            }
+        } catch {
+            // Ignore promotion failure; future messages will still write to the new session key.
+        }
+    }
+
 /** Called when agent session is explicitly changed */
     onSessionChange(agentType: string): void {
         this.lastSeenHashes.delete(agentType);
@@ -157,15 +267,15 @@ export function readChatHistory(
     agentType: string,
     offset: number = 0,
     limit: number = 30,
-    instanceId?: string,
+    historySessionId?: string,
 ): { messages: HistoryMessage[]; hasMore: boolean } {
     try {
         const sanitized = agentType.replace(/[^a-zA-Z0-9_-]/g, '_');
         const dir = path.join(HISTORY_DIR, sanitized);
         if (!fs.existsSync(dir)) return { messages: [], hasMore: false };
 
- // JSONL file list — filter by instanceId prefix if specified
-        const sanitizedInstance = instanceId?.replace(/[^a-zA-Z0-9_-]/g, '_');
+ // JSONL file list — filter by persistent history key when specified
+        const sanitizedInstance = historySessionId?.replace(/[^a-zA-Z0-9_-]/g, '_');
         const files = fs.readdirSync(dir)
             .filter(f => {
                 if (!f.endsWith('.jsonl')) return false;
@@ -210,3 +320,76 @@ export function readChatHistory(
         return { messages: [], hasMore: false };
     }
 }
+
+export function listSavedHistorySessions(
+    agentType: string,
+    options: { offset?: number; limit?: number } = {},
+): { sessions: SavedHistorySessionSummary[]; hasMore: boolean } {
+    try {
+        const sanitized = agentType.replace(/[^a-zA-Z0-9_-]/g, '_');
+        const dir = path.join(HISTORY_DIR, sanitized);
+        if (!fs.existsSync(dir)) return { sessions: [], hasMore: false };
+
+        const groupedFiles = new Map<string, string[]>();
+        const filePattern = /^([A-Za-z0-9_-]+)_\d{4}-\d{2}-\d{2}\.jsonl$/;
+        for (const file of fs.readdirSync(dir)) {
+            if (!file.endsWith('.jsonl')) continue;
+            const match = file.match(filePattern);
+            if (!match?.[1]) continue;
+            const historySessionId = match[1];
+            const files = groupedFiles.get(historySessionId) || [];
+            files.push(file);
+            groupedFiles.set(historySessionId, files);
+        }
+
+        const summaries: SavedHistorySessionSummary[] = [];
+        for (const [historySessionId, files] of groupedFiles.entries()) {
+            let messageCount = 0;
+            let firstMessageAt = 0;
+            let lastMessageAt = 0;
+            let sessionTitle = '';
+            let preview = '';
+
+            for (const file of files.sort()) {
+                const filePath = path.join(dir, file);
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const lines = content.split('\n').filter(Boolean);
+                for (const line of lines) {
+                    let parsed: HistoryMessage | null = null;
+                    try {
+                        parsed = JSON.parse(line) as HistoryMessage;
+                    } catch {
+                        parsed = null;
+                    }
+                    if (!parsed || parsed.historySessionId !== historySessionId) continue;
+                    messageCount += 1;
+                    if (!firstMessageAt || parsed.receivedAt < firstMessageAt) firstMessageAt = parsed.receivedAt;
+                    if (!lastMessageAt || parsed.receivedAt > lastMessageAt) lastMessageAt = parsed.receivedAt;
+                    if (parsed.sessionTitle) sessionTitle = parsed.sessionTitle;
+                    if (parsed.role !== 'system' && parsed.content.trim()) preview = parsed.content.trim();
+                }
+            }
+
+            if (messageCount === 0 || !lastMessageAt) continue;
+            summaries.push({
+                historySessionId,
+                sessionTitle: sessionTitle || undefined,
+                messageCount,
+                firstMessageAt,
+                lastMessageAt,
+                preview: preview || undefined,
+            });
+        }
+
+        summaries.sort((a, b) => b.lastMessageAt - a.lastMessageAt);
+        const offset = Math.max(0, options.offset || 0);
+        const limit = Math.max(1, options.limit || 30);
+        const sliced = summaries.slice(offset, offset + limit);
+        return {
+            sessions: sliced,
+            hasMore: summaries.length > offset + limit,
+        };
+    } catch {
+        return { sessions: [], hasMore: false };
+    }
+}

package/src/config/config.d.ts

@@ -5,8 +5,10 @@
  */
 import type { WorkspaceEntry } from './workspaces.js';
 import type { RecentActivityEntry } from './recent-activity.js';
+import type { SavedProviderSessionEntry } from './saved-sessions.js';
 export type { WorkspaceEntry } from './workspaces.js';
 export type { RecentActivityEntry } from './recent-activity.js';
+export type { SavedProviderSessionEntry } from './saved-sessions.js';
 export interface ADHDevConfig {
     serverUrl: string;
     selectedIde: string | null;
@@ -23,6 +25,8 @@ export interface ADHDevConfig {
     defaultWorkspaceId?: string | null;
     /** Unified recent activity across IDE / CLI / ACP launch flows */
     recentActivity?: RecentActivityEntry[];
+    /** Persistent resume-capable provider sessions keyed by providerSessionId */
+    savedProviderSessions?: SavedProviderSessionEntry[];
     /** Last seen timestamps for live sessions, keyed by sessionId */
     sessionReads?: Record<string, number>;
     /** Last seen completion marker for live sessions, keyed by sessionId */

package/src/config/config.ts

@@ -10,8 +10,10 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'f
 import { randomUUID } from 'crypto';
 import type { WorkspaceEntry } from './workspaces.js';
 import type { RecentActivityEntry } from './recent-activity.js';
+import type { SavedProviderSessionEntry } from './saved-sessions.js';
 export type { WorkspaceEntry } from './workspaces.js';
 export type { RecentActivityEntry } from './recent-activity.js';
+export type { SavedProviderSessionEntry } from './saved-sessions.js';
 
 export interface ADHDevConfig {
  // Server connection
@@ -44,6 +46,8 @@ export interface ADHDevConfig {
 
     /** Unified recent activity across IDE / CLI / ACP launch flows */
     recentActivity?: RecentActivityEntry[];
+    /** Persistent resume-capable provider sessions keyed by providerSessionId */
+    savedProviderSessions?: SavedProviderSessionEntry[];
     /** Last seen timestamps for live sessions, keyed by sessionId */
     sessionReads?: Record<string, number>;
     /** Last seen completion marker for live sessions, keyed by sessionId */
@@ -99,6 +103,7 @@ const DEFAULT_CONFIG: ADHDevConfig = {
     workspaces: [],
     defaultWorkspaceId: null,
     recentActivity: [],
+    savedProviderSessions: [],
     sessionReads: {},
     sessionReadMarkers: {},
     machineNickname: null,
@@ -161,6 +166,7 @@ function normalizeConfig(raw: unknown): ADHDevConfig & { activeWorkspaceId?: str
         workspaces: Array.isArray(parsed.workspaces) ? parsed.workspaces as WorkspaceEntry[] : [],
         defaultWorkspaceId: asNullableString(parsed.defaultWorkspaceId) ?? asNullableString(parsed.activeWorkspaceId),
         recentActivity: Array.isArray(parsed.recentActivity) ? parsed.recentActivity as RecentActivityEntry[] : [],
+        savedProviderSessions: Array.isArray(parsed.savedProviderSessions) ? parsed.savedProviderSessions as SavedProviderSessionEntry[] : [],
         sessionReads: mergedSessionReads,
         sessionReadMarkers,
         machineNickname: asNullableString(parsed.machineNickname),

package/src/config/recent-activity.ts

@@ -3,7 +3,7 @@
  *
  * Unlike live session state, this is launch oriented:
  * - one normalized row shape for IDE / CLI / ACP
- * - deduped by kind + providerType + workspace
+ * - deduped by provider session when available, else by kind + providerType + workspace
  * - used only for quick-launch shortcuts
  */
 
@@ -16,6 +16,7 @@ export interface RecentActivityEntry {
     kind: 'ide' | 'cli' | 'acp';
     providerType: string;
     providerName: string;
+    providerSessionId?: string;
     workspace?: string | null;
     currentModel?: string;
     title?: string;
@@ -37,6 +38,16 @@ export function buildRecentActivityKey(entry: Pick<RecentActivityEntry, 'kind' |
     return `${entry.kind}:${entry.providerType}:${normalizeWorkspace(entry.workspace)}`;
 }
 
+export function buildRecentActivityKeyForEntry(
+    entry: Pick<RecentActivityEntry, 'kind' | 'providerType' | 'workspace' | 'providerSessionId'>,
+) {
+    const providerSessionId = typeof entry.providerSessionId === 'string' ? entry.providerSessionId.trim() : '';
+    if (providerSessionId) {
+        return `${entry.kind}:${entry.providerType}:session:${providerSessionId}`;
+    }
+    return buildRecentActivityKey(entry);
+}
+
 export function appendRecentActivity(
     config: ADHDevConfig,
     entry: Omit<RecentActivityEntry, 'id' | 'lastUsedAt'> & { lastUsedAt?: number },
@@ -44,7 +55,7 @@ export function appendRecentActivity(
     const nextEntry: RecentActivityEntry = {
         ...entry,
         workspace: entry.workspace ? normalizeWorkspace(entry.workspace) : undefined,
-        id: buildRecentActivityKey(entry),
+        id: buildRecentActivityKeyForEntry(entry),
         lastUsedAt: entry.lastUsedAt || Date.now(),
     };
 

package/src/config/saved-sessions.ts

@@ -0,0 +1,73 @@
+import * as path from 'path';
+import type { ADHDevConfig } from './config.js';
+import { expandPath } from './workspaces.js';
+
+export interface SavedProviderSessionEntry {
+    id: string;
+    kind: 'cli' | 'acp';
+    providerType: string;
+    providerName: string;
+    providerSessionId: string;
+    workspace?: string | null;
+    currentModel?: string;
+    title?: string;
+    createdAt: number;
+    lastUsedAt: number;
+}
+
+const MAX_SAVED_SESSIONS = 500;
+
+function normalizeWorkspace(workspace?: string | null) {
+    if (!workspace) return '';
+    try {
+        return path.resolve(expandPath(workspace));
+    } catch {
+        return path.resolve(workspace);
+    }
+}
+
+export function buildSavedProviderSessionKey(providerSessionId: string) {
+    return `saved:${providerSessionId.trim()}`;
+}
+
+export function upsertSavedProviderSession(
+    config: ADHDevConfig,
+    entry: Omit<SavedProviderSessionEntry, 'id' | 'createdAt' | 'lastUsedAt'> & { createdAt?: number; lastUsedAt?: number },
+): ADHDevConfig {
+    const providerSessionId = typeof entry.providerSessionId === 'string' ? entry.providerSessionId.trim() : '';
+    if (!providerSessionId) return config;
+
+    const id = buildSavedProviderSessionKey(providerSessionId);
+    const existing = (config.savedProviderSessions || []).find(item => item.id === id);
+    const nextEntry: SavedProviderSessionEntry = {
+        id,
+        kind: entry.kind,
+        providerType: entry.providerType,
+        providerName: entry.providerName,
+        providerSessionId,
+        workspace: entry.workspace ? normalizeWorkspace(entry.workspace) : undefined,
+        currentModel: entry.currentModel,
+        title: entry.title,
+        createdAt: existing?.createdAt || entry.createdAt || Date.now(),
+        lastUsedAt: entry.lastUsedAt || Date.now(),
+    };
+
+    const filtered = (config.savedProviderSessions || []).filter(item => item.id !== id);
+    return {
+        ...config,
+        savedProviderSessions: [nextEntry, ...filtered].slice(0, MAX_SAVED_SESSIONS),
+    };
+}
+
+export function getSavedProviderSessions(
+    config: ADHDevConfig,
+    filters?: { providerType?: string; kind?: SavedProviderSessionEntry['kind'] },
+): SavedProviderSessionEntry[] {
+    return [...(config.savedProviderSessions || [])]
+        .filter(entry => {
+            if (filters?.providerType && entry.providerType !== filters.providerType) return false;
+            if (filters?.kind && entry.kind !== filters.kind) return false;
+            return true;
+        })
+        .sort((a, b) => b.lastUsedAt - a.lastUsedAt);
+}

package/src/daemon/dev-auto-implement.ts

@@ -952,22 +952,32 @@ export function buildCliAutoImplPrompt(ctx: DevServerContext,
   lines.push('| `detectStatus` | `{ tail, screenText, rawBuffer }` | `idle`, `generating`, `waiting_approval`, or `error` |');
   lines.push('| `parseApproval` | `{ buffer, rawBuffer, tail }` | `{ message, buttons }` or `null` |');
   lines.push('');
+  lines.push('## Primary Source of Truth');
+  lines.push('The runtime now provides a reliable current-screen snapshot. Treat `screenText` as the primary source of truth for the LIVE visible UI.');
+  lines.push('That means:');
+  lines.push('- Use `screenText` first for prompt detection, approval UI, status, and visible assistant content.');
+  lines.push('- Use `rawBuffer` only as supporting evidence when ANSI/style/cursor cues matter.');
+  lines.push('- Use `buffer` only when the visible screen does not contain enough text to recover the latest assistant answer.');
+  lines.push('- Do NOT build the parser around stale transcript noise if the current screen already gives the answer.');
+  lines.push('');
 
   lines.push('## Rules');
   lines.push('0. **🚫 SCOPE CONSTRAINT**: You may ONLY edit files marked ✏️ EDIT above. ALL other files are READ-ONLY. Do NOT modify, rewrite, refactor, or "improve" any file not explicitly marked as editable — even if you notice bugs or improvements. No exceptions.');
   lines.push('1. These scripts run in Node.js CommonJS, not in the browser. Do NOT use DOM APIs.');
-  lines.push('2. Prefer `screenText` for current visible UI state. That is the PTY equivalent of parsing the current IDE DOM.');
+  lines.push('2. Prefer `screenText` for current visible UI state. It is now the PTY equivalent of a trustworthy live DOM snapshot.');
   lines.push('3. Use `messages` as prior transcript state so redraws do not duplicate old turns on every parse.');
   lines.push('4. Use `partialResponse` for the actively streaming assistant text when status is `generating`.');
-  lines.push('5. `detectStatus` must stay lightweight and tail-based. Do not scan the entire history there.');
-  lines.push('6. `parseApproval` should understand the live approval area and return clean button labels.');
-  lines.push('7. Use `rawBuffer` only when ANSI/control-sequence artifacts matter. Do not depend on raw escape noise unless necessary.');
+  lines.push('5. `detectStatus` must stay lightweight and current-screen-oriented. Prefer the active bottom-of-screen region over stale history.');
+  lines.push('6. `parseApproval` should understand the live approval area and return clean button labels from the CURRENT visible modal.');
+  lines.push('7. Use `rawBuffer` only when ANSI/control-sequence artifacts or style cues matter. Do not depend on raw escape noise unless necessary.');
   lines.push('8. Keep exports compatible with the existing `scripts.js` router (`module.exports = function ...`).');
   lines.push('9. Do NOT modify ANY file not explicitly marked ✏️ EDIT above. No exceptions — no "tiny supporting changes" to other files.');
   lines.push('10. When the verification API returns `instanceId`, keep using that exact instance for follow-up `send`, `resolve`, `raw`, and `stop` calls. Do not assume type-only routing is safe if multiple sessions exist.');
   lines.push('11. Do NOT repeatedly dump the same target files. Read the target scripts once, reproduce the bug, then move directly to patching.');
   lines.push('12. If the user instructions include concrete screen text, raw PTY snippets, or a specific repro, treat that as the primary acceptance criteria.');
   lines.push('13. After the first successful live repro, stop broad diagnosis. Edit the scripts, reload, and verify. Do not burn tokens on repeated re-inspection without code changes.');
+  lines.push('14. If the visible current screen is clean and sufficient, do NOT fall back to complex buffer heuristics. Simpler current-screen parsing is preferred.');
+  lines.push('15. Before changing parser logic, verify whether `provider.json` submit/approval behavior (`sendDelayMs`, `approvalKeys`, submit strategy) is the simpler and more correct fix.');
   lines.push('');
 
   lines.push('## Task');
@@ -990,6 +1000,12 @@ export function buildCliAutoImplPrompt(ctx: DevServerContext,
   lines.push(`curl -sS http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/status`);
   lines.push('```');
   lines.push('');
+  lines.push('The debug payload should be read in this priority order:');
+  lines.push('1. `screenText` / current visible state');
+  lines.push('2. parsed `status`, `messages`, `activeModal`');
+  lines.push('3. `rawBuffer` only for style/control-sequence cues');
+  lines.push('4. `buffer` only when the current screen is insufficient');
+  lines.push('');
   lines.push('Extract the current `instanceId` from the launch or status response and keep using it below.');
   lines.push('');
   lines.push('### 3. Send a realistic approval-triggering prompt');
@@ -1036,6 +1052,8 @@ export function buildCliAutoImplPrompt(ctx: DevServerContext,
   lines.push('5. Confirm the Python file was actually created and executed, not just described in chat text.');
   lines.push('6. Confirm the final assistant transcript includes the exact Python output, including the working directory line and the five square numbers.');
   lines.push('7. Re-run the debug endpoints after edits. Do NOT finish until the parsed result looks correct.');
+  lines.push('8. Confirm the parser still works after a redraw or scroll change without duplicating transcript history.');
+  lines.push('9. Confirm the implementation prefers current-screen signals over stale history when both are present.');
   lines.push('');
 
   if (userComment) {
@@ -1091,4 +1109,4 @@ export function sendAutoImplSSE(ctx: DevServerContext, msg: { event: string; dat
   for (const client of ctx.autoImplSSEClients) {
     try { client.write(payload); } catch { /* ignore */ }
   }
-}
+}

package/src/daemon/dev-server.ts

@@ -1427,22 +1427,32 @@ export class DevServer implements DevServerContext {
     lines.push('| `detectStatus` | `{ tail, screenText, rawBuffer }` | `idle`, `generating`, `waiting_approval`, or `error` |');
     lines.push('| `parseApproval` | `{ buffer, rawBuffer, tail }` | `{ message, buttons }` or `null` |');
     lines.push('');
+    lines.push('## Primary Source of Truth');
+    lines.push('The runtime now provides a reliable current-screen snapshot. Treat `screenText` as the primary source of truth for the LIVE visible UI.');
+    lines.push('That means:');
+    lines.push('- Use `screenText` first for prompt detection, approval UI, status, and visible assistant content.');
+    lines.push('- Use `rawBuffer` only as supporting evidence when ANSI/style/cursor cues matter.');
+    lines.push('- Use `buffer` only when the visible screen does not contain enough text to recover the latest assistant answer.');
+    lines.push('- Do NOT build the parser around stale transcript noise if the current screen already gives the answer.');
+    lines.push('');
 
     lines.push('## Rules');
     lines.push('0. **🚫 SCOPE CONSTRAINT**: You may ONLY edit files marked ✏️ EDIT above. ALL other files are READ-ONLY. Do NOT modify, rewrite, refactor, or "improve" any file not explicitly marked as editable — even if you notice bugs or improvements. No exceptions.');
     lines.push('1. These scripts run in Node.js CommonJS, not in the browser. Do NOT use DOM APIs.');
-    lines.push('2. Prefer `screenText` for current visible UI state. That is the PTY equivalent of parsing the current IDE DOM.');
+    lines.push('2. Prefer `screenText` for current visible UI state. It is now the PTY equivalent of a trustworthy live DOM snapshot.');
     lines.push('3. Use `messages` as prior transcript state so redraws do not duplicate old turns on every parse.');
     lines.push('4. Use `partialResponse` for the actively streaming assistant text when status is `generating`.');
-    lines.push('5. `detectStatus` must stay lightweight and tail-based. Do not scan the entire history there.');
-    lines.push('6. `parseApproval` should understand the live approval area and return clean button labels.');
-    lines.push('7. Use `rawBuffer` only when ANSI/control-sequence artifacts matter. Do not depend on raw escape noise unless necessary.');
+    lines.push('5. `detectStatus` must stay lightweight and current-screen-oriented. Prefer the active bottom-of-screen region over stale history.');
+    lines.push('6. `parseApproval` should understand the live approval area and return clean button labels from the CURRENT visible modal.');
+    lines.push('7. Use `rawBuffer` only when ANSI/control-sequence artifacts or style cues matter. Do not depend on raw escape noise unless necessary.');
     lines.push('8. Keep exports compatible with the existing `scripts.js` router (`module.exports = function ...`).');
     lines.push('9. Do NOT modify ANY file not explicitly marked ✏️ EDIT above. No exceptions — no "tiny supporting changes" to other files.');
     lines.push('10. When the verification API returns `instanceId`, keep using that exact instance for follow-up `send`, `resolve`, `raw`, and `stop` calls. Do not assume type-only routing is safe if multiple sessions exist.');
     lines.push('11. Do NOT repeatedly dump the same target files. Read the target scripts once, reproduce the bug, then move directly to patching.');
     lines.push('12. If the user instructions include concrete screen text, raw PTY snippets, or a specific repro, treat that as the primary acceptance criteria.');
     lines.push('13. After the first successful live repro, stop broad diagnosis. Edit the scripts, reload, and verify. Do not burn tokens on repeated re-inspection without code changes.');
+    lines.push('14. If the visible current screen is clean and sufficient, do NOT fall back to complex buffer heuristics. Simpler current-screen parsing is preferred.');
+    lines.push('15. Before changing parser logic, verify whether `provider.json` submit/approval behavior (`sendDelayMs`, `approvalKeys`, submit strategy) is the simpler and more correct fix.');
     lines.push('');
 
     lines.push('## Task');
@@ -1465,6 +1475,12 @@ export class DevServer implements DevServerContext {
     lines.push(`curl -sS http://127.0.0.1:${DEV_SERVER_PORT}/api/cli/status`);
     lines.push('```');
     lines.push('');
+    lines.push('The debug payload should be read in this priority order:');
+    lines.push('1. `screenText` / current visible state');
+    lines.push('2. parsed `status`, `messages`, `activeModal`');
+    lines.push('3. `rawBuffer` only for style/control-sequence cues');
+    lines.push('4. `buffer` only when the current screen is insufficient');
+    lines.push('');
     lines.push('Extract the current `instanceId` from the launch or status response and keep using it below.');
     lines.push('');
     lines.push('### 3. Send a realistic approval-triggering prompt');
@@ -1511,6 +1527,8 @@ export class DevServer implements DevServerContext {
     lines.push('5. Confirm the Python file was actually created and executed, not just described in chat text.');
     lines.push('6. Confirm the final assistant transcript includes the exact Python output, including the working directory line and the five square numbers.');
     lines.push('7. Re-run the debug endpoints after edits. Do NOT finish until the parsed result looks correct.');
+    lines.push('8. Confirm the parser still works after a redraw or scroll change without duplicating transcript history.');
+    lines.push('9. Confirm the implementation prefers current-screen signals over stale history when both are present.');
     lines.push('');
 
     if (userComment) {

package/src/index.ts

@@ -66,6 +66,8 @@ export { loadConfig, saveConfig, resetConfig, isSetupComplete, markSetupComplete
 export { getWorkspaceState } from './config/workspaces.js';
 export { appendRecentActivity, getRecentActivity } from './config/recent-activity.js';
 export type { RecentActivityEntry } from './config/recent-activity.js';
+export { getSavedProviderSessions, upsertSavedProviderSession } from './config/saved-sessions.js';
+export type { SavedProviderSessionEntry } from './config/saved-sessions.js';
 
 // ── Detection ──
 export { detectIDEs } from './detection/ide-detector.js';