@higherdev/cli 0.16.0 → 0.18.0

package/dist/tui/Panels.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text } from "ink";
-import { BOARD_COLUMNS, statusLabel, statusTone, } from "./data.js";
+import { Text } from "ink";
+import { BOARD_COLUMNS, decisionOptions, statusLabel, statusTone, } from "./data.js";
 import { elapsed, pad, relativeTime, truncate } from "../out/format.js";
 import { inkColor } from "../out/theme.js";
 import { UI } from "./theme.js";
@@ -8,6 +8,8 @@ import { BoundedPanel as Panel, Heading, More, contentRows } from "./bounded.js"
 import { scrollWindow } from "./Dashboard.js";
 import { agentDisplayRows } from "./agent-rows.js";
 import { inboxHeader } from "./inbox.js";
+import { DECISION_CURSOR, decisionIdAt } from "./decide-nav.js";
+import { ticketScrollOffset, ticketViewLines } from "./ticket-view.js";
 const DOT = "●";
 /**
  * The single-purpose views behind /board, /agents, /feed and /inbox. Each is
@@ -26,8 +28,10 @@ export function AgentsPanel({ board, width = 80, rows = 12, }) {
                 ]
                 : []),
             ...shown.map((row) => {
-                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" ? "warning" : "muted";
-                const state = row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state;
+                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" || row.state === "draining"
+                    ? "warning" : "muted";
+                const state = row.state === "draining" ? ""
+                    : row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state;
                 return (_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsx(Text, { color: UI.text, children: pad(truncate(row.name, 13), 14) }), _jsx(Text, { color: UI.dim, children: pad(row.agent?.role ?? row.run?.kind ?? "", 13) }), _jsx(Text, { color: UI.dim, children: pad(truncate(row.agent?.model ?? "", 23), 24) }), _jsx(Text, { color: UI.text, children: pad(state, row.limitedUntil ? 22 : 9) }), _jsxs(Text, { color: UI.dim, children: [row.ticket ? `${row.ticket.key} ` : "", row.run ? elapsed(row.run.started_at ?? row.run.created_at) : ""] })] }, row.key));
             }),
             _jsx(More, { count: displayRows.length - shown.length }, "more"),
@@ -85,10 +89,11 @@ export function FeedPanel({ entries, width = 80, rows = 12, }) {
  * The whole queue, one row each, numbered the way `/decide` reaches them: the
  * one on screen is 1.
  */
-export function InboxPanel({ board, width = 80, rows = 12, focus = 0, }) {
-    const entries = inboxEntries(board, width);
+export function InboxPanel({ board, width = 80, rows = 12, focus = 0, selectedId = null, answeringId = null, }) {
+    const entries = inboxEntries(board, width, answeringId);
     const unread = board.messages ?? [];
     const earlier = board.earlier ?? [];
+    const selected = selectedId ?? decisionIdAt(entries, focus);
     const inner = Math.max(0, rows - 1);
     const window = scrollWindow(entries.length, inner, focus);
     const hiddenAbove = window.start;
@@ -103,11 +108,16 @@ export function InboxPanel({ board, width = 80, rows = 12, focus = 0, }) {
                     _jsx(Text, { color: UI.dim, children: "Nothing waiting on you." }, "empty"),
                 ]
                 : []),
-            ...entries.slice(window.start, window.end).map((entry, index) => (_jsx(Text, { color: entry.kind === "body" ? UI.text : UI.warn, wrap: "truncate", inverse: window.start + index === focus, children: entry.kind === "body" ? `  ${entry.text}` : entry.text }, entry.key))),
+            ...entries.slice(window.start, window.end).map((entry, index) => {
+                const cursor = Boolean(entry.kind === "header" && entry.decisionId && entry.decisionId === selected);
+                const color = entry.kind === "option" ? UI.accent : entry.kind === "body" ? UI.text : UI.warn;
+                const prefix = entry.kind === "body" || entry.kind === "option" ? "  " : cursor ? `${DECISION_CURSOR} ` : entry.decisionId ? "  " : "";
+                return (_jsxs(Text, { color: color, wrap: "truncate", inverse: cursor, children: [prefix, entry.text] }, entry.key));
+            }),
         ] }));
 }
 /** Every physical line in /inbox, with decision and message bodies wrapped but never clipped. */
