agent-coord-mcp 0.17.0 → 0.18.0

package/dist/work.js

@@ -0,0 +1,260 @@
+// Work state as data (Phase 8 Task 5): queue items, done entries and board
+// rows as typed records, with markdown as a first-class EXPORT rather than the
+// datastore.
+//
+// WHY THIS SHAPE. `docs/QUEUE.md` / `docs/DONE.md` were parsed under a contract
+// requiring exact `—` (U+2014) and ` · ` (U+00B7). A parser once returned ZERO
+// items on the real file while passing every synthetic test, and the consuming
+// UI rendered an empty panel — no error, no signal. The files themselves are
+// good: David edits them, git diffs them, they grep. So markdown stays the
+// INTERFACE and stops being the DATASTORE.
+//
+// MARKDOWN REMAINS AUTHORITATIVE. Delete the store and the documents still
+// stand alone: every field here is recoverable from the file it came from, the
+// exporter is byte-exact, and nothing downstream is required to read records.
+// The store is a derived index until a consumer chooses otherwise.
+//
+// The round-trip guarantee is structural, not incidental: everything this
+// module does NOT model — prose, the write-rule paragraphs, the Cross-project
+// section, fenced examples — is captured verbatim as a `text` block and
+// replayed in place. Only lines it genuinely understands are re-rendered, so
+// an unmodelled construct can never be silently dropped.
+import { createHash } from "node:crypto";
+// ---------- the glyph contract ----------
+//
+// Pinned in docs/DONE.md and consumed by external parsers: the ref splits on
+// the LAST ` — ` (space, U+2014, space) and the date is a trailing ` · `
+// (space, U+00B7, space) + ISO date. Written as explicit escapes so a source
+// file normalization or a copy-paste through an ASCII-mangling tool can never
+// change them silently — the constants are the contract.
+export const EM_DASH_SEP = " — ";
+export const MIDDOT_SEP = " · ";
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+// Deterministic ids: same content in → same id out, so import→export→import is
+// stable and no id has to be written into the markdown (which would change the
+// bytes the round trip is measured on).
+function idFor(kind, seed) {
+    return `${kind}-${createHash("sha1").update(seed).digest("hex").slice(0, 8)}`;
+}
+// ---------- line-level recognizers ----------
+const QUEUE_LINE = /^- \[( |x)\] \((P1|P2|P3)\) (.*)$/;
+const DONE_LINE = /^- \[( |x)\] (.*)$/;
+export function parseQueueLine(line, section) {
+    const m = QUEUE_LINE.exec(line);
+    if (!m)
+        return null;
+    const [, mark, priority, text] = m;
+    return {
+        id: idFor("q", text ?? ""),
+        priority: priority,
+        text: text ?? "",
+        done: mark === "x",
+        ...(section ? { section } : {}),
+    };
+}
+// Split on the LAST ` — `, then peel a trailing ` · YYYY-MM-DD`. Both parts are
+// optional: an entry with neither is still a done entry, it just carries no
+// verifiable ref — which is a fact about the entry, not a parse failure. The
+// old parser treated the same line as nothing at all.
+export function parseDoneLine(line, section) {
+    const m = DONE_LINE.exec(line);
+    if (!m)
+        return null;
+    let body = m[2] ?? "";
+    let ref;
+    let date;
+    const cut = body.lastIndexOf(EM_DASH_SEP);
+    if (cut !== -1) {
+        const tail = body.slice(cut + EM_DASH_SEP.length);
+        const dot = tail.lastIndexOf(MIDDOT_SEP);
+        if (dot !== -1) {
+            const maybeDate = tail.slice(dot + MIDDOT_SEP.length);
+            if (ISO_DATE.test(maybeDate)) {
+                date = maybeDate;
+                ref = tail.slice(0, dot);
+            }
+        }
+        // A tail with no date is still a ref, as long as it isn't prose with
+        // spaces — refs are `owner/repo#N` or `owner/repo@sha`.
+        if (date === undefined && /^\S+$/.test(tail))
+            ref = tail;
+        if (ref !== undefined)
+            body = body.slice(0, cut);
+    }
+    return {
+        id: idFor("d", `${body}|${ref ?? ""}|${date ?? ""}`),
+        text: body,
+        ...(ref !== undefined ? { ref } : {}),
+        ...(date !== undefined ? { date } : {}),
+        ...(section ? { section } : {}),
+    };
+}
+export function renderQueueLine(item) {
+    return `- [${item.done ? "x" : " "}] (${item.priority}) ${item.text}`;
+}
+export function renderDoneLine(entry) {
+    let line = `- [x] ${entry.text}`;
+    if (entry.ref !== undefined)
+        line += `${EM_DASH_SEP}${entry.ref}`;
+    if (entry.date !== undefined)
+        line += `${MIDDOT_SEP}${entry.date}`;
+    return line;
+}
+// ---------- board table ----------
+const TABLE_ROW = /^\|(.*)\|\s*$/;
+const TABLE_ALIGN = /^\|[\s:|-]+\|\s*$/;
+function splitRow(line) {
+    const m = TABLE_ROW.exec(line);
+    if (!m)
+        return [];
+    return (m[1] ?? "").split("|").map((c) => c.trim());
+}
+function renderRow(cells) {
+    return `| ${cells.join(" | ")} |`;
+}
+function boardCells(r) {
+    return [r.lane, r.owner, r.state, r.currentSlice, r.nextGo];
+}
+// Replay the original line when the fields still say what it said; re-render
+// once anything actually changed.
+export function renderBoardRow(r) {
+    if (r.raw !== undefined) {
+        const cells = splitRow(r.raw);
+        if (cells.length === 5 && cells.every((c, i) => c === boardCells(r)[i]))
+            return r.raw;
+    }
+    return renderRow(boardCells(r));
+}
+// Which record kind a `## Heading` opens. `## Queue` → queue items,
+// `## Done` → done entries; anything else closes the record region, so the
+// Cross-project section's bullets stay verbatim prose.
+function sectionKindOf(heading) {
+    const h = heading.replace(/^#+\s*/, "").trim().toLowerCase();
+    if (h === "queue")
+        return "queue";
+    if (h === "done")
+        return "done";
+    return "none";
+}
+export function parseWorkDoc(source) {
+    const trailingNewline = source.endsWith("\n");
+    const lines = source.split("\n");
+    if (trailingNewline)
+        lines.pop(); // the split's empty tail, restored on render
+    const blocks = [];
+    let text = [];
+    let kind = "none";
+    let subsection;
+    let inFence = false;
+    const flushText = () => {
+        if (text.length)
+            blocks.push({ kind: "text", lines: text });
+        text = [];
+    };
+    // Consecutive item lines coalesce into one block; anything in between (a
+    // blank line, a subsection heading) flushes as text first and therefore
+    // starts a new one, which is what keeps rendering order faithful.
+    const pushItem = (item) => {
+        flushText();
+        const last = blocks[blocks.length - 1];
+        if (last?.kind === "queue")
+            last.items.push(item);
+        else
+            blocks.push({ kind: "queue", items: [item] });
+    };
+    const pushEntry = (entry) => {
+        flushText();
+        const last = blocks[blocks.length - 1];
+        if (last?.kind === "done")
+            last.entries.push(entry);
+        else
+            blocks.push({ kind: "done", entries: [entry] });
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? "";
+        // Fenced blocks are never interpreted — docs/DONE.md pins the done-line
+        // FORMAT inside a fence, and parsing that example as an entry would
+        // invent a record out of documentation.
+        if (/^\s*```/.test(line)) {
+            inFence = !inFence;
+            text.push(line);
+            continue;
+        }
+        if (inFence) {
+            text.push(line);
+            continue;
+        }
+        if (/^#{1,6}\s/.test(line)) {
+            const level = (line.match(/^#+/) ?? [""])[0].length;
+            if (level <= 2) {
+                kind = sectionKindOf(line);
+                subsection = undefined;
+            }
+            else if (kind !== "none") {
+                subsection = line.replace(/^#+\s*/, "").trim();
+            }
+            text.push(line);
+            continue;
+        }
+        if (kind === "queue") {
+            const item = parseQueueLine(line, subsection);
+            if (item) {
+                pushItem(item);
+                continue;
+            }
+        }
+        else if (kind === "done") {
+            const entry = parseDoneLine(line, subsection);
+            if (entry) {
+                pushEntry(entry);
+                continue;
+            }
+        }
+        // Lanes table: a header row followed by an alignment row.
+        if (TABLE_ROW.test(line) && TABLE_ALIGN.test(lines[i + 1] ?? "")) {
+            const rows = [];
+            let j = i + 2;
+            for (; j < lines.length && TABLE_ROW.test(lines[j] ?? ""); j++) {
+                const raw = lines[j] ?? "";
+                const [lane = "", owner = "", state = "", currentSlice = "", nextGo = ""] = splitRow(raw);
+                rows.push({ id: idFor("b", lane), lane, owner, state, currentSlice, nextGo, raw });
+            }
+            flushText();
+            blocks.push({ kind: "board", header: line, align: lines[i + 1] ?? "", rows });
+            i = j - 1;
+            continue;
+        }
+        text.push(line);
+    }
+    flushText();
+    return { trailingNewline, blocks };
+}
+export function renderWorkDoc(doc) {
+    const out = [];
+    for (const block of doc.blocks) {
+        if (block.kind === "text")
+            out.push(...block.lines);
+        else if (block.kind === "queue")
+            out.push(...block.items.map(renderQueueLine));
+        else if (block.kind === "done")
+            out.push(...block.entries.map(renderDoneLine));
+        else {
+            out.push(block.header);
+            out.push(block.align);
+            for (const r of block.rows)
+                out.push(renderBoardRow(r));
+        }
+    }
+    return out.join("\n") + (doc.trailingNewline ? "\n" : "");
+}
+// ---------- record extraction ----------
+export function queueItemsOf(doc) {
+    return doc.blocks.flatMap((b) => (b.kind === "queue" ? b.items : []));
+}
+export function doneEntriesOf(doc) {
+    return doc.blocks.flatMap((b) => (b.kind === "done" ? b.entries : []));
+}
+export function boardRowsOf(doc) {
+    return doc.blocks.flatMap((b) => (b.kind === "board" ? b.rows : []));
+}
+//# sourceMappingURL=work.js.map

package/dist/work.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work.js","sourceRoot":"","sources":["../src/work.ts"],"names":[],"mappings":"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"}

package/hooks/marker.mjs

@@ -0,0 +1,18 @@
+// The transport-marker rewrite contract, extracted so it is testable.
+//
+// The marker has TWO writers with different authority: attach_agent CREATES
+// it (authoritative — a fresh attach owns every field, including provenance
+// stamps like serverBuildMtime that only the server can know), and the pusher
+// REWRITES it at startup (partial — it owns its pid, target, and the
+// scriptMtime of the code it actually loaded, and must not touch the rest).
+//
+// A rewrite that rebuilds the marker from scratch drops every field the other
+// writer owns. That is not hypothetical: an earlier from-scratch rewrite
+// dropped scriptMtime and silently disabled doctor's stale-pusher-script
+// check for every local pusher — a marker field a rewrite can drop is a
+// health check that can be switched off by accident.
+export function mergeTransportMarker(existing, own) {
+  // Spread order IS the contract: fields this writer does not own survive;
+  // fields it does own win.
+  return { ...(existing && typeof existing === "object" ? existing : {}), ...own };
+}

package/hooks/roles.mjs

@@ -0,0 +1,79 @@
+// Canonical role identity (Phase 8 Task 4). Dependency-free and
+// side-effect-free: hooks/tier.mjs imports it on the delivery hot path, and it
+// must keep working from a bare checkout with no build step.
+//
+// The problem this exists for: a role's identity used to BE its display string,
+// so renaming it (curator → liaison → aide) churned every id, skill and script
+// that named it. Now the id is frozen and only the name moves.
+//
+// MIRROR: src/roles.ts carries the same logic for the server side — tsconfig's
+// rootDir is `src`, so TypeScript cannot import this file. test/roles.test.mjs
+// asserts the two stay in lockstep; if you change a rule or an id here, change
+// it there too.
+
+// Display text → role id. Lowercase, non-alphanumerics collapse to "-".
+export function slugifyRole(role) {
+  return String(role ?? "")
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+// A gate runner is the agent that consumes DONE: reports (QA / coordinator).
+export const GATE_RUNNER_ROLE_IDS = new Set(["qa", "quality", "coordinator", "gate"]);
+// Coordinators countersign work orders (`go`) and in-flight contract
+// amendments (`scope`).
+export const COORDINATOR_ROLE_IDS = new Set(["coordinator"]);
+
+// Normalize any role shape into {roleId, displayName, explicit}.
+//
+// `explicit` records whether the id was DECLARED (registry entry carries a
+// frozen roleId) or DERIVED from display text. It is the difference between
+// "this agent's identity is `gate`" and "this agent's name happens to contain
+// the word gate" — declared ids match exactly, derived ones fall back to the
+// legacy word match below so un-migrated registries keep behaving as they did.
+//
+// Accepts: a plain string, {roleId, displayName}, or an AgentEntry ({role,
+// roleId}) passed straight from the registry.
+export function resolveRole(role) {
+  if (role === null || role === undefined) return undefined;
+  if (typeof role === "string") {
+    const roleId = slugifyRole(role);
+    return roleId ? { roleId, displayName: role, explicit: false } : undefined;
+  }
+  if (typeof role === "object") {
+    const declared = typeof role.roleId === "string" ? slugifyRole(role.roleId) : "";
+    const name =
+      typeof role.displayName === "string" && role.displayName
+        ? role.displayName
+        : typeof role.role === "string" && role.role
+          ? role.role
+          : undefined;
+    if (declared) return { roleId: declared, displayName: name ?? declared, explicit: true };
+    if (name) return resolveRole(name);
+  }
+  return undefined;
+}
+
+// Does this role carry one of `allowedIds`?
+//
+// Declared ids must match exactly — that is the point of freezing them. A
+// derived id additionally matches on any of its hyphen-separated words, which
+// reproduces the pre-Task-4 prose regex (/\b(qa|quality|coordinator|gate)\b/i)
+// for registries that never declared a roleId.
+export function roleMatches(role, allowedIds) {
+  const resolved = resolveRole(role);
+  if (!resolved) return false;
+  if (allowedIds.has(resolved.roleId)) return true;
+  if (resolved.explicit) return false;
+  return resolved.roleId.split("-").some((word) => allowedIds.has(word));
+}
+
+export function isGateRunner(role) {
+  return roleMatches(role, GATE_RUNNER_ROLE_IDS);
+}
+
+export function isCoordinator(role) {
+  return roleMatches(role, COORDINATOR_ROLE_IDS);
+}

package/hooks/submit.mjs

@@ -0,0 +1,271 @@
+// Paste + submit, shared by BOTH pushers (hooks/tmux-pusher.mjs and
+// scripts/coord-pusher.mjs). One implementation on purpose: the two carried
+// copies of this pipeline and they had already drifted — the local one sent two
+// Enters with 100ms/50ms delays, the remote one sent a single Enter with no
+// delay at all. Same class of defect as three copies of the retention
+// predicate. Import it; do not re-implement it.
+//
+// tmux is injected (`run`, `runStdin`) so this module is pure logic and can be
+// tested without a terminal. It never imports node:child_process itself.
+
+function envInt(name, fallback) {
+  const n = Number(process.env[name]);
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : fallback;
+}
+
+// WHY THESE NUMBERS.
+//
+// The old defaults (100ms then 50ms) were picked for a multi-line PASTE
+// settling, not for a slash command. A real agent TUI does more on "/" than
+// accept text: it opens an autocomplete menu, which is rendered on a later
+// frame, and the first Enter is consumed selecting from that menu rather than
+// submitting. The command then sits in the input looking delivered — which is
+// exactly what David hit.
+//
+// 400ms is a frame-budget argument, not a measurement of one machine: a TUI
+// that re-renders at 60fps needs a handful of frames to open a menu, and
+// terminal apps commonly debounce input by 100-250ms. 400ms clears that with
+// margin while staying under the ~500ms a human reads as instant. 150ms
+// between Enters is the same reasoning at smaller scale — enough for the menu
+// to close and the input to settle before the submitting Enter.
+//
+// These are DEFAULTS, not guarantees. That is why verification exists below:
+// no delay can be proven sufficient on a machine we have not seen, so the
+// pipeline observes the result instead of trusting the clock.
+export const ENTER_DELAY_MS = () => envInt("AGENT_COORD_ENTER_DELAY_MS", 400);
+export const ENTER_GAP_MS = () => envInt("AGENT_COORD_ENTER_GAP_MS", 150);
+// How long to keep checking that the command actually left the input, and how
+// often. Bounded and finite — this must not spin, and it must not stall the
+// delivery loop behind a pane that will never change.
+export const VERIFY_TIMEOUT_MS = () => envInt("AGENT_COORD_SUBMIT_VERIFY_MS", 1500);
+export const VERIFY_POLL_MS = () => envInt("AGENT_COORD_SUBMIT_POLL_MS", 100);
+// Extra Enters to try when the first pair didn't submit. 0 disables retrying.
+export const ENTER_RETRIES = () => envInt("AGENT_COORD_ENTER_RETRIES", 2);
+// How long to wait for a BUSY pane to go idle before giving up on a control
+// command. 15s covers a short tool call or a model turn's tail; beyond that the
+// honest answer is "not now" rather than queueing a slash command behind a
+// turn that may run for minutes. 0 disables waiting (paste immediately).
+export const CONTROL_IDLE_WAIT_MS = () => envInt("AGENT_COORD_CONTROL_IDLE_WAIT_MS", 15000);
+
+// Pane-state patterns. Defaults match the Claude Code TUI, which is what the
+// bus drives; override for another TUI. Empty string disables that check.
+//
+// These exist because control commands fail in ways a delay cannot fix:
+//   BUSY  — the command lands in the TUI's queue and runs only when the
+//           current turn ends (observed: minutes later), while the receipt
+//           already said "confirmed".
+//   DRAFT — unsent text in the input; the paste APPENDS to it, so
+//           "draft I was typing" + "/compact" submits as an ordinary MESSAGE
+//           to the model. The command never runs at all and a model turn is
+//           burned on nonsense. This is the worst observed outcome.
+export const BUSY_PATTERN = () => envStr("AGENT_COORD_BUSY_PATTERN", "esc to interrupt");
+export const PROMPT_PATTERN = () => envStr("AGENT_COORD_PROMPT_PATTERN", "^\\s*[❯>]\\s?(.*)$");
+// Input-line content that means "empty" — placeholder hints, not real text.
+export const PLACEHOLDER_PATTERN = () =>
+  envStr("AGENT_COORD_PLACEHOLDER_PATTERN", '^(Try ".*"|Press up to edit queued messages|)$');
+
+function envStr(name, fallback) {
+  const v = process.env[name];
+  return v === undefined ? fallback : v;
+}
+
+
+export function sleep(ms) {
+  return new Promise((res) => setTimeout(res, ms));
+}
+
+// Normalize for comparison: a TUI re-wraps and re-pads its input box, so raw
+// substring matching on captured pane text is unreliable.
+function squash(s) {
+  return String(s ?? "").replace(/\s+/g, " ").trim();
+}
+
+// Is `payload` still sitting in the pane's INPUT LINE?
+//
+// It asks the input line specifically, and nothing else. The first version
+// squashed the last 20 lines of the whole pane and searched that window — but
+// Claude Code ECHOES a submitted command into the transcript directly above
+// the prompt box, inside that window. So a command that ran perfectly still
+// matched, and the verifier reported failure on success (David hit this live:
+// the pane read "Compacting conversation… 28%" while the receipt said the
+// command "did not run").
+//
+// It only ever passed in testing because a freshly spawned disposable session
+// has an empty scrollback — the one condition that hides a scrollback bug. The
+// lesson is narrower than "test on a real TUI": a check that reads scrollback
+// has to be tested against a pane that HAS scrollback.
+//
+// Returns true = still waiting in the input, false = gone (submitted),
+// null = UNKNOWN. Unknown is never upgraded to a confirmation: no pane text,
+// or no line matching AGENT_COORD_PROMPT_PATTERN, means we cannot tell.
+export function stillInInput(paneText, payload) {
+  if (paneText === null || paneText === undefined) return null;
+  const needle = squash(payload);
+  if (!needle) return false;
+  const { draft } = readPaneState(paneText);
+  if (draft === null) return null; // no recognizable input line — cannot tell
+  return squash(draft).includes(needle);
+}
+
+// Read the pane's input state: is the TUI busy, and is there unsent text?
+//
+// `null` for either field means UNKNOWN — the pane could not be captured, or
+// this TUI does not look like the one we know how to read. Unknown is never
+// treated as "fine": callers either proceed and fall back to verify-by-absence
+// or report the uncertainty, but they never upgrade it to a confirmation.
+export function readPaneState(paneText) {
+  if (paneText === null || paneText === undefined) return { busy: null, draft: null };
+  const text = String(paneText);
+  const busyRe = BUSY_PATTERN();
+  const busy = busyRe ? new RegExp(busyRe).test(text) : null;
+
+  const promptRe = PROMPT_PATTERN();
+  let draft = null;
+  if (promptRe) {
+    const re = new RegExp(promptRe);
+    const lines = text.split("\n").map((l) => l.replace(/\s+$/, ""));
+    // The LAST prompt line is the live input; earlier ones are history.
+    for (let i = lines.length - 1; i >= 0; i--) {
+      const m = re.exec(lines[i]);
+      if (!m) continue;
+      const content = (m[1] ?? "").trim();
+      const placeholder = PLACEHOLDER_PATTERN();
+      draft = placeholder && new RegExp(placeholder).test(content) ? "" : content;
+      break;
+    }
+  }
+  return { busy, draft };
+}
+
+// Submit a CONTROL command (/clear, /compact) — the path that must actually
+// run, not merely arrive.
+//
+// Refuses rather than corrupts. Pasting into a busy pane queues the command
+// behind a whole model turn; pasting onto a draft concatenates with it and
+// sends the result to the model as chat text. Both were previously reported as
+// delivery:"confirmed". Waiting briefly and then declining is slower and
+// louder — deliberately, because a control command that silently becomes a
+// chat message is worse than one that says it did not run.
+export async function submitControl(deps, payload) {
+  const { run, target } = deps;
+  const capture = () => {
+    const cap = run(["capture-pane", "-p", "-t", target]);
+    return cap.status === 0 ? String(cap.stdout ?? "") : null;
+  };
+
+  const idleBudget = CONTROL_IDLE_WAIT_MS();
+  const deadline = Date.now() + idleBudget;
+  let state = readPaneState(capture());
+  while (state.busy === true && idleBudget > 0 && Date.now() < deadline) {
+    await sleep(VERIFY_POLL_MS() * 5);
+    state = readPaneState(capture());
+  }
+  if (state.busy === true) {
+    return {
+      submitted: false,
+      verified: true,
+      pasted: false,
+      attempts: 0,
+      reason:
+        `pane '${target}' is still busy after ${idleBudget}ms — not pasted. A control command sent now would ` +
+        `queue behind the running turn instead of executing (raise AGENT_COORD_CONTROL_IDLE_WAIT_MS to wait longer).`,
+    };
+  }
+  if (state.draft) {
+    return {
+      submitted: false,
+      verified: true,
+      pasted: false,
+      attempts: 0,
+      reason:
+        `pane '${target}' has unsent text in its input (${JSON.stringify(state.draft.slice(0, 40))}…) — not pasted. ` +
+        `The command would have been appended to that draft and sent to the model as an ordinary message.`,
+    };
+  }
+  return pasteAndSubmit(deps, payload, { bracketed: false, verify: true });
+}
+
+// Paste a payload into the target pane and submit it.
+//
+// deps:
+//   runStdin(args, payload) -> Promise<void>   // tmux load-buffer -
+//   run(args) -> {status, stdout, stderr}      // spawnSync-shaped
+//   target, buffer                             // tmux -t target, buffer name
+//
+// Returns {submitted, verified, reason?, attempts}. For bracketed peer content
+// verification is skipped entirely (`verified:false`, `submitted:true`) — that
+// path pastes inert data on the hot path and has never been the problem; only
+// control commands are verified.
+export async function pasteAndSubmit(deps, payload, { bracketed = false, verify = false } = {}) {
+  const { run, runStdin, target, buffer } = deps;
+
+  await runStdin(["load-buffer", "-b", buffer, "-"], payload);
+  const paste = run(["paste-buffer", ...(bracketed ? ["-p"] : []), "-b", buffer, "-t", target, "-d"]);
+  if (paste.status !== 0) {
+    throw new Error(`tmux paste-buffer: ${String(paste.stderr ?? "").trim()}`);
+  }
+
+  await sleep(ENTER_DELAY_MS());
+  const e1 = run(["send-keys", "-t", target, "Enter"]);
+  if (e1.status !== 0) throw new Error(`tmux send-keys: ${String(e1.stderr ?? "").trim()}`);
+  await sleep(ENTER_GAP_MS());
+  run(["send-keys", "-t", target, "Enter"]);
+
+  if (!verify) return { submitted: true, verified: false, attempts: 1 };
+
+  const retries = ENTER_RETRIES();
+  for (let attempt = 1; ; attempt++) {
+    const outcome = await pollUntilGone(deps, payload);
+    if (outcome === false) return { submitted: true, verified: true, attempts: attempt };
+    if (outcome === null) {
+      return {
+        submitted: false,
+        verified: false,
+        attempts: attempt,
+        reason:
+          `could not read the input line of pane '${target}' to verify submission — the command was typed but may not have run ` +
+          `(pane capture failed, or no line matched AGENT_COORD_PROMPT_PATTERN for this TUI)`,
+      };
+    }
+    if (attempt > retries) {
+      return {
+        submitted: false,
+        verified: true, // we DID observe the pane; what we observed is failure
+        attempts: attempt,
+        reason:
+          `the command is still in the input of pane '${target}' after ${attempt} submit attempt(s) — ` +
+          `it was typed but did not run (raise AGENT_COORD_ENTER_DELAY_MS if this recurs)`,
+      };
+    }
+    // Still sitting there: one more Enter before giving up.
+    //
+    // Every retry re-verifies FIRST (the loop head above), so an Enter is only
+    // ever sent after we have just looked at the input line and seen the
+    // command still in it. That ordering is the whole safety argument: these
+    // are keystrokes into a live session someone else may be typing in, and an
+    // Enter sent on a stale reading would submit whatever they had drafted
+    // since. Under the old tail-window check this fired on EVERY successful
+    // submit — three Enters into a pane that had already run the command.
+    await sleep(ENTER_GAP_MS());
+    run(["send-keys", "-t", target, "Enter"]);
+  }
+}
+
+// Poll capture-pane until the payload leaves the input line, the budget runs
+// out, or we run out of ways to tell. true = still there, false = gone,
+// null = unknown (capture failed, or no input line we can read).
+async function pollUntilGone(deps, payload) {
+  const { run, target } = deps;
+  const deadline = Date.now() + VERIFY_TIMEOUT_MS();
+  let readInput = false;
+  for (;;) {
+    const cap = run(["capture-pane", "-p", "-t", target]);
+    if (cap.status === 0) {
+      const verdict = stillInInput(String(cap.stdout ?? ""), payload);
+      if (verdict === false) return false;
+      if (verdict === true) readInput = true; // we could read the input line
+    }
+    if (Date.now() >= deadline) return readInput ? true : null;
+    await sleep(VERIFY_POLL_MS());
+  }
+}