@higherdev/cli 0.16.0 → 0.17.0

package/dist/tui/Decision.js

@@ -1,48 +1,35 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from "ink";
 import { relativeTime, truncate } from "../out/format.js";
-import { clipToRows } from "./Panels.js";
-import { decisionOptions } from "./data.js";
+import { DECISION_CURSOR } from "./decide-nav.js";
 import { UI } from "./theme.js";
 /**
- * Everything the panel spends that is not question or options: two rows of
- * frame, the heading, the line saying how to answer, and the blank row after.
- */
-const DECISION_CHROME = 5;
-/**
- * Rows the flag wants, so the caller can take them out of the panel budget
- * before anything is drawn. Zero when nothing is waiting.
+ * Heading, one row per pending decision, and the hint. Cap keeps the flag
+ * from eating the cockpit on a busy inbox.
  */
 export function decisionRows(decisions, cap = 9) {
     if (decisions.length === 0)
         return 0;
-    // Two rows of question is the least worth reading, and the options after it.
-    return Math.min(cap, DECISION_CHROME + 2 + decisionOptions(decisions[0]).length);
+    return Math.min(cap, 4 + decisions.length);
 }
 /**
- * A decision waiting on you, in the way of the prompt rather than counted in
- * the status line. This is the one thing in the frame that is not a report:
- * nothing moves on the ticket it blocks until it is answered, so it stays in
- * front of you until it is.
+ * Pending decisions on the home view, numbered the same way `/inbox` and
+ * `/decide N` use, so the owner can answer any of them.
  */
-export function DecisionPanel({ decisions, board, width, rows, }) {
+export function DecisionPanel({ decisions, board, width, rows, selectedId = null, }) {
     if (decisions.length === 0)
         return null;
-    const decision = decisions[0];
-    const ticket = board?.tickets.find((row) => row.id === decision.ticket_id);
-    const options = decisionOptions(decision);
     const inner = Math.max(8, width - 4);
-    const forBody = rows - DECISION_CHROME;
-    // Too little room for a frame at all. The flag still has to appear, so it
-    // shrinks to the one line that says something is waiting and how to answer.
-    if (forBody < 1) {
-        return (_jsxs(Box, { width: width, flexWrap: "nowrap", children: [_jsx(Text, { color: UI.warn, bold: true, wrap: "truncate", children: decisions.length > 1 ? `${decisions.length} decisions waiting` : "Decision waiting" }), _jsx(Text, { color: UI.dim, wrap: "truncate", children: `  ${truncate(decision.question_md, Math.max(8, width - 26))}  /decide` })] }));
+    const selected = selectedId ?? decisions[0]?.id ?? null;
+    if (rows < 4) {
+        return (_jsxs(Box, { width: width, flexWrap: "nowrap", children: [_jsxs(Text, { color: UI.warn, bold: true, wrap: "truncate", children: [decisions.length, " decision", decisions.length === 1 ? "" : "s"] }), _jsx(Text, { color: UI.dim, wrap: "truncate", children: `  /decide N answer  or /inbox then Enter` })] }));
     }
-    // The question gets a row before any option does, and the options take what
-    // is left after it.
-    const optionRows = Math.min(options.length, Math.max(0, forBody - 1));
-    const question = clipToRows(decision.question_md.trim(), inner, forBody - optionRows);
-    return (_jsxs(Box, { borderStyle: "single", borderColor: UI.warn, flexDirection: "column", paddingX: 1, width: width, marginBottom: 1, children: [_jsxs(Box, { flexWrap: "nowrap", children: [_jsx(Text, { color: UI.warn, bold: true, wrap: "truncate", children: decisions.length > 1 ? `Decision 1 of ${decisions.length}` : "Decision" }), _jsxs(Text, { color: UI.dim, wrap: "truncate", children: [ticket ? `  ${ticket.key}` : "", `  asked by ${decision.asked_by_role}`, `  ${relativeTime(decision.created_at)}`] })] }), _jsx(Text, { color: UI.text, wrap: "wrap", children: question }), options.slice(0, optionRows).map((option, index) => (_jsxs(Box, { flexWrap: "nowrap", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsxs(Text, { color: UI.accent, children: [index + 1, ")"] }) }), _jsx(Text, { color: UI.text, wrap: "truncate", children: truncate(option, Math.max(8, inner - 4)) })] }, index))), _jsx(Text, { color: UI.dim, wrap: "truncate", children: options.length
-                    ? `/decide 1 to ${options.length}, or /decide <your answer>`
-                    : "/decide <your answer>" })] }));
+    const shown = decisions.slice(0, Math.max(1, rows - 4));
+    return (_jsxs(Box, { borderStyle: "single", borderColor: UI.warn, flexDirection: "column", paddingX: 1, width: width, marginBottom: 1, children: [_jsxs(Text, { color: UI.warn, bold: true, wrap: "truncate", children: ["Decisions (", decisions.length, ")"] }), shown.map((decision, index) => {
+                const ticket = board?.tickets.find((row) => row.id === decision.ticket_id);
+                const cursor = decision.id === selected;
+                const label = ticket?.key ?? decision.id.slice(0, 8);
+                const question = decision.question_md.trim().split("\n")[0] ?? "";
+                return (_jsxs(Text, { color: UI.text, wrap: "truncate", inverse: cursor, children: [cursor ? `${DECISION_CURSOR} ` : "  ", index + 1, ") ", label, question ? `  ${truncate(question, Math.max(8, inner - label.length - 8))}` : "", `  ${relativeTime(decision.created_at)}`] }, decision.id));
+            }), decisions.length > shown.length ? (_jsxs(Text, { color: UI.dim, wrap: "truncate", children: ["+", decisions.length - shown.length, " more in /inbox"] })) : null, _jsx(Text, { color: UI.dim, wrap: "truncate", children: "/decide 3 answer \u00B7 /inbox then Enter" })] }));
 }