-export function inboxEntries(board, width) {
+export function inboxEntries(board, width, answeringId) {
     const entries = [];
     const bodyWidth = Math.max(12, width - 2);
     const unread = board.messages ?? [];
@@ -117,11 +127,28 @@ export function inboxEntries(board, width) {
         entries.push({
             key: `${decision.id}:header`,
             kind: "header",
+            decisionId: decision.id,
             text: `${index + 1}) ${ticket?.key ?? decision.id.slice(0, 8)}`,
         });
         wrapLines(decision.question_md.trim(), bodyWidth).forEach((text, line) => {
-            entries.push({ key: `${decision.id}:body:${line}`, kind: "body", text });
+            entries.push({ key: `${decision.id}:body:${line}`, kind: "body", decisionId: decision.id, text });
         });
+        if (answeringId === decision.id) {
+            decisionOptions(decision).forEach((option, optionIndex) => {
+                entries.push({
+                    key: `${decision.id}:option:${optionIndex}`,
+                    kind: "option",
+                    decisionId: decision.id,
+                    text: `${optionIndex + 1}) ${option}`,
+                });
+            });
+            entries.push({
+                key: `${decision.id}:prompt`,
+                kind: "body",
+                decisionId: decision.id,
+                text: "Type a number or your answer. Esc cancels.",
+            });
+        }
     });
     entries.push({ key: "unread:section", kind: "section", text: "Unread" });
     if (unread.length === 0) {
@@ -191,28 +218,19 @@ function wrapLines(text, width) {
  * rows nothing had budgeted, and a frame past the window is one Ink stops
  * repainting in place.
  */
-export function TicketPanel({ ticket, width = 80, rows = 24, }) {
-    const lines = [
-        _jsxs(Text, { color: UI.text, bold: true, wrap: "truncate", children: [ticket.key, " ", ticket.title] }, "title"),
-        _jsxs(Box, { flexWrap: "nowrap", children: [_jsx(Text, { color: inkColor(statusTone(ticket.status)), wrap: "truncate", children: statusLabel(ticket.status) }), _jsxs(Text, { color: UI.dim, wrap: "truncate", children: [ticket.area ? `  ${ticket.area}` : "", ticket.agent_name ? `  ${ticket.agent_name}` : "  unassigned", ticket.attempts ? `  attempt ${ticket.attempts}` : ""] })] }, "status"),
-    ];
-    if (ticket.stuck) {
-        lines.push(_jsxs(Text, { color: UI.warn, wrap: "truncate", children: ["why: ", ticket.stuck] }, "stuck"));
-    }
-    if (ticket.blocker_keys.length) {
-        lines.push(_jsxs(Text, { color: UI.dim, wrap: "truncate", children: ["blocked by ", ticket.blocker_keys.join(", ")] }, "blocked"));
-    }
-    if (ticket.pr_url) {
-        lines.push(_jsx(Text, { color: UI.accent, wrap: "truncate", children: ticket.pr_url }, "pr"));
-    }
-    // The blank row before the body comes out of the body's own allowance.
+export function TicketPanel({ ticket, width = 80, rows = 24, offset = 0, collapsed = [], }) {
+    const entries = ticketViewLines(ticket, Math.max(20, width), collapsed);
     const drawable = Math.max(0, rows);
-    const body = clipToRows(ticket.body_md.trim(), Math.max(20, width), Math.max(0, drawable - lines.length - 1));
-    if (body) {
-        lines.push(_jsx(Box, { height: 1 }, "gap"));
-        lines.push(_jsx(Text, { color: UI.text, wrap: "wrap", children: body }, "body"));
-    }
-    return (_jsx(Panel, { width: width, rows: drawable, children: lines }));
+    const overflow = entries.length > drawable;
+    const inner = overflow ? Math.max(0, drawable - 1) : drawable;
+    const start = ticketScrollOffset(entries.length, inner, offset);
+    const shown = entries.slice(start, start + inner);
+    const hiddenAbove = start;
+    const hiddenBelow = Math.max(0, entries.length - start - shown.length);
+    return (_jsx(Panel, { width: width, rows: drawable, children: [
+            ...shown.map((entry) => (_jsx(Text, { color: entry.kind === "section" ? UI.warn : UI.text, wrap: "truncate", children: entry.text }, entry.key))),
+            overflow ? (_jsxs(Text, { color: UI.dim, wrap: "truncate", children: [hiddenAbove ? `${hiddenAbove}↑ ` : "", hiddenBelow ? `${hiddenBelow}↓` : ""] }, "more")) : null,
+        ] }));
 }
 /**
  * Text cut to the rows it may occupy once wrapped.

package/dist/tui/TextInput.js

@@ -19,7 +19,7 @@ function printableOf(text) {
     // eslint-disable-next-line no-control-regex
     return text.replace(/[\x00-\x1f\x7f]/g, "");
 }
-export default function TextInput({ value, onChange, onSubmit, onCancel, onUp, onDown, isActive = true, placeholder = "", prompt, color, }) {
+export default function TextInput({ value, onChange, onSubmit, onCancel, onUp, onDown, onPageUp, onPageDown, isActive = true, placeholder = "", prompt, color, }) {
     const [cursor, setCursor] = useState(value.length);
     // The last value this component produced. Anything else arriving in `value`
     // was swapped in by the caller.
@@ -62,6 +62,10 @@ export default function TextInput({ value, onChange, onSubmit, onCancel, onUp, o
             return onUp?.();
         if (key.downArrow)
             return onDown?.();
+        if (key.pageUp)
+            return onPageUp?.();
+        if (key.pageDown)
+            return onPageDown?.();
         // A whole line and its Enter can arrive as a single chunk. Unbracketed
         // paste does it, and so does any link that buffers, which over ssh is
         // most of them. Ink reports that as ordinary input with key.return

package/dist/tui/agent-rows.js

@@ -1,3 +1,4 @@
+import { formatDrainStatus } from "../host.js";
 const LIMITED_UNTIL = /^(?:Waiting on )?(\w+) (?:limited )?until (\d{1,2}:\d{2})\.?$/;
 export function limitedUntilByProvider(tickets) {
     const limited = new Map();
@@ -22,7 +23,18 @@ function agentForRun(board, run) {
     return board.agents.find((agent) => agent.enabled && agent.role === role && agent.provider === run.provider) ?? null;
 }
 /** Expand live invocations into rows, then append enabled agents with no live run. */
-export function agentDisplayRows(board) {
+export function agentDisplayRows(board, now = Date.now()) {
+    const drain = board.hostDrain
+        ? [{
+                key: "drain",
+                name: formatDrainStatus(board.hostDrain.live, board.hostDrain.until, now),
+                agent: null,
+                run: null,
+                ticket: null,
+                state: "draining",
+                limitedUntil: null,
+            }]
+        : [];
     const activeAgents = new Set();
     const live = board.runs
         .filter((run) => run.status === "running" || run.status === "queued")
@@ -71,5 +83,5 @@ export function agentDisplayRows(board) {
             limitedUntil: until ?? null,
         };
     });
-    return [...live, ...idle];
+    return [...drain, ...live, ...idle];
 }

package/dist/tui/data.js

@@ -1,4 +1,4 @@
-import { approveEpic as approveEpicNow, answerDecision, cancelTicket as cancelTicketNow, createAgent as postAgent, createEpic as postEpic, deleteEpic as removeEpic, getStatus, getWorkspace, listAgents, listEpics, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage as sendMessage, queueTicket as queueTicketNow, setPaused as setPausedNow, showTicket, updateAgent as patchAgent, updateCaps, updateWorkspace as patchWorkspace, deleteAgent as removeAgent, } from "../api.js";
+import { approveEpic as approveEpicNow, answerDecision, cancelTicket as cancelTicketNow, createAgent as postAgent, createEpic as postEpic, deleteEpic as removeEpic, getStatus, getWorkspace, listAgents, listEpics, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage as sendMessage, queueTicket as queueTicketNow, setPaused as setPausedNow, showTicket, updateAgent as patchAgent, updateCaps, updateWorkspace as patchWorkspace, deleteAgent as removeAgent, } from "../api.js";
 import { loadConfig, switchWorkspace as selectWorkspace, } from "../config.js";
 import { readEpicSpec } from "../epics.js";
 import { EARLIER_PAGE } from "./inbox.js";
@@ -79,7 +79,8 @@ export async function loadSnapshot(config = loadConfig(), options = {}) {
             earlier: earlier.slice(0, earlierLimit),
             earlierHasMore: earlier.length > earlierLimit,
             availability,
-            runs: status.live_runs,
+            runs: status.recent_runs ?? status.live_runs,
+            hostDrain: status.host?.draining ?? null,
         },
         feed: feedData.entries,
     };
@@ -125,7 +126,18 @@ export async function postAgentMessage(role, body, config) {
     await sendMessage({ body_md: body, to_role: role, delivery: "queue" }, config);
 }
 export async function loadTicketDetail(config, key) {
-    return showTicket(key, config);
+    const { ticket, pr, events, runs, messages, decisions } = await showTicket(key, config);
+    return {
+        ticket: {
+            ...ticket,
+            stuck: ticket.stuck_reason,
+            pr,
+            timeline: events,
+            messages,
+            runs,
+            decisions,
+        },
+    };
 }
 export async function createEpicFromFile(config, path) {
     return postEpic(await readEpicSpec(path), config);
@@ -187,14 +199,16 @@ export async function updateWorkspace(config, fields) {
 }
 export async function loadLiveEvents(config, board, ticketKey) {
     if (ticketKey)
-        return (await listTicketEvents(ticketKey, undefined, undefined, config)).events
+        return (await listTicketRunEvents(ticketKey, undefined, undefined, config)).events
             .sort((left, right) => left.at.localeCompare(right.at) || left.seq - right.seq);
-    const liveIds = new Set(board.runs.filter((run) => run.status === "running").map((run) => run.id));
+    const now = Date.now();
+    const liveIds = new Set(board.runs.filter((run) => run.status === "running" || Boolean(run.ended_at)
+        && now - Date.parse(run.ended_at) <= 15 * 60_000).map((run) => run.id));
     const keys = new Set(board.runs
         .filter((run) => liveIds.has(run.id) && run.ticket_id)
         .map((run) => board.tickets.find((ticket) => ticket.id === run.ticket_id)?.key)
         .filter((key) => Boolean(key)));
-    const batches = await Promise.all([...keys].map((key) => listTicketEvents(key, undefined, undefined, config)));
+    const batches = await Promise.all([...keys].map((key) => listTicketRunEvents(key, undefined, undefined, config)));
     return batches
         .flatMap((batch) => batch.events)
         .filter((event) => liveIds.has(event.run_id))

package/dist/tui/decide-nav.js

@@ -0,0 +1,62 @@
+import { decisionOptions } from "./data.js";
+export const DECISION_CURSOR = "▶";
+export function decisionIdAt(entries, focus) {
+    if (!entries.length)
+        return null;
+    const start = Math.max(0, Math.min(focus, entries.length - 1));
+    for (let i = start; i >= 0; i -= 1) {
+        const entry = entries[i];
+        if (entry.kind === "section")
+            return null;
+        if (entry.decisionId)
+            return entry.decisionId;
+    }
+    return null;
+}
+export function decisionHeaderIndex(entries, decisionId) {
+    return entries.findIndex((entry) => entry.kind === "header" && entry.decisionId === decisionId);
+}
+export function moveDecisionFocus(entries, focus, delta) {
+    const headers = entries
+        .map((entry, index) => ({ entry, index }))
+        .filter((row) => row.entry.kind === "header" && row.entry.decisionId);
+    const currentId = decisionIdAt(entries, focus);
+    if (currentId && headers.length) {
+        const at = headers.findIndex((row) => row.entry.decisionId === currentId);
+        const next = at + delta;
+        if (next >= 0 && next < headers.length)
+            return headers[next].index;
+        if (next >= headers.length) {
+            const after = entries.findIndex((entry, index) => index > headers[headers.length - 1].index && entry.kind === "section");
+            return after >= 0 ? after : headers[headers.length - 1].index;
+        }
+        return headers[0].index;
+    }
+    const next = Math.max(0, Math.min(entries.length - 1, focus + delta));
+    if (delta < 0 && headers.length && decisionIdAt(entries, next)) {
+        return headers[headers.length - 1].index;
+    }
+    return next;
+}
+export function nextUnanswered(decisions, answeredId) {
+    const index = decisions.findIndex((decision) => decision.id === answeredId);
+    if (index < 0)
+        return decisions[0] ?? null;
+    return decisions[index + 1] ?? null;
+}
+export function resolveDecisionAnswer(decision, text) {
+    const trimmed = text.trim();
+    const options = decisionOptions(decision);
+    if (/^\d+$/.test(trimmed)) {
+        const option = options[Number(trimmed) - 1];
+        if (option)
+            return option;
+    }
+    return trimmed;
+}
+export function answeredLine(decisions, tickets, decision, answer) {
+    const number = decisions.findIndex((row) => row.id === decision.id) + 1;
+    const ticket = tickets.find((row) => row.id === decision.ticket_id);
+    const label = ticket?.key ?? decision.id.slice(0, 8);
+    return `Answered ${number}) ${label}: ${answer}`;
+}

package/dist/tui/narrate.js

@@ -0,0 +1,97 @@
+const record = (value) => value && typeof value === "object" && !Array.isArray(value)
+    ? value : {};
+const string = (value) => typeof value === "string" ? value : "";
+const clip = (value) => value.length > 60 ? `${value.slice(0, 57)}...` : value;
+const path = (value) => string(value).replace(/^.*\/[A-Z][A-Z0-9]*-\d+\//, "").replace(/^\.\//, "");
+const stat = (value) => value.additions != null || value.deletions != null
+    ? ` (+${Number(value.additions ?? 0)} -${Number(value.deletions ?? 0)})` : "";
+const shell = (value) => string(value).trim().replace(/^\/bin\/(?:ba)?sh -lc (["'])([\s\S]*)\1$/, "$2");
+const sha = (payload) => string(payload.aggregated_output || payload.output)
+    .match(/\b([0-9a-f]{7,40})\b/)?.[1] ?? "";
+function command(value, payload, status, lastSha = "") {
+    const cmd = shell(value);
+    const code = payload.exit_code ?? payload.exitCode;
+    const failed = status === "failed" || code != null && Number(code) !== 0;
+    const read = cmd.match(/(?:^|[;&|]\s*)(?:cat|head|tail)\s+(?:-[^\s]+\s+)*["']?([^\s;|&"']+)/)
+        ?? cmd.match(/(?:^|[;&|]\s*)sed\s+-n\s+["']?[^\s]+["']?\s+["']?([^\s;|&"']+)/);
+    if (read)
+        return status === "in_progress" ? null
+            : { kind: failed ? "error" : "tool", title: `Read ${path(read[1])}${failed ? " (failed)" : ""}` };
+    if (/(?:^|\s)git push(?:\s|$)/.test(cmd)) {
+        const branch = cmd.match(/git push(?:\s+--set-upstream|\s+-u)?\s+origin\s+([^\s;&]+)/)?.[1] ?? "remote";
+        const pushed = lastSha || sha(payload);
+        return status === "in_progress" ? null : failed ? { kind: "error", title: `Push to ${branch} failed` }
+            : { kind: "tool", title: `Pushed${pushed ? ` ${pushed.slice(0, 7)}` : ""} to ${branch}` };
+    }
+    const state = status === "in_progress" || code == null && status !== "completed" ? "running" : failed ? "failed" : "passed";
+    return { kind: state === "failed" ? "error" : "tool", title: `Ran \`${clip(cmd || "command")}\` (${state})` };
+}
+function assistant(payload) {
+    const item = record(payload.item);
+    const message = record(payload.message);
+    const direct = string(payload.text) || string(item.text) || string(payload.result);
+    return direct || (Array.isArray(message.content)
+        ? message.content.map((part) => string(record(part).text)).filter(Boolean).join("\n") : string(message.content));
+}
+function isJson(value) {
+    try {
+        JSON.parse(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function narrateEvents(events, raw = false) {
+    const lines = [];
+    let lastSha = "";
+    for (const event of events.slice().sort((a, b) => a.seq - b.seq)) {
+        const payload = record(event.payload);
+        const item = record(payload.item);
+        const itemType = string(item.type);
+        let made = [];
+        if (raw)
+            made = [{ kind: event.type === "error" ? "error" : "raw", title: JSON.stringify(event.payload) }];
+        else if (event.type === "error") {
+            const error = record(payload.error);
+            made = [{ kind: "error", title: string(error.message) || string(payload.error || payload.message) || "Run error" }];
+        }
+        else if (itemType === "command_execution") {
+            const line = command(item.command, item, item.status, lastSha);
+            if (line)
+                made = [line];
+        }
+        else if (itemType === "file_change" && item.status !== "in_progress") {
+            made = (Array.isArray(item.changes) ? item.changes.map(record) : [item])
+                .map((change) => ({ kind: "tool", title: `Edited ${path(change.path)}${stat(change)}` }));
+        }
+        else if (event.type === "tool_use") {
+            const input = record(payload.input ?? payload.args ?? payload);
+            const name = string(payload.name || payload.tool).toLowerCase();
+            if (name === "read")
+                made = [{ kind: "tool", title: `Read ${path(input.file_path || input.path)}` }];
+            else if (["edit", "write", "apply_patch"].includes(name))
+                made = [{ kind: "tool", title: `Edited ${path(input.file_path || input.path)}${stat(input)}` }];
+            else if (["bash", "shell", "exec_command"].includes(name) || input.command || input.cmd) {
+                const line = command(input.command || input.cmd, input, "in_progress", lastSha);
+                if (line)
+                    made = [line];
+            }
+        }
+        else if (event.type === "command") {
+            const line = command(payload.command || payload.cmd, payload, payload.status, lastSha);
+            if (line)
+                made = [line];
+        }
+        else if (event.type === "file_changed")
+            made = [{ kind: "tool", title: `Edited ${path(payload.path)}${stat(payload)}` }];
+        else if (event.type === "text") {
+            const text = assistant(payload);
+            if (text.trim() && !isJson(text))
+                made = [{ kind: "agent", title: text }];
+        }
+        made.forEach((line, index) => lines.push({ ...line, id: `${event.id}:${index}`, sourceId: event.id, at: event.at, seq: event.seq }));
+        lastSha = sha(item) || sha(payload) || lastSha;
+    }
+    return lines;
+}

package/dist/tui/parse.js

@@ -94,8 +94,11 @@ export function parseLine(raw) {
             return rest.length >= 2 ? { kind: "message", key: rest[0].toUpperCase(), text: rest.slice(1).join(" ") }
                 : { kind: "unknown", command: "msg needs KEY TEXT" };
         case "logs":
-            return rest.length <= 1 ? { kind: "logs", key: rest[0]?.toUpperCase() ?? null }
-                : { kind: "unknown", command: "logs takes one ticket key" };
+            if (rest[0]?.toLowerCase() === "raw" && rest.length <= 2) {
+                return { kind: "logs", key: rest[1]?.toUpperCase() ?? null, raw: true };
+            }
+            return rest.length <= 1 ? { kind: "logs", key: rest[0]?.toUpperCase() ?? null, raw: false }
+                : { kind: "unknown", command: "logs takes raw and an optional ticket key" };
         case "refresh":
             return { kind: "refresh" };
         case "exit":

package/dist/tui/stream.js

@@ -1,3 +1,4 @@
+import { narrateEvents } from "./narrate.js";
 /** How much of the stream is kept. Older lines have already scrolled past. */
 export const STREAM_LIMIT = 200;
 /**
@@ -5,31 +6,43 @@ export const STREAM_LIMIT = 200;
  * caller did not name are dropped, which is how another workspace's traffic
  * stays out of this one's stream.
  */
-export function toStreamLines(events, runs) {
+export function toStreamLines(events, runs, raw = false) {
     const lines = [];
-    for (const event of events) {
-        const run = runs.get(event.run_id);
-        if (!run)
-            continue;
+    for (const run of runs.values()) {
+        const target = run.ticket ? ` on ${run.ticket}` : "";
+        lines.push({ id: `${run.runId}:start`, sourceIds: [`${run.runId}:start`], runId: run.runId,
+            agent: run.agent, at: run.startedAt ?? "", seq: -1, kind: "status",
+            title: `${run.agent} started ${run.kind}${target} (attempt ${run.attempt})` });
+    }
+    for (const run of runs.values()) {
         // The id has to be a property of the event, not of the batch it arrived in.
         // Live delivery converts one row at a time and a backfill converts eighty,
         // so an id carrying a batch position would give the same event two ids and
         // defeat the dedupe below. One event can still produce several lines, which
         // is what the second half counts.
-        const produced = transcriptLines(event);
-        produced.forEach((line, index) => {
+        narrateEvents(events.filter((event) => event.run_id === run.runId), raw).forEach((line) => {
             lines.push({
-                id: `${event.id}:${index}`,
-                runId: event.run_id,
+                id: line.id,
+                sourceIds: [line.sourceId],
+                runId: run.runId,
                 agent: run.agent,
-                at: String(event.at),
-                seq: event.seq,
+                at: line.at,
+                seq: line.seq,
                 kind: line.kind,
                 title: line.title,
             });
         });
     }
-    return lines;
+    for (const run of runs.values()) {
+        if (["queued", "running"].includes(run.status) || !run.summary)
+            continue;
+        const target = run.ticket ? ` on ${run.ticket}` : "";
+        lines.push({ id: `${run.runId}:end`, sourceIds: [`${run.runId}:end`], runId: run.runId,
+            agent: run.agent, at: run.endedAt ?? "", seq: Number.MAX_SAFE_INTEGER,
+            kind: run.status === "failed" || run.status === "killed" ? "error" : "status",
+            title: `${run.agent} finished ${run.kind}${target}: ${run.summary}` });
+    }
+    return collapse(lines.sort((a, b) => a.at.localeCompare(b.at) || a.seq - b.seq), raw);
 }
 /**
  * Adds lines to the stream without letting it grow forever and without showing
@@ -40,11 +53,14 @@ export function toStreamLines(events, runs) {
 export function appendLines(prior, incoming, limit = STREAM_LIMIT) {
     if (incoming.length === 0)
         return prior;
-    const seen = new Set(prior.map((line) => line.id));
-    const fresh = incoming.filter((line) => !seen.has(line.id));
+    const seen = new Set(prior.flatMap((line) => line.sourceIds ?? [line.id]));
+    const fresh = incoming.flatMap((line) => {
+        const ids = (line.sourceIds ?? [line.id]).filter((id) => !seen.has(id));
+        return ids.length ? [{ ...line, sourceIds: ids, count: line.count ? ids.length : undefined }] : [];
+    });
     if (fresh.length === 0)
         return prior;
-    const next = [...prior, ...fresh].sort((left, right) => left.at.localeCompare(right.at) || left.seq - right.seq);
+    const next = collapse([...prior, ...fresh].sort((left, right) => left.at.localeCompare(right.at) || left.seq - right.seq));
     return next.length > limit ? next.slice(next.length - limit) : next;
 }
 /**
@@ -82,33 +98,32 @@ export async function backfill(opts) {
         return;
     opts.apply((prior) => appendLines(prior, lines));
 }
-function transcriptLines(event) {
-    const payload = event.payload && typeof event.payload === "object" && !Array.isArray(event.payload)
-        ? event.payload
-        : {};
-    const text = [payload.text, payload.message, payload.summary, payload.command, payload.path]
-        .find((value) => typeof value === "string");
-    const title = text?.trim() || JSON.stringify(event.payload) || event.type;
-    if (!title)
-        return [];
-    const kind = event.type === "error"
-        ? "error"
-        : ["tool_use", "tool_result", "command", "file_changed"].includes(event.type)
-            ? "tool"
-            : event.type === "status"
-                ? "status"
-                : "text";
-    return [{ kind, title }];
+function collapse(lines, raw = false) {
+    if (raw)
+        return lines;
+    const out = [];
+    for (const line of lines) {
+        const previous = out.at(-1);
+        const gap = previous ? Date.parse(line.at) - Date.parse(previous.at) : Infinity;
+        if (previous && previous.runId === line.runId && previous.kind === line.kind && previous.title === line.title && gap <= 2_000) {
+            previous.count = (previous.count ?? 1) + (line.count ?? 1);
+            previous.sourceIds = [...(previous.sourceIds ?? [previous.id]), ...(line.sourceIds ?? [line.id])];
+        }
+        else
+            out.push({ ...line });
+    }
+    return out;
 }
 /**
  * The live runs, keyed by id. Realtime hands over a run event before the board
  * has caught up with the run that produced it, so anything this does not know
  * about is dropped and recovered by the backfill when the board does catch up.
  */
-export function runLabels(board) {
+export function runLabels(board, now = Date.now()) {
     const map = new Map();
     for (const run of board.runs) {
-        if (run.status !== "running")
+        const ended = run.ended_at ? Date.parse(run.ended_at) : NaN;
+        if (run.status !== "running" && (!Number.isFinite(ended) || now - ended > 15 * 60_000))
             continue;
         const agent = board.agents.find((row) => row.id === run.agent_id);
         const ticket = board.tickets.find((row) => row.id === run.ticket_id);
@@ -116,6 +131,8 @@ export function runLabels(board) {
             runId: run.id,
             agent: agent?.display_name ?? run.kind,
             ticket: ticket?.key ?? null,
+            kind: run.kind, status: run.status, attempt: ticket?.attempts ?? 1,
+            startedAt: run.started_at, endedAt: run.ended_at ?? null, summary: run.summary ?? null,
         });
     }
     return map;