@esso0428/pi-subagents 0.16.0 → 0.17.0

package/dist/ui/agent-widget.d.ts.map

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

package/dist/ui/agent-widget.js

@@ -4,7 +4,7 @@
  * Displays a tree of agents with animated spinners, live stats, and activity descriptions.
  * Uses the callback form of setWidget for themed rendering.
  */
-import { truncateToWidth } from "@earendil-works/pi-tui";
+import { Editor, isKeyRelease, Key, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
 import { getConfig } from "../agent-types.js";
 import { getLifetimeTotal, getSessionContextPercent } from "../usage.js";
 // ---- Constants ----
@@ -155,13 +155,17 @@ export class AgentWidget {
     manager;
     agentActivity;
     mode;
+    options;
     uiCtx;
     widgetFrame = 0;
     widgetInterval;
-    /** Tracks how many turns each finished agent has survived. Key: agent ID, Value: turns since finished. */
-    finishedTurnAge = new Map();
-    /** How many extra turns errors/aborted agents linger (completed agents clear after 1 turn). */
-    static ERROR_LINGER_TURNS = 2;
+    inputUnsub;
+    /** Whether arrow keys currently navigate the agent roster. */
+    navigationActive = false;
+    /** Stable identity of the selected row, so roster changes do not jump selection. */
+    selectedAgentId;
+    /** First logical row currently represented by the bounded viewport. */
+    viewportStart = 0;
     /** Whether the widget callback is currently registered with the TUI. */
     widgetRegistered = false;
     /** Cached TUI reference from widget factory callback, used for requestRender(). */
@@ -171,15 +175,15 @@ export class AgentWidget {
     /** Snapshot of the state used for the last widget registration/render request. */
     lastRenderKey;
     constructor(manager, agentActivity, 
-    /**
-     * Read live at render time. Selects which agents the widget shows — see
-     * `WidgetMode`. Defaults to `"all"` when a caller supplies no policy; the
-     * extension supplies one defaulting to `"background"`.
-     */
-    mode = () => "all") {
+    /** Read live at render time. Selects which agents the widget shows. */
+    mode = () => "all", options = {
+        canOpenHistory: (record) => record.session !== undefined || record.completedAt !== undefined,
+        onOpen: () => { },
+    }) {
         this.manager = manager;
         this.agentActivity = agentActivity;
         this.mode = mode;
+        this.options = options;
     }
     /**
      * Agents eligible for the widget, per the current `WidgetMode`:
@@ -204,13 +208,23 @@ export class AgentWidget {
     setUICtx(ctx) {
         if (ctx === this.uiCtx)
             return false;
-        // UICtx changed — the widget registered on the old context is gone.
-        // Force re-registration on next update().
+        // UICtx changed — the widget and input handler registered on the old
+        // context are gone. Re-register both on the next update().
+        this.inputUnsub?.();
+        this.inputUnsub = undefined;
         this.uiCtx = ctx;
         this.widgetRegistered = false;
         this.tui = undefined;
         this.lastStatusText = undefined;
         this.lastRenderKey = undefined;
+        this.navigationActive = false;
+        this.selectedAgentId = undefined;
+        this.viewportStart = 0;
+        // Print/RPC tests and lightweight embedders may provide only the widget
+        // surface; real interactive contexts always implement this hook.
+        if (typeof ctx.onTerminalInput === "function") {
+            this.inputUnsub = ctx.onTerminalInput(data => this.handleKey(data));
+        }
         return true;
     }
     /** Request a render on the currently registered TUI without touching input. */
@@ -220,16 +234,8 @@ export class AgentWidget {
         this.tui.requestRender(force);
         return true;
     }
-    /**
-     * Called on each new turn (tool_execution_start).
-     * Ages finished agents and clears those that have lingered long enough.
-     */
+    /** Called on each new turn (tool_execution_start). */
     onTurnStart() {
-        // Age all finished agents
-        for (const [id, age] of this.finishedTurnAge) {
-            this.finishedTurnAge.set(id, age + 1);
-        }
-        // Trigger a widget refresh (will filter out expired agents)
         this.update();
     }
     /** Keep the spinner/elapsed-time timer alive only while a visible agent runs. */
@@ -237,7 +243,7 @@ export class AgentWidget {
         if (!this.uiCtx || !this.widgetAgents().some(a => a.status === "running"))
             return;
         if (!this.widgetInterval) {
-            this.widgetInterval = setInterval(() => this.update(true), 80);
+            this.widgetInterval = setInterval(() => this.update(true), 250);
         }
     }
     syncTimer(shouldRun) {
@@ -249,17 +255,111 @@ export class AgentWidget {
             this.widgetInterval = undefined;
         }
     }
-    /** Check if a finished agent should still be shown in the widget. */
-    shouldShowFinished(agentId, status) {
-        const age = this.finishedTurnAge.get(agentId) ?? 0;
-        const maxAge = ERROR_STATUSES.has(status) ? AgentWidget.ERROR_LINGER_TURNS : 1;
-        return age < maxAge;
+    /**
+     * Retained for the lifecycle call sites. Terminal visibility is determined
+     * by the manager record and the history capability, not a one-turn timer.
+     */
+    markFinished(_agentId) { }
+    /**
+     * Records represented by selectable rows in the above-editor widget.
+     *
+     * Keep this order as the single source of truth for both rendering and key
+     * navigation. `listAgents()` is newest-first; active rows come first so the
+     * panel exposes currently useful work before terminal history.
+     */
+    roster() {
+        const agents = this.widgetAgents();
+        const finished = agents.filter(record => record.status !== "running" && record.status !== "queued"
+            && record.completedAt !== undefined
+            && this.options.canOpenHistory(record));
+        const running = agents.filter(record => record.status === "running");
+        const queued = agents.filter(record => record.status === "queued");
+        return [...running, ...queued, ...finished];
+    }
+    /** True when pi's prompt editor owns the keyboard. */
+    editorHasFocus() {
+        const focused = this.tui?.focusedComponent;
+        return focused == null || focused instanceof Editor;
+    }
+    selectedIndexOf(records) {
+        if (!this.selectedAgentId)
+            return -1;
+        return records.findIndex(record => record.id === this.selectedAgentId);
+    }
+    deactivate() {
+        this.navigationActive = false;
+        this.selectedAgentId = undefined;
+        this.viewportStart = 0;
+        this.update();
+    }
+    /** Move the selected row, activating only from an empty focused editor. */
+    moveSelection(direction) {
+        const records = this.roster();
+        const ui = this.uiCtx;
+        if (records.length === 0 || !ui)
+            return false;
+        if (!this.navigationActive) {
+            if (direction !== 1 || !this.editorHasFocus() || (ui.getEditorText?.() ?? "") !== "")
+                return false;
+            this.navigationActive = true;
+            this.selectedAgentId = records[0].id;
+            this.viewportStart = 0;
+            this.update();
+            return true;
+        }
+        const currentIndex = Math.max(0, this.selectedIndexOf(records));
+        if (direction === -1 && currentIndex === 0) {
+            this.deactivate();
+            return true;
+        }
+        const nextIndex = Math.max(0, Math.min(records.length - 1, currentIndex + direction));
+        this.selectedAgentId = records[nextIndex].id;
+        this.update();
+        return true;
+    }
+    openSelected() {
+        const record = this.roster().find(candidate => candidate.id === this.selectedAgentId);
+        this.deactivate();
+        if (!record)
+            return;
+        const mode = record.status === "running" || record.status === "queued" ? "live" : "history";
+        void this.options.onOpen(record, mode);
     }
-    /** Record an agent as finished (call when agent completes). */
-    markFinished(agentId) {
-        if (!this.finishedTurnAge.has(agentId)) {
-            this.finishedTurnAge.set(agentId, 0);
+    /** Handle terminal input before it reaches the focused prompt editor. */
+    handleKey(data) {
+        if (!this.uiCtx || isKeyRelease(data))
+            return undefined;
+        if (!this.editorHasFocus()) {
+            if (this.navigationActive)
+                this.deactivate();
+            return undefined;
+        }
+        if (!this.navigationActive) {
+            if (!matchesKey(data, "down") || (this.uiCtx.getEditorText?.() ?? "") !== "" || this.roster().length === 0) {
+                return undefined;
+            }
+            this.navigationActive = true;
+            this.selectedAgentId = this.roster()[0]?.id;
+            this.viewportStart = 0;
+            this.update();
+            return { consume: true };
+        }
+        if (matchesKey(data, "escape")) {
+            this.deactivate();
+            return { consume: true };
         }
+        if (matchesKey(data, "up"))
+            return this.moveSelection(-1) ? { consume: true } : undefined;
+        if (matchesKey(data, "down"))
+            return this.moveSelection(1) ? { consume: true } : undefined;
+        if (matchesKey(data, Key.enter)) {
+            this.openSelected();
+            return { consume: true };
+        }
+        // Only ↑/↓ navigate. Other keys, including j/k/←/→, flow to the editor
+        // and leave navigation mode.
+        this.deactivate();
+        return undefined;
     }
     /** Render a finished agent line. */
     renderFinishedLine(a, theme) {
@@ -308,8 +408,9 @@ export class AgentWidget {
         const allAgents = this.widgetAgents();
         const running = allAgents.filter(a => a.status === "running");
         const queued = allAgents.filter(a => a.status === "queued");
-        const finished = allAgents.filter(a => a.status !== "running" && a.status !== "queued" && a.completedAt
-            && this.shouldShowFinished(a.id, a.status));
+        const finished = allAgents.filter(a => a.status !== "running" && a.status !== "queued" && a.completedAt !== undefined
+            && this.options.canOpenHistory(a));
+        const selectedId = this.navigationActive ? this.selectedAgentId : undefined;
         const hasActive = running.length > 0 || queued.length > 0;
         const hasFinished = finished.length > 0;
         // Nothing to show — return empty (widget will be unregistered by update())
@@ -327,7 +428,11 @@ export class AgentWidget {
         // Each running agent = 2 lines (header + activity), finished = 1 line, queued = 1 line.
         const finishedLines = [];
         for (const a of finished) {
-            finishedLines.push(truncate(theme.fg("dim", "├─") + " " + this.renderFinishedLine(a, theme)));
+            const marker = a.id === selectedId ? theme.fg("accent", "●") : theme.fg("dim", "○");
+            finishedLines.push({
+                record: a,
+                lines: [truncate(theme.fg("dim", "├─") + ` ${marker} ` + this.renderFinishedLine(a, theme))],
+            });
         }
         const runningLines = []; // each entry is [header, activity]
         for (const a of running) {
@@ -350,92 +455,99 @@ export class AgentWidget {
             parts.push(elapsed);
             const statsText = parts.join(" · ");
             const activity = bg ? describeActivity(bg.activeTools, bg.responseText) : "thinking…";
-            runningLines.push([
-                truncate(theme.fg("dim", "├─") + ` ${theme.fg("accent", frame)} ${theme.bold(name)}${modeTag}  ${theme.fg("muted", truncateLine(a.description))} ${theme.fg("dim", "·")} ${fgPreservingNestedStyles(theme, "dim", statsText)}`),
-                truncate(theme.fg("dim", "│  ") + theme.fg("dim", `  ⎿  ${activity}`)),
-            ]);
-        }
-        const queuedLine = queued.length > 0
-            ? truncate(theme.fg("dim", "├─") + ` ${theme.fg("muted", "◦")} ${theme.fg("dim", `${queued.length} queued`)}`)
-            : undefined;
+            const marker = a.id === selectedId ? theme.fg("accent", "●") : theme.fg("dim", "○");
+            runningLines.push({
+                record: a,
+                lines: [
+                    truncate(theme.fg("dim", "├─") + ` ${marker} ${theme.fg("accent", frame)} ${theme.bold(name)}${modeTag}  ${theme.fg("muted", truncateLine(a.description))} ${theme.fg("dim", "·")} ${fgPreservingNestedStyles(theme, "dim", statsText)}`),
+                    truncate(theme.fg("dim", "│  ") + `   ${theme.fg("dim", `⎿  ${activity}`)}`),
+                ],
+            });
+        }
+        const queuedLines = queued.map(a => {
+            const marker = a.id === selectedId ? theme.fg("accent", "●") : theme.fg("dim", "○");
+            return {
+                record: a,
+                lines: [truncate(theme.fg("dim", "├─") + ` ${marker} ${theme.fg("muted", "◦")} ${theme.fg("dim", `${getDisplayName(a.type)}  ${truncateLine(a.description)} · queued`)}`)],
+            };
+        });
         // Assemble with a responsive cap (heading + overflow indicator = 2
         // reserved lines when content exceeds the available body budget).
         const maxBody = maxLines - 1; // heading takes 1 line
-        const totalBody = finishedLines.length + runningLines.length * 2 + (queuedLine ? 1 : 0);
-        const lines = [truncate(theme.fg(headingColor, headingIcon) + " " + theme.fg(headingColor, "Agents"))];
+        const rows = [...runningLines, ...queuedLines, ...finishedLines];
+        const totalBody = rows.reduce((total, row) => total + row.lines.length, 0);
+        const heading = "Agents  ↑↓ select · enter view · esc back";
+        const lines = [truncate(theme.fg(headingColor, headingIcon) + " " + theme.fg(headingColor, heading))];
         if (maxLines === 1) {
             // There is room only for the heading; do not consume the editor/input row.
             return lines;
         }
         if (totalBody <= maxBody) {
-            // Everything fits — add all lines and fix up connectors for the last item.
-            lines.push(...finishedLines);
-            for (const pair of runningLines)
-                lines.push(...pair);
-            if (queuedLine)
-                lines.push(queuedLine);
-            // Fix last connector: swap ├─ → └─ and │ → space for activity lines.
-            if (lines.length > 1) {
-                const last = lines.length - 1;
-                lines[last] = lines[last].replace("├─", "└─");
-                // If last item is a running agent activity line, fix indent of that line
-                // and fix the header line above it.
-                if (runningLines.length > 0 && !queuedLine) {
-                    // The last two lines are the last running agent's header + activity.
-                    if (last >= 2) {
-                        lines[last - 1] = lines[last - 1].replace("├─", "└─");
-                        lines[last] = lines[last].replace("│  ", "   ");
-                    }
+            this.viewportStart = 0;
+            for (const row of rows)
+                lines.push(...row.lines);
+            if (rows.length > 0) {
+                const lastRow = rows[rows.length - 1];
+                const lastStart = lines.length - lastRow.lines.length;
+                lines[lastStart] = lines[lastStart].replace("├─", "└─");
+                if (lastRow.lines.length === 2) {
+                    lines[lastStart + 1] = lines[lastStart + 1].replace("│  ", "   ");
                 }
             }
         }
         else {
-            // Overflow — prioritize: running > queued > finished.
-            // Reserve 1 line for overflow indicator.
-            let budget = maxBody - 1;
-            let hiddenRunning = 0;
-            let hiddenQueued = 0;
-            let hiddenFinished = 0;
-            // 1. Running agents (2 lines each)
-            for (const pair of runningLines) {
-                if (budget >= 2) {
-                    lines.push(...pair);
-                    budget -= 2;
-                }
-                else {
-                    hiddenRunning++;
+            // Reserve one line for a directional overflow summary. The viewport is
+            // a contiguous slice in roster order, so the same slice is navigable and
+            // renderable even when the selected row is currently hidden.
+            const contentBudget = Math.max(0, maxBody - 1);
+            const heightAt = (index) => rows[index]?.lines.length ?? 0;
+            const endFor = (start) => {
+                let used = 0;
+                let end = start;
+                while (end < rows.length && used + heightAt(end) <= contentBudget) {
+                    used += heightAt(end++);
                 }
+                return end;
+            };
+            let start = Math.max(0, Math.min(this.viewportStart, Math.max(0, rows.length - 1)));
+            const selectedIndex = this.navigationActive && selectedId
+                ? rows.findIndex(row => row.record.id === selectedId)
+                : -1;
+            if (selectedIndex >= 0) {
+                if (selectedIndex < start)
+                    start = selectedIndex;
+                if (selectedIndex >= endFor(start))
+                    start = selectedIndex;
             }
-            // 2. Queued line
-            if (queuedLine) {
-                if (budget >= 1) {
-                    lines.push(queuedLine);
-                    budget--;
-                }
-                else {
-                    hiddenQueued = 1;
-                }
+            this.viewportStart = start;
+            let used = 0;
+            let end = start;
+            while (end < rows.length && used + heightAt(end) <= contentBudget) {
+                lines.push(...rows[end].lines);
+                used += heightAt(end);
+                end++;
             }
-            // 3. Finished agents
-            for (const fl of finishedLines) {
-                if (budget >= 1) {
-                    lines.push(fl);
-                    budget--;
-                }
-                else {
-                    hiddenFinished++;
-                }
+            // A selected two-line row must remain addressable even if only one body
+            // line is available. Showing its header is preferable to hiding it.
+            if (end === start && rows[start] && contentBudget > 0) {
+                lines.push(rows[start].lines[0]);
+                end = start + 1;
             }
-            // Overflow summary
-            const overflowParts = [];
-            if (hiddenRunning > 0)
-                overflowParts.push(`${hiddenRunning} running`);
-            if (hiddenQueued > 0)
-                overflowParts.push(`${hiddenQueued} queued`);
-            if (hiddenFinished > 0)
-                overflowParts.push(`${hiddenFinished} finished`);
-            const overflowText = overflowParts.join(", ");
-            lines.push(truncate(theme.fg("dim", "└─") + ` ${theme.fg("dim", `+${hiddenRunning + hiddenQueued + hiddenFinished} more (${overflowText})`)}`));
+            const hiddenBefore = start;
+            const hiddenAfter = Math.max(0, rows.length - end);
+            const hidden = hiddenBefore + hiddenAfter;
+            const hiddenRows = rows.filter((_row, index) => index < start || index >= end);
+            const categoryCounts = [
+                ["running", hiddenRows.filter(row => row.record.status === "running").length],
+                ["queued", hiddenRows.filter(row => row.record.status === "queued").length],
+                ["finished", hiddenRows.filter(row => row.record.status !== "running" && row.record.status !== "queued").length],
+            ].filter(([, count]) => count > 0).map(([label, count]) => `${count} ${label}`);
+            const direction = [
+                ...(hiddenBefore > 0 ? [`↑ ${hiddenBefore} more`] : []),
+                ...(hiddenAfter > 0 ? [`↓ ${hiddenAfter} more`] : []),
+            ].join(" · ");
+            const summary = `+${hidden} more (${direction}${categoryCounts.length > 0 ? `; ${categoryCounts.join(", ")}` : ""})`;
+            lines.push(truncate(theme.fg("dim", "└─") + ` ${theme.fg("dim", summary)}`));
         }
         return lines;
     }
@@ -468,9 +580,14 @@ export class AgentWidget {
                 lifetimeUsage: a.lifetimeUsage,
                 compactionCount: a.compactionCount,
                 isBackground: a.isBackground,
+                hasSession: a.session !== undefined,
+                transcriptPath: a.transcriptPath,
+                openableHistory: this.options.canOpenHistory(a),
             })),
             activities,
-            finishedTurnAge: [...this.finishedTurnAge.entries()],
+            navigationActive: this.navigationActive,
+            selectedAgentId: this.selectedAgentId,
+            viewportStart: this.viewportStart,
         });
     }
     /** Force an immediate widget update. `advanceSpinner` is reserved for the timer. */
@@ -478,21 +595,17 @@ export class AgentWidget {
         if (!this.uiCtx)
             return;
         const allAgents = this.widgetAgents();
+        const roster = this.roster();
         // Lightweight existence checks — full categorization happens in renderWidget()
         let runningCount = 0;
         let queuedCount = 0;
-        let hasFinished = false;
-        for (const a of allAgents) {
-            if (a.status === "running") {
+        for (const a of roster) {
+            if (a.status === "running")
                 runningCount++;
-            }
-            else if (a.status === "queued") {
+            else if (a.status === "queued")
                 queuedCount++;
-            }
-            else if (a.completedAt && this.shouldShowFinished(a.id, a.status)) {
-                hasFinished = true;
-            }
         }
+        const hasFinished = roster.some(a => a.status !== "running" && a.status !== "queued");
         const hasActive = runningCount > 0 || queuedCount > 0;
         // Nothing to show — clear widget
         if (!hasActive && !hasFinished) {
@@ -506,12 +619,10 @@ export class AgentWidget {
                 this.lastStatusText = undefined;
             }
             this.lastRenderKey = undefined;
+            this.navigationActive = false;
+            this.selectedAgentId = undefined;
+            this.viewportStart = 0;
             this.syncTimer(false);
-            // Clean up stale entries
-            for (const [id] of this.finishedTurnAge) {
-                if (!allAgents.some(a => a.id === id))
-                    this.finishedTurnAge.delete(id);
-            }
             return;
         }
         // Status bar — only call setStatus when the text actually changes
@@ -535,6 +646,16 @@ export class AgentWidget {
         if (advanceSpinner && runningCount > 0)
             this.widgetFrame++;
         this.syncTimer(runningCount > 0);
+        if (this.navigationActive) {
+            if (roster.length === 0) {
+                this.navigationActive = false;
+                this.selectedAgentId = undefined;
+                this.viewportStart = 0;
+            }
+            else if (this.selectedIndexOf(roster) < 0) {
+                this.selectedAgentId = roster[Math.min(this.viewportStart, roster.length - 1)].id;
+            }
+        }
         const renderKey = this.renderKey(allAgents);
         // Register widget callback once; subsequent updates use requestRender()
         // which re-invokes render() without replacing the component (avoids layout thrashing).
@@ -569,12 +690,16 @@ export class AgentWidget {
             this.uiCtx.setWidget("agents", undefined);
             this.uiCtx.setStatus("subagents", undefined);
         }
+        this.inputUnsub?.();
+        this.inputUnsub = undefined;
         this.widgetRegistered = false;
         this.tui = undefined;
         this.lastStatusText = undefined;
         this.lastRenderKey = undefined;
+        this.navigationActive = false;
+        this.selectedAgentId = undefined;
+        this.viewportStart = 0;
         this.uiCtx = undefined;
-        this.finishedTurnAge.clear();
     }
 }
 //# sourceMappingURL=agent-widget.js.map