npm - agentflow-core - Versions diffs - 0.3.3 → 0.4.0 - Mend

agentflow-core 0.3.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/dist/{chunk-M5CGDXAO.js → chunk-DHCTDCDI.js} +1612 -1306
package/dist/chunk-DY7YHFIB.js +56 -0
package/dist/cli.cjs +1185 -577
package/dist/cli.js +217 -9
package/dist/index.cjs +936 -416
package/dist/index.d.cts +296 -132
package/dist/index.d.ts +296 -132
package/dist/index.js +173 -5
package/dist/loader-LYRR6LMM.js +8 -0
package/package.json +1 -1

package/dist/{chunk-M5CGDXAO.js → chunk-DHCTDCDI.js} RENAMED Viewed

@@ -1,1289 +1,1685 @@
-// src/graph-builder.ts
-import { randomUUID } from "crypto";
-function deepFreeze(obj) {
-  if (obj === null || typeof obj !== "object") return obj;
-  if (obj instanceof Map) {
-    Object.freeze(obj);
-    for (const value of obj.values()) {
-      deepFreeze(value);
+import {
+  graphToJson,
+  loadGraph
+} from "./chunk-DY7YHFIB.js";
+// src/graph-query.ts
+function getNode(graph, nodeId) {
+  return graph.nodes.get(nodeId);
+}
+function getChildren(graph, nodeId) {
+  const node = graph.nodes.get(nodeId);
+  if (!node) return [];
+  const result = [];
+  for (const childId of node.children) {
+    const child = graph.nodes.get(childId);
+    if (child) result.push(child);
+  }
+  return result;
+}
+function getParent(graph, nodeId) {
+  const node = graph.nodes.get(nodeId);
+  if (!node || node.parentId === null) return void 0;
+  return graph.nodes.get(node.parentId);
+}
+function getFailures(graph) {
+  const failureStatuses = /* @__PURE__ */ new Set(["failed", "hung", "timeout"]);
+  return [...graph.nodes.values()].filter((node) => failureStatuses.has(node.status));
+}
+function getHungNodes(graph) {
+  return [...graph.nodes.values()].filter(
+    (node) => node.status === "running" && node.endTime === null
+  );
+}
+function getCriticalPath(graph) {
+  const root = graph.nodes.get(graph.rootNodeId);
+  if (!root) return [];
+  function nodeDuration2(node) {
+    const end = node.endTime ?? Date.now();
+    return end - node.startTime;
+  }
+  function dfs(node) {
+    if (node.children.length === 0) {
+      return { duration: nodeDuration2(node), path: [node] };
     }
-    return obj;
+    let bestChild = { duration: -1, path: [] };
+    for (const childId of node.children) {
+      const child = graph.nodes.get(childId);
+      if (!child) continue;
+      const result = dfs(child);
+      if (result.duration > bestChild.duration) {
+        bestChild = result;
+      }
+    }
+    return {
+      duration: nodeDuration2(node) + bestChild.duration,
+      path: [node, ...bestChild.path]
+    };
   }
-  Object.freeze(obj);
-  const record = obj;
-  for (const key of Object.keys(record)) {
-    const value = record[key];
-    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
-      deepFreeze(value);
+  return dfs(root).path;
+}
+function findWaitingOn(graph, nodeId) {
+  const results = [];
+  for (const edge of graph.edges) {
+    if (edge.from === nodeId && edge.type === "waited_on") {
+      const node = graph.nodes.get(edge.to);
+      if (node) results.push(node);
     }
   }
-  return obj;
+  return results;
 }
-function createCounterIdGenerator() {
-  let counter = 0;
-  return () => {
-    counter++;
-    return `node_${String(counter).padStart(3, "0")}`;
-  };
+function getSubtree(graph, nodeId) {
+  const startNode = graph.nodes.get(nodeId);
+  if (!startNode) return [];
+  const result = [];
+  const queue = [...startNode.children];
+  while (queue.length > 0) {
+    const currentId = queue.shift();
+    if (currentId === void 0) break;
+    const current = graph.nodes.get(currentId);
+    if (!current) continue;
+    result.push(current);
+    queue.push(...current.children);
+  }
+  return result;
 }
-function createGraphBuilder(config) {
-  const generateId = config?.idGenerator ?? createCounterIdGenerator();
-  const agentId = config?.agentId ?? "unknown";
-  const trigger = config?.trigger ?? "manual";
-  const spanId = randomUUID();
-  const traceId = config?.traceId ?? (typeof process !== "undefined" ? process.env?.AGENTFLOW_TRACE_ID : void 0) ?? randomUUID();
-  const parentSpanId = config?.parentSpanId ?? (typeof process !== "undefined" ? process.env?.AGENTFLOW_PARENT_SPAN_ID : void 0) ?? null;
-  const graphId = generateId();
-  const startTime = Date.now();
-  const nodes = /* @__PURE__ */ new Map();
-  const edges = [];
-  const events = [];
-  const parentStack = [];
-  let rootNodeId = null;
-  let built = false;
-  function assertNotBuilt() {
-    if (built) {
-      throw new Error("GraphBuilder: cannot mutate after build() has been called");
+function getDuration(graph) {
+  const end = graph.endTime ?? Date.now();
+  return end - graph.startTime;
+}
+function getDepth(graph) {
+  const root = graph.nodes.get(graph.rootNodeId);
+  if (!root) return -1;
+  function dfs(node, depth) {
+    if (node.children.length === 0) return depth;
+    let maxDepth = depth;
+    for (const childId of node.children) {
+      const child = graph.nodes.get(childId);
+      if (!child) continue;
+      const childDepth = dfs(child, depth + 1);
+      if (childDepth > maxDepth) maxDepth = childDepth;
     }
+    return maxDepth;
   }
-  function getNode2(nodeId) {
-    const node = nodes.get(nodeId);
-    if (!node) {
-      throw new Error(`GraphBuilder: node "${nodeId}" does not exist`);
+  return dfs(root, 0);
+}
+function getStats(graph) {
+  const byStatus = {
+    running: 0,
+    completed: 0,
+    failed: 0,
+    hung: 0,
+    timeout: 0
+  };
+  const byType = {
+    agent: 0,
+    tool: 0,
+    subagent: 0,
+    wait: 0,
+    decision: 0,
+    custom: 0
+  };
+  let failureCount = 0;
+  let hungCount = 0;
+  for (const node of graph.nodes.values()) {
+    byStatus[node.status]++;
+    byType[node.type]++;
+    if (node.status === "failed" || node.status === "timeout" || node.status === "hung") {
+      failureCount++;
+    }
+    if (node.status === "running" && node.endTime === null) {
+      hungCount++;
     }
-    return node;
   }
-  function recordEvent(nodeId, eventType, data = {}) {
-    events.push({
-      timestamp: Date.now(),
-      eventType,
-      nodeId,
-      data
-    });
+  return {
+    totalNodes: graph.nodes.size,
+    byStatus,
+    byType,
+    depth: getDepth(graph),
+    duration: getDuration(graph),
+    failureCount,
+    hungCount
+  };
+}
+// src/graph-stitch.ts
+function groupByTraceId(graphs) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const g of graphs) {
+    if (!g.traceId) continue;
+    const arr = groups.get(g.traceId) ?? [];
+    arr.push(g);
+    groups.set(g.traceId, arr);
   }
-  function buildGraph() {
-    if (rootNodeId === null) {
-      throw new Error("GraphBuilder: cannot build a graph with no nodes");
+  return groups;
+}
+function stitchTrace(graphs) {
+  if (graphs.length === 0) throw new Error("No graphs to stitch");
+  const traceId = graphs[0].traceId ?? "";
+  const graphsBySpan = /* @__PURE__ */ new Map();
+  const childMap = /* @__PURE__ */ new Map();
+  let rootGraph = null;
+  for (const g of graphs) {
+    if (g.spanId) graphsBySpan.set(g.spanId, g);
+    if (!g.parentSpanId) {
+      if (!rootGraph || g.startTime < rootGraph.startTime) rootGraph = g;
     }
-    let graphStatus = "completed";
-    for (const node of nodes.values()) {
-      if (node.status === "failed" || node.status === "timeout" || node.status === "hung") {
-        graphStatus = "failed";
-        break;
-      }
-      if (node.status === "running") {
-        graphStatus = "running";
-      }
+    if (g.parentSpanId) {
+      const siblings = childMap.get(g.parentSpanId) ?? [];
+      if (g.spanId) siblings.push(g.spanId);
+      childMap.set(g.parentSpanId, siblings);
     }
-    const endTime = graphStatus === "running" ? null : Date.now();
-    const frozenNodes = new Map(
-      [...nodes.entries()].map(([id, mNode]) => [
-        id,
-        {
-          id: mNode.id,
-          type: mNode.type,
-          name: mNode.name,
-          startTime: mNode.startTime,
-          endTime: mNode.endTime,
-          status: mNode.status,
-          parentId: mNode.parentId,
-          children: [...mNode.children],
-          metadata: { ...mNode.metadata },
-          state: { ...mNode.state }
-        }
-      ])
-    );
-    const graph = {
-      id: graphId,
-      rootNodeId,
-      nodes: frozenNodes,
-      edges: [...edges],
-      startTime,
-      endTime,
-      status: graphStatus,
-      trigger,
-      agentId,
-      events: [...events],
-      traceId,
-      spanId,
-      parentSpanId
-    };
-    return deepFreeze(graph);
   }
-  const builder = {
-    get graphId() {
-      return graphId;
-    },
-    get traceContext() {
-      return { traceId, spanId };
-    },
-    startNode(opts) {
-      assertNotBuilt();
-      const id = generateId();
-      const parentId = opts.parentId ?? parentStack[parentStack.length - 1] ?? null;
-      if (parentId !== null && !nodes.has(parentId)) {
-        throw new Error(`GraphBuilder: parent node "${parentId}" does not exist`);
-      }
-      const node = {
-        id,
-        type: opts.type,
-        name: opts.name,
-        startTime: Date.now(),
-        endTime: null,
-        status: "running",
-        parentId,
-        children: [],
-        metadata: opts.metadata ? { ...opts.metadata } : {},
-        state: {}
-      };
-      nodes.set(id, node);
-      if (parentId !== null) {
-        const parent = nodes.get(parentId);
-        if (parent) {
-          parent.children.push(id);
-        }
-        edges.push({ from: parentId, to: id, type: "spawned" });
-      }
-      if (rootNodeId === null) {
-        rootNodeId = id;
-      }
-      recordEvent(id, "agent_start", { type: opts.type, name: opts.name });
-      return id;
-    },
-    endNode(nodeId, status = "completed") {
-      assertNotBuilt();
-      const node = getNode2(nodeId);
-      if (node.endTime !== null) {
-        throw new Error(
-          `GraphBuilder: node "${nodeId}" has already ended (status: ${node.status})`
-        );
-      }
-      node.endTime = Date.now();
-      node.status = status;
-      recordEvent(nodeId, "agent_end", { status });
-    },
-    failNode(nodeId, error) {
-      assertNotBuilt();
-      const node = getNode2(nodeId);
-      if (node.endTime !== null) {
-        throw new Error(
-          `GraphBuilder: node "${nodeId}" has already ended (status: ${node.status})`
-        );
-      }
-      const errorMessage = error instanceof Error ? error.message : error;
-      const errorStack = error instanceof Error ? error.stack : void 0;
-      node.endTime = Date.now();
-      node.status = "failed";
-      node.metadata.error = errorMessage;
-      if (errorStack) {
-        node.metadata.errorStack = errorStack;
-      }
-      recordEvent(nodeId, "tool_error", { error: errorMessage });
-    },
-    addEdge(from, to, type) {
-      assertNotBuilt();
-      getNode2(from);
-      getNode2(to);
-      edges.push({ from, to, type });
-      recordEvent(from, "custom", { to, type, action: "edge_add" });
-    },
-    pushEvent(event) {
-      assertNotBuilt();
-      getNode2(event.nodeId);
-      events.push({
-        ...event,
-        timestamp: Date.now()
-      });
-    },
-    updateState(nodeId, state) {
-      assertNotBuilt();
-      const node = getNode2(nodeId);
-      Object.assign(node.state, state);
-      recordEvent(nodeId, "custom", { action: "state_update", ...state });
-    },
-    withParent(parentId, fn) {
-      assertNotBuilt();
-      getNode2(parentId);
-      parentStack.push(parentId);
-      try {
-        return fn();
-      } finally {
-        parentStack.pop();
-      }
-    },
-    getSnapshot() {
-      return buildGraph();
-    },
-    build() {
-      assertNotBuilt();
-      const graph = buildGraph();
-      built = true;
-      return graph;
-    }
-  };
-  return builder;
-}
-// src/loader.ts
-function toNodesMap(raw) {
-  if (raw instanceof Map) return raw;
-  if (Array.isArray(raw)) {
-    return new Map(raw);
-  }
-  if (raw !== null && typeof raw === "object") {
-    return new Map(Object.entries(raw));
+  if (!rootGraph) rootGraph = graphs[0];
+  let status = "completed";
+  let endTime = 0;
+  let startTime = Infinity;
+  for (const g of graphs) {
+    startTime = Math.min(startTime, g.startTime);
+    if (g.status === "failed") status = "failed";
+    else if (g.status === "running" && status !== "failed") status = "running";
+    if (g.endTime === null) endTime = null;
+    else if (endTime !== null) endTime = Math.max(endTime, g.endTime);
   }
-  return /* @__PURE__ */ new Map();
-}
-function loadGraph(input) {
-  const raw = typeof input === "string" ? JSON.parse(input) : input;
-  const nodes = toNodesMap(raw.nodes);
-  return {
-    id: raw.id ?? "",
-    rootNodeId: raw.rootNodeId ?? raw.rootId ?? "",
-    nodes,
-    edges: raw.edges ?? [],
-    startTime: raw.startTime ?? 0,
-    endTime: raw.endTime ?? null,
-    status: raw.status ?? "completed",
-    trigger: raw.trigger ?? "unknown",
-    agentId: raw.agentId ?? "unknown",
-    events: raw.events ?? [],
-    traceId: raw.traceId,
-    spanId: raw.spanId,
-    parentSpanId: raw.parentSpanId
-  };
+  const frozenChildMap = /* @__PURE__ */ new Map();
+  for (const [k, v] of childMap) frozenChildMap.set(k, Object.freeze([...v]));
+  return Object.freeze({
+    traceId,
+    graphs: graphsBySpan,
+    rootGraph,
+    childMap: frozenChildMap,
+    startTime,
+    endTime,
+    status
+  });
 }
-function graphToJson(graph) {
-  const nodesObj = {};
-  for (const [id, node] of graph.nodes) {
-    nodesObj[id] = node;
+function getTraceTree(trace) {
+  const result = [];
+  function walk(spanId) {
+    const graph = trace.graphs.get(spanId);
+    if (graph) result.push(graph);
+    const children = trace.childMap.get(spanId) ?? [];
+    for (const childSpan of children) walk(childSpan);
   }
-  return {
-    id: graph.id,
-    rootNodeId: graph.rootNodeId,
-    nodes: nodesObj,
-    edges: graph.edges,
-    startTime: graph.startTime,
-    endTime: graph.endTime,
-    status: graph.status,
-    trigger: graph.trigger,
-    agentId: graph.agentId,
-    events: graph.events,
-    traceId: graph.traceId,
-    spanId: graph.spanId,
-    parentSpanId: graph.parentSpanId
-  };
+  if (trace.rootGraph.spanId) walk(trace.rootGraph.spanId);
+  else result.push(trace.rootGraph);
+  return result;
 }
-// src/runner.ts
-import { spawnSync } from "child_process";
-import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "fs";
+// src/live.ts
+import { existsSync, readdirSync, readFileSync, statSync, watch } from "fs";
 import { basename, join, resolve } from "path";
-function globToRegex(pattern) {
-  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
-  return new RegExp(`^${escaped}$`);
+var C = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[90m",
+  under: "\x1B[4m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  white: "\x1B[37m"
+};
+function parseArgs(argv) {
+  const config = { dirs: [], refreshMs: 3e3, recursive: false };
+  const args = argv.slice(0);
+  if (args[0] === "live") args.shift();
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      printUsage();
+      process.exit(0);
+    } else if (arg === "--refresh" || arg === "-r") {
+      i++;
+      const v = parseInt(args[i] ?? "", 10);
+      if (!isNaN(v) && v > 0) config.refreshMs = v * 1e3;
+      i++;
+    } else if (arg === "--recursive" || arg === "-R") {
+      config.recursive = true;
+      i++;
+    } else if (!arg.startsWith("-")) {
+      config.dirs.push(resolve(arg));
+      i++;
+    } else {
+      i++;
+    }
+  }
+  if (config.dirs.length === 0) config.dirs.push(resolve("."));
+  return config;
 }
-function snapshotDir(dir, patterns) {
-  const result = /* @__PURE__ */ new Map();
-  if (!existsSync(dir)) return result;
-  for (const entry of readdirSync(dir)) {
-    if (!patterns.some((re) => re.test(entry))) continue;
-    const full = join(dir, entry);
+function printUsage() {
+  console.log(
+    `
+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 directories.
+Usage:
+  agentflow live [dir...] [options]
+Arguments:
+  dir                     One or more directories to watch (default: .)
+Options:
+  -r, --refresh <secs>    Refresh interval in seconds (default: 3)
+  -R, --recursive         Scan subdirectories (1 level deep)
+  -h, --help              Show this help message
+Examples:
+  agentflow live ./data
+  agentflow live ./traces ./cron ./workers --refresh 5
+  agentflow live /var/lib/myagent -R
+`.trim()
+  );
+}
+function scanFiles(dirs, recursive) {
+  const results = [];
+  const seen = /* @__PURE__ */ new Set();
+  function scanDir(d, topLevel) {
     try {
-      const stat = statSync(full);
-      if (stat.isFile()) {
-        result.set(full, stat.mtimeMs);
+      for (const f of readdirSync(d)) {
+        if (f.startsWith(".")) continue;
+        const fp = join(d, f);
+        if (seen.has(fp)) continue;
+        let stat;
+        try {
+          stat = statSync(fp);
+        } catch {
+          continue;
+        }
+        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 {
     }
   }
-  return result;
+  for (const dir of dirs) scanDir(dir, true);
+  results.sort((a, b) => b.mtime - a.mtime);
+  return results;
 }
-function agentIdFromFilename(filePath) {
-  const base = basename(filePath, ".json");
-  const cleaned = base.replace(/-state$/, "");
-  return `alfred-${cleaned}`;
+function safeReadJson(fp) {
+  try {
+    return JSON.parse(readFileSync(fp, "utf8"));
+  } catch {
+    return null;
+  }
 }
-function deriveAgentId(command) {
-  return "orchestrator";
+function nameFromFile(filename) {
+  return basename(filename).replace(/\.(json|jsonl)$/, "").replace(/-state$/, "");
 }
-function fileTimestamp() {
-  return (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "");
+function normalizeStatus(val) {
+  if (typeof val !== "string") return "unknown";
+  const s = val.toLowerCase();
+  if (["ok", "success", "completed", "done", "passed", "healthy", "good"].includes(s)) return "ok";
+  if (["error", "failed", "failure", "crashed", "unhealthy", "bad", "timeout"].includes(s))
+    return "error";
+  if (["running", "active", "in_progress", "started", "pending", "processing"].includes(s))
+    return "running";
+  return "unknown";
 }
-async function runTraced(config) {
-  const {
-    command,
-    agentId = deriveAgentId(command),
-    trigger = "cli",
-    tracesDir = "./traces",
-    watchDirs = [],
-    watchPatterns = ["*.json"]
-  } = config;
-  if (command.length === 0) {
-    throw new Error("runTraced: command must not be empty");
-  }
-  const resolvedTracesDir = resolve(tracesDir);
-  const patterns = watchPatterns.map(globToRegex);
-  const orchestrator = createGraphBuilder({ agentId, trigger });
-  const { traceId, spanId } = orchestrator.traceContext;
-  const beforeSnapshots = /* @__PURE__ */ new Map();
-  for (const dir of watchDirs) {
-    beforeSnapshots.set(dir, snapshotDir(dir, patterns));
-  }
-  const rootId = orchestrator.startNode({ type: "agent", name: agentId });
-  const dispatchId = orchestrator.startNode({
-    type: "tool",
-    name: "dispatch-command",
-    parentId: rootId
-  });
-  orchestrator.updateState(dispatchId, { command: command.join(" ") });
-  const monitorId = orchestrator.startNode({
-    type: "tool",
-    name: "state-monitor",
-    parentId: rootId
-  });
-  orchestrator.updateState(monitorId, {
-    watchDirs,
-    watchPatterns
-  });
-  const startMs = Date.now();
-  const execCmd = command[0] ?? "";
-  const execArgs = command.slice(1);
-  process.env.AGENTFLOW_TRACE_ID = traceId;
-  process.env.AGENTFLOW_PARENT_SPAN_ID = spanId;
-  const result = spawnSync(execCmd, execArgs, { stdio: "inherit" });
-  delete process.env.AGENTFLOW_TRACE_ID;
-  delete process.env.AGENTFLOW_PARENT_SPAN_ID;
-  const exitCode = result.status ?? 1;
-  const duration = (Date.now() - startMs) / 1e3;
-  const stateChanges = [];
-  for (const dir of watchDirs) {
-    const before = beforeSnapshots.get(dir) ?? /* @__PURE__ */ new Map();
-    const after = snapshotDir(dir, patterns);
-    for (const [filePath, mtime] of after) {
-      const prevMtime = before.get(filePath);
-      if (prevMtime === void 0 || mtime > prevMtime) {
-        stateChanges.push(filePath);
+function findStatus(obj) {
+  for (const key of ["status", "state", "lastRunStatus", "lastStatus", "health", "result"]) {
+    if (key in obj) {
+      const val = obj[key];
+      if (typeof val === "string") return normalizeStatus(val);
+      if (typeof val === "object" && val !== null && "status" in val) {
+        return normalizeStatus(val.status);
       }
     }
   }
-  orchestrator.updateState(monitorId, { stateChanges });
-  orchestrator.endNode(monitorId);
-  if (exitCode === 0) {
-    orchestrator.endNode(dispatchId);
-  } else {
-    orchestrator.failNode(dispatchId, `Command exited with code ${exitCode}`);
-  }
-  orchestrator.updateState(rootId, {
-    exitCode,
-    duration,
-    stateChanges
-  });
-  if (exitCode === 0) {
-    orchestrator.endNode(rootId);
-  } else {
-    orchestrator.failNode(rootId, `Command exited with code ${exitCode}`);
-  }
-  const orchestratorGraph = orchestrator.build();
-  const allGraphs = [orchestratorGraph];
-  for (const filePath of stateChanges) {
-    const childAgentId = agentIdFromFilename(filePath);
-    const childBuilder = createGraphBuilder({
-      agentId: childAgentId,
-      trigger: "state-change",
-      traceId,
-      parentSpanId: spanId
-    });
-    const childRootId = childBuilder.startNode({
-      type: "agent",
-      name: childAgentId
-    });
-    childBuilder.updateState(childRootId, {
-      stateFile: filePath,
-      detectedBy: "runner-state-monitor"
-    });
-    childBuilder.endNode(childRootId);
-    allGraphs.push(childBuilder.build());
+  return "unknown";
+}
+function findTimestamp(obj) {
+  for (const key of [
+    "ts",
+    "timestamp",
+    "lastRunAtMs",
+    "last_run",
+    "lastExecution",
+    "updated_at",
+    "started_at",
+    "endTime",
+    "startTime"
+  ]) {
+    const val = obj[key];
+    if (typeof val === "number") return val > 1e12 ? val : val * 1e3;
+    if (typeof val === "string") {
+      const d = Date.parse(val);
+      if (!isNaN(d)) return d;
+    }
   }
-  if (!existsSync(resolvedTracesDir)) {
-    mkdirSync(resolvedTracesDir, { recursive: true });
+  return 0;
+}
+function extractDetail(obj) {
+  const parts = [];
+  for (const key of [
+    "summary",
+    "message",
+    "description",
+    "lastError",
+    "error",
+    "name",
+    "jobId",
+    "id"
+  ]) {
+    const val = obj[key];
+    if (typeof val === "string" && val.length > 0 && val.length < 200) {
+      parts.push(val.slice(0, 80));
+      break;
+    }
   }
-  const ts = fileTimestamp();
-  const tracePaths = [];
-  for (const graph of allGraphs) {
-    const filename = `${graph.agentId}-${ts}.json`;
-    const outPath = join(resolvedTracesDir, filename);
-    writeFileSync(outPath, JSON.stringify(graphToJson(graph), null, 2), "utf-8");
-    tracePaths.push(outPath);
+  for (const key of ["totalExecutions", "runs", "count", "processed", "consecutiveErrors"]) {
+    const val = obj[key];
+    if (typeof val === "number") {
+      parts.push(`${key}: ${val}`);
+      break;
+    }
   }
-  return {
-    exitCode,
-    traceId,
-    spanId,
-    tracePaths,
-    stateChanges,
-    duration
-  };
-}
-// src/graph-query.ts
-function getNode(graph, nodeId) {
-  return graph.nodes.get(nodeId);
+  return parts.join(" | ") || "";
 }
-function getChildren(graph, nodeId) {
-  const node = graph.nodes.get(nodeId);
-  if (!node) return [];
-  const result = [];
-  for (const childId of node.children) {
-    const child = graph.nodes.get(childId);
-    if (child) result.push(child);
+function tryLoadTrace(fp, raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const obj = raw;
+  if (!("nodes" in obj)) return null;
+  if (!("agentId" in obj) && !("rootNodeId" in obj) && !("rootId" in obj)) return null;
+  try {
+    return loadGraph(obj);
+  } catch {
+    return null;
   }
-  return result;
-}
-function getParent(graph, nodeId) {
-  const node = graph.nodes.get(nodeId);
-  if (!node || node.parentId === null) return void 0;
-  return graph.nodes.get(node.parentId);
-}
-function getFailures(graph) {
-  const failureStatuses = /* @__PURE__ */ new Set(["failed", "hung", "timeout"]);
-  return [...graph.nodes.values()].filter((node) => failureStatuses.has(node.status));
-}
-function getHungNodes(graph) {
-  return [...graph.nodes.values()].filter(
-    (node) => node.status === "running" && node.endTime === null
-  );
 }
-function getCriticalPath(graph) {
-  const root = graph.nodes.get(graph.rootNodeId);
-  if (!root) return [];
-  function nodeDuration(node) {
-    const end = node.endTime ?? Date.now();
-    return end - node.startTime;
+function processJsonFile(file) {
+  const raw = safeReadJson(file.path);
+  if (raw === null) return [];
+  const records = [];
+  const trace = tryLoadTrace(file.path, raw);
+  if (trace) {
+    try {
+      const fails = getFailures(trace);
+      const hung = getHungNodes(trace);
+      const stats = getStats(trace);
+      records.push({
+        id: trace.agentId,
+        source: "trace",
+        status: fails.length === 0 && hung.length === 0 ? "ok" : "error",
+        lastActive: file.mtime,
+        detail: `${stats.totalNodes} nodes [${trace.trigger}]`,
+        file: file.filename,
+        traceData: trace
+      });
+    } catch {
+    }
+    return records;
   }
-  function dfs(node) {
-    if (node.children.length === 0) {
-      return { duration: nodeDuration(node), path: [node] };
+  if (typeof raw !== "object") return records;
+  const arr = Array.isArray(raw) ? raw : Array.isArray(raw.jobs) ? raw.jobs : Array.isArray(raw.tasks) ? raw.tasks : Array.isArray(raw.items) ? raw.items : null;
+  if (arr && arr.length > 0 && typeof arr[0] === "object" && arr[0] !== null) {
+    for (const item of arr.slice(0, 50)) {
+      const name = item.name ?? item.id ?? item.jobId ?? item.agentId;
+      if (!name) continue;
+      const state = typeof item.state === "object" && item.state !== null ? item.state : item;
+      const status2 = findStatus(state);
+      const ts2 = findTimestamp(state) || file.mtime;
+      const detail2 = extractDetail(state);
+      records.push({
+        id: String(name),
+        source: "jobs",
+        status: status2,
+        lastActive: ts2,
+        detail: detail2,
+        file: file.filename
+      });
     }
-    let bestChild = { duration: -1, path: [] };
-    for (const childId of node.children) {
-      const child = graph.nodes.get(childId);
-      if (!child) continue;
-      const result = dfs(child);
-      if (result.duration > bestChild.duration) {
-        bestChild = result;
+    return records;
+  }
+  const obj = raw;
+  for (const containerKey of ["tools", "workers", "services", "agents", "daemons"]) {
+    const container = obj[containerKey];
+    if (typeof container === "object" && container !== null && !Array.isArray(container)) {
+      for (const [name, info] of Object.entries(container)) {
+        if (typeof info !== "object" || info === null) continue;
+        const w = info;
+        const status2 = findStatus(w);
+        const ts2 = findTimestamp(w) || findTimestamp(obj) || file.mtime;
+        const pid = w.pid;
+        const detail2 = pid ? `pid: ${pid}` : extractDetail(w);
+        records.push({
+          id: name,
+          source: "workers",
+          status: status2,
+          lastActive: ts2,
+          detail: detail2,
+          file: file.filename
+        });
       }
+      return records;
     }
-    return {
-      duration: nodeDuration(node) + bestChild.duration,
-      path: [node, ...bestChild.path]
-    };
   }
-  return dfs(root).path;
+  const status = findStatus(obj);
+  const ts = findTimestamp(obj) || file.mtime;
+  const detail = extractDetail(obj);
+  records.push({
+    id: nameFromFile(file.filename),
+    source: "state",
+    status,
+    lastActive: ts,
+    detail,
+    file: file.filename
+  });
+  return records;
 }
-function findWaitingOn(graph, nodeId) {
-  const results = [];
-  for (const edge of graph.edges) {
-    if (edge.from === nodeId && edge.type === "waited_on") {
-      const node = graph.nodes.get(edge.to);
-      if (node) results.push(node);
+function processJsonlFile(file) {
+  try {
+    const content = readFileSync(file.path, "utf8").trim();
+    if (!content) return [];
+    const lines = content.split("\n");
+    const lineCount = lines.length;
+    const lastObj = JSON.parse(lines[lines.length - 1]);
+    const name = lastObj.jobId ?? lastObj.agentId ?? lastObj.name ?? lastObj.id ?? nameFromFile(file.filename);
+    if (lastObj.action !== void 0 || lastObj.jobId !== void 0) {
+      const status2 = findStatus(lastObj);
+      const ts2 = findTimestamp(lastObj) || file.mtime;
+      const action = lastObj.action;
+      const detail2 = action ? `${action} (${lineCount} entries)` : `${lineCount} entries`;
+      return [
+        {
+          id: String(name),
+          source: "session",
+          status: status2,
+          lastActive: ts2,
+          detail: detail2,
+          file: file.filename
+        }
+      ];
     }
-  }
-  return results;
-}
-function getSubtree(graph, nodeId) {
-  const startNode = graph.nodes.get(nodeId);
-  if (!startNode) return [];
-  const result = [];
-  const queue = [...startNode.children];
-  while (queue.length > 0) {
-    const currentId = queue.shift();
-    if (currentId === void 0) break;
-    const current = graph.nodes.get(currentId);
-    if (!current) continue;
-    result.push(current);
-    queue.push(...current.children);
-  }
-  return result;
-}
-function getDuration(graph) {
-  const end = graph.endTime ?? Date.now();
-  return end - graph.startTime;
-}
-function getDepth(graph) {
-  const root = graph.nodes.get(graph.rootNodeId);
-  if (!root) return -1;
-  function dfs(node, depth) {
-    if (node.children.length === 0) return depth;
-    let maxDepth = depth;
-    for (const childId of node.children) {
-      const child = graph.nodes.get(childId);
-      if (!child) continue;
-      const childDepth = dfs(child, depth + 1);
-      if (childDepth > maxDepth) maxDepth = childDepth;
+    const tail = lines.slice(Math.max(0, lineCount - 30));
+    let model = "";
+    let totalTokens = 0;
+    let totalCost = 0;
+    const toolCalls = [];
+    let lastUserMsg = "";
+    let lastAssistantMsg = "";
+    let errorCount = 0;
+    let lastRole = "";
+    let sessionId = "";
+    for (const line of tail) {
+      let entry;
+      try {
+        entry = JSON.parse(line);
+      } catch {
+        continue;
+      }
+      const entryType = entry.type;
+      if (entryType === "session") {
+        sessionId = entry.id ?? "";
+        continue;
+      }
+      if (entryType === "model_change") {
+        model = entry.modelId ?? "";
+        continue;
+      }
+      if (entryType !== "message") continue;
+      const msg = entry.message;
+      if (!msg) continue;
+      const role = msg.role;
+      lastRole = role;
+      if (msg.model && !model) model = msg.model;
+      const usage = msg.usage;
+      if (usage) {
+        const input = usage.input ?? 0;
+        const output = usage.output ?? 0;
+        totalTokens += input + output;
+        const cost = usage.cost;
+        if (cost && typeof cost.total === "number") totalCost += cost.total;
+      }
+      const msgContent = msg.content;
+      if (role === "user") {
+        if (typeof msgContent === "string") {
+          lastUserMsg = msgContent.slice(0, 80);
+        } else if (Array.isArray(msgContent)) {
+          for (const c of msgContent) {
+            if (c.type === "text" && typeof c.text === "string") {
+              lastUserMsg = c.text.slice(0, 80);
+              break;
+            }
+          }
+        }
+      }
+      if (role === "assistant" && Array.isArray(msgContent)) {
+        for (const c of msgContent) {
+          if (c.type === "tool_use" || c.type === "toolCall") {
+            const toolName = c.name ?? "";
+            if (toolName && !toolCalls.includes(toolName)) toolCalls.push(toolName);
+          }
+          if (c.type === "text" && typeof c.text === "string" && c.text.length > 5) {
+            lastAssistantMsg = c.text.slice(0, 80);
+          }
+        }
+      }
+      if (role === "toolResult") {
+        if (typeof msgContent === "string" && /error|ENOENT|failed|exception/i.test(msgContent)) {
+          errorCount++;
+        } else if (Array.isArray(msgContent)) {
+          for (const c of msgContent) {
+            if (typeof c.text === "string" && /error|ENOENT|failed|exception/i.test(c.text)) {
+              errorCount++;
+            }
+          }
+        }
+      }
     }
-    return maxDepth;
-  }
-  return dfs(root, 0);
-}
-function getStats(graph) {
-  const byStatus = {
-    running: 0,
-    completed: 0,
-    failed: 0,
-    hung: 0,
-    timeout: 0
-  };
-  const byType = {
-    agent: 0,
-    tool: 0,
-    subagent: 0,
-    wait: 0,
-    decision: 0,
-    custom: 0
-  };
-  let failureCount = 0;
-  let hungCount = 0;
-  for (const node of graph.nodes.values()) {
-    byStatus[node.status]++;
-    byType[node.type]++;
-    if (node.status === "failed" || node.status === "timeout" || node.status === "hung") {
-      failureCount++;
+    const parts = [];
+    if (model) {
+      const shortModel = model.includes("/") ? model.split("/").pop() : model;
+      parts.push(shortModel.slice(0, 20));
     }
-    if (node.status === "running" && node.endTime === null) {
-      hungCount++;
+    if (toolCalls.length > 0) {
+      const recent = toolCalls.slice(-3);
+      parts.push(`tools: ${recent.join(", ")}`);
     }
+    if (totalCost > 0) {
+      parts.push(`$${totalCost.toFixed(3)}`);
+    } else if (totalTokens > 0) {
+      const k = (totalTokens / 1e3).toFixed(1);
+      parts.push(`${k}k tok`);
+    }
+    if (lastAssistantMsg && lastRole === "assistant") {
+      parts.push(lastAssistantMsg.slice(0, 40));
+    } else if (lastUserMsg && !parts.some((p) => p.startsWith("tools:"))) {
+      parts.push(`user: ${lastUserMsg.slice(0, 35)}`);
+    }
+    if (errorCount > 0) {
+      parts.push(`${errorCount} errors`);
+    }
+    const detail = parts.join(" | ") || `${lineCount} messages`;
+    const status = errorCount > lineCount / 4 ? "error" : lastRole === "assistant" ? "ok" : "running";
+    const ts = findTimestamp(lastObj) || file.mtime;
+    const sessionName = sessionId ? sessionId.slice(0, 8) : nameFromFile(file.filename);
+    return [
+      {
+        id: String(name !== "unknown" ? name : sessionName),
+        source: "session",
+        status,
+        lastActive: ts,
+        detail,
+        file: file.filename
+      }
+    ];
+  } catch {
+    return [];
   }
-  return {
-    totalNodes: graph.nodes.size,
-    byStatus,
-    byType,
-    depth: getDepth(graph),
-    duration: getDuration(graph),
-    failureCount,
-    hungCount
-  };
 }
-// src/graph-stitch.ts
-function groupByTraceId(graphs) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const g of graphs) {
-    if (!g.traceId) continue;
-    const arr = groups.get(g.traceId) ?? [];
-    arr.push(g);
-    groups.set(g.traceId, arr);
-  }
-  return groups;
+var K = "\x1B[K";
+function writeLine(lines, text) {
+  lines.push(text + K);
 }
-function stitchTrace(graphs) {
-  if (graphs.length === 0) throw new Error("No graphs to stitch");
-  const traceId = graphs[0].traceId ?? "";
-  const graphsBySpan = /* @__PURE__ */ new Map();
-  const childMap = /* @__PURE__ */ new Map();
-  let rootGraph = null;
-  for (const g of graphs) {
-    if (g.spanId) graphsBySpan.set(g.spanId, g);
-    if (!g.parentSpanId) {
-      if (!rootGraph || g.startTime < rootGraph.startTime) rootGraph = g;
-    }
-    if (g.parentSpanId) {
-      const siblings = childMap.get(g.parentSpanId) ?? [];
-      if (g.spanId) siblings.push(g.spanId);
-      childMap.set(g.parentSpanId, siblings);
-    }
+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.dirs, config.recursive);
+  if (files.length > prevFileCount && prevFileCount > 0) {
+    newExecCount += files.length - prevFileCount;
   }
-  if (!rootGraph) rootGraph = graphs[0];
-  let status = "completed";
-  let endTime = 0;
-  let startTime = Infinity;
-  for (const g of graphs) {
-    startTime = Math.min(startTime, g.startTime);
-    if (g.status === "failed") status = "failed";
-    else if (g.status === "running" && status !== "failed") status = "running";
-    if (g.endTime === null) endTime = null;
-    else if (endTime !== null) endTime = Math.max(endTime, g.endTime);
+  prevFileCount = files.length;
+  const allRecords = [];
+  const allTraces = [];
+  for (const f of files.slice(0, 300)) {
+    const records = f.ext === ".jsonl" ? processJsonlFile(f) : processJsonFile(f);
+    for (const r of records) {
+      allRecords.push(r);
+      if (r.traceData) allTraces.push(r.traceData);
+    }
   }
-  const frozenChildMap = /* @__PURE__ */ new Map();
-  for (const [k, v] of childMap) frozenChildMap.set(k, Object.freeze([...v]));
-  return Object.freeze({
-    traceId,
-    graphs: graphsBySpan,
-    rootGraph,
-    childMap: frozenChildMap,
-    startTime,
-    endTime,
-    status
-  });
-}
-function getTraceTree(trace) {
-  const result = [];
-  function walk(spanId) {
-    const graph = trace.graphs.get(spanId);
-    if (graph) result.push(graph);
-    const children = trace.childMap.get(spanId) ?? [];
-    for (const childSpan of children) walk(childSpan);
+  const byFile = /* @__PURE__ */ new Map();
+  for (const r of allRecords) {
+    const arr = byFile.get(r.file) ?? [];
+    arr.push(r);
+    byFile.set(r.file, arr);
   }
-  if (trace.rootGraph.spanId) walk(trace.rootGraph.spanId);
-  else result.push(trace.rootGraph);
-  return result;
-}
-// src/live.ts
-import { readdirSync as readdirSync2, readFileSync, statSync as statSync2, watch, existsSync as existsSync2 } from "fs";
-import { join as join2, resolve as resolve2, basename as basename2 } from "path";
-var C = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  dim: "\x1B[90m",
-  under: "\x1B[4m",
-  red: "\x1B[31m",
-  green: "\x1B[32m",
-  yellow: "\x1B[33m",
-  blue: "\x1B[34m",
-  magenta: "\x1B[35m",
-  cyan: "\x1B[36m",
-  white: "\x1B[37m"
-};
-function parseArgs(argv) {
-  const config = { dirs: [], refreshMs: 3e3, recursive: false };
-  const args = argv.slice(0);
-  if (args[0] === "live") args.shift();
-  let i = 0;
-  while (i < args.length) {
-    const arg = args[i];
-    if (arg === "--help" || arg === "-h") {
-      printUsage();
-      process.exit(0);
-    } else if (arg === "--refresh" || arg === "-r") {
-      i++;
-      const v = parseInt(args[i] ?? "", 10);
-      if (!isNaN(v) && v > 0) config.refreshMs = v * 1e3;
-      i++;
-    } else if (arg === "--recursive" || arg === "-R") {
-      config.recursive = true;
-      i++;
-    } else if (!arg.startsWith("-")) {
-      config.dirs.push(resolve2(arg));
-      i++;
+  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 {
-      i++;
+      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
+      });
     }
   }
-  if (config.dirs.length === 0) config.dirs.push(resolve2("."));
-  return config;
-}
-function printUsage() {
-  console.log(`
-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 directories.
-Usage:
-  agentflow live [dir...] [options]
-Arguments:
-  dir                     One or more directories to watch (default: .)
-Options:
-  -r, --refresh <secs>    Refresh interval in seconds (default: 3)
-  -R, --recursive         Scan subdirectories (1 level deep)
-  -h, --help              Show this help message
-Examples:
-  agentflow live ./data
-  agentflow live ./traces ./cron ./workers --refresh 5
-  agentflow live /var/lib/myagent -R
-`.trim());
-}
-function scanFiles(dirs, recursive) {
-  const results = [];
-  const seen = /* @__PURE__ */ new Set();
-  function scanDir(d, topLevel) {
-    try {
-      for (const f of readdirSync2(d)) {
-        if (f.startsWith(".")) continue;
-        const fp = join2(d, f);
-        if (seen.has(fp)) continue;
-        let stat;
+  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);
+  const failBuckets = new Array(12).fill(0);
+  for (const r of allRecords) {
+    const age = now - r.lastActive;
+    if (age > 36e5 || age < 0) continue;
+    const idx = 11 - Math.floor(age / 3e5);
+    if (idx >= 0 && idx < 12) {
+      buckets[idx]++;
+      if (r.status === "error") failBuckets[idx]++;
+    }
+  }
+  const maxBucket = Math.max(...buckets, 1);
+  const sparkChars = " \u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
+  const spark = buckets.map((v, i) => {
+    const level = Math.round(v / maxBucket * 8);
+    return (failBuckets[i] > 0 ? C.red : C.green) + sparkChars[level] + C.reset;
+  }).join("");
+  const distributedTraces = [];
+  if (allTraces.length > 1) {
+    const traceGroups = groupByTraceId(allTraces);
+    for (const [_tid, graphs] of traceGroups) {
+      if (graphs.length > 1) {
         try {
-          stat = statSync2(fp);
+          distributedTraces.push(stitchTrace(graphs));
         } catch {
-          continue;
-        }
-        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 {
     }
+    distributedTraces.sort((a, b) => b.startTime - a.startTime);
   }
-  for (const dir of dirs) scanDir(dir, true);
-  results.sort((a, b) => b.mtime - a.mtime);
-  return results;
-}
-function safeReadJson(fp) {
-  try {
-    return JSON.parse(readFileSync(fp, "utf8"));
-  } catch {
-    return null;
+  const upSec = Math.floor((Date.now() - sessionStart) / 1e3);
+  const upMin = Math.floor(upSec / 60);
+  const upStr = upMin > 0 ? `${upMin}m ${upSec % 60}s` : `${upSec}s`;
+  const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+  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 nameFromFile(filename) {
-  return basename2(filename).replace(/\.(json|jsonl)$/, "").replace(/-state$/, "");
-}
-function normalizeStatus(val) {
-  if (typeof val !== "string") return "unknown";
-  const s = val.toLowerCase();
-  if (["ok", "success", "completed", "done", "passed", "healthy", "good"].includes(s)) return "ok";
-  if (["error", "failed", "failure", "crashed", "unhealthy", "bad", "timeout"].includes(s)) return "error";
-  if (["running", "active", "in_progress", "started", "pending", "processing"].includes(s)) return "running";
-  return "unknown";
-}
-function findStatus(obj) {
-  for (const key of ["status", "state", "lastRunStatus", "lastStatus", "health", "result"]) {
-    if (key in obj) {
-      const val = obj[key];
-      if (typeof val === "string") return normalizeStatus(val);
-      if (typeof val === "object" && val !== null && "status" in val) {
-        return normalizeStatus(val.status);
+  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}`;
+      case "jobs":
+        return `${C.blue}job${C.reset}`;
+      case "workers":
+        return `${C.magenta}worker${C.reset}`;
+      case "session":
+        return `${C.yellow}session${C.reset}`;
+      case "state":
+        return `${C.dim}state${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;
+  }
+  const termWidth = process.stdout.columns || 120;
+  const detailWidth = Math.max(20, termWidth - 60);
+  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);
+  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;
+  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, detailWidth);
+      writeLine(
+        L,
+        `  ${icon} ${name}  ${st.padEnd(20)}  ${active.padEnd(20)}  ${C.dim}${det}${C.reset}`
+      );
+      lineCount++;
+    } else {
+      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, detailWidth - 5);
+        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++;
       }
     }
   }
-  return "unknown";
+  if (distributedTraces.length > 0) {
+    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 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);
+      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 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 = 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, 6);
+  if (recentRecords.length > 0) {
+    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 = 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 det = truncate(r.detail, detailWidth);
+      writeLine(
+        L,
+        `  ${icon}  ${agent} ${C.dim}${t}  ${ageStr.padStart(8)}${C.reset}  ${C.dim}${det}${C.reset}`
+      );
+    }
+  }
+  if (files.length === 0) {
+    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}`);
+  }
+  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 findTimestamp(obj) {
-  for (const key of ["ts", "timestamp", "lastRunAtMs", "last_run", "lastExecution", "updated_at", "started_at", "endTime", "startTime"]) {
-    const val = obj[key];
-    if (typeof val === "number") return val > 1e12 ? val : val * 1e3;
-    if (typeof val === "string") {
-      const d = Date.parse(val);
-      if (!isNaN(d)) return d;
+function getDistDepth(dt, spanId) {
+  if (!spanId) return 0;
+  const g = dt.graphs.get(spanId);
+  if (!g || !g.parentSpanId) return 0;
+  return 1 + getDistDepth(dt, g.parentSpanId);
+}
+function startLive(argv) {
+  const config = parseArgs(argv);
+  const valid = config.dirs.filter((d) => 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) => !existsSync(d));
+  if (invalid.length > 0) {
+    console.warn(`Skipping non-existent: ${invalid.join(", ")}`);
+  }
+  config.dirs = valid;
+  render(config);
+  let debounce = null;
+  for (const dir of config.dirs) {
+    try {
+      watch(dir, { recursive: config.recursive }, () => {
+        if (debounce) clearTimeout(debounce);
+        debounce = setTimeout(() => render(config), 500);
+      });
+    } catch {
     }
   }
-  return 0;
+  setInterval(() => render(config), config.refreshMs);
+  process.on("SIGINT", () => {
+    console.log("\n" + C.dim + "Monitor stopped." + C.reset);
+    process.exit(0);
+  });
 }
-function extractDetail(obj) {
-  const parts = [];
-  for (const key of ["summary", "message", "description", "lastError", "error", "name", "jobId", "id"]) {
-    const val = obj[key];
-    if (typeof val === "string" && val.length > 0 && val.length < 200) {
-      parts.push(val.slice(0, 80));
-      break;
+// src/graph-builder.ts
+import { randomUUID } from "crypto";
+function deepFreeze(obj) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (obj instanceof Map) {
+    Object.freeze(obj);
+    for (const value of obj.values()) {
+      deepFreeze(value);
     }
+    return obj;
   }
-  for (const key of ["totalExecutions", "runs", "count", "processed", "consecutiveErrors"]) {
-    const val = obj[key];
-    if (typeof val === "number") {
-      parts.push(`${key}: ${val}`);
-      break;
+  Object.freeze(obj);
+  const record = obj;
+  for (const key of Object.keys(record)) {
+    const value = record[key];
+    if (value !== null && typeof value === "object" && !Object.isFrozen(value)) {
+      deepFreeze(value);
     }
   }
-  return parts.join(" | ") || "";
+  return obj;
 }
-function tryLoadTrace(fp, raw) {
-  if (typeof raw !== "object" || raw === null) return null;
-  const obj = raw;
-  if (!("nodes" in obj)) return null;
-  if (!("agentId" in obj) && !("rootNodeId" in obj) && !("rootId" in obj)) return null;
-  try {
-    return loadGraph(obj);
-  } catch {
-    return null;
-  }
+function createCounterIdGenerator() {
+  let counter = 0;
+  return () => {
+    counter++;
+    return `node_${String(counter).padStart(3, "0")}`;
+  };
 }
-function processJsonFile(file) {
-  const raw = safeReadJson(file.path);
-  if (raw === null) return [];
-  const records = [];
-  const trace = tryLoadTrace(file.path, raw);
-  if (trace) {
-    try {
-      const fails = getFailures(trace);
-      const hung = getHungNodes(trace);
-      const stats = getStats(trace);
-      records.push({
-        id: trace.agentId,
-        source: "trace",
-        status: fails.length === 0 && hung.length === 0 ? "ok" : "error",
-        lastActive: file.mtime,
-        detail: `${stats.totalNodes} nodes [${trace.trigger}]`,
-        file: file.filename,
-        traceData: trace
-      });
-    } catch {
+function createGraphBuilder(config) {
+  const generateId = config?.idGenerator ?? createCounterIdGenerator();
+  const agentId = config?.agentId ?? "unknown";
+  const trigger = config?.trigger ?? "manual";
+  const spanId = randomUUID();
+  const traceId = config?.traceId ?? (typeof process !== "undefined" ? process.env?.AGENTFLOW_TRACE_ID : void 0) ?? randomUUID();
+  const parentSpanId = config?.parentSpanId ?? (typeof process !== "undefined" ? process.env?.AGENTFLOW_PARENT_SPAN_ID : void 0) ?? null;
+  const graphId = generateId();
+  const startTime = Date.now();
+  const nodes = /* @__PURE__ */ new Map();
+  const edges = [];
+  const events = [];
+  const parentStack = [];
+  let rootNodeId = null;
+  let built = false;
+  function assertNotBuilt() {
+    if (built) {
+      throw new Error("GraphBuilder: cannot mutate after build() has been called");
     }
-    return records;
   }
-  if (typeof raw !== "object") return records;
-  const arr = Array.isArray(raw) ? raw : Array.isArray(raw.jobs) ? raw.jobs : Array.isArray(raw.tasks) ? raw.tasks : Array.isArray(raw.items) ? raw.items : null;
-  if (arr && arr.length > 0 && typeof arr[0] === "object" && arr[0] !== null) {
-    for (const item of arr.slice(0, 50)) {
-      const name = item.name ?? item.id ?? item.jobId ?? item.agentId;
-      if (!name) continue;
-      const state = typeof item.state === "object" && item.state !== null ? item.state : item;
-      const status2 = findStatus(state);
-      const ts2 = findTimestamp(state) || file.mtime;
-      const detail2 = extractDetail(state);
-      records.push({ id: String(name), source: "jobs", status: status2, lastActive: ts2, detail: detail2, file: file.filename });
+  function getNode2(nodeId) {
+    const node = nodes.get(nodeId);
+    if (!node) {
+      throw new Error(`GraphBuilder: node "${nodeId}" does not exist`);
     }
-    return records;
+    return node;
   }
-  const obj = raw;
-  for (const containerKey of ["tools", "workers", "services", "agents", "daemons"]) {
-    const container = obj[containerKey];
-    if (typeof container === "object" && container !== null && !Array.isArray(container)) {
-      for (const [name, info] of Object.entries(container)) {
-        if (typeof info !== "object" || info === null) continue;
-        const w = info;
-        const status2 = findStatus(w);
-        const ts2 = findTimestamp(w) || findTimestamp(obj) || file.mtime;
-        const pid = w.pid;
-        const detail2 = pid ? `pid: ${pid}` : extractDetail(w);
-        records.push({ id: name, source: "workers", status: status2, lastActive: ts2, detail: detail2, file: file.filename });
+  function recordEvent(nodeId, eventType, data = {}) {
+    events.push({
+      timestamp: Date.now(),
+      eventType,
+      nodeId,
+      data
+    });
+  }
+  function buildGraph() {
+    if (rootNodeId === null) {
+      throw new Error("GraphBuilder: cannot build a graph with no nodes");
+    }
+    let graphStatus = "completed";
+    for (const node of nodes.values()) {
+      if (node.status === "failed" || node.status === "timeout" || node.status === "hung") {
+        graphStatus = "failed";
+        break;
+      }
+      if (node.status === "running") {
+        graphStatus = "running";
       }
-      return records;
     }
+    const endTime = graphStatus === "running" ? null : Date.now();
+    const frozenNodes = new Map(
+      [...nodes.entries()].map(([id, mNode]) => [
+        id,
+        {
+          id: mNode.id,
+          type: mNode.type,
+          name: mNode.name,
+          startTime: mNode.startTime,
+          endTime: mNode.endTime,
+          status: mNode.status,
+          parentId: mNode.parentId,
+          children: [...mNode.children],
+          metadata: { ...mNode.metadata },
+          state: { ...mNode.state }
+        }
+      ])
+    );
+    const graph = {
+      id: graphId,
+      rootNodeId,
+      nodes: frozenNodes,
+      edges: [...edges],
+      startTime,
+      endTime,
+      status: graphStatus,
+      trigger,
+      agentId,
+      events: [...events],
+      traceId,
+      spanId,
+      parentSpanId
+    };
+    return deepFreeze(graph);
   }
-  const status = findStatus(obj);
-  const ts = findTimestamp(obj) || file.mtime;
-  const detail = extractDetail(obj);
-  records.push({ id: nameFromFile(file.filename), source: "state", status, lastActive: ts, detail, file: file.filename });
-  return records;
-}
-function processJsonlFile(file) {
-  try {
-    const content = readFileSync(file.path, "utf8").trim();
-    if (!content) return [];
-    const lines = content.split("\n");
-    const lineCount = lines.length;
-    const lastObj = JSON.parse(lines[lines.length - 1]);
-    const name = lastObj.jobId ?? lastObj.agentId ?? lastObj.name ?? lastObj.id ?? nameFromFile(file.filename);
-    if (lastObj.action !== void 0 || lastObj.jobId !== void 0) {
-      const status2 = findStatus(lastObj);
-      const ts2 = findTimestamp(lastObj) || file.mtime;
-      const action = lastObj.action;
-      const detail2 = action ? `${action} (${lineCount} entries)` : `${lineCount} entries`;
-      return [{ id: String(name), source: "session", status: status2, lastActive: ts2, detail: detail2, file: file.filename }];
-    }
-    const tail = lines.slice(Math.max(0, lineCount - 30));
-    let model = "";
-    let totalTokens = 0;
-    let totalCost = 0;
-    let toolCalls = [];
-    let lastUserMsg = "";
-    let lastAssistantMsg = "";
-    let errorCount = 0;
-    let lastRole = "";
-    let sessionId = "";
-    for (const line of tail) {
-      let entry;
-      try {
-        entry = JSON.parse(line);
-      } catch {
-        continue;
+  const builder = {
+    get graphId() {
+      return graphId;
+    },
+    get traceContext() {
+      return { traceId, spanId };
+    },
+    startNode(opts) {
+      assertNotBuilt();
+      const id = generateId();
+      const parentId = opts.parentId ?? parentStack[parentStack.length - 1] ?? null;
+      if (parentId !== null && !nodes.has(parentId)) {
+        throw new Error(`GraphBuilder: parent node "${parentId}" does not exist`);
       }
-      const entryType = entry.type;
-      if (entryType === "session") {
-        sessionId = entry.id ?? "";
-        continue;
+      const node = {
+        id,
+        type: opts.type,
+        name: opts.name,
+        startTime: Date.now(),
+        endTime: null,
+        status: "running",
+        parentId,
+        children: [],
+        metadata: opts.metadata ? { ...opts.metadata } : {},
+        state: {}
+      };
+      nodes.set(id, node);
+      if (parentId !== null) {
+        const parent = nodes.get(parentId);
+        if (parent) {
+          parent.children.push(id);
+        }
+        edges.push({ from: parentId, to: id, type: "spawned" });
       }
-      if (entryType === "model_change") {
-        model = entry.modelId ?? "";
-        continue;
+      if (rootNodeId === null) {
+        rootNodeId = id;
       }
-      if (entryType !== "message") continue;
-      const msg = entry.message;
-      if (!msg) continue;
-      const role = msg.role;
-      lastRole = role;
-      if (msg.model && !model) model = msg.model;
-      const usage = msg.usage;
-      if (usage) {
-        const input = usage.input ?? 0;
-        const output = usage.output ?? 0;
-        totalTokens += input + output;
-        const cost = usage.cost;
-        if (cost && typeof cost.total === "number") totalCost += cost.total;
+      recordEvent(id, "agent_start", { type: opts.type, name: opts.name });
+      return id;
+    },
+    endNode(nodeId, status = "completed") {
+      assertNotBuilt();
+      const node = getNode2(nodeId);
+      if (node.endTime !== null) {
+        throw new Error(
+          `GraphBuilder: node "${nodeId}" has already ended (status: ${node.status})`
+        );
       }
-      const msgContent = msg.content;
-      if (role === "user") {
-        if (typeof msgContent === "string") {
-          lastUserMsg = msgContent.slice(0, 80);
-        } else if (Array.isArray(msgContent)) {
-          for (const c of msgContent) {
-            if (c.type === "text" && typeof c.text === "string") {
-              lastUserMsg = c.text.slice(0, 80);
-              break;
-            }
-          }
-        }
+      node.endTime = Date.now();
+      node.status = status;
+      recordEvent(nodeId, "agent_end", { status });
+    },
+    failNode(nodeId, error) {
+      assertNotBuilt();
+      const node = getNode2(nodeId);
+      if (node.endTime !== null) {
+        throw new Error(
+          `GraphBuilder: node "${nodeId}" has already ended (status: ${node.status})`
+        );
       }
-      if (role === "assistant" && Array.isArray(msgContent)) {
-        for (const c of msgContent) {
-          if (c.type === "tool_use" || c.type === "toolCall") {
-            const toolName = c.name ?? "";
-            if (toolName && !toolCalls.includes(toolName)) toolCalls.push(toolName);
-          }
-          if (c.type === "text" && typeof c.text === "string" && c.text.length > 5) {
-            lastAssistantMsg = c.text.slice(0, 80);
-          }
-        }
+      const errorMessage = error instanceof Error ? error.message : error;
+      const errorStack = error instanceof Error ? error.stack : void 0;
+      node.endTime = Date.now();
+      node.status = "failed";
+      node.metadata.error = errorMessage;
+      if (errorStack) {
+        node.metadata.errorStack = errorStack;
       }
-      if (role === "toolResult") {
-        if (typeof msgContent === "string" && /error|ENOENT|failed|exception/i.test(msgContent)) {
-          errorCount++;
-        } else if (Array.isArray(msgContent)) {
-          for (const c of msgContent) {
-            if (typeof c.text === "string" && /error|ENOENT|failed|exception/i.test(c.text)) {
-              errorCount++;
-            }
-          }
-        }
+      recordEvent(nodeId, "tool_error", { error: errorMessage });
+    },
+    addEdge(from, to, type) {
+      assertNotBuilt();
+      getNode2(from);
+      getNode2(to);
+      edges.push({ from, to, type });
+      recordEvent(from, "custom", { to, type, action: "edge_add" });
+    },
+    pushEvent(event) {
+      assertNotBuilt();
+      getNode2(event.nodeId);
+      events.push({
+        ...event,
+        timestamp: Date.now()
+      });
+    },
+    updateState(nodeId, state) {
+      assertNotBuilt();
+      const node = getNode2(nodeId);
+      Object.assign(node.state, state);
+      recordEvent(nodeId, "custom", { action: "state_update", ...state });
+    },
+    withParent(parentId, fn) {
+      assertNotBuilt();
+      getNode2(parentId);
+      parentStack.push(parentId);
+      try {
+        return fn();
+      } finally {
+        parentStack.pop();
       }
+    },
+    getSnapshot() {
+      return buildGraph();
+    },
+    build() {
+      assertNotBuilt();
+      const graph = buildGraph();
+      built = true;
+      return graph;
     }
-    const parts = [];
-    if (model) {
-      const shortModel = model.includes("/") ? model.split("/").pop() : model;
-      parts.push(shortModel.slice(0, 20));
-    }
-    if (toolCalls.length > 0) {
-      const recent = toolCalls.slice(-3);
-      parts.push(`tools: ${recent.join(", ")}`);
-    }
-    if (totalCost > 0) {
-      parts.push(`$${totalCost.toFixed(3)}`);
-    } else if (totalTokens > 0) {
-      const k = (totalTokens / 1e3).toFixed(1);
-      parts.push(`${k}k tok`);
-    }
-    if (lastAssistantMsg && lastRole === "assistant") {
-      parts.push(lastAssistantMsg.slice(0, 40));
-    } else if (lastUserMsg && !parts.some((p) => p.startsWith("tools:"))) {
-      parts.push(`user: ${lastUserMsg.slice(0, 35)}`);
-    }
-    if (errorCount > 0) {
-      parts.push(`${errorCount} errors`);
+  };
+  return builder;
+}
+// src/runner.ts
+import { spawnSync } from "child_process";
+import { existsSync as existsSync2, mkdirSync, readdirSync as readdirSync2, statSync as statSync2, writeFileSync } from "fs";
+import { basename as basename2, join as join2, resolve as resolve2 } from "path";
+function globToRegex(pattern) {
+  const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`);
+}
+function snapshotDir(dir, patterns) {
+  const result = /* @__PURE__ */ new Map();
+  if (!existsSync2(dir)) return result;
+  for (const entry of readdirSync2(dir)) {
+    if (!patterns.some((re) => re.test(entry))) continue;
+    const full = join2(dir, entry);
+    try {
+      const stat = statSync2(full);
+      if (stat.isFile()) {
+        result.set(full, stat.mtimeMs);
+      }
+    } catch {
     }
-    const detail = parts.join(" | ") || `${lineCount} messages`;
-    const status = errorCount > lineCount / 4 ? "error" : lastRole === "assistant" ? "ok" : "running";
-    const ts = findTimestamp(lastObj) || file.mtime;
-    const sessionName = sessionId ? sessionId.slice(0, 8) : nameFromFile(file.filename);
-    return [{ id: String(name !== "unknown" ? name : sessionName), source: "session", status, lastActive: ts, detail, file: file.filename }];
-  } catch {
-    return [];
   }
+  return result;
 }
-var K = "\x1B[K";
-function writeLine(lines, text) {
-  lines.push(text + K);
+function agentIdFromFilename(filePath) {
+  const base = basename2(filePath, ".json");
+  const cleaned = base.replace(/-state$/, "");
+  return `alfred-${cleaned}`;
 }
-function flushLines(lines) {
-  process.stdout.write("\x1B[H");
-  process.stdout.write(lines.join("\n") + "\n");
-  process.stdout.write("\x1B[J");
+function deriveAgentId(command) {
+  return "orchestrator";
 }
-var prevFileCount = 0;
-var newExecCount = 0;
-var sessionStart = Date.now();
-var firstRender = true;
-function render(config) {
-  const files = scanFiles(config.dirs, config.recursive);
-  if (files.length > prevFileCount && prevFileCount > 0) {
-    newExecCount += files.length - prevFileCount;
-  }
-  prevFileCount = files.length;
-  const allRecords = [];
-  const allTraces = [];
-  for (const f of files.slice(0, 300)) {
-    const records = f.ext === ".jsonl" ? processJsonlFile(f) : processJsonFile(f);
-    for (const r of records) {
-      allRecords.push(r);
-      if (r.traceData) allTraces.push(r.traceData);
-    }
-  }
-  const byFile = /* @__PURE__ */ new Map();
-  for (const r of allRecords) {
-    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
-      });
-    }
+function fileTimestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "");
+}
+async function runTraced(config) {
+  const {
+    command,
+    agentId = deriveAgentId(command),
+    trigger = "cli",
+    tracesDir = "./traces",
+    watchDirs = [],
+    watchPatterns = ["*.json"]
+  } = config;
+  if (command.length === 0) {
+    throw new Error("runTraced: command must not be empty");
   }
-  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);
-  const failBuckets = new Array(12).fill(0);
-  for (const r of allRecords) {
-    const age = now - r.lastActive;
-    if (age > 36e5 || age < 0) continue;
-    const idx = 11 - Math.floor(age / 3e5);
-    if (idx >= 0 && idx < 12) {
-      buckets[idx]++;
-      if (r.status === "error") failBuckets[idx]++;
-    }
+  const resolvedTracesDir = resolve2(tracesDir);
+  const patterns = watchPatterns.map(globToRegex);
+  const orchestrator = createGraphBuilder({ agentId, trigger });
+  const { traceId, spanId } = orchestrator.traceContext;
+  const beforeSnapshots = /* @__PURE__ */ new Map();
+  for (const dir of watchDirs) {
+    beforeSnapshots.set(dir, snapshotDir(dir, patterns));
   }
-  const maxBucket = Math.max(...buckets, 1);
-  const sparkChars = " \u2581\u2582\u2583\u2584\u2585\u2586\u2587\u2588";
-  const spark = buckets.map((v, i) => {
-    const level = Math.round(v / maxBucket * 8);
-    return (failBuckets[i] > 0 ? C.red : C.green) + sparkChars[level] + C.reset;
-  }).join("");
-  const distributedTraces = [];
-  if (allTraces.length > 1) {
-    const traceGroups = groupByTraceId(allTraces);
-    for (const [_tid, graphs] of traceGroups) {
-      if (graphs.length > 1) {
-        try {
-          distributedTraces.push(stitchTrace(graphs));
-        } catch {
-        }
+  const rootId = orchestrator.startNode({ type: "agent", name: agentId });
+  const dispatchId = orchestrator.startNode({
+    type: "tool",
+    name: "dispatch-command",
+    parentId: rootId
+  });
+  orchestrator.updateState(dispatchId, { command: command.join(" ") });
+  const monitorId = orchestrator.startNode({
+    type: "tool",
+    name: "state-monitor",
+    parentId: rootId
+  });
+  orchestrator.updateState(monitorId, {
+    watchDirs,
+    watchPatterns
+  });
+  const startMs = Date.now();
+  const execCmd = command[0] ?? "";
+  const execArgs = command.slice(1);
+  process.env.AGENTFLOW_TRACE_ID = traceId;
+  process.env.AGENTFLOW_PARENT_SPAN_ID = spanId;
+  const result = spawnSync(execCmd, execArgs, { stdio: "inherit" });
+  delete process.env.AGENTFLOW_TRACE_ID;
+  delete process.env.AGENTFLOW_PARENT_SPAN_ID;
+  const exitCode = result.status ?? 1;
+  const duration = (Date.now() - startMs) / 1e3;
+  const stateChanges = [];
+  for (const dir of watchDirs) {
+    const before = beforeSnapshots.get(dir) ?? /* @__PURE__ */ new Map();
+    const after = snapshotDir(dir, patterns);
+    for (const [filePath, mtime] of after) {
+      const prevMtime = before.get(filePath);
+      if (prevMtime === void 0 || mtime > prevMtime) {
+        stateChanges.push(filePath);
       }
     }
-    distributedTraces.sort((a, b) => b.startTime - a.startTime);
   }
-  const upSec = Math.floor((Date.now() - sessionStart) / 1e3);
-  const upMin = Math.floor(upSec / 60);
-  const upStr = upMin > 0 ? `${upMin}m ${upSec % 60}s` : `${upSec}s`;
-  const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-  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}`;
+  orchestrator.updateState(monitorId, { stateChanges });
+  orchestrator.endNode(monitorId);
+  if (exitCode === 0) {
+    orchestrator.endNode(dispatchId);
+  } else {
+    orchestrator.failNode(dispatchId, `Command exited with code ${exitCode}`);
   }
-  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}`;
+  orchestrator.updateState(rootId, {
+    exitCode,
+    duration,
+    stateChanges
+  });
+  if (exitCode === 0) {
+    orchestrator.endNode(rootId);
+  } else {
+    orchestrator.failNode(rootId, `Command exited with code ${exitCode}`);
   }
-  function sourceTag(s) {
-    switch (s) {
-      case "trace":
-        return `${C.cyan}trace${C.reset}`;
-      case "jobs":
-        return `${C.blue}job${C.reset}`;
-      case "workers":
-        return `${C.magenta}worker${C.reset}`;
-      case "session":
-        return `${C.yellow}session${C.reset}`;
-      case "state":
-        return `${C.dim}state${C.reset}`;
-    }
+  const orchestratorGraph = orchestrator.build();
+  const allGraphs = [orchestratorGraph];
+  for (const filePath of stateChanges) {
+    const childAgentId = agentIdFromFilename(filePath);
+    const childBuilder = createGraphBuilder({
+      agentId: childAgentId,
+      trigger: "state-change",
+      traceId,
+      parentSpanId: spanId
+    });
+    const childRootId = childBuilder.startNode({
+      type: "agent",
+      name: childAgentId
+    });
+    childBuilder.updateState(childRootId, {
+      stateFile: filePath,
+      detectedBy: "runner-state-monitor"
+    });
+    childBuilder.endNode(childRootId);
+    allGraphs.push(childBuilder.build());
   }
-  function timeStr(ts) {
-    if (ts <= 0) return "n/a";
-    return new Date(ts).toLocaleTimeString();
+  if (!existsSync2(resolvedTracesDir)) {
+    mkdirSync(resolvedTracesDir, { recursive: true });
   }
-  function truncate(s, max) {
-    return s.length > max ? s.slice(0, max - 1) + "\u2026" : s;
+  const ts = fileTimestamp();
+  const tracePaths = [];
+  for (const graph of allGraphs) {
+    const filename = `${graph.agentId}-${ts}.json`;
+    const outPath = join2(resolvedTracesDir, filename);
+    writeFileSync(outPath, JSON.stringify(graphToJson(graph), null, 2), "utf-8");
+    tracePaths.push(outPath);
   }
-  const termWidth = process.stdout.columns || 120;
-  const detailWidth = Math.max(20, termWidth - 60);
-  if (firstRender) {
-    process.stdout.write("\x1B[2J");
-    firstRender = false;
+  if (tracePaths.length > 0) {
+    console.log(`\u{1F50D} Run "agentflow trace show ${orchestratorGraph.id} --traces-dir ${resolvedTracesDir}" to inspect`);
   }
-  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);
-  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;
-  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, detailWidth);
-      writeLine(L, `  ${icon} ${name}  ${st.padEnd(20)}  ${active.padEnd(20)}  ${C.dim}${det}${C.reset}`);
-      lineCount++;
-    } else {
-      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, detailWidth - 5);
-        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++;
+  return {
+    exitCode,
+    traceId,
+    spanId,
+    tracePaths,
+    stateChanges,
+    duration
+  };
+}
+// src/trace-store.ts
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import { join as join3 } from "path";
+function createTraceStore(dir) {
+  async function ensureDir() {
+    await mkdir(dir, { recursive: true });
+  }
+  async function loadAll() {
+    await ensureDir();
+    let files;
+    try {
+      files = await readdir(dir);
+    } catch {
+      return [];
+    }
+    const graphs = [];
+    for (const file of files) {
+      if (!file.endsWith(".json")) continue;
+      try {
+        const content = await readFile(join3(dir, file), "utf-8");
+        const graph = loadGraph(content);
+        graphs.push(graph);
+      } catch {
       }
     }
+    return graphs;
   }
-  if (distributedTraces.length > 0) {
-    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 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);
-      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 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 = 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}`);
+  return {
+    async save(graph) {
+      await ensureDir();
+      const json = graphToJson(graph);
+      const filePath = join3(dir, `${graph.id}.json`);
+      await writeFile(filePath, JSON.stringify(json, null, 2), "utf-8");
+      return filePath;
+    },
+    async get(graphId) {
+      await ensureDir();
+      const filePath = join3(dir, `${graphId}.json`);
+      try {
+        const content = await readFile(filePath, "utf-8");
+        return loadGraph(content);
+      } catch {
+      }
+      const all = await loadAll();
+      return all.find((g) => g.id === graphId) ?? null;
+    },
+    async list(opts) {
+      let graphs = await loadAll();
+      if (opts?.status) {
+        graphs = graphs.filter((g) => g.status === opts.status);
+      }
+      graphs.sort((a, b) => b.startTime - a.startTime);
+      if (opts?.limit && opts.limit > 0) {
+        graphs = graphs.slice(0, opts.limit);
+      }
+      return graphs;
+    },
+    async getStuckSpans() {
+      const graphs = await loadAll();
+      const stuck = [];
+      for (const graph of graphs) {
+        for (const node of graph.nodes.values()) {
+          if (node.status === "running" || node.status === "hung" || node.status === "timeout") {
+            stuck.push(node);
+          }
+        }
+      }
+      return stuck;
+    },
+    async getReasoningLoops(threshold = 25) {
+      const graphs = await loadAll();
+      const results = [];
+      for (const graph of graphs) {
+        const loops = findLoopsInGraph(graph, threshold);
+        if (loops.length > 0) {
+          results.push({ graphId: graph.id, nodes: loops });
+        }
       }
+      return results;
     }
-  }
-  const recentRecords = allRecords.filter((r) => r.lastActive > 0).sort((a, b) => b.lastActive - a.lastActive).slice(0, 6);
-  if (recentRecords.length > 0) {
-    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 = 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 det = truncate(r.detail, detailWidth);
-      writeLine(L, `  ${icon}  ${agent} ${C.dim}${t}  ${ageStr.padStart(8)}${C.reset}  ${C.dim}${det}${C.reset}`);
+  };
+}
+function findLoopsInGraph(graph, threshold) {
+  const loopNodes = [];
+  function walk(nodeId, consecutiveCount, consecutiveType) {
+    const node = graph.nodes.get(nodeId);
+    if (!node) return;
+    const newCount = node.type === consecutiveType ? consecutiveCount + 1 : 1;
+    if (newCount > threshold) {
+      loopNodes.push(node);
+    }
+    for (const childId of node.children) {
+      walk(childId, newCount, node.type);
     }
   }
-  if (files.length === 0) {
-    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}`);
-  }
-  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);
+  walk(graph.rootNodeId, 0, null);
+  return loopNodes;
 }
-function getDistDepth(dt, spanId) {
-  if (!spanId) return 0;
-  const g = dt.graphs.get(spanId);
-  if (!g || !g.parentSpanId) return 0;
-  return 1 + getDistDepth(dt, g.parentSpanId);
+// src/visualize.ts
+var STATUS_ICONS = {
+  completed: "\u2713",
+  failed: "\u2717",
+  running: "\u231B",
+  hung: "\u231B",
+  timeout: "\u231B"
+};
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  if (ms < 6e4) return `${(ms / 1e3).toFixed(1)}s`;
+  if (ms < 36e5) return `${(ms / 6e4).toFixed(1)}m`;
+  return `${(ms / 36e5).toFixed(1)}h`;
 }
-function startLive(argv) {
-  const config = parseArgs(argv);
-  const valid = config.dirs.filter((d) => existsSync2(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) => !existsSync2(d));
-  if (invalid.length > 0) {
-    console.warn(`Skipping non-existent: ${invalid.join(", ")}`);
+function nodeDuration(node, graphEndTime) {
+  const end = node.endTime ?? graphEndTime;
+  return formatDuration(end - node.startTime);
+}
+function getGenAiInfo(node) {
+  const parts = [];
+  const meta = node.metadata;
+  if (meta["gen_ai.request.model"]) {
+    parts.push(String(meta["gen_ai.request.model"]));
+  }
+  const tokens = meta["gen_ai.usage.prompt_tokens"] ?? meta["gen_ai.usage.completion_tokens"];
+  if (tokens !== void 0) {
+    const prompt = meta["gen_ai.usage.prompt_tokens"] ?? 0;
+    const completion = meta["gen_ai.usage.completion_tokens"] ?? 0;
+    if (prompt || completion) {
+      parts.push(`${prompt + completion} tok`);
+    }
   }
-  config.dirs = valid;
-  render(config);
-  let debounce = null;
-  for (const dir of config.dirs) {
-    try {
-      watch(dir, { recursive: config.recursive }, () => {
-        if (debounce) clearTimeout(debounce);
-        debounce = setTimeout(() => render(config), 500);
-      });
-    } catch {
+  return parts.length > 0 ? ` [${parts.join(", ")}]` : "";
+}
+function hasViolation(node, graph) {
+  return graph.events.some(
+    (e) => e.nodeId === node.id && e.eventType === "custom" && e.data.guardViolation !== void 0
+  );
+}
+function toAsciiTree(graph) {
+  if (graph.nodes.size === 0) return "(empty graph)";
+  const now = Date.now();
+  const endTime = graph.endTime ?? now;
+  const lines = [];
+  function renderNode(nodeId, prefix, isLast, isRoot) {
+    const node = graph.nodes.get(nodeId);
+    if (!node) return;
+    const icon = STATUS_ICONS[node.status];
+    const duration = nodeDuration(node, endTime);
+    const genAi = getGenAiInfo(node);
+    const violation = hasViolation(node, graph) ? " \u26A0" : "";
+    const errorInfo = node.status === "failed" && node.metadata.error ? ` \u2014 ${node.metadata.error}` : "";
+    const timeoutInfo = node.status === "timeout" ? " [TIMEOUT]" : "";
+    const hungInfo = node.status === "hung" ? " [HUNG]" : "";
+    const connector = isRoot ? "" : isLast ? "\u2514\u2500 " : "\u251C\u2500 ";
+    const line = `${prefix}${connector}${icon} ${node.name} (${node.type}) ${duration}${genAi}${violation}${timeoutInfo}${hungInfo}${errorInfo}`;
+    lines.push(line);
+    const children = getChildren(graph, nodeId);
+    const childPrefix = isRoot ? "" : prefix + (isLast ? "   " : "\u2502  ");
+    for (let i = 0; i < children.length; i++) {
+      renderNode(children[i].id, childPrefix, i === children.length - 1, false);
     }
   }
-  setInterval(() => render(config), config.refreshMs);
-  process.on("SIGINT", () => {
-    console.log("\n" + C.dim + "Monitor stopped." + C.reset);
-    process.exit(0);
-  });
+  renderNode(graph.rootNodeId, "", true, true);
+  return lines.join("\n");
+}
+function toTimeline(graph) {
+  if (graph.nodes.size === 0) return "(empty graph)";
+  const now = Date.now();
+  const graphStart = graph.startTime;
+  const graphEnd = graph.endTime ?? now;
+  const totalDuration = graphEnd - graphStart;
+  if (totalDuration <= 0) return "(zero duration)";
+  const barWidth = 60;
+  const lines = [];
+  const scaleLabels = [];
+  const tickCount = Math.min(5, Math.max(2, Math.floor(barWidth / 10)));
+  for (let i = 0; i <= tickCount; i++) {
+    const t = totalDuration * i / tickCount;
+    scaleLabels.push(formatDuration(t));
+  }
+  let header = "";
+  for (let i = 0; i < scaleLabels.length; i++) {
+    const pos = Math.round(barWidth * i / tickCount);
+    while (header.length < pos) header += " ";
+    header += scaleLabels[i];
+  }
+  lines.push(header);
+  let tickLine = "";
+  for (let i = 0; i < barWidth; i++) {
+    const tickPos = tickCount > 0 ? i * tickCount / barWidth : 0;
+    if (Number.isInteger(Math.round(tickPos * 100) / 100) && Math.abs(tickPos - Math.round(tickPos)) < 0.01) {
+      tickLine += "\u253C";
+    } else {
+      tickLine += "\u2500";
+    }
+  }
+  lines.push(tickLine);
+  const orderedNodes = [];
+  function collectNodes(nodeId) {
+    const node = graph.nodes.get(nodeId);
+    if (!node) return;
+    orderedNodes.push(node);
+    const children = getChildren(graph, nodeId);
+    for (const child of children) {
+      collectNodes(child.id);
+    }
+  }
+  collectNodes(graph.rootNodeId);
+  for (const node of orderedNodes) {
+    const nodeStart = node.startTime - graphStart;
+    const nodeEnd = (node.endTime ?? now) - graphStart;
+    const startCol = Math.round(nodeStart / totalDuration * barWidth);
+    const endCol = Math.max(startCol + 1, Math.round(nodeEnd / totalDuration * barWidth));
+    let bar = "";
+    for (let i = 0; i < barWidth; i++) {
+      if (i >= startCol && i < endCol) {
+        bar += "\u2588";
+      } else {
+        bar += " ";
+      }
+    }
+    const icon = STATUS_ICONS[node.status];
+    const duration = nodeDuration(node, graphEnd);
+    const violation = hasViolation(node, graph) ? " \u26A0" : "";
+    lines.push(`${bar} ${icon} ${node.name} (${duration})${violation}`);
+  }
+  return lines.join("\n");
 }
 // src/watch.ts
 import { existsSync as existsSync4 } from "fs";
-import { resolve as resolve3, join as join3 } from "path";
 import { hostname } from "os";
+import { join as join4, resolve as resolve3 } from "path";
+// src/watch-alerts.ts
+import { exec } from "child_process";
+import { request as httpRequest } from "http";
+import { request as httpsRequest } from "https";
+function formatAlertMessage(payload) {
+  const time = new Date(payload.timestamp).toISOString();
+  const arrow = `${payload.previousStatus} \u2192 ${payload.currentStatus}`;
+  return [
+    `[ALERT] ${payload.condition}: "${payload.agentId}"`,
+    `  Status:  ${arrow}`,
+    payload.detail ? `  Detail:  ${payload.detail}` : null,
+    `  File:    ${payload.file}`,
+    `  Time:    ${time}`
+  ].filter(Boolean).join("\n");
+}
+function formatTelegram(payload) {
+  const icon = payload.condition === "recovery" ? "\u2705" : "\u26A0\uFE0F";
+  const time = new Date(payload.timestamp).toLocaleTimeString();
+  return [
+    `${icon} *AgentFlow Alert*`,
+    `*${payload.condition}*: \`${payload.agentId}\``,
+    `Status: ${payload.previousStatus} \u2192 ${payload.currentStatus}`,
+    payload.detail ? `Detail: ${payload.detail.slice(0, 200)}` : null,
+    `Time: ${time}`
+  ].filter(Boolean).join("\n");
+}
+async function sendAlert(payload, channel) {
+  try {
+    switch (channel.type) {
+      case "stdout":
+        sendStdout(payload);
+        break;
+      case "telegram":
+        await sendTelegram(payload, channel.botToken, channel.chatId);
+        break;
+      case "webhook":
+        await sendWebhook(payload, channel.url);
+        break;
+      case "command":
+        await sendCommand(payload, channel.cmd);
+        break;
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`[agentflow] Failed to send ${channel.type} alert: ${msg}`);
+  }
+}
+function sendStdout(payload) {
+  console.log(formatAlertMessage(payload));
+}
+function sendTelegram(payload, botToken, chatId) {
+  const body = JSON.stringify({
+    chat_id: chatId,
+    text: formatTelegram(payload),
+    parse_mode: "Markdown"
+  });
+  return new Promise((resolve4, reject) => {
+    const req = httpsRequest(
+      `https://api.telegram.org/bot${botToken}/sendMessage`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) }
+      },
+      (res) => {
+        res.resume();
+        if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) resolve4();
+        else reject(new Error(`Telegram API returned ${res.statusCode}`));
+      }
+    );
+    req.on("error", reject);
+    req.write(body);
+    req.end();
+  });
+}
+function sendWebhook(payload, url) {
+  const body = JSON.stringify(payload);
+  const isHttps = url.startsWith("https");
+  const doRequest = isHttps ? httpsRequest : httpRequest;
+  return new Promise((resolve4, reject) => {
+    const req = doRequest(
+      url,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) }
+      },
+      (res) => {
+        res.resume();
+        if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) resolve4();
+        else reject(new Error(`Webhook returned ${res.statusCode}`));
+      }
+    );
+    req.on("error", reject);
+    req.setTimeout(1e4, () => {
+      req.destroy(new Error("Webhook timeout"));
+    });
+    req.write(body);
+    req.end();
+  });
+}
+function sendCommand(payload, cmd) {
+  return new Promise((resolve4, reject) => {
+    const env = {
+      ...process.env,
+      AGENTFLOW_ALERT_AGENT: payload.agentId,
+      AGENTFLOW_ALERT_CONDITION: payload.condition,
+      AGENTFLOW_ALERT_STATUS: payload.currentStatus,
+      AGENTFLOW_ALERT_PREVIOUS_STATUS: payload.previousStatus,
+      AGENTFLOW_ALERT_DETAIL: payload.detail,
+      AGENTFLOW_ALERT_FILE: payload.file,
+      AGENTFLOW_ALERT_TIMESTAMP: String(payload.timestamp)
+    };
+    exec(cmd, { env, timeout: 3e4 }, (err) => {
+      if (err) reject(err);
+      else resolve4();
+    });
+  });
+}
 // src/watch-state.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, renameSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2, renameSync, writeFileSync as writeFileSync2 } from "fs";
 function parseDuration(input) {
   const match = input.match(/^(\d+(?:\.\d+)?)\s*(s|m|h|d)$/i);
   if (!match) {
@@ -1346,7 +1742,9 @@ function detectTransitions(previous, currentRecords, config, now) {
   const hasError = config.alertConditions.some((c) => c.type === "error");
   const hasRecovery = config.alertConditions.some((c) => c.type === "recovery");
   const staleConditions = config.alertConditions.filter((c) => c.type === "stale");
-  const consecutiveConditions = config.alertConditions.filter((c) => c.type === "consecutive-errors");
+  const consecutiveConditions = config.alertConditions.filter(
+    (c) => c.type === "consecutive-errors"
+  );
   const byAgent = /* @__PURE__ */ new Map();
   for (const r of currentRecords) {
     const existing = byAgent.get(r.id);
@@ -1370,14 +1768,16 @@ function detectTransitions(previous, currentRecords, config, now) {
     for (const cond of consecutiveConditions) {
       if (newConsec === cond.threshold) {
         if (canAlert(prev, `consecutive-errors:${cond.threshold}`, config.cooldownMs, now)) {
-          alerts.push(makePayload(
-            agentId,
-            `consecutive-errors (${cond.threshold})`,
-            prevStatus,
-            currStatus,
-            { ...record, detail: `${newConsec} consecutive errors. ${record.detail}` },
-            config.dirs
-          ));
+          alerts.push(
+            makePayload(
+              agentId,
+              `consecutive-errors (${cond.threshold})`,
+              prevStatus,
+              currStatus,
+              { ...record, detail: `${newConsec} consecutive errors. ${record.detail}` },
+              config.dirs
+            )
+          );
         }
       }
     }
@@ -1386,14 +1786,16 @@ function detectTransitions(previous, currentRecords, config, now) {
       if (sinceActive > cond.durationMs && record.lastActive > 0) {
         if (canAlert(prev, "stale", config.cooldownMs, now)) {
           const mins = Math.floor(sinceActive / 6e4);
-          alerts.push(makePayload(
-            agentId,
-            "stale",
-            prevStatus,
-            currStatus,
-            { ...record, detail: `No update for ${mins}m. ${record.detail}` },
-            config.dirs
-          ));
+          alerts.push(
+            makePayload(
+              agentId,
+              "stale",
+              prevStatus,
+              currStatus,
+              { ...record, detail: `No update for ${mins}m. ${record.detail}` },
+              config.dirs
+            )
+          );
         }
       }
     }
@@ -1406,14 +1808,19 @@ function detectTransitions(previous, currentRecords, config, now) {
           if (canAlert(prev, "stale-auto", config.cooldownMs, now)) {
             const mins = Math.floor(sinceActive / 6e4);
             const expectedMins = Math.floor(expectedInterval / 6e4);
-            alerts.push(makePayload(
-              agentId,
-              "stale (auto)",
-              prevStatus,
-              currStatus,
-              { ...record, detail: `No update for ${mins}m (expected every ~${expectedMins}m). ${record.detail}` },
-              config.dirs
-            ));
+            alerts.push(
+              makePayload(
+                agentId,
+                "stale (auto)",
+                prevStatus,
+                currStatus,
+                {
+                  ...record,
+                  detail: `No update for ${mins}m (expected every ~${expectedMins}m). ${record.detail}`
+                },
+                config.dirs
+              )
+            );
           }
         }
       }
@@ -1472,118 +1879,6 @@ function makePayload(agentId, condition, previousStatus, currentStatus, record,
   };
 }
-// src/watch-alerts.ts
-import { request as httpsRequest } from "https";
-import { request as httpRequest } from "http";
-import { exec } from "child_process";
-function formatAlertMessage(payload) {
-  const time = new Date(payload.timestamp).toISOString();
-  const arrow = `${payload.previousStatus} \u2192 ${payload.currentStatus}`;
-  return [
-    `[ALERT] ${payload.condition}: "${payload.agentId}"`,
-    `  Status:  ${arrow}`,
-    payload.detail ? `  Detail:  ${payload.detail}` : null,
-    `  File:    ${payload.file}`,
-    `  Time:    ${time}`
-  ].filter(Boolean).join("\n");
-}
-function formatTelegram(payload) {
-  const icon = payload.condition === "recovery" ? "\u2705" : "\u26A0\uFE0F";
-  const time = new Date(payload.timestamp).toLocaleTimeString();
-  return [
-    `${icon} *AgentFlow Alert*`,
-    `*${payload.condition}*: \`${payload.agentId}\``,
-    `Status: ${payload.previousStatus} \u2192 ${payload.currentStatus}`,
-    payload.detail ? `Detail: ${payload.detail.slice(0, 200)}` : null,
-    `Time: ${time}`
-  ].filter(Boolean).join("\n");
-}
-async function sendAlert(payload, channel) {
-  try {
-    switch (channel.type) {
-      case "stdout":
-        sendStdout(payload);
-        break;
-      case "telegram":
-        await sendTelegram(payload, channel.botToken, channel.chatId);
-        break;
-      case "webhook":
-        await sendWebhook(payload, channel.url);
-        break;
-      case "command":
-        await sendCommand(payload, channel.cmd);
-        break;
-    }
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    console.error(`[agentflow] Failed to send ${channel.type} alert: ${msg}`);
-  }
-}
-function sendStdout(payload) {
-  console.log(formatAlertMessage(payload));
-}
-function sendTelegram(payload, botToken, chatId) {
-  const body = JSON.stringify({
-    chat_id: chatId,
-    text: formatTelegram(payload),
-    parse_mode: "Markdown"
-  });
-  return new Promise((resolve4, reject) => {
-    const req = httpsRequest(
-      `https://api.telegram.org/bot${botToken}/sendMessage`,
-      { method: "POST", headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) } },
-      (res) => {
-        res.resume();
-        if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) resolve4();
-        else reject(new Error(`Telegram API returned ${res.statusCode}`));
-      }
-    );
-    req.on("error", reject);
-    req.write(body);
-    req.end();
-  });
-}
-function sendWebhook(payload, url) {
-  const body = JSON.stringify(payload);
-  const isHttps = url.startsWith("https");
-  const doRequest = isHttps ? httpsRequest : httpRequest;
-  return new Promise((resolve4, reject) => {
-    const req = doRequest(
-      url,
-      { method: "POST", headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) } },
-      (res) => {
-        res.resume();
-        if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) resolve4();
-        else reject(new Error(`Webhook returned ${res.statusCode}`));
-      }
-    );
-    req.on("error", reject);
-    req.setTimeout(1e4, () => {
-      req.destroy(new Error("Webhook timeout"));
-    });
-    req.write(body);
-    req.end();
-  });
-}
-function sendCommand(payload, cmd) {
-  return new Promise((resolve4, reject) => {
-    const env = {
-      ...process.env,
-      AGENTFLOW_ALERT_AGENT: payload.agentId,
-      AGENTFLOW_ALERT_CONDITION: payload.condition,
-      AGENTFLOW_ALERT_STATUS: payload.currentStatus,
-      AGENTFLOW_ALERT_PREVIOUS_STATUS: payload.previousStatus,
-      AGENTFLOW_ALERT_DETAIL: payload.detail,
-      AGENTFLOW_ALERT_FILE: payload.file,
-      AGENTFLOW_ALERT_TIMESTAMP: String(payload.timestamp)
-    };
-    exec(cmd, { env, timeout: 3e4 }, (err) => {
-      if (err) reject(err);
-      else resolve4();
-    });
-  });
-}
 // src/watch.ts
 function parseWatchArgs(argv) {
   const dirs = [];
@@ -1625,7 +1920,9 @@ function parseWatchArgs(argv) {
         if (botToken && chatId) {
           notifyChannels.push({ type: "telegram", botToken, chatId });
         } else {
-          console.error("Warning: --notify telegram requires AGENTFLOW_TELEGRAM_BOT_TOKEN and AGENTFLOW_TELEGRAM_CHAT_ID env vars");
+          console.error(
+            "Warning: --notify telegram requires AGENTFLOW_TELEGRAM_BOT_TOKEN and AGENTFLOW_TELEGRAM_CHAT_ID env vars"
+          );
         }
       } else if (val.startsWith("webhook:")) {
         notifyChannels.push({ type: "webhook", url: val.slice(8) });
@@ -1664,7 +1961,7 @@ function parseWatchArgs(argv) {
   }
   notifyChannels.unshift({ type: "stdout" });
   if (!stateFilePath) {
-    stateFilePath = join3(dirs[0], ".agentflow-watch-state.json");
+    stateFilePath = join4(dirs[0], ".agentflow-watch-state.json");
   }
   return {
     dirs,
@@ -1677,7 +1974,8 @@ function parseWatchArgs(argv) {
   };
 }
 function printWatchUsage() {
-  console.log(`
+  console.log(
+    `
 AgentFlow Watch \u2014 headless alert system for agent infrastructure.
 Polls directories for JSON/JSONL files, detects failures and stale
@@ -1720,7 +2018,8 @@ Examples:
   agentflow watch ./data ./cron --notify telegram --poll 60
   agentflow watch ./traces --notify webhook:https://hooks.slack.com/... --alert-on consecutive-errors:3
   agentflow watch ./data --notify "command:curl -X POST https://my-pagerduty/alert"
-`.trim());
+`.trim()
+  );
 }
 function startWatch(argv) {
   const config = parseWatchArgs(argv);
@@ -1749,7 +2048,9 @@ agentflow watch started`);
   console.log(`  Directories:  ${valid.join(", ")}`);
   console.log(`  Poll:         ${config.pollIntervalMs / 1e3}s`);
   console.log(`  Alert on:     ${condLabels.join(", ")}`);
-  console.log(`  Notify:       stdout${channelLabels.length > 0 ? ", " + channelLabels.join(", ") : ""}`);
+  console.log(
+    `  Notify:       stdout${channelLabels.length > 0 ? ", " + channelLabels.join(", ") : ""}`
+  );
   console.log(`  Cooldown:     ${Math.floor(config.cooldownMs / 6e4)}m`);
   console.log(`  State:        ${config.stateFilePath}`);
   console.log(`  Hostname:     ${hostname()}`);
@@ -1775,9 +2076,13 @@ agentflow watch started`);
     if (pollCount % 10 === 0) {
       const agentCount = Object.keys(state.agents).length;
       const errorCount = Object.values(state.agents).filter((a) => a.lastStatus === "error").length;
-      const runningCount = Object.values(state.agents).filter((a) => a.lastStatus === "running").length;
+      const runningCount = Object.values(state.agents).filter(
+        (a) => a.lastStatus === "running"
+      ).length;
       const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
-      console.log(`[${time}] heartbeat: ${agentCount} agents, ${runningCount} running, ${errorCount} errors, ${files.length} files`);
+      console.log(
+        `[${time}] heartbeat: ${agentCount} agents, ${runningCount} running, ${errorCount} errors, ${files.length} files`
+      );
     }
   }
   poll();
@@ -1794,10 +2099,6 @@ agentflow watch started`);
 }
 export {
-  createGraphBuilder,
-  loadGraph,
-  graphToJson,
-  runTraced,
   getNode,
   getChildren,
   getParent,
@@ -1813,5 +2114,10 @@ export {
   stitchTrace,
   getTraceTree,
   startLive,
+  createGraphBuilder,
+  runTraced,
+  createTraceStore,
+  toAsciiTree,
+  toTimeline,
   startWatch
 };