@cmgmyr/hive 1.9.0 → 1.10.0

package/dist/tools/agents.js

@@ -10,12 +10,14 @@ import { currentActor, findProjectForDir, getProject, linkedWorktreePrimaryRoot,
 import { commandHead, harnessFor, harnessNames, readOnlyExtraArgsAllowed, paneClassifierFor, resolvedCommandPrefix, screenClassifiable, } from "../harnesses.js";
 import { ensureWorkerHooksFile } from "../hooks.js";
 import { activeProfile, allowedAgents, loadProjectYml } from "../projectYml.js";
-import { classifyMiss, LEAD_MESSAGE_THRESHOLD, leadPointerMarker, missMessage, readLeadMessage, renderLeadPointer, senderTag, shortenedSendFailureClause, shortenedSendNote, storeLeadMessage, } from "../leadMessage.js";
+import { classifyMiss, DELIVERY_FIELDS, LEAD_MESSAGE_THRESHOLD, leadPointerMarker, missMessage, readLeadMessage, renderLeadPointer, senderTag, shortenedSendFailureClause, shortenedSendNote, storeLeadMessage, } from "../leadMessage.js";
+import { sendQuietLeadMessage } from "../leadMessageDelivery.js";
 import { run } from "../result.js";
 import { markGoneReported } from "../scheduler.js";
 import { agentIdentityEnv, branchAt, closeAgentRow, currentOwnership, discardOrphanedPane, isReservedAgentName, isRunningLeadActor, killAgentPane, launchAgent, LEAD_KIND, PaneOwnershipLost, paneIdentity, parkAgentRow, reapCodexHomeForClosedAgent, requireStillOwned, releaseParkRow, renameAgent, resumeAgent, storedLaunchOptions, } from "../spawn.js";
 import { COMMAND_KIND, runningCommandRow, stopLine, stopProcess, STOP_REASONS } from "../processes.js";
 import { readContextTokens, readContextFill, resolveTranscriptDir } from "../transcript.js";
+import { leadSessionEnded } from "../leadState.js";
 import { capturePane, captureFinalScreen, DEFAULT_LAYOUT, cancelCopyMode, describePaneChoice, ensureAttached, findUnsafeControlChar, holdsHumanInput, liveTargets, observationFailed, observeRowOwnership, ownershipLiveness, paneCurrentCommand, paneInCopyMode, paneWindow, pollPaneReadiness, rowOwnership, sendText, sessionName, setRemainOnExit, sleep, TEXT_ALLOWED_CONTROL_CHARS, tmux, TmuxTimeoutError, WINDOW_LAYOUTS, } from "../tmux.js";
 import { agentIdParam, agentNameParam, idParam, projectIdParam } from "./params.js";
 import { deriveProvenance, lastLogEvent, lastPermissionMode, reportsAgentStateLog, } from "../stateProvenance.js";
@@ -356,7 +358,7 @@ function paneField(row, alive) {
     return { pane: describePaneChoice(awaitingChoice) };
 }
 function agentSummary(row, snapshot) {
-    const alive = summaryLiveness(row, snapshot);
+    const { alive, dormant } = row.kind === LEAD_KIND ? leadSummaryLiveness(row, snapshot) : { alive: summaryLiveness(row, snapshot), dormant: null };
     const { state, ...provenance } = deriveProvenance(row, alive);
     return {
         agent_id: row.id,
@@ -377,7 +379,9 @@ function agentSummary(row, snapshot) {
         command: row.command,
         cwd: row.cwd,
         parent_actor_id: row.parent_actor_id,
+        todo_id: row.todo_id,
         created_at: row.created_at,
+        ...(dormant ? { dormant_since: dormant.ended_at } : {}),
     };
 }
 export function contextCheckpointEnv(config) {
@@ -418,6 +422,9 @@ export function registerAgents(server) {
                 .describe("Spawn a known harness by name (e.g. \"codex\") instead of a raw command. Ignored when command is also given. Must be in the project's hive.yml agents: list (default: claude only)."),
             extra_args: z.array(z.string()).optional().describe("Extra CLI arguments."),
             read_only: z.boolean().optional().describe("Prevent local file writes and mutating shell commands while allowing Hive MCP tools. Only bare claude/codex executables. Extra args allow codex -c model_reasoning_effort=low|medium|high|xhigh, or claude --effort low|medium|high|xhigh|max; all other arguments are refused."),
+            todo_id: idParam
+                .optional()
+                .describe("The todo this worker is on, recorded as a link (a non-archived todo in the same project). Changes no todo status."),
             cwd: z
                 .string()
                 .optional()
@@ -467,6 +474,20 @@ export function registerAgents(server) {
                 throw new Error(`cwd ${cwd} belongs to project "${cwdProject.name}" (id ${cwdProject.id}), but this spawn resolved to project "${project.name}" (id ${project.id}). ${remedy}`);
             }
         }
+        if (args.todo_id !== undefined) {
+            const linked = db
+                .prepare("SELECT archived_at FROM todos WHERE id = ? AND project_id = ?")
+                .get(args.todo_id, project.id);
+            if (!linked)
+                throw new Error(`todo_id ${args.todo_id} is not a todo in project "${project.name}" (id ${project.id}).`);
+            if (linked.archived_at != null)
+                throw new Error(`todo_id ${args.todo_id} is archived; unarchive it or link another todo.`);
+        }
+        const omittedTodoWarning = args.todo_id === undefined && db
+            .prepare("SELECT 1 FROM todos WHERE project_id = ? AND status = 'in_progress' AND archived_at IS NULL LIMIT 1")
+            .get(project.id)
+            ? "todo_id was omitted while this project has an in-progress todo; the crew view may infer a link from this worker's comments or pad updates."
+            : undefined;
         const name = args.name != null
             ? normalizeAgentName(args.name, "name")
             : nextWorkerName(project.id);
@@ -565,6 +586,7 @@ export function registerAgents(server) {
                 model: args.model,
                 extraArgs: args.extra_args,
                 readOnly: args.read_only,
+                todoId: args.todo_id,
                 retainOnExit: harness.classifiesPaneScreen,
             });
         }
@@ -621,7 +643,7 @@ export function registerAgents(server) {
             }
         }
         const codexInstructions = codexHomeKey ? codexInstructionsPhrase(codexInstructionLayers) : undefined;
