shroud-privacy 2.2.9 → 2.2.11

package/dist/dashboard.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Real-time security dashboard — lightweight HTTP endpoint.
+ *
+ * Serves JSON snapshots of all agent sessions, security events,
+ * profiling baselines, and injection detection stats. Designed
+ * for Grafana, custom UIs, or direct curl consumption.
+ *
+ * Zero external dependencies — uses Node's built-in http module.
+ *
+ * Endpoints:
+ *   GET /health                    — liveness check
+ *   GET /api/overview              — high-level security summary
+ *   GET /api/agents                — all agent sessions with profiling status
+ *   GET /api/agents/:buildId       — single agent detail
+ *   GET /api/events                — recent security events (last 100)
+ *   GET /api/events/stream         — SSE stream of security events (real-time)
+ *   GET /api/profiling             — profiling baselines for all agents
+ *   GET /api/profiling/:buildId    — single agent baseline detail
+ *   GET /api/stats                 — obfuscation + security stats combined
+ */
+import { createServer } from "node:http";
+import type { SecurityEventBus } from "./security-event.js";
+import type { AgentSessionTracker } from "./agent-session.js";
+import type { BaselineStore } from "./profiler-store.js";
+import type { Obfuscator } from "./obfuscator.js";
+import type { BehaviouralProfiler } from "./profiler.js";
+import type { ShroudConfig } from "./types.js";
+import type { PolicyEngine } from "./policy.js";
+export interface DashboardDeps {
+    securityBus: SecurityEventBus | null;
+    agentTracker: AgentSessionTracker;
+    baselineStore: BaselineStore | null;
+    obfuscator: Obfuscator;
+    profiler: BehaviouralProfiler | null;
+    config: ShroudConfig;
+    policyEngine: PolicyEngine | null;
+}
+/**
+ * Start the dashboard HTTP server.
+ * Returns the server instance for cleanup.
+ */
+export declare function startDashboard(port: number, deps: DashboardDeps): ReturnType<typeof createServer>;