network-ai 4.15.3 → 5.1.0

package/dist/lib/work-tree-dashboard.d.ts

@@ -0,0 +1,130 @@
+/**
+ * WorkTreeDashboard — Browser-based live WorkTree visualization
+ *
+ * Serves a single-page HTML dashboard over HTTP and streams WorkTree
+ * state changes over WebSocket. Zero external dependencies — uses only
+ * Node.js built-in modules.
+ *
+ * Follows the same architecture as {@link DashboardServer} for the
+ * TopologyTracker but renders a hierarchical task tree instead of a
+ * force-directed graph.
+ *
+ * @module WorkTreeDashboard
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import type { WorkTree } from './work-tree';
+/** Options for WorkTreeDashboard */
+export interface WorkTreeDashboardOptions {
+    /** TCP port to listen on (default: 4821) */
+    port?: number;
+    /** Hostname to bind to (default: '127.0.0.1') */
+    host?: string;
+}
+/** A single agent log entry */
+export interface AgentLogEntry {
+    time: string;
+    message: string;
+    level: 'info' | 'warn' | 'error';
+}
+/** Agent state as sent to the dashboard */
+export interface DashboardAgentInfo {
+    name: string;
+    role: 'orchestrator' | 'worker';
+    status: 'idle' | 'busy' | 'error';
+    tasks: Array<{
+        id: string;
+        label: string;
+        status: string;
+    }>;
+    currentTask: string | null;
+    logs: AgentLogEntry[];
+    tokens: number;
+}
+/** A detected system-wide diagnostic entry */
+export interface SystemDiagnostic {
+    level: 'info' | 'warn' | 'error';
+    category: string;
+    message: string;
+    agent?: string;
+    taskId?: string;
+}
+/** System health summary sent to the dashboard */
+export interface SystemHealth {
+    status: 'healthy' | 'warning' | 'critical';
+    summary: string;
+    diagnostics: SystemDiagnostic[];
+}
+/**
+ * HTTP + WebSocket server for live WorkTree visualization.
+ *
+ * ```typescript
+ * const tree = new WorkTree('root', 'My Project');
+ * const dashboard = new WorkTreeDashboard(tree, { port: 4821 });
+ * await dashboard.start();
+ * // Open http://127.0.0.1:4821 in your browser
+ * ```
+ */
+export declare class WorkTreeDashboard extends EventEmitter {
+    private readonly tree;
+    private readonly port;
+    private readonly host;
+    private server;
+    private clients;
+    private pingInterval;
+    private eventHandlers;
+    private clientCounter;
+    private deltaPending;
+    private agentLogs;
+    private orchestratorLogs;
+    private orchestratorAgent;
+    constructor(tree: WorkTree, options?: WorkTreeDashboardOptions);
+    /**
+     * Start the dashboard server.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the dashboard server.
+     */
+    stop(): Promise<void>;
+    /** Number of connected WebSocket clients. */
+    clientCount(): number;
+    /** The URL the dashboard is serving on. */
+    get url(): string;
+    /**
+     * Designate an agent as the orchestrator (shown at the top of the Agents tab).
+     */
+    setOrchestrator(agentName: string): void;
+    /**
+     * Push a log entry for an agent. Triggers a broadcast to connected clients.
+     *
+     * @param agent  - The agent name (must match `node.agent` in the tree)
+     * @param message - Log message text
+     * @param level   - Severity: 'info' | 'warn' | 'error' (default: 'info')
+     */
+    pushLog(agent: string, message: string, level?: 'info' | 'warn' | 'error'): void;
+    /**
+     * Push a narrative message to the orchestrator log (not tied to a specific agent).
+     */
+    pushNarrative(message: string): void;
+    private subscribeToTree;
+    private unsubscribeFromTree;
+    private handleHTTP;
+    private handleUpgrade;
+    private sendSnapshot;
+    /**
+     * Broadcast a delta (changed nodes + stats) to all clients.
+     * Debounced via queueMicrotask to batch rapid events per tick.
+     */
+    private broadcastUpdate;
+    /**
+     * Build agent map from tree snapshot + stored logs.
+     */
+    private buildAgentMap;
+    /**
+     * Analyze system state and detect issues, stalls, and failures.
+     */
+    private computeDiagnostics;
+    private pingClients;
+}
+//# sourceMappingURL=work-tree-dashboard.d.ts.map

package/dist/lib/work-tree-dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-tree-dashboard.d.ts","sourceRoot":"","sources":["../../lib/work-tree-dashboard.ts"],"names":[],"mappings":"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"}