local-commander-agent 0.3.52 → 0.3.53

package/bin/monitor-agents.mjs

@@ -1,162 +1,162 @@
-import { execFile } from "node:child_process";
-import { createHash } from "node:crypto";
-import { lstat, open } from "node:fs/promises";
-import { lstatSync, readFileSync } from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { promisify } from "node:util";
-import { agentName, contextSummary } from "./monitor-context.mjs";
-
-const execute = promisify(execFile);
-const uuid = value => typeof value === "string" && /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/i.test(value);
-const text = (value, max = 160) => typeof value === "string" && value.length <= max && !/[\u0000-\u001f\u007f-\u009f]/u.test(value.replace(/\n/g, " "));
-const model = value => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9._:/+-]{0,127}$/.test(value);
-const time = value => typeof value === "string" && /^\d{4}-\d\d-\d\dT[\d:.]+Z$/.test(value) && Number.isFinite(Date.parse(value));
-const pid = value => Number.isInteger(value) && value > 0 && value <= 0xffffffff;
-const invalid = () => { throw Error("AGENT_OBSERVATION_INVALID"); };
-const shortId = id => /^rt-/.test(id) && uuid(id.slice(3)) ? id.slice(3, 11) : uuid(id) ? id.slice(0, 8) :
-  createHash("sha256").update(id).digest("hex").slice(0, 8);
-
-// Read coordination facts only; never open identity/capability/enrollment files.
-export async function readState(file) {
-  for (const directory of [path.dirname(path.dirname(file)), path.dirname(file)]) {
-    const stat = await lstat(directory);
-    if (!stat.isDirectory() || stat.isSymbolicLink()) invalid();
-  }
-  const stat = await lstat(file);
-  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 1024 * 1024) invalid();
-  const handle = await open(file, "r");
-  try {
-    const buffer = Buffer.alloc(1024 * 1024 + 1);
-    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
-    if (bytesRead > 1024 * 1024) invalid();
-    return JSON.parse(buffer.subarray(0, bytesRead).toString("utf8"));
-  } finally { await handle.close(); }
-}
-
-export function presenceRows(raw, computer, now = Date.now()) {
-  if (raw?.version !== 1 || !Array.isArray(raw.runtimes) || raw.runtimes.length > 64 || (raw.messages !== undefined && (!Array.isArray(raw.messages) || raw.messages.length > 512))) invalid();
-  return raw.runtimes.flatMap(runtime => {
-    if (!/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/.test(runtime?.id ?? "") || !text(runtime.label, 80) || !text(runtime.node, 80) ||
-        !Number.isSafeInteger(runtime.lastSeenAt) || !Number.isInteger(runtime.leaseMs) || runtime.leaseMs < 1000 ||
-        runtime.leaseMs > 30 * 60_000 || typeof runtime.stopped !== "boolean" ||
-        !(runtime.activity === null || text(runtime.activity)) || runtime.lastSeenAt > now + 5000) invalid();
-    const age = now - runtime.lastSeenAt;
-    if (runtime.stopped || age > runtime.leaseMs * 3) return [];
-    return [{ id: runtime.id, displayId: shortId(runtime.id), kind: "agent", computer: runtime.node === "this machine" ? computer : runtime.node.replace(/\n/g, " "),
-      pid: null, name: /^[A-Za-z][A-Za-z0-9]{0,7}$/.test(runtime.name ?? "") ? runtime.name : agentName(runtime.id),
-      label: runtime.label.replace(/\n/g, " "), activity: (runtime.activity ?? "presence reported; no activity supplied").replace(/\n/g, " "),
-      context: contextSummary({ project: runtime.project, taskId: runtime.taskId }), phase: ["working", "analysis", "message", "idle"].includes(runtime.phase) ? runtime.phase : "working",
-      unread: Array.isArray(raw.messages) ? raw.messages.filter(message => message.to === runtime.id && message.expiresAt > now && Array.isArray(message.ackedBy) && !message.ackedBy.includes(runtime.id)).length : 0,
-      state: age <= runtime.leaseMs ? "REPORTING" : "STALE", model: model(runtime.model) ? runtime.model : null,
-      modelSource: model(runtime.model) ? "reported" : null, executionIds: [], startedAt: null }];
-  });
-}
-
-export function mailboxRows(raw, computer) {
-  if (raw?.version !== 2 || !Array.isArray(raw.workers) || raw.workers.length > 64 ||
-      !Array.isArray(raw.assignments) || raw.assignments.length > 256) invalid();
-  const facts = attribution => {
-    const fact = attribution?.model;
-    if (fact === null || fact === undefined) return null;
-    if (!model(fact.value) || !time(fact.confirmedAt) || !text(fact.evidenceRef, 96) ||
-        !["registered_integration", "adapter_receipt"].includes(fact.source)) invalid();
-    return fact.value;
-  };
-  const assignments = new Map();
-  const workerIds = new Set(raw.workers.map(worker => worker?.workerId));
-  const executionIds = raw.assignments.flatMap(assignment => assignment?.execution?.executionId ? [assignment.execution.executionId] : []);
-  if (workerIds.size !== raw.workers.length || new Set(executionIds).size !== executionIds.length) invalid();
-  for (const assignment of raw.assignments) {
-    if (!uuid(assignment?.workerId) || !workerIds.has(assignment.workerId) || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/.test(assignment.taskId ?? "") || !time(assignment.updatedAt) ||
-        !["assigned", "launching", "running", "unknown", "exited", "not_started"].includes(assignment.phase) ||
-        !["chatgpt", "claude", "cursor"].includes(assignment.selectedRuntime)) invalid();
-    if (assignment.execution && (!(assignment.execution.pid === null || pid(assignment.execution.pid)) ||
-        !(assignment.execution.executionId === null || uuid(assignment.execution.executionId)) || !time(assignment.execution.confirmedAt))) invalid();
-    facts(assignment.attribution);
-    const previous = assignments.get(assignment.workerId);
-    if (!previous || Date.parse(previous.updatedAt) <= Date.parse(assignment.updatedAt)) assignments.set(assignment.workerId, assignment);
-  }
-  return raw.workers.map(worker => {
-    if (!uuid(worker?.workerId) || !(worker.runtimeId === null || /^rt-[a-f0-9-]{36}$/i.test(worker.runtimeId))) invalid();
-    const assignment = assignments.get(worker.workerId);
-    const active = assignment && !["exited", "not_started"].includes(assignment.phase);
-    const attributedModel = facts(assignment?.attribution) ?? facts(worker.attribution);
-    return { id: worker.runtimeId ?? worker.workerId, displayId: shortId(worker.runtimeId ?? worker.workerId), kind: "agent", computer,
-      pid: active ? assignment.execution?.pid ?? null : null, name: agentName(worker.runtimeId ?? worker.workerId),
-      context: contextSummary({ taskId: assignment?.taskId }), phase: "working",
-      activity: active ? "task " + assignment.taskId : "registered; no active assignment",
-      state: !active ? "REGISTERED" : assignment.phase === "unknown" ? "UNKNOWN" : assignment.phase.toUpperCase(),
-      model: attributedModel, modelSource: attributedModel ? "confirmed" : null,
-      executionIds: raw.assignments.filter(item => item.workerId === worker.workerId && item.execution?.executionId).map(item => item.execution.executionId),
-      confirmedAt: active ? assignment.execution?.confirmedAt ?? null : null, startedAt: null };
-  });
-}
-
-export function hostRows(raw, computer, previous = new Map()) {
-  if (!Array.isArray(raw) || raw.length > 64) invalid();
-  const seen = new Set();
-  const rows = raw.map(host => {
-    if (!host || !["codex", "claude", "cursor-agent"].includes(host.name) || !pid(host.pid) ||
-        !time(host.startedAt) || !Number.isFinite(host.cpuMs) || host.cpuMs < 0) invalid();
-    const id = createHash("sha256").update(JSON.stringify([computer, host.name, host.pid, host.startedAt])).digest("hex");
-    if (seen.has(id)) invalid();
-    seen.add(id);
-    const before = previous.get(id);
-    previous.set(id, host.cpuMs);
-    const cpu = before !== undefined && host.cpuMs > before ? Math.round(host.cpuMs - before) : 0;
-    return { id, displayId: id.slice(0, 8), kind: "host", computer, pid: host.pid, name: agentName(id),
-      activity: host.name + " host" + (cpu ? " | CPU +" + cpu + "ms" : " | waiting or external work"),
-      state: "OBSERVED", model: null, modelSource: null, executionIds: [], startedAt: host.startedAt };
-  });
-  for (const id of previous.keys()) if (!seen.has(id)) previous.delete(id);
-  return rows;
-}
-
-// ponytail: observe at most 64 named hosts; add host paging if the local fleet exceeds this ceiling.
-const census = `$ErrorActionPreference = 'Stop'
-$rows = @(Get-Process -Name codex,claude,cursor-agent -ErrorAction SilentlyContinue | Sort-Object Id | Select-Object -First 64 | ForEach-Object {
-  try { @{ name = $_.ProcessName.ToLowerInvariant(); pid = $_.Id; startedAt = $_.StartTime.ToUniversalTime().ToString('o'); cpuMs = $_.TotalProcessorTime.TotalMilliseconds } } catch {}
-})
-ConvertTo-Json -InputObject $rows -Compress`;
-
-export function presenceDirectory(projectRoot = process.cwd()) {
-  let state = process.env.LCMCP_OAUTH_STATE_PATH;
-  if (!state) try {
-    const file = path.resolve(projectRoot, process.env.LCMCP_CONFIG?.trim() || "local-commander.config.json");
-    const stat = lstatSync(file);
-    if (stat.isFile() && !stat.isSymbolicLink() && stat.size <= 65536)
-      state = JSON.parse(readFileSync(file, "utf8").replace(/^\uFEFF/, "")).auth?.oauthStatePath;
-  } catch { /* Missing/unreadable local configuration leaves observations unavailable. */ }
-  return typeof state === "string" && state.trim() ? path.join(path.dirname(path.resolve(projectRoot, state)), ".local-commander") : path.join(projectRoot, ".local-commander");
-}
-
-export async function readAgentActivity(directory, { previousHosts = new Map(), signal, projectRoot = process.cwd() } = {}) {
-  const computer = os.hostname().replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 64) || "PC";
-  const rows = [], unavailable = [];
-  const stateDirectory = process.env.LC_AGENT_STATE_DIR ?? path.join(path.dirname(directory), "Agent");
-  const inputs = [
-    ["presence", path.join(presenceDirectory(projectRoot), "agents.json"), presenceRows],
-    ["workers", path.join(stateDirectory, ".local-commander", "fabric", "mailbox.json"), mailboxRows]
-  ];
-  if (!path.isAbsolute(stateDirectory) || /[\u0000-\u001f]/u.test(stateDirectory)) return { rows, unavailable: ["state_directory"] };
-  await Promise.all(inputs.map(async ([source, file, project]) => {
-    try { rows.push(...project(await readState(file), computer)); }
-    catch (error) { if (error.code !== "ENOENT") unavailable.push(source); }
-  }));
-  if (process.platform === "win32") {
-    try {
-      const systemRoot = process.env.SystemRoot ?? "C:\\Windows";
-      const { stdout } = await execute(path.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe"),
-        ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(census, "utf16le").toString("base64")],
-        { windowsHide: true, shell: false, timeout: 4000, maxBuffer: 128 * 1024, signal, env: { SystemRoot: systemRoot, WINDIR: systemRoot } });
-      rows.push(...hostRows(JSON.parse(stdout), computer, previousHosts));
-    } catch { unavailable.push("hosts"); }
-  } else unavailable.push("hosts_unsupported");
-  // Coalesce only a confirmed assignment/PID that predates the current host instance.
-  const agents = rows.filter(row => row.kind === "agent");
-  const merged = rows.filter(host => host.kind !== "host" || !agents.some(agent => agent.pid === host.pid && agent.confirmedAt &&
-    Date.parse(host.startedAt) <= Date.parse(agent.confirmedAt)));
-  return { rows: merged.sort((a, b) => a.computer.localeCompare(b.computer) || a.kind.localeCompare(b.kind) || a.id.localeCompare(b.id)),
-    unavailable: unavailable.sort() };
-}
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { lstat, open } from "node:fs/promises";
+import { lstatSync, readFileSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { promisify } from "node:util";
+import { agentName, contextSummary } from "./monitor-context.mjs";
+
+const execute = promisify(execFile);
+const uuid = value => typeof value === "string" && /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/i.test(value);
+const text = (value, max = 160) => typeof value === "string" && value.length <= max && !/[\u0000-\u001f\u007f-\u009f]/u.test(value.replace(/\n/g, " "));
+const model = value => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9._:/+-]{0,127}$/.test(value);
+const time = value => typeof value === "string" && /^\d{4}-\d\d-\d\dT[\d:.]+Z$/.test(value) && Number.isFinite(Date.parse(value));
+const pid = value => Number.isInteger(value) && value > 0 && value <= 0xffffffff;
+const invalid = () => { throw Error("AGENT_OBSERVATION_INVALID"); };
+const shortId = id => /^rt-/.test(id) && uuid(id.slice(3)) ? id.slice(3, 11) : uuid(id) ? id.slice(0, 8) :
+  createHash("sha256").update(id).digest("hex").slice(0, 8);
+
+// Read coordination facts only; never open identity/capability/enrollment files.
+export async function readState(file) {
+  for (const directory of [path.dirname(path.dirname(file)), path.dirname(file)]) {
+    const stat = await lstat(directory);
+    if (!stat.isDirectory() || stat.isSymbolicLink()) invalid();
+  }
+  const stat = await lstat(file);
+  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 1024 * 1024) invalid();
+  const handle = await open(file, "r");
+  try {
+    const buffer = Buffer.alloc(1024 * 1024 + 1);
+    const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+    if (bytesRead > 1024 * 1024) invalid();
+    return JSON.parse(buffer.subarray(0, bytesRead).toString("utf8"));
+  } finally { await handle.close(); }
+}
+
+export function presenceRows(raw, computer, now = Date.now()) {
+  if (raw?.version !== 1 || !Array.isArray(raw.runtimes) || raw.runtimes.length > 64 || (raw.messages !== undefined && (!Array.isArray(raw.messages) || raw.messages.length > 512))) invalid();
+  return raw.runtimes.flatMap(runtime => {
+    if (!/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/.test(runtime?.id ?? "") || !text(runtime.label, 80) || !text(runtime.node, 80) ||
+        !Number.isSafeInteger(runtime.lastSeenAt) || !Number.isInteger(runtime.leaseMs) || runtime.leaseMs < 1000 ||
+        runtime.leaseMs > 30 * 60_000 || typeof runtime.stopped !== "boolean" ||
+        !(runtime.activity === null || text(runtime.activity)) || runtime.lastSeenAt > now + 5000) invalid();
+    const age = now - runtime.lastSeenAt;
+    if (runtime.stopped || age > runtime.leaseMs * 3) return [];
+    return [{ id: runtime.id, displayId: shortId(runtime.id), kind: "agent", computer: runtime.node === "this machine" ? computer : runtime.node.replace(/\n/g, " "),
+      pid: null, name: /^[A-Za-z][A-Za-z0-9]{0,7}$/.test(runtime.name ?? "") ? runtime.name : agentName(runtime.id),
+      label: runtime.label.replace(/\n/g, " "), activity: (runtime.activity ?? "presence reported; no activity supplied").replace(/\n/g, " "),
+      context: contextSummary({ project: runtime.project, taskId: runtime.taskId }), phase: ["working", "analysis", "message", "idle"].includes(runtime.phase) ? runtime.phase : "working",
+      unread: Array.isArray(raw.messages) ? raw.messages.filter(message => message.to === runtime.id && message.expiresAt > now && Array.isArray(message.ackedBy) && !message.ackedBy.includes(runtime.id)).length : 0,
+      state: age <= runtime.leaseMs ? "REPORTING" : "STALE", model: model(runtime.model) ? runtime.model : null,
+      modelSource: model(runtime.model) ? "reported" : null, executionIds: [], startedAt: null }];
+  });
+}
+
+export function mailboxRows(raw, computer) {
+  if (raw?.version !== 2 || !Array.isArray(raw.workers) || raw.workers.length > 64 ||
+      !Array.isArray(raw.assignments) || raw.assignments.length > 256) invalid();
+  const facts = attribution => {
+    const fact = attribution?.model;
+    if (fact === null || fact === undefined) return null;
+    if (!model(fact.value) || !time(fact.confirmedAt) || !text(fact.evidenceRef, 96) ||
+        !["registered_integration", "adapter_receipt"].includes(fact.source)) invalid();
+    return fact.value;
+  };
+  const assignments = new Map();
+  const workerIds = new Set(raw.workers.map(worker => worker?.workerId));
+  const executionIds = raw.assignments.flatMap(assignment => assignment?.execution?.executionId ? [assignment.execution.executionId] : []);
+  if (workerIds.size !== raw.workers.length || new Set(executionIds).size !== executionIds.length) invalid();
+  for (const assignment of raw.assignments) {
+    if (!uuid(assignment?.workerId) || !workerIds.has(assignment.workerId) || !/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/.test(assignment.taskId ?? "") || !time(assignment.updatedAt) ||
+        !["assigned", "launching", "running", "unknown", "exited", "not_started"].includes(assignment.phase) ||
+        !["chatgpt", "claude", "cursor"].includes(assignment.selectedRuntime)) invalid();
+    if (assignment.execution && (!(assignment.execution.pid === null || pid(assignment.execution.pid)) ||
+        !(assignment.execution.executionId === null || uuid(assignment.execution.executionId)) || !time(assignment.execution.confirmedAt))) invalid();
+    facts(assignment.attribution);
+    const previous = assignments.get(assignment.workerId);
+    if (!previous || Date.parse(previous.updatedAt) <= Date.parse(assignment.updatedAt)) assignments.set(assignment.workerId, assignment);
+  }
+  return raw.workers.map(worker => {
+    if (!uuid(worker?.workerId) || !(worker.runtimeId === null || /^rt-[a-f0-9-]{36}$/i.test(worker.runtimeId))) invalid();
+    const assignment = assignments.get(worker.workerId);
+    const active = assignment && !["exited", "not_started"].includes(assignment.phase);
+    const attributedModel = facts(assignment?.attribution) ?? facts(worker.attribution);
+    return { id: worker.runtimeId ?? worker.workerId, displayId: shortId(worker.runtimeId ?? worker.workerId), kind: "agent", computer,
+      pid: active ? assignment.execution?.pid ?? null : null, name: agentName(worker.runtimeId ?? worker.workerId),
+      context: contextSummary({ taskId: assignment?.taskId }), phase: "working",
+      activity: active ? "task " + assignment.taskId : "registered; no active assignment",
+      state: !active ? "REGISTERED" : assignment.phase === "unknown" ? "UNKNOWN" : assignment.phase.toUpperCase(),
+      model: attributedModel, modelSource: attributedModel ? "confirmed" : null,
+      executionIds: raw.assignments.filter(item => item.workerId === worker.workerId && item.execution?.executionId).map(item => item.execution.executionId),
+      confirmedAt: active ? assignment.execution?.confirmedAt ?? null : null, startedAt: null };
+  });
+}
+
+export function hostRows(raw, computer, previous = new Map()) {
+  if (!Array.isArray(raw) || raw.length > 64) invalid();
+  const seen = new Set();
+  const rows = raw.map(host => {
+    if (!host || !["codex", "claude", "cursor-agent"].includes(host.name) || !pid(host.pid) ||
+        !time(host.startedAt) || !Number.isFinite(host.cpuMs) || host.cpuMs < 0) invalid();
+    const id = createHash("sha256").update(JSON.stringify([computer, host.name, host.pid, host.startedAt])).digest("hex");
+    if (seen.has(id)) invalid();
+    seen.add(id);
+    const before = previous.get(id);
+    previous.set(id, host.cpuMs);
+    const cpu = before !== undefined && host.cpuMs > before ? Math.round(host.cpuMs - before) : 0;
+    return { id, displayId: id.slice(0, 8), kind: "host", computer, pid: host.pid, name: agentName(id),
+      activity: host.name + " host" + (cpu ? " | CPU +" + cpu + "ms" : " | waiting or external work"),
+      state: "OBSERVED", model: null, modelSource: null, executionIds: [], startedAt: host.startedAt };
+  });
+  for (const id of previous.keys()) if (!seen.has(id)) previous.delete(id);
+  return rows;
+}
+
+// ponytail: observe at most 64 named hosts; add host paging if the local fleet exceeds this ceiling.
+const census = `$ErrorActionPreference = 'Stop'
+$rows = @(Get-Process -Name codex,claude,cursor-agent -ErrorAction SilentlyContinue | Sort-Object Id | Select-Object -First 64 | ForEach-Object {
+  try { @{ name = $_.ProcessName.ToLowerInvariant(); pid = $_.Id; startedAt = $_.StartTime.ToUniversalTime().ToString('o'); cpuMs = $_.TotalProcessorTime.TotalMilliseconds } } catch {}
+})
+ConvertTo-Json -InputObject $rows -Compress`;
+
+export function presenceDirectory(projectRoot = process.cwd()) {
+  let state = process.env.LCMCP_OAUTH_STATE_PATH;
+  if (!state) try {
+    const file = path.resolve(projectRoot, process.env.LCMCP_CONFIG?.trim() || "local-commander.config.json");
+    const stat = lstatSync(file);
+    if (stat.isFile() && !stat.isSymbolicLink() && stat.size <= 65536)
+      state = JSON.parse(readFileSync(file, "utf8").replace(/^\uFEFF/, "")).auth?.oauthStatePath;
+  } catch { /* Missing/unreadable local configuration leaves observations unavailable. */ }
+  return typeof state === "string" && state.trim() ? path.join(path.dirname(path.resolve(projectRoot, state)), ".local-commander") : path.join(projectRoot, ".local-commander");
+}
+
+export async function readAgentActivity(directory, { previousHosts = new Map(), signal, projectRoot = process.cwd() } = {}) {
+  const computer = os.hostname().replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 64) || "PC";
+  const rows = [], unavailable = [];
+  const stateDirectory = process.env.LC_AGENT_STATE_DIR ?? path.join(path.dirname(directory), "Agent");
+  const inputs = [
+    ["presence", path.join(presenceDirectory(projectRoot), "agents.json"), presenceRows],
+    ["workers", path.join(stateDirectory, ".local-commander", "fabric", "mailbox.json"), mailboxRows]
+  ];
+  if (!path.isAbsolute(stateDirectory) || /[\u0000-\u001f]/u.test(stateDirectory)) return { rows, unavailable: ["state_directory"] };
+  await Promise.all(inputs.map(async ([source, file, project]) => {
+    try { rows.push(...project(await readState(file), computer)); }
+    catch (error) { if (error.code !== "ENOENT") unavailable.push(source); }
+  }));
+  if (process.platform === "win32") {
+    try {
+      const systemRoot = process.env.SystemRoot ?? "C:\\Windows";
+      const { stdout } = await execute(path.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe"),
+        ["-NoLogo", "-NoProfile", "-NonInteractive", "-EncodedCommand", Buffer.from(census, "utf16le").toString("base64")],
+        { windowsHide: true, shell: false, timeout: 4000, maxBuffer: 128 * 1024, signal, env: { SystemRoot: systemRoot, WINDIR: systemRoot } });
+      rows.push(...hostRows(JSON.parse(stdout), computer, previousHosts));
+    } catch { unavailable.push("hosts"); }
+  } else unavailable.push("hosts_unsupported");
+  // Coalesce only a confirmed assignment/PID that predates the current host instance.
+  const agents = rows.filter(row => row.kind === "agent");
+  const merged = rows.filter(host => host.kind !== "host" || !agents.some(agent => agent.pid === host.pid && agent.confirmedAt &&
+    Date.parse(host.startedAt) <= Date.parse(agent.confirmedAt)));
+  return { rows: merged.sort((a, b) => a.computer.localeCompare(b.computer) || a.kind.localeCompare(b.kind) || a.id.localeCompare(b.id)),
+    unavailable: unavailable.sort() };
+}

