@sagmans/dsh-tui 0.1.0

package/lib/ui/dock.js

@@ -0,0 +1,110 @@
+import { truncateToWidth } from '@earendil-works/pi-tui';
+import { DOCK_JOB_LIMIT, describeJob, isLive } from "../jobs.js";
+import { DOCK_SUBAGENT_LIMIT, describeSubagent } from "../subagents.js";
+import { displayText } from "../text.js";
+/** Todo rows the dock keeps on screen; the rest become a count. */
+export const DOCK_TODO_LIMIT = 4;
+const TODO_GLYPHS = {
+    pending: '☐',
+    in_progress: '▸',
+    completed: '☑',
+};
+/** What the reader most needs to see first: work in flight, then work left. */
+function orderTodos(todos) {
+    const rank = { in_progress: 0, pending: 1, completed: 2 };
+    return [...todos].sort((left, right) => rank[left.status] - rank[right.status]);
+}
+/**
+ * The dock above the editor: what the agent is working on right now.
+ *
+ * It renders nothing when there is nothing to say, so a plain conversation
+ * keeps its rows for the conversation.
+ */
+export class WorkDock {
+    state;
+    theme;
+    jobs;
+    subagents;
+    now;
+    constructor(state, theme, 
+    /** Live background jobs: process state, not something a resume can replay. */
+    jobs = () => [], 
+    /** Delegations this session started; also live state. */
+    subagents = () => [], 
+    /** Clock for elapsed times, so a frame can be pinned in a test. */
+    now = () => Date.now()) {
+        this.state = state;
+        this.theme = theme;
+        this.jobs = jobs;
+        this.subagents = subagents;
+        this.now = now;
+    }
+    invalidate() {
+        // The fold is the only state; nothing is cached.
+    }
+    pushTodos(lines, todos, width) {
+        const done = todos.filter(todo => todo.status === 'completed').length;
+        lines.push(this.theme.bold(truncateToWidth(`☰ todos ${done}/${todos.length} done`, width, '…')));
+        const ordered = orderTodos(todos);
+        for (const todo of ordered.slice(0, DOCK_TODO_LIMIT)) {
+            lines.push(this.theme.dim(truncateToWidth(`  ${TODO_GLYPHS[todo.status]} ${displayText(todo.content)}`, width, '…')));
+        }
+        if (ordered.length > DOCK_TODO_LIMIT) {
+            lines.push(this.theme.dim(truncateToWidth(`  … ${ordered.length - DOCK_TODO_LIMIT} more`, width, '…')));
+        }
+    }
+    pushSubagents(lines, runs, width) {
+        const running = runs.filter(run => run.status === 'running').length;
+        lines.push(this.theme.bold(truncateToWidth(`⚇ subagents · ${running} running, ${runs.length - running} done`, width, '…')));
+        const now = this.now();
+        for (const run of runs.slice(0, DOCK_SUBAGENT_LIMIT)) {
+            const glyph = run.status === 'running' ? '▸' : run.status === 'completed' ? '✓' : '✗';
+            lines.push(this.theme.dim(truncateToWidth(`  ${glyph} ${displayText(describeSubagent(run, now))}`, width, '…')));
+        }
+        if (runs.length > DOCK_SUBAGENT_LIMIT) {
+            lines.push(this.theme.dim(truncateToWidth(`  … ${runs.length - DOCK_SUBAGENT_LIMIT} more`, width, '…')));
+        }
+    }
+    pushJobs(lines, jobs, width) {
+        const live = jobs.filter(job => isLive(job.status)).length;
+        lines.push(this.theme.bold(truncateToWidth(`⛭ jobs · ${live} running, ${jobs.length - live} done`, width, '…')));
+        // Work still holding resources first, then the most recent.
+        const ordered = [...jobs].sort((left, right) => Number(isLive(right.status)) - Number(isLive(left.status)) || right.startedAt - left.startedAt);
+        const now = this.now();
+        for (const job of ordered.slice(0, DOCK_JOB_LIMIT)) {
+            const glyph = isLive(job.status) ? '▸' : job.status === 'completed' ? '✓' : '✗';
+            lines.push(this.theme.dim(truncateToWidth(`  ${glyph} ${displayText(describeJob(job, now))}`, width, '…')));
+        }
+        if (ordered.length > DOCK_JOB_LIMIT) {
+            lines.push(this.theme.dim(truncateToWidth(`  … ${ordered.length - DOCK_JOB_LIMIT} more`, width, '…')));
+        }
+    }
+    render(width) {
+        if (width <= 0)
+            return [];
+        const state = this.state();
+        const lines = [];
+        if (state.goal !== undefined) {
+            const rounds = state.goal.maxRounds === undefined
+                ? `round ${state.goal.roundsStarted}`
+                : `round ${state.goal.roundsStarted}/${state.goal.maxRounds}`;
+            // The row itself decides where a long objective ends, so the reader
+            // always sees that something was left out.
+            const objective = state.goal.objective.replace(/\s+/gu, ' ');
+            lines.push(this.theme.bold(truncateToWidth(`◎ goal ${rounds} · ${displayText(objective)}`, width, '…')));
+        }
+        if (state.planMode) {
+            lines.push(this.theme.bold(truncateToWidth('⏸ plan mode · answer the plan before edits happen', width, '…')));
+        }
+        const subagents = this.subagents();
+        if (subagents.length > 0)
+            this.pushSubagents(lines, subagents, width);
+        const jobs = this.jobs();
+        if (jobs.length > 0)
+            this.pushJobs(lines, jobs, width);
+        if (state.todos !== undefined)
+            this.pushTodos(lines, state.todos, width);
+        return lines;
+    }
+}
+//# sourceMappingURL=dock.js.map

