@higherdev/cli 0.13.0 → 0.14.2

package/README.md

@@ -43,6 +43,9 @@ workspace-map config shapes are migrated automatically when they are read.
 | `hd agents rm ROLE\|ID` | Remove an unambiguous agent |
 | `hd agents set ROLE\|ID [options]` | Rename, configure, enable, or disable an agent |
 | `hd caps [set PROVIDER N]` | Show or update provider concurrency caps |
+| `hd env ls` | List workspace environment variable names |
+| `hd env set NAME=VALUE [NAME=VALUE...]` | Set workspace environment variables |
+| `hd env rm NAME` | Remove a workspace environment variable |
 | `hd logs KEY [-f]` | Show or follow run events |
 | `hd msg KEY "message" [--interrupt]` | Message a builder |
 | `hd decide` | List open decisions |
@@ -64,7 +67,7 @@ the repository is missing, approve private creation interactively, use `--create
 `--no-create` to fail. Fully flagged calls remain non-interactive for scripts and Mel.
 
 Inside the TUI, use `/board`, `/inbox`, `/ticket`, `/queue`, `/cancel`, `/epic new`,
-`/epic approve`, `/epics`, `/architect` (or `/plan`), `/decide`, `/agents add`, `/agents rm`, `/settings`, `/workspace`,
+`/epic approve`, `/epics`, `/architect` (or `/plan`), `/decide`, `/agents add`, `/agents rm`, `/env`, `/settings`, `/workspace`,
 `/workspace new`, `/workspace set`, `/workspace rotate-key`, `/feed`,
 `/on`, `/off`, `/orchestrator`, `/refresh`, `/help`, or `/exit`. The display refreshes from
 the HDX API every five seconds.

package/dist/api.js

@@ -105,6 +105,15 @@ export async function updateAgent(id, fields, config = loadConfig()) {
 export async function deleteAgent(id, config = loadConfig()) {
     return request(config, "DELETE", `/api/w/${config.slug}/agents`, { id });
 }
+export async function listWorkspaceEnv(config = loadConfig()) {
+    return request(config, "GET", `/api/w/${config.slug}/env`);
+}
+export async function setWorkspaceEnv(name, value, config = loadConfig()) {
+    return request(config, "PUT", `/api/w/${config.slug}/env`, { name, value });
+}
+export async function removeWorkspaceEnv(name, config = loadConfig()) {
+    return request(config, "DELETE", `/api/w/${config.slug}/env`, { name });
+}
 export async function listEpics(config = loadConfig()) {
     return request(config, "GET", `/api/w/${config.slug}/epics`);
 }
@@ -125,9 +134,16 @@ export async function listMessages(options = {}, config = loadConfig()) {
         query.set("since", options.since);
     if (options.limit)
         query.set("limit", String(options.limit));
+    if (options.toRoles?.length)
+        query.set("to_role", options.toRoles.join(","));
+    if (options.undelivered)
+        query.set("undelivered", "true");
     const suffix = query.size ? `?${query.toString()}` : "";
     return request(config, "GET", `/api/w/${config.slug}/messages${suffix}`);
 }
+export async function markMessagesDelivered(ids, config = loadConfig()) {
+    return request(config, "PATCH", `/api/w/${config.slug}/messages`, { ids });
+}
 export async function updateCaps(provider_caps, config = loadConfig()) {
     return request(config, "PATCH", `/api/w/${config.slug}/caps`, { provider_caps });
 }

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
-import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, createTicket, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, setPaused, showTicket, updateAgent, updateCaps, } from "./api.js";
+import { approveEpic, answerDecision, cancelTicket, createAgent, createEpic, createTicket, deleteAgent, deleteEpic, getStatus, listAgents, listEpics, listWorkspaceEnv, listTicketEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, setPaused, setWorkspaceEnv, showTicket, updateAgent, updateCaps, } from "./api.js";
 import { initHost, parseHostFlags } from "./host.js";
 import { login, parseLoginFlags } from "./login.js";
 import { loadConfig } from "./config.js";
@@ -344,6 +344,32 @@ async function cmdCaps(argv) {
     const result = await updateCaps({ [provider]: cap });
     console.log(`${provider}  ${result.provider_caps[provider]}`);
 }
+async function cmdEnv(argv) {
+    const [action, ...args] = argv;
+    if (action === "ls") {
+        const { env } = await listWorkspaceEnv();
+        if (!env.length)
+            return console.log(c.dim("No workspace environment variables."));
+        console.log(table(["NAME", "UPDATED"], env.map((row) => [row.name, row.updated_at])));
+        return;
+    }
+    if (action === "set" && args.length) {
+        for (const assignment of args) {
+            const at = assignment.indexOf("=");
+            if (at < 1)
+                fail("usage: hd env set NAME=VALUE [NAME=VALUE...]");
+            await setWorkspaceEnv(assignment.slice(0, at), assignment.slice(at + 1));
+        }
+        console.log(`set ${args.length} variable${args.length === 1 ? "" : "s"}`);
+        return;
+    }
+    if (action === "rm" && args.length === 1) {
+        await removeWorkspaceEnv(args[0]);
+        console.log(`removed ${args[0]}`);
+        return;
+    }
+    fail("usage: hd env ls | set NAME=VALUE [NAME=VALUE...] | rm NAME");
+}
 export async function main(argv = process.argv.slice(2), deps = {}) {
     const [cmd, ...rest] = argv;
     try {
@@ -405,6 +431,10 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdCaps(rest);
             return;
         }
+        if (cmd === "env") {
+            await cmdEnv(rest);
+            return;
+        }
         if (cmd === "pause" || cmd === "off") {
             await setPaused(true);
             console.log(cmd === "off" ? "off" : "paused");

package/dist/out.js

@@ -70,6 +70,7 @@ export function usage() {
         `  ${c.blue("hd workspace ls | new | set | rotate-key")} workspace operations`,
         `  ${c.blue("hd agents [add | rm | set]")}         manage agents`,
         `  ${c.blue("hd caps [set PROVIDER N]")}           provider concurrency`,
+        `  ${c.blue("hd env ls | set | rm")}               workspace environment`,
         `  ${c.blue("hd logs KEY [-f]")}                  run events`,
         `  ${c.blue("hd msg KEY TEXT")}                   message a builder`,
         `  ${c.blue("hd decide [ID --answer TEXT]")}      decisions`,

package/dist/tui/App.js

@@ -18,7 +18,7 @@ import { alertOnce } from "./alert.js";
 import { bubbleRows } from "./height.js";
 import { planLayout, splitPanels } from "./layout.js";
 import { parseLine } from "./parse.js";
-import { configuredSlugs, approveEpic, cancelTicket, createAgent, createEpicFromFile, decisionOptions, deleteAgent, loadLiveEvents, loadTicketDetail, pollSnapshot, postAgentMessage, queueTicket, resolveDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
+import { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, createAgent, createEpicFromFile, decisionOptions, deleteAgent, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, pollSnapshot, postAgentMessage, queueTicket, resolveDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
 import { editFor, editableKeys, nextValue, seedFor, settingsRows } from "./settings-model.js";
 import { appendLines, runLabels, toStreamLines } from "./stream.js";
 import { UI } from "./theme.js";
@@ -57,6 +57,7 @@ export function App({ initial }) {
     const history = useRef([]);
     const historyAt = useRef(-1);
     const refreshRef = useRef(null);
+    const acknowledgedMessages = useRef(new Set());
     const loads = useRef(new WorkspaceLoads(initial.workspace.id));
     editingRef.current = editing;
     useEffect(() => {
@@ -143,6 +144,19 @@ export function App({ initial }) {
     useEffect(() => {
         setInboxFocus((current) => Math.max(0, Math.min(inbox.length - 1, current)));
     }, [inbox.length]);
+    useEffect(() => {
+        if (view !== "inbox")
+            return;
+        const ids = (board.messages ?? []).map((message) => message.id)
+            .filter((id) => !acknowledgedMessages.current.has(id));
+        if (!ids.length)
+            return;
+        ids.forEach((id) => acknowledgedMessages.current.add(id));
+        void acknowledgeInbox(config, ids).catch((error) => {
+            ids.forEach((id) => acknowledgedMessages.current.delete(id));
+            setNotice(error instanceof Error ? error.message : String(error));
+        });
+    }, [view, board.messages, config]);
     const refresh = useCallback(async () => {
         await refreshRef.current?.();
     }, []);
@@ -186,6 +200,7 @@ export function App({ initial }) {
             setBoard(snapshot.board);
             setFeed(snapshot.feed);
             setStream([]);
+            acknowledgedMessages.current.clear();
             setCursor(null);
             selectedRef.current = null;
             setView("home");
@@ -472,6 +487,19 @@ export function App({ initial }) {
                 }
                 return;
             }
+            case "env":
+                setBusy(true);
+                try {
+                    const { env } = await listWorkspaceEnv(config);
+                    say("system", env.length ? env.map((row) => row.name).join("\n") : "No workspace environment variables.");
+                }
+                catch (error) {
+                    setNotice(error instanceof Error ? error.message : String(error));
+                }
+                finally {
+                    setBusy(false);
+                }
+                return;
             case "decide": {
                 const decision = board.decisions[0];
                 if (!decision) {

package/dist/tui/Dashboard.js

@@ -117,10 +117,10 @@ export function AgentsColumn({ board, width, rows, }) {
                 ]
                 : []),
             ...shown.map((row) => {
-                const tone = row.run ? "blue" : row.state === "offline" ? "warning" : "muted";
+                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" ? "warning" : "muted";
                 return (_jsxs(Box, { flexWrap: "nowrap", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsxs(Text, { color: UI.text, wrap: "truncate", children: [row.name, _jsx(Text, { color: UI.dim, children: row.run
                                         ? ` · ${row.ticket?.key ?? row.run.kind} ${elapsed(row.run.started_at ?? row.run.created_at)}`
-                                        : ` · ${row.state}` })] })] }, row.key));
+                                        : ` · ${row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state}` })] })] }, row.key));
             }),
             _jsx(More, { count: displayRows.length - shown.length }, "more"),
         ] }));

package/dist/tui/Help.js

@@ -16,6 +16,7 @@ export const COMMANDS = [
     { name: "/plan", help: "alias for /architect" },
     { name: "/decide", args: "2 | text", help: "answer the decision on screen" },
     { name: "/agents", args: "[add ... | rm ROLE|ID]", help: "view or manage 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]", help: "list, switch, create, or configure" },
     { name: "/on", help: "turn on the current workspace" },

package/dist/tui/Panels.js

@@ -25,8 +25,9 @@ export function AgentsPanel({ board, width = 80, rows = 12, }) {
                 ]
                 : []),
             ...shown.map((row) => {
-                const tone = row.run ? "blue" : row.state === "offline" ? "warning" : "muted";
-                return (_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsx(Text, { color: UI.text, children: pad(truncate(row.name, 13), 14) }), _jsx(Text, { color: UI.dim, children: pad(row.agent?.role ?? row.run?.kind ?? "", 13) }), _jsx(Text, { color: UI.dim, children: pad(truncate(row.agent?.model ?? "", 23), 24) }), _jsx(Text, { color: UI.text, children: pad(row.state, 9) }), _jsxs(Text, { color: UI.dim, children: [row.ticket ? `${row.ticket.key} ` : "", row.run ? elapsed(row.run.started_at ?? row.run.created_at) : ""] })] }, row.key));
+                const tone = row.run ? "blue" : row.state === "offline" || row.state === "limited" ? "warning" : "muted";
+                const state = row.limitedUntil ? `limited until ${row.limitedUntil}` : row.state;
+                return (_jsxs(Text, { wrap: "truncate", children: [_jsxs(Text, { color: inkColor(tone), children: [DOT, " "] }), _jsx(Text, { color: UI.text, children: pad(truncate(row.name, 13), 14) }), _jsx(Text, { color: UI.dim, children: pad(row.agent?.role ?? row.run?.kind ?? "", 13) }), _jsx(Text, { color: UI.dim, children: pad(truncate(row.agent?.model ?? "", 23), 24) }), _jsx(Text, { color: UI.text, children: pad(state, row.limitedUntil ? 22 : 9) }), _jsxs(Text, { color: UI.dim, children: [row.ticket ? `${row.ticket.key} ` : "", row.run ? elapsed(row.run.started_at ?? row.run.created_at) : ""] })] }, row.key));
             }),
             _jsx(More, { count: displayRows.length - shown.length }, "more"),
         ] }));
@@ -85,14 +86,16 @@ 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 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}${hiddenAbove ? `  ${hiddenAbove}↑` : ""}${hiddenBelow ? `  ${hiddenBelow}↓` : ""}`;
+    const note = `${board.decisions.length}d · ${messages.length}m`
+        + `${hiddenAbove ? `  ${hiddenAbove}↑` : ""}${hiddenBelow ? `  ${hiddenBelow}↓` : ""}`;
     return (_jsx(Panel, { width: width, rows: rows, children: [
-            _jsx(Heading, { text: "Decisions", note: note }, "h"),
-            ...(board.decisions.length === 0
+            _jsx(Heading, { text: "Inbox", note: note }, "h"),
+            ...(board.decisions.length === 0 && messages.length === 0
                 ? [
                     _jsx(Text, { color: UI.dim, children: "Nothing waiting on you." }, "empty"),
                 ]
@@ -115,6 +118,16 @@ 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 });
+        });
+    });
     return entries;
 }
 function wrapLines(text, width) {

package/dist/tui/agent-rows.js

@@ -1,3 +1,13 @@
+const LIMITED_UNTIL = /^(\w+) limited until (\d{1,2}:\d{2})$/;
+export function limitedUntilByProvider(tickets) {
+    const limited = new Map();
+    for (const ticket of tickets) {
+        const match = ticket.stuck_reason?.match(LIMITED_UNTIL);
+        if (match)
+            limited.set(match[1], match[2]);
+    }
+    return limited;
+}
 const roleForKind = {
     architect: "architect",
     build: "builder",
@@ -38,20 +48,28 @@ export function agentDisplayRows(board) {
             run,
             ticket,
             state: run.status,
+            limitedUntil: null,
         };
     });