-        return {
+        const receipt = {
             agent_id: agentId,
             ...(args.read_only ? { read_only: true } : {}),
             actor_id: actorId,
@@ -670,6 +692,11 @@ export function registerAgents(server) {
                             "Wakes aimed at this worker are refused for the same reason.",
                     }),
         };
+        if (omittedTodoWarning) {
+            const existingNote = typeof receipt.note === "string" ? receipt.note : "";
+            receipt.note = existingNote ? `${existingNote} ${omittedTodoWarning}` : omittedTodoWarning;
+        }
+        return receipt;
     }));
     server.registerTool("agent_resume", {
         description: "Resume a CLOSED claude or codex worker from its recorded session id (claude --resume / codex resume): a fresh pane, the same actor_id, and the worker's full prior context. Addressed by name or agent_id among closed agents (agent_list(include_closed: true)). Send it its next instruction with agent_send once resumed - this tool does not.",
@@ -1126,7 +1153,7 @@ export function registerAgents(server) {
         };
     }));
     server.registerTool("agent_send", {
-        description: "Type into an agent's terminal, addressed by name (or agent_id). text of any shape is prefixed with the sender tag, delivered as one bracketed paste and submitted with Enter unless submit=false. ONE EXCEPTION: text over 300 characters sent to a LEAD by anyone who is not that lead is stored and delivered as a one-line pointer instead, because a lead's pane is a human's own window; the receipt says so and names agent_message_get for the full text. Worker-bound text is never shortened at any length. Alternatively pass keys (tmux key names like Escape, C-c, Enter). wait_ms (250-10000) returns the terminal tail after sending. A claude worker is already briefed by agent_spawn. A worker whose screen hive cannot classify is REFUSED on the text path entirely (its brief is at the spawn receipt's brief_path); keys still reaches it. A pane in tmux copy mode is REFUSED too, and retriably: tmux clears its bracketed-paste flag there, so the paste would lose its markers and the Enter would be eaten - leave copy mode (or agent_send(keys: [\"-X\", \"cancel\"]) to cancel it deliberately) and send again.",
+        description: "Type into an agent's terminal, addressed by name (or agent_id). text of any shape is prefixed with the sender tag, delivered as one bracketed paste and submitted with Enter unless submit=false. ONE EXCEPTION: text over 300 characters sent to a LEAD by anyone who is not that lead is stored and delivered as a one-line pointer instead, because a lead's pane is a human's own window; the receipt says so and names agent_message_get for the full text. Worker-bound text is never shortened at any length. With quiet_messaging on, a worker's submitted text to a Claude lead is stored with a message id and posted over the lead's messaging socket instead of typed (the same pointer when over 300 characters): the receipt says pending until the lead's prompt confirms it, hive types it into the pane once if no confirmation comes, and the socket post skips the pane checks below; do not resend a pending send. Alternatively pass keys (tmux key names like Escape, C-c, Enter). wait_ms (250-10000) returns the terminal tail after sending. A claude worker is already briefed by agent_spawn. A worker whose screen hive cannot classify is REFUSED on the text path entirely (its brief is at the spawn receipt's brief_path); keys still reaches it. A pane in tmux copy mode is REFUSED too, and retriably: tmux clears its bracketed-paste flag there, so the paste would lose its markers and the Enter would be eaten - leave copy mode (or agent_send(keys: [\"-X\", \"cancel\"]) to cancel it deliberately) and send again.",
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
@@ -1151,6 +1178,7 @@ export function registerAgents(server) {
         let outgoing = args.text ?? "";
         const tag = senderTag(project.id, currentActor());
         let shortened = null;
+        let boxBefore = null;
         const withShortened = (receipt) => shortened === null
             ? receipt
             : {
@@ -1183,6 +1211,32 @@ export function registerAgents(server) {
                     "turning a text call into a keys call. Tab and newline are the only control characters " +
                     'allowed. To send an actual keystroke on purpose, use keys instead (e.g. keys: ["C-c"]).');
             }
+            const quiet = await sendQuietLeadMessage({
+                projectId: project.id,
+                fromActor: currentActor(),
+                target: agent,
+                text: args.text,
+                submit: args.submit !== false,
+            });
+            if (quiet !== null) {
+                if (quiet.sent) {
+                    confirmQueenWrite("agent_send", project.id, args, { sent: true, agent_id: agent.id }, auditIdentity);
+                }
+                if (args.wait_ms == null)
+                    return quiet;
+                await sleep(Math.min(Math.max(args.wait_ms, 250), 10000));
+                try {
+                    if (observeOwnership(agent) !== "live")
+                        throw new Error("not live");
+                    return { ...quiet, tail: capturePane(target, 15) };
+                }
+                catch {
+                    return {
+                        ...quiet,
+                        tail_note: "The terminal tail could not be read after the wait (the pane may have died or changed owner).",
+                    };
+                }
+            }
             if (!screenClassifiable(agent.command)) {
                 return {
                     agent_id: agent.id,
@@ -1235,7 +1289,9 @@ export function registerAgents(server) {
                 };
             }
             if (submitting) {
-                const box = sendClassifier.inputBoxState(target);
+                const snapshot = readInputBox(sendClassifier, target);
+                const box = snapshot?.box ?? null;
+                boxBefore = inputBoxBefore(snapshot);
                 if (holdsHumanInput(box)) {
                     return {
                         agent_id: agent.id,
@@ -1319,12 +1375,13 @@ export function registerAgents(server) {
                 sent: true,
                 ...tailField,
                 ...inputBoxField(agent.command, target),
+                ...(boxBefore === null ? {} : { input_box_before: boxBefore }),
             });
         }
         return withShortened({ agent_id: agent.id, name: agent.name, sent: true });
     }));
     server.registerTool("agent_message_get", {
-        description: "Read one agent-to-lead message in full, by the id in a \"[hive:worker NAME] [message #N ...]\" pointer line. hive stores a message here only when it shortens one: text over 300 characters sent to a lead by someone who is not that lead. Every other send is typed with its sender tag and stores nothing, so there is no id to read. Messages are pruned after 7 days, and a lookup for a pruned id says so rather than reporting it missing.",
+        description: "Read one agent-to-lead message in full, by the id in a \"[hive:worker NAME] [message #N ...]\" pointer line. hive stores a message here when it shortens one (text over 300 characters sent to a lead by someone who is not that lead) and, with quiet_messaging on, for every submitted worker send to a Claude lead, whose result then also carries its delivery state (delivery_status, delivery_method, socket_attempt_at, confirmed_at, fallback_claimed_at, typed_at, delivery_note and the accepted target). Every other send is typed with its sender tag and stores nothing, so there is no id to read. Messages are pruned after 7 days, and a lookup for a pruned id says so rather than reporting it missing.",
         annotations: {
             readOnlyHint: false,
             destructiveHint: false,
@@ -1349,6 +1406,9 @@ export function registerAgents(server) {
             chars: row.text.length,
             created_at: row.created_at,
             text: row.text,
+            ...(row.delivery_status === null
+                ? {}
+                : Object.fromEntries(DELIVERY_FIELDS.map((field) => [field, row[field]]))),
         };
     }));
     server.registerTool("agent_output", {
@@ -1528,3 +1588,26 @@ export function registerAgents(server) {
         };
     }));
 }
