agentflow-dashboard 0.7.0 → 0.7.1

package/README.md

@@ -1,9 +1,13 @@
-# AgentFlow Dashboard v0.5.0
+# AgentFlow Dashboard v0.7.1
 
 Real-time monitoring dashboard for AI agent systems. Visualize execution graphs, session transcripts, and performance metrics from any agent framework.
 
 ## Features
 
+### Error Surfacing
+- **Crystal-clear error tracking** — Failed node errors (`state.error` and `metadata.error`) are surfaced in all detail views: Flame Chart, Agent Flow, Summary, and Transcript
+- Error messages like `"403 Forbidden — Key limit exceeded"` appear directly in the UI — no more digging through log files
+
 ### Universal Agent Monitoring
 - **Multi-Format Ingestion** - AgentFlow JSON traces, JSONL session logs (Claude Code compatible), structured log files, cron run logs
 - **Auto-Discovery** - Recursively scans directories for trace files, watches for new files in real-time

package/dist/{chunk-GA2Y6E62.js → chunk-3S4AAIPA.js}

@@ -2061,11 +2061,23 @@ async function startDashboard() {
       case "--cors":
         config.enableCors = true;
         break;
+      case "--no-collector":
+        config.enableCollector = false;
+        break;
+      case "--collector-token":
+        config.collectorAuthToken = args[++i];
+        break;
       case "--help":
         printHelp();
         process.exit(0);
     }
   }
+  if (!config.collectorAuthToken && process.env.AGENTFLOW_COLLECTOR_TOKEN) {
+    config.collectorAuthToken = process.env.AGENTFLOW_COLLECTOR_TOKEN;
+  }
+  if (process.env.AGENTFLOW_NO_COLLECTOR === "true") {
+    config.enableCollector = false;
+  }
   const tracesPath = path2.resolve(config.tracesDir);
   if (!fs2.existsSync(tracesPath)) {
     fs2.mkdirSync(tracesPath, { recursive: true });
@@ -2108,6 +2120,8 @@ Options:
   -h, --host <address>    Host address (default: localhost)
   --data-dir <path>       Extra data directory for process discovery (repeatable)
   --cors                  Enable CORS headers
+  --no-collector          Disable OTLP trace collector (POST /v1/traces)
+  --collector-token <tok> Require auth token for collector (or set AGENTFLOW_COLLECTOR_TOKEN)
   --help                  Show this help message
 
 Examples:
@@ -2686,46 +2700,54 @@ var DashboardServer = class {
         res.status(500).json({ error: "Failed to update directory config" });
       }
     });
