agentflow-dashboard 0.3.0 → 0.3.1

package/dist/index.cjs

@@ -38,9 +38,9 @@ module.exports = __toCommonJS(index_exports);
 
 // src/server.ts
 var import_express = __toESM(require("express"), 1);
-var fs2 = __toESM(require("fs"), 1);
+var fs3 = __toESM(require("fs"), 1);
 var import_http = require("http");
-var path2 = __toESM(require("path"), 1);
+var path3 = __toESM(require("path"), 1);
 var import_url = require("url");
 var import_ws = require("ws");
 var import_agentflow_core3 = require("agentflow-core");
@@ -997,10 +997,155 @@ var TraceWatcher = class extends import_events.EventEmitter {
   }
 };
 
+// src/cli.ts
+var fs2 = __toESM(require("fs"), 1);
+var os = __toESM(require("os"), 1);
+var path2 = __toESM(require("path"), 1);
+var VERSION = "0.3.1";
+function getLanAddress() {
+  const interfaces = os.networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    for (const iface of interfaces[name] || []) {
+      if (iface.family === "IPv4" && !iface.internal) {
+        return iface.address;
+      }
+    }
+  }
+  return null;
+}
+function printBanner(config, traceCount, stats) {
+  var _a;
+  const lan = getLanAddress();
+  const host = config.host || "localhost";
+  const port = config.port;
+  const isPublic = host === "0.0.0.0";
+  console.log(`
+   ___                    _   _____ _
+  / _ \\  __ _  ___ _ __ | |_|  ___| | _____      __
+ | |_| |/ _\` |/ _ \\ '_ \\| __| |_  | |/ _ \\ \\ /\\ / /
+ |  _  | (_| |  __/ | | | |_|  _| | | (_) \\ V  V /
+ |_| |_|\\__, |\\___|_| |_|\\__|_|   |_|\\___/ \\_/\\_/
+        |___/              dashboard v${VERSION}
+
+  See your agents think.
+
+  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510              \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510              \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+  \u2502  \u{1F916} Agents          \u2502  TRACE FILES \u2502  \u{1F4CA} AgentFlow      \u2502  SHOWS YOU   \u2502  \u{1F310} Your browser   \u2502
+  \u2502  Execute tasks,   \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500> \u2502  Reads traces,    \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500> \u2502  Interactive      \u2502
+  \u2502  write JSON       \u2502              \u2502  builds graphs,  \u2502              \u2502  graph, timeline, \u2502
+  \u2502  trace files.     \u2502              \u2502  serves dashboard.\u2502              \u2502  metrics, health. \u2502
+  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
+
+  Runs locally. Your data never leaves your machine.
+
+  Tabs: \u{1F3AF} Graph \xB7 \u23F1\uFE0F  Timeline \xB7 \u{1F4CA} Metrics \xB7 \u{1F6E0}\uFE0F  Process Health \xB7 \u26A0\uFE0F  Errors
+
+  Traces:     ${config.tracesDir}${((_a = config.dataDirs) == null ? void 0 : _a.length) ? "\n  Data dirs:  " + config.dataDirs.join("\n              ") : ""}
+  Loaded:     ${traceCount} traces \xB7 ${stats.totalAgents} agents \xB7 ${stats.totalExecutions} executions
+  Success:    ${stats.globalSuccessRate.toFixed(1)}%${stats.activeAgents > 0 ? ` \xB7 ${stats.activeAgents} active now` : ""}
+  CORS:       ${config.enableCors ? "enabled" : "disabled"}
+  WebSocket:  live updates enabled
+
+  \u2192 http://localhost:${port}${isPublic && lan ? `
+  \u2192 http://${lan}:${port}  (LAN)` : ""}
+`);
+}
+async function startDashboard() {
+  const args = process.argv.slice(2);
+  const config = {
+    port: 3e3,
+    tracesDir: "./traces",
+    host: "localhost",
+    enableCors: false
+  };
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case "--port":
+      case "-p":
+        config.port = parseInt(args[++i]) || 3e3;
+        break;
+      case "--traces":
+      case "-t":
+        config.tracesDir = args[++i];
+        break;
+      case "--host":
+      case "-h":
+        config.host = args[++i];
+        break;
+      case "--data-dir":
+        if (!config.dataDirs) config.dataDirs = [];
+        config.dataDirs.push(args[++i]);
+        break;
+      case "--cors":
+        config.enableCors = true;
+        break;
+      case "--help":
+        printHelp();
+        process.exit(0);
+    }
+  }
+  const tracesPath = path2.resolve(config.tracesDir);
+  if (!fs2.existsSync(tracesPath)) {
+    fs2.mkdirSync(tracesPath, { recursive: true });
+  }
+  config.tracesDir = tracesPath;
+  console.log("\nStarting AgentFlow Dashboard...\n");
+  const dashboard = new DashboardServer(config);
+  process.on("SIGINT", async () => {
+    console.log("\n\u{1F6D1} Shutting down dashboard...");
+    await dashboard.stop();
+    process.exit(0);
+  });
+  process.on("SIGTERM", async () => {
+    await dashboard.stop();
+    process.exit(0);
+  });
+  try {
+    await dashboard.start();
+    setTimeout(() => {
+      const stats = dashboard.getStats();
+      const traces = dashboard.getTraces();
+      printBanner(config, traces.length, stats);
+    }, 1500);
+  } catch (error) {
+    console.error("\u274C Failed to start dashboard:", error);
+    process.exit(1);
+  }
+}
+function printHelp() {
+  console.log(`
+\u{1F4CA} AgentFlow Dashboard v${VERSION} \u2014 See your agents think.
+
+Usage:
+  agentflow-dashboard [options]
+  npx agentflow-dashboard [options]
+
+Options:
+  -p, --port <number>     Server port (default: 3000)
+  -t, --traces <path>     Traces directory (default: ./traces)
+  -h, --host <address>    Host address (default: localhost)
+  --data-dir <path>       Extra data directory for process discovery (repeatable)
+  --cors                  Enable CORS headers
+  --help                  Show this help message
+
+Examples:
+  agentflow-dashboard --traces ./traces --host 0.0.0.0 --cors
+  agentflow-dashboard -p 8080 -t /var/log/agentflow
+  agentflow-dashboard --traces ./traces --data-dir ./workers --data-dir ./cron
+
+Tabs:
+  \u{1F3AF} Graph            Interactive Cytoscape.js execution graph
+  \u23F1\uFE0F  Timeline          Waterfall view of node durations
+  \u{1F4CA} Metrics           Success rates, durations, node breakdown
+  \u{1F6E0}\uFE0F  Process Health    PID files, systemd, workers, orphans
+  \u26A0\uFE0F  Errors            Failed and hung nodes with metadata
+`);
+}
+
 // src/server.ts
 var import_meta = {};
 var __filename = (0, import_url.fileURLToPath)(import_meta.url);
-var __dirname = path2.dirname(__filename);
+var __dirname = path3.dirname(__filename);
 var DashboardServer = class {
   constructor(config) {
     this.config = config;
@@ -1030,8 +1175,8 @@ var DashboardServer = class {
         next();
       });
     }
-    const publicDir = path2.join(__dirname, "../public");
-    if (fs2.existsSync(publicDir)) {
+    const publicDir = path3.join(__dirname, "../public");
+    if (fs3.existsSync(publicDir)) {
       this.app.use(import_express.default.static(publicDir));
     }
     this.app.get("/api/traces", (req, res) => {
@@ -1103,7 +1248,7 @@ var DashboardServer = class {
         }
         const discoveryDirs = [
           this.config.tracesDir,
-          path2.dirname(this.config.tracesDir),
+          path3.dirname(this.config.tracesDir),
           ...this.config.dataDirs || []
         ];
         const processConfig = (0, import_agentflow_core3.discoverProcessConfig)(discoveryDirs);
@@ -1118,8 +1263,8 @@ var DashboardServer = class {
       }
     });
     this.app.get("*", (req, res) => {
-      const indexPath = path2.join(__dirname, "../public/index.html");
-      if (fs2.existsSync(indexPath)) {
+      const indexPath = path3.join(__dirname, "../public/index.html");
+      if (fs3.existsSync(indexPath)) {
         res.sendFile(indexPath);
       } else {
         res.status(404).send("Dashboard not found - public files may not be built");
@@ -1176,21 +1321,21 @@ var DashboardServer = class {
     });
   }
   async start() {
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       const host = this.config.host || "localhost";
       this.server.listen(this.config.port, host, () => {
         console.log(`AgentFlow Dashboard running at http://${host}:${this.config.port}`);
         console.log(`Watching traces in: ${this.config.tracesDir}`);
-        resolve2();
+        resolve3();
       });
     });
   }
   async stop() {
-    return new Promise((resolve2) => {
+    return new Promise((resolve3) => {
       this.watcher.stop();
       this.server.close(() => {
         console.log("Dashboard server stopped");
-        resolve2();
+        resolve3();
       });
     });
   }
@@ -1201,6 +1346,9 @@ var DashboardServer = class {
     return this.watcher.getAllTraces();
   }
 };
+if (import_meta.url === `file://${process.argv[1]}`) {
+  startDashboard().catch(console.error);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AgentStats,

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   AgentStats,
   DashboardServer,
   TraceWatcher
-} from "./chunk-2FTN742J.js";
+} from "./chunk-EDHK4NJD.js";
 export {
   AgentStats,
   DashboardServer,