+function inputBoxBefore(snapshot) {
+    if (snapshot === null)
+        return { state: "unreadable" };
+    const { box, rows, promptSgr } = snapshot;
+    const sgr = promptSgr ? { prompt_sgr: promptSgr } : {};
+    const withRows = rows === undefined ? {} : { rows };
+    if (box === null)
+        return { state: "not_found", ...withRows, ...sgr };
+    if (box.state === "ghost")
+        return { state: "ghost", ...sgr };
+    return { state: box.state, text: box.text, ...withRows, ...sgr };
+}
+function readInputBox(classifier, target) {
+    if (classifier.inputBoxSnapshot)
+        return classifier.inputBoxSnapshot(target);
+    const box = classifier.inputBoxState(target);
+    return box === null ? null : { box };
+}
+function leadSummaryLiveness(row, snapshot) {
+    const ownership = row.status === "running" ? rowOwnership(row, snapshot) : null;
+    const alive = ownership === null ? false : ownershipLiveness(ownership);
+    return { alive, dormant: ownership === null ? null : leadSessionEnded(row, ownership) };
+}

package/dist/tools/wakes.js

@@ -112,9 +112,23 @@ function deliveryState(t, hasChannel) {
                         ? "unconfirmed_busy"
                         : "unconfirmed",
         delivery_method: t.delivery_method,
+        delivered_by: t.delivered_by,
         socket_attempt_at: t.socket_attempt_at,
     };
 }
