@agi-fans/dsh-tui 0.6.1 → 0.8.0

package/lib/runtime/provider-local.js

@@ -3,7 +3,7 @@
 
  * Owns the tty: raw-mode key input (editing, history, slash/tab
  * autocomplete, /settings overlay, /copy picker, Ctrl-R history search, PgUp/PgDn
- * and mouse-wheel transcript scroll, click-to-caret, Ctrl-O tool
+ * and Shift+Up/Down transcript scroll, Ctrl-O tool
  * expand, bracketed paste, double-Escape conversation rewind, double Ctrl-C exit, Ctrl-D quit),
  * SIGWINCH reflow, and the differential renderer. In non-tty mode
  * (pipes, CI) it degrades to line-based input with plain append-only
@@ -14,18 +14,19 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
 import { TUI_SERVICE, } from "../definition.js";
-import { applySlashCompletion, formatHelpText, hitTestAutocomplete, parseSlashInput, resolveSlashCommand, slashSuggestions, BUILTIN_SLASH_COMMANDS, } from "../views/autocomplete.js";
-import { applyPathCompletion, defaultPathSource, findPathToken, parsePathPrefix, pathSuggestions, searchPathSuggestions, } from "../views/path-complete.js";
+import { applySlashCompletion, formatHelpText, parseSlashInput, resolveSlashCommand, slashSuggestions, BUILTIN_SLASH_COMMANDS, } from "../views/autocomplete.js";
+import { applyPathCompletion, defaultPathSource, editorLineAt, findPathToken, parsePathPrefix, pathSuggestions, searchPathSuggestions, } from "../views/path-complete.js";
+import { activeAtToken } from '@deepseek-ai/dsh-file-reference/grammar';
+import { nextSelectableAutocompleteIndex, searchAtSuggestions, } from "../views/at-complete.js";
 import { copyToClipboard, readFromClipboard } from "../input/clipboard.js";
-import { applyCopySelectorEvent, createCopySelector, hitTestCopySelector, selectCopyTarget, } from "../views/copy-selector.js";
+import { applyCopySelectorEvent, createCopySelector, } from "../views/copy-selector.js";
 import { buildCopyTargets, extractCopyTarget, parseCopyKind } from "../views/copy-targets.js";
-import { applyHistorySearchEvent, createHistorySearch, hitTestHistorySearch, } from "../views/history-search.js";
+import { applyHistorySearchEvent, createHistorySearch, } from "../views/history-search.js";
 import { InputEditor, lineEnd, lineStart } from "../input/editor.js";
-import { applySettingsEvent, createSettings, hitTestSettings, selectSetting, tuiSettingItems, } from "../views/settings-list.js";
-import { applyEvent, blockLines, hitTestSubagentRoster, initialTranscript, replayEvents, renderView, TRANSCRIPT_FAST_SCROLL, TRANSCRIPT_WHEEL_SCROLL, } from "../views/event-views.js";
-import { flushPending, MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseKeys } from "../input/keys.js";
-import { LineRenderer } from "../chrome/renderer.js";
-import { hitTestEditor } from "../chrome/box.js";
+import { applySettingsEvent, createSettings, } from "../views/settings-list.js";
+import { applyEvent, blockLines, initialTranscript, replayEvents, renderView, TRANSCRIPT_FAST_SCROLL, } from "../views/event-views.js";
+import { flushPending, parseKeys } from "../input/keys.js";
+import { MainScreenRenderer } from "../chrome/main-screen-renderer.js";
 import { createTheme, detectTrueColor, parseThemeName } from "../chrome/theme.js";
 import { TUI_SETTINGS_NAMESPACE, TuiSettingsSchema } from "../session/tui-settings.js";
 import { defaultStatusBarConfig, resolveStatusBarConfig } from "../chrome/status-config.js";