package/bin/monitor-context.d.mts

@@ -1,7 +1,7 @@
-export const AGENT_NAMES: readonly string[];
-export function agentName(id: string): string;
-export interface MonitorContext { project: string | null; directory: string | null; taskId: string | null; pr: number | null; inferred: boolean }
-export function contextSummary(meta?: Record<string, unknown>): MonitorContext;
-export function commandSummary(tool: string, meta?: Record<string, unknown>): string;
-
-export function commandPreview(tool: string, meta?: Record<string, unknown>): string;
+export const AGENT_NAMES: readonly string[];
+export function agentName(id: string): string;
+export interface MonitorContext { project: string | null; directory: string | null; taskId: string | null; pr: number | null; inferred: boolean }
+export function contextSummary(meta?: Record<string, unknown>): MonitorContext;
+export function commandSummary(tool: string, meta?: Record<string, unknown>): string;
+
+export function commandPreview(tool: string, meta?: Record<string, unknown>): string;

package/bin/monitor-context.mjs

@@ -1,65 +1,65 @@
-import { createHash } from "node:crypto";
-
-// Transliteration keeps terminal widths predictable. Random runtime IDs select the pool without a model or handshake.
-export const AGENT_NAMES = Object.freeze([
-  "Avi", "Noam", "Yael", "Leah", "Ezra", "Eli", "Tamar", "Dalia", "Ruth", "Maya", "Oren", "Shira", "Eitan", "Lior", "Hila", "Amir",
-  "Ivan", "Yuri", "Olga", "Anna", "Boris", "Nina", "Pavel", "Irina", "Vera", "Daria", "Misha", "Sasha", "Vadim", "Roman", "Anya", "Lev",
-  "Omar", "Layla", "Ali", "Nadia", "Salim", "Hana", "Rami", "Zain", "Noor", "Amal", "Samir", "Farah", "Malik", "Yasmin", "Adil", "Hadi",
-  "Arjun", "Priya", "Ravi", "Anika", "Asha", "Dev", "Kiran", "Meera", "Nisha", "Rohan", "Diya", "Neha", "Anil", "Sana", "Vijay", "Isha",
-  "Wei", "Lin", "Mei", "Chen", "Li", "Jian", "Ming", "Hua", "Yan", "Tao", "Jun", "Lan", "Yue", "Lei", "Hong", "Qian",
-  "Pickle", "Waffle", "Noodle", "Spud", "Mochi", "Taco", "Doodle", "Widget", "Boop", "Bytey", "Glitch", "Sprock", "Wombat", "Goose", "Ninja", "Otter", "Quokka", "Squid", "Sushi", "Pogo", "Zippy", "Nifty", "Fuzzy", "Gizmo", "Bloop", "Blip", "Niblet", "Pixel", "Bugsy", "Wobble", "Muppet", "Puddle", "Cookie", "Muffin", "Bagel", "Nacho", "Tater", "Churro", "Snappy", "Peppy", "Plonk", "Slinky", "Tofu", "Nugget", "Dumplo", "Popper", "Kebab", "Sizzle"
-]);
-export function agentName(id) {
-  const hash = createHash("sha256").update(id).digest();
-  return AGENT_NAMES[hash.readUInt16BE(0) % AGENT_NAMES.length] + hash.subarray(2, 3).toString("hex");
-}
-const identifier = value => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/.test(value);
-export function contextSummary(meta = {}) {
-  const source = typeof (meta.cwd ?? meta.path ?? meta.project) === "string" ? (meta.cwd ?? meta.path ?? meta.project) : "";
-  const normalized = source.replaceAll("\\", "/").replace(/\/+$/, "");
-  const safe = normalized.length <= 1024 && /^[A-Za-z0-9 _./:@()+-]*$/.test(normalized) &&
-    !/(?:^|\/)(?:\.env(?:\.[^/]*)?|credentials[^/]*|\.npmrc|agent-identities\.json)(?:\/|$)/i.test(normalized);
-  const directory = safe && normalized ? normalized.slice(-96) : null;
-  const project = directory ? directory.split("/").at(-1) : null;
-  const taskMatch = safe && normalized.match(/\/planning\/tasks\/([A-Za-z0-9][A-Za-z0-9_.:-]{0,95})\.md$/);
-  const taskId = identifier(meta.taskId) ? meta.taskId : taskMatch ? taskMatch[1] : null;
-  const branchPr = safe && normalized.match(/(?:^|[/_-])pr[-_]?(\d{1,7})(?:[/_.-]|$)/i);
-  const explicitPr = Number.isSafeInteger(meta.pr) && meta.pr > 0 && meta.pr <= 9_999_999 ? meta.pr : null;
-  const args = Array.isArray(meta.args) ? meta.args : [];
-  const ghPr = meta.command === "gh" && args[0] === "pr" && ["view", "checkout", "diff", "checks", "merge"].includes(args[1]) && /^\d{1,7}$/.test(args[2] ?? "") ? Number(args[2]) : null;
-  return { project, directory, taskId, pr: explicitPr ?? ghPr ?? (branchPr ? Number(branchPr[1]) : null), inferred: !explicitPr && !identifier(meta.taskId) };
-}
-export function commandSummary(tool, meta = {}) {
-  if (tool === "agent_message" && ["send", "inbox", "ack"].includes(meta.action)) {
-    const kind = ["status", "question", "answer", "handoff", "result_summary", "blocker"].includes(meta.kind) ? " " + meta.kind : "";
-    const target = identifier(meta.to) ? " -> " + meta.to.slice(0, 8) : "";
-    return "agent_message " + meta.action + kind + target;
-  }
-  if (!["command_run", "process_start"].includes(tool)) return tool;
-  const candidate = typeof meta.command === "string" ? meta.command.replaceAll("\\", "/").split("/").at(-1).replace(/\.(exe|cmd|bat|com)$/i, "").toLowerCase() : "";
-  const name = ["node", "npm", "npx", "git", "rg", "powershell", "pwsh", "cmd", "tsc", "python", "dotnet", "gh"].includes(candidate) ? candidate : "command";
-  const args = Array.isArray(meta.args) ? meta.args : [];
-  if (name === "git" && ["status", "diff", "log", "show", "fetch", "pull", "push", "commit"].includes(args[0])) return name + " " + args[0];
-  if (name === "npm" && ["test", "install", "ci", "pack", "publish"].includes(args[0])) return name + " " + args[0];
-  if (name === "npm" && args[0] === "run" && ["test", "build", "typecheck", "lint", "dev", "start"].includes(args[1])) return "npm run " + args[1];
-  return name + (args.length ? " [args]" : "");
-}
-
-/** Diagnostic preview only. Never used to construct or execute a command. */
-export function commandPreview(tool, meta = {}) {
-  if (!["command_run", "process_start"].includes(tool)) return commandSummary(tool, meta);
-  const name = typeof meta.command === "string" && /^[A-Za-z0-9_.-]{1,40}$/.test(meta.command) ? meta.command : "command";
-  const args = Array.isArray(meta.args) ? meta.args.slice(0, 24) : [];
-  let hideNext = false, inline = false;
-  const safe = args.map(arg => {
-    if (inline || hideNext) { hideNext = false; return "[redacted]"; }
-    if (typeof arg !== "string") return "[value]";
-    if (/^(?:-e|--eval|-p|--print|-c|-command|--command|-encodedcommand|\/c|\/k)$/i.test(arg) &&
-        /^(?:node|python|bash|sh|powershell|pwsh|cmd)(?:\.[a-z]+)?$/i.test(name)) inline = true;
-    if (/^(?:[-/]+(?:.*(?:token|password|passwd|secret|credential|authorization|api[-_]?key)|auth|key|header|env|config|data|data-raw|data-binary|message|prompt)|-[uHpmd])$/i.test(arg)) hideNext = true;
-    if (/(?:token|password|passwd|secret|credential|authorization|api[-_]?key)\s*[=:]|(?:^|[/\\])(?:\.env(?:\.|$)|credentials|\.npmrc)|:\/\/|[\x00-\x1f\x7f]|[A-Za-z0-9+/_=-]{40,}/i.test(arg)) return "[redacted]";
-    // ponytail: printable simple argv only; embedded scripts and complex values stay private.
-    return arg.length <= 96 && /^[A-Za-z0-9 _./\\:@()+=-]+$/.test(arg) ? (arg.includes(" ") ? JSON.stringify(arg) : arg) : "[value]";
-  });
-  return [name, ...safe, ...(Array.isArray(meta.args) && meta.args.length > 24 ? ["…"] : [])].join(" ").slice(0, 240);
-}
+import { createHash } from "node:crypto";
+
+// Transliteration keeps terminal widths predictable. Random runtime IDs select the pool without a model or handshake.
+export const AGENT_NAMES = Object.freeze([
+  "Avi", "Noam", "Yael", "Leah", "Ezra", "Eli", "Tamar", "Dalia", "Ruth", "Maya", "Oren", "Shira", "Eitan", "Lior", "Hila", "Amir",
+  "Ivan", "Yuri", "Olga", "Anna", "Boris", "Nina", "Pavel", "Irina", "Vera", "Daria", "Misha", "Sasha", "Vadim", "Roman", "Anya", "Lev",
+  "Omar", "Layla", "Ali", "Nadia", "Salim", "Hana", "Rami", "Zain", "Noor", "Amal", "Samir", "Farah", "Malik", "Yasmin", "Adil", "Hadi",
+  "Arjun", "Priya", "Ravi", "Anika", "Asha", "Dev", "Kiran", "Meera", "Nisha", "Rohan", "Diya", "Neha", "Anil", "Sana", "Vijay", "Isha",
+  "Wei", "Lin", "Mei", "Chen", "Li", "Jian", "Ming", "Hua", "Yan", "Tao", "Jun", "Lan", "Yue", "Lei", "Hong", "Qian",
+  "Pickle", "Waffle", "Noodle", "Spud", "Mochi", "Taco", "Doodle", "Widget", "Boop", "Bytey", "Glitch", "Sprock", "Wombat", "Goose", "Ninja", "Otter", "Quokka", "Squid", "Sushi", "Pogo", "Zippy", "Nifty", "Fuzzy", "Gizmo", "Bloop", "Blip", "Niblet", "Pixel", "Bugsy", "Wobble", "Muppet", "Puddle", "Cookie", "Muffin", "Bagel", "Nacho", "Tater", "Churro", "Snappy", "Peppy", "Plonk", "Slinky", "Tofu", "Nugget", "Dumplo", "Popper", "Kebab", "Sizzle"
+]);
+export function agentName(id) {
+  const hash = createHash("sha256").update(id).digest();
+  return AGENT_NAMES[hash.readUInt16BE(0) % AGENT_NAMES.length] + hash.subarray(2, 3).toString("hex");
+}
+const identifier = value => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9_.:-]{0,95}$/.test(value);
+export function contextSummary(meta = {}) {
+  const source = typeof (meta.cwd ?? meta.path ?? meta.project) === "string" ? (meta.cwd ?? meta.path ?? meta.project) : "";
+  const normalized = source.replaceAll("\\", "/").replace(/\/+$/, "");
+  const safe = normalized.length <= 1024 && /^[A-Za-z0-9 _./:@()+-]*$/.test(normalized) &&
+    !/(?:^|\/)(?:\.env(?:\.[^/]*)?|credentials[^/]*|\.npmrc|agent-identities\.json)(?:\/|$)/i.test(normalized);
+  const directory = safe && normalized ? normalized.slice(-96) : null;
+  const project = directory ? directory.split("/").at(-1) : null;
+  const taskMatch = safe && normalized.match(/\/planning\/tasks\/([A-Za-z0-9][A-Za-z0-9_.:-]{0,95})\.md$/);
+  const taskId = identifier(meta.taskId) ? meta.taskId : taskMatch ? taskMatch[1] : null;
+  const branchPr = safe && normalized.match(/(?:^|[/_-])pr[-_]?(\d{1,7})(?:[/_.-]|$)/i);
+  const explicitPr = Number.isSafeInteger(meta.pr) && meta.pr > 0 && meta.pr <= 9_999_999 ? meta.pr : null;
+  const args = Array.isArray(meta.args) ? meta.args : [];
+  const ghPr = meta.command === "gh" && args[0] === "pr" && ["view", "checkout", "diff", "checks", "merge"].includes(args[1]) && /^\d{1,7}$/.test(args[2] ?? "") ? Number(args[2]) : null;
+  return { project, directory, taskId, pr: explicitPr ?? ghPr ?? (branchPr ? Number(branchPr[1]) : null), inferred: !explicitPr && !identifier(meta.taskId) };
+}
+export function commandSummary(tool, meta = {}) {
+  if (tool === "agent_message" && ["send", "inbox", "ack"].includes(meta.action)) {
+    const kind = ["status", "question", "answer", "handoff", "result_summary", "blocker"].includes(meta.kind) ? " " + meta.kind : "";
+    const target = identifier(meta.to) ? " -> " + meta.to.slice(0, 8) : "";
+    return "agent_message " + meta.action + kind + target;
+  }
+  if (!["command_run", "process_start"].includes(tool)) return tool;
+  const candidate = typeof meta.command === "string" ? meta.command.replaceAll("\\", "/").split("/").at(-1).replace(/\.(exe|cmd|bat|com)$/i, "").toLowerCase() : "";
+  const name = ["node", "npm", "npx", "git", "rg", "powershell", "pwsh", "cmd", "tsc", "python", "dotnet", "gh"].includes(candidate) ? candidate : "command";
+  const args = Array.isArray(meta.args) ? meta.args : [];
+  if (name === "git" && ["status", "diff", "log", "show", "fetch", "pull", "push", "commit"].includes(args[0])) return name + " " + args[0];
+  if (name === "npm" && ["test", "install", "ci", "pack", "publish"].includes(args[0])) return name + " " + args[0];
+  if (name === "npm" && args[0] === "run" && ["test", "build", "typecheck", "lint", "dev", "start"].includes(args[1])) return "npm run " + args[1];
+  return name + (args.length ? " [args]" : "");
+}
+
+/** Diagnostic preview only. Never used to construct or execute a command. */
+export function commandPreview(tool, meta = {}) {
+  if (!["command_run", "process_start"].includes(tool)) return commandSummary(tool, meta);
+  const name = typeof meta.command === "string" && /^[A-Za-z0-9_.-]{1,40}$/.test(meta.command) ? meta.command : "command";
+  const args = Array.isArray(meta.args) ? meta.args.slice(0, 24) : [];
+  let hideNext = false, inline = false;
+  const safe = args.map(arg => {
+    if (inline || hideNext) { hideNext = false; return "[redacted]"; }
+    if (typeof arg !== "string") return "[value]";
+    if (/^(?:-e|--eval|-p|--print|-c|-command|--command|-encodedcommand|\/c|\/k)$/i.test(arg) &&
+        /^(?:node|python|bash|sh|powershell|pwsh|cmd)(?:\.[a-z]+)?$/i.test(name)) inline = true;
+    if (/^(?:[-/]+(?:.*(?:token|password|passwd|secret|credential|authorization|api[-_]?key)|auth|key|header|env|config|data|data-raw|data-binary|message|prompt)|-[uHpmd])$/i.test(arg)) hideNext = true;
+    if (/(?:token|password|passwd|secret|credential|authorization|api[-_]?key)\s*[=:]|(?:^|[/\\])(?:\.env(?:\.|$)|credentials|\.npmrc)|:\/\/|[\x00-\x1f\x7f]|[A-Za-z0-9+/_=-]{40,}/i.test(arg)) return "[redacted]";
+    // ponytail: printable simple argv only; embedded scripts and complex values stay private.
+    return arg.length <= 96 && /^[A-Za-z0-9 _./\\:@()+=-]+$/.test(arg) ? (arg.includes(" ") ? JSON.stringify(arg) : arg) : "[value]";
+  });
+  return [name, ...safe, ...(Array.isArray(meta.args) && meta.args.length > 24 ? ["…"] : [])].join(" ").slice(0, 240);
+}