-    this.app.post("/v1/traces", express.json({ limit: "10mb" }), (req, res) => {
-      try {
-        const traces = parseOtlpPayload(req.body);
-        let ingested = 0;
-        for (const trace of traces) {
-          const nodes = /* @__PURE__ */ new Map();
-          for (const [id, node] of Object.entries(trace.nodes)) {
-            nodes.set(id, { ...node, state: {} });
+    if (this.config.enableCollector !== false) {
+      this.app.post("/v1/traces", express.json({ limit: "10mb" }), (req, res) => {
+        try {
+          if (this.config.collectorAuthToken) {
+            const auth = req.headers.authorization;
+            if (!auth || auth !== `Bearer ${this.config.collectorAuthToken}`) {
+              return res.status(401).json({ error: "Unauthorized \u2014 provide Authorization: Bearer <token>" });
+            }
           }
-          const watched = {
-            id: trace.id,
-            rootNodeId: Object.keys(trace.nodes)[0] ?? "",
-            agentId: trace.agentId,
-            name: trace.name,
-            trigger: trace.trigger,
-            startTime: trace.startTime,
-            endTime: trace.endTime,
-            status: trace.status,
-            nodes,
-            edges: [],
-            events: [],
-            metadata: { ...trace.metadata, adapterSource: "otel" },
-            sessionEvents: [],
-            sourceType: "session",
-            filename: `otel-${trace.id}`,
-            lastModified: Date.now(),
-            sourceDir: "http-collector"
-          };
-          this.watcher.traces.set(`otel:${trace.id}`, watched);
-          ingested++;
-        }
-        if (ingested > 0) {
-          this.broadcast({ type: "traces-updated", count: ingested });
+          const traces = parseOtlpPayload(req.body);
+          let ingested = 0;
+          for (const trace of traces) {
+            const nodes = /* @__PURE__ */ new Map();
+            for (const [id, node] of Object.entries(trace.nodes)) {
+              nodes.set(id, { ...node, state: {} });
+            }
+            const watched = {
+              id: trace.id,
+              rootNodeId: Object.keys(trace.nodes)[0] ?? "",
+              agentId: trace.agentId,
+              name: trace.name,
+              trigger: trace.trigger,
+              startTime: trace.startTime,
+              endTime: trace.endTime,
+              status: trace.status,
+              nodes,
+              edges: [],
+              events: [],
+              metadata: { ...trace.metadata, adapterSource: "otel" },
+              sessionEvents: [],
+              sourceType: "session",
+              filename: `otel-${trace.id}`,
+              lastModified: Date.now(),
+              sourceDir: "http-collector"
+            };
+            this.watcher.traces.set(`otel:${trace.id}`, watched);
+            ingested++;
+          }
+          if (ingested > 0) {
+            this.broadcast({ type: "traces-updated", count: ingested });
+          }
+          res.json({ ok: true, tracesIngested: ingested });
+        } catch (error) {
+          console.error("OTLP collector error:", error);
+          res.status(400).json({ error: "Failed to parse OTLP payload" });
         }
-        res.json({ ok: true, tracesIngested: ingested });
-      } catch (error) {
-        console.error("OTLP collector error:", error);
-        res.status(400).json({ error: "Failed to parse OTLP payload" });
-      }
-    });
+      });
+    }
     this.app.get("/health", (_req, res) => {
       res.json({
         status: "ok",

package/dist/cli.cjs

@@ -2563,46 +2563,54 @@ var DashboardServer = class {
         res.status(500).json({ error: "Failed to update directory config" });
       }
     });
-    this.app.post("/v1/traces", import_express.default.json({ limit: "10mb" }), (req, res) => {
-      try {
-        const traces = parseOtlpPayload(req.body);
-        let ingested = 0;
-        for (const trace of traces) {
-          const nodes = /* @__PURE__ */ new Map();
-          for (const [id, node] of Object.entries(trace.nodes)) {
-            nodes.set(id, { ...node, state: {} });
+    if (this.config.enableCollector !== false) {
+      this.app.post("/v1/traces", import_express.default.json({ limit: "10mb" }), (req, res) => {
+        try {
+          if (this.config.collectorAuthToken) {
+            const auth = req.headers.authorization;
+            if (!auth || auth !== `Bearer ${this.config.collectorAuthToken}`) {
+              return res.status(401).json({ error: "Unauthorized \u2014 provide Authorization: Bearer <token>" });
+            }
           }
-          const watched = {
-            id: trace.id,
-            rootNodeId: Object.keys(trace.nodes)[0] ?? "",
-            agentId: trace.agentId,
-            name: trace.name,
-            trigger: trace.trigger,
-            startTime: trace.startTime,
-            endTime: trace.endTime,
-            status: trace.status,
-            nodes,
-            edges: [],
-            events: [],
-            metadata: { ...trace.metadata, adapterSource: "otel" },
-            sessionEvents: [],
-            sourceType: "session",
-            filename: `otel-${trace.id}`,
-            lastModified: Date.now(),
-            sourceDir: "http-collector"
-          };
-          this.watcher.traces.set(`otel:${trace.id}`, watched);
-          ingested++;
-        }
-        if (ingested > 0) {
-          this.broadcast({ type: "traces-updated", count: ingested });
+          const traces = parseOtlpPayload(req.body);
+          let ingested = 0;
+          for (const trace of traces) {
+            const nodes = /* @__PURE__ */ new Map();
+            for (const [id, node] of Object.entries(trace.nodes)) {
+              nodes.set(id, { ...node, state: {} });
+            }
+            const watched = {
+              id: trace.id,
+              rootNodeId: Object.keys(trace.nodes)[0] ?? "",
+              agentId: trace.agentId,
+              name: trace.name,
+              trigger: trace.trigger,
+              startTime: trace.startTime,
+              endTime: trace.endTime,
+              status: trace.status,
+              nodes,
+              edges: [],
+              events: [],
+              metadata: { ...trace.metadata, adapterSource: "otel" },
+              sessionEvents: [],
+              sourceType: "session",
+              filename: `otel-${trace.id}`,
+              lastModified: Date.now(),
+              sourceDir: "http-collector"
+            };
+            this.watcher.traces.set(`otel:${trace.id}`, watched);
+            ingested++;
+          }
+          if (ingested > 0) {
+            this.broadcast({ type: "traces-updated", count: ingested });
+          }
+          res.json({ ok: true, tracesIngested: ingested });
+        } catch (error) {
+          console.error("OTLP collector error:", error);
+          res.status(400).json({ error: "Failed to parse OTLP payload" });
         }
-        res.json({ ok: true, tracesIngested: ingested });
-      } catch (error) {
-        console.error("OTLP collector error:", error);
-        res.status(400).json({ error: "Failed to parse OTLP payload" });
-      }
-    });
+      });
+    }
     this.app.get("/health", (_req, res) => {
       res.json({
         status: "ok",
@@ -2981,11 +2989,23 @@ async function startDashboard() {
       case "--cors":
         config.enableCors = true;
         break;
+      case "--no-collector":
+        config.enableCollector = false;
+        break;
+      case "--collector-token":
+        config.collectorAuthToken = args[++i];
+        break;
       case "--help":
         printHelp();
         process.exit(0);
     }
   }
+  if (!config.collectorAuthToken && process.env.AGENTFLOW_COLLECTOR_TOKEN) {
+    config.collectorAuthToken = process.env.AGENTFLOW_COLLECTOR_TOKEN;
+  }
+  if (process.env.AGENTFLOW_NO_COLLECTOR === "true") {
+    config.enableCollector = false;
+  }
   const tracesPath = path3.resolve(config.tracesDir);
   if (!fs3.existsSync(tracesPath)) {
     fs3.mkdirSync(tracesPath, { recursive: true });
@@ -3028,6 +3048,8 @@ Options:
   -h, --host <address>    Host address (default: localhost)
   --data-dir <path>       Extra data directory for process discovery (repeatable)
   --cors                  Enable CORS headers
+  --no-collector          Disable OTLP trace collector (POST /v1/traces)
+  --collector-token <tok> Require auth token for collector (or set AGENTFLOW_COLLECTOR_TOKEN)
   --help                  Show this help message
 
 Examples:

package/dist/cli.js

@@ -1,6 +1,6 @@
 import {
   startDashboard
-} from "./chunk-GA2Y6E62.js";
+} from "./chunk-3S4AAIPA.js";
 export {
   startDashboard
 };