@higherdev/cli 0.15.4 → 0.17.0

package/dist/tui/Help.js

@@ -6,18 +6,18 @@ 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", help: "decisions and messages waiting on you" },
-    { 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: "/agents", args: "[add ... | rm ROLE|ID]", help: "view or manage agents" },
+    { 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" },
     { name: "/workspace", args: "[slug | new | set | rotate-key | grant-runner-access]", help: "list, switch, create, or configure" },

package/dist/tui/Panels.js

@@ -1,12 +1,15 @@
 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";
 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
@@ -84,52 +87,96 @@ 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);
-    const messages = board.messages ?? [];
+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;
     const hiddenBelow = entries.length - window.end;
-    const note = `${board.decisions.length}d · ${messages.length}m`
+    const note = `${board.decisions.length}d · ${unread.length} unread`
         + `${hiddenAbove ? `  ${hiddenAbove}↑` : ""}${hiddenBelow ? `  ${hiddenBelow}↓` : ""}`;
+    const empty = board.decisions.length === 0 && unread.length === 0 && earlier.length === 0;
     return (_jsx(Panel, { width: width, rows: rows, children: [
             _jsx(Heading, { text: "Inbox", note: note }, "h"),
-            ...(board.decisions.length === 0 && messages.length === 0
+            ...(empty
                 ? [
                     _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 === "header" ? UI.warn : UI.text, 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 bodies wrapped but never clipped. */
-export function inboxEntries(board, width) {
+/** Every physical line in /inbox, with decision and message bodies wrapped but never clipped. */
+export function inboxEntries(board, width, answeringId) {
     const entries = [];
     const bodyWidth = Math.max(12, width - 2);
+    const unread = board.messages ?? [];
+    const earlier = board.earlier ?? [];
     board.decisions.forEach((decision, index) => {
         const ticket = board.tickets.find((row) => row.id === decision.ticket_id);
         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 });
-        });
-    });
-    (board.messages ?? []).forEach((message) => {
-        entries.push({
-            key: `${message.id}:header`,
-            kind: "header",
-            text: `Message from ${message.from_name ?? message.from_role}`,
-        });
-        wrapLines(message.body_md.trim(), bodyWidth).forEach((text, line) => {
-            entries.push({ key: `${message.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) {
+        entries.push({ key: "unread:empty", kind: "body", text: "No unread messages." });
+    }
+    else {
+        unread.forEach((message) => pushMessageEntries(entries, message, bodyWidth));
+    }
+    entries.push({ key: "earlier:section", kind: "section", text: "Earlier" });
+    if (earlier.length === 0) {
+        entries.push({ key: "earlier:empty", kind: "body", text: "No earlier messages." });
+    }
+    else {
+        earlier.forEach((message) => pushMessageEntries(entries, message, bodyWidth));
+        if (board.earlierHasMore) {
+            entries.push({ key: "earlier:more", kind: "body", text: "Type /inbox more for older messages." });
+        }
+    }
     return entries;
 }
+function pushMessageEntries(entries, message, bodyWidth) {
+    entries.push({
+        key: `${message.id}:header`,
+        kind: "header",
+        text: inboxHeader(message),
+    });
+    wrapLines(message.body_md.trim(), bodyWidth).forEach((text, line) => {
+        entries.push({ key: `${message.id}:body:${line}`, kind: "body", text });
+    });
+}
 function wrapLines(text, width) {
     if (!text)
         return [""];
@@ -169,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/agent-rows.js

@@ -1,4 +1,4 @@
-const LIMITED_UNTIL = /^(\w+) limited until (\d{1,2}:\d{2})$/;
+const LIMITED_UNTIL = /^(?:Waiting on )?(\w+) (?:limited )?until (\d{1,2}:\d{2})\.?$/;
 export function limitedUntilByProvider(tickets) {
     const limited = new Map();
     for (const ticket of tickets) {

package/dist/tui/data.js

@@ -1,6 +1,7 @@
-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";
 export const POLL_MS = 5_000;
 export const providers = ["claude", "codex", "gemini", "grok"];
 export const efforts = ["low", "medium", "high"];
@@ -21,8 +22,16 @@ export const BOARD_COLUMNS = [
 export async function configuredSlugs(config = loadConfig()) {
     return (await listWorkspaces(config)).map((workspace) => workspace.slug).sort();
 }
-export async function loadSnapshot(config = loadConfig()) {
-    const [status, workspaceData, ticketData, agentData, epicData, feedData, messageData] = await Promise.all([
+function withTicketKeys(messages, tickets) {
+    const keys = new Map(tickets.map((ticket) => [ticket.id, ticket.key]));
+    return messages.map((message) => ({
+        ...message,
+        ticket_key: message.ticket_key ?? (message.ticket_id ? keys.get(message.ticket_id) ?? null : null),
+    }));
+}
+export async function loadSnapshot(config = loadConfig(), options = {}) {
+    const earlierLimit = options.earlierLimit ?? EARLIER_PAGE;
+    const [status, workspaceData, ticketData, agentData, epicData, feedData, unreadData, earlierData] = await Promise.all([
         getStatus(config),
         getWorkspace(config),
         listTickets(config),
@@ -30,6 +39,9 @@ export async function loadSnapshot(config = loadConfig()) {
         listEpics(config),
         listFeed(config),
         listMessages({ toRoles: ["human", "all"], undelivered: true, limit: 500 }, config),
+        listMessages({
+            toRoles: ["human", "all"], delivered: true, order: "desc", limit: earlierLimit + 1,
+        }, config),
     ]);
     const byId = new Map(ticketData.tickets.map((ticket) => [ticket.id, ticket]));
     const agents = new Map(agentData.agents.map((agent) => [agent.id, agent]));
@@ -39,11 +51,10 @@ export async function loadSnapshot(config = loadConfig()) {
         blocker_keys: ticket.blocked_by.map((id) => byId.get(id)?.key).filter((key) => Boolean(key)),
         stuck: ticket.stuck_reason,
     }));
-    const caps = status.workspace.provider_caps ?? {};
-    const availability = providers.map((provider) => {
-        const cap = Number(caps[provider] ?? 0);
-        return { provider, available: cap > 0, reason: cap > 0 ? "available" : "cap 0" };
-    });
+    const availability = status.workspace.provider_capabilities?.length
+        ? status.workspace.provider_capabilities
+        : providers.map((provider) => ({ provider, available: false, reason: "runner capability unknown" }));
+    const earlier = withTicketKeys(earlierData.messages, tickets);
     return {
         config,
         workspace: {
@@ -64,14 +75,16 @@ export async function loadSnapshot(config = loadConfig()) {
             agents: agentData.agents,
             epics: epicData.epics,
             decisions: status.decisions,
-            messages: messageData.messages,
+            messages: withTicketKeys(unreadData.messages, tickets),
+            earlier: earlier.slice(0, earlierLimit),
+            earlierHasMore: earlier.length > earlierLimit,
             availability,
-            runs: status.live_runs,
+            runs: status.recent_runs ?? status.live_runs,
         },
         feed: feedData.entries,
     };
 }
-export function pollSnapshot(config, onSnapshot, onState, onError) {
+export function pollSnapshot(config, onSnapshot, onState, onError, earlierLimit) {
     let closed = false;
     let active = false;
     const refresh = async () => {
@@ -79,7 +92,7 @@ export function pollSnapshot(config, onSnapshot, onState, onError) {
             return;
         active = true;
         try {
-            const snapshot = await loadSnapshot(config);
+            const snapshot = await loadSnapshot(config, { earlierLimit: earlierLimit?.() ?? EARLIER_PAGE });
             if (closed)
                 return;
             onSnapshot(snapshot);
@@ -112,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);
@@ -174,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/inbox.js

@@ -0,0 +1,29 @@
+export const EARLIER_PAGE = 50;
+/** Split a mixed inbox fixture into Unread and Earlier, newest-first for delivered. */
+export function inboxHistory(messages, earlierLimit = EARLIER_PAGE) {
+    const unread = messages
+        .filter((message) => !message.delivered_at)
+        .sort((a, b) => Date.parse(a.created_at) - Date.parse(b.created_at));
+    const earlier = messages
+        .filter((message) => Boolean(message.delivered_at))
+        .sort((a, b) => Date.parse(b.created_at) - Date.parse(a.created_at));
+    return {
+        unread,
+        earlier: earlier.slice(0, earlierLimit),
+        earlierHasMore: earlier.length > earlierLimit,
+    };
+}
+export function inboxTime(iso) {
+    const at = Date.parse(iso);
+    if (Number.isNaN(at))
+        return iso;
+    return new Date(at).toISOString().slice(0, 16).replace("T", " ");
+}
+export function inboxSender(message) {
+    return message.from_name?.trim() || message.from_role;
+}
+export function inboxHeader(message) {
+    const key = message.ticket_key?.trim();
+    const prefix = `${inboxTime(message.created_at)}  ${inboxSender(message)}`;
+    return key ? `${prefix}  ${key}` : prefix;
+}

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

@@ -19,22 +19,22 @@ export function parseLine(raw) {
                 : { kind: "mode", mode: "architect" };
         case "board":
         case "feed":
-        case "inbox":
         case "settings":
             return { kind: "view", view: word.toLowerCase() };
+        case "inbox":
+            if (!argument)
+                return { kind: "view", view: "inbox" };
+            return rest.length === 1 && rest[0].toLowerCase() === "more"
+                ? { kind: "inbox-more" }
+                : { kind: "unknown", command: "inbox takes no arguments, or more" };
         case "agents": {
             if (!argument)
                 return { kind: "view", view: "agents" };
             const [verb, target, ...tail] = rest;
             if (verb === "rm" && target && !tail.length)
                 return { kind: "agent-rm", target };
-            const opts = {};
-            for (let i = 0; i < tail.length; i += 2)
-                if (tail[i]?.startsWith("--") && tail[i + 1])
-                    opts[tail[i].slice(2)] = tail[i + 1];
-            return verb === "add" && target && opts.provider && opts.model
-                ? { kind: "agent-add", role: target, provider: opts.provider, model: opts.model,
-                    ...(opts.effort ? { effort: opts.effort } : {}), ...(opts.name ? { name: opts.name } : {}) }
+            return verb === "add"
+                ? { kind: "agent-add", args: rest.slice(1) }
                 : { kind: "unknown", command: "agents needs add ROLE --provider P --model M or rm ROLE|ID" };
         }
         case "env":
@@ -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":