package/dist/tui/Help.js

@@ -6,17 +6,17 @@ export const HELP_FOOTER = "Anything not starting with / goes to whoever you are
 /** Everything you can type. The app is driven from here, not from flags. */
 export const COMMANDS = [
     { name: "/board", help: "the kanban board" },
-    { name: "/inbox", args: "[more]", help: "unread and earlier messages; more pages earlier" },
-    { name: "/ticket", args: "HD-12 | new [PATH.md]", help: "open or create a ticket" },
+    { name: "/inbox", args: "[more]", help: "unread, earlier, and numbered decisions; Enter answers" },
+    { name: "/ticket", args: "HD-12 | new [PATH.md]", help: "open a full ticket view or create one" },
     { name: "/queue", args: "HD-12", help: "queue a complete ticket now" },
     { name: "/cancel", args: "HD-12", help: "cancel a ticket" },
     { name: "/msg", args: "HD-12 TEXT", help: "message a ticket's builder" },
-    { name: "/logs", args: "[HD-12]", help: "filter or clear the activity stream" },
+    { name: "/logs", args: "[raw] [HD-12]", help: "filter activity; raw reveals event JSON" },
     { name: "/epic", args: "new PATH | approve ID | rm ID", help: "create, approve, or remove a draft epic" },
     { name: "/epics", help: "list epics and ticket progress" },
     { name: "/architect", help: "talk to the agent that shapes draft epics" },
     { name: "/plan", help: "alias for /architect" },
-    { name: "/decide", args: "[N|ID] answer", help: "answer a targeted or focused decision" },
+    { name: "/decide", args: "[N|ID] [answer]", help: "answer the selected or numbered decision" },
     { name: "/agents", args: "[add [ROLE] [flags] | rm ROLE|ID]", help: "view or manage named agents" },
     { name: "/env", help: "list workspace environment variable names" },
     { name: "/settings", help: "change provider caps and agent settings" },

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
@@ -85,10 +87,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 +106,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 +125,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 +216,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/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,7 @@ 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,
         },
         feed: feedData.entries,
     };
@@ -125,7 +125,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 +198,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;