+    const limited = limitedUntilByProvider(board.tickets);
     const idle = board.agents
         .filter((agent) => agent.enabled && !activeAgents.has(agent.id))
         .sort((left, right) => left.display_name.localeCompare(right.display_name))
-        .map((agent) => ({
-        key: `idle:${agent.id}`,
-        name: agent.display_name,
-        agent,
-        run: null,
-        ticket: null,
-        state: board.availability.some((row) => row.provider === agent.provider && !row.available)
-            ? "offline"
-            : "idle",
-    }));
+        .map((agent) => {
+        const until = limited.get(agent.provider);
+        return {
+            key: `idle:${agent.id}`,
+            name: agent.display_name,
+            agent,
+            run: null,
+            ticket: null,
+            state: until
+                ? "limited"
+                : board.availability.some((row) => row.provider === agent.provider && !row.available)
+                    ? "offline"
+                    : "idle",
+            limitedUntil: until ?? null,
+        };
+    });
     return [...live, ...idle];
 }

package/dist/tui/data.js

@@ -1,4 +1,4 @@
-import { approveEpic as approveEpicNow, answerDecision, cancelTicket as cancelTicketNow, createAgent as postAgent, createEpic as postEpic, getStatus, getWorkspace, listAgents, listEpics, listFeed, listMessages, 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, 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";
 export const POLL_MS = 5_000;
@@ -22,13 +22,14 @@ 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] = await Promise.all([
+    const [status, workspaceData, ticketData, agentData, epicData, feedData, messageData] = await Promise.all([
         getStatus(config),
         getWorkspace(config),
         listTickets(config),
         listAgents(config),
         listEpics(config),
         listFeed(config),
+        listMessages({ toRoles: ["human", "all"], undelivered: true, limit: 500 }, config),
     ]);
     const byId = new Map(ticketData.tickets.map((ticket) => [ticket.id, ticket]));
     const agents = new Map(agentData.agents.map((agent) => [agent.id, agent]));
@@ -63,6 +64,7 @@ export async function loadSnapshot(config = loadConfig()) {
             agents: agentData.agents,
             epics: epicData.epics,
             decisions: status.decisions,
+            messages: messageData.messages,
             availability,
             runs: status.live_runs,
         },
@@ -127,6 +129,9 @@ export async function cancelTicket(config, key) {
 export async function setWorkspacePaused(config, paused) {
     return setPausedNow(paused, config);
 }
+export async function listWorkspaceEnv(config) {
+    return getWorkspaceEnv(config);
+}
 export async function createAgent(config, fields) {
     return postAgent(fields, config);
 }
@@ -148,6 +153,10 @@ export async function waitForReply(config, role, since, timeoutMs) {
 export async function resolveDecision(config, id, answer) {
     await answerDecision(id, answer, config);
 }
+export async function acknowledgeInbox(config, ids) {
+    if (ids.length)
+        await markMessagesDelivered(ids, config);
+}
 export async function updateAgent(config, id, fields) {
     return patchAgent(id, fields, config);
 }

package/dist/tui/parse.js

@@ -37,6 +37,8 @@ export function parseLine(raw) {
                     ...(opts.effort ? { effort: opts.effort } : {}), ...(opts.name ? { name: opts.name } : {}) }
                 : { kind: "unknown", command: "agents needs add ROLE --provider P --model M or rm ROLE|ID" };
         }
+        case "env":
+            return rest.length ? { kind: "unknown", command: "env takes no arguments" } : { kind: "env" };
         case "help":
             return { kind: "help" };
         case "workspace":

package/package.json

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