agentflow-dashboard 0.8.0 → 0.8.1

package/dist/{chunk-NZFXRZYU.js → chunk-JRVE5NM3.js}

@@ -94,6 +94,7 @@ import {
   getBottlenecks,
   loadGraph as loadGraph2
 } from "agentflow-core";
+import chokidar2 from "chokidar";
 import express from "express";
 import { WebSocketServer } from "ws";
 
@@ -868,7 +869,7 @@ var TraceWatcher = class _TraceWatcher extends EventEmitter {
       ...getSkipFiles(this.userConfig)
     ]);
     this.userSkipDirs = new Set(getSkipDirectories(this.userConfig));
-    this.allWatchDirs = [this.tracesDir, ...this.dataDirs];
+    this.allWatchDirs = [...new Set([this.tracesDir, ...this.dataDirs].map((d) => path.resolve(d)))];
     this.ensureTracesDir();
     this.loadExistingFiles();
     this.archiveOldTraces();
@@ -2172,7 +2173,9 @@ function printBanner(config, traceCount, stats, configPath) {
   \u2192 http://localhost:${port}${isPublic && lan ? `
   \u2192 http://${lan}:${port}  (LAN)` : ""}
 
-  Views:  Agent Profile \xB7 Execution Detail \xB7 Governance
+  Pages:  Agents \xB7 SOMA
+  Agent:  Profile \xB7 Execution Detail
+  SOMA:   Intelligence \xB7 Review \xB7 Policies \xB7 Knowledge \xB7 Activity
   Tabs:   Flame Chart \xB7 Agent Flow \xB7 Metrics \xB7 Dependencies
           State Machine \xB7 Summary \xB7 Transcript
 
@@ -2357,6 +2360,7 @@ var DashboardServer = class {
     this.setupExpress();
     this.setupWebSocket();
     this.setupTraceWatcher();
+    this.setupSomaReportWatcher();
     let knowledgeCount = 0;
     for (const trace of this.watcher.getAllTraces()) {
       this.stats.processTrace(trace);
@@ -2715,6 +2719,27 @@ var DashboardServer = class {
         res.status(500).json({ error: "Failed to load agent statistics" });
       }
     });
+    this.app.get("/api/soma/tier", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) {
+        return res.json({ tier: "teaser", somaVault: false, governanceAvailable: false });
+      }
+      try {
+        const reportPath = path3.join(somaVault, "..", "soma-report.json");
+        if (!fs3.existsSync(reportPath)) {
+          return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+        }
+        const report = JSON.parse(fs3.readFileSync(reportPath, "utf-8"));
+        const hasGovernance = report.governance && typeof report.governance.pending === "number";
+        return res.json({
+          tier: hasGovernance ? "pro" : "free",
+          somaVault: true,
+          governanceAvailable: !!hasGovernance
+        });
+      } catch {
+        return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+      }
+    });
     this.app.get("/api/soma/report", (_req, res) => {
       const somaVault = this.config.somaVault;
       if (!somaVault) {
@@ -2811,6 +2836,118 @@ var DashboardServer = class {
         res.status(404).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
       }
     });
+    this.app.get("/api/soma/policies", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.json({ policies: [] });
+      try {
+        const reportPath = path3.join(somaVault, "..", "soma-report.json");
+        if (!fs3.existsSync(reportPath)) return res.json({ policies: [] });
+        const report = JSON.parse(fs3.readFileSync(reportPath, "utf-8"));
+        res.json({ policies: report.policies ?? [] });
+      } catch {
+        res.json({ policies: [] });
+      }
+    });
+    this.app.post("/api/soma/policies", express.json(), (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      const { name, enforcement, scope, conditions } = req.body ?? {};
+      if (!name) return res.status(400).json({ error: "name required" });
+      try {
+        const safeName = sanitizeArg(String(name));
+        const safeEnf = sanitizeArg(String(enforcement || "warn"));
+        const safeScope = sanitizeReason(String(scope || "all"));
+        const safeCond = sanitizeReason(String(conditions || ""));
+        const result = execSync(
+          `npx soma policy create "${safeName}" --enforcement ${safeEnf} --scope "${safeScope}" --conditions "${safeCond}" --vault "${somaVault}"`,
+          { encoding: "utf-8", timeout: 1e4 }
+        );
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.delete("/api/soma/policies/:name", (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      try {
+        const safeName = sanitizeArg(String(req.params.name));
+        const result = execSync(
+          `npx soma policy delete "${safeName}" --vault "${somaVault}"`,
+          { encoding: "utf-8", timeout: 1e4 }
+        );
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.get("/api/soma/vault/entities", (req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.json({ entities: [], total: 0 });
+      try {
+        const reportPath = path3.join(somaVault, "..", "soma-report.json");
+        if (!fs3.existsSync(reportPath)) return res.json({ entities: [], total: 0 });
+        const report = JSON.parse(fs3.readFileSync(reportPath, "utf-8"));
+        let entities = [
+          ...(report.agents ?? []).map((a) => ({ ...a, type: "agent", id: a.name })),
+          ...(report.insights ?? []).map((i, idx) => {
+            var _a;
+            return { ...i, type: i.type || "insight", id: ((_a = i.title) == null ? void 0 : _a.replace(/\s+/g, "-").toLowerCase()) || `insight-${idx}` };
+          }),
+          ...(report.policies ?? []).map((p) => ({ ...p, type: "policy", id: p.name }))
+        ];
+        const { type, layer, q, limit: limitStr, offset: offsetStr } = req.query;
+        if (type) entities = entities.filter((e) => e.type === type);
+        if (layer) entities = entities.filter((e) => e.layer === layer);
+        if (q) {
+          const lq = q.toLowerCase();
+          entities = entities.filter((e) => (e.name || e.title || "").toLowerCase().includes(lq) || (e.claim || e.body || "").toLowerCase().includes(lq));
+        }
+        const total = entities.length;
+        const offset = parseInt(offsetStr || "0", 10);
+        const limit = Math.min(parseInt(limitStr || "50", 10), 200);
+        entities = entities.slice(offset, offset + limit);
+        res.json({ entities, total });
+      } catch (error) {
+        console.error("Vault entities error:", error);
+        res.json({ entities: [], total: 0 });
+      }
+    });
+    this.app.get("/api/soma/vault/entities/:type/:id", (req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(404).json({ error: "Soma vault not configured" });
+      try {
+        const reportPath = path3.join(somaVault, "..", "soma-report.json");
+        const report = JSON.parse(fs3.readFileSync(reportPath, "utf-8"));
+        const { type, id } = req.params;
+        let entity = null;
+        if (type === "agent") {
+          entity = (report.agents ?? []).find((a) => a.name === id);
+        } else if (type === "policy") {
+          entity = (report.policies ?? []).find((p) => p.name === id);
+        } else {
+          entity = (report.insights ?? []).find(
+            (i) => {
+              var _a;
+              return (((_a = i.title) == null ? void 0 : _a.replace(/\s+/g, "-").toLowerCase()) || "") === id || i.title === id;
+            }
+          );
+        }
+        if (!entity) return res.status(404).json({ error: "Entity not found" });
+        res.json({
+          ...entity,
+          type,
+          id,
+          body: entity.claim || entity.conditions || "",
+          tags: entity.tags ?? [],
+          related: entity.related ?? []
+        });
+      } catch {
+        res.status(404).json({ error: "Entity not found" });
+      }
+    });
     this.app.get("/api/process-health", (_req, res) => {
       var _a, _b;
       try {
@@ -2914,11 +3051,11 @@ var DashboardServer = class {
           }
         } catch {
         }
-        const watched = [
+        const watched = [...new Set([
           this.config.tracesDir,
           ...this.config.dataDirs || [],
           ...extraDirs
-        ];
+        ].map((w) => path3.resolve(w)))];
         const discovered = [];
         const svcNames = getSystemdServices(this.userConfig);
         if (svcNames.length > 0) {
@@ -3072,6 +3209,41 @@ var DashboardServer = class {
       });
     });
   }
+  /** Watch soma-report.json for changes and broadcast updates via WebSocket. */
+  setupSomaReportWatcher() {
+    const somaVault = this.config.somaVault;
+    if (!somaVault) return;
+    const reportPath = path3.join(somaVault, "..", "soma-report.json");
+    const reportDir = path3.dirname(reportPath);
+    if (!fs3.existsSync(reportDir)) return;
+    let debounceTimer = null;
+    const watcher = chokidar2.watch(reportPath, {
+      ignoreInitial: true,
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 500 }
+    });
+    watcher.on("change", () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        var _a, _b;
+        try {
+          const report = JSON.parse(fs3.readFileSync(reportPath, "utf-8"));
+          this.broadcast({ type: "soma-report-updated", data: report });
+          if (report.generatedAt) {
+            this.broadcast({
+              type: "soma-activity",
+              data: {
+                action: "report-updated",
+                description: `Report updated: ${((_a = report.totals) == null ? void 0 : _a.agents) ?? 0} agents, ${((_b = report.totals) == null ? void 0 : _b.insights) ?? 0} insights`,
+                timestamp: report.generatedAt
+              }
+            });
+          }
+        } catch {
+        }
+      }, 500);
+    });
+  }
   /**
    * Filter an agent's traces to valid ExecutionGraphs and convert via loadGraph().
    * Returns only traces with proper nodes (Map or non-empty object), skipping session-only traces.

package/dist/cli.cjs

@@ -116,6 +116,7 @@ function getProcessPreference(config) {
 
 // src/server.ts
 var import_agentflow_core3 = require("agentflow-core");
+var import_chokidar2 = __toESM(require("chokidar"), 1);
 var import_express = __toESM(require("express"), 1);
 var import_ws = require("ws");
 
@@ -890,7 +891,7 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
       ...getSkipFiles(this.userConfig)
     ]);
     this.userSkipDirs = new Set(getSkipDirectories(this.userConfig));
-    this.allWatchDirs = [this.tracesDir, ...this.dataDirs];
+    this.allWatchDirs = [...new Set([this.tracesDir, ...this.dataDirs].map((d) => path.resolve(d)))];
     this.ensureTracesDir();
     this.loadExistingFiles();
     this.archiveOldTraces();
@@ -2202,6 +2203,7 @@ var DashboardServer = class {
     this.setupExpress();
     this.setupWebSocket();
     this.setupTraceWatcher();
+    this.setupSomaReportWatcher();
     let knowledgeCount = 0;
     for (const trace of this.watcher.getAllTraces()) {
       this.stats.processTrace(trace);
@@ -2560,6 +2562,27 @@ var DashboardServer = class {
         res.status(500).json({ error: "Failed to load agent statistics" });
       }
     });
+    this.app.get("/api/soma/tier", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) {
+        return res.json({ tier: "teaser", somaVault: false, governanceAvailable: false });
+      }
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) {
+          return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+        }
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        const hasGovernance = report.governance && typeof report.governance.pending === "number";
+        return res.json({
+          tier: hasGovernance ? "pro" : "free",
+          somaVault: true,
+          governanceAvailable: !!hasGovernance
+        });
+      } catch {
+        return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+      }
+    });
     this.app.get("/api/soma/report", (_req, res) => {
       const somaVault = this.config.somaVault;
       if (!somaVault) {
@@ -2656,6 +2679,118 @@ var DashboardServer = class {
         res.status(404).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
       }
     });
+    this.app.get("/api/soma/policies", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.json({ policies: [] });
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) return res.json({ policies: [] });
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        res.json({ policies: report.policies ?? [] });
+      } catch {
+        res.json({ policies: [] });
+      }
+    });
+    this.app.post("/api/soma/policies", import_express.default.json(), (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      const { name, enforcement, scope, conditions } = req.body ?? {};
+      if (!name) return res.status(400).json({ error: "name required" });
+      try {
+        const safeName = sanitizeArg(String(name));
+        const safeEnf = sanitizeArg(String(enforcement || "warn"));
+        const safeScope = sanitizeReason(String(scope || "all"));
+        const safeCond = sanitizeReason(String(conditions || ""));
+        const result = (0, import_node_child_process.execSync)(
+          `npx soma policy create "${safeName}" --enforcement ${safeEnf} --scope "${safeScope}" --conditions "${safeCond}" --vault "${somaVault}"`,
+          { encoding: "utf-8", timeout: 1e4 }
+        );
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.delete("/api/soma/policies/:name", (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      try {
+        const safeName = sanitizeArg(String(req.params.name));
+        const result = (0, import_node_child_process.execSync)(
+          `npx soma policy delete "${safeName}" --vault "${somaVault}"`,
+          { encoding: "utf-8", timeout: 1e4 }
+        );
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.get("/api/soma/vault/entities", (req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.json({ entities: [], total: 0 });
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) return res.json({ entities: [], total: 0 });
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        let entities = [
+          ...(report.agents ?? []).map((a) => ({ ...a, type: "agent", id: a.name })),
+          ...(report.insights ?? []).map((i, idx) => {
+            var _a;
+            return { ...i, type: i.type || "insight", id: ((_a = i.title) == null ? void 0 : _a.replace(/\s+/g, "-").toLowerCase()) || `insight-${idx}` };
+          }),
+          ...(report.policies ?? []).map((p) => ({ ...p, type: "policy", id: p.name }))
+        ];
+        const { type, layer, q, limit: limitStr, offset: offsetStr } = req.query;
+        if (type) entities = entities.filter((e) => e.type === type);
+        if (layer) entities = entities.filter((e) => e.layer === layer);
+        if (q) {
+          const lq = q.toLowerCase();
+          entities = entities.filter((e) => (e.name || e.title || "").toLowerCase().includes(lq) || (e.claim || e.body || "").toLowerCase().includes(lq));
+        }
+        const total = entities.length;
+        const offset = parseInt(offsetStr || "0", 10);
+        const limit = Math.min(parseInt(limitStr || "50", 10), 200);
+        entities = entities.slice(offset, offset + limit);
+        res.json({ entities, total });
+      } catch (error) {
+        console.error("Vault entities error:", error);
+        res.json({ entities: [], total: 0 });
+      }
+    });
+    this.app.get("/api/soma/vault/entities/:type/:id", (req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(404).json({ error: "Soma vault not configured" });
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        const { type, id } = req.params;
+        let entity = null;
+        if (type === "agent") {
+          entity = (report.agents ?? []).find((a) => a.name === id);
+        } else if (type === "policy") {
+          entity = (report.policies ?? []).find((p) => p.name === id);
+        } else {
+          entity = (report.insights ?? []).find(
+            (i) => {
+              var _a;
+              return (((_a = i.title) == null ? void 0 : _a.replace(/\s+/g, "-").toLowerCase()) || "") === id || i.title === id;
+            }
+          );
+        }
+        if (!entity) return res.status(404).json({ error: "Entity not found" });
+        res.json({
+          ...entity,
+          type,
+          id,
+          body: entity.claim || entity.conditions || "",
+          tags: entity.tags ?? [],
+          related: entity.related ?? []
+        });
+      } catch {
+        res.status(404).json({ error: "Entity not found" });
+      }
+    });
     this.app.get("/api/process-health", (_req, res) => {
       var _a, _b;
       try {
@@ -2759,11 +2894,11 @@ var DashboardServer = class {
           }
         } catch {
         }
-        const watched = [
+        const watched = [...new Set([
           this.config.tracesDir,
           ...this.config.dataDirs || [],
           ...extraDirs
-        ];
+        ].map((w) => path2.resolve(w)))];
         const discovered = [];
         const svcNames = getSystemdServices(this.userConfig);
         if (svcNames.length > 0) {
@@ -2917,6 +3052,41 @@ var DashboardServer = class {
       });
     });
   }
+  /** Watch soma-report.json for changes and broadcast updates via WebSocket. */
+  setupSomaReportWatcher() {
+    const somaVault = this.config.somaVault;
+    if (!somaVault) return;
+    const reportPath = path2.join(somaVault, "..", "soma-report.json");
+    const reportDir = path2.dirname(reportPath);
+    if (!fs2.existsSync(reportDir)) return;
+    let debounceTimer = null;
+    const watcher = import_chokidar2.default.watch(reportPath, {
+      ignoreInitial: true,
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 500 }
+    });
+    watcher.on("change", () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        var _a, _b;
+        try {
+          const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+          this.broadcast({ type: "soma-report-updated", data: report });
+          if (report.generatedAt) {
+            this.broadcast({
+              type: "soma-activity",
+              data: {
+                action: "report-updated",
+                description: `Report updated: ${((_a = report.totals) == null ? void 0 : _a.agents) ?? 0} agents, ${((_b = report.totals) == null ? void 0 : _b.insights) ?? 0} insights`,
+                timestamp: report.generatedAt
+              }
+            });
+          }
+        } catch {
+        }
+      }, 500);
+    });
+  }
   /**
    * Filter an agent's traces to valid ExecutionGraphs and convert via loadGraph().
    * Returns only traces with proper nodes (Map or non-empty object), skipping session-only traces.
@@ -3233,7 +3403,9 @@ function printBanner(config, traceCount, stats, configPath) {
   \u2192 http://localhost:${port}${isPublic && lan ? `
   \u2192 http://${lan}:${port}  (LAN)` : ""}
 
-  Views:  Agent Profile \xB7 Execution Detail \xB7 Governance
+  Pages:  Agents \xB7 SOMA
+  Agent:  Profile \xB7 Execution Detail
+  SOMA:   Intelligence \xB7 Review \xB7 Policies \xB7 Knowledge \xB7 Activity
   Tabs:   Flame Chart \xB7 Agent Flow \xB7 Metrics \xB7 Dependencies
           State Machine \xB7 Summary \xB7 Transcript
 

package/dist/cli.js

@@ -1,6 +1,6 @@
 import {
   startDashboard
-} from "./chunk-NZFXRZYU.js";
+} from "./chunk-JRVE5NM3.js";
 export {
   startDashboard
 };