@higherdev/cli 0.27.0 → 0.29.0

package/dist/api.js

@@ -81,6 +81,9 @@ export async function postMessage(fields, config = loadConfig()) {
 export async function getRun(id, config = loadConfig()) {
     return request(config, "GET", `/api/w/${config.slug}/runs/${encodeURIComponent(id)}`);
 }
+export async function cancelRun(id, config = loadConfig()) {
+    return request(config, "POST", `/api/w/${config.slug}/runs/${encodeURIComponent(id)}/cancel`);
+}
 export async function answerDecision(id, answer_md, config = loadConfig()) {
     return request(config, "POST", `/api/w/${config.slug}/decisions/${encodeURIComponent(id)}/answer`, { answer_md });
 }

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, mergeTicket, createEpic, deleteAgent, deleteEpic, getStatus, getRoadmap, getWorkspace, listAgents, listEpics, listHostEnv, listMessages, listWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateEpic, updateCaps, } from "./api.js";
+import { approveEpic, answerDecision, cancelTicket, cancelRun, mergeTicket, createEpic, deleteAgent, deleteEpic, getStatus, getRoadmap, getWorkspace, listAgents, listEpics, listHostEnv, listMessages, listWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage, queueTicket, removeWorkspaceEnv, removeHostEnv, setPaused, setWorkspaceEnv, setHostEnv, showTicket, updateAgent, updateEpic, updateCaps, } from "./api.js";
 import { formatDrainStatus, hostRoll, initHost, parseHostFlags, parseHostRollFlags } from "./host.js";
 import { login, parseLoginFlags } from "./login.js";
 import { loadConfig } from "./config.js";
@@ -89,6 +89,25 @@ async function cmdStatus() {
         console.log(`\n${c.bold("Chat replies")}  median ${seconds}s (last day)`);
     }
 }
+export function runAge(started, created, now = Date.now()) {
+    const seconds = Math.max(0, Math.floor((now - Date.parse(started ?? created)) / 1000));
+    return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
+}
+async function cmdRun(argv) {
+    if (argv[0] !== "cancel" || !argv[1] || argv.length !== 2)
+        fail("usage: hd run cancel ID");
+    const { run } = await cancelRun(argv[1]);
+    console.log(`${run.id}  cancellation requested`);
+}
+async function cmdRuns(argv) {
+    if (argv.length)
+        fail("usage: hd runs");
+    const [{ live_runs: runs }, { agents }] = await Promise.all([getStatus(), listAgents()]);
+    const names = new Map(agents.map((agent) => [agent.id, agent.display_name]));
+    console.log(table(["ID", "AGE", "KIND", "AGENT"], runs.map((run) => [
+        run.id, runAge(run.started_at, run.created_at), run.kind, names.get(run.agent_id ?? "") ?? run.provider,
+    ])));
+}
 async function cmdTicket(argv, deps = {}) {
     const [action, ...rest] = argv;
     if (action === "list") {
@@ -445,8 +464,10 @@ async function cmdAgents(argv, deps = {}) {
     };
     if (!Object.keys(fields).length)
         fail(agentUsage);
-    const { agent } = await updateAgent(current.id, fields);
+    const { agent, cancelled_runs = 0 } = await updateAgent(current.id, fields);
     console.log(`${agent.display_name}  ${agent.role}  ${agent.provider}  ${agent.model}  ${agent.enabled ? "on" : "off"}`);
+    if (cancelled_runs)
+        console.log(`cancellation requested for ${cancelled_runs} live run${cancelled_runs === 1 ? "" : "s"}`);
 }
 export function mailerCapsRow(auth) {
     if (auth === "smtp")
@@ -622,6 +643,14 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdTicket(rest, deps);
             return;
         }
+        if (cmd === "run") {
+            await cmdRun(rest);
+            return;
+        }
+        if (cmd === "runs") {
+            await cmdRuns(rest);
+            return;
+        }
         if (cmd === "epic") {
             await cmdEpic(rest);
             return;
@@ -658,7 +687,7 @@ export async function main(argv = process.argv.slice(2), deps = {}) {
             await cmdWorkspace(rest, deps);
             return;
         }
-        if (cmd === "agents") {
+        if (cmd === "agents" || cmd === "agent") {
             await cmdAgents(rest, deps);
             return;
         }

package/dist/out.js

@@ -65,6 +65,7 @@ export function usage() {
         c.bold("Usage"),
         `  ${c.blue("hd status")}                         workspace overview`,
         `  ${c.blue("hd ticket list | show KEY [--json] | new [PATH] | queue | cancel | merge")} ticket operations`,
+        `  ${c.blue("hd runs | hd run cancel ID")}          inspect or cancel live runs`,
         `  ${c.blue("hd epic new PATH | list | approve | rm")} epic operations`,
         `  ${c.blue("hd roadmap [--json]")}               ordered workspace roadmap`,
         `  ${c.blue("hd plan")}                           use /architect in the TUI`,

package/dist/tui/App.js

@@ -25,7 +25,7 @@ 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, mergeTicket, createEpicFromFile, decisionOptions, deleteAgent, deleteEpic, followChat, loadChatMessages, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, POLL_MS, pollSnapshot, postAgentMessage, postTicketMessage, queueTicket, resolveDecision, selectDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
+import { configuredSlugs, acknowledgeInbox, approveEpic, cancelTicket, cancelRun, mergeTicket, createEpicFromFile, decisionOptions, deleteAgent, deleteEpic, followChat, loadChatMessages, loadLiveEvents, listWorkspaceEnv, loadTicketDetail, POLL_MS, pollSnapshot, postAgentMessage, postTicketMessage, queueTicket, resolveDecision, selectDecision, setWorkspacePaused, switchWorkspace, updateAgent, updateProviderCap, updateWorkspace, } from "./data.js";
 import { inputActive, promptPlaceholder, settleChatReply } from "./chat-wait.js";
 import { answeredLine, decisionHeaderIndex, decisionIdAt, moveDecisionFocus, nextUnanswered, resolveDecisionAnswer, } from "./decide-nav.js";
 import { EARLIER_PAGE } from "./inbox.js";
@@ -315,16 +315,20 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
         }
         setBusy(true);
         try {
+            let message = null;
             if (edit.value.target === "cap") {
                 await updateProviderCap(config, edit.value.provider, edit.value.cap);
             }
             else if (edit.value.target === "agent") {
-                await updateAgent(config, edit.value.id, edit.value.fields);
+                const result = await updateAgent(config, edit.value.id, edit.value.fields);
+                const count = result.cancelled_runs ?? 0;
+                if (count)
+                    message = `Saved. Cancellation requested for ${count} live run${count === 1 ? "" : "s"}.`;
             }
             else {
                 await updateWorkspace(config, edit.value.fields);
             }
-            setNotice(null);
+            setNotice(message);
             await refresh();
         }
         catch (error) {
@@ -425,7 +429,7 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                             activity: activity.lines,
                         },
                     }));
