@mu-crew/mu 3.7.0 → 3.8.0

package/dist/index.js

@@ -68,7 +68,7 @@ var CtlUnknownOpError = class extends Error {
 function clientTimeout(req, override) {
   if (override !== void 0) return override;
   if (req.op === "fresh" || req.op === "command") return CTL_FRESH_TIMEOUT_MS;
-  if (req.op !== "wait") return CTL_DEFAULT_TIMEOUT_MS;
+  if (req.op !== "wait" && req.op !== "interrupt") return CTL_DEFAULT_TIMEOUT_MS;
   return req.timeoutMs === void 0 ? void 0 : req.timeoutMs + CTL_WAIT_SLACK_MS;
 }
 function parseReply(line) {
@@ -863,1769 +863,1769 @@ function unlinkCtlSocket(db, name, workstream) {
   }
 }
 
-// src/mux.ts
-var mux_exports = {};
-__export(mux_exports, {
-  HerdrCommandOverrideError: () => HerdrCommandOverrideError,
-  HerdrError: () => HerdrError,
-  HerdrNotImplementedError: () => HerdrNotImplementedError,
-  HerdrSyntaxError: () => HerdrSyntaxError,
-  HerdrUnsupportedCliError: () => HerdrUnsupportedCliError,
-  HerdrWorkspaceGroupCloseError: () => HerdrWorkspaceGroupCloseError,
-  MuxError: () => MuxError,
-  NoMultiplexerError: () => NoMultiplexerError,
-  PaneNotFoundError: () => PaneNotFoundError,
-  activeMux: () => activeMux,
-  detectMux: () => detectMux,
-  herdrBackend: () => herdrBackend,
-  isHerdrStatusUsable: () => isHerdrStatusUsable,
-  muxByName: () => muxByName,
-  parseAgentNameFromTitle: () => parseAgentNameFromTitle,
-  resetHerdrExecutor: () => resetHerdrExecutor,
-  resetMux: () => resetMux,
-  setHerdrExecutor: () => setHerdrExecutor,
-  setMuxForTests: () => setMuxForTests,
-  tmuxBackend: () => tmuxBackend
-});
-
-// src/mux/herdr.ts
-import { execa as execa2 } from "execa";
-
-// src/mux/tmux.ts
-import { execa } from "execa";
-
-// src/mux/input-timing.ts
-var TAIL_WINDOW_LINES = 100;
-var TAIL_LINES = 20;
-var BUSY_MARKERS = ["to interrupt)"];
-var BRAILLE_SPINNER_RE = /[\u2800-\u28ff]/;
-function extractTail(scrollback) {
-  const lines = scrollback.split("\n");
-  const window = lines.slice(-TAIL_WINDOW_LINES);
-  let end = window.length;
-  while (end > 0 && (window[end - 1] ?? "").trim() === "") end--;
-  return window.slice(Math.max(0, end - TAIL_LINES), end).join("\n");
-}
-function paneLooksBusy(scrollback) {
-  const tail = extractTail(scrollback);
-  return BUSY_MARKERS.some((marker) => tail.includes(marker)) || BRAILLE_SPINNER_RE.test(tail);
-}
+// src/logs.ts
+import { randomUUID as randomUUID2 } from "crypto";
 
-// src/mux/types.ts
-function parseAgentNameFromTitle(title) {
-  const idx = title.indexOf(" \xB7 ");
-  return idx === -1 ? title.trim() : title.slice(0, idx).trim();
-}
-var MuxError = class extends Error {
-  name = "MuxError";
-  errorNextSteps() {
-    return [{ intent: "Run health check", command: "mu doctor" }];
-  }
-};
-var PaneNotFoundError = class extends Error {
-  constructor(paneId, backend) {
-    super(`${backend?.name ?? "mux"} pane not found: ${paneId}`);
-    this.paneId = paneId;
-    this.backend = backend;
-  }
-  paneId;
-  backend;
-  name = "PaneNotFoundError";
-  errorNextSteps() {
-    return [
-      ...this.backend?.paneNotFoundNextSteps(this.paneId) ?? [],
-      {
-        intent: "List workstreams to choose the right scope",
-        command: "mu workstream list"
-      },
-      {
-        intent: "List registered agents and orphan panes in that scope",
-        command: "mu agent list -w <workstream>"
-      }
-    ];
+// src/hlc.ts
+var WALL_WIDTH = 15;
+var COUNTER_WIDTH = 6;
+var SEP = ".";
+var MAX_WALL = 10 ** WALL_WIDTH - 1;
+var MAX_COUNTER = 10 ** COUNTER_WIDTH - 1;
+var HlcParseError = class extends Error {
+  constructor(value) {
+    super(`Malformed HLC: ${JSON.stringify(value)}`);
+    this.value = value;
+    this.name = "HlcParseError";
   }
+  value;
 };
-var NoMultiplexerError = class extends Error {
-  constructor(tried) {
+var HlcOverflowError = class extends Error {
+  constructor(field, value) {
     super(
-      `no supported multiplexer found (tried: ${tried.join(", ")}). mu drives agents through tmux panes.`
+      field === "counter" ? `HLC counter overflow (${value} > ${MAX_COUNTER}): more than ${MAX_COUNTER + 1} ops in one millisecond` : `HLC wall-clock overflow (${value} > ${MAX_WALL}): system clock is far in the future`
     );
-    this.tried = tried;
-  }
-  tried;
-  name = "NoMultiplexerError";
-  errorNextSteps() {
-    return [
-      { intent: "Run health check", command: "mu doctor" },
-      { intent: "Verify tmux is installed", command: "tmux -V" },
-      { intent: "Force a specific backend", command: "MU_MUX=tmux mu <verb>" }
-    ];
+    this.field = field;
+    this.value = value;
+    this.name = "HlcOverflowError";
   }
+  field;
+  value;
 };
-
-// src/mux/tmux.ts
-var TmuxError = class extends MuxError {
-  constructor(args, stderr, stdout, exitCode) {
-    const detail = stderr.trim() || stdout.trim() || "no output";
-    super(`tmux ${args.join(" ")} failed (exit ${exitCode}): ${detail}`);
-    this.args = args;
-    this.stderr = stderr;
-    this.stdout = stdout;
-    this.exitCode = exitCode;
-    this.name = "TmuxError";
-  }
-  args;
-  stderr;
-  stdout;
-  exitCode;
-  errorNextSteps() {
-    return [
-      { intent: "Run health check", command: "mu doctor" },
-      {
-        intent: "Verify tmux is running and reachable",
-        command: "tmux info | head"
-      },
-      {
-        intent: "Check the failing tmux command in isolation",
-        command: `tmux ${this.args.join(" ")}`
-      }
-    ];
+var MachineIdentityMissingError = class extends Error {
+  constructor() {
+    super("machine_identity row (id = 1) is missing; the DB was not opened via openDb()");
+    this.name = "MachineIdentityMissingError";
   }
 };
-var PANE_ID_RE = /^%\d+$/;
-function isValidPaneId(s) {
-  return PANE_ID_RE.test(s);
+function formatHlc(hlc) {
+  const { wallMs, counter, machineId: machineId2 } = hlc;
+  if (!Number.isInteger(wallMs) || wallMs < 0) throw new HlcParseError(String(wallMs));
+  if (!Number.isInteger(counter) || counter < 0) throw new HlcParseError(String(counter));
+  if (wallMs > MAX_WALL) throw new HlcOverflowError("wall", wallMs);
+  if (counter > MAX_COUNTER) throw new HlcOverflowError("counter", counter);
+  if (machineId2.length === 0 || machineId2.includes(SEP)) throw new HlcParseError(machineId2);
+  return `${String(wallMs).padStart(WALL_WIDTH, "0")}${SEP}${String(counter).padStart(
+    COUNTER_WIDTH,
+    "0"
+  )}${SEP}${machineId2}`;
 }
-function assertValidPaneId(s) {
-  if (!isValidPaneId(s)) {
-    throw new TypeError(`invalid tmux pane id: ${JSON.stringify(s)} (expected /^%\\d+$/)`);
+function parseHlc(value) {
+  const parts = value.split(SEP);
+  if (parts.length !== 3) throw new HlcParseError(value);
+  const [wall, counter, machineId2] = parts;
+  if (wall === void 0 || counter === void 0 || machineId2 === void 0) {
+    throw new HlcParseError(value);
   }
+  if (wall.length !== WALL_WIDTH || counter.length !== COUNTER_WIDTH || machineId2.length === 0) {
+    throw new HlcParseError(value);
+  }
+  if (!/^\d+$/.test(wall) || !/^\d+$/.test(counter)) throw new HlcParseError(value);
+  return { wallMs: Number(wall), counter: Number(counter), machineId: machineId2 };
 }
-function defaultSendDelayMs() {
-  const raw = process.env.MU_SEND_DELAY_MS;
-  if (raw === void 0) return 500;
-  const parsed = Number.parseInt(raw, 10);
-  if (Number.isNaN(parsed) || parsed < 0) return 500;
-  return parsed;
-}
-function tmuxGlobalFlags() {
-  const socket = process.env.MU_TMUX_SOCKET;
-  if (socket === void 0 || socket.length === 0) return [];
-  return ["-L", socket, "-f", "/dev/null"];
+function compareHlc(a, b) {
+  if (a < b) return -1;
+  if (a > b) return 1;
+  return 0;
 }
-var realExecutor = async (args) => {
-  const result = await execa("tmux", [...tmuxGlobalFlags(), ...args], { reject: false });
-  return {
-    stdout: result.stdout ?? "",
-    stderr: result.stderr ?? "",
-    exitCode: result.exitCode ?? null
-  };
-};
-var currentExecutor = realExecutor;
-function setTmuxExecutor(executor) {
-  const previous = currentExecutor;
-  currentExecutor = executor;
-  return previous;
+function nextHlc(db, now = Date.now()) {
+  const row = db.prepare(
+    `UPDATE machine_identity
+          SET last_wall    = MAX(last_wall, @now),
+              last_counter = CASE WHEN @now > last_wall THEN 0 ELSE last_counter + 1 END
+        WHERE id = 1
+        RETURNING machine_id, last_wall, last_counter`
+  ).get({ now: Math.floor(now) });
+  if (!row) throw new MachineIdentityMissingError();
+  return formatHlc({ wallMs: row.last_wall, counter: row.last_counter, machineId: row.machine_id });
 }
-function resetTmuxExecutor() {
-  currentExecutor = realExecutor;
+function receiveHlc(db, remoteHlc, now = Date.now()) {
+  const remote = parseHlc(remoteHlc);
+  const wallNow = Math.floor(now);
+  const read = db.prepare(
+    "SELECT machine_id, last_wall, last_counter FROM machine_identity WHERE id = 1"
+  );
+  const write = db.prepare(
+    "UPDATE machine_identity SET last_wall = @wall, last_counter = @counter WHERE id = 1"
+  );
+  const advance = db.transaction(() => {
+    const row = read.get();
+    if (!row) throw new MachineIdentityMissingError();
+    const wall = Math.max(row.last_wall, remote.wallMs, wallNow);
+    const localAtMax = row.last_wall === wall;
+    const remoteAtMax = remote.wallMs === wall;
+    let counter;
+    if (!localAtMax && !remoteAtMax) {
+      counter = 0;
+    } else if (localAtMax && remoteAtMax) {
+      counter = Math.max(row.last_counter, remote.counter) + 1;
+    } else if (localAtMax) {
+      counter = row.last_counter + 1;
+    } else {
+      counter = remote.counter + 1;
+    }
+    if (counter > MAX_COUNTER) throw new HlcOverflowError("counter", counter);
+    write.run({ wall, counter });
+    return formatHlc({ wallMs: wall, counter, machineId: row.machine_id });
+  });
+  return advance.immediate();
 }
-async function tmux(args) {
-  const result = await currentExecutor(args);
-  if (result.exitCode !== 0) {
-    throw new TmuxError([...args], result.stderr, result.stdout, result.exitCode);
-  }
-  return result.stdout;
+
+// src/legacy-ops.ts
+var LEGACY_LOG_ONLY_INTENTS = /* @__PURE__ */ new Set(["workstream.export"]);
+function isLegacyLogOnlyIntent(intent) {
+  return intent !== null && LEGACY_LOG_ONLY_INTENTS.has(intent);
 }
-var currentSleep = (ms) => new Promise((resolve7) => setTimeout(resolve7, ms));
-function setSleepForTests(impl) {
-  const previous = currentSleep;
-  currentSleep = impl;
-  return previous;
+var LEGACY_INTENT_SYNONYMS = /* @__PURE__ */ new Map([
+  ["workstream.teardown", ["workstream.destroy"]]
+]);
+function intentSpellings(intent) {
+  const legacy = LEGACY_INTENT_SYNONYMS.get(intent);
+  return legacy === void 0 ? [intent] : [intent, ...legacy];
 }
-function resetSleep() {
-  currentSleep = (ms) => new Promise((resolve7) => setTimeout(resolve7, ms));
+var LEGACY_LOG_ONLY_SQL_EXCLUSION = `(intent IS NULL OR intent NOT IN (${[
+  ...LEGACY_LOG_ONLY_INTENTS
+].map((i) => `'${i}'`).join(", ")}))`;
+
+// src/logs.ts
+var SELECT_LOG_COLS = `
+  l.seq AS seq,
+  l.key AS workstream,
+  l.actor AS source,
+  l.intent AS intent,
+  l.group_id AS group_id,
+  l.op AS op,
+  l.entity AS kind,
+  l.payload AS payload,
+  l.created_at AS created_at
+`;
+var LOG_FROM_JOIN = "FROM ops l";
+function workstreamScopeSql(column = "l.key") {
+  return `(${column} = ? OR ${column} LIKE ? ESCAPE '\\')`;
 }
-function sleep(ms) {
-  return currentSleep(ms);
+function workstreamScopeParams(workstream) {
+  const escaped = workstream.replace(/[\\%_]/g, (c) => `\\${c}`);
+  return [workstream, `${escaped}/%`];
 }
-async function listSessions() {
-  try {
-    const out = await tmux(["list-sessions", "-F", "#{session_name}"]);
-    return out.split("\n").filter((line) => line.length > 0).map((name) => ({ name }));
-  } catch (err) {
-    if (err instanceof TmuxError && /no server running|no sessions/i.test(err.stderr)) {
-      return [];
-    }
-    throw err;
+var TOUCH_OP_FILTER = `NOT (
+  l.intent IS NOT NULL
+  AND l.op = 'put'
+  AND l.payload LIKE '{"updated_at":%'
+  AND LENGTH(l.payload) < 45
+)`;
+var MACHINE_WIDE_KEY = "";
+var GroupIdAmbiguousError = class extends Error {
+  constructor(prefix, candidates) {
+    super(
+      `group id ${JSON.stringify(prefix)} is ambiguous: matches ${candidates.length} groups (${candidates.slice(0, 4).map((c) => c.slice(0, 12)).join(", ")}${candidates.length > 4 ? ", \u2026" : ""})`
+    );
+    this.prefix = prefix;
+    this.candidates = candidates;
+    this.name = "GroupIdAmbiguousError";
+  }
+  prefix;
+  candidates;
+  errorNextSteps() {
+    return [
+      { intent: "List recent groups with their ids", command: "mu undo" },
+      {
+        intent: "Retry with more characters",
+        command: `mu log --group ${this.candidates[0] ?? "<full-id>"}`
+      }
+    ];
   }
+};
+function groupIdFromPrefix(db, prefix) {
+  if (prefix === "") return null;
+  const rows = db.prepare(
+    `SELECT DISTINCT group_id AS groupId FROM ops
+        WHERE group_id = @exact OR group_id LIKE @prefix || '%' ESCAPE '\\'`
+  ).all({ exact: prefix, prefix: prefix.replace(/[\\%_]/g, (c) => `\\${c}`) });
+  const exact = rows.find((r) => r.groupId === prefix);
+  if (exact !== void 0) return exact.groupId;
+  const first = rows[0];
+  if (rows.length === 1 && first !== void 0) return first.groupId;
+  if (rows.length === 0) return null;
+  throw new GroupIdAmbiguousError(
+    prefix,
+    rows.map((r) => r.groupId)
+  );
 }
-async function sessionExists(name) {
-  const result = await currentExecutor(["has-session", "-t", name]);
-  return result.exitCode === 0;
+function machineId(db) {
+  const row = db.prepare("SELECT machine_id FROM machine_identity WHERE id = 1").get();
+  return row?.machine_id ?? "unknown";
 }
-async function newSession(name, opts = {}) {
-  const args = ["new-session"];
-  if (opts.detached !== false) args.push("-d");
-  args.push("-s", name);
-  if (opts.windowName) args.push("-n", opts.windowName);
-  if (opts.cwd) args.push("-c", opts.cwd);
-  appendEnvFlags(args, opts.env);
-  if (opts.command) args.push(opts.command);
-  await tmux(args);
+function rowFromDb(row) {
+  return {
+    seq: row.seq,
+    workstreamName: row.workstream === MACHINE_WIDE_KEY ? null : row.workstream,
+    source: row.source ?? "system",
+    intent: row.intent,
+    group: row.group_id,
+    op: row.op,
+    kind: row.kind,
+    payload: row.payload,
+    createdAt: row.created_at
+  };
 }
-async function newSessionWithPane(name, opts) {
-  const args = ["new-session"];
-  if (opts.detached !== false) args.push("-d");
-  args.push("-s", name, "-n", opts.windowName);
-  if (opts.cwd) args.push("-c", opts.cwd);
-  appendEnvFlags(args, opts.env);
-  args.push("-P", "-F", "#{pane_id}", opts.command);
-  const out = (await tmux(args)).trim();
-  assertValidPaneId(out);
-  return out;
+function appendLog(db, opts) {
+  const kind = opts.kind ?? "message";
+  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
+  const key = opts.workstream ?? MACHINE_WIDE_KEY;
+  const group = randomUUID2();
+  const result = db.prepare(
+    `INSERT INTO ops (hlc, machine_id, group_id, actor, intent, entity, key, op, payload, created_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, 'put', ?, ?)`
+  ).run(
+    nextHlc(db),
+    machineId(db),
+    group,
+    opts.source,
+    opts.intent ?? null,
+    kind,
+    key,
+    opts.payload,
+    createdAt
+  );
+  return {
+    seq: Number(result.lastInsertRowid),
+    workstreamName: opts.workstream,
+    source: opts.source,
+    intent: opts.intent ?? null,
+    group,
+    op: "put",
+    kind,
+    payload: opts.payload,
+    createdAt
+  };
 }
-async function killSession(name) {
-  const result = await currentExecutor(["kill-session", "-t", name]);
-  if (result.exitCode !== 0 && !/can't find session|session not found|no server running|no current target/i.test(result.stderr)) {
-    throw new TmuxError(
-      ["kill-session", "-t", name],
-      result.stderr,
-      result.stdout,
-      result.exitCode
-    );
+function listLogs(db, opts = {}) {
+  const conditions = [];
+  const params = [];
+  if (opts.workstream === null) {
+    conditions.push("l.key = ?");
+    params.push(MACHINE_WIDE_KEY);
+  } else if (opts.workstream !== void 0) {
+    conditions.push(workstreamScopeSql());
+    params.push(...workstreamScopeParams(opts.workstream));
   }
-}
-async function listWindows(session) {
-  if (session) {
-    const out2 = await tmux(["list-windows", "-t", session, "-F", "#{window_id}	#{window_name}"]);
-    return parseWindows(out2);
+  if (opts.since !== void 0) {
+    conditions.push("l.seq > ?");
+    params.push(opts.since);
   }
-  const out = await tmux([
-    "list-windows",
-    "-a",
-    "-F",
-    "#{session_name}	#{window_id}	#{window_name}"
-  ]);
-  const windows = [];
-  for (const line of out.split("\n")) {
-    if (line.length === 0) continue;
-    const [sessionName, id, name] = line.split("	");
-    if (!sessionName || !id || name === void 0) continue;
-    windows.push({ id, name, sessionName });
+  if (opts.source !== void 0) {
+    conditions.push("l.actor = ?");
+    params.push(opts.source);
   }
-  return windows;
-}
-function parseWindows(output) {
-  const windows = [];
-  for (const line of output.split("\n")) {
-    if (line.length === 0) continue;
-    const [id, name] = line.split("	");
-    if (!id || name === void 0) continue;
-    windows.push({ id, name });
+  if (opts.kind !== void 0) {
+    conditions.push("l.entity = ?");
+    params.push(opts.kind);
   }
-  return windows;
-}
-async function newWindow(opts) {
-  const args = ["new-window"];
-  if (opts.detached !== false) args.push("-d");
-  if (opts.session) args.push("-t", opts.session);
-  args.push("-n", opts.name);
-  if (opts.cwd) args.push("-c", opts.cwd);
-  appendEnvFlags(args, opts.env);
-  args.push("-P", "-F", "#{pane_id}", opts.command);
-  const out = (await tmux(args)).trim();
-  assertValidPaneId(out);
-  return out;
-}
-async function listPanesInSession(session) {
-  const args = [
-    "list-panes",
-    "-s",
-    "-t",
-    session,
-    "-F",
-    "#{window_id}	#{pane_id}	#{pane_title}	#{pane_current_command}"
-  ];
-  const result = await currentExecutor(args);
-  if (result.exitCode !== 0) {
-    if (/can't find (session|window)|no server running|no sessions|no current target/i.test(
-      result.stderr
-    )) {
-      return [];
-    }
-    throw new TmuxError(args, result.stderr, result.stdout, result.exitCode);
+  if (opts.intent !== void 0) {
+    const spellings = intentSpellings(opts.intent);
+    conditions.push(`l.intent IN (${spellings.map(() => "?").join(", ")})`);
+    params.push(...spellings);
   }
-  const panes = [];
-  for (const line of result.stdout.split("\n")) {
-    if (line.length === 0) continue;
-    const [windowId, paneId, title, command] = line.split("	");
-    if (!windowId || !paneId || command === void 0) continue;
-    panes.push({ paneId, title: title ?? "", command, windowId });
+  if (opts.group !== void 0) {
+    conditions.push("l.group_id = ?");
+    params.push(opts.group);
   }
-  return panes;
-}
-async function listPanes(target) {
-  if (target === "*") {
-    const out2 = await tmux([
-      "list-panes",
-      "-a",
-      "-F",
-      "#{session_name}	#{window_id}	#{pane_id}	#{pane_title}	#{pane_current_command}"
-    ]);
-    const panes2 = [];
-    for (const line of out2.split("\n")) {
-      if (line.length === 0) continue;
-      const [sessionName, windowId, paneId, title, command] = line.split("	");
-      if (!sessionName || !windowId || !paneId || command === void 0) continue;
-      panes2.push({ paneId, title: title ?? "", command, windowId, sessionName });
-    }
-    return panes2;
-  }
-  const args = ["list-panes"];
-  if (target !== void 0) args.push("-t", target);
-  args.push("-F", "#{pane_id}	#{pane_title}	#{pane_current_command}");
-  const out = await tmux(args);
-  const panes = [];
-  for (const line of out.split("\n")) {
-    if (line.length === 0) continue;
-    const [paneId, title, command] = line.split("	");
-    if (!paneId || command === void 0) continue;
-    panes.push({ paneId, title: title ?? "", command });
+  conditions.push(TOUCH_OP_FILTER);
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  if (opts.limit !== void 0 && opts.since === void 0) {
+    const rowsDesc = db.prepare(`SELECT ${SELECT_LOG_COLS} ${LOG_FROM_JOIN} ${where} ORDER BY l.seq DESC LIMIT ?`).all(...params, opts.limit);
+    return rowsDesc.reverse().map(rowFromDb);
   }
-  return panes;
-}
-async function splitWindow(opts) {
-  const args = ["split-window"];
-  if (opts.horizontal !== false) args.push("-h");
-  if (opts.detached !== false) args.push("-d");
-  args.push("-t", opts.target);
-  if (opts.cwd) args.push("-c", opts.cwd);
-  appendEnvFlags(args, opts.env);
-  args.push("-P", "-F", "#{pane_id}", opts.command);
-  const out = (await tmux(args)).trim();
-  assertValidPaneId(out);
-  return out;
-}
-function appendEnvFlags(args, env) {
-  if (!env) return;
-  for (const [k, v] of Object.entries(env)) {
-    if (k.length === 0) {
-      throw new TypeError("tmux env key must be non-empty");
-    }
-    if (k.includes("=")) {
-      throw new TypeError(`tmux env key must not contain '=': ${JSON.stringify(k)}`);
-    }
-    args.push("-e", `${k}=${v}`);
+  let sql = `SELECT ${SELECT_LOG_COLS} ${LOG_FROM_JOIN} ${where} ORDER BY l.seq ASC`;
+  if (opts.limit !== void 0) {
+    sql += " LIMIT ?";
+    params.push(opts.limit);
   }
+  const rows = db.prepare(sql).all(...params);
+  return rows.map(rowFromDb);
 }
-async function killPane(paneId) {
-  assertValidPaneId(paneId);
-  const result = await currentExecutor(["kill-pane", "-t", paneId]);
-  if (result.exitCode !== 0 && !/can't find pane/i.test(result.stderr)) {
-    throw new TmuxError(["kill-pane", "-t", paneId], result.stderr, result.stdout, result.exitCode);
-  }
+function latestSeq(db, workstream) {
+  const row = workstream === void 0 ? db.prepare(`SELECT MAX(seq) AS s FROM ops l WHERE ${TOUCH_OP_FILTER}`).get() : db.prepare(
+    `SELECT MAX(seq) AS s FROM ops l WHERE ${workstreamScopeSql()} AND ${TOUCH_OP_FILTER}`
+  ).get(...workstreamScopeParams(workstream));
+  return row.s ?? 0;
 }
-async function paneExists(paneId) {
-  if (!isValidPaneId(paneId)) return false;
-  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{pane_id}"]);
-  if (result.exitCode !== 0) return false;
-  return result.stdout.trim() === paneId;
+function emitEvent(db, workstream, intent, payload, source = "system") {
+  appendLog(db, { workstream, source, kind: entityForIntent(intent), payload, intent });
 }
-async function setPaneTitle(paneId, title) {
-  assertValidPaneId(paneId);
-  await tmux(["select-pane", "-t", paneId, "-T", title]);
+function entityForIntent(intent) {
+  const dot = intent.indexOf(".");
+  return dot === -1 ? intent : intent.slice(0, dot);
 }
-async function getWindowIdForPane(paneId) {
-  if (!isValidPaneId(paneId)) return void 0;
-  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{window_id}"]);
-  if (result.exitCode !== 0) return void 0;
-  const id = result.stdout.trim();
-  return id.length > 0 ? id : void 0;
+function lastClaimOp(db, workstream, localId) {
+  const row = db.prepare(
+    `SELECT actor, created_at FROM ops
+        WHERE key = ? AND intent = 'task.claim'
+        ORDER BY seq DESC LIMIT 1`
+  ).get(`${workstream}/${localId}`);
+  return row ?? null;
 }
-function muBannersDisabled() {
-  return process.env.MU_BANNER_QUIET === "1";
+function lastClaimEventAt(db, workstream, localId) {
+  return lastClaimOp(db, workstream, localId)?.created_at ?? null;
 }
-async function enableMuPaneBordersForSession(session) {
-  if (muBannersDisabled()) return 0;
-  const windows = await listWindows(session).catch(() => []);
-  let n = 0;
-  for (const w of windows) {
-    try {
-      await enableMuPaneBorders(w.id);
-      n += 1;
-    } catch {
-    }
-  }
-  return n;
+
+// src/mux.ts
+var mux_exports = {};
+__export(mux_exports, {
+  HerdrCommandOverrideError: () => HerdrCommandOverrideError,
+  HerdrError: () => HerdrError,
+  HerdrNotImplementedError: () => HerdrNotImplementedError,
+  HerdrSyntaxError: () => HerdrSyntaxError,
+  HerdrUnsupportedCliError: () => HerdrUnsupportedCliError,
+  HerdrWorkspaceGroupCloseError: () => HerdrWorkspaceGroupCloseError,
+  MuxError: () => MuxError,
+  NoMultiplexerError: () => NoMultiplexerError,
+  PaneNotFoundError: () => PaneNotFoundError,
+  activeMux: () => activeMux,
+  detectMux: () => detectMux,
+  herdrBackend: () => herdrBackend,
+  isHerdrStatusUsable: () => isHerdrStatusUsable,
+  muxByName: () => muxByName,
+  parseAgentNameFromTitle: () => parseAgentNameFromTitle,
+  resetHerdrExecutor: () => resetHerdrExecutor,
+  resetMux: () => resetMux,
+  setHerdrExecutor: () => setHerdrExecutor,
+  setMuxForTests: () => setMuxForTests,
+  tmuxBackend: () => tmuxBackend
+});
+
+// src/mux/herdr.ts
+import { execa as execa2 } from "execa";
+
+// src/mux/tmux.ts
+import { execa } from "execa";
+
+// src/mux/input-timing.ts
+var TAIL_WINDOW_LINES = 100;
+var TAIL_LINES = 20;
+var BUSY_MARKERS = ["to interrupt)"];
+var BRAILLE_SPINNER_RE = /[\u2800-\u28ff]/;
+function extractTail(scrollback) {
+  const lines = scrollback.split("\n");
+  const window = lines.slice(-TAIL_WINDOW_LINES);
+  let end = window.length;
+  while (end > 0 && (window[end - 1] ?? "").trim() === "") end--;
+  return window.slice(Math.max(0, end - TAIL_LINES), end).join("\n");
 }
-async function enableMuPaneBordersForPane(paneId) {
-  if (muBannersDisabled()) return;
-  const wid = await getWindowIdForPane(paneId).catch(() => void 0);
-  if (wid) await enableMuPaneBorders(wid).catch(() => {
-  });
+function paneLooksBusy(scrollback) {
+  const tail = extractTail(scrollback);
+  return BUSY_MARKERS.some((marker) => tail.includes(marker)) || BRAILLE_SPINNER_RE.test(tail);
 }
-async function enableMuPaneBorders(target) {
-  if (muBannersDisabled()) return;
-  await tmux(["set-option", "-w", "-t", target, "pane-border-status", "top"]);
-  await tmux(["set-option", "-w", "-t", target, "pane-border-lines", "heavy"]);
-  await tmux(["set-option", "-w", "-t", target, "pane-active-border-style", "fg=cyan,bold"]);
-  await tmux(["set-option", "-w", "-t", target, "pane-border-style", "fg=brightblack"]);
+
+// src/mux/types.ts
+function parseAgentNameFromTitle(title) {
+  const idx = title.indexOf(" \xB7 ");
+  return idx === -1 ? title.trim() : title.slice(0, idx).trim();
 }
-async function paneTTY(paneId) {
-  assertValidPaneId(paneId);
-  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{pane_tty}"]);
-  if (result.exitCode !== 0) {
-    if (/can't find pane|pane not found/i.test(result.stderr)) {
-      throw new PaneNotFoundError(paneId, tmuxBackend);
-    }
-    throw new TmuxError(
-      ["display-message", "-t", paneId, "-p", "#{pane_tty}"],
-      result.stderr,
-      result.stdout,
-      result.exitCode
+var MuxError = class extends Error {
+  name = "MuxError";
+  errorNextSteps() {
+    return [{ intent: "Run health check", command: "mu doctor" }];
+  }
+};
+var PaneNotFoundError = class extends Error {
+  constructor(paneId, backend) {
+    super(`${backend?.name ?? "mux"} pane not found: ${paneId}`);
+    this.paneId = paneId;
+    this.backend = backend;
+  }
+  paneId;
+  backend;
+  name = "PaneNotFoundError";
+  errorNextSteps() {
+    return [
+      ...this.backend?.paneNotFoundNextSteps(this.paneId) ?? [],
+      {
+        intent: "List workstreams to choose the right scope",
+        command: "mu workstream list"
+      },
+      {
+        intent: "List registered agents and orphan panes in that scope",
+        command: "mu agent list -w <workstream>"
+      }
+    ];
+  }
+};
+var NoMultiplexerError = class extends Error {
+  constructor(tried) {
+    super(
+      `no supported multiplexer found (tried: ${tried.join(", ")}). mu drives agents through tmux panes.`
     );
+    this.tried = tried;
   }
-  const tty = result.stdout.trim();
-  if (tty === "") throw new PaneNotFoundError(paneId, tmuxBackend);
-  return tty;
-}
-async function getPaneTitle(paneId) {
-  if (!isValidPaneId(paneId)) return void 0;
-  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{pane_title}"]);
-  if (result.exitCode !== 0) return void 0;
-  return result.stdout.trimEnd();
-}
-async function currentPaneTitle() {
-  const paneId = process.env.TMUX_PANE;
-  if (!paneId || !isValidPaneId(paneId)) return void 0;
-  return getPaneTitle(paneId);
-}
-async function currentAgentName() {
-  const title = await currentPaneTitle();
-  if (title === void 0) return void 0;
-  return parseAgentNameFromTitle(title);
-}
-async function currentSessionName() {
-  if (!process.env.TMUX) return void 0;
-  const result = await currentExecutor(["display-message", "-p", "#S"]);
-  if (result.exitCode !== 0) return void 0;
-  const name = result.stdout.trim();
-  return name === "" ? void 0 : name;
-}
-async function selectLayout(window, layout) {
-  await tmux(["select-layout", "-t", window, layout]);
-}
-function defaultSendReadinessMs() {
-  const raw = process.env.MU_SEND_READINESS_MS;
-  if (raw === void 0) return 15e3;
-  const parsed = Number.parseInt(raw, 10);
-  if (Number.isNaN(parsed) || parsed < 0) return 15e3;
-  return parsed;
-}
-var SEND_READINESS_POLL_MS = 250;
-var QUIESCENCE_CONFIRMATIONS = 3;
-var SUBMIT_RETRIES = 2;
-var SUBMIT_SETTLE_MS = 600;
-var SUBMIT_VERIFY_SAMPLES = 4;
-var SUBMIT_VERIFY_INTERVAL_MS = 700;
-var WORK_MARKERS = ["to interrupt)", "Working"];
-function hasWorkMarker(scrollback) {
-  const tail = scrollback.split("\n").slice(-40).join("\n");
-  return WORK_MARKERS.some((m) => tail.includes(m));
-}
-async function awaitPaneQuiescence(paneId, budgetMs) {
-  if (budgetMs <= 0) return true;
-  const deadline = Date.now() + budgetMs;
-  let calm = 0;
-  for (; ; ) {
-    const scrollback = await capturePane(paneId, { lines: 50 }).catch(() => void 0);
-    const busy = scrollback === void 0 || paneLooksBusy(scrollback);
-    if (busy && scrollback !== void 0 && hasWorkMarker(scrollback)) return true;
-    if (!busy) {
-      calm++;
-      if (calm >= QUIESCENCE_CONFIRMATIONS) return true;
-    } else {
-      calm = 0;
-    }
-    const remaining = deadline - Date.now();
-    if (remaining <= 0) return false;
-    await currentSleep(Math.min(SEND_READINESS_POLL_MS, remaining));
-  }
-}
-function pasteProbe(text) {
-  const firstLine = (text.split("\n")[0] ?? "").trim();
-  return firstLine.slice(0, 24);
-}
-async function isTextStranded(paneId, probe) {
-  for (let i = 0; i < SUBMIT_VERIFY_SAMPLES; i++) {
-    if (i > 0) await currentSleep(SUBMIT_VERIFY_INTERVAL_MS);
-    const capture = await capturePane(paneId, { lines: 50 }).catch(() => void 0);
-    if (capture === void 0) return false;
-    if (paneLooksBusy(capture)) return false;
-    let count = 0;
-    let idx = capture.indexOf(probe);
-    while (idx !== -1 && count < 2) {
-      count++;
-      idx = capture.indexOf(probe, idx + probe.length);
-    }
-    if (count !== 1) return false;
-  }
-  return true;
-}
-function defaultUndeliveredWarning(warning) {
-  console.warn(`warning: ${warning.message}`);
-}
-async function sendToPane(paneId, text, opts = {}) {
-  assertValidPaneId(paneId);
-  const readinessMs = opts.readinessMs ?? defaultSendReadinessMs();
-  const quiesced = await awaitPaneQuiescence(paneId, readinessMs);
-  const copyResult = await currentExecutor(["copy-mode", "-q", "-t", paneId]);
-  if (copyResult.exitCode !== 0 && /can't find pane|no current target/i.test(copyResult.stderr)) {
-    throw new TmuxError(
-      ["copy-mode", "-q", "-t", paneId],
-      copyResult.stderr,
-      copyResult.stdout,
-      copyResult.exitCode
-    );
-  }
-  const bufferName = `mu-send-${process.pid}-${Date.now()}-${Math.floor(Math.random() * 1e6)}`;
-  await tmux(["set-buffer", "-b", bufferName, text]);
-  try {
-    await tmux(["paste-buffer", "-p", "-d", "-r", "-b", bufferName, "-t", paneId]);
-  } catch (err) {
-    await currentExecutor(["delete-buffer", "-b", bufferName]).catch(() => {
-    });
-    throw err;
-  }
-  const delay2 = opts.delayMs ?? defaultSendDelayMs();
-  if (delay2 > 0) await currentSleep(delay2);
-  await tmux(["send-keys", "-t", paneId, "Enter"]);
-  if (readinessMs <= 0) return;
-  const probe = pasteProbe(text);
-  if (probe.length === 0) return;
-  for (let attempt = 0; attempt <= SUBMIT_RETRIES; attempt++) {
-    if (!await isTextStranded(paneId, probe)) return;
-    if (attempt === SUBMIT_RETRIES) break;
-    await tmux(["send-keys", "-t", paneId, "Enter"]);
-    await currentSleep(SUBMIT_SETTLE_MS);
-  }
-  const warn2 = opts.onUndelivered ?? defaultUndeliveredWarning;
-  warn2({
-    paneId,
-    reason: quiesced ? "paste-vanished" : "busy-at-deadline",
-    message: `send to ${paneId} was NOT submitted: the text is still sitting unsubmitted in the pane's input box after ${SUBMIT_RETRIES + 1} Enter attempts. The agent has NOT seen it. Press Enter in the pane, or re-send.`
-  });
-}
-async function capturePane(paneId, opts = {}) {
-  assertValidPaneId(paneId);
-  const args = ["capture-pane", "-t", paneId, "-p"];
-  if (opts.lines === void 0) {
-    args.push("-S", "-", "-E", "-");
-  } else if (opts.lines > 0) {
-    args.push("-S", `-${opts.lines}`);
-  }
-  return tmux(args);
-}
-async function tmuxAvailable() {
-  try {
-    await tmux(["-V"]);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function attachTargetSpec(target) {
-  return target.window === void 0 ? target.session : `${target.session}:${target.window}`;
-}
-function attachHint(target) {
-  const spec = attachTargetSpec(target);
-  if (target.inside === true) return `tmux switch-client -t ${spec}`;
-  if (target.window === void 0) return `tmux attach -t ${target.session}`;
-  return `tmux attach -t ${target.session} && tmux select-window -t ${spec}`;
-}
-function attachCommands(target) {
-  const spec = attachTargetSpec(target);
-  if (target.inside === true) {
-    return [{ command: "tmux", args: ["switch-client", "-t", spec] }];
-  }
-  const steps = [{ command: "tmux", args: ["attach-session", "-t", target.session] }];
-  if (target.window !== void 0) {
-    steps.push({ command: "tmux", args: ["select-window", "-t", spec], optional: true });
-  }
-  return steps;
-}
-function paneNotFoundNextSteps(paneId) {
-  return [
-    {
-      intent: `Verify the pane id ${paneId} actually exists`,
-      command: `tmux display-message -t ${paneId} -p '#{pane_id} #{pane_title}'`
-    },
-    {
-      intent: "List all live panes across all sessions",
-      command: "tmux list-panes -a -F '#{session_name}:#{window_id}.#{pane_id}\\t#{pane_title}\\t#{pane_current_command}'"
-    }
-  ];
-}
-async function healthCheck() {
-  let version = null;
-  try {
-    version = (await tmux(["-V"])).trim();
-  } catch {
-    version = null;
+  tried;
+  name = "NoMultiplexerError";
+  errorNextSteps() {
+    return [
+      { intent: "Run health check", command: "mu doctor" },
+      { intent: "Verify tmux is installed", command: "tmux -V" },
+      { intent: "Force a specific backend", command: "MU_MUX=tmux mu <verb>" }
+    ];
   }
-  return {
-    name: "tmux",
-    ok: version !== null,
-    version,
-    env: [
-      { name: "$TMUX", value: process.env.TMUX ?? null },
-      { name: "$TMUX_PANE", value: process.env.TMUX_PANE ?? null }
-    ],
-    remediation: "install tmux \u2265 3.0"
-  };
-}
-var tmuxBackend = Object.freeze({
-  name: "tmux",
-  available: tmuxAvailable,
-  isValidPaneId,
-  assertValidPaneId,
-  listSessions,
-  sessionExists,
-  newSession,
-  newSessionWithPane,
-  killSession,
-  listWindows,
-  newWindow,
-  selectLayout,
-  listPanes,
-  listPanesInSession,
-  splitWindow,
-  killPane,
-  paneExists,
-  paneTTY,
-  setPaneTitle,
-  getPaneTitle,
-  currentAgentName,
-  currentSessionName,
-  sendToPane,
-  capturePane,
-  enableMuPaneBordersForSession,
-  enableMuPaneBordersForPane,
-  attachHint,
-  attachCommands,
-  paneNotFoundNextSteps,
-  healthCheck
-});
+};
 
-// src/mux/herdr.ts
-var HerdrError = class extends MuxError {
-  constructor(args, stderr, stdout, exitCode, code) {
-    const detail = parseErrorEnvelope(stderr)?.message ?? stderr.trim() ?? stdout.trim();
-    super(`herdr ${args.join(" ")} failed (exit ${exitCode}): ${detail || "no output"}`);
+// src/mux/tmux.ts
+var TmuxError = class extends MuxError {
+  constructor(args, stderr, stdout, exitCode) {
+    const detail = stderr.trim() || stdout.trim() || "no output";
+    super(`tmux ${args.join(" ")} failed (exit ${exitCode}): ${detail}`);
     this.args = args;
     this.stderr = stderr;
     this.stdout = stdout;
     this.exitCode = exitCode;
-    this.code = code;
-    this.name = "HerdrError";
+    this.name = "TmuxError";
   }
   args;
   stderr;
   stdout;
   exitCode;
-  code;
   errorNextSteps() {
     return [
       { intent: "Run health check", command: "mu doctor" },
-      { intent: "Verify the herdr server is running", command: "herdr status" },
       {
-        intent: "Check the failing herdr command in isolation",
-        command: `herdr ${this.args.join(" ")}`
+        intent: "Verify tmux is running and reachable",
+        command: "tmux info | head"
+      },
+      {
+        intent: "Check the failing tmux command in isolation",
+        command: `tmux ${this.args.join(" ")}`
       }
     ];
   }
 };
-var HerdrSyntaxError = class extends Error {
-  constructor(args, output) {
-    super(
-      `herdr rejected the command line (exit 2) \u2014 this is a bug in mu, not a herdr outage. Ran: herdr ${args.join(" ")}. herdr said: ${output.trim().split("\n")[0] ?? "(no output)"}`
-    );
-    this.args = args;
-    this.output = output;
-  }
-  args;
-  output;
-  name = "HerdrSyntaxError";
-};
-var HerdrUnsupportedCliError = class extends Error {
-  constructor(cli, detail) {
-    super(
-      `herdr does not recognise --cli ${cli} as an interactive agent kind, so it cannot classify that pane's status. herdr said: ${detail}`
-    );
-    this.cli = cli;
-    this.detail = detail;
+var PANE_ID_RE = /^%\d+$/;
+function isValidPaneId(s) {
+  return PANE_ID_RE.test(s);
+}
+function assertValidPaneId(s) {
+  if (!isValidPaneId(s)) {
+    throw new TypeError(`invalid tmux pane id: ${JSON.stringify(s)} (expected /^%\\d+$/)`);
   }
-  cli;
-  detail;
-  name = "HerdrUnsupportedCliError";
-  errorNextSteps() {
-    return [
-      {
-        intent: "List the agent kinds this herdr knows",
-        command: "herdr agent start --help"
-      },
-      {
-        intent: "Spawn with a kind herdr supports",
-        command: "mu agent spawn <name> --cli pi -w <workstream>"
-      },
-      {
-        intent: "Or spawn this cli under tmux, which runs any command",
-        command: `MU_MUX=tmux mu agent spawn <name> --cli ${this.cli}`
-      }
-    ];
-  }
-};
-var HerdrCommandOverrideError = class extends Error {
-  constructor(cli, command, envVar) {
-    super(
-      (envVar === void 0 ? `--command ${JSON.stringify(command)} cannot be honoured on the herdr backend` : `${envVar}=${command} cannot be honoured on the herdr backend`) + `: 'herdr agent start --kind ${cli}' resolves the executable itself and has no override flag. mu refuses rather than starting a different binary than you asked for.`
-    );
-    this.cli = cli;
-    this.command = command;
-    this.envVar = envVar;
-  }
-  cli;
-  command;
-  envVar;
-  name = "HerdrCommandOverrideError";
-  errorNextSteps() {
-    return [
-      ...this.envVar === void 0 ? [
-        {
-          intent: "Spawn without --command so herdr resolves the agent itself",
-          command: `mu agent spawn <name> --cli ${this.cli} -w <workstream>`
-        }
-      ] : [
-        {
-          intent: `Unset the override so herdr resolves ${this.cli} itself`,
-          command: `unset ${this.envVar}`
-        }
-      ],
-      {
-        intent: "Or spawn under tmux, which runs the command you name",
-        command: `MU_MUX=tmux mu agent spawn <name> --cli ${this.cli}`
-      }
-    ];
-  }
-};
-var GROUP_CLOSE_REQUIRED_CODE = "workspace_group_close_required";
-var HerdrWorkspaceGroupCloseError = class extends Error {
-  constructor(session, workspaceId, detail) {
-    super(
-      `herdr refused to close workspace ${workspaceId} (${session}): it has linked worktree workspaces, which mu did not create and will not close on your behalf. herdr said: ${detail}`
-    );
-    this.session = session;
-    this.workspaceId = workspaceId;
-    this.detail = detail;
-  }
-  session;
-  workspaceId;
-  detail;
-  name = "HerdrWorkspaceGroupCloseError";
-  errorNextSteps() {
-    return [
-      {
-        intent: "See which workspaces are linked as a group",
-        command: "herdr workspace list"
-      },
-      {
-        intent: "Remove the worktree workspaces you no longer want",
-        command: "herdr worktree remove <workspace-id>"
-      },
-      {
-        intent: "Or close the whole group yourself, then re-run the teardown",
-        command: `herdr workspace close ${this.workspaceId} --group`
-      }
-    ];
-  }
-};
-var HerdrNotImplementedError = class extends Error {
-  name = "HerdrNotImplementedError";
-  constructor(method, owner) {
-    super(`herdr backend: ${method} is not implemented yet (owned by task ${owner})`);
-  }
-};
-var HERDR_ORDINAL = "[0-9A-Z]+";
-var PANE_ID_RE2 = new RegExp(`^w${HERDR_ORDINAL}:p${HERDR_ORDINAL}$`);
-var WORKSPACE_ID_RE = new RegExp(`^w${HERDR_ORDINAL}$`);
-var TAB_ID_RE = new RegExp(`^w${HERDR_ORDINAL}:t${HERDR_ORDINAL}$`);
-function isValidPaneId2(s) {
-  return PANE_ID_RE2.test(s);
 }
-function assertValidPaneId2(s) {
-  if (!isValidPaneId2(s)) {
-    throw new TypeError(
-      `invalid herdr pane id: ${JSON.stringify(s)} (expected ${PANE_ID_RE2.source})`
-    );
-  }
+function defaultSendDelayMs() {
+  const raw = process.env.MU_SEND_DELAY_MS;
+  if (raw === void 0) return 500;
+  const parsed = Number.parseInt(raw, 10);
+  if (Number.isNaN(parsed) || parsed < 0) return 500;
+  return parsed;
 }
-function herdrGlobalFlags() {
-  const session = process.env.MU_HERDR_SESSION;
-  if (session === void 0 || session.length === 0) return [];
-  return ["--session", session];
+function tmuxGlobalFlags() {
+  const socket = process.env.MU_TMUX_SOCKET;
+  if (socket === void 0 || socket.length === 0) return [];
+  return ["-L", socket, "-f", "/dev/null"];
 }
-var realExecutor2 = async (args) => {
-  const result = await execa2("herdr", [...herdrGlobalFlags(), ...args], { reject: false });
+var realExecutor = async (args) => {
+  const result = await execa("tmux", [...tmuxGlobalFlags(), ...args], { reject: false });
   return {
     stdout: result.stdout ?? "",
     stderr: result.stderr ?? "",
     exitCode: result.exitCode ?? null
   };
 };
-var currentExecutor2 = realExecutor2;
-function setHerdrExecutor(executor) {
-  const previous = currentExecutor2;
-  currentExecutor2 = executor;
+var currentExecutor = realExecutor;
+function setTmuxExecutor(executor) {
+  const previous = currentExecutor;
+  currentExecutor = executor;
   return previous;
 }
-function resetHerdrExecutor() {
-  currentExecutor2 = realExecutor2;
+function resetTmuxExecutor() {
+  currentExecutor = realExecutor;
 }
-function isRecord(v) {
-  return typeof v === "object" && v !== null && !Array.isArray(v);
+async function tmux(args) {
+  const result = await currentExecutor(args);
+  if (result.exitCode !== 0) {
+    throw new TmuxError([...args], result.stderr, result.stdout, result.exitCode);
+  }
+  return result.stdout;
 }
-function asString(v) {
-  return typeof v === "string" ? v : void 0;
+var currentSleep = (ms) => new Promise((resolve7) => setTimeout(resolve7, ms));
+function setSleepForTests(impl) {
+  const previous = currentSleep;
+  currentSleep = impl;
+  return previous;
 }
-function parseErrorEnvelope(stderr) {
-  const trimmed = stderr.trim();
-  if (trimmed.length === 0) return void 0;
-  let parsed;
-  try {
-    parsed = JSON.parse(trimmed);
-  } catch {
-    return void 0;
-  }
-  if (!isRecord(parsed)) return void 0;
-  const err = parsed.error;
-  if (!isRecord(err)) return void 0;
-  const code = asString(err.code);
-  const message = asString(err.message);
-  if (code === void 0) return void 0;
-  return { code, message: message ?? code };
+function resetSleep() {
+  currentSleep = (ms) => new Promise((resolve7) => setTimeout(resolve7, ms));
 }
-async function herdr(args) {
-  const result = await currentExecutor2(args);
-  if (result.exitCode === 2) {
-    throw new HerdrSyntaxError([...args], result.stderr || result.stdout);
-  }
-  if (result.exitCode !== 0) {
-    throw new HerdrError(
-      [...args],
-      result.stderr,
-      result.stdout,
-      result.exitCode,
-      parseErrorEnvelope(result.stderr)?.code
-    );
-  }
-  const trimmed = result.stdout.trim();
-  if (trimmed.length === 0) return {};
-  let parsed;
-  try {
-    parsed = JSON.parse(trimmed);
-  } catch {
-    throw new HerdrError([...args], result.stderr, result.stdout, result.exitCode);
-  }
-  if (!isRecord(parsed)) return {};
-  const inner = parsed.result;
-  return isRecord(inner) ? inner : {};
+function sleep(ms) {
+  return currentSleep(ms);
 }
-async function herdrTolerating(args, tolerate) {
+async function listSessions() {
   try {
-    return await herdr(args);
+    const out = await tmux(["list-sessions", "-F", "#{session_name}"]);
+    return out.split("\n").filter((line) => line.length > 0).map((name) => ({ name }));
   } catch (err) {
-    if (err instanceof HerdrError && err.code !== void 0 && tolerate.includes(err.code)) {
-      return void 0;
+    if (err instanceof TmuxError && /no server running|no sessions/i.test(err.stderr)) {
+      return [];
     }
     throw err;
   }
 }
-function readWorkspace(v) {
-  if (!isRecord(v)) return void 0;
-  const workspaceId = asString(v.workspace_id);
-  if (workspaceId === void 0) return void 0;
-  return { workspaceId, label: asString(v.label) ?? "" };
-}
-function readTab(v) {
-  if (!isRecord(v)) return void 0;
-  const id = asString(v.tab_id);
-  if (id === void 0) return void 0;
-  return { id, name: asString(v.label) ?? "" };
-}
-function readPane(v) {
-  if (!isRecord(v)) return void 0;
-  const paneId = asString(v.pane_id);
-  if (paneId === void 0) return void 0;
-  return {
-    paneId,
-    // herdr's optional `label` is what `pane rename` writes and is
-    // therefore mu's pane-title equivalent.
-    title: asString(v.label) ?? "",
-    // herdr does not report a foreground command on `pane list`; the
-    // authoritative answer costs a `pane process-info` round trip per
-    // pane. Callers that need it use `paneCommand()`.
-    command: "",
-    windowId: asString(v.tab_id)
-  };
+async function sessionExists(name) {
+  const result = await currentExecutor(["has-session", "-t", name]);
+  return result.exitCode === 0;
 }
-function readArray(result, key) {
-  const v = result[key];
-  return Array.isArray(v) ? v : [];
+async function newSession(name, opts = {}) {
+  const args = ["new-session"];
+  if (opts.detached !== false) args.push("-d");
+  args.push("-s", name);
+  if (opts.windowName) args.push("-n", opts.windowName);
+  if (opts.cwd) args.push("-c", opts.cwd);
+  appendEnvFlags(args, opts.env);
+  if (opts.command) args.push(opts.command);
+  await tmux(args);
 }
-async function listWorkspaces() {
-  const result = await herdr(["workspace", "list"]);
-  const out = [];
-  for (const raw of readArray(result, "workspaces")) {
-    const ws = readWorkspace(raw);
-    if (ws) out.push(ws);
-  }
+async function newSessionWithPane(name, opts) {
+  const args = ["new-session"];
+  if (opts.detached !== false) args.push("-d");
+  args.push("-s", name, "-n", opts.windowName);
+  if (opts.cwd) args.push("-c", opts.cwd);
+  appendEnvFlags(args, opts.env);
+  args.push("-P", "-F", "#{pane_id}", opts.command);
+  const out = (await tmux(args)).trim();
+  assertValidPaneId(out);
   return out;
 }
-async function listSessions2() {
-  return (await listWorkspaces()).map((ws) => ({ name: ws.label }));
-}
-async function resolveWorkspaceId(name) {
-  for (const ws of await listWorkspaces()) {
-    if (ws.label === name) return ws.workspaceId;
-  }
-  return void 0;
-}
-async function requireWorkspaceId(name) {
-  const id = await resolveWorkspaceId(name);
-  if (id === void 0) {
-    throw new HerdrError(
-      ["workspace", "list"],
-      `{"error":{"code":"workspace_not_found","message":"no herdr workspace labelled ${name}"}}`,
-      "",
-      1,
-      "workspace_not_found"
+async function killSession(name) {
+  const result = await currentExecutor(["kill-session", "-t", name]);
+  if (result.exitCode !== 0 && !/can't find session|session not found|no server running|no current target/i.test(result.stderr)) {
+    throw new TmuxError(
+      ["kill-session", "-t", name],
+      result.stderr,
+      result.stdout,
+      result.exitCode
     );
   }
-  return id;
-}
-async function sessionExists2(name) {
-  return await resolveWorkspaceId(name) !== void 0;
-}
-async function newSession2(name, opts = {}) {
-  rejectCommand("newSession", opts.command);
-  const args = ["workspace", "create", "--label", name, "--no-focus"];
-  if (opts.cwd) args.push("--cwd", opts.cwd);
-  appendEnvFlags2(args, opts.env);
-  await herdr(args);
-}
-async function newSessionWithPane2(name, opts) {
-  rejectCommand("newSessionWithPane", opts.command);
-  const args = ["workspace", "create", "--label", name, "--no-focus"];
-  if (opts.cwd) args.push("--cwd", opts.cwd);
-  appendEnvFlags2(args, opts.env);
-  const result = await herdr(args);
-  return readCreatedPaneId(result, "root_pane", args);
-}
-async function killSession2(name) {
-  const id = await resolveWorkspaceId(name);
-  if (id === void 0) return;
-  try {
-    await herdrTolerating(["workspace", "close", id], ["workspace_not_found"]);
-  } catch (err) {
-    if (err instanceof HerdrError && err.code === GROUP_CLOSE_REQUIRED_CODE) {
-      throw new HerdrWorkspaceGroupCloseError(name, id, err.message);
-    }
-    throw err;
-  }
 }
-async function listWindows2(session) {
-  if (session !== void 0) {
-    const id = await resolveWorkspaceId(session);
-    if (id === void 0) return [];
-    return readTabs(await herdr(["tab", "list", "--workspace", id]));
+async function listWindows(session) {
+  if (session) {
+    const out2 = await tmux(["list-windows", "-t", session, "-F", "#{window_id}	#{window_name}"]);
+    return parseWindows(out2);
   }
+  const out = await tmux([
+    "list-windows",
+    "-a",
+    "-F",
+    "#{session_name}	#{window_id}	#{window_name}"
+  ]);
   const windows = [];
-  for (const ws of await listWorkspaces()) {
-    for (const tab of readTabs(await herdr(["tab", "list", "--workspace", ws.workspaceId]))) {
-      windows.push({ ...tab, sessionName: ws.label });
-    }
+  for (const line of out.split("\n")) {
+    if (line.length === 0) continue;
+    const [sessionName, id, name] = line.split("	");
+    if (!sessionName || !id || name === void 0) continue;
+    windows.push({ id, name, sessionName });
   }
   return windows;
 }
-function readTabs(result) {
-  const out = [];
-  for (const raw of readArray(result, "tabs")) {
-    const tab = readTab(raw);
-    if (tab) out.push(tab);
+function parseWindows(output) {
+  const windows = [];
+  for (const line of output.split("\n")) {
+    if (line.length === 0) continue;
+    const [id, name] = line.split("	");
+    if (!id || name === void 0) continue;
+    windows.push({ id, name });
   }
+  return windows;
+}
+async function newWindow(opts) {
+  const args = ["new-window"];
+  if (opts.detached !== false) args.push("-d");
+  if (opts.session) args.push("-t", opts.session);
+  args.push("-n", opts.name);
+  if (opts.cwd) args.push("-c", opts.cwd);
+  appendEnvFlags(args, opts.env);
+  args.push("-P", "-F", "#{pane_id}", opts.command);
+  const out = (await tmux(args)).trim();
+  assertValidPaneId(out);
   return out;
 }
-async function newWindow2(opts) {
-  rejectCommand("newWindow", opts.command);
-  const args = ["tab", "create"];
-  if (opts.session !== void 0) {
-    args.push("--workspace", await requireWorkspaceId(opts.session));
+async function listPanesInSession(session) {
+  const args = [
+    "list-panes",
+    "-s",
+    "-t",
+    session,
+    "-F",
+    "#{window_id}	#{pane_id}	#{pane_title}	#{pane_current_command}"
+  ];
+  const result = await currentExecutor(args);
+  if (result.exitCode !== 0) {
+    if (/can't find (session|window)|no server running|no sessions|no current target/i.test(
+      result.stderr
+    )) {
+      return [];
+    }
+    throw new TmuxError(args, result.stderr, result.stdout, result.exitCode);
   }
-  args.push("--label", opts.name, "--no-focus");
-  if (opts.cwd) args.push("--cwd", opts.cwd);
-  appendEnvFlags2(args, opts.env);
-  return readCreatedPaneId(await herdr(args), "root_pane", args);
-}
-async function selectLayout2(_window, _layout) {
-}
-async function listPanesInSession2(session) {
-  const id = await resolveWorkspaceId(session);
-  if (id === void 0) return [];
-  const result = await herdrTolerating(
-    ["pane", "list", "--workspace", id],
-    ["workspace_not_found"]
-  );
-  if (result === void 0) return [];
-  return readPanes(result).map((p) => ({ ...p, sessionName: session }));
+  const panes = [];
+  for (const line of result.stdout.split("\n")) {
+    if (line.length === 0) continue;
+    const [windowId, paneId, title, command] = line.split("	");
+    if (!windowId || !paneId || command === void 0) continue;
+    panes.push({ paneId, title: title ?? "", command, windowId });
+  }
+  return panes;
 }
-async function listPanes2(target) {
-  if (target !== void 0 && target !== "*") {
-    if (TAB_ID_RE.test(target)) {
-      const workspaceId = target.split(":")[0] ?? target;
-      const panes2 = readPanes(await herdr(["pane", "list", "--workspace", workspaceId]));
-      return panes2.filter((p) => p.windowId === target);
-    }
-    if (WORKSPACE_ID_RE.test(target)) {
-      return readPanes(await herdr(["pane", "list", "--workspace", target]));
+async function listPanes(target) {
+  if (target === "*") {
+    const out2 = await tmux([
+      "list-panes",
+      "-a",
+      "-F",
+      "#{session_name}	#{window_id}	#{pane_id}	#{pane_title}	#{pane_current_command}"
+    ]);
+    const panes2 = [];
+    for (const line of out2.split("\n")) {
+      if (line.length === 0) continue;
+      const [sessionName, windowId, paneId, title, command] = line.split("	");
+      if (!sessionName || !windowId || !paneId || command === void 0) continue;
+      panes2.push({ paneId, title: title ?? "", command, windowId, sessionName });
     }
-    return listPanesInSession2(target);
-  }
-  const ambient = process.env.HERDR_WORKSPACE_ID;
-  if (target === void 0 && ambient !== void 0 && WORKSPACE_ID_RE.test(ambient)) {
-    return readPanes(await herdr(["pane", "list", "--workspace", ambient]));
+    return panes2;
   }
+  const args = ["list-panes"];
+  if (target !== void 0) args.push("-t", target);
+  args.push("-F", "#{pane_id}	#{pane_title}	#{pane_current_command}");
+  const out = await tmux(args);
   const panes = [];
-  for (const ws of await listWorkspaces()) {
-    for (const pane of readPanes(await herdr(["pane", "list", "--workspace", ws.workspaceId]))) {
-      panes.push({ ...pane, sessionName: ws.label });
-    }
+  for (const line of out.split("\n")) {
+    if (line.length === 0) continue;
+    const [paneId, title, command] = line.split("	");
+    if (!paneId || command === void 0) continue;
+    panes.push({ paneId, title: title ?? "", command });
   }
   return panes;
 }
-function readPanes(result) {
-  const out = [];
-  for (const raw of readArray(result, "panes")) {
-    const pane = readPane(raw);
-    if (pane) out.push(pane);
-  }
+async function splitWindow(opts) {
+  const args = ["split-window"];
+  if (opts.horizontal !== false) args.push("-h");
+  if (opts.detached !== false) args.push("-d");
+  args.push("-t", opts.target);
+  if (opts.cwd) args.push("-c", opts.cwd);
+  appendEnvFlags(args, opts.env);
+  args.push("-P", "-F", "#{pane_id}", opts.command);
+  const out = (await tmux(args)).trim();
+  assertValidPaneId(out);
   return out;
 }
-async function splitWindow2(opts) {
-  rejectCommand("splitWindow", opts.command);
-  assertValidPaneId2(opts.target);
-  const args = [
-    "pane",
-    "split",
-    opts.target,
-    "--direction",
-    opts.horizontal === false ? "down" : "right",
-    "--no-focus"
-  ];
-  if (opts.cwd) args.push("--cwd", opts.cwd);
-  appendEnvFlags2(args, opts.env);
-  return readCreatedPaneId(await herdr(args), "pane", args);
+function appendEnvFlags(args, env) {
+  if (!env) return;
+  for (const [k, v] of Object.entries(env)) {
+    if (k.length === 0) {
+      throw new TypeError("tmux env key must be non-empty");
+    }
+    if (k.includes("=")) {
+      throw new TypeError(`tmux env key must not contain '=': ${JSON.stringify(k)}`);
+    }
+    args.push("-e", `${k}=${v}`);
+  }
 }
-async function killPane2(paneId) {
-  assertValidPaneId2(paneId);
-  await herdrTolerating(["pane", "close", paneId], ["pane_not_found", "workspace_not_found"]);
+async function killPane(paneId) {
+  assertValidPaneId(paneId);
+  const result = await currentExecutor(["kill-pane", "-t", paneId]);
+  if (result.exitCode !== 0 && !/can't find pane/i.test(result.stderr)) {
+    throw new TmuxError(["kill-pane", "-t", paneId], result.stderr, result.stdout, result.exitCode);
+  }
 }
-async function paneExists2(paneId) {
-  if (!isValidPaneId2(paneId)) return false;
-  const pane = await getPane(paneId);
-  return pane !== void 0;
+async function paneExists(paneId) {
+  if (!isValidPaneId(paneId)) return false;
+  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{pane_id}"]);
+  if (result.exitCode !== 0) return false;
+  return result.stdout.trim() === paneId;
 }
-async function getPane(paneId) {
-  const result = await herdrTolerating(
-    ["pane", "get", paneId],
-    ["pane_not_found", "workspace_not_found"]
-  );
-  if (result === void 0) return void 0;
-  return readPane(result.pane);
-}
-async function paneTTY2(paneId) {
-  assertValidPaneId2(paneId);
-  const result = await herdrTolerating(
-    ["pane", "process-info", "--pane", paneId],
-    ["pane_not_found", "workspace_not_found"]
-  );
-  if (result === void 0) throw new PaneNotFoundError(paneId);
-  const info = result.process_info;
-  const pid = isRecord(info) ? info.shell_pid : void 0;
-  if (typeof pid !== "number") throw new PaneNotFoundError(paneId);
-  const { readlink } = await import("fs/promises");
-  try {
-    return await readlink(`/proc/${pid}/fd/0`);
-  } catch (err) {
-    throw new HerdrError(
-      ["pane", "process-info", "--pane", paneId],
-      `cannot resolve the TTY for herdr pane ${paneId} (shell pid ${pid}) via /proc: ${String(err)}`,
-      "",
-      1
-    );
-  }
-}
-async function setPaneTitle2(paneId, title) {
-  assertValidPaneId2(paneId);
-  await herdr(["pane", "rename", paneId, title]);
-}
-async function getPaneTitle2(paneId) {
-  if (!isValidPaneId2(paneId)) return void 0;
-  const pane = await getPane(paneId).catch(() => void 0);
-  if (pane === void 0) return void 0;
-  return pane.title.length > 0 ? pane.title : void 0;
+async function setPaneTitle(paneId, title) {
+  assertValidPaneId(paneId);
+  await tmux(["select-pane", "-t", paneId, "-T", title]);
 }
-async function currentAgentName2() {
-  const paneId = process.env.HERDR_PANE_ID;
-  if (paneId === void 0 || !isValidPaneId2(paneId)) return void 0;
-  const title = await getPaneTitle2(paneId);
-  if (title === void 0) return void 0;
-  const idx = title.indexOf(" \xB7 ");
-  return idx === -1 ? title.trim() : title.slice(0, idx).trim();
+async function getWindowIdForPane(paneId) {
+  if (!isValidPaneId(paneId)) return void 0;
+  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{window_id}"]);
+  if (result.exitCode !== 0) return void 0;
+  const id = result.stdout.trim();
+  return id.length > 0 ? id : void 0;
 }
-async function currentSessionName2() {
-  const workspaceId = process.env.HERDR_WORKSPACE_ID;
-  if (workspaceId === void 0 || !WORKSPACE_ID_RE.test(workspaceId)) return void 0;
-  for (const ws of await listWorkspaces()) {
-    if (ws.workspaceId === workspaceId) return ws.label;
-  }
-  return void 0;
+function muBannersDisabled() {
+  return process.env.MU_BANNER_QUIET === "1";
 }
-var PANE_READY_RETRY_INTERVAL_MS = 50;
-var PANE_READY_MAX_ATTEMPTS = 60;
-async function startAgentInPane(opts) {
-  assertValidPaneId2(opts.paneId);
-  if (opts.commandSource !== "cli-key") {
-    throw new HerdrCommandOverrideError(
-      opts.cli,
-      opts.command,
-      // Name the env var only when that is actually where the override
-      // came from; "unset MU_PI_COMMAND" is useless advice to someone who
-      // typed --command.
-      opts.commandSource === "env" ? envVarNameForCli(opts.cli) : void 0
-    );
-  }
-  const args = ["agent", "start", opts.name, "--kind", opts.cli, "--pane", opts.paneId];
-  for (let attempt = 1; ; attempt += 1) {
+async function enableMuPaneBordersForSession(session) {
+  if (muBannersDisabled()) return 0;
+  const windows = await listWindows(session).catch(() => []);
+  let n = 0;
+  for (const w of windows) {
     try {
-      await herdr(args);
-      return;
-    } catch (err) {
-      if (err instanceof HerdrSyntaxError) {
-        throw new HerdrUnsupportedCliError(opts.cli, err.output.trim().split("\n")[0] ?? "");
-      }
-      const busy = err instanceof HerdrError && err.code === "agent_pane_busy";
-      if (!busy || attempt >= PANE_READY_MAX_ATTEMPTS) throw err;
-      await sleep(PANE_READY_RETRY_INTERVAL_MS);
+      await enableMuPaneBorders(w.id);
+      n += 1;
+    } catch {
     }
   }
+  return n;
 }
-function envVarNameForCli(cli) {
-  return `MU_${cli.toUpperCase().replace(/-/g, "_")}_COMMAND`;
-}
-var PROMPT_STALLED_CODE = "agent_prompt_stalled";
-var NO_AGENT_CODES = ["agent_not_found", "agent_not_recognized"];
-function defaultUndeliveredWarning2(warning) {
-  console.warn(`warning: ${warning.message}`);
+async function enableMuPaneBordersForPane(paneId) {
+  if (muBannersDisabled()) return;
+  const wid = await getWindowIdForPane(paneId).catch(() => void 0);
+  if (wid) await enableMuPaneBorders(wid).catch(() => {
+  });
 }
-async function sendToPane2(paneId, text, opts = {}) {
-  assertValidPaneId2(paneId);
-  const wait = opts.readinessMs === 0 ? [] : ["--wait"];
-  try {
-    await herdr(["agent", "prompt", paneId, text, ...wait]);
-    return;
-  } catch (err) {
-    if (!(err instanceof HerdrError) || err.code === void 0) throw err;
-    if (err.code === PROMPT_STALLED_CODE) {
-      const warn2 = opts.onUndelivered ?? defaultUndeliveredWarning2;
-      warn2({
-        paneId,
-        reason: "paste-vanished",
-        message: `send to ${paneId} was submitted but the agent's state never changed (herdr: ${PROMPT_STALLED_CODE}). The agent may NOT have seen it. Read the pane, or re-send.`
-      });
-      return;
-    }
-    if (!NO_AGENT_CODES.includes(err.code)) throw err;
-  }
-  await herdr(["pane", "run", paneId, text]);
+async function enableMuPaneBorders(target) {
+  if (muBannersDisabled()) return;
+  await tmux(["set-option", "-w", "-t", target, "pane-border-status", "top"]);
+  await tmux(["set-option", "-w", "-t", target, "pane-border-lines", "heavy"]);
+  await tmux(["set-option", "-w", "-t", target, "pane-active-border-style", "fg=cyan,bold"]);
+  await tmux(["set-option", "-w", "-t", target, "pane-border-style", "fg=brightblack"]);
 }
-async function capturePane2(paneId, opts = {}) {
-  assertValidPaneId2(paneId);
-  const args = ["pane", "read", paneId];
-  if (opts.lines === 0) {
-    args.push("--source", "visible");
-  } else {
-    args.push("--source", "recent-unwrapped");
-    if (opts.lines !== void 0) args.push("--lines", String(opts.lines));
-  }
-  const result = await currentExecutor2(args);
-  if (result.exitCode === 2) throw new HerdrSyntaxError(args, result.stderr || result.stdout);
+async function paneTTY(paneId) {
+  assertValidPaneId(paneId);
+  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{pane_tty}"]);
   if (result.exitCode !== 0) {
-    throw new HerdrError(
-      args,
+    if (/can't find pane|pane not found/i.test(result.stderr)) {
+      throw new PaneNotFoundError(paneId, tmuxBackend);
+    }
+    throw new TmuxError(
+      ["display-message", "-t", paneId, "-p", "#{pane_tty}"],
       result.stderr,
       result.stdout,
-      result.exitCode,
-      parseErrorEnvelope(result.stderr)?.code
+      result.exitCode
     );
   }
-  return result.stdout;
+  const tty = result.stdout.trim();
+  if (tty === "") throw new PaneNotFoundError(paneId, tmuxBackend);
+  return tty;
 }
-function mapAgentStatus(agentStatus) {
-  switch (agentStatus) {
-    case "working":
-      return "busy";
-    case "blocked":
-      return "needs_permission";
-    default:
-      return "needs_input";
-  }
+async function getPaneTitle(paneId) {
+  if (!isValidPaneId(paneId)) return void 0;
+  const result = await currentExecutor(["display-message", "-t", paneId, "-p", "#{pane_title}"]);
+  if (result.exitCode !== 0) return void 0;
+  return result.stdout.trimEnd();
 }
-async function paneStatus(paneId) {
-  if (!isValidPaneId2(paneId)) return void 0;
-  const result = await herdrTolerating(
-    ["pane", "get", paneId],
-    ["pane_not_found", "workspace_not_found"]
-  );
-  if (result === void 0) return void 0;
-  const pane = result.pane;
-  const status = isRecord(pane) ? asString(pane.agent_status) : void 0;
-  if (status === void 0) return void 0;
-  return mapAgentStatus(status);
+async function currentPaneTitle() {
+  const paneId = process.env.TMUX_PANE;
+  if (!paneId || !isValidPaneId(paneId)) return void 0;
+  return getPaneTitle(paneId);
 }
-async function enableMuPaneBordersForSession2(_session) {
-  return 0;
+async function currentAgentName() {
+  const title = await currentPaneTitle();
+  if (title === void 0) return void 0;
+  return parseAgentNameFromTitle(title);
 }
-async function enableMuPaneBordersForPane2(_paneId) {
+async function currentSessionName() {
+  if (!process.env.TMUX) return void 0;
+  const result = await currentExecutor(["display-message", "-p", "#S"]);
+  if (result.exitCode !== 0) return void 0;
+  const name = result.stdout.trim();
+  return name === "" ? void 0 : name;
 }
-function appendEnvFlags2(args, env) {
-  if (!env) return;
-  for (const [k, v] of Object.entries(env)) {
-    if (k.length === 0) throw new TypeError("herdr env key must be non-empty");
-    if (k.includes("=")) {
-      throw new TypeError(`herdr env key must not contain '=': ${JSON.stringify(k)}`);
+async function selectLayout(window, layout) {
+  await tmux(["select-layout", "-t", window, layout]);
+}
+function defaultSendReadinessMs() {
+  const raw = process.env.MU_SEND_READINESS_MS;
+  if (raw === void 0) return 15e3;
+  const parsed = Number.parseInt(raw, 10);
+  if (Number.isNaN(parsed) || parsed < 0) return 15e3;
+  return parsed;
+}
+var SEND_READINESS_POLL_MS = 250;
+var QUIESCENCE_CONFIRMATIONS = 3;
+var SUBMIT_RETRIES = 2;
+var SUBMIT_SETTLE_MS = 600;
+var SUBMIT_VERIFY_SAMPLES = 4;
+var SUBMIT_VERIFY_INTERVAL_MS = 700;
+var WORK_MARKERS = ["to interrupt)", "Working"];
+function hasWorkMarker(scrollback) {
+  const tail = scrollback.split("\n").slice(-40).join("\n");
+  return WORK_MARKERS.some((m) => tail.includes(m));
+}
+async function awaitPaneQuiescence(paneId, budgetMs) {
+  if (budgetMs <= 0) return true;
+  const deadline = Date.now() + budgetMs;
+  let calm = 0;
+  for (; ; ) {
+    const scrollback = await capturePane(paneId, { lines: 50 }).catch(() => void 0);
+    const busy = scrollback === void 0 || paneLooksBusy(scrollback);
+    if (busy && scrollback !== void 0 && hasWorkMarker(scrollback)) return true;
+    if (!busy) {
+      calm++;
+      if (calm >= QUIESCENCE_CONFIRMATIONS) return true;
+    } else {
+      calm = 0;
     }
-    args.push("--env", `${k}=${v}`);
+    const remaining = deadline - Date.now();
+    if (remaining <= 0) return false;
+    await currentSleep(Math.min(SEND_READINESS_POLL_MS, remaining));
   }
 }
-function rejectCommand(method, command) {
-  if (command === void 0 || command.trim().length === 0) return;
-  throw new HerdrNotImplementedError(`${method} with a command`, "mux-herdr-spawn");
+function pasteProbe(text) {
+  const firstLine = (text.split("\n")[0] ?? "").trim();
+  return firstLine.slice(0, 24);
 }
-function readCreatedPaneId(result, key, args) {
-  const pane = readPane(result[key]);
-  if (pane === void 0) {
-    throw new HerdrError(
-      args,
-      `herdr response had no ${key}.pane_id: ${JSON.stringify(result)}`,
-      "",
-      0
+async function isTextStranded(paneId, probe) {
+  for (let i = 0; i < SUBMIT_VERIFY_SAMPLES; i++) {
+    if (i > 0) await currentSleep(SUBMIT_VERIFY_INTERVAL_MS);
+    const capture = await capturePane(paneId, { lines: 50 }).catch(() => void 0);
+    if (capture === void 0) return false;
+    if (paneLooksBusy(capture)) return false;
+    let count = 0;
+    let idx = capture.indexOf(probe);
+    while (idx !== -1 && count < 2) {
+      count++;
+      idx = capture.indexOf(probe, idx + probe.length);
+    }
+    if (count !== 1) return false;
+  }
+  return true;
+}
+function defaultUndeliveredWarning(warning) {
+  console.warn(`warning: ${warning.message}`);
+}
+async function sendToPane(paneId, text, opts = {}) {
+  assertValidPaneId(paneId);
+  const readinessMs = opts.readinessMs ?? defaultSendReadinessMs();
+  const quiesced = await awaitPaneQuiescence(paneId, readinessMs);
+  const copyResult = await currentExecutor(["copy-mode", "-q", "-t", paneId]);
+  if (copyResult.exitCode !== 0 && /can't find pane|no current target/i.test(copyResult.stderr)) {
+    throw new TmuxError(
+      ["copy-mode", "-q", "-t", paneId],
+      copyResult.stderr,
+      copyResult.stdout,
+      copyResult.exitCode
     );
   }
-  assertValidPaneId2(pane.paneId);
-  return pane.paneId;
+  const bufferName = `mu-send-${process.pid}-${Date.now()}-${Math.floor(Math.random() * 1e6)}`;
+  await tmux(["set-buffer", "-b", bufferName, text]);
+  try {
+    await tmux(["paste-buffer", "-p", "-d", "-r", "-b", bufferName, "-t", paneId]);
+  } catch (err) {
+    await currentExecutor(["delete-buffer", "-b", bufferName]).catch(() => {
+    });
+    throw err;
+  }
+  const delay2 = opts.delayMs ?? defaultSendDelayMs();
+  if (delay2 > 0) await currentSleep(delay2);
+  await tmux(["send-keys", "-t", paneId, "Enter"]);
+  if (readinessMs <= 0) return;
+  const probe = pasteProbe(text);
+  if (probe.length === 0) return;
+  for (let attempt = 0; attempt <= SUBMIT_RETRIES; attempt++) {
+    if (!await isTextStranded(paneId, probe)) return;
+    if (attempt === SUBMIT_RETRIES) break;
+    await tmux(["send-keys", "-t", paneId, "Enter"]);
+    await currentSleep(SUBMIT_SETTLE_MS);
+  }
+  const warn2 = opts.onUndelivered ?? defaultUndeliveredWarning;
+  warn2({
+    paneId,
+    reason: quiesced ? "paste-vanished" : "busy-at-deadline",
+    message: `send to ${paneId} was NOT submitted: the text is still sitting unsubmitted in the pane's input box after ${SUBMIT_RETRIES + 1} Enter attempts. The agent has NOT seen it. Press Enter in the pane, or re-send.`
+  });
 }
-function isHerdrStatusUsable(stdout) {
-  if (!/^\s*status:\s*running\s*$/m.test(stdout)) return false;
-  if (/^\s*endpoint_compatible:\s*no\s*$/m.test(stdout)) return false;
-  return !/^\s*compatible:\s*no\s*$/m.test(stdout);
+async function capturePane(paneId, opts = {}) {
+  assertValidPaneId(paneId);
+  const args = ["capture-pane", "-t", paneId, "-p"];
+  if (opts.lines === void 0) {
+    args.push("-S", "-", "-E", "-");
+  } else if (opts.lines > 0) {
+    args.push("-S", `-${opts.lines}`);
+  }
+  return tmux(args);
 }
-async function herdrAvailable() {
-  const result = await currentExecutor2(["status"]).catch(() => void 0);
-  if (result === void 0 || result.exitCode !== 0) return false;
-  return isHerdrStatusUsable(result.stdout);
+async function tmuxAvailable() {
+  try {
+    await tmux(["-V"]);
+    return true;
+  } catch {
+    return false;
+  }
 }
-function attachHint2(target) {
+function attachTargetSpec(target) {
+  return target.window === void 0 ? target.session : `${target.session}:${target.window}`;
+}
+function attachHint(target) {
+  const spec = attachTargetSpec(target);
+  if (target.inside === true) return `tmux switch-client -t ${spec}`;
+  if (target.window === void 0) return `tmux attach -t ${target.session}`;
+  return `tmux attach -t ${target.session} && tmux select-window -t ${spec}`;
+}
+function attachCommands(target) {
+  const spec = attachTargetSpec(target);
+  if (target.inside === true) {
+    return [{ command: "tmux", args: ["switch-client", "-t", spec] }];
+  }
+  const steps = [{ command: "tmux", args: ["attach-session", "-t", target.session] }];
   if (target.window !== void 0) {
-    return `herdr session attach ${target.session} # then focus tab ${target.window}`;
+    steps.push({ command: "tmux", args: ["select-window", "-t", spec], optional: true });
   }
-  return `herdr session attach ${target.session}`;
-}
-function attachCommands2(target) {
-  return [{ command: "herdr", args: ["session", "attach", target.session] }];
+  return steps;
 }
-function paneNotFoundNextSteps2(paneId) {
+function paneNotFoundNextSteps(paneId) {
   return [
     {
       intent: `Verify the pane id ${paneId} actually exists`,
-      command: `herdr pane get ${paneId}`
+      command: `tmux display-message -t ${paneId} -p '#{pane_id} #{pane_title}'`
     },
     {
-      intent: "List panes in the current workspace",
-      command: 'herdr pane list --workspace "$HERDR_WORKSPACE_ID"'
+      intent: "List all live panes across all sessions",
+      command: "tmux list-panes -a -F '#{session_name}:#{window_id}.#{pane_id}\\t#{pane_title}\\t#{pane_current_command}'"
     }
   ];
 }
-async function healthCheck2() {
+async function healthCheck() {
   let version = null;
   try {
-    const result = await currentExecutor2(["status"]);
-    if (result.exitCode === 0) {
-      const match = /^\s*version:\s*(\S+)\s*$/m.exec(result.stdout);
-      version = match?.[1] ?? null;
-    }
+    version = (await tmux(["-V"])).trim();
   } catch {
     version = null;
   }
   return {
-    name: "herdr",
+    name: "tmux",
     ok: version !== null,
     version,
     env: [
-      { name: "$HERDR_ENV", value: process.env.HERDR_ENV ?? null },
-      { name: "$HERDR_WORKSPACE_ID", value: process.env.HERDR_WORKSPACE_ID ?? null },
-      { name: "$HERDR_PANE_ID", value: process.env.HERDR_PANE_ID ?? null }
+      { name: "$TMUX", value: process.env.TMUX ?? null },
+      { name: "$TMUX_PANE", value: process.env.TMUX_PANE ?? null }
     ],
-    remediation: "start the herdr server (herdr status) or install herdr"
+    remediation: "install tmux \u2265 3.0"
   };
 }
-var herdrBackend = Object.freeze({
-  name: "herdr",
-  available: herdrAvailable,
-  isValidPaneId: isValidPaneId2,
-  assertValidPaneId: assertValidPaneId2,
-  listSessions: listSessions2,
-  sessionExists: sessionExists2,
-  newSession: newSession2,
-  newSessionWithPane: newSessionWithPane2,
-  killSession: killSession2,
-  listWindows: listWindows2,
-  newWindow: newWindow2,
-  selectLayout: selectLayout2,
-  listPanes: listPanes2,
-  listPanesInSession: listPanesInSession2,
-  splitWindow: splitWindow2,
-  killPane: killPane2,
-  paneExists: paneExists2,
-  paneTTY: paneTTY2,
-  setPaneTitle: setPaneTitle2,
-  getPaneTitle: getPaneTitle2,
-  currentAgentName: currentAgentName2,
-  currentSessionName: currentSessionName2,
-  startAgentInPane,
-  sendToPane: sendToPane2,
-  capturePane: capturePane2,
-  paneStatus,
-  enableMuPaneBordersForSession: enableMuPaneBordersForSession2,
-  enableMuPaneBordersForPane: enableMuPaneBordersForPane2,
-  attachHint: attachHint2,
-  attachCommands: attachCommands2,
-  paneNotFoundNextSteps: paneNotFoundNextSteps2,
-  healthCheck: healthCheck2
+var tmuxBackend = Object.freeze({
+  name: "tmux",
+  available: tmuxAvailable,
+  isValidPaneId,
+  assertValidPaneId,
+  listSessions,
+  sessionExists,
+  newSession,
+  newSessionWithPane,
+  killSession,
+  listWindows,
+  newWindow,
+  selectLayout,
+  listPanes,
+  listPanesInSession,
+  splitWindow,
+  killPane,
+  paneExists,
+  paneTTY,
+  setPaneTitle,
+  getPaneTitle,
+  currentAgentName,
+  currentSessionName,
+  sendToPane,
+  capturePane,
+  enableMuPaneBordersForSession,
+  enableMuPaneBordersForPane,
+  attachHint,
+  attachCommands,
+  paneNotFoundNextSteps,
+  healthCheck
 });
 
-// src/mux/detect.ts
-var BACKENDS = [tmuxBackend, herdrBackend];
-function muxByName(name) {
-  for (const backend of BACKENDS) {
-    if (backend.name === name) return backend;
+// src/mux/herdr.ts
+var HerdrError = class extends MuxError {
+  constructor(args, stderr, stdout, exitCode, code) {
+    const detail = parseErrorEnvelope(stderr)?.message ?? stderr.trim() ?? stdout.trim();
+    super(`herdr ${args.join(" ")} failed (exit ${exitCode}): ${detail || "no output"}`);
+    this.args = args;
+    this.stderr = stderr;
+    this.stdout = stdout;
+    this.exitCode = exitCode;
+    this.code = code;
+    this.name = "HerdrError";
   }
-  throw new Error(`unknown mux backend: ${name}`);
-}
-var KNOWN_NAMES = BACKENDS.map((b) => b.name);
-async function detectMux() {
-  const override = process.env.MU_MUX;
-  if (override !== void 0 && override.length > 0) {
-    return muxByName(override);
+  args;
+  stderr;
+  stdout;
+  exitCode;
+  code;
+  errorNextSteps() {
+    return [
+      { intent: "Run health check", command: "mu doctor" },
+      { intent: "Verify the herdr server is running", command: "herdr status" },
+      {
+        intent: "Check the failing herdr command in isolation",
+        command: `herdr ${this.args.join(" ")}`
+      }
+    ];
   }
-  if (process.env.HERDR_ENV === "1") return herdrBackend;
-  if (process.env.TMUX || process.env.TMUX_PANE) return tmuxBackend;
-  for (const backend of BACKENDS) {
-    if (await backend.available()) return backend;
+};
+var HerdrSyntaxError = class extends Error {
+  constructor(args, output) {
+    super(
+      `herdr rejected the command line (exit 2) \u2014 this is a bug in mu, not a herdr outage. Ran: herdr ${args.join(" ")}. herdr said: ${output.trim().split("\n")[0] ?? "(no output)"}`
+    );
+    this.args = args;
+    this.output = output;
   }
-  throw new NoMultiplexerError(KNOWN_NAMES);
-}
-var cached;
-async function activeMux() {
-  if (cached === void 0) cached = await detectMux();
-  return cached;
-}
-function setMuxForTests(backend) {
-  const previous = cached;
-  cached = backend;
-  return previous;
-}
-function resetMux() {
-  cached = void 0;
-}
-
-// src/agents/spawn.ts
-import { execFile as execFile2 } from "child_process";
-import { mkdirSync as mkdirSync2, rmSync as rmSync4 } from "fs";
-import { basename, dirname as dirname6 } from "path";
-import { setTimeout as delay } from "timers/promises";
-import { promisify as promisify2 } from "util";
-
-// src/agents.ts
-import { dirname as dirname5 } from "path";
-
-// src/glyphs.ts
-var AGENT_STATE_GLYPH = {
-  busy: "\uF04B",
-  // nf-fa-play
-  needs_input: "\uF186",
-  // nf-fa-moon_o
-  needs_permission: "\uF023",
-  // nf-fa-lock
-  unknown: "\uF059"
-  // nf-fa-question_circle
+  args;
+  output;
+  name = "HerdrSyntaxError";
 };
-function agentStateGlyph(state) {
-  return AGENT_STATE_GLYPH[state] ?? GLYPH.unknown;
-}
-var GLYPH = {
-  /** Healthy, clean, passing, closed-successfully. */
-  ok: "\uF058",
-  // nf-fa-check_circle
-  /** Failed check. */
-  fail: "\uF057",
-  // nf-fa-times_circle
-  /** Needs attention but not broken (idle-but-assigned, stale warning). */
-  warn: "\uF071",
-  // nf-fa-warning
-  /** Workspace has uncommitted edits. */
-  dirty: "\uF005",
-  // nf-fa-star
-  /** Workspace is ≥ WORKSPACE_STALE_THRESHOLD commits behind main. */
-  stale: "\uF017",
-  // nf-fa-clock_o
-  /** Task is blocked by an incoming edge. */
-  blocked: "\uF0C1",
-  // nf-fa-link (chain)
-  /** Task is parked (OPEN/parked): open, but set aside on purpose. */
-  parked: "\uF04C",
-  // nf-fa-pause
-  /** Track whose roots merged (diamond dependency). */
-  merge: "\uF074",
-  // nf-fa-random
-  /** Agent owns more than one task (pane-title multi-count slot). */
-  multi: "\uF055",
-  // nf-fa-plus_circle
-  /** Filter toggle: enabled / disabled. */
-  on: "\uF111",
-  // nf-fa-circle
-  off: "\uF10C",
-  // nf-fa-circle_o
-  /** Status outside the known enum. */
-  unknown: "\uF059"
-  // nf-fa-question_circle
+var HerdrUnsupportedCliError = class extends Error {
+  constructor(cli, detail) {
+    super(
+      `herdr does not recognise --cli ${cli} as an interactive agent kind, so it cannot classify that pane's status. herdr said: ${detail}`
+    );
+    this.cli = cli;
+    this.detail = detail;
+  }
+  cli;
+  detail;
+  name = "HerdrUnsupportedCliError";
+  errorNextSteps() {
+    return [
+      {
+        intent: "List the agent kinds this herdr knows",
+        command: "herdr agent start --help"
+      },
+      {
+        intent: "Spawn with a kind herdr supports",
+        command: "mu agent spawn <name> --cli pi -w <workstream>"
+      },
+      {
+        intent: "Or spawn this cli under tmux, which runs any command",
+        command: `MU_MUX=tmux mu agent spawn <name> --cli ${this.cli}`
+      }
+    ];
+  }
 };
-
-// src/logs.ts
-import { randomUUID as randomUUID2 } from "crypto";
-
-// src/hlc.ts
-var WALL_WIDTH = 15;
-var COUNTER_WIDTH = 6;
-var SEP = ".";
-var MAX_WALL = 10 ** WALL_WIDTH - 1;
-var MAX_COUNTER = 10 ** COUNTER_WIDTH - 1;
-var HlcParseError = class extends Error {
-  constructor(value) {
-    super(`Malformed HLC: ${JSON.stringify(value)}`);
-    this.value = value;
-    this.name = "HlcParseError";
+var HerdrCommandOverrideError = class extends Error {
+  constructor(cli, command, envVar) {
+    super(
+      (envVar === void 0 ? `--command ${JSON.stringify(command)} cannot be honoured on the herdr backend` : `${envVar}=${command} cannot be honoured on the herdr backend`) + `: 'herdr agent start --kind ${cli}' resolves the executable itself and has no override flag. mu refuses rather than starting a different binary than you asked for.`
+    );
+    this.cli = cli;
+    this.command = command;
+    this.envVar = envVar;
+  }
+  cli;
+  command;
+  envVar;
+  name = "HerdrCommandOverrideError";
+  errorNextSteps() {
+    return [
+      ...this.envVar === void 0 ? [
+        {
+          intent: "Spawn without --command so herdr resolves the agent itself",
+          command: `mu agent spawn <name> --cli ${this.cli} -w <workstream>`
+        }
+      ] : [
+        {
+          intent: `Unset the override so herdr resolves ${this.cli} itself`,
+          command: `unset ${this.envVar}`
+        }
+      ],
+      {
+        intent: "Or spawn under tmux, which runs the command you name",
+        command: `MU_MUX=tmux mu agent spawn <name> --cli ${this.cli}`
+      }
+    ];
   }
-  value;
 };
-var HlcOverflowError = class extends Error {
-  constructor(field, value) {
+var GROUP_CLOSE_REQUIRED_CODE = "workspace_group_close_required";
+var HerdrWorkspaceGroupCloseError = class extends Error {
+  constructor(session, workspaceId, detail) {
     super(
-      field === "counter" ? `HLC counter overflow (${value} > ${MAX_COUNTER}): more than ${MAX_COUNTER + 1} ops in one millisecond` : `HLC wall-clock overflow (${value} > ${MAX_WALL}): system clock is far in the future`
+      `herdr refused to close workspace ${workspaceId} (${session}): it has linked worktree workspaces, which mu did not create and will not close on your behalf. herdr said: ${detail}`
+    );
+    this.session = session;
+    this.workspaceId = workspaceId;
+    this.detail = detail;
+  }
+  session;
+  workspaceId;
+  detail;
+  name = "HerdrWorkspaceGroupCloseError";
+  errorNextSteps() {
+    return [
+      {
+        intent: "See which workspaces are linked as a group",
+        command: "herdr workspace list"
+      },
+      {
+        intent: "Remove the worktree workspaces you no longer want",
+        command: "herdr worktree remove <workspace-id>"
+      },
+      {
+        intent: "Or close the whole group yourself, then re-run the teardown",
+        command: `herdr workspace close ${this.workspaceId} --group`
+      }
+    ];
+  }
+};
+var HerdrNotImplementedError = class extends Error {
+  name = "HerdrNotImplementedError";
+  constructor(method, owner) {
+    super(`herdr backend: ${method} is not implemented yet (owned by task ${owner})`);
+  }
+};
+var HERDR_ORDINAL = "[0-9A-Z]+";
+var PANE_ID_RE2 = new RegExp(`^w${HERDR_ORDINAL}:p${HERDR_ORDINAL}$`);
+var WORKSPACE_ID_RE = new RegExp(`^w${HERDR_ORDINAL}$`);
+var TAB_ID_RE = new RegExp(`^w${HERDR_ORDINAL}:t${HERDR_ORDINAL}$`);
+function isValidPaneId2(s) {
+  return PANE_ID_RE2.test(s);
+}
+function assertValidPaneId2(s) {
+  if (!isValidPaneId2(s)) {
+    throw new TypeError(
+      `invalid herdr pane id: ${JSON.stringify(s)} (expected ${PANE_ID_RE2.source})`
+    );
+  }
+}
+function herdrGlobalFlags() {
+  const session = process.env.MU_HERDR_SESSION;
+  if (session === void 0 || session.length === 0) return [];
+  return ["--session", session];
+}
+var realExecutor2 = async (args) => {
+  const result = await execa2("herdr", [...herdrGlobalFlags(), ...args], { reject: false });
+  return {
+    stdout: result.stdout ?? "",
+    stderr: result.stderr ?? "",
+    exitCode: result.exitCode ?? null
+  };
+};
+var currentExecutor2 = realExecutor2;
+function setHerdrExecutor(executor) {
+  const previous = currentExecutor2;
+  currentExecutor2 = executor;
+  return previous;
+}
+function resetHerdrExecutor() {
+  currentExecutor2 = realExecutor2;
+}
+function isRecord(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function asString(v) {
+  return typeof v === "string" ? v : void 0;
+}
+function parseErrorEnvelope(stderr) {
+  const trimmed = stderr.trim();
+  if (trimmed.length === 0) return void 0;
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    return void 0;
+  }
+  if (!isRecord(parsed)) return void 0;
+  const err = parsed.error;
+  if (!isRecord(err)) return void 0;
+  const code = asString(err.code);
+  const message = asString(err.message);
+  if (code === void 0) return void 0;
+  return { code, message: message ?? code };
+}
+async function herdr(args) {
+  const result = await currentExecutor2(args);
+  if (result.exitCode === 2) {
+    throw new HerdrSyntaxError([...args], result.stderr || result.stdout);
+  }
+  if (result.exitCode !== 0) {
+    throw new HerdrError(
+      [...args],
+      result.stderr,
+      result.stdout,
+      result.exitCode,
+      parseErrorEnvelope(result.stderr)?.code
+    );
+  }
+  const trimmed = result.stdout.trim();
+  if (trimmed.length === 0) return {};
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch {
+    throw new HerdrError([...args], result.stderr, result.stdout, result.exitCode);
+  }
+  if (!isRecord(parsed)) return {};
+  const inner = parsed.result;
+  return isRecord(inner) ? inner : {};
+}
+async function herdrTolerating(args, tolerate) {
+  try {
+    return await herdr(args);
+  } catch (err) {
+    if (err instanceof HerdrError && err.code !== void 0 && tolerate.includes(err.code)) {
+      return void 0;
+    }
+    throw err;
+  }
+}
+function readWorkspace(v) {
+  if (!isRecord(v)) return void 0;
+  const workspaceId = asString(v.workspace_id);
+  if (workspaceId === void 0) return void 0;
+  return { workspaceId, label: asString(v.label) ?? "" };
+}
+function readTab(v) {
+  if (!isRecord(v)) return void 0;
+  const id = asString(v.tab_id);
+  if (id === void 0) return void 0;
+  return { id, name: asString(v.label) ?? "" };
+}
+function readPane(v) {
+  if (!isRecord(v)) return void 0;
+  const paneId = asString(v.pane_id);
+  if (paneId === void 0) return void 0;
+  return {
+    paneId,
+    // herdr's optional `label` is what `pane rename` writes and is
+    // therefore mu's pane-title equivalent.
+    title: asString(v.label) ?? "",
+    // herdr does not report a foreground command on `pane list`; the
+    // authoritative answer costs a `pane process-info` round trip per
+    // pane. Callers that need it use `paneCommand()`.
+    command: "",
+    windowId: asString(v.tab_id)
+  };
+}
+function readArray(result, key) {
+  const v = result[key];
+  return Array.isArray(v) ? v : [];
+}
+async function listWorkspaces() {
+  const result = await herdr(["workspace", "list"]);
+  const out = [];
+  for (const raw of readArray(result, "workspaces")) {
+    const ws = readWorkspace(raw);
+    if (ws) out.push(ws);
+  }
+  return out;
+}
+async function listSessions2() {
+  return (await listWorkspaces()).map((ws) => ({ name: ws.label }));
+}
+async function resolveWorkspaceId(name) {
+  for (const ws of await listWorkspaces()) {
+    if (ws.label === name) return ws.workspaceId;
+  }
+  return void 0;
+}
+async function requireWorkspaceId(name) {
+  const id = await resolveWorkspaceId(name);
+  if (id === void 0) {
+    throw new HerdrError(
+      ["workspace", "list"],
+      `{"error":{"code":"workspace_not_found","message":"no herdr workspace labelled ${name}"}}`,
+      "",
+      1,
+      "workspace_not_found"
+    );
+  }
+  return id;
+}
+async function sessionExists2(name) {
+  return await resolveWorkspaceId(name) !== void 0;
+}
+async function newSession2(name, opts = {}) {
+  rejectCommand("newSession", opts.command);
+  const args = ["workspace", "create", "--label", name, "--no-focus"];
+  if (opts.cwd) args.push("--cwd", opts.cwd);
+  appendEnvFlags2(args, opts.env);
+  await herdr(args);
+}
+async function newSessionWithPane2(name, opts) {
+  rejectCommand("newSessionWithPane", opts.command);
+  const args = ["workspace", "create", "--label", name, "--no-focus"];
+  if (opts.cwd) args.push("--cwd", opts.cwd);
+  appendEnvFlags2(args, opts.env);
+  const result = await herdr(args);
+  return readCreatedPaneId(result, "root_pane", args);
+}
+async function killSession2(name) {
+  const id = await resolveWorkspaceId(name);
+  if (id === void 0) return;
+  try {
+    await herdrTolerating(["workspace", "close", id], ["workspace_not_found"]);
+  } catch (err) {
+    if (err instanceof HerdrError && err.code === GROUP_CLOSE_REQUIRED_CODE) {
+      throw new HerdrWorkspaceGroupCloseError(name, id, err.message);
+    }
+    throw err;
+  }
+}
+async function listWindows2(session) {
+  if (session !== void 0) {
+    const id = await resolveWorkspaceId(session);
+    if (id === void 0) return [];
+    return readTabs(await herdr(["tab", "list", "--workspace", id]));
+  }
+  const windows = [];
+  for (const ws of await listWorkspaces()) {
+    for (const tab of readTabs(await herdr(["tab", "list", "--workspace", ws.workspaceId]))) {
+      windows.push({ ...tab, sessionName: ws.label });
+    }
+  }
+  return windows;
+}
+function readTabs(result) {
+  const out = [];
+  for (const raw of readArray(result, "tabs")) {
+    const tab = readTab(raw);
+    if (tab) out.push(tab);
+  }
+  return out;
+}
+async function newWindow2(opts) {
+  rejectCommand("newWindow", opts.command);
+  const args = ["tab", "create"];
+  if (opts.session !== void 0) {
+    args.push("--workspace", await requireWorkspaceId(opts.session));
+  }
+  args.push("--label", opts.name, "--no-focus");
+  if (opts.cwd) args.push("--cwd", opts.cwd);
+  appendEnvFlags2(args, opts.env);
+  return readCreatedPaneId(await herdr(args), "root_pane", args);
+}
+async function selectLayout2(_window, _layout) {
+}
+async function listPanesInSession2(session) {
+  const id = await resolveWorkspaceId(session);
+  if (id === void 0) return [];
+  const result = await herdrTolerating(
+    ["pane", "list", "--workspace", id],
+    ["workspace_not_found"]
+  );
+  if (result === void 0) return [];
+  return readPanes(result).map((p) => ({ ...p, sessionName: session }));
+}
+async function listPanes2(target) {
+  if (target !== void 0 && target !== "*") {
+    if (TAB_ID_RE.test(target)) {
+      const workspaceId = target.split(":")[0] ?? target;
+      const panes2 = readPanes(await herdr(["pane", "list", "--workspace", workspaceId]));
+      return panes2.filter((p) => p.windowId === target);
+    }
+    if (WORKSPACE_ID_RE.test(target)) {
+      return readPanes(await herdr(["pane", "list", "--workspace", target]));
+    }
+    return listPanesInSession2(target);
+  }
+  const ambient = process.env.HERDR_WORKSPACE_ID;
+  if (target === void 0 && ambient !== void 0 && WORKSPACE_ID_RE.test(ambient)) {
+    return readPanes(await herdr(["pane", "list", "--workspace", ambient]));
+  }
+  const panes = [];
+  for (const ws of await listWorkspaces()) {
+    for (const pane of readPanes(await herdr(["pane", "list", "--workspace", ws.workspaceId]))) {
+      panes.push({ ...pane, sessionName: ws.label });
+    }
+  }
+  return panes;
+}
+function readPanes(result) {
+  const out = [];
+  for (const raw of readArray(result, "panes")) {
+    const pane = readPane(raw);
+    if (pane) out.push(pane);
+  }
+  return out;
+}
+async function splitWindow2(opts) {
+  rejectCommand("splitWindow", opts.command);
+  assertValidPaneId2(opts.target);
+  const args = [
+    "pane",
+    "split",
+    opts.target,
+    "--direction",
+    opts.horizontal === false ? "down" : "right",
+    "--no-focus"
+  ];
+  if (opts.cwd) args.push("--cwd", opts.cwd);
+  appendEnvFlags2(args, opts.env);
+  return readCreatedPaneId(await herdr(args), "pane", args);
+}
+async function killPane2(paneId) {
+  assertValidPaneId2(paneId);
+  await herdrTolerating(["pane", "close", paneId], ["pane_not_found", "workspace_not_found"]);
+}
+async function paneExists2(paneId) {
+  if (!isValidPaneId2(paneId)) return false;
+  const pane = await getPane(paneId);
+  return pane !== void 0;
+}
+async function getPane(paneId) {
+  const result = await herdrTolerating(
+    ["pane", "get", paneId],
+    ["pane_not_found", "workspace_not_found"]
+  );
+  if (result === void 0) return void 0;
+  return readPane(result.pane);
+}
+async function paneTTY2(paneId) {
+  assertValidPaneId2(paneId);
+  const result = await herdrTolerating(
+    ["pane", "process-info", "--pane", paneId],
+    ["pane_not_found", "workspace_not_found"]
+  );
+  if (result === void 0) throw new PaneNotFoundError(paneId);
+  const info = result.process_info;
+  const pid = isRecord(info) ? info.shell_pid : void 0;
+  if (typeof pid !== "number") throw new PaneNotFoundError(paneId);
+  const { readlink } = await import("fs/promises");
+  try {
+    return await readlink(`/proc/${pid}/fd/0`);
+  } catch (err) {
+    throw new HerdrError(
+      ["pane", "process-info", "--pane", paneId],
+      `cannot resolve the TTY for herdr pane ${paneId} (shell pid ${pid}) via /proc: ${String(err)}`,
+      "",
+      1
+    );
+  }
+}
+async function setPaneTitle2(paneId, title) {
+  assertValidPaneId2(paneId);
+  await herdr(["pane", "rename", paneId, title]);
+}
+async function getPaneTitle2(paneId) {
+  if (!isValidPaneId2(paneId)) return void 0;
+  const pane = await getPane(paneId).catch(() => void 0);
+  if (pane === void 0) return void 0;
+  return pane.title.length > 0 ? pane.title : void 0;
+}
+async function currentAgentName2() {
+  const paneId = process.env.HERDR_PANE_ID;
+  if (paneId === void 0 || !isValidPaneId2(paneId)) return void 0;
+  const title = await getPaneTitle2(paneId);
+  if (title === void 0) return void 0;
+  const idx = title.indexOf(" \xB7 ");
+  return idx === -1 ? title.trim() : title.slice(0, idx).trim();
+}
+async function currentSessionName2() {
+  const workspaceId = process.env.HERDR_WORKSPACE_ID;
+  if (workspaceId === void 0 || !WORKSPACE_ID_RE.test(workspaceId)) return void 0;
+  for (const ws of await listWorkspaces()) {
+    if (ws.workspaceId === workspaceId) return ws.label;
+  }
+  return void 0;
+}
+var PANE_READY_RETRY_INTERVAL_MS = 50;
+var PANE_READY_MAX_ATTEMPTS = 60;
+async function startAgentInPane(opts) {
+  assertValidPaneId2(opts.paneId);
+  if (opts.commandSource !== "cli-key") {
+    throw new HerdrCommandOverrideError(
+      opts.cli,
+      opts.command,
+      // Name the env var only when that is actually where the override
+      // came from; "unset MU_PI_COMMAND" is useless advice to someone who
+      // typed --command.
+      opts.commandSource === "env" ? envVarNameForCli(opts.cli) : void 0
+    );
+  }
+  const args = ["agent", "start", opts.name, "--kind", opts.cli, "--pane", opts.paneId];
+  for (let attempt = 1; ; attempt += 1) {
+    try {
+      await herdr(args);
+      return;
+    } catch (err) {
+      if (err instanceof HerdrSyntaxError) {
+        throw new HerdrUnsupportedCliError(opts.cli, err.output.trim().split("\n")[0] ?? "");
+      }
+      const busy = err instanceof HerdrError && err.code === "agent_pane_busy";
+      if (!busy || attempt >= PANE_READY_MAX_ATTEMPTS) throw err;
+      await sleep(PANE_READY_RETRY_INTERVAL_MS);
+    }
+  }
+}
+function envVarNameForCli(cli) {
+  return `MU_${cli.toUpperCase().replace(/-/g, "_")}_COMMAND`;
+}
+var PROMPT_STALLED_CODE = "agent_prompt_stalled";
+var NO_AGENT_CODES = ["agent_not_found", "agent_not_recognized"];
+function defaultUndeliveredWarning2(warning) {
+  console.warn(`warning: ${warning.message}`);
+}
+async function sendToPane2(paneId, text, opts = {}) {
+  assertValidPaneId2(paneId);
+  const wait = opts.readinessMs === 0 ? [] : ["--wait"];
+  try {
+    await herdr(["agent", "prompt", paneId, text, ...wait]);
+    return;
+  } catch (err) {
+    if (!(err instanceof HerdrError) || err.code === void 0) throw err;
+    if (err.code === PROMPT_STALLED_CODE) {
+      const warn2 = opts.onUndelivered ?? defaultUndeliveredWarning2;
+      warn2({
+        paneId,
+        reason: "paste-vanished",
+        message: `send to ${paneId} was submitted but the agent's state never changed (herdr: ${PROMPT_STALLED_CODE}). The agent may NOT have seen it. Read the pane, or re-send.`
+      });
+      return;
+    }
+    if (!NO_AGENT_CODES.includes(err.code)) throw err;
+  }
+  await herdr(["pane", "run", paneId, text]);
+}
+async function capturePane2(paneId, opts = {}) {
+  assertValidPaneId2(paneId);
+  const args = ["pane", "read", paneId];
+  if (opts.lines === 0) {
+    args.push("--source", "visible");
+  } else {
+    args.push("--source", "recent-unwrapped");
+    if (opts.lines !== void 0) args.push("--lines", String(opts.lines));
+  }
+  const result = await currentExecutor2(args);
+  if (result.exitCode === 2) throw new HerdrSyntaxError(args, result.stderr || result.stdout);
+  if (result.exitCode !== 0) {
+    throw new HerdrError(
+      args,
+      result.stderr,
+      result.stdout,
+      result.exitCode,
+      parseErrorEnvelope(result.stderr)?.code
     );
-    this.field = field;
-    this.value = value;
-    this.name = "HlcOverflowError";
-  }
-  field;
-  value;
-};
-var MachineIdentityMissingError = class extends Error {
-  constructor() {
-    super("machine_identity row (id = 1) is missing; the DB was not opened via openDb()");
-    this.name = "MachineIdentityMissingError";
   }
-};
-function formatHlc(hlc) {
-  const { wallMs, counter, machineId: machineId2 } = hlc;
-  if (!Number.isInteger(wallMs) || wallMs < 0) throw new HlcParseError(String(wallMs));
-  if (!Number.isInteger(counter) || counter < 0) throw new HlcParseError(String(counter));
-  if (wallMs > MAX_WALL) throw new HlcOverflowError("wall", wallMs);
-  if (counter > MAX_COUNTER) throw new HlcOverflowError("counter", counter);
-  if (machineId2.length === 0 || machineId2.includes(SEP)) throw new HlcParseError(machineId2);
-  return `${String(wallMs).padStart(WALL_WIDTH, "0")}${SEP}${String(counter).padStart(
-    COUNTER_WIDTH,
-    "0"
-  )}${SEP}${machineId2}`;
+  return result.stdout;
 }
-function parseHlc(value) {
-  const parts = value.split(SEP);
-  if (parts.length !== 3) throw new HlcParseError(value);
-  const [wall, counter, machineId2] = parts;
-  if (wall === void 0 || counter === void 0 || machineId2 === void 0) {
-    throw new HlcParseError(value);
-  }
-  if (wall.length !== WALL_WIDTH || counter.length !== COUNTER_WIDTH || machineId2.length === 0) {
-    throw new HlcParseError(value);
+function mapAgentStatus(agentStatus) {
+  switch (agentStatus) {
+    case "working":
+      return "busy";
+    case "blocked":
+      return "needs_permission";
+    default:
+      return "needs_input";
   }
-  if (!/^\d+$/.test(wall) || !/^\d+$/.test(counter)) throw new HlcParseError(value);
-  return { wallMs: Number(wall), counter: Number(counter), machineId: machineId2 };
 }
-function compareHlc(a, b) {
-  if (a < b) return -1;
-  if (a > b) return 1;
+async function paneStatus(paneId) {
+  if (!isValidPaneId2(paneId)) return void 0;
+  const result = await herdrTolerating(
+    ["pane", "get", paneId],
+    ["pane_not_found", "workspace_not_found"]
+  );
+  if (result === void 0) return void 0;
+  const pane = result.pane;
+  const status = isRecord(pane) ? asString(pane.agent_status) : void 0;
+  if (status === void 0) return void 0;
+  return mapAgentStatus(status);
+}
+async function enableMuPaneBordersForSession2(_session) {
   return 0;
 }
-function nextHlc(db, now = Date.now()) {
-  const row = db.prepare(
-    `UPDATE machine_identity
-          SET last_wall    = MAX(last_wall, @now),
-              last_counter = CASE WHEN @now > last_wall THEN 0 ELSE last_counter + 1 END
-        WHERE id = 1
-        RETURNING machine_id, last_wall, last_counter`
-  ).get({ now: Math.floor(now) });
-  if (!row) throw new MachineIdentityMissingError();
-  return formatHlc({ wallMs: row.last_wall, counter: row.last_counter, machineId: row.machine_id });
+async function enableMuPaneBordersForPane2(_paneId) {
 }
-function receiveHlc(db, remoteHlc, now = Date.now()) {
-  const remote = parseHlc(remoteHlc);
-  const wallNow = Math.floor(now);
-  const read = db.prepare(
-    "SELECT machine_id, last_wall, last_counter FROM machine_identity WHERE id = 1"
-  );
-  const write = db.prepare(
-    "UPDATE machine_identity SET last_wall = @wall, last_counter = @counter WHERE id = 1"
-  );
-  const advance = db.transaction(() => {
-    const row = read.get();
-    if (!row) throw new MachineIdentityMissingError();
-    const wall = Math.max(row.last_wall, remote.wallMs, wallNow);
-    const localAtMax = row.last_wall === wall;
-    const remoteAtMax = remote.wallMs === wall;
-    let counter;
-    if (!localAtMax && !remoteAtMax) {
-      counter = 0;
-    } else if (localAtMax && remoteAtMax) {
-      counter = Math.max(row.last_counter, remote.counter) + 1;
-    } else if (localAtMax) {
-      counter = row.last_counter + 1;
-    } else {
-      counter = remote.counter + 1;
+function appendEnvFlags2(args, env) {
+  if (!env) return;
+  for (const [k, v] of Object.entries(env)) {
+    if (k.length === 0) throw new TypeError("herdr env key must be non-empty");
+    if (k.includes("=")) {
+      throw new TypeError(`herdr env key must not contain '=': ${JSON.stringify(k)}`);
     }
-    if (counter > MAX_COUNTER) throw new HlcOverflowError("counter", counter);
-    write.run({ wall, counter });
-    return formatHlc({ wallMs: wall, counter, machineId: row.machine_id });
-  });
-  return advance.immediate();
+    args.push("--env", `${k}=${v}`);
+  }
 }
-
-// src/legacy-ops.ts
-var LEGACY_LOG_ONLY_INTENTS = /* @__PURE__ */ new Set(["workstream.export"]);
-function isLegacyLogOnlyIntent(intent) {
-  return intent !== null && LEGACY_LOG_ONLY_INTENTS.has(intent);
+function rejectCommand(method, command) {
+  if (command === void 0 || command.trim().length === 0) return;
+  throw new HerdrNotImplementedError(`${method} with a command`, "mux-herdr-spawn");
 }
-var LEGACY_INTENT_SYNONYMS = /* @__PURE__ */ new Map([
-  ["workstream.teardown", ["workstream.destroy"]]
-]);
-function intentSpellings(intent) {
-  const legacy = LEGACY_INTENT_SYNONYMS.get(intent);
-  return legacy === void 0 ? [intent] : [intent, ...legacy];
+function readCreatedPaneId(result, key, args) {
+  const pane = readPane(result[key]);
+  if (pane === void 0) {
+    throw new HerdrError(
+      args,
+      `herdr response had no ${key}.pane_id: ${JSON.stringify(result)}`,
+      "",
+      0
+    );
+  }
+  assertValidPaneId2(pane.paneId);
+  return pane.paneId;
 }
-var LEGACY_LOG_ONLY_SQL_EXCLUSION = `(intent IS NULL OR intent NOT IN (${[
-  ...LEGACY_LOG_ONLY_INTENTS
-].map((i) => `'${i}'`).join(", ")}))`;
-
-// src/logs.ts
-var SELECT_LOG_COLS = `
-  l.seq AS seq,
-  l.key AS workstream,
-  l.actor AS source,
-  l.intent AS intent,
-  l.group_id AS group_id,
-  l.op AS op,
-  l.entity AS kind,
-  l.payload AS payload,
-  l.created_at AS created_at
-`;
-var LOG_FROM_JOIN = "FROM ops l";
-function workstreamScopeSql(column = "l.key") {
-  return `(${column} = ? OR ${column} LIKE ? ESCAPE '\\')`;
+function isHerdrStatusUsable(stdout) {
+  if (!/^\s*status:\s*running\s*$/m.test(stdout)) return false;
+  if (/^\s*endpoint_compatible:\s*no\s*$/m.test(stdout)) return false;
+  return !/^\s*compatible:\s*no\s*$/m.test(stdout);
 }
-function workstreamScopeParams(workstream) {
-  const escaped = workstream.replace(/[\\%_]/g, (c) => `\\${c}`);
-  return [workstream, `${escaped}/%`];
+async function herdrAvailable() {
+  const result = await currentExecutor2(["status"]).catch(() => void 0);
+  if (result === void 0 || result.exitCode !== 0) return false;
+  return isHerdrStatusUsable(result.stdout);
 }
-var TOUCH_OP_FILTER = `NOT (
-  l.intent IS NOT NULL
-  AND l.op = 'put'
-  AND l.payload LIKE '{"updated_at":%'
-  AND LENGTH(l.payload) < 45
-)`;
-var MACHINE_WIDE_KEY = "";
-var GroupIdAmbiguousError = class extends Error {
-  constructor(prefix, candidates) {
-    super(
-      `group id ${JSON.stringify(prefix)} is ambiguous: matches ${candidates.length} groups (${candidates.slice(0, 4).map((c) => c.slice(0, 12)).join(", ")}${candidates.length > 4 ? ", \u2026" : ""})`
-    );
-    this.prefix = prefix;
-    this.candidates = candidates;
-    this.name = "GroupIdAmbiguousError";
-  }
-  prefix;
-  candidates;
-  errorNextSteps() {
-    return [
-      { intent: "List recent groups with their ids", command: "mu undo" },
-      {
-        intent: "Retry with more characters",
-        command: `mu log --group ${this.candidates[0] ?? "<full-id>"}`
-      }
-    ];
+function attachHint2(target) {
+  if (target.window !== void 0) {
+    return `herdr session attach ${target.session} # then focus tab ${target.window}`;
   }
-};
-function groupIdFromPrefix(db, prefix) {
-  if (prefix === "") return null;
-  const rows = db.prepare(
-    `SELECT DISTINCT group_id AS groupId FROM ops
-        WHERE group_id = @exact OR group_id LIKE @prefix || '%' ESCAPE '\\'`
-  ).all({ exact: prefix, prefix: prefix.replace(/[\\%_]/g, (c) => `\\${c}`) });
-  const exact = rows.find((r) => r.groupId === prefix);
-  if (exact !== void 0) return exact.groupId;
-  const first = rows[0];
-  if (rows.length === 1 && first !== void 0) return first.groupId;
-  if (rows.length === 0) return null;
-  throw new GroupIdAmbiguousError(
-    prefix,
-    rows.map((r) => r.groupId)
-  );
-}
-function machineId(db) {
-  const row = db.prepare("SELECT machine_id FROM machine_identity WHERE id = 1").get();
-  return row?.machine_id ?? "unknown";
+  return `herdr session attach ${target.session}`;
 }
-function rowFromDb(row) {
-  return {
-    seq: row.seq,
-    workstreamName: row.workstream === MACHINE_WIDE_KEY ? null : row.workstream,
-    source: row.source ?? "system",
-    intent: row.intent,
-    group: row.group_id,
-    op: row.op,
-    kind: row.kind,
-    payload: row.payload,
-    createdAt: row.created_at
-  };
+function attachCommands2(target) {
+  return [{ command: "herdr", args: ["session", "attach", target.session] }];
 }
-function appendLog(db, opts) {
-  const kind = opts.kind ?? "message";
-  const createdAt = (/* @__PURE__ */ new Date()).toISOString();
-  const key = opts.workstream ?? MACHINE_WIDE_KEY;
-  const group = randomUUID2();
-  const result = db.prepare(
-    `INSERT INTO ops (hlc, machine_id, group_id, actor, intent, entity, key, op, payload, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, 'put', ?, ?)`
-  ).run(
-    nextHlc(db),
-    machineId(db),
-    group,
-    opts.source,
-    opts.intent ?? null,
-    kind,
-    key,
-    opts.payload,
-    createdAt
-  );
+function paneNotFoundNextSteps2(paneId) {
+  return [
+    {
+      intent: `Verify the pane id ${paneId} actually exists`,
+      command: `herdr pane get ${paneId}`
+    },
+    {
+      intent: "List panes in the current workspace",
+      command: 'herdr pane list --workspace "$HERDR_WORKSPACE_ID"'
+    }
+  ];
+}
+async function healthCheck2() {
+  let version = null;
+  try {
+    const result = await currentExecutor2(["status"]);
+    if (result.exitCode === 0) {
+      const match = /^\s*version:\s*(\S+)\s*$/m.exec(result.stdout);
+      version = match?.[1] ?? null;
+    }
+  } catch {
+    version = null;
+  }
   return {
-    seq: Number(result.lastInsertRowid),
-    workstreamName: opts.workstream,
-    source: opts.source,
-    intent: opts.intent ?? null,
-    group,
-    op: "put",
-    kind,
-    payload: opts.payload,
-    createdAt
+    name: "herdr",
+    ok: version !== null,
+    version,
+    env: [
+      { name: "$HERDR_ENV", value: process.env.HERDR_ENV ?? null },
+      { name: "$HERDR_WORKSPACE_ID", value: process.env.HERDR_WORKSPACE_ID ?? null },
+      { name: "$HERDR_PANE_ID", value: process.env.HERDR_PANE_ID ?? null }
+    ],
+    remediation: "start the herdr server (herdr status) or install herdr"
   };
 }
-function listLogs(db, opts = {}) {
-  const conditions = [];
-  const params = [];
-  if (opts.workstream === null) {
-    conditions.push("l.key = ?");
-    params.push(MACHINE_WIDE_KEY);
-  } else if (opts.workstream !== void 0) {
-    conditions.push(workstreamScopeSql());
-    params.push(...workstreamScopeParams(opts.workstream));
-  }
-  if (opts.since !== void 0) {
-    conditions.push("l.seq > ?");
-    params.push(opts.since);
-  }
-  if (opts.source !== void 0) {
-    conditions.push("l.actor = ?");
-    params.push(opts.source);
-  }
-  if (opts.kind !== void 0) {
-    conditions.push("l.entity = ?");
-    params.push(opts.kind);
-  }
-  if (opts.intent !== void 0) {
-    const spellings = intentSpellings(opts.intent);
-    conditions.push(`l.intent IN (${spellings.map(() => "?").join(", ")})`);
-    params.push(...spellings);
-  }
-  if (opts.group !== void 0) {
-    conditions.push("l.group_id = ?");
-    params.push(opts.group);
+var herdrBackend = Object.freeze({
+  name: "herdr",
+  available: herdrAvailable,
+  isValidPaneId: isValidPaneId2,
+  assertValidPaneId: assertValidPaneId2,
+  listSessions: listSessions2,
+  sessionExists: sessionExists2,
+  newSession: newSession2,
+  newSessionWithPane: newSessionWithPane2,
+  killSession: killSession2,
+  listWindows: listWindows2,
+  newWindow: newWindow2,
+  selectLayout: selectLayout2,
+  listPanes: listPanes2,
+  listPanesInSession: listPanesInSession2,
+  splitWindow: splitWindow2,
+  killPane: killPane2,
+  paneExists: paneExists2,
+  paneTTY: paneTTY2,
+  setPaneTitle: setPaneTitle2,
+  getPaneTitle: getPaneTitle2,
+  currentAgentName: currentAgentName2,
+  currentSessionName: currentSessionName2,
+  startAgentInPane,
+  sendToPane: sendToPane2,
+  capturePane: capturePane2,
+  paneStatus,
+  enableMuPaneBordersForSession: enableMuPaneBordersForSession2,
+  enableMuPaneBordersForPane: enableMuPaneBordersForPane2,
+  attachHint: attachHint2,
+  attachCommands: attachCommands2,
+  paneNotFoundNextSteps: paneNotFoundNextSteps2,
+  healthCheck: healthCheck2
+});
+
+// src/mux/detect.ts
+var BACKENDS = [tmuxBackend, herdrBackend];
+function muxByName(name) {
+  for (const backend of BACKENDS) {
+    if (backend.name === name) return backend;
   }
-  conditions.push(TOUCH_OP_FILTER);
-  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-  if (opts.limit !== void 0 && opts.since === void 0) {
-    const rowsDesc = db.prepare(`SELECT ${SELECT_LOG_COLS} ${LOG_FROM_JOIN} ${where} ORDER BY l.seq DESC LIMIT ?`).all(...params, opts.limit);
-    return rowsDesc.reverse().map(rowFromDb);
+  throw new Error(`unknown mux backend: ${name}`);
+}
+var KNOWN_NAMES = BACKENDS.map((b) => b.name);
+async function detectMux() {
+  const override = process.env.MU_MUX;
+  if (override !== void 0 && override.length > 0) {
+    return muxByName(override);
   }
-  let sql = `SELECT ${SELECT_LOG_COLS} ${LOG_FROM_JOIN} ${where} ORDER BY l.seq ASC`;
-  if (opts.limit !== void 0) {
-    sql += " LIMIT ?";
-    params.push(opts.limit);
+  if (process.env.HERDR_ENV === "1") return herdrBackend;
+  if (process.env.TMUX || process.env.TMUX_PANE) return tmuxBackend;
+  for (const backend of BACKENDS) {
+    if (await backend.available()) return backend;
   }
-  const rows = db.prepare(sql).all(...params);
-  return rows.map(rowFromDb);
-}
-function latestSeq(db, workstream) {
-  const row = workstream === void 0 ? db.prepare(`SELECT MAX(seq) AS s FROM ops l WHERE ${TOUCH_OP_FILTER}`).get() : db.prepare(
-    `SELECT MAX(seq) AS s FROM ops l WHERE ${workstreamScopeSql()} AND ${TOUCH_OP_FILTER}`
-  ).get(...workstreamScopeParams(workstream));
-  return row.s ?? 0;
+  throw new NoMultiplexerError(KNOWN_NAMES);
 }
-function emitEvent(db, workstream, intent, payload, source = "system") {
-  appendLog(db, { workstream, source, kind: entityForIntent(intent), payload, intent });
+var cached;
+async function activeMux() {
+  if (cached === void 0) cached = await detectMux();
+  return cached;
 }
-function entityForIntent(intent) {
-  const dot = intent.indexOf(".");
-  return dot === -1 ? intent : intent.slice(0, dot);
+function setMuxForTests(backend) {
+  const previous = cached;
+  cached = backend;
+  return previous;
 }
-function lastClaimOp(db, workstream, localId) {
-  const row = db.prepare(
-    `SELECT actor, created_at FROM ops
-        WHERE key = ? AND intent = 'task.claim'
-        ORDER BY seq DESC LIMIT 1`
-  ).get(`${workstream}/${localId}`);
-  return row ?? null;
+function resetMux() {
+  cached = void 0;
 }
-function lastClaimEventAt(db, workstream, localId) {
-  return lastClaimOp(db, workstream, localId)?.created_at ?? null;
+
+// src/agents/spawn.ts
+import { execFile as execFile2 } from "child_process";
+import { mkdirSync as mkdirSync2, rmSync as rmSync4 } from "fs";
+import { basename, dirname as dirname6 } from "path";
+import { setTimeout as delay } from "timers/promises";
+import { promisify as promisify2 } from "util";
+
+// src/agents.ts
+import { dirname as dirname5 } from "path";
+
+// src/glyphs.ts
+var AGENT_STATE_GLYPH = {
+  busy: "\uF04B",
+  // nf-fa-play
+  needs_input: "\uF186",
+  // nf-fa-moon_o
+  needs_permission: "\uF023",
+  // nf-fa-lock
+  unknown: "\uF059"
+  // nf-fa-question_circle
+};
+function agentStateGlyph(state) {
+  return AGENT_STATE_GLYPH[state] ?? GLYPH.unknown;
 }
+var GLYPH = {
+  /** Healthy, clean, passing, closed-successfully. */
+  ok: "\uF058",
+  // nf-fa-check_circle
+  /** Failed check. */
+  fail: "\uF057",
+  // nf-fa-times_circle
+  /** Needs attention but not broken (idle-but-assigned, stale warning). */
+  warn: "\uF071",
+  // nf-fa-warning
+  /** Workspace has uncommitted edits. */
+  dirty: "\uF005",
+  // nf-fa-star
+  /** Workspace is ≥ WORKSPACE_STALE_THRESHOLD commits behind main. */
+  stale: "\uF017",
+  // nf-fa-clock_o
+  /** Task is blocked by an incoming edge. */
+  blocked: "\uF0C1",
+  // nf-fa-link (chain)
+  /** Task is parked (OPEN/parked): open, but set aside on purpose. */
+  parked: "\uF04C",
+  // nf-fa-pause
+  /** Track whose roots merged (diamond dependency). */
+  merge: "\uF074",
+  // nf-fa-random
+  /** Agent owns more than one task (pane-title multi-count slot). */
+  multi: "\uF055",
+  // nf-fa-plus_circle
+  /** Filter toggle: enabled / disabled. */
+  on: "\uF111",
+  // nf-fa-circle
+  off: "\uF10C",
+  // nf-fa-circle_o
+  /** Status outside the known enum. */
+  unknown: "\uF059"
+  // nf-fa-question_circle
+};
 
 // src/op-context.ts
 import { randomUUID as randomUUID3 } from "crypto";
@@ -5332,12 +5332,32 @@ function recordReasonNote(db, localId, workstream, substate, why, author) {
   if (why === void 0 || why.trim() === "") return;
   const noteOpts = { workstream };
   if (author !== void 0 && author !== "") noteOpts.author = author;
-  insertNote(db, localId, `${substate.toUpperCase()}: ${why}`, noteOpts);
+  const text = substate === "rejected" || substate === "superseded" ? withTitles(db, why, workstream, localId) : why;
+  insertNote(db, localId, `${substate.toUpperCase()}: ${text}`, noteOpts);
+}
+var TASK_ID_TOKEN = /(?<![\w./-])[a-z][a-z0-9_-]{0,63}(?![\w-]|\.\w|:\d)/g;
+var TASK_ID_WITH_PAREN = new RegExp(`(?:${TASK_ID_TOKEN.source})(\\s*\\()?`, "g");
+function namedTaskIds(db, text, workstream, self) {
+  const ids = (text.match(TASK_ID_TOKEN) ?? []).filter((t) => t !== self);
+  return [...new Set(ids)].filter((t) => getTask(db, t, workstream) !== void 0);
+}
+function withTitles(db, why, workstream, self) {
+  const named = new Set(namedTaskIds(db, why, workstream, self));
+  if (named.size === 0) return why;
+  return why.replace(TASK_ID_WITH_PAREN, (match, paren) => {
+    const id = paren === void 0 ? match : match.slice(0, -paren.length);
+    if (!named.has(id)) return match;
+    const title = getTask(db, id, workstream)?.title ?? "";
+    return paren === void 0 ? `${id} (${title})` : `${id} (${title}; `;
+  });
 }
 function openTask(db, localId, opts) {
-  return withOpContext(db, { intent: "task.open", group: "new" }, () => {
+  return withOpContext(db, { intent: "task.open", actor: opts.author, group: "new" }, () => {
     const before = getTask(db, localId, opts.workstream);
-    const r = setTaskStatus(db, localId, "OPEN", opts);
+    const r = setTaskStatus(db, localId, "OPEN", {
+      workstream: opts.workstream,
+      ...opts.evidence !== void 0 ? { evidence: opts.evidence } : {}
+    });
     if (r.changed && before) recordEvidenceNote(db, localId, before.workstreamName, "OPEN", opts);
     return r;
   });
@@ -5368,7 +5388,7 @@ function parkTask(db, localId, opts) {
 function acceptTask(db, localId, opts) {
   return withOpContext(
     db,
-    { intent: "task.accept", group: "new" },
+    { intent: "task.accept", actor: opts.author, group: "new" },
     () => db.transaction(() => {
       const before = getTask(db, localId, opts.workstream);
       if (!before) throw new TaskNotFoundError(localId);
@@ -5390,7 +5410,7 @@ function acceptTask(db, localId, opts) {
 function unparkTask(db, localId, opts) {
   return withOpContext(
     db,
-    { intent: "task.unpark", group: "new" },
+    { intent: "task.unpark", actor: opts.author, group: "new" },
     () => db.transaction(() => {
       const before = getTask(db, localId, opts.workstream);
       if (!before) throw new TaskNotFoundError(localId);
@@ -5414,7 +5434,7 @@ function unparkTask(db, localId, opts) {
 function releaseTask(db, localId, opts) {
   return withOpContext(
     db,
-    { intent: "task.release", group: "new" },
+    { intent: "task.release", actor: opts.author, group: "new" },
     () => releaseTaskImpl(db, localId, opts)
   );
 }
@@ -5502,7 +5522,10 @@ async function claimTaskImpl(db, localId, opts) {
       }
       const after = getTask(db, localId, opts.workstream);
       if (!after) throw new Error(`claimTask: row missing after update: ${localId}`);
-      recordEvidenceNote(db, localId, opts.workstream, "CLAIM", opts);
+      recordEvidenceNote(db, localId, opts.workstream, "CLAIM", {
+        ...opts,
+        author: opts.author ?? agentName
+      });
       return {
         ownerName: agentName,
         actorName: agentName,
@@ -5562,7 +5585,10 @@ async function claimSelf(db, localId, opts) {
       }
       const after = getTask(db, localId, before.workstreamName);
       if (!after) throw new Error(`claimTask: row missing after update: ${localId}`);
-      recordEvidenceNote(db, localId, before.workstreamName, "CLAIM", opts);
+      recordEvidenceNote(db, localId, before.workstreamName, "CLAIM", {
+        ...opts,
+        author: opts.author ?? actor
+      });
       return {
         ownerName: null,
         actorName: actor,
@@ -5753,6 +5779,7 @@ async function abortAgent(db, name, opts) {
   const st = await ctlRequestFor(agent, sock, { op: "status" });
   if (!st.ok) throw new Error(`control socket refused status: ${st.error}`);
   const before = st.state ?? "idle";
+  const pending = st.pending ?? false;
   if (before !== "busy") {
     return {
       ...base,
@@ -5760,6 +5787,7 @@ async function abortAgent(db, name, opts) {
       after: before,
       settled: true,
       aborted: false,
+      pending,
       elapsedMs: Date.now() - started
     };
   }
@@ -5776,9 +5804,50 @@ async function abortAgent(db, name, opts) {
     after: w.state ?? "idle",
     settled: true,
     aborted: true,
+    pending,
     elapsedMs: Date.now() - started
   };
 }
+async function interruptAgent(db, name, text, opts) {
+  const r = await interruptAgentImpl(db, name, text, opts);
+  recordSend(db, { name, workstreamName: opts.workstream }, "interrupt", text.length, {
+    transport: "ctl",
+    wasBusy: r.wasBusy
+  });
+  return r;
+}
+async function interruptAgentImpl(db, name, text, opts) {
+  const agent = getAgent(db, name, opts.workstream);
+  if (!agent) throw new AgentNotFoundError(name, opts.workstream);
+  const sock = opts.socket ?? agentCtlSocket(db, agent);
+  if (!expectsCtl(agent, sock)) throw new AgentAbortNeedsCtlError(name, opts.workstream, agent.cli);
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_ABORT_TIMEOUT_MS;
+  let r;
+  try {
+    r = await ctlRequest(sock, { op: "interrupt", text, timeoutMs });
+  } catch (e) {
+    if (!(e instanceof CtlUnknownOpError)) throw await ctlFailure(agent, sock, e);
+    const ab = await abortAgent(db, name, { ...opts, socket: sock });
+    const sent = await ctlRequestFor(agent, sock, { op: "send", text });
+    if (!sent.ok) throw new Error(`control socket refused the send: ${sent.error}`);
+    return {
+      wasBusy: ab.aborted,
+      pending: ab.pending,
+      ...sent.runs !== void 0 ? { runs: sent.runs } : {},
+      fallback: true
+    };
+  }
+  if (!r.ok) {
+    if (r.error === "timeout") throw new AgentAbortTimeoutError(name, opts.workstream, timeoutMs);
+    throw new Error(`control socket refused the interrupt: ${r.error}`);
+  }
+  return {
+    wasBusy: r.wasBusy ?? false,
+    pending: r.pending ?? false,
+    ...r.runs !== void 0 ? { runs: r.runs } : {},
+    fallback: false
+  };
+}
 
 // src/agents/adopt.ts
 var ADOPT_CTL_PROBE_MS = 1e3;
@@ -6171,10 +6240,23 @@ function isValidAgentName(name) {
 async function sendToAgent(db, name, text, opts) {
   const agent = getAgent(db, name, opts.workstream);
   if (!agent) throw new AgentNotFoundError(name);
-  return sendViaTransport(agent, text, {
+  const sent = await sendViaTransport(agent, text, {
     ...opts,
     socket: opts.socket ?? agentCtlSocket(db, agent)
   });
+  recordSend(
+    db,
+    agent,
+    opts.fresh ? "fresh" : opts.mode === "steer" ? "steer" : "plain",
+    text.length,
+    {
+      transport: sent.transport,
+      command: sent.command,
+      state: sent.state,
+      since: sent.since
+    }
+  );
+  return sent;
 }
 async function readAgent(db, name, opts) {
   const agent = getAgent(db, name, opts.workstream);
@@ -7247,16 +7329,28 @@ async function ctlRequestFor(agent, sock, req) {
   try {
     return await ctlRequest(sock, req);
   } catch (e) {
-    if (e instanceof CtlVersionError) throw e;
-    if (e instanceof CtlUnknownOpError) throw await extensionOutdated(agent, sock, e);
-    throw new AgentCtlUnreachableError(
-      agent.name,
-      agent.workstreamName,
-      sock,
-      errCode(e) === "ENOENT" ? "missing" : "refused"
-    );
+    throw await ctlFailure(agent, sock, e);
   }
 }
+async function ctlFailure(agent, sock, e) {
+  if (e instanceof CtlVersionError) return e;
+  if (e instanceof CtlUnknownOpError) return extensionOutdated(agent, sock, e);
+  return new AgentCtlUnreachableError(
+    agent.name,
+    agent.workstreamName,
+    sock,
+    errCode(e) === "ENOENT" ? "missing" : "refused"
+  );
+}
+function recordSend(db, agent, mode, bytes, fields2) {
+  const detail = Object.entries({ mode, ...fields2 }).filter(([, v]) => v !== void 0).map(([k, v]) => `${k}=${k === "since" ? new Date(Number(v)).toISOString() : v}`).join(" ");
+  emitEvent(
+    db,
+    agent.workstreamName,
+    "agent.send",
+    `agent send ${agent.name} (${detail}, ${bytes} bytes)`
+  );
+}
 async function sendViaTransport(agent, text, opts) {
   const sock = opts.socket;
   if (opts.fresh && (opts.via === "mux" || !expectsCtl(agent, sock))) {
@@ -7293,7 +7387,8 @@ async function sendViaTransport(agent, text, opts) {
   return {
     transport,
     ...reply.state !== void 0 ? { state: reply.state } : {},
-    ...reply.runs !== void 0 ? { runs: reply.runs } : {}
+    ...reply.runs !== void 0 ? { runs: reply.runs } : {},
+    ...reply.since !== void 0 ? { since: reply.since } : {}
   };
 }
 async function runSessionCommand(agent, sock, cmd, force) {
@@ -9365,6 +9460,7 @@ var VERBS = {
   "agent.close": "agent close",
   "agent.adopt": "agent adopt",
   "agent.kick": "agent kick",
+  "agent.send": "agent send",
   // Payload prose reads "agent stalled ..."; keep the verb matching it
   // so the emitted text is not printed with a second, different verb.
   "agent.stall": "agent stalled",
@@ -9487,6 +9583,7 @@ function renderKnown(row, intent) {
     case "agent.close":
     case "agent.adopt":
     case "agent.kick":
+    case "agent.send":
     case "agent.stall":
     case "workspace.create":
     case "workspace.free":
@@ -11240,6 +11337,7 @@ export {
   insertAgent,
   inspectLinks,
   installCapture,
+  interruptAgent,
   isKickSignal,
   isPathInside,
   isTaskStatus,