@@ -37,7 +38,7 @@ import { movePromptSelection, filteredPromptOptions, selectedPromptAnswer, selec
 import { resolveProjectContext } from "../session/project-context.js";
 import { pickWelcomeTips } from "../chrome/welcome-tips.js";
 import { formatEssentialHotkeysText, formatHotkeysText, hotkeyCount } from "../views/hotkeys.js";
-import { imageMarker, imagePathCandidates, probeImageDimensions, readImageFile, readImageFromClipboard, readMacClipboardFiles, } from "../input/image-paste.js";
+import { imageMarker, imagePathCandidates, probeImageDimensions, stripComposerImageMarkers, readImageFile, readImageFromClipboard, readMacClipboardFiles, } from "../input/image-paste.js";
 import { APP_NAME, APP_VERSION } from "../session/package-metadata.js";
 const DOUBLE_CTRL_C_MS = 500;
 const DOUBLE_ESCAPE_MS = 500;
@@ -53,7 +54,19 @@ export const name = 'omdsh-tui';
 /**
  * Local terminal presentation service.
  */
+function detectTerminalProfile() {
+    if (process.env.TMUX !== undefined || process.env.STY !== undefined || process.env.ZELLIJ !== undefined) {
+        return 'multiplexer';
+    }
+    return process.platform === 'win32' ? 'conpty' : 'direct';
+}
 export class LocalTui {
+    #deferInitialRender = false;
+    #terminalProfile;
+    #resizeDebounceMs;
+    #resizeTimer = null;
+    #streamRenderMs;
+    #streamRenderTimer = null;
     #term;
     #model;
     #reasoningEffort;
@@ -91,7 +104,6 @@ export class LocalTui {
     #autocompleteTimer = null;
     #autocompleteAbort = null;
     #autocompleteRequestId = 0;
-    #scrollRender = null;
     #paste = false;
     #pasteBuf = '';
     #pasteInFlight = 0;
@@ -129,10 +141,9 @@ export class LocalTui {
     #sessionControls;
     #loopStatus;
     #subagents;
+    #subagentLauncherFocused = false;
     #inspected;
-    #editorHit = null;
-    #chromeHit = null;
-    #overlayHit = null;
+    #promptDocument;
     #trueColor;
     #copy;
     #readClipboard;
@@ -146,6 +157,9 @@ export class LocalTui {
     #home;
     #listDir;
     #searchFiles;
+    #searchFileMentions;
+    #searchSessions;
+    #validateImageDraft;
     #autocompleteDebounceMs;
     #persistPrefs = null;
     /**
@@ -176,32 +190,49 @@ export class LocalTui {
         this.#home = paths.home ?? fallback.home;
         this.#listDir = paths.listDir ?? fallback.listDir;
         this.#searchFiles = paths.searchFiles ?? fallback.searchFiles;
+        this.#searchFileMentions = paths.searchFileMentions;
+        this.#searchSessions = paths.searchSessions;
         this.#autocompleteDebounceMs = Math.max(0, paths.autocompleteDebounceMs ?? 100);
         this.#welcomeTips = pickWelcomeTips();
+        this.#deferInitialRender = paths.deferInitialRender === true;
+        this.#terminalProfile = paths.terminalProfile ?? detectTerminalProfile();
+        this.#resizeDebounceMs = Math.max(0, paths.resizeDebounceMs ?? 120);
+        this.#streamRenderMs = Math.max(0, paths.streamRenderMs ?? 8);
         this.#trueColor = colors && detectTrueColor();
         this.#tty = term.input.isTTY === true;
         this.#pwd = shortenPath(project.root);
         this.#branch = project.gitLabel;
-        this.#renderer = new LineRenderer({ write: (chunk) => { this.#term.output.write(chunk); } }, { synchronized: this.#tty });
+        this.#renderer = new MainScreenRenderer({ write: (chunk) => { this.#term.output.write(chunk); } }, {
+            width: this.#term.width(),
+            height: this.#term.height(),
+            synchronized: this.#tty,
+            clearScrollback: this.#terminalProfile === 'direct',
+            alternateScreenOverlays: paths.alternateScreenOverlays === true,
+        });
         if (this.#tty) {
+            this.#renderer.startEpoch();
             term.input.setRawMode?.(true);
             const listener = (chunk) => { this.#onData(chunk); };
             term.input.on('data', listener);
             this.#offData = () => { term.input.off('data', listener); };
             this.#offResize = term.onResize?.(() => {
-                // A terminal resize invalidates both the physical cursor position and
-                // the screen-relative frame retained by the differential renderer.
-                this.#renderer.reset();
-                this.#term.output.write('\x1b[2J\x1b[H');
-                this.#render();
+                // A terminal resize changes the committed/live seam; re-anchor the
+                // live window so it stays anchored at the bottom.
+                const repaint = () => {
+                    this.#resizeTimer = null;
+                    this.#renderer.resize(this.#term.width(), this.#term.height());
+                    this.#render();
+                };
+                if (this.#terminalProfile === 'multiplexer') {
+                    if (this.#resizeTimer !== null)
+                        clearTimeout(this.#resizeTimer);
+                    this.#resizeTimer = setTimeout(repaint, this.#resizeDebounceMs);
+                }
+                else {
+                    repaint();
+                }
             }) ?? null;
-            // Boot output above us (package-manager warnings, loader logs) has
-            // already scrolled the cursor off row 0; the renderer's screen-relative
-            // frames require a clean origin. Clear the screen and home the cursor
-            // before the first frame. Enable bracketed paste and SGR mouse
-            // tracking (wheel drives the virtual transcript; native scrollback
-            // is already unusable under full-screen diffs).
-            term.output.write('\x1b[2J\x1b[H\x1b[?2004h' + MOUSE_TRACKING_ON);
+            term.output.write('\x1b[?2004h');
         }
         this.#render();
     }
@@ -209,7 +240,12 @@ export class LocalTui {
         this.#state = applyEvent(this.#state, event, presentation);
         this.#syncTick();
         if (this.#tty) {
-            this.#render();
+            if (event.type === 'assistant/chunk' && this.#streamRenderMs > 0) {
+                this.#scheduleStreamRender();
+            }
+            else {
+                this.#render();
+            }
         }
         else if (event.type === 'user/message' || event.type === 'assistant/message' || event.type === 'tool/result' || event.type === 'turn/end') {
             this.#printPlain();
@@ -239,6 +275,8 @@ export class LocalTui {
         this.#subagents = roster === undefined
             ? undefined
             : { agents: roster.agents.map(agent => ({ ...agent, activity: [...agent.activity] })) };
+        if ((this.#subagents?.agents.length ?? 0) === 0)
+            this.#subagentLauncherFocused = false;
         const inspected = this.#inspected;
         if (inspected !== undefined) {
             const current = this.#subagents?.agents.find(agent => agent.id === inspected.id);
@@ -258,6 +296,8 @@ export class LocalTui {
     }
     setInspectedSubagent(inspected) {
         this.#inspected = inspected === undefined ? undefined : { ...inspected };
+        if (inspected !== undefined)
+            this.#subagentLauncherFocused = false;
         this.#syncTick();
         if (this.#tty)
             this.#render();
@@ -275,6 +315,21 @@ export class LocalTui {
         if (this.#tty)
             this.#render();
     }
+    setSessionSearch(search) {
+        this.#searchSessions = search;
+        this.#refreshAutocomplete();
+        if (this.#tty)
+            this.#render();
+    }
+    setFileSearch(search) {
+        this.#searchFileMentions = search;
+        this.#refreshAutocomplete();
+        if (this.#tty)
+            this.#render();
+    }
+    setImageValidator(validate) {
+        this.#validateImageDraft = validate;
+    }
     notice(text, options = {}) {
         const block = {
             kind: 'notice',
@@ -330,11 +385,13 @@ export class LocalTui {
             }
         });
     }
-    replaceSession(events, presentations) {
+    replaceSession(events, presentations, status = 'idle') {
         const state = replayEvents(events, presentations);
-        this.#state = { ...state, status: 'idle', compactCommandId: undefined };
+        this.#state = { ...state, status, compactCommandId: undefined };
         this.#plainPrinted = 0;
         this.#followTail();
+        this.#deferInitialRender = false;
+        this.#renderer.startEpoch({ replay: status === 'idle' ? 'full' : 'pinned' });
         if (this.#tty)
             this.#render();
         else
@@ -473,6 +530,14 @@ export class LocalTui {
         if (this.#disposed)
             return;
         this.#disposed = true;
+        if (this.#resizeTimer !== null) {
+            clearTimeout(this.#resizeTimer);
+            this.#resizeTimer = null;
+        }
+        if (this.#streamRenderTimer !== null) {
+            clearTimeout(this.#streamRenderTimer);
+            this.#streamRenderTimer = null;
+        }
         if (this.#tick !== null) {
             clearInterval(this.#tick);
             this.#tick = null;
@@ -481,19 +546,15 @@ export class LocalTui {
             clearInterval(this.#loopTick);
             this.#loopTick = null;
         }
-        if (this.#scrollRender !== null) {
-            clearImmediate(this.#scrollRender);
-            this.#scrollRender = null;
-        }
         if (this.#tty) {
             this.#offData?.();
             this.#offResize?.();
             this.#term.input.setRawMode?.(false);
             // Leave the cursor on a fresh line below the last frame so the shell
-            // prompt does not overwrite the transcript. Disable mouse tracking
-            // and bracketed paste.
+            // prompt does not overwrite the transcript. Disable bracketed paste
+            // and restore the cursor.
             this.#renderer.finish();
-            this.#term.output.write(MOUSE_TRACKING_OFF + '\x1b[?2004l\x1b[?25h\r\n');
+            this.#term.output.write('\x1b[?2004l\x1b[?25h\r\n');
             if (this.#resumeHintRequested && this.#sessionId !== undefined) {
                 this.#term.output.write(`\r\nResume this session with ${APP_NAME} --resume ${this.#sessionId}\r\n`);
             }
@@ -613,10 +674,12 @@ export class LocalTui {
         }
     }
     #render() {
-        if (this.#scrollRender !== null) {
-            clearImmediate(this.#scrollRender);
-            this.#scrollRender = null;
+        if (this.#streamRenderTimer !== null) {
+            clearTimeout(this.#streamRenderTimer);
+            this.#streamRenderTimer = null;
         }
+        if (this.#deferInitialRender)
+            return;
         const width = this.#term.width();
         const frame = this.#tty
             ? renderView(this.#state, {
@@ -649,6 +712,7 @@ export class LocalTui {
                 ...(this.#sessionControls === undefined ? {} : { sessionControls: this.#sessionControls }),
                 ...(this.#loopStatus === undefined ? {} : { loopStatus: this.#loopStatus }),
                 ...(this.#subagents === undefined ? {} : { subagents: this.#subagents }),
+                subagentLauncherFocused: this.#subagentLauncherFocused,
                 ...(this.#inspected === undefined ? {} : { inspected: this.#inspected }),
                 statusBar: this.#statusBar,
                 ...(this.#prompt === null ? {} : { promptSelector: this.#prompt }),
@@ -662,12 +726,19 @@ export class LocalTui {
             })
             : { lines: [] };
         this.#focusBlock = undefined;
-        this.#editorHit = frame.editor ?? null;
-        this.#overlayHit = frame.overlay ?? null;
-        this.#chromeHit = frame.chrome ?? null;
+        this.#promptDocument = frame.promptDocument;
         this.#syncScroll(frame.transcript);
         this.#renderer.render(frame);
     }
+    #scheduleStreamRender() {
+        if (this.#streamRenderTimer !== null)
+            return;
+        this.#streamRenderTimer = setTimeout(() => {
+            this.#streamRenderTimer = null;
+            if (!this.#disposed)
+                this.#render();
+        }, this.#streamRenderMs);
+    }
     #syncScroll(scroll) {
         if (scroll === undefined) {
             this.#scrollStart = 0;
@@ -687,24 +758,14 @@ export class LocalTui {
     #pageSize() {
         return Math.max(1, this.#scrollBudget > 2 ? this.#scrollBudget - 2 : 1);
     }
-    #scrollBy(delta, coalesce = false) {
+    #scrollBy(delta) {
         if (delta === 0 && this.#maxStart === 0)
             return;
         this.#follow = false;
         this.#scrollStart += delta;
         if (this.#scrollStart <= 0)
             this.#scrollStart = 0;
-        if (!coalesce) {
-            this.#render();
-            return;
-        }
-        if (this.#scrollRender !== null)
-            return;
-        this.#scrollRender = setImmediate(() => {
-            this.#scrollRender = null;
-            if (!this.#disposed)
-                this.#render();
-        });
+        this.#render();
     }
     #followTail() {
         this.#follow = true;
@@ -765,10 +826,17 @@ export class LocalTui {
         if (paths.length > 0) {
             const images = await Promise.all(paths.map(path => this.#readImagePath(path)));
             if (images.every((image) => image !== null)) {
-                for (const image of images)
-                    this.#insertImageDraft(image);
-                this.#refreshAutocomplete();
-                this.#render();
+                let inserted = false;
+                for (const image of images) {
+                    if (await this.#admitImage(image)) {
+                        this.#insertImageDraft(image);
+                        inserted = true;
+                    }
+                }
+                if (inserted) {
+                    this.#refreshAutocomplete();
+                    this.#render();
+                }
                 return;
             }
             // Screenshot tools sometimes paste a transient cache path and remove
@@ -790,9 +858,11 @@ export class LocalTui {
         if (this.#search === null && this.#settings === null && this.#copySelector === null) {
             const image = await this.#readClipboardImage();
             if (image !== null) {
-                this.#insertImageDraft(image);
-                this.#refreshAutocomplete();
-                this.#render();
+                if (await this.#admitImage(image)) {
+                    this.#insertImageDraft(image);
+                    this.#refreshAutocomplete();
+                    this.#render();
+                }
                 return;
             }
             const files = await this.#readClipboardFiles();
@@ -801,10 +871,17 @@ export class LocalTui {
                 const images = (await Promise.all(imagePaths.map(path => this.#readImagePath(path))))
                     .filter((candidate) => candidate !== null);
                 if (images.length > 0) {
-                    for (const candidate of images)
-                        this.#insertImageDraft(candidate);
-                    this.#refreshAutocomplete();
-                    this.#render();
+                    let inserted = false;
+                    for (const candidate of images) {
+                        if (await this.#admitImage(candidate)) {
+                            this.#insertImageDraft(candidate);
+                            inserted = true;
+                        }
+                    }
+                    if (inserted) {
+                        this.#refreshAutocomplete();
+                        this.#render();
+                    }
                     return;
                 }
             }
@@ -813,6 +890,23 @@ export class LocalTui {
         if (text !== '')
             await this.#acceptPastedText(text);
     }
+    /**
+     * Run the Harness image-admission check for one paste candidate. A refusal
+     * becomes an error notice and skips the draft, instead of failing the whole
+     * submission after the user has typed a prompt around it.
+     */
+    async #admitImage(image) {
+        if (this.#validateImageDraft === undefined)
+            return true;
+        try {
+            await this.#validateImageDraft(image);
+            return true;
+        }
+        catch (error) {
+            this.notice(error instanceof Error ? error.message : String(error), { level: 'error' });
+            return false;
+        }
+    }
     #insertImageDraft(input) {
         const size = input.width === undefined || input.height === undefined
             ? probeImageDimensions(input.data, input.mediaType)
@@ -890,10 +984,6 @@ export class LocalTui {
     }
     #dispatch(event) {
         if (this.#state.status === 'compacting') {
-            if (event.type === 'mouse' && event.wheel !== null) {
-                this.#scrollBy(event.wheel < 0 ? -TRANSCRIPT_WHEEL_SCROLL : TRANSCRIPT_WHEEL_SCROLL, true);
-                return;
-            }
             if (event.type === 'key' && event.id === 'pageUp') {
                 this.#scrollBy(-this.#pageSize());
                 return;
@@ -932,11 +1022,6 @@ export class LocalTui {
             this.#pasteBuf = '';
             return;
         }
-        if (event.type === 'mouse') {
-            this.#lastEscapeTime = 0;
-            this.#handleMouse(event);
-            return;
-        }
         if (event.type !== 'key' || event.id !== 'escape')
             this.#lastEscapeTime = 0;
         if (this.#handlePrompt(event))
@@ -1019,6 +1104,8 @@ export class LocalTui {
                 this.#lastEscapeTime = 0;
             return;
         }
+        if (this.#handleSubagentLauncher(event))
+            return;
         if (event.type === 'key' && event.id === 'escape') {
             if (this.#inspected !== undefined) {
                 if (this.#inspected.writable === true && (this.#editor.text !== '' || this.#images.length > 0)) {
@@ -1212,7 +1299,7 @@ export class LocalTui {
             this.#render();
             return true;
         }
-        const scroll = this.#overlayHit?.kind === 'prompt' ? this.#overlayHit.document : undefined;
+        const scroll = this.#promptDocument;
         let documentScroll;
         if (event.id === 'up')
             documentScroll = (scroll?.start ?? prompt.documentScroll ?? 0) - 1;
@@ -1262,73 +1349,42 @@ export class LocalTui {
         }
         return true;
     }
-    #handleMouse(event) {
-        if (event.leftClick) {
-            if (this.#clickChrome(event.row))
-                return;
-            if (this.#clickOverlay(event.row))
-                return;
-            this.#clickEditor(event.row, event.col);
-            return;
-        }
-        if (event.wheel === null)
-            return;
-        const dir = event.wheel;
-        if (this.#prompt !== null) {
-            this.#handlePrompt({ type: 'key', id: dir < 0 ? 'up' : 'down' });
-            return;
-        }
-        if (this.#settings !== null) {
-            this.#applySettings({ type: 'key', id: dir < 0 ? 'up' : 'down' });
-            return;
-        }
-        if (this.#copySelector !== null) {
-            this.#applyCopySelector({ type: 'key', id: dir < 0 ? 'up' : 'down' });
-            return;
-        }
-        if (this.#search !== null) {
-            this.#applySearch({ type: 'key', id: dir < 0 ? 'up' : 'down' });
-            return;
-        }
-        if (this.#ac !== null) {
-            this.#moveAutocomplete(dir);
-            this.#render();
-            return;
-        }
-        this.#scrollBy(dir < 0 ? -TRANSCRIPT_WHEEL_SCROLL : TRANSCRIPT_WHEEL_SCROLL, true);
+    #openInspect(id) {
+        for (const listener of this.#inspects)
+            listener(id);
     }
-    #clickChrome(row) {
-        const hit = this.#chromeHit;
-        if (hit === undefined || hit === null)
+    #handleSubagentLauncher(event) {
+        const hasAgents = (this.#subagents?.agents.length ?? 0) > 0;
+        if (this.#subagentLauncherFocused) {
+            if (!hasAgents) {
+                this.#subagentLauncherFocused = false;
+                return false;
+            }
+            if (event.type === 'key' && event.id === 'enter') {
+                this.#subagentLauncherFocused = false;
+                void this.#pickSubagent();
+                return true;
+            }
+            if (event.type === 'key' && (event.id === 'escape' || event.id === 'up')) {
+                this.#subagentLauncherFocused = false;
+                this.#render();
+                return true;
+            }
+            if (event.type === 'key' && event.id === 'down')
+                return true;
+            this.#subagentLauncherFocused = false;
             return false;
-        const inspect = hit.inspect;
-        if (inspect !== undefined && row >= inspect.start && row < inspect.start + inspect.rows) {
-            this.#closeInspect();
-            return true;
         }
-        const roster = hit.subagents;
-        if (roster === undefined)
+        if (!hasAgents || event.type !== 'key' || event.id !== 'down')
             return false;
-        const localRow = row - roster.start;
-        if (localRow < 0 || localRow >= roster.rows)
+        if (this.#editor.text !== '' || this.#images.length > 0 || this.#historyIndex !== 0 || this.#ac !== null)
             return false;
-        if (localRow < roster.headerRows) {
-            void this.#pickSubagent();
-            return true;
-        }
-        const id = hitTestSubagentRoster(roster.items, localRow);
-        if (id === undefined)
-            return true;
-        if (this.#inspected?.id === id)
-            this.#closeInspect();
-        else
-            this.#openInspect(id);
+        if (this.#queuedSubmissions.length > 0 || this.#queueEditNewer !== null || this.#queueEditPending)
+            return false;
+        this.#subagentLauncherFocused = true;
+        this.#render();
         return true;
     }
-    #openInspect(id) {
-        for (const listener of this.#inspects)
-            listener(id);
-    }
     #closeInspect() {
         if (this.#inspected === undefined)
             return;
@@ -1336,6 +1392,7 @@ export class LocalTui {
             listener();
     }
     async #pickSubagent() {
+        this.#subagentLauncherFocused = false;
         const agents = this.#subagents?.agents ?? [];
         if (agents.length === 0) {
             this.notice('No subagents are available in this session.');
@@ -1343,7 +1400,7 @@ export class LocalTui {
         }
         const initialValue = this.#inspected?.id ?? agents[0]?.id;
         const answer = await this.prompt({
-            title: 'Agents',
+            title: 'Agent Hub',
             question: 'Open a subagent transcript',
             options: agents.map(agent => ({
                 label: agent.label,
@@ -1352,93 +1409,14 @@ export class LocalTui {
             })),
             ...(initialValue === undefined ? {} : { initialValue }),
             allowCustom: false,
-            ...(agents.length > 8 ? { presentation: 'fullscreen-list', filterable: true } : {}),
+            presentation: 'fullscreen-list',
+            filterable: true,
             submitLabel: 'open',
         });
         if (answer === null || answer === '')
             return;
         this.#openInspect(answer);
     }
-    #clickOverlay(row) {
-        const hit = this.#overlayHit;
-        if (hit === null)
-            return false;
-        const localRow = row - hit.start;
-        if (hit.kind === 'settings' && this.#settings !== null) {
-            const index = hitTestSettings(hit.itemRows ?? tuiSettingItems(this.#settings.prefs).length, localRow);
-            if (index === undefined)
-                return true;
-            if (index === this.#settings.selected) {
-                this.#applySettings({ type: 'key', id: 'enter' });
-            }
-            else {
-                this.#settings = selectSetting(this.#settings, index);
-                this.#render();
-            }
-            return true;
-        }
-        if (hit.kind === 'copy' && this.#copySelector !== null) {
-            const index = hitTestCopySelector(this.#copySelector.items.length, this.#copySelector.selected, localRow);
-            if (index === undefined)
-                return true;
-            if (index === this.#copySelector.selected) {
-                this.#applyCopySelector({ type: 'key', id: 'enter' });
-            }
-            else {
-                this.#copySelector = selectCopyTarget(this.#copySelector, index);
-                this.#render();
-            }
-            return true;
-        }
-        if (hit.kind === 'autocomplete' && this.#ac !== null) {
-            const index = hitTestAutocomplete(this.#ac.items.length, this.#ac.selected, localRow);
-            if (index === undefined)
-                return true;
-            this.#ac = { ...this.#ac, selected: index };
-            this.#applySelectedCompletion();
-            this.#render();
-            return true;
-        }
-        if (hit.kind === 'search' && this.#search !== null) {
-            const index = hitTestHistorySearch(this.#search.results.length, this.#search.selected, localRow, hit.resultsRow ?? 0);
-            if (index === undefined)
-                return true;
-            this.#search = { ...this.#search, selected: index };
-            this.#applySearch({ type: 'key', id: 'enter' });
-            return true;
-        }
-        if (hit.kind === 'prompt' && this.#prompt !== null) {
-            const index = hit.itemRows?.[localRow];
-            if (index === undefined)
-                return true;
-            if (index === this.#prompt.selected) {
-                this.#finishPrompt(selectedFilteredPromptAnswer(this.#prompt, this.#editor.text));
-                this.#editor.setText('');
-            }
-            else {
-                this.#prompt = { ...this.#prompt, selected: index };
-            }
-            this.#render();
-            return true;
-        }
-        return false;
-    }
-    #clickEditor(row, col) {
-        if (this.#settings !== null || this.#copySelector !== null || this.#search !== null)
-            return;
-        const hit = this.#editorHit;
-        if (hit === null)
-            return;
-        const localRow = row - hit.start;
-        if (localRow < 0 || localRow >= hit.rows)
-            return;
-        const index = hitTestEditor(this.#editor.text, this.#term.width(), localRow, col);
-        if (index === undefined)
-            return;
-        this.#editor.setCursor(index);
-        this.#refreshAutocomplete();
-        this.#render();
-    }
     #prefs() {
         return {
             theme: this.#themeName,
@@ -1603,10 +1581,20 @@ export class LocalTui {
             force: forcePath,
         };
         const token = findPathToken(this.#editor.text, this.#editor.cursor, forcePath);
-        const atPrefix = token?.kind === 'at' ? parsePathPrefix(token.prefix).raw.replaceAll('\\', '/') : '';
-        const fuzzyAt = token?.kind === 'at' && atPrefix !== '' && !atPrefix.endsWith('/');
-        if (fuzzyAt) {
-            this.#ac = null;
+        const { line, col } = editorLineAt(this.#editor.text, this.#editor.cursor);
+        const at = forcePath ? undefined : activeAtToken(line, col);
+        const atPrefix = at?.query.replaceAll('\\', '/')
+            ?? (token?.kind === 'at' ? parsePathPrefix(token.prefix).raw.replaceAll('\\', '/') : '');
+        const fuzzyAt = (at !== undefined || token?.kind === 'at') && atPrefix !== '' && !atPrefix.endsWith('/');
+        const harnessAt = at !== undefined
+            && (this.#searchFileMentions !== undefined || this.#searchSessions !== undefined);
+        if (fuzzyAt || harnessAt) {
+            if (harnessAt && !fuzzyAt) {
+                this.#setAutocomplete(pathSuggestions(this.#editor.text, this.#editor.cursor, pathOptions, commands));
+            }
+            else {
+                this.#ac = null;
+            }
             const text = this.#editor.text;
             const cursor = this.#editor.cursor;
             this.#autocompleteTimer = setTimeout(() => {
@@ -1615,11 +1603,20 @@ export class LocalTui {
                     return;
                 const controller = new AbortController();
                 this.#autocompleteAbort = controller;
-                void searchPathSuggestions(text, cursor, {
-                    ...pathOptions,
-                    searchFiles: this.#searchFiles,
-                    signal: controller.signal,
-                }, commands).then((result) => {
+                const search = this.#searchFileMentions === undefined && this.#searchSessions === undefined
+                    ? searchPathSuggestions(text, cursor, {
+                        ...pathOptions,
+                        searchFiles: this.#searchFiles,
+                        signal: controller.signal,
+                    }, commands)
+                    : searchAtSuggestions(text, cursor, {
+                        ...pathOptions,
+                        searchFiles: this.#searchFiles,
+                        ...(this.#searchFileMentions === undefined ? {} : { searchFileMentions: this.#searchFileMentions }),
+                        ...(this.#searchSessions === undefined ? {} : { searchSessions: this.#searchSessions }),
+                        signal: controller.signal,
+                    }, commands);
+                void search.then((result) => {
                     if (this.#disposed || controller.signal.aborted || requestId !== this.#autocompleteRequestId)
                         return;
                     this.#autocompleteAbort = null;
@@ -1645,9 +1642,9 @@ export class LocalTui {
             return;
         }
         const prev = this.#ac?.items[this.#ac.selected]?.value;
-        let selected = 0;
+        let selected = nextSelectableAutocompleteIndex(result.items, 0, 1);
         if (prev !== undefined) {
-            const idx = result.items.findIndex((item) => item.value === prev);
+            const idx = result.items.findIndex((item) => item.value === prev && item.kind !== 'heading');
             if (idx >= 0)
                 selected = idx;
         }
@@ -1656,14 +1653,16 @@ export class LocalTui {
     #moveAutocomplete(dir) {
         if (this.#ac === null || this.#ac.items.length === 0)
             return;
-        const n = this.#ac.items.length;
-        this.#ac = { ...this.#ac, selected: (this.#ac.selected + dir + n) % n };
+        this.#ac = {
+            ...this.#ac,
+            selected: nextSelectableAutocompleteIndex(this.#ac.items, this.#ac.selected + dir, dir),
+        };
     }
     #applySelectedCompletion() {
         const item = this.#ac?.items[this.#ac.selected];
-        if (item === undefined)
+        if (item === undefined || item.kind === 'heading')
             return;
-        const next = item.kind === 'path'
+        const next = item.kind === 'path' || item.kind === 'session'
             ? applyPathCompletion(this.#editor.text, this.#editor.cursor, item)
             : applySlashCompletion(this.#editor.text, this.#editor.cursor, item);
         this.#editor.setText(next.text, next.cursor);
@@ -1730,7 +1729,6 @@ export class LocalTui {
         }
         if (command.kind === 'resetDisplay') {
             this.#renderer.reset();
-            this.#term.output.write('\x1b[2J\x1b[H');
             this.#render();
         }
     }
@@ -1812,7 +1810,7 @@ export class LocalTui {
         const images = this.#images.map(image => ({ ...image }));
         const submittedText = images.length > 0 ? text.trim() : text;
         const queueEditNewer = this.#queueEditNewer;
-        const historyText = images.reduce((value, image, index) => value.replaceAll(imageMarker(index, image), ''), submittedText)
+        const historyText = stripComposerImageMarkers(submittedText, images)
             .replace(/[ \t]{2,}/gu, ' ')
             .trim();
         if (historyText !== '' && this.#history[this.#history.length - 1] !== historyText) {
@@ -1830,6 +1828,9 @@ export class LocalTui {
         this.#settings = null;
         this.#copySelector = null;
         this.#followTail();
+        // Image placeholders are TUI-owned. Mixed image+slash drafts stay a
+        // submission so restore can keep the original markers; the runner strips
+        // them only to detect and execute Harness commands.
         const slash = images.length === 0 ? parseSlashInput(submittedText) : null;
         if (slash !== null) {
             if (queueEditNewer !== null)
@@ -1856,7 +1857,7 @@ export class LocalTui {
     #submitInspect(text) {
         const images = this.#images.map(image => ({ ...image }));
         const submittedText = images.length > 0 ? text.trim() : text;
-        const historyText = images.reduce((value, image, index) => value.replaceAll(imageMarker(index, image), ''), submittedText)
+        const historyText = stripComposerImageMarkers(submittedText, images)
             .replace(/[ \t]{2,}/gu, ' ')
             .trim();
         if (historyText !== '' && this.#history[this.#history.length - 1] !== historyText) {
@@ -1902,6 +1903,7 @@ export class LocalTui {
         if (command.name === 'clear') {
             this.#state = initialTranscript();
             this.#followTail();
+            this.#renderer.startEpoch();
             this.#render();
             return;
         }
@@ -2076,7 +2078,6 @@ export class LocalTui {
         finally {
             this.#term.input.setRawMode?.(true);
             this.#renderer.reset();
-            this.#term.output.write('\x1b[2J\x1b[H');
             this.#refreshAutocomplete();
             this.#render();
         }
@@ -2089,6 +2090,7 @@ export class LocalTui {
  */
 export function apply(ctx, config) {
     const dshHome = process.env.OMDSH_HOME ?? process.env.DSH_HOME ?? join(homedir(), '.dsh');
+    const terminalProfile = detectTerminalProfile();
     const term = {
         output: process.stdout,
         input: process.stdin,
@@ -2100,6 +2102,9 @@ export function apply(ctx, config) {
         },
     };
     const tui = new LocalTui(term, config.model, config.colors ?? term.output.isTTY === true, parseThemeName(config.theme), copyToClipboard, {
+        deferInitialRender: true,
+        terminalProfile,
+        alternateScreenOverlays: terminalProfile === 'direct',
         historyPath: config.historyPath ?? join(dshHome, 'omdsh', 'history.jsonl'),
         keybindingsPath: config.keybindingsPath ?? join(dshHome, 'omdsh', 'keybindings.json'),
     });