-                    if (followShouldStop(follow.run, follow.reply)) {
+                    if (followShouldStop(follow.run, follow.reply, follow.tagged)) {
                         const settled = settleChatReply(follow.reply, follow.run);
                         setThread(key, (current) => ({
                             ...current,
@@ -767,6 +771,20 @@ export function App({ initial, availableUpdate: initialUpdate = null, updateDeps
                     setBusy(false);
                 }
                 return;
+            case "cancel-run":
+                setBusy(true);
+                try {
+                    await cancelRun(config, action.id);
+                    say("system", `Cancellation requested for run ${action.id}.`);
+                    await refresh();
+                }
+                catch (error) {
+                    setNotice(error instanceof Error ? error.message : String(error));
+                }
+                finally {
+                    setBusy(false);
+                }
+                return;
             case "merge":
                 setBusy(true);
                 try {

package/dist/tui/Help.js

@@ -10,7 +10,7 @@ export const COMMANDS = [
     { 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: "/cancel", args: "HD-12 | RUN-ID", help: "cancel a ticket or run" },
     { name: "/merge", args: "HD-12", help: "approve a reviewed PR over the reviewer's objections" },
     { name: "/msg", args: "HD-12 TEXT", help: "message a ticket's builder" },
     { name: "/attach", args: "PATH [HD-12]", help: "attach a file to the open or named ticket" },

package/dist/tui/chat-view.js

@@ -91,10 +91,16 @@ export function pendingActivity(events, run, label, now = Date.now()) {
         lines: narrateEvents(events).map((line) => line.title),
     };
 }
-export function followShouldStop(run, reply) {
+export function followShouldStop(run, reply, tagged = false) {
     if (reply)
         return true;
-    if (run && ["failed", "killed"].includes(run.status))
+    if (!run)
+        return false;
+    if (["failed", "killed", "cancelled"].includes(run.status))
+        return true;
+    // The role's other runs may finish while ours is still queued; only the run
+    // started for this message is definitive when it ends without a reply.
+    if (tagged && !["queued", "running"].includes(run.status))
         return true;
     return false;
 }

package/dist/tui/chat-wait.js

@@ -15,6 +15,12 @@ export function failedChatNote(reason) {
     const detail = reason?.trim();
     return detail ? `${NO_REPLY_NOTE} ${detail}` : NO_REPLY_NOTE;
 }
+/** A run that finished without writing a reply message: show what it did instead. */
+export const NO_REPLY_WRITTEN = "Finished without a reply.";
+export function finishedWithoutReplyNote(summary) {
+    const detail = summary?.trim();
+    return detail ? `${NO_REPLY_WRITTEN} ${detail}` : NO_REPLY_WRITTEN;
+}
 export function answeredIn(ms) {
     return `answered in ${Math.max(0, Math.round(ms / 1000))}s`;
 }
@@ -22,8 +28,12 @@ export function settleChatReply(reply, run) {
     if (reply) {
         return { body: reply, pending: false, steps: [], done: true, replyMs: run?.reply_ms ?? null };
     }
-    if (run && ["failed", "killed"].includes(run.status ?? "")) {
+    if (run && ["failed", "killed", "cancelled"].includes(run.status ?? "")) {
         return { body: failedChatNote(run.summary), pending: false, steps: [], done: true, replyMs: run.reply_ms ?? null };
     }
+    if (run && run.status && !["queued", "running"].includes(run.status)) {
+        return { body: finishedWithoutReplyNote(run.summary), pending: false, steps: [], done: true,
+            replyMs: run.reply_ms ?? null };
+    }
     return { body: "", pending: true, steps: [], done: false, replyMs: null };
 }

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, getRoadmap, getRun, getWorkspace, listAgents, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage as sendMessage, mergeTicket as mergeTicketNow, 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, cancelRun as cancelRunNow, createAgent as postAgent, createEpic as postEpic, deleteEpic as removeEpic, getStatus, getRoadmap, getRun, getWorkspace, listAgents, listFeed, listMessages, markMessagesDelivered, listWorkspaceEnv as getWorkspaceEnv, listTicketRunEvents, listTickets, listWorkspaces, postMessage as sendMessage, mergeTicket as mergeTicketNow, 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";
@@ -70,6 +70,7 @@ export async function loadSnapshot(config = loadConfig(), options = {}) {
                 chat: Number(workspaceData.workspace.settings.max_turns?.chat ?? 8),
             },
             max_attempts: Number(workspaceData.workspace.settings.max_attempts ?? 3),
+            chat_timeout_ms: Number(workspaceData.workspace.settings.chat_timeout_ms ?? 600_000),
         },
         board: {
             tickets,
@@ -129,6 +130,9 @@ export async function postAgentMessage(role, body, config, attachmentIds = []) {
         attachment_ids: attachmentIds }, config);
     return message;
 }
+export async function cancelRun(config, id) {
+    await cancelRunNow(id, config);
+}
 export async function loadChatMessages(config, role) {
     const { messages } = await listMessages({
         unticketed: true,
@@ -156,7 +160,7 @@ export async function followChat(config, role, messageId, since) {
     const reply = messages.find((message) => message.from_role === role
         && ["human", "operator", "all"].includes(message.to_role)
         && (!run || !message.run_id || message.run_id === run.id));
-    return { run, events, reply: reply?.body_md ?? null };
+    return { run, events, reply: reply?.body_md ?? null, tagged: Boolean(tagged) };
 }
 export async function loadTicketDetail(config, key) {
     const { ticket, pr, events, runs, messages, decisions, attachments } = await showTicket(key, config);

package/dist/tui/parse.js

@@ -79,7 +79,9 @@ export function parseLine(raw) {
                 ? { kind: "queue", key: argument.toUpperCase() }
                 : { kind: "unknown", command: "queue needs a key" };
         case "cancel":
-            return argument ? { kind: "cancel", key: argument.toUpperCase() }
+            return argument ? /^HD-\d+$/i.test(argument)
+                ? { kind: "cancel", key: argument.toUpperCase() }
+                : { kind: "cancel-run", id: argument }
                 : { kind: "unknown", command: "cancel needs a key" };
         case "merge":
             return argument ? { kind: "merge", key: argument.toUpperCase() }

package/dist/tui/settings-model.js

@@ -12,6 +12,7 @@ export function settingsRows(workspace, agents) {
             value: String(workspace.max_turns[kind]), hint: "integer >= 1",
         })),
         { key: "w:max_attempts", kind: "number", label: "max attempts", value: String(workspace.max_attempts) },
+        { key: "w:chat_timeout_ms", kind: "number", label: "chat timeout ms", value: String(workspace.chat_timeout_ms ?? 600_000) },
     ];
     for (const provider of providers) {
         rows.push({
@@ -81,6 +82,12 @@ export function editFor(row, raw) {
                 return { ok: false, error: "max_attempts must be an integer >= 1." };
             return { ok: true, value: { target: "workspace", fields: { max_attempts: number } } };
         }
+        if (id === "chat_timeout_ms") {
+            const number = Number(value);
+            if (!Number.isInteger(number) || number < 1_000)
+                return { ok: false, error: "chat_timeout_ms must be an integer >= 1000." };
+            return { ok: true, value: { target: "workspace", fields: { chat_timeout_ms: number } } };
+        }
         if (id === "auto_merge")
             return { ok: true, value: { target: "workspace", fields: { auto_merge: value === "yes" } } };
         if (!value)

package/dist/tui/stream.js

@@ -39,7 +39,7 @@ export function toStreamLines(events, runs, raw = false) {
         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",
+            kind: ["failed", "killed", "cancelled"].includes(run.status) ? "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);

package/dist/workspace-commands.js

@@ -150,6 +150,12 @@ export async function workspaceSet(argv) {
             throw new Error("--max-attempts must be an integer >= 1");
         fields.max_attempts = value;
     }
+    if (opts["chat-timeout-ms"]) {
+        const value = Number(opts["chat-timeout-ms"]);
+        if (!Number.isInteger(value) || value < 1_000)
+            throw new Error("--chat-timeout-ms must be an integer >= 1000");
+        fields.chat_timeout_ms = value;
+    }
     if (!Object.keys(fields).length)
         throw new Error(WORKSPACE_USAGE);
     return (await updateWorkspace(fields)).workspace;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@higherdev/cli",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "type": "module",
   "repository": {
     "type": "git",