package/lib/ui/dock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dock.js","sourceRoot":"","sources":["../../src/ui/dock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAmB,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAoB,MAAM,iBAAiB,CAAA;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAIxC,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC,MAAM,WAAW,GAAkD;IACjE,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,GAAG;CACf,CAAA;AAED,+EAA+E;AAC/E,SAAS,UAAU,CAAC,KAA2B;IAC7C,MAAM,IAAI,GAAwC,EAAE,WAAW,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAA;IAC9F,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,QAAQ;IAEA;IACA;IAEA;IAEA;IAEA;IARnB,YACmB,KAAsB,EACtB,KAAe;IAChC,8EAA8E;IAC7D,OAAoC,GAAG,EAAE,CAAC,EAAE;IAC7D,yDAAyD;IACxC,YAA0C,GAAG,EAAE,CAAC,EAAE;IACnE,mEAAmE;IAClD,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QAPpC,UAAK,GAAL,KAAK,CAAiB;QACtB,UAAK,GAAL,KAAK,CAAU;QAEf,SAAI,GAAJ,IAAI,CAAwC;QAE5C,cAAS,GAAT,SAAS,CAAyC;QAElD,QAAG,GAAH,GAAG,CAAiC;IACpD,CAAC;IAEJ,UAAU;QACR,iDAAiD;IACnD,CAAC;IAEO,SAAS,CAAC,KAAe,EAAE,KAA2B,EAAE,KAAa;QAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAA;QACrE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,IAAI,IAAI,KAAK,CAAC,MAAM,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAChG,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QACjC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,EAAE,CAAC;YACrD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QACvH,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,GAAG,eAAe,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QACzG,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,IAA4B,EAAE,KAAa;QAChF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAA;QACnE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,iBAAiB,OAAO,aAAa,IAAI,CAAC,MAAM,GAAG,OAAO,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC3H,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YACrF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,KAAK,IAAI,WAAW,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAClH,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,mBAAmB,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,IAAI,CAAC,MAAM,GAAG,mBAAmB,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC1G,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,KAAe,EAAE,IAA2B,EAAE,KAAa;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;QAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,IAAI,aAAa,IAAI,CAAC,MAAM,GAAG,IAAI,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAChH,4DAA4D;QAC5D,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC7C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;QACjG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;YAC/E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,KAAK,IAAI,WAAW,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC7G,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,OAAO,CAAC,MAAM,GAAG,cAAc,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QACxG,CAAC;IACH,CAAC;IAED,MAAM,CAAC,KAAa;QAClB,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,EAAE,CAAA;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1B,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS;gBAC/C,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE;gBACrC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;YAC/D,oEAAoE;YACpE,2CAA2C;YAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,MAAM,MAAM,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC1G,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,mDAAmD,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;QAC/G,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAA;QAClC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;QACrE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACtD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACxE,OAAO,KAAK,CAAA;IACd,CAAC;CACF"}