+function deliveredByNote(t) {
+    if (t.delivery_method === null)
+        return null;
+    if (t.delivered_by === null)
+        return "delivered by a hive build older than this field";
+    if (t.repeat_every_ms === null)
+        return null;
+    const firing = t.delivered_by.match(/, firing #(\d+)$/);
+    return firing !== null && Number(firing[1]) !== t.fire_count
+        ? `firing #${t.fire_count} was claimed by a hive build older than this field; ` +
+            "that build types it into the pane and does not record delivered_by"
+        : null;
+}
 export const truncateBody = (body) => body.length > 120 ? `${cutToUnitBudget(body, 120)}…` : body;
 function rejectUnsafeBody(body) {
     const bad = findUnsafeControlChar(body, TEXT_ALLOWED_CONTROL_CHARS);
@@ -486,8 +500,13 @@ export function registerWakes(server) {
     server.registerTool("wake_get", {
         description: "Read one wake-up by id, in this project, with its UNTRUNCATED body. wake_list truncates " +
             "body at 120 chars; use this to see exactly what a wake will say, or to confirm what " +
-            "wake_update just changed. Its delivery state includes delivery_method (socket, pty or " +
-            "pty-after-socket-timeout) and socket_attempt_at, set when a wake was posted to a Claude lead's socket.",
+            "wake_update just changed. Its delivery state includes delivery_method (socket, socket-repeating, pty or " +
+            "pty-after-socket-timeout), delivered_by (the pid and build of the server that last set the delivery method, " +
+            "plus the firing number for repeating wakes), " +
+            "and socket_attempt_at, set when a wake was posted to a Claude lead's socket; " +
+            "for a repeating wake both describe its current firing (fire_count). An older repeat claim is " +
+            "identified in delivered_by_note as a claim; the older build types the firing into the pane " +
+            "without recording delivered_by.",
         annotations: {
             readOnlyHint: false,
             destructiveHint: false,
@@ -511,6 +530,7 @@ export function registerWakes(server) {
             repeating: t.repeat_every_ms != null,
             fire_count: t.fire_count,
             cancelled_at: t.cancelled_at,
+            delivered_by_note: deliveredByNote(t),
             first_held_at: t.first_held_at,
             ...deliveryState(t, hasChannel),
         };
@@ -626,7 +646,7 @@ export function registerWakes(server) {
     server.registerTool("wake_list", {
         description: "List pending wake-ups in this project, plus recently_delivered: the last " +
             `${RECENTLY_FIRED_LIMIT} one-shot wakes that have already fired, with their delivery ` +
-            "state (typed_at, held_at/held_reason, confirmation, delivery_method, socket_attempt_at). A one-shot wake leaves the " +
+            "state (typed_at, held_at/held_reason, confirmation, delivery_method, delivered_by, socket_attempt_at). A one-shot wake leaves the " +
             "pending list the moment it fires; recently_delivered is where to check whether it " +
             "was actually typed and, if its target has a confirmation channel, acknowledged.",
         annotations: {

package/dist/transcript.js

@@ -35,6 +35,9 @@ function usageTokens(record) {
     return tokenNumber(sum) && sum > 0 ? sum : null;
 }
 function tailRecords(path) {
+    return tailRead(path).records;
+}
+function tailRead(path) {
     let fd;
     try {
         fd = openSync(path, "r");
@@ -54,10 +57,10 @@ function tailRecords(path) {
             }
             catch { }
         }
-        return records;
+        return { records, clipped: start > 0 };
     }
     catch {
-        return [];
+        return { records: [], clipped: false };
     }
     finally {
         if (fd !== undefined)
@@ -124,3 +127,133 @@ export function readContextTokens(cwd, sessionId, explicitPath = "") {
         return null;
     return claudeTokens(tailRecords(transcriptPath(cwd, sessionId, explicitPath)));
 }
+export const RECENT_TOOL_CALLS = 8;
+export const SKILL_TOOL = "Skill";
+export function lastComponent(name) {
+    return name.split(/__|[.:/]/).filter(Boolean).pop() ?? name;
+}
+function timestamp(record) {
+    return typeof record.timestamp === "string" && record.timestamp !== "" ? record.timestamp : null;
+}
+function reviewMarker(texts, at, skills) {
+    for (const skill of skills) {
+        const invocation = new RegExp(`^\\s*\\$${skill.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?![\\w-])`, "m");
+        if (texts.some((text) => typeof text === "string" && invocation.test(text))) {
+            return [{ name: SKILL_TOOL, input: { skill }, at }];
+        }
+    }
+    return [];
+}
+function claudeToolCalls(record, options) {
+    if (record.type !== "assistant")
+        return [];
+    const content = object(record.message)?.content;
+    if (!Array.isArray(content))
+        return [];
+    const at = timestamp(record);
+    const calls = [];
+    for (const part of content) {
+        const block = object(part);
+        if (!block)
+            continue;
+        if (block.type === "tool_use" && typeof block.name === "string") {
+            calls.push({ name: block.name, input: object(block.input) ?? {}, at });
+        }
+        else if (block.type === "text") {
+            calls.push(...reviewMarker([block.text], at, options.reviewSkills ?? []));
+        }
+    }
+    return calls;
+}
+function stringLiteral(text) {
+    const quote = text[0];
+    if (quote !== '"' && quote !== "'")
+        return null;
+    const json = quote === '"' ? text : `"${text.slice(1, -1).replace(/\\'/g, "'").replace(/(\\.)|"/g, (m, esc) => esc ?? '\\"')}"`;
+    try {
+        const value = JSON.parse(json);
+        return typeof value === "string" ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+function execInnerCalls(source, at) {
+    const marks = [...source.matchAll(/\btools\.([A-Za-z_]\w*)\s*\(/g)];
+    if (marks.length === 0)
+        return null;
+    const calls = [];
+    marks.forEach((mark, i) => {
+        const name = lastComponent(mark[1]);
+        if (name === "write_stdin")
+            return;
+        if (name === "exec_command") {
+            const span = source.slice(mark.index + mark[0].length, marks[i + 1]?.index ?? source.length);
+            const cmd = /["']?\bcmd["']?\s*:\s*("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*')/.exec(span);
+            const command = cmd ? stringLiteral(cmd[1]) : null;
+            if (command !== null)
+                calls.push({ name: "Bash", input: { command }, at });
+            return;
+        }
+        calls.push({ name, input: {}, at });
+    });
+    return calls;
+}
+function codexToolCalls(record, options) {
+    const payload = object(record.payload);
+    if (record.type !== "response_item" || !payload)
+        return [];
+    const at = timestamp(record);
+    if (payload.type === "message") {
+        if (payload.role !== "assistant" || !Array.isArray(payload.content))
+            return [];
+        return reviewMarker(payload.content.map((part) => object(part)?.text), at, options.reviewSkills ?? []);
+    }
+    if (typeof payload.name !== "string")
+        return [];
+    const name = lastComponent(payload.name);
+    if (payload.type === "custom_tool_call") {
+        if (name === "exec" && typeof payload.input === "string") {
+            const inner = execInnerCalls(payload.input, at);
+            if (inner)
+                return inner;
+        }
+        return [{ name, input: typeof payload.input === "string" ? { input: payload.input } : {}, at }];
+    }
+    if (payload.type !== "function_call")
+        return [];
+    if (name === "write_stdin" || name === "sleep")
+        return [];
+    let args = {};
+    if (typeof payload.arguments === "string") {
+        try {
+            args = object(JSON.parse(payload.arguments)) ?? {};
+        }
+        catch { }
+    }
+    if (name === "exec_command")
+        return typeof args.cmd === "string" ? [{ name: "Bash", input: { command: args.cmd }, at }] : [];
+    return [{ name, input: args, at }];
+}
+export function readRecentToolCalls(kind, worker, options = {}) {
+    const path = worker.transcript_path || (kind === "claude" && worker.session_id
+        ? join(transcriptDir(worker.cwd), `${worker.session_id}.jsonl`) : "");
+    if (!path)
+        return { calls: [], truncated: false };
+    const { records, clipped } = tailRead(path);
+    const newestFirst = [];
+    let capped = false;
+    for (const record of records) {
+        const calls = (kind === "claude" ? claudeToolCalls : codexToolCalls)(record, options);
+        for (let i = calls.length - 1; i >= 0; i--) {
+            if (newestFirst.length === RECENT_TOOL_CALLS) {
+                capped = true;
+                break;
+            }
+            newestFirst.push(calls[i]);
+        }
+        if (capped)
+            break;
+    }
+    return { calls: newestFirst.reverse(), truncated: clipped || capped };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmgmyr/hive",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Run a crew of Claude Code and Codex workers from one lead session: visible tmux panes, exact state from hooks, one local SQLite store.",
   "type": "module",
   "bin": {