trantor 0.18.76 → 0.18.77

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.18.76",
+  "version": "0.18.77",
   "description": "Trantor — the hub-world for AI agent crews: live message bus, presence, project Kanban/flow board + crew orchestration for independent AI coding agents (Claude, Codex, Gemini, Kimi, DeepSeek)",
   "mcpServers": {
     "relay": {

package/bin/agents.mjs

@@ -1,16 +1,8 @@
 #!/usr/bin/env node
-// trantor agents [sessionId] [--json] — the LIVE sub-agent manifest for a session.
-//
-// What were this session's sub-agents (Agent/Task tool, Workflow swarms, agent-teams) doing —
-// what was each tasked with, did it return, what did it write, and do those files still survive
-// on disk? Derived fresh from the on-disk transcripts every run (so it reflects CURRENT disk,
-// catching files an agent finished that were later clobbered — the 2026-06-21 kill corrupted a
-// completed 30KB lib down to a 17-byte stub).
-//
-//   trantor agents                 → the session of the newest handoff for THIS project (the
-//                                     predecessor a fresh session is taking over from)
-//   trantor agents <sessionId>     → that specific session
-//   trantor agents --json          → structured manifest (for tools)
+// trantor agents [sessionId] [--json] [--since <epochMs>] — the LIVE sub-agent manifest for a
+// session: what was each sub-agent tasked with, did it return, what did it write, did it survive
+// on disk — re-derived fresh from the transcripts every run. `--since <epochMs>` (#10007) reads
+// agents launched before that instant "stale", never "in-flight"; the app polls this for liveness.
 import { readFileSync, readdirSync, existsSync } from "node:fs";
 import { join, basename } from "node:path";
 import { homedir } from "node:os";
@@ -18,7 +10,10 @@ import { deriveSubagentManifest, formatSubagentManifest, resolveTranscriptForSid
 
 const args = process.argv.slice(2);
 const json = args.includes("--json");
-const sid = args.find((a) => !a.startsWith("--"));
+const sinceIdx = args.indexOf("--since");
+const sinceVal = sinceIdx !== -1 ? args[sinceIdx + 1] : undefined;
+const sinceMs = sinceVal != null ? Number(sinceVal) : undefined;
+const sid = args.find((a) => !a.startsWith("--") && a !== sinceVal);
 
 const HANDOFF_DIR = join(process.env.RELAY_DATA_DIR || join(homedir(), ".agent-bus"), "handoffs");
 
@@ -55,7 +50,7 @@ if (sid) {
   projectRoot = h.project || projectRoot;
 }
 
-const manifest = deriveSubagentManifest(transcript, { projectRoot });
+const manifest = deriveSubagentManifest(transcript, { projectRoot, sinceMs: Number.isFinite(sinceMs) ? sinceMs : undefined });
 if (json) {
   process.stdout.write(JSON.stringify(manifest, null, 2) + "\n");
 } else {

package/lib/subagent-manifest.mjs

@@ -68,11 +68,12 @@ function reconcileFile(absPath, agentBytes, projectRoot) {
   return { path: shortPath(absPath, projectRoot), agentBytes, onDiskNow, suspect };
 }
 
-function analyzeAgent(meta, completedIds, projectRoot) {
+function analyzeAgent(meta, completedIds, projectRoot, sinceMs) {
   const wrote = new Map(); // absPath → last-write byte length
-  let lastMs = 0, result = "";
+  let lastMs = 0, launchMs = 0, result = "";
   for (const r of parseLines(meta.jsonlPath)) {
     const ts = r.timestamp ? Date.parse(r.timestamp) || 0 : 0;
+    if (!launchMs && ts) launchMs = ts; // jsonl is append-ordered: first timestamped line = launch
     if (ts > lastMs) lastMs = ts;
     const c = r?.message?.content;
     if (!Array.isArray(c)) continue;
@@ -84,13 +85,22 @@ function analyzeAgent(meta, completedIds, projectRoot) {
       if (b?.type === "text") { const text = asString(b.text)?.trim(); if (text) result = text; }
     }
   }
-  const status = meta.toolUseId && completedIds.has(meta.toolUseId) ? "completed" : "in-flight";
+  // #10007 liveness: "in-flight" means launched and never returned a result. But an agent whose
+  // launch predates the session's CURRENT process (sinceMs = process start) can never return —
+  // its turn died with the old process — so it reads "stale" and never counts as live.
+  const returned = meta.toolUseId && completedIds.has(meta.toolUseId);
+  let status = returned ? "completed" : "in-flight";
+  if (!returned) {
+    if (!launchMs) { try { launchMs = statSync(meta.jsonlPath).birthtimeMs || 0; } catch {} }
+    if (sinceMs != null && launchMs < sinceMs) status = "stale";
+  }
   return {
     name: meta.name || basename(meta.jsonlPath).replace(/\.jsonl$/, ""),
     agentType: meta.agentType || "",
     task: meta.description || "",
     workflow: meta.workflow || null,
     status,
+    launchMs: launchMs || null,
     wrote: [...wrote.entries()].map(([p, n]) => reconcileFile(p, n, projectRoot)),
     lastActivity: lastMs ? new Date(lastMs).toISOString() : null,
     lastActivityMs: lastMs,
@@ -99,10 +109,12 @@ function analyzeAgent(meta, completedIds, projectRoot) {
   };
 }
 
-// Derive the full manifest for a session from its parent transcript path. projectRoot (the repo
-// dir) is used only to shorten displayed file paths. Returns { sessionId, subagents[], counts }.
-export function deriveSubagentManifest(parentTranscript, { projectRoot } = {}) {
-  const out = { sessionId: "", subagents: [], counts: { total: 0, completed: 0, inFlight: 0, suspectFiles: 0 } };
+// Derive the full manifest for a session from its parent transcript path. projectRoot shortens
+// displayed file paths. sinceMs (epoch ms, #10007) marks agents launched before it "stale" instead
+// of "in-flight" — pass the session process's start when the answer feeds a LIVE claim (ACTIVE
+// NOW), never for a handoff record. Returns { sessionId, subagents[], counts }.
+export function deriveSubagentManifest(parentTranscript, { projectRoot, sinceMs } = {}) {
+  const out = { sessionId: "", subagents: [], counts: { total: 0, completed: 0, inFlight: 0, stale: 0, suspectFiles: 0 } };
   try {
     if (!parentTranscript || !existsSync(parentTranscript)) return out;
     const sid = basename(parentTranscript).replace(/\.jsonl$/i, "");
@@ -118,12 +130,13 @@ export function deriveSubagentManifest(parentTranscript, { projectRoot } = {}) {
     }
 
     const metas = collectMetas(subdir);
-    out.subagents = metas.map((m) => analyzeAgent(m, completedIds, projectRoot))
+    out.subagents = metas.map((m) => analyzeAgent(m, completedIds, projectRoot, sinceMs))
       .sort((a, b) => (a.lastActivityMs || 0) - (b.lastActivityMs || 0));
 
     out.counts.total = out.subagents.length;
     out.counts.completed = out.subagents.filter((s) => s.status === "completed").length;
     out.counts.inFlight = out.subagents.filter((s) => s.status === "in-flight").length;
+    out.counts.stale = out.subagents.filter((s) => s.status === "stale").length;
     out.counts.suspectFiles = out.subagents.reduce((n, s) => n + s.wrote.filter((w) => w.suspect).length, 0);
   } catch {}
   return out;
@@ -140,7 +153,9 @@ export function formatSubagentManifest(m, { heading = true } = {}) {
     }
   }
   for (const s of m.subagents) {
-    const badge = s.status === "completed" ? "✅ completed" : "🛑 IN-FLIGHT at handoff";
+    const badge = s.status === "completed" ? "✅ completed"
+      : s.status === "stale" ? "⏸  never returned, and launched before the current session process — stale"
+      : "🛑 IN-FLIGHT at handoff";
     L.push("");
     L.push(`• ${s.name}  [${s.agentType}]${s.workflow ? ` · wf:${s.workflow}` : ""}  ${badge}`);
     if (s.task) L.push(`    task: ${s.task}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trantor",
-  "version": "0.18.76",
+  "version": "0.18.77",
   "type": "module",
   "bin": {
     "trantor": "bin/cli.mjs"