package/lib/ui/markdown.d.ts

@@ -0,0 +1,17 @@
+import { type MarkdownTheme } from '@earendil-works/pi-tui';
+/** Parsed messages kept for redraws; everything above this is cold transcript. */
+export declare const MARKDOWN_CACHE_LIMIT = 64;
+/**
+ * Render assistant text as markdown without reparsing the whole history.
+ *
+ * A repaint walks every row, so parsing each message again on every keystroke
+ * would make a long session crawl. Parsing is keyed by message text because
+ * that is what changes; the component re-renders on its own when the width does.
+ */
+export declare class MarkdownRenderer {
+    private readonly theme;
+    private readonly parsed;
+    constructor(theme: MarkdownTheme);
+    render(text: string, width: number): string[];
+}
+//# sourceMappingURL=markdown.d.ts.map

package/lib/ui/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/ui/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAErE,kFAAkF;AAClF,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;gBAExB,KAAK,EAAE,aAAa;IAEjD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAe9C"}

package/lib/ui/markdown.js

@@ -0,0 +1,35 @@
+import { Markdown } from '@earendil-works/pi-tui';
+/** Parsed messages kept for redraws; everything above this is cold transcript. */
+export const MARKDOWN_CACHE_LIMIT = 64;
+/**
+ * Render assistant text as markdown without reparsing the whole history.
+ *
+ * A repaint walks every row, so parsing each message again on every keystroke
+ * would make a long session crawl. Parsing is keyed by message text because
+ * that is what changes; the component re-renders on its own when the width does.
+ */
+export class MarkdownRenderer {
+    theme;
+    parsed = new Map();
+    constructor(theme) {
+        this.theme = theme;
+    }
+    render(text, width) {
+        let message = this.parsed.get(text);
+        if (message === undefined) {
+            if (this.parsed.size >= MARKDOWN_CACHE_LIMIT) {
+                const oldest = this.parsed.keys().next();
+                if (oldest.done !== true)
+                    this.parsed.delete(oldest.value);
+            }
+            message = new Markdown(text, 0, 0, this.theme);
+        }
+        else {
+            // Reinserting keeps a message that is still on screen from ageing out.
+            this.parsed.delete(text);
+        }
+        this.parsed.set(text, message);
+        return message.render(Math.max(1, Math.floor(width)));
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/lib/ui/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/ui/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,wBAAwB,CAAA;AAErE,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IAGE;IAFZ,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAA;IAErD,YAA6B,KAAoB;QAApB,UAAK,GAAL,KAAK,CAAe;IAAG,CAAC;IAErD,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,oBAAoB,EAAE,CAAC;gBAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;gBACxC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;oBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC5D,CAAC;YACD,OAAO,GAAG,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAChD,CAAC;aAAM,CAAC;YACN,uEAAuE;YACvE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACvD,CAAC;CACF"}

package/lib/ui/picker.d.ts

@@ -0,0 +1,103 @@
+import type { StoredSession } from '../agent/history.ts';
+import { type PresetSummary } from '../agent/presets.ts';
+/** One selectable row of the picker. */
+export interface PickerRow {
+    readonly label: string;
+    readonly description: string | undefined;
+    readonly current: boolean;
+}
+/** How the picker presents itself, independent of how it is drawn. */
+export interface PickerCard {
+    readonly title: string;
+    /** Why the last pick was refused, for as long as it stays the last thing asked. */
+    readonly note: string | undefined;
+    readonly rows: readonly PickerRow[];
+    readonly filter: string;
+    readonly hint: string;
+    /** Rows above the window, so the reader knows the list continues. */
+    readonly above: number;
+    /** Rows below the window. */
+    readonly below: number;
+}
+/** What one key press asked the picker to do. */
+export type PickerAction = {
+    readonly kind: 'pick';
+    readonly id: string;
+} | {
+    readonly kind: 'cancel';
+};
+/**
+ * Rows the picker shows at once.
+ *
+ * The card is drawn at the end of a viewport that follows the transcript, so a
+ * list taller than the screen would push its own cursor out of sight. The
+ * window stays around the cursor instead, and the counts say what is hidden.
+ */
+export declare const PICKER_WINDOW = 12;
+/** The hint lines a list uses when it is empty and when it holds rows. */
+export interface PickerHints {
+    readonly empty: string;
+    readonly listed: string;
+}
+/** Human age of a session, so a list of ids becomes a list of moments. */
+export declare function describeAge(createdAt: number, now: number): string;
+/**
+ * A filtered list the reader moves through by key.
+ *
+ * The list is the caller's and is re-read on every key and paint, so rows whose
+ * text arrives late — a session title read from its log, a roster re-read after
+ * a preset was authored — appear without rebuilding the picker. Windowing,
+ * filtering, and the keys are the same whatever the rows mean, which is why
+ * they live here once instead of in every list a terminal has to choose from.
+ */
+export declare class ListPicker<Row> {
+    private readonly source;
+    private readonly heading;
+    /** The value a pick settles on. */
+    private readonly idOf;
+    private readonly describe;
+    /** Extra text the filter matches besides the row's own label. */
+    private readonly haystackOf;
+    private readonly hints;
+    private cursor;
+    private filter;
+    private note;
+    constructor(source: () => readonly Row[], heading: () => string, 
+    /** The value a pick settles on. */
+    idOf: (row: Row) => string, describe: (row: Row) => PickerRow, 
+    /** Extra text the filter matches besides the row's own label. */
+    haystackOf: (row: Row) => string, hints: PickerHints);
+    /** Rows matching the typed filter, in the order they were listed. */
+    visible(): readonly Row[];
+    /**
+     * Say why the row under the cursor cannot be taken.
+     *
+     * Cleared by the next key press, because it explains one refusal rather than
+     * describing the list: a note that outlived it would read as a property of
+     * whatever the reader moved to.
+     */
+    setNote(text: string | undefined): void;
+    /** Apply one key press; returns an action only when the picker settles. */
+    handleKey(data: string): PickerAction | undefined;
+    card(): PickerCard;
+}
+/**
+ * One stored session chosen by key press.
+ *
+ * The picker owns only what it shows: ids and rows come from the caller, and
+ * the titles arrive after the list does, because reading every log before the
+ * first paint would make opening the picker as slow as the slowest session.
+ */
+export declare class SessionPicker extends ListPicker<StoredSession> {
+    constructor(sessions: readonly StoredSession[], titles: () => ReadonlyMap<string, string>, now?: () => number);
+}
+/**
+ * One agent preset chosen by key press.
+ *
+ * The roster is re-read on every paint, so a preset authored or deleted while
+ * the picker is open is present or gone without reopening it.
+ */
+export declare class PresetPicker extends ListPicker<PresetSummary> {
+    constructor(presets: () => readonly PresetSummary[], currentId: () => string | undefined);
+}
+//# sourceMappingURL=picker.d.ts.map

package/lib/ui/picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.d.ts","sourceRoot":"","sources":["../../src/ui/picker.ts"],"names":[],"mappings":"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"}

package/lib/ui/picker.js

@@ -0,0 +1,165 @@
+import { matchesKey } from '@earendil-works/pi-tui';
+import { describePreset } from "../agent/presets.js";
+/**
+ * Rows the picker shows at once.
+ *
+ * The card is drawn at the end of a viewport that follows the transcript, so a
+ * list taller than the screen would push its own cursor out of sight. The
+ * window stays around the cursor instead, and the counts say what is hidden.
+ */
+export const PICKER_WINDOW = 12;
+const MINUTE_MS = 60_000;
+const HOUR_MS = 60 * MINUTE_MS;
+const DAY_MS = 24 * HOUR_MS;
+/** Human age of a session, so a list of ids becomes a list of moments. */
+export function describeAge(createdAt, now) {
+    const elapsed = Math.max(0, now - createdAt);
+    if (elapsed < MINUTE_MS)
+        return 'just now';
+    if (elapsed < HOUR_MS)
+        return `${Math.floor(elapsed / MINUTE_MS)}m ago`;
+    if (elapsed < DAY_MS)
+        return `${Math.floor(elapsed / HOUR_MS)}h ago`;
+    return `${Math.floor(elapsed / DAY_MS)}d ago`;
+}
+/**
+ * A filtered list the reader moves through by key.
+ *
+ * The list is the caller's and is re-read on every key and paint, so rows whose
+ * text arrives late — a session title read from its log, a roster re-read after
+ * a preset was authored — appear without rebuilding the picker. Windowing,
+ * filtering, and the keys are the same whatever the rows mean, which is why
+ * they live here once instead of in every list a terminal has to choose from.
+ */
+export class ListPicker {
+    source;
+    heading;
+    idOf;
+    describe;
+    haystackOf;
+    hints;
+    cursor = 0;
+    filter = '';
+    note;
+    constructor(source, heading, 
+    /** The value a pick settles on. */
+    idOf, describe, 
+    /** Extra text the filter matches besides the row's own label. */
+    haystackOf, hints) {
+        this.source = source;
+        this.heading = heading;
+        this.idOf = idOf;
+        this.describe = describe;
+        this.haystackOf = haystackOf;
+        this.hints = hints;
+    }
+    /** Rows matching the typed filter, in the order they were listed. */
+    visible() {
+        const needle = this.filter.trim().toLowerCase();
+        if (needle === '')
+            return this.source();
+        return this.source().filter(row => this.haystackOf(row).toLowerCase().includes(needle));
+    }
+    /**
+     * Say why the row under the cursor cannot be taken.
+     *
+     * Cleared by the next key press, because it explains one refusal rather than
+     * describing the list: a note that outlived it would read as a property of
+     * whatever the reader moved to.
+     */
+    setNote(text) {
+        this.note = text;
+    }
+    /** Apply one key press; returns an action only when the picker settles. */
+    handleKey(data) {
+        this.note = undefined;
+        const rows = this.visible();
+        if (matchesKey(data, 'escape'))
+            return { kind: 'cancel' };
+        if (matchesKey(data, 'enter')) {
+            const chosen = rows[Math.min(this.cursor, Math.max(0, rows.length - 1))];
+            return chosen === undefined ? undefined : { kind: 'pick', id: this.idOf(chosen) };
+        }
+        if (matchesKey(data, 'up')) {
+            this.cursor = Math.max(0, this.cursor - 1);
+            return undefined;
+        }
+        if (matchesKey(data, 'down')) {
+            this.cursor = Math.min(Math.max(0, rows.length - 1), this.cursor + 1);
+            return undefined;
+        }
+        if (matchesKey(data, 'backspace')) {
+            this.filter = this.filter.slice(0, -1);
+            this.cursor = 0;
+            return undefined;
+        }
+        if (matchesKey(data, 'space')) {
+            this.filter += ' ';
+            this.cursor = 0;
+            return undefined;
+        }
+        if (data.length === 1 && data >= ' ') {
+            this.filter += data;
+            this.cursor = 0;
+        }
+        return undefined;
+    }
+    card() {
+        const rows = this.visible();
+        const cursor = Math.min(this.cursor, Math.max(0, rows.length - 1));
+        const start = Math.max(0, Math.min(cursor - Math.floor(PICKER_WINDOW / 2), rows.length - PICKER_WINDOW));
+        const window = rows.slice(start, start + PICKER_WINDOW);
+        return {
+            title: this.heading(),
+            note: this.note,
+            rows: window.map((row, index) => ({
+                ...this.describe(row),
+                current: start + index === cursor,
+            })),
+            above: start,
+            below: Math.max(0, rows.length - start - window.length),
+            filter: this.filter,
+            hint: rows.length === 0 ? this.hints.empty : this.hints.listed,
+        };
+    }
+}
+/**
+ * One stored session chosen by key press.
+ *
+ * The picker owns only what it shows: ids and rows come from the caller, and
+ * the titles arrive after the list does, because reading every log before the
+ * first paint would make opening the picker as slow as the slowest session.
+ */
+export class SessionPicker extends ListPicker {
+    constructor(sessions, titles, now = () => Date.now()) {
+        const labelOf = (session) => titles().get(session.id) ?? session.id;
+        super(() => sessions, () => `resume a session · ${sessions.length} stored`, session => session.id, session => ({
+            label: labelOf(session),
+            description: [
+                session.cwd ?? 'unknown directory',
+                describeAge(session.createdAt, now()),
+                ...session.eventCount === undefined ? [] : [`${session.eventCount} events`],
+            ].join(' · '),
+            // The card marks the row under the cursor, which the list decides.
+            current: false,
+        }), session => [labelOf(session), session.id, session.cwd ?? ''].join(' '), {
+            empty: 'nothing matches · backspace to widen · esc cancel',
+            listed: '↑↓ move · enter open · esc cancel · type to filter',
+        });
+    }
+}
+/**
+ * One agent preset chosen by key press.
+ *
+ * The roster is re-read on every paint, so a preset authored or deleted while
+ * the picker is open is present or gone without reopening it.
+ */
+export class PresetPicker extends ListPicker {
+    constructor(presets, currentId) {
+        super(presets, () => `agent preset · ${presets().length} available`, preset => preset.id, preset => describePreset(preset, currentId()), preset => [preset.id, preset.name ?? '', preset.description ?? ''].join(' '), {
+            empty: 'nothing matches · backspace to widen · esc cancel',
+            listed: '↑↓ move · enter switch · esc cancel · type to filter',
+        });
+    }
+}
+//# sourceMappingURL=picker.js.map

package/lib/ui/picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"picker.js","sourceRoot":"","sources":["../../src/ui/picker.ts"],"names":[],"mappings":"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"}

package/lib/ui/rows.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Rendered transcript rows, kept per entry.
+ *
+ * A repaint walks the whole transcript, and wrapping text is the expensive part
+ * of doing that: without a cache, a session with a few thousand rows re-wraps
+ * all of them on every keystroke. Entries are stable objects, so their rows can
+ * be keyed by identity and only rebuilt when the width or the reader's
+ * expansion state changes.
+ */
+/** Entries kept before the oldest are re-rendered on demand. */
+export declare const ROW_CACHE_LIMIT = 4000;
+/** What the cache has done, so a test can assert the work was actually avoided. */
+export interface RowCacheStats {
+    readonly hits: number;
+    readonly misses: number;
+    readonly size: number;
+}
+export declare class RowCache<K extends object = object> {
+    private readonly limit;
+    private readonly rows;
+    private hits;
+    private misses;
+    constructor(limit?: number);
+    /** The rows for a key and tag, or nothing when they have to be rebuilt. */
+    lookup(key: K, tag: string): readonly string[] | undefined;
+    store(key: K, tag: string, lines: readonly string[]): void;
+    clear(): void;
+    stats(): RowCacheStats;
+}
+//# sourceMappingURL=rows.d.ts.map

package/lib/ui/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/ui/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gEAAgE;AAChE,eAAO,MAAM,eAAe,OAAQ,CAAA;AAOpC,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAKjC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,MAAM,CAAI;gBAEW,KAAK,GAAE,MAAwB;IAE5D,2EAA2E;IAC3E,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS;IAa1D,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAS1D,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,aAAa;CAGvB"}

package/lib/ui/rows.js

@@ -0,0 +1,49 @@
+/**
+ * Rendered transcript rows, kept per entry.
+ *
+ * A repaint walks the whole transcript, and wrapping text is the expensive part
+ * of doing that: without a cache, a session with a few thousand rows re-wraps
+ * all of them on every keystroke. Entries are stable objects, so their rows can
+ * be keyed by identity and only rebuilt when the width or the reader's
+ * expansion state changes.
+ */
+/** Entries kept before the oldest are re-rendered on demand. */
+export const ROW_CACHE_LIMIT = 4_000;
+export class RowCache {
+    limit;
+    rows = new Map();
+    hits = 0;
+    misses = 0;
+    constructor(limit = ROW_CACHE_LIMIT) {
+        this.limit = limit;
+    }
+    /** The rows for a key and tag, or nothing when they have to be rebuilt. */
+    lookup(key, tag) {
+        const cached = this.rows.get(key);
+        if (cached === undefined || cached.tag !== tag) {
+            this.misses += 1;
+            return undefined;
+        }
+        this.hits += 1;
+        // Reinserting keeps a row that is still on screen from ageing out.
+        this.rows.delete(key);
+        this.rows.set(key, cached);
+        return cached.lines;
+    }
+    store(key, tag, lines) {
+        this.rows.set(key, { tag, lines });
+        while (this.rows.size > this.limit) {
+            const oldest = this.rows.keys().next();
+            if (oldest.done === true)
+                return;
+            this.rows.delete(oldest.value);
+        }
+    }
+    clear() {
+        this.rows.clear();
+    }
+    stats() {
+        return { hits: this.hits, misses: this.misses, size: this.rows.size };
+    }
+}
+//# sourceMappingURL=rows.js.map

package/lib/ui/rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../src/ui/rows.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAA;AAcpC,MAAM,OAAO,QAAQ;IAKU;IAJZ,IAAI,GAAG,IAAI,GAAG,EAAiB,CAAA;IACxC,IAAI,GAAG,CAAC,CAAA;IACR,MAAM,GAAG,CAAC,CAAA;IAElB,YAA6B,QAAgB,eAAe;QAA/B,UAAK,GAAL,KAAK,CAA0B;IAAG,CAAC;IAEhE,2EAA2E;IAC3E,MAAM,CAAC,GAAM,EAAE,GAAW;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,IAAI,CAAC,CAAA;YAChB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,CAAC,CAAA;QACd,mEAAmE;QACnE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACrB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAC1B,OAAO,MAAM,CAAC,KAAK,CAAA;IACrB,CAAC;IAED,KAAK,CAAC,GAAM,EAAE,GAAW,EAAE,KAAwB;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAA;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAA;YACtC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAM;YAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAChC,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;IAED,KAAK;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IACvE,CAAC;CACF"}

package/lib/ui/status.d.ts

@@ -0,0 +1,49 @@
+import { type Component } from '@earendil-works/pi-tui';
+import type { TuiTheme } from '../theme.ts';
+/** Everything the footer states, gathered by the surface around it. */
+export interface StatusFacts {
+    readonly activity: 'idle' | 'working';
+    /** How long the running turn has been running, when one is. */
+    readonly elapsedMs: number | undefined;
+    readonly provider: string | undefined;
+    readonly model: string | undefined;
+    readonly effort: string | undefined;
+    /** The agent preset (mode) the session runs; fixed once it has a turn. */
+    readonly agentPreset: string | undefined;
+    /** The permission preset, which is a sandbox policy and a different thing. */
+    readonly preset: string | undefined;
+    readonly contextTokens: number | undefined;
+    readonly contextWindow: number | undefined;
+    /** Share of prompt tokens served from the provider's cache, 0–1. */
+    readonly cacheRate: number | undefined;
+    /** Prompt tokens the provider did not have cached, when it reported any. */
+    readonly uncachedInputTokens: number | undefined;
+    /** Tokens this session has generated, when the provider reported any. */
+    readonly outputTokens: number | undefined;
+    readonly cwd: string;
+    readonly home: string | undefined;
+}
+/** Compact a token count, because the exact number changes nothing a reader decides. */
+export declare function formatTokens(count: number): string;
+/**
+ * Shorten an absolute path for the footer: the reader's own home becomes `~`,
+ * and only a path from outside it is cut down to its tail.
+ *
+ * A home path keeps every directory between `~` and the leaf. Dropping those
+ * away would name a location that does not exist, which is worse than a long one.
+ */
+export declare function shortPath(path: string, home: string | undefined): string;
+/**
+ * One line of state, ordered by what a reader asks first: is it working, what is
+ * it, how full is the context, and where am I.
+ */
+export declare function formatStatus(facts: StatusFacts, width: number, theme: TuiTheme): string;
+/** A one-row view of the state around the transcript. */
+export declare class StatusBar implements Component {
+    private readonly facts;
+    private readonly theme;
+    constructor(facts: () => StatusFacts, theme: TuiTheme);
+    invalidate(): void;
+    render(width: number): string[];
+}
+//# sourceMappingURL=status.d.ts.map

package/lib/ui/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/ui/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,wBAAwB,CAAA;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;IAChD,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC;AAUD,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQxE;AAOD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAuBvF;AAED,yDAAyD;AACzD,qBAAa,SAAU,YAAW,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,KAAK,EAAE,MAAM,WAAW,EACxB,KAAK,EAAE,QAAQ;IAGlC,UAAU,IAAI,IAAI;IAIlB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAGhC"}