agentflow-core 0.2.1 → 0.2.3

package/dist/index.cjs

@@ -693,7 +693,7 @@ var C = {
   white: "\x1B[37m"
 };
 function parseArgs(argv) {
-  const config = { tracesDir: ".", refreshMs: 3e3, recursive: false };
+  const config = { dirs: [], refreshMs: 3e3, recursive: false };
   const args = argv.slice(0);
   if (args[0] === "live") args.shift();
   let i = 0;
@@ -710,18 +710,14 @@ function parseArgs(argv) {
     } else if (arg === "--recursive" || arg === "-R") {
       config.recursive = true;
       i++;
-    } else if (arg === "--traces-dir" || arg === "-t") {
-      i++;
-      config.tracesDir = args[i] ?? config.tracesDir;
-      i++;
     } else if (!arg.startsWith("-")) {
-      config.tracesDir = arg;
+      config.dirs.push((0, import_node_path2.resolve)(arg));
       i++;
     } else {
       i++;
     }
   }
-  config.tracesDir = (0, import_node_path2.resolve)(config.tracesDir);
+  if (config.dirs.length === 0) config.dirs.push((0, import_node_path2.resolve)("."));
   return config;
 }
 function printUsage() {
@@ -729,13 +725,13 @@ function printUsage() {
 AgentFlow Live Monitor \u2014 real-time terminal dashboard for agent systems.
 
 Auto-detects agent traces, state files, job schedulers, and session logs
-from any JSON/JSONL files in the watched directory.
+from any JSON/JSONL files in the watched directories.
 
 Usage:
-  agentflow live [directory] [options]
+  agentflow live [dir...] [options]
 
 Arguments:
-  directory               Directory to watch (default: current directory)
+  dir                     One or more directories to watch (default: .)
 
 Options:
   -r, --refresh <secs>    Refresh interval in seconds (default: 3)
@@ -744,38 +740,42 @@ Options:
 
 Examples:
   agentflow live ./data
-  agentflow live ./traces --refresh 5
+  agentflow live ./traces ./cron ./workers --refresh 5
   agentflow live /var/lib/myagent -R
 `.trim());
 }
-function scanFiles(dir, recursive) {
+function scanFiles(dirs, recursive) {
   const results = [];
-  function scanDir(d) {
+  const seen = /* @__PURE__ */ new Set();
+  function scanDir(d, topLevel) {
     try {
       for (const f of (0, import_node_fs2.readdirSync)(d)) {
         if (f.startsWith(".")) continue;
         const fp = (0, import_node_path2.join)(d, f);
+        if (seen.has(fp)) continue;
         let stat;
         try {
           stat = (0, import_node_fs2.statSync)(fp);
         } catch {
           continue;
         }
-        if (stat.isDirectory() && recursive && d === dir) {
-          scanDir(fp);
+        if (stat.isDirectory() && recursive && topLevel) {
+          scanDir(fp, false);
           continue;
         }
         if (!stat.isFile()) continue;
         if (f.endsWith(".json")) {
+          seen.add(fp);
           results.push({ filename: f, path: fp, mtime: stat.mtime.getTime(), ext: ".json" });
         } else if (f.endsWith(".jsonl")) {
+          seen.add(fp);
           results.push({ filename: f, path: fp, mtime: stat.mtime.getTime(), ext: ".jsonl" });
         }
       }
     } catch {
     }
   }
-  scanDir(dir);
+  for (const dir of dirs) scanDir(dir, true);
   results.sort((a, b) => b.mtime - a.mtime);
   return results;
 }
@@ -925,11 +925,21 @@ function processJsonlFile(file) {
     return [];
   }
 }
+var K = "\x1B[K";
+function writeLine(lines, text) {
+  lines.push(text + K);
+}
+function flushLines(lines) {
+  process.stdout.write("\x1B[H");
+  process.stdout.write(lines.join("\n") + "\n");
+  process.stdout.write("\x1B[J");
+}
 var prevFileCount = 0;
 var newExecCount = 0;
 var sessionStart = Date.now();
+var firstRender = true;
 function render(config) {
-  const files = scanFiles(config.tracesDir, config.recursive);
+  const files = scanFiles(config.dirs, config.recursive);
   if (files.length > prevFileCount && prevFileCount > 0) {
     newExecCount += files.length - prevFileCount;
   }
@@ -943,26 +953,58 @@ function render(config) {
       if (r.traceData) allTraces.push(r.traceData);
     }
   }
-  const agents = {};
+  const byFile = /* @__PURE__ */ new Map();
   for (const r of allRecords) {
-    if (!agents[r.id]) {
-      agents[r.id] = { name: r.id, total: 0, ok: 0, fail: 0, running: 0, lastTs: 0, source: r.source, detail: "" };
-    }
-    const ag = agents[r.id];
-    ag.total++;
-    if (r.status === "ok") ag.ok++;
-    else if (r.status === "error") ag.fail++;
-    else if (r.status === "running") ag.running++;
-    if (r.lastActive > ag.lastTs) {
-      ag.lastTs = r.lastActive;
-      ag.detail = r.detail;
-      ag.source = r.source;
+    const arr = byFile.get(r.file) ?? [];
+    arr.push(r);
+    byFile.set(r.file, arr);
+  }
+  const groups = [];
+  for (const [file, records] of byFile) {
+    if (records.length === 1) {
+      const r = records[0];
+      groups.push({
+        name: r.id,
+        source: r.source,
+        status: r.status,
+        lastTs: r.lastActive,
+        detail: r.detail,
+        children: [],
+        ok: r.status === "ok" ? 1 : 0,
+        fail: r.status === "error" ? 1 : 0,
+        running: r.status === "running" ? 1 : 0,
+        total: 1
+      });
+    } else {
+      const groupName = nameFromFile(file);
+      let lastTs = 0;
+      let ok = 0, fail = 0, running = 0;
+      for (const r of records) {
+        if (r.lastActive > lastTs) lastTs = r.lastActive;
+        if (r.status === "ok") ok++;
+        else if (r.status === "error") fail++;
+        else if (r.status === "running") running++;
+      }
+      const status = fail > 0 ? "error" : running > 0 ? "running" : ok > 0 ? "ok" : "unknown";
+      groups.push({
+        name: groupName,
+        source: records[0].source,
+        status,
+        lastTs,
+        detail: `${records.length} agents`,
+        children: records.sort((a, b) => b.lastActive - a.lastActive),
+        ok,
+        fail,
+        running,
+        total: records.length
+      });
     }
   }
-  const agentList = Object.values(agents).sort((a, b) => b.lastTs - a.lastTs);
-  const totExec = agentList.reduce((s, a) => s + a.total, 0);
-  const totFail = agentList.reduce((s, a) => s + a.fail, 0);
-  const totRunning = agentList.reduce((s, a) => s + a.running, 0);
+  groups.sort((a, b) => b.lastTs - a.lastTs);
+  const totExec = allRecords.length;
+  const totFail = allRecords.filter((r) => r.status === "error").length;
+  const totRunning = allRecords.filter((r) => r.status === "running").length;
+  const uniqueAgents = new Set(allRecords.map((r) => r.id)).size;
   const sysRate = totExec > 0 ? ((totExec - totFail) / totExec * 100).toFixed(1) : "100.0";
   const now = Date.now();
   const buckets = new Array(12).fill(0);
@@ -999,7 +1041,21 @@ function render(config) {
   const upMin = Math.floor(upSec / 60);
   const upStr = upMin > 0 ? `${upMin}m ${upSec % 60}s` : `${upSec}s`;
   const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-  const sourceTag = (s) => {
+  function statusIcon(s, recent) {
+    if (s === "error") return `${C.red}\u25CF${C.reset}`;
+    if (s === "running") return `${C.green}\u25CF${C.reset}`;
+    if (s === "ok" && recent) return `${C.green}\u25CF${C.reset}`;
+    if (s === "ok") return `${C.dim}\u25CB${C.reset}`;
+    return `${C.dim}\u25CB${C.reset}`;
+  }
+  function statusText(g) {
+    if (g.fail > 0 && g.ok === 0 && g.running === 0) return `${C.red}error${C.reset}`;
+    if (g.running > 0) return `${C.green}running${C.reset}`;
+    if (g.fail > 0) return `${C.yellow}${g.ok}ok/${g.fail}err${C.reset}`;
+    if (g.ok > 0) return g.total > 1 ? `${C.green}${g.ok}/${g.total} ok${C.reset}` : `${C.green}ok${C.reset}`;
+    return `${C.dim}idle${C.reset}`;
+  }
+  function sourceTag(s) {
     switch (s) {
       case "trace":
         return `${C.cyan}trace${C.reset}`;
@@ -1012,92 +1068,115 @@ function render(config) {
       case "state":
         return `${C.dim}state${C.reset}`;
     }
-  };
-  process.stdout.write("\x1B[2J\x1B[H");
-  console.log(`${C.bold}${C.cyan}\u2554${"\u2550".repeat(70)}\u2557${C.reset}`);
-  console.log(`${C.bold}${C.cyan}\u2551${C.reset}  ${C.bold}${C.white}AGENTFLOW LIVE${C.reset}                               ${C.green}\u25CF LIVE${C.reset}  ${C.dim}${time}${C.reset}  ${C.bold}${C.cyan}\u2551${C.reset}`);
+  }
+  function timeStr(ts) {
+    if (ts <= 0) return "n/a";
+    return new Date(ts).toLocaleTimeString();
+  }
+  function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "\u2026" : s;
+  }
+  if (firstRender) {
+    process.stdout.write("\x1B[2J");
+    firstRender = false;
+  }
+  const L = [];
+  writeLine(L, `${C.bold}${C.cyan}\u2554${"\u2550".repeat(70)}\u2557${C.reset}`);
+  writeLine(L, `${C.bold}${C.cyan}\u2551${C.reset}  ${C.bold}${C.white}AGENTFLOW LIVE${C.reset}                               ${C.green}\u25CF LIVE${C.reset}  ${C.dim}${time}${C.reset}  ${C.bold}${C.cyan}\u2551${C.reset}`);
   const metaLine = `Refresh: ${config.refreshMs / 1e3}s \xB7 Up: ${upStr} \xB7 Files: ${files.length}`;
   const pad1 = Math.max(0, 64 - metaLine.length);
-  console.log(`${C.bold}${C.cyan}\u2551${C.reset}  ${C.dim}${metaLine}${C.reset}${" ".repeat(pad1)}${C.bold}${C.cyan}\u2551${C.reset}`);
-  console.log(`${C.bold}${C.cyan}\u255A${"\u2550".repeat(70)}\u255D${C.reset}`);
+  writeLine(L, `${C.bold}${C.cyan}\u2551${C.reset}  ${C.dim}${metaLine}${C.reset}${" ".repeat(pad1)}${C.bold}${C.cyan}\u2551${C.reset}`);
+  writeLine(L, `${C.bold}${C.cyan}\u255A${"\u2550".repeat(70)}\u255D${C.reset}`);
   const sc = totFail === 0 ? C.green : C.yellow;
-  console.log("");
-  console.log(`  ${C.bold}Agents${C.reset} ${sc}${agentList.length}${C.reset}    ${C.bold}Records${C.reset} ${sc}${totExec}${C.reset}    ${C.bold}Success${C.reset} ${sc}${sysRate}%${C.reset}    ${C.bold}Running${C.reset} ${C.green}${totRunning}${C.reset}    ${C.bold}Errors${C.reset} ${totFail > 0 ? C.red : C.dim}${totFail}${C.reset}    ${C.bold}New${C.reset} ${C.yellow}+${newExecCount}${C.reset}`);
-  console.log("");
-  console.log(`  ${C.bold}Activity (1h)${C.reset}  ${spark}  ${C.dim}\u2190 now${C.reset}`);
-  console.log("");
-  console.log(`  ${C.bold}${C.under}Agent                     Type     Status   Last Active  Detail${C.reset}`);
-  for (const ag of agentList.slice(0, 30)) {
-    const lastTime = ag.lastTs > 0 ? new Date(ag.lastTs).toLocaleTimeString() : "n/a";
-    const isRecent = Date.now() - ag.lastTs < 3e5;
-    let statusIcon;
-    let statusText;
-    if (ag.fail > 0 && ag.ok === 0 && ag.running === 0) {
-      statusIcon = `${C.red}\u25CF${C.reset}`;
-      statusText = `${C.red}error${C.reset}`;
-    } else if (ag.running > 0) {
-      statusIcon = `${C.green}\u25CF${C.reset}`;
-      statusText = `${C.green}running${C.reset}`;
-    } else if (ag.fail > 0) {
-      statusIcon = `${C.yellow}\u25CF${C.reset}`;
-      statusText = `${C.yellow}${ag.ok}ok/${ag.fail}err${C.reset}`;
-    } else if (ag.ok > 0) {
-      statusIcon = isRecent ? `${C.green}\u25CF${C.reset}` : `${C.dim}\u25CB${C.reset}`;
-      statusText = ag.total > 1 ? `${C.green}${ag.ok}/${ag.total}${C.reset}` : `${C.green}ok${C.reset}`;
+  writeLine(L, "");
+  writeLine(L, `  ${C.bold}Agents${C.reset} ${sc}${uniqueAgents}${C.reset}    ${C.bold}Records${C.reset} ${sc}${totExec}${C.reset}    ${C.bold}Success${C.reset} ${sc}${sysRate}%${C.reset}    ${C.bold}Running${C.reset} ${C.green}${totRunning}${C.reset}    ${C.bold}Errors${C.reset} ${totFail > 0 ? C.red : C.dim}${totFail}${C.reset}    ${C.bold}New${C.reset} ${C.yellow}+${newExecCount}${C.reset}`);
+  writeLine(L, "");
+  writeLine(L, `  ${C.bold}Activity (1h)${C.reset}  ${spark}  ${C.dim}\u2190 now${C.reset}`);
+  writeLine(L, "");
+  writeLine(L, `  ${C.bold}${C.under}Agent                        Status      Last Active  Detail${C.reset}`);
+  let lineCount = 0;
+  for (const g of groups) {
+    if (lineCount > 35) break;
+    const isRecent = Date.now() - g.lastTs < 3e5;
+    const icon = statusIcon(g.status, isRecent);
+    const active = isRecent ? `${C.green}${timeStr(g.lastTs)}${C.reset}` : `${C.dim}${timeStr(g.lastTs)}${C.reset}`;
+    if (g.children.length === 0) {
+      const name = truncate(g.name, 26).padEnd(26);
+      const st = statusText(g);
+      const det = truncate(g.detail, 30);
+      writeLine(L, `  ${icon} ${name}  ${st.padEnd(20)}  ${active.padEnd(20)}  ${C.dim}${det}${C.reset}`);
+      lineCount++;
     } else {
-      statusIcon = `${C.dim}\u25CB${C.reset}`;
-      statusText = `${C.dim}idle${C.reset}`;
+      const name = truncate(g.name, 24).padEnd(24);
+      const st = statusText(g);
+      const tag = sourceTag(g.source);
+      writeLine(L, `  ${icon} ${C.bold}${name}${C.reset}  ${st.padEnd(20)}  ${active.padEnd(20)}  ${tag} ${C.dim}(${g.children.length} agents)${C.reset}`);
+      lineCount++;
+      const kids = g.children.slice(0, 12);
+      for (let i = 0; i < kids.length; i++) {
+        if (lineCount > 35) break;
+        const child = kids[i];
+        const isLast = i === kids.length - 1;
+        const connector = isLast ? "\u2514\u2500" : "\u251C\u2500";
+        const cIcon = statusIcon(child.status, Date.now() - child.lastActive < 3e5);
+        const cName = truncate(child.id, 22).padEnd(22);
+        const cActive = `${C.dim}${timeStr(child.lastActive)}${C.reset}`;
+        const cDet = truncate(child.detail, 25);
+        writeLine(L, `     ${C.dim}${connector}${C.reset} ${cIcon} ${cName}  ${cActive.padEnd(20)}  ${C.dim}${cDet}${C.reset}`);
+        lineCount++;
+      }
+      if (g.children.length > 12) {
+        writeLine(L, `     ${C.dim}   ... +${g.children.length - 12} more${C.reset}`);
+        lineCount++;
+      }
     }
-    const name = ag.name.length > 23 ? ag.name.slice(0, 22) + "\u2026" : ag.name.padEnd(23);
-    const src = sourceTag(ag.source).padEnd(16);
-    const active = isRecent ? `${C.green}${lastTime}${C.reset}` : `${C.dim}${lastTime}${C.reset}`;
-    const detail = ag.detail.length > 30 ? ag.detail.slice(0, 29) + "\u2026" : ag.detail;
-    console.log(`  ${statusIcon} ${name}  ${src}  ${statusText.padEnd(18)}  ${active.padEnd(20)}  ${C.dim}${detail}${C.reset}`);
   }
   if (distributedTraces.length > 0) {
-    console.log("");
-    console.log(`  ${C.bold}${C.under}Distributed Traces${C.reset}`);
+    writeLine(L, "");
+    writeLine(L, `  ${C.bold}${C.under}Distributed Traces${C.reset}`);
     for (const dt of distributedTraces.slice(0, 3)) {
       const traceTime = new Date(dt.startTime).toLocaleTimeString();
-      const statusIcon = dt.status === "completed" ? `${C.green}\u2713${C.reset}` : dt.status === "failed" ? `${C.red}\u2717${C.reset}` : `${C.yellow}\u23F3${C.reset}`;
+      const si = dt.status === "completed" ? `${C.green}\u2713${C.reset}` : dt.status === "failed" ? `${C.red}\u2717${C.reset}` : `${C.yellow}\u23F3${C.reset}`;
       const dur = dt.endTime ? `${dt.endTime - dt.startTime}ms` : "running";
       const tid = dt.traceId.slice(0, 8);
-      console.log(`  ${statusIcon}  ${C.magenta}trace:${tid}${C.reset}  ${C.dim}${traceTime}  ${dur}  (${dt.graphs.size} agents)${C.reset}`);
+      writeLine(L, `  ${si}  ${C.magenta}trace:${tid}${C.reset}  ${C.dim}${traceTime}  ${dur}  (${dt.graphs.size} agents)${C.reset}`);
       const tree = getTraceTree(dt);
       for (let i = 0; i < Math.min(tree.length, 6); i++) {
-        const g = tree[i];
-        const depth = getDistDepth(dt, g.spanId);
+        const tg = tree[i];
+        const depth = getDistDepth(dt, tg.spanId);
         const indent = "     " + "\u2502  ".repeat(Math.max(0, depth - 1));
         const isLast = i === tree.length - 1 || getDistDepth(dt, tree[i + 1]?.spanId) <= depth;
         const conn = depth === 0 ? "  " : isLast ? "\u2514\u2500 " : "\u251C\u2500 ";
-        const gs = g.status === "completed" ? `${C.green}\u2713${C.reset}` : g.status === "failed" ? `${C.red}\u2717${C.reset}` : `${C.yellow}\u23F3${C.reset}`;
-        const gd = g.endTime ? `${g.endTime - g.startTime}ms` : "running";
-        console.log(`${indent}${conn}${gs} ${C.bold}${g.agentId}${C.reset} ${C.dim}[${g.trigger}] ${gd}${C.reset}`);
+        const gs = tg.status === "completed" ? `${C.green}\u2713${C.reset}` : tg.status === "failed" ? `${C.red}\u2717${C.reset}` : `${C.yellow}\u23F3${C.reset}`;
+        const gd = tg.endTime ? `${tg.endTime - tg.startTime}ms` : "running";
+        writeLine(L, `${indent}${conn}${gs} ${C.bold}${tg.agentId}${C.reset} ${C.dim}[${tg.trigger}] ${gd}${C.reset}`);
       }
     }
   }
-  const recentRecords = allRecords.filter((r) => r.lastActive > 0).sort((a, b) => b.lastActive - a.lastActive).slice(0, 8);
+  const recentRecords = allRecords.filter((r) => r.lastActive > 0).sort((a, b) => b.lastActive - a.lastActive).slice(0, 6);
   if (recentRecords.length > 0) {
-    console.log("");
-    console.log(`  ${C.bold}${C.under}Recent Activity${C.reset}`);
+    writeLine(L, "");
+    writeLine(L, `  ${C.bold}${C.under}Recent Activity${C.reset}`);
     for (const r of recentRecords) {
       const icon = r.status === "ok" ? `${C.green}\u2713${C.reset}` : r.status === "error" ? `${C.red}\u2717${C.reset}` : r.status === "running" ? `${C.green}\u25B6${C.reset}` : `${C.dim}\u25CB${C.reset}`;
       const t = new Date(r.lastActive).toLocaleTimeString();
-      const agent = r.id.length > 26 ? r.id.slice(0, 25) + "\u2026" : r.id.padEnd(26);
+      const agent = truncate(r.id, 26).padEnd(26);
       const age = Math.floor((Date.now() - r.lastActive) / 1e3);
       const ageStr = age < 60 ? age + "s ago" : age < 3600 ? Math.floor(age / 60) + "m ago" : Math.floor(age / 3600) + "h ago";
-      const detail = r.detail.length > 25 ? r.detail.slice(0, 24) + "\u2026" : r.detail;
-      console.log(`  ${icon}  ${agent} ${C.dim}${t}  ${ageStr.padStart(8)}${C.reset}  ${C.dim}${detail}${C.reset}`);
+      const det = truncate(r.detail, 25);
+      writeLine(L, `  ${icon}  ${agent} ${C.dim}${t}  ${ageStr.padStart(8)}${C.reset}  ${C.dim}${det}${C.reset}`);
     }
   }
   if (files.length === 0) {
-    console.log("");
-    console.log(`  ${C.dim}No JSON/JSONL files found. Waiting for data in:${C.reset}`);
-    console.log(`  ${C.dim}${config.tracesDir}${C.reset}`);
+    writeLine(L, "");
+    writeLine(L, `  ${C.dim}No JSON/JSONL files found. Waiting for data in:${C.reset}`);
+    for (const d of config.dirs) writeLine(L, `  ${C.dim}  ${d}${C.reset}`);
   }
-  console.log("");
-  console.log(`  ${C.dim}Watching: ${config.tracesDir}${C.reset}`);
-  console.log(`  ${C.dim}Press Ctrl+C to exit${C.reset}`);
+  writeLine(L, "");
+  const dirLabel = config.dirs.length === 1 ? config.dirs[0] : `${config.dirs.length} directories`;
+  writeLine(L, `  ${C.dim}Watching: ${dirLabel}${C.reset}`);
+  writeLine(L, `  ${C.dim}Press Ctrl+C to exit${C.reset}`);
+  flushLines(L);
 }
 function getDistDepth(dt, spanId) {
   if (!spanId) return 0;
@@ -1107,19 +1186,27 @@ function getDistDepth(dt, spanId) {
 }
 function startLive(argv) {
   const config = parseArgs(argv);
-  if (!(0, import_node_fs2.existsSync)(config.tracesDir)) {
-    console.error(`Directory does not exist: ${config.tracesDir}`);
-    console.error("Specify a directory containing JSON/JSONL files: agentflow live <dir>");
+  const valid = config.dirs.filter((d) => (0, import_node_fs2.existsSync)(d));
+  if (valid.length === 0) {
+    console.error(`No valid directories found: ${config.dirs.join(", ")}`);
+    console.error("Specify directories containing JSON/JSONL files: agentflow live <dir> [dir...]");
     process.exit(1);
   }
+  const invalid = config.dirs.filter((d) => !(0, import_node_fs2.existsSync)(d));
+  if (invalid.length > 0) {
+    console.warn(`Skipping non-existent: ${invalid.join(", ")}`);
+  }
+  config.dirs = valid;
   render(config);
   let debounce = null;
-  try {
-    (0, import_node_fs2.watch)(config.tracesDir, { recursive: config.recursive }, () => {
-      if (debounce) clearTimeout(debounce);
-      debounce = setTimeout(() => render(config), 500);
-    });
-  } catch {
+  for (const dir of config.dirs) {
+    try {
+      (0, import_node_fs2.watch)(dir, { recursive: config.recursive }, () => {
+        if (debounce) clearTimeout(debounce);
+        debounce = setTimeout(() => render(config), 500);
+      });
+    } catch {
+    }
   }
   setInterval(() => render(config), config.refreshMs);
   process.on("SIGINT", () => {

package/dist/index.js

@@ -18,7 +18,7 @@ import {
   runTraced,
   startLive,
   stitchTrace
-} from "./chunk-FJVQYJFB.js";
+} from "./chunk-5SPZPOFN.js";
 export {
   createGraphBuilder,
   findWaitingOn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentflow-core",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Universal execution tracing for AI agent systems",
   "type": "module",
   "main": "./dist/index.cjs",