agentflow-core 0.3.3 → 0.5.0

package/dist/{chunk-M5CGDXAO.js → chunk-T2BYYGA4.js}

@@ -1,1289 +1,1718 @@
-// 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}$`);
+import { execSync } from "child_process";
+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;
+        let validatedStatus = status2;
+        let pidAlive = true;
+        if (pid && (status2 === "running" || status2 === "ok")) {
+          try {
+            execSync(`kill -0 ${pid} 2>/dev/null`, { stdio: "ignore" });
+          } catch {
+            pidAlive = false;
+            validatedStatus = "error";
+          }
+        }
+        const pidLabel = pid ? pidAlive ? `pid: ${pid}` : `pid: ${pid} (dead)` : "";
+        const detail2 = pidLabel || extractDetail(w);
+        records.push({
+          id: name,
+          source: "workers",
+          status: validatedStatus,
+          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
+        }
+      ];
+    }
+    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++;
+            }
+          }
+        }
+      }
+    }
+    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`);
+    }
+    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 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;
+var K = "\x1B[K";
+function writeLine(lines, text) {
+  lines.push(text + K);
 }
-function getDuration(graph) {
-  const end = graph.endTime ?? Date.now();
-  return end - graph.startTime;
+function flushLines(lines) {
+  process.stdout.write("\x1B[H");
+  process.stdout.write(lines.join("\n") + "\n");
+  process.stdout.write("\x1B[J");
 }
-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;
+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;
   }
-  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++;
+  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);
     }
   }
-  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;
-}
-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;
+  const deduped = [];
+  const seenAgents = /* @__PURE__ */ new Map();
+  for (const r of allRecords) {
+    if (r.source === "jobs" || r.source === "workers" || r.source === "state") {
+      deduped.push(r);
+      continue;
     }
-    if (g.parentSpanId) {
-      const siblings = childMap.get(g.parentSpanId) ?? [];
-      if (g.spanId) siblings.push(g.spanId);
-      childMap.set(g.parentSpanId, siblings);
+    const key = `${r.source}:${r.id}`;
+    const existing = seenAgents.get(key);
+    if (!existing || r.lastActive > existing.lastActive) {
+      seenAgents.set(key, r);
     }
   }
-  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);
-  }
-  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
+  for (const r of seenAgents.values()) deduped.push(r);
+  const STALE_THRESHOLD_MS = 2 * 60 * 60 * 1e3;
+  const now = Date.now();
+  const filtered = deduped.filter((r) => {
+    if (r.source === "jobs" || r.source === "workers") return true;
+    if (r.status === "running") return true;
+    return now - r.lastActive < STALE_THRESHOLD_MS;
   });
-}
-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 activeRecords = filtered;
+  const byFile = /* @__PURE__ */ new Map();
+  for (const r of activeRecords) {
+    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++;
-    }
-  }
-  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;
+      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
+      });
+    }
+  }
+  groups.sort((a, b) => b.lastTs - a.lastTs);
+  const totExec = activeRecords.length;
+  const totFail = activeRecords.filter((r) => r.status === "error").length;
+  const totRunning = activeRecords.filter((r) => r.status === "running").length;
+  const uniqueAgents = new Set(activeRecords.map((r) => r.id)).size;
+  const sysRate = totExec > 0 ? ((totExec - totFail) / totExec * 100).toFixed(1) : "100.0";
+  const buckets = new Array(12).fill(0);
+  const failBuckets = new Array(12).fill(0);
+  for (const r of activeRecords) {
+    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}`;
     }
   }
-  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;
+  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 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;
+  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}`
+        );
+      }
     }
   }
-  for (const key of ["totalExecutions", "runs", "count", "processed", "consecutiveErrors"]) {
-    const val = obj[key];
-    if (typeof val === "number") {
-      parts.push(`${key}: ${val}`);
-      break;
+  const recentRecords = activeRecords.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}`
+      );
     }
   }
-  return parts.join(" | ") || "";
-}
-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;
+  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 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
+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 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 });
+  setInterval(() => render(config), config.refreshMs);
+  process.on("SIGINT", () => {
+    console.log("\n" + C.dim + "Monitor stopped." + C.reset);
+    process.exit(0);
+  });
+}
+
+// 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 records;
+    return obj;
   }
-  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;
+  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);
     }
   }
-  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;
+  return obj;
 }
-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 }];
+function createCounterIdGenerator() {
+  let counter = 0;
+  return () => {
+    counter++;
+    return `node_${String(counter).padStart(3, "0")}`;
+  };
+}
+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");
     }
-    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 entryType = entry.type;
-      if (entryType === "session") {
-        sessionId = entry.id ?? "";
-        continue;
+  }
+  function getNode2(nodeId) {
+    const node = nodes.get(nodeId);
+    if (!node) {
+      throw new Error(`GraphBuilder: node "${nodeId}" does not exist`);
+    }
+    return node;
+  }
+  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 (entryType === "model_change") {
-        model = entry.modelId ?? "";
-        continue;
+      if (node.status === "running") {
+        graphStatus = "running";
       }
-      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 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 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;
-            }
-          }
+      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})`
+        );
       }
-      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);
-          }
-        }
+      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 === "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++;
-            }
-          }
-        }
+      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;
     }
-    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 +1775,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 +1801,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 +1819,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 +1841,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 +1912,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 +1953,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 +1994,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 +2007,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 +2051,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 +2081,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 +2109,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 +2132,6 @@ agentflow watch started`);
 }
 
 export {
-  createGraphBuilder,
-  loadGraph,
-  graphToJson,
-  runTraced,
   getNode,
   getChildren,
   getParent,
@@ -1813,5 +2147,10 @@ export {
   stitchTrace,
   getTraceTree,
   startLive,
+  createGraphBuilder,
+  runTraced,
+  createTraceStore,
+  toAsciiTree,
+  toTimeline,
   startWatch
 };