@higherdev/cli 0.15.4 → 0.16.0

package/README.md

@@ -54,6 +54,7 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd host env rm NAME` | Remove a host-only environment variable |
 | `hd logs KEY [-f]` | Show or follow run events |
 | `hd msg KEY "message" [--interrupt]` | Message a builder |
+| `hd inbox [--all] [--limit N] [--json]` | List unread inbox messages, or earlier history with `--all` |
 | `hd decide` | List open decisions |
 | `hd decide ID --answer TEXT` | Answer a decision |
 | `hd on` / `hd off` | Turn the workspace on or off |
@@ -95,7 +96,7 @@ Use `hd host env set VERCEL_TOKEN=... VERCEL_TEAM_ID=...` to let the runner adop
 Vercel project. It syncs `NEXT_PUBLIC_*`, names listed in `settings.vercel.env`, and existing Vercel-held names
 to production and preview. Later `hd env set` changes wake the orchestrator to update matching Vercel variables.
 
-Inside the TUI, use `/board`, `/inbox`, `/ticket`, `/ticket new [PATH.md]`, `/queue`, `/cancel`, `/msg`, `/logs`, `/epic new`,
+Inside the TUI, use `/board`, `/inbox`, `/inbox more`, `/ticket`, `/ticket new [PATH.md]`, `/queue`, `/cancel`, `/msg`, `/logs`, `/epic new`,
 `/epic approve`, `/epic rm`, `/epics`, `/architect` (or `/plan`), `/decide`, `/agents add`, `/agents rm`, `/env`, `/settings`, `/workspace`,
 `/workspace new`, `/workspace set`, `/workspace rotate-key`, `/workspace grant-runner-access`, `/feed`,
 `/on`, `/off`, `/orchestrator`, `/refresh`, `/help`, or `/exit`. The display refreshes from

package/dist/agent-commands.js

@@ -0,0 +1,80 @@
+import { createAgent, getStatus, listAgents } from "./api.js";
+import { promptOnStdin } from "./prompt.js";
+export const AGENT_ADD_USAGE = "usage: hd agents add [ROLE] --name NAME --provider P --model M --effort E";
+const EFFORTS = ["low", "medium", "high"];
+const ROLES = ["architect", "orchestrator", "reviewer", "builder"];
+function parse(argv) {
+    const opts = {};
+    const rest = [];
+    const missingValues = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg.startsWith("--")) {
+            rest.push(arg);
+            continue;
+        }
+        const name = arg.slice(2);
+        const value = argv[index + 1];
+        if (!value || value.startsWith("--")) {
+            missingValues.push(name);
+            continue;
+        }
+        opts[name] = value;
+        index += 1;
+    }
+    return { opts, rest, missingValues };
+}
+export function nextBuilderName(agents) {
+    return `Builder ${agents.filter((agent) => agent.role === "builder").length + 1}`;
+}
+export function availableProvider(capabilities, requested) {
+    const capability = capabilities.find((item) => item.provider === requested);
+    if (!capability?.available)
+        throw new Error(capability?.reason ?? `Unsupported provider ${requested}.`);
+    return capability;
+}
+function choose(answer, choices) {
+    if (!answer)
+        return choices[0];
+    return /^\d+$/.test(answer) ? choices[Number(answer) - 1] : answer;
+}
+export async function agentAdd(argv, deps = {}) {
+    const { opts, rest, missingValues } = parse(argv);
+    if (missingValues.length || rest.length > 1 || Object.keys(opts).some((key) => !["name", "provider", "model", "effort"].includes(key)))
+        throw new Error(AGENT_ADD_USAGE);
+    const role = rest[0] ?? "builder";
+    if (!ROLES.includes(role))
+        throw new Error(AGENT_ADD_USAGE);
+    const interactive = deps.isTTY ?? Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const needsForm = ["name", "provider", "model", "effort"].some((field) => !opts[field]);
+    if (needsForm && !interactive)
+        throw new Error(AGENT_ADD_USAGE);
+    const [{ agents }, status] = await Promise.all([
+        (deps.listAgents ?? listAgents)(deps.config), (deps.getStatus ?? getStatus)(deps.config),
+    ]);
+    const prompt = deps.prompt ?? promptOnStdin;
+    const defaultName = nextBuilderName(agents);
+    const name = opts.name?.trim() || (await prompt(`Name [${defaultName}]: `)).trim() || defaultName;
+    const capabilities = status.workspace.provider_capabilities ?? [];
+    if (opts.provider?.trim())
+        availableProvider(capabilities, opts.provider.trim());
+    const providers = capabilities.filter((item) => item.available).map((item) => item.provider);
+    if (!providers.length && !opts.provider) {
+        throw new Error(`No providers are available on runner host ${status.workspace.default_host}.`);
+    }
+    const providerAnswer = opts.provider?.trim() || (await prompt(`Provider (${providers.map((item, index) => `${index + 1}=${item}`).join(", ")}) [${providers[0]}]: `)).trim();
+    const provider = choose(providerAnswer, providers);
+    if (!provider)
+        throw new Error("Provider is required.");
+    availableProvider(capabilities, provider);
+    const model = opts.model?.trim() || (await prompt("Model: ")).trim();
+    if (!model)
+        throw new Error("Model is required.");
+    const effortAnswer = opts.effort?.trim() || (await prompt("Effort (1=low, 2=medium, 3=high) [high]: ")).trim();
+    const effort = choose(effortAnswer || "high", [...EFFORTS]);
+    if (!effort || !EFFORTS.includes(effort)) {
+        throw new Error(`Choose effort from: ${EFFORTS.join(", ")}.`);
+    }
+    return (deps.createAgent ?? createAgent)({ role, provider, model, effort,
+        display_name: name }, deps.config);
+}

package/dist/api.js

@@ -143,10 +143,16 @@ export async function listMessages(options = {}, config = loadConfig()) {
         query.set("since", options.since);
     if (options.limit)
         query.set("limit", String(options.limit));
+    if (options.offset)
+        query.set("offset", String(options.offset));
     if (options.toRoles?.length)
         query.set("to_role", options.toRoles.join(","));
     if (options.undelivered)
         query.set("undelivered", "true");
+    if (options.delivered)
+        query.set("delivered", "true");
+    if (options.order)
+        query.set("order", options.order);
     const suffix = query.size ? `?${query.toString()}` : "";
     return request(config, "GET", `/api/w/${config.slug}/messages${suffix}`);
 }

package/dist/index.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listHostEnv, listWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
+import { approveEpic, answerDecision, cancelTicket, createEpic, deleteAgent, deleteEpic, getStatus, getWorkspace, listAgents, listEpics, listHostEnv, listMessages, listWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
 import { initHost, parseHostFlags } from "./host.js";
 import { login, parseLoginFlags } from "./login.js";
 import { loadConfig } from "./config.js";
 import { epicProgressRows, readEpicSpec } from "./epics.js";
 import { banner, c, statusChip, table, truncate, usage } from "./out.js";
 import { ticketNew } from "./ticket-commands.js";
+import { agentAdd, AGENT_ADD_USAGE } from "./agent-commands.js";
 import { WORKSPACE_USAGE, workspaceGrantRunnerAccess, workspaceNew, workspaceRotateKey, workspaceSet, workspaceUse } from "./workspace-commands.js";
 import { defaultGh, hasWriteRepoPermission, HDX_RUNNER_GH_USER, requireAdminRepo, runnerRepoPermission } from "./workspace-preflight.js";
 function fail(message) {
@@ -60,6 +61,11 @@ async function cmdStatus() {
     const data = await getStatus();
     const state = data.workspace.paused ? c.yellow("off") : c.green("on");
     console.log(`${c.bold(data.workspace.name)}  ${c.dim(data.workspace.repo)}  ${state}\n`);
+    const waiting = [...new Set(data.tickets.map((ticket) => ticket.stuck_reason
+            ?.match(/^Waiting on (\w+) until (\d{1,2}:\d{2})\.$/)).filter(Boolean)
+            .map((match) => `${match?.[1]} waiting until ${match?.[2]}`))];
+    if (waiting.length)
+        console.log(`${c.bold("Providers")}  ${waiting.map((line) => c.yellow(line)).join(", ")}\n`);
     printTickets(data.tickets);
     if (data.live_runs.length > 0) {
         console.log(`\n${c.bold("Live runs")}`);
@@ -209,6 +215,36 @@ async function cmdMsg(argv) {
     });
     console.log(`sent ${message.id}`);
 }
+async function cmdInbox(argv) {
+    const { rest, opts, bools } = flags(argv);
+    if (rest.length || (bools.has("limit") && !opts.limit))
+        fail("usage: hd inbox [--all] [--limit N] [--json]");
+    const all = bools.has("all");
+    const json = bools.has("json");
+    const limit = opts.limit ? Number(opts.limit) : 50;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 500)
+        fail("usage: hd inbox [--all] [--limit N] [--json]");
+    const { messages } = await listMessages({
+        toRoles: ["human", "all"],
+        limit,
+        ...(all ? { order: "desc" } : { undelivered: true }),
+    });
+    if (json) {
+        console.log(JSON.stringify({ messages }));
+        return;
+    }
+    if (!messages.length) {
+        console.log(all ? "No messages." : "No unread messages.");
+        return;
+    }
+    for (const message of messages) {
+        const sender = message.from_name?.trim() || message.from_role;
+        const ticket = message.ticket_key?.trim();
+        console.log([message.created_at, sender, ticket].filter(Boolean).join("  "));
+        console.log(message.body_md);
+        console.log("");
+    }
+}
 async function cmdDecide(argv) {
     const { rest, opts } = flags(argv);
     if (rest.length === 0) {
@@ -293,7 +329,7 @@ function selectAgent(agents, target, provider) {
         fail(`No unambiguous agent ${target}${provider ? ` for provider ${provider}` : ""}.`);
     return selected;
 }
-async function cmdAgents(argv) {
+async function cmdAgents(argv, deps = {}) {
     const [action, ...rest] = argv;
     if (!action) {
         const { agents } = await listAgents();
@@ -307,14 +343,11 @@ async function cmdAgents(argv) {
         ])));
         return;
     }
-    const agentUsage = "usage: hd agents add ROLE --provider P --model M [--effort E] [--name N] | rm ROLE|ID | set ROLE|ID [flags]";
+    const agentUsage = `${AGENT_ADD_USAGE} | hd agents rm ROLE|ID | hd agents set ROLE|ID [flags]`;
     const { rest: args, opts, bools } = flags(rest);
     const target = args[0];
     if (action === "add") {
-        if (!target || !opts.provider || !opts.model)
-            fail(agentUsage);
-        const { agent } = await createAgent({ role: target, provider: opts.provider, model: opts.model,
-            effort: opts.effort, display_name: opts.name ?? opts.provider });
+        const { agent } = await agentAdd(rest, deps);
         console.log(`${agent.id}  ${agent.display_name}  ${agent.role}  ${agent.provider}`);
         return;
     }
@@ -339,11 +372,26 @@ async function cmdAgents(argv) {
     const { agent } = await updateAgent(current.id, fields);
     console.log(`${agent.display_name}  ${agent.role}  ${agent.provider}  ${agent.model}  ${agent.enabled ? "on" : "off"}`);
 }
+export function mailerCapsRow(auth) {
+    if (auth === "smtp")
+        return "mailer: custom SMTP";
+    if (auth === "built-in" || auth === "configured")
+        return "mailer: built-in (2/h)";
+    return null;
+}
+export function previewCapsRow(preview) {
+    return `preview: ${preview === "bypass" ? "bypass" : "protected"}`;
+}
 async function cmdCaps(argv) {
     const [action, provider, raw, ...extra] = argv;
     if (!action) {
-        const caps = (await getStatus()).workspace.provider_caps;
+        const [status, detail] = await Promise.all([getStatus(), getWorkspace()]);
+        const caps = status.workspace.provider_caps ?? {};
         console.log(table(["PROVIDER", "CAP"], Object.entries(caps).sort().map(([name, cap]) => [name, String(cap)])));
+        const mailer = mailerCapsRow(detail.workspace.settings?.infra?.auth);
+        if (mailer)
+            console.log(mailer);
+        console.log(previewCapsRow(detail.workspace.settings?.infra?.vercel_preview));
         return;
     }
     const cap = Number(raw);
@@ -490,6 +538,10 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdMsg(rest);
             return;
         }
+        if (cmd === "inbox") {
+            await cmdInbox(rest);
+            return;
+        }
         if (cmd === "decide") {
             await cmdDecide(rest);
             return;
@@ -499,7 +551,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             return;
         }
         if (cmd === "agents") {
-            await cmdAgents(rest);
+            await cmdAgents(rest, deps);
             return;
         }
         if (cmd === "caps") {

package/dist/out.js

@@ -74,6 +74,7 @@ export function usage() {
         `  ${c.blue("hd host env ls | set | rm")}          host environment`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
+        `  ${c.blue("hd inbox [--all] [--limit N] [--json]")} inbox messages`,
         `  ${c.blue("hd decide [ID --answer TEXT]")}      decisions`,
         `  ${c.blue("hd on | hd off")}                    workspace switch`,
         `  ${c.blue("hd login --url URL --api-key KEY")}  client setup`,

package/dist/tui/App.js

@@ -5,6 +5,7 @@ import { loadConfig } from "../config.js";
 import { epicProgressRows } from "../epics.js";
 import { promptOnStdin } from "../prompt.js";
 import { ticketNew } from "../ticket-commands.js";
+import { agentAdd } from "../agent-commands.js";
 import { workspaceGrantRunnerAccess, workspaceNew, workspaceRotateKey, workspaceSet } from "../workspace-commands.js";
 import { Banner } from "./Banner.js";
 import { Bubble } from "./Bubble.js";
@@ -19,8 +20,9 @@ import { alertOnce } from "./alert.js";
 import { bubbleRows } from "./height.js";
 import { planLayout, splitPanels } from "./layout.js";
 import { parseLine } from "./parse.js";
-import { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, createAgent, createEpicFromFile, decisionOptions, deleteAgent, deleteEpic, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, pollSnapshot, postAgentMessage, postTicketMessage, queueTicket, resolveDecision, selectDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, waitForReply, } from "./data.js";
+import { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, createEpicFromFile, decisionOptions, deleteAgent, deleteEpic, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, pollSnapshot, postAgentMessage, postTicketMessage, queueTicket, resolveDecision, selectDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, waitForReply, } from "./data.js";
 import { inputActive, promptPlaceholder, QUEUED_STEP, REPLY_WAIT_MS, settleChatReply } from "./chat-wait.js";
+import { EARLIER_PAGE } from "./inbox.js";
 import { editFor, editableKeys, nextValue, seedFor, settingsRows } from "./settings-model.js";
 import { appendLines, runLabels, toStreamLines } from "./stream.js";
 import { UI } from "./theme.js";
@@ -54,6 +56,9 @@ export function App({ initial }) {
     const [field, setField] = useState(null);
     const [editing, setEditing] = useState(null);
     const [inboxFocus, setInboxFocus] = useState(0);
+    const [earlierLimit, setEarlierLimit] = useState(EARLIER_PAGE);
+    const earlierLimitRef = useRef(EARLIER_PAGE);
+    earlierLimitRef.current = earlierLimit;
     const selectedRef = useRef(null);
     const fieldRef = useRef(null);
     const editingRef = useRef(null);
@@ -94,7 +99,7 @@ export function App({ initial }) {
     }, []);
     useEffect(() => {
         setLive("connecting");
-        const polling = pollSnapshot(config, applySnapshot, setLive, (error) => setNotice(error instanceof Error ? error.message : String(error)));
+        const polling = pollSnapshot(config, applySnapshot, setLive, (error) => setNotice(error instanceof Error ? error.message : String(error)), () => earlierLimitRef.current);
         refreshRef.current = polling.refresh;
         return polling.close;
     }, [config, applySnapshot]);
@@ -212,6 +217,8 @@ export function App({ initial }) {
             setStream([]);
             setLogsFilter(null);
             acknowledgedMessages.current.clear();
+            setEarlierLimit(EARLIER_PAGE);
+            earlierLimitRef.current = EARLIER_PAGE;
             setCursor(null);
             selectedRef.current = null;
             setView("home");
@@ -502,8 +509,13 @@ export function App({ initial }) {
             case "agent-add":
                 setBusy(true);
                 try {
-                    const { agent } = await createAgent(config, { role: action.role, provider: action.provider,
-                        model: action.model, effort: action.effort, display_name: action.name ?? action.provider });
+                    let created;
+                    await suspendTerminal(async () => {
+                        created = await agentAdd(action.args, { config, isTTY: true, prompt: tuiPrompt });
+                    });
+                    if (!created)
+                        throw new Error("Agent wizard did not finish.");
+                    const { agent } = created;
                     say("system", `Added ${agent.display_name} (${agent.id}).`);
                     await refresh();
                 }
@@ -599,6 +611,17 @@ export function App({ initial }) {
             case "help":
                 setMessages((prior) => [...prior, { id: nextId(), speaker: "system", body: "", panel: "help", done: true }]);
                 return;
+            case "inbox-more":
+                if (view !== "inbox")
+                    setView("inbox");
+                if (!board.earlierHasMore) {
+                    say("system", "No more earlier messages.");
+                    return;
+                }
+                setEarlierLimit((current) => current + EARLIER_PAGE);
+                earlierLimitRef.current += EARLIER_PAGE;
+                await refresh();
+                return;
             case "refresh":
                 await refresh();
                 return;

package/dist/tui/Help.js

@@ -6,7 +6,7 @@ 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: "/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: "/queue", args: "HD-12", help: "queue a complete ticket now" },
     { name: "/cancel", args: "HD-12", help: "cancel a ticket" },
@@ -17,7 +17,7 @@ export const COMMANDS = [
     { 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: "/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

@@ -7,6 +7,7 @@ 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";
 const DOT = "●";
 /**
  * The single-purpose views behind /board, /agents, /feed and /inbox. Each is
@@ -86,27 +87,31 @@ export function FeedPanel({ entries, width = 80, rows = 12, }) {
  */
 export function InboxPanel({ board, width = 80, rows = 12, focus = 0, }) {
     const entries = inboxEntries(board, width);
-    const messages = board.messages ?? [];
+    const unread = board.messages ?? [];
+    const earlier = board.earlier ?? [];
     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) => (_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))),
         ] }));
 }
-/** Every physical line in /inbox, with decision bodies wrapped but never clipped. */
+/** Every physical line in /inbox, with decision and message bodies wrapped but never clipped. */
 export function inboxEntries(board, width) {
     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({
@@ -118,18 +123,35 @@ export function inboxEntries(board, width) {
             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: "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 [""];

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 { 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,
         },
         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);

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/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":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.15.4",
+  "version": "0.16.0",
   "type": "module",
   "bin": {
     "hd": "dist/index.js"