maestro-flow 0.1.0

package/dashboard/dist-server/server/ws/handlers/execution-handler.js

@@ -0,0 +1,157 @@
+import { loadDashboardAgentSettings } from '../../config.js';
+import { readIssuesJsonl, writeIssuesJsonl, withIssueWriteLock } from '../../utils/issue-store.js';
+// ---------------------------------------------------------------------------
+// ExecutionWsHandler — execute:issue, execute:batch, execute:wave,
+//                      supervisor:toggle, issue:analyze, issue:plan
+// ---------------------------------------------------------------------------
+export class ExecutionWsHandler {
+    executionScheduler;
+    waveExecutor;
+    agentManager;
+    eventBus;
+    workflowRoot;
+    agentHandler;
+    actions = [
+        'execute:issue',
+        'execute:batch',
+        'execute:wave',
+        'supervisor:toggle',
+        'issue:analyze',
+        'issue:plan',
+        'issue:pipeline',
+    ];
+    constructor(executionScheduler, waveExecutor, agentManager, eventBus, workflowRoot, agentHandler) {
+        this.executionScheduler = executionScheduler;
+        this.waveExecutor = waveExecutor;
+        this.agentManager = agentManager;
+        this.eventBus = eventBus;
+        this.workflowRoot = workflowRoot;
+        this.agentHandler = agentHandler;
+    }
+    async handle(action, data, ws, _broadcast) {
+        const msg = data;
+        switch (action) {
+            case 'execute:issue':
+                await this.executionScheduler.executeIssue(msg.issueId, msg.executor);
+                break;
+            case 'execute:batch':
+                await this.executionScheduler.executeBatch(msg.issueIds, msg.executor, msg.maxConcurrency);
+                break;
+            case 'execute:wave':
+                await this.handleWaveExecute(ws, msg.issueId);
+                break;
+            case 'supervisor:toggle':
+                if (msg.config) {
+                    this.executionScheduler.updateConfig(msg.config);
+                }
+                if (msg.enabled === true) {
+                    this.executionScheduler.startSupervisor();
+                }
+                else if (msg.enabled === false) {
+                    this.executionScheduler.stopSupervisor();
+                }
+                break;
+            case 'issue:analyze':
+                if (!msg.issueId) {
+                    throw new Error('Missing issueId');
+                }
+                await this.handleIssueAnalyze(ws, msg.issueId, msg.tool, msg.depth);
+                break;
+            case 'issue:plan':
+                if (!msg.issueId) {
+                    throw new Error('Missing issueId');
+                }
+                await this.handleIssuePlan(ws, msg.issueId, msg.tool);
+                break;
+            case 'issue:pipeline':
+                if (!msg.issueId) {
+                    throw new Error('Missing issueId');
+                }
+                await this.handleIssuePipeline(msg.issueId, msg.tool);
+                break;
+        }
+    }
+    async handleWaveExecute(ws, issueId) {
+        if (!issueId) {
+            throw new Error('Missing issueId');
+        }
+        const { join } = await import('node:path');
+        const jsonlPath = join(this.workflowRoot, 'issues', 'issues.jsonl');
+        const issues = await readIssuesJsonl(jsonlPath);
+        const issue = issues.find((i) => i.id === issueId);
+        if (!issue) {
+            throw new Error(`Issue not found: ${issueId}`);
+        }
+        await this.waveExecutor.execute(issue);
+    }
+    async handleIssuePipeline(issueId, tool) {
+        const { join } = await import('node:path');
+        const jsonlPath = join(this.workflowRoot, 'issues', 'issues.jsonl');
+        // Read issue and derive chain mode from current state
+        const issues = await readIssuesJsonl(jsonlPath);
+        const issue = issues.find((i) => i.id === issueId);
+        if (!issue) {
+            throw new Error(`Issue not found: ${issueId}`);
+        }
+        const mode = resolveChainMode(issue);
+        // Write chain config into solution (create stub if absent)
+        await withIssueWriteLock(async () => {
+            const freshIssues = await readIssuesJsonl(jsonlPath);
+            const idx = freshIssues.findIndex((i) => i.id === issueId);
+            if (idx === -1)
+                return;
+            const target = freshIssues[idx];
+            target.solution = {
+                steps: [],
+                ...target.solution,
+                chain: 'issue-lifecycle',
+                chainMode: mode,
+            };
+            target.updated_at = new Date().toISOString();
+            freshIssues[idx] = target;
+            await writeIssuesJsonl(jsonlPath, freshIssues);
+        });
+        // Dispatch via existing executeIssue — it routes to dispatchViaChain when solution.chain is set
+        const executor = tool || undefined;
+        await this.executionScheduler.executeIssue(issueId, executor);
+    }
+    async handleIssueAnalyze(ws, issueId, tool, depth) {
+        const resolvedTool = tool || 'gemini';
+        const resolvedDepth = depth || 'standard';
+        const prompt = `/manage-issue-analyze ${issueId} --tool ${resolvedTool} --depth ${resolvedDepth}`;
+        await this.buildIssuePromptAndSpawn(ws, issueId, () => prompt);
+    }
+    async handleIssuePlan(ws, issueId, tool) {
+        const resolvedTool = tool || 'gemini';
+        const prompt = `/manage-issue-plan ${issueId} --tool ${resolvedTool}`;
+        await this.buildIssuePromptAndSpawn(ws, issueId, () => prompt);
+    }
+    async buildIssuePromptAndSpawn(ws, issueId, buildPrompt) {
+        const { join } = await import('node:path');
+        const jsonlPath = join(this.workflowRoot, 'issues', 'issues.jsonl');
+        const issues = await readIssuesJsonl(jsonlPath);
+        const issue = issues.find((i) => i.id === issueId);
+        if (!issue) {
+            throw new Error(`Issue not found: ${issueId}`);
+        }
+        const savedSettings = await loadDashboardAgentSettings(this.workflowRoot, 'agent-sdk');
+        const agentType = (savedSettings?.settingsFile || savedSettings?.baseUrl || savedSettings?.apiKey)
+            ? 'agent-sdk'
+            : 'claude-code';
+        const prompt = buildPrompt(issue, agentType);
+        await this.agentHandler.mergeSettingsAndSpawn(ws, {
+            type: agentType,
+            prompt,
+            workDir: this.workflowRoot,
+            approvalMode: 'auto',
+        });
+    }
+}
+function resolveChainMode(issue) {
+    if (issue.solution && issue.solution.steps.length > 0)
+        return 'direct';
+    if (issue.analysis)
+        return 'plan-execute';
+    return 'full';
+}
+//# sourceMappingURL=execution-handler.js.map

package/dashboard/dist-server/server/ws/handlers/execution-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-handler.js","sourceRoot":"","sources":["../../../../src/server/ws/handlers/execution-handler.ts"],"names":[],"mappings":"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"}

package/dashboard/dist-server/server/ws/handlers/requirement-handler.d.ts

@@ -0,0 +1,10 @@
+import type { WebSocket } from 'ws';
+import type { WsHandler } from '../ws-handler.js';
+import type { WsEventType } from '../../../shared/ws-protocol.js';
+import type { RequirementExpander } from '../../requirement/requirement-expander.js';
+export declare class RequirementWsHandler implements WsHandler {
+    private readonly requirementExpander;
+    readonly actions: readonly ["requirement:expand", "requirement:refine", "requirement:commit"];
+    constructor(requirementExpander: RequirementExpander);
+    handle(action: string, data: unknown, _ws: WebSocket, broadcast: (type: WsEventType, data: unknown) => void): Promise<void>;
+}

package/dashboard/dist-server/server/ws/handlers/requirement-handler.js

@@ -0,0 +1,50 @@
+// ---------------------------------------------------------------------------
+// RequirementWsHandler — requirement:expand, requirement:refine,
+//                         requirement:commit
+// ---------------------------------------------------------------------------
+export class RequirementWsHandler {
+    requirementExpander;
+    actions = [
+        'requirement:expand',
+        'requirement:refine',
+        'requirement:commit',
+    ];
+    constructor(requirementExpander) {
+        this.requirementExpander = requirementExpander;
+    }
+    async handle(action, data, _ws, broadcast) {
+        const msg = data;
+        switch (action) {
+            case 'requirement:expand': {
+                const requirement = await this.requirementExpander.expand(msg.text, msg.depth, msg.method, msg.previousRequirementId);
+                broadcast('requirement:expanded', { requirement });
+                break;
+            }
+            case 'requirement:refine': {
+                const requirement = await this.requirementExpander.refine(msg.requirementId, msg.feedback);
+                broadcast('requirement:expanded', { requirement });
+                break;
+            }
+            case 'requirement:commit': {
+                if (msg.mode === 'issues') {
+                    const issueIds = await this.requirementExpander.commitAsIssues(msg.requirementId);
+                    broadcast('requirement:committed', {
+                        requirementId: msg.requirementId,
+                        mode: 'issues',
+                        issueIds,
+                    });
+                }
+                else {
+                    const coordinateSessionId = await this.requirementExpander.commitAsCoordinate(msg.requirementId);
+                    broadcast('requirement:committed', {
+                        requirementId: msg.requirementId,
+                        mode: 'coordinate',
+                        coordinateSessionId,
+                    });
+                }
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=requirement-handler.js.map

package/dashboard/dist-server/server/ws/handlers/requirement-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-handler.js","sourceRoot":"","sources":["../../../../src/server/ws/handlers/requirement-handler.ts"],"names":[],"mappings":"AAOA,8EAA8E;AAC9E,iEAAiE;AACjE,6CAA6C;AAC7C,8EAA8E;AAE9E,MAAM,OAAO,oBAAoB;IAOF;IANpB,OAAO,GAAG;QACjB,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;KACZ,CAAC;IAEX,YAA6B,mBAAwC;QAAxC,wBAAmB,GAAnB,mBAAmB,CAAqB;IAAG,CAAC;IAEzE,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAAa,EACb,GAAc,EACd,SAAqD;QAErD,MAAM,GAAG,GAAG,IAA+B,CAAC;QAE5C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CACvD,GAAG,CAAC,IAAc,EAClB,GAAG,CAAC,KAAmC,EACvC,GAAG,CAAC,MAAmC,EACvC,GAAG,CAAC,qBAA2C,CAChD,CAAC;gBACF,SAAS,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR,CAAC;YAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,MAAM,CACvD,GAAG,CAAC,aAAuB,EAC3B,GAAG,CAAC,QAAkB,CACvB,CAAC;gBACF,SAAS,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;gBACnD,MAAM;YACR,CAAC;YAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;gBAC1B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAC5D,GAAG,CAAC,aAAuB,CAC5B,CAAC;oBACF,SAAS,CAAC,uBAAuB,EAAE;wBACjC,aAAa,EAAE,GAAG,CAAC,aAAa;wBAChC,IAAI,EAAE,QAAQ;wBACd,QAAQ;qBACT,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,kBAAkB,CAC3E,GAAG,CAAC,aAAuB,CAC5B,CAAC;oBACF,SAAS,CAAC,uBAAuB,EAAE;wBACjC,aAAa,EAAE,GAAG,CAAC,aAAa;wBAChC,IAAI,EAAE,YAAY;wBAClB,mBAAmB;qBACpB,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dashboard/dist-server/server/ws/handlers/supervisor-handler.d.ts

@@ -0,0 +1,12 @@
+import { WebSocket } from 'ws';
+import type { WsHandler } from '../ws-handler.js';
+import type { WsEventType } from '../../../shared/ws-protocol.js';
+import type { SelfLearningService } from '../../supervisor/self-learning-service.js';
+import type { TaskSchedulerService } from '../../supervisor/task-scheduler-service.js';
+export declare class SupervisorWsHandler implements WsHandler {
+    private readonly learningService;
+    private readonly schedulerService;
+    readonly actions: readonly ["supervisor:learning", "supervisor:schedule"];
+    constructor(learningService: SelfLearningService, schedulerService: TaskSchedulerService);
+    handle(action: string, data: unknown, ws: WebSocket, _broadcast: (type: WsEventType, data: unknown) => void): Promise<void>;
+}

package/dashboard/dist-server/server/ws/handlers/supervisor-handler.js

@@ -0,0 +1,35 @@
+import { WebSocket } from 'ws';
+// ---------------------------------------------------------------------------
+// SupervisorWsHandler -- real-time supervisor data queries
+//   supervisor:learning  -> returns current learning stats
+//   supervisor:schedule  -> returns current scheduled tasks
+// ---------------------------------------------------------------------------
+export class SupervisorWsHandler {
+    learningService;
+    schedulerService;
+    actions = [
+        'supervisor:learning',
+        'supervisor:schedule',
+    ];
+    constructor(learningService, schedulerService) {
+        this.learningService = learningService;
+        this.schedulerService = schedulerService;
+    }
+    async handle(action, data, ws, _broadcast) {
+        if (ws.readyState !== WebSocket.OPEN)
+            return;
+        switch (action) {
+            case 'supervisor:learning': {
+                const stats = this.learningService.getStats();
+                ws.send(JSON.stringify({ type: 'supervisor:learning_update', data: stats }));
+                break;
+            }
+            case 'supervisor:schedule': {
+                const tasks = this.schedulerService.listTasks();
+                ws.send(JSON.stringify({ type: 'supervisor:schedule_update', data: { tasks } }));
+                break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=supervisor-handler.js.map

package/dashboard/dist-server/server/ws/handlers/supervisor-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-handler.js","sourceRoot":"","sources":["../../../../src/server/ws/handlers/supervisor-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAO/B,8EAA8E;AAC9E,2DAA2D;AAC3D,2DAA2D;AAC3D,4DAA4D;AAC5D,8EAA8E;AAE9E,MAAM,OAAO,mBAAmB;IAOX;IACA;IAPV,OAAO,GAAG;QACjB,qBAAqB;QACrB,qBAAqB;KACb,CAAC;IAEX,YACmB,eAAoC,EACpC,gBAAsC;QADtC,oBAAe,GAAf,eAAe,CAAqB;QACpC,qBAAgB,GAAhB,gBAAgB,CAAsB;IACtD,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,MAAc,EACd,IAAa,EACb,EAAa,EACb,UAAsD;QAEtD,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YAAE,OAAO;QAE7C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;gBAC9C,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC7E,MAAM;YACR,CAAC;YAED,KAAK,qBAAqB,CAAC,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC;gBAChD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;gBACjF,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dashboard/dist-server/server/ws/handlers/supervisor-handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dashboard/dist-server/server/ws/handlers/supervisor-handler.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { SupervisorWsHandler } from './supervisor-handler.js';
+// ---------------------------------------------------------------------------
+// Mock WebSocket
+// ---------------------------------------------------------------------------
+class MockWebSocket {
+    readyState = 1; // WebSocket.OPEN
+    sent = [];
+    send(data) { this.sent.push(data); }
+}
+// ---------------------------------------------------------------------------
+// Mock services
+// ---------------------------------------------------------------------------
+class MockLearningService {
+    getStats() {
+        return {
+            totalCommands: 10,
+            uniquePatterns: 3,
+            topPatterns: [],
+            suggestions: [],
+            knowledgeBaseSize: 5,
+        };
+    }
+}
+class MockSchedulerService {
+    listTasks() {
+        return [
+            {
+                id: 'task-1',
+                name: 'Health Check',
+                cronExpression: '0 * * * *',
+                taskType: 'health-check',
+                config: {},
+                enabled: true,
+                lastRun: null,
+                nextRun: null,
+                history: [],
+            },
+        ];
+    }
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('SupervisorWsHandler', () => {
+    let handler;
+    let ws;
+    let broadcast;
+    beforeEach(() => {
+        handler = new SupervisorWsHandler(new MockLearningService(), new MockSchedulerService());
+        ws = new MockWebSocket();
+        broadcast = vi.fn();
+    });
+    describe('actions', () => {
+        it('declares supervisor:learning and supervisor:schedule actions', () => {
+            expect(handler.actions).toContain('supervisor:learning');
+            expect(handler.actions).toContain('supervisor:schedule');
+        });
+    });
+    describe('supervisor:learning', () => {
+        it('sends learning stats to websocket', async () => {
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(1);
+            const msg = JSON.parse(ws.sent[0]);
+            expect(msg.type).toBe('supervisor:learning_update');
+            expect(msg.data.totalCommands).toBe(10);
+            expect(msg.data.uniquePatterns).toBe(3);
+            expect(msg.data.knowledgeBaseSize).toBe(5);
+        });
+        it('does not call broadcast', async () => {
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            expect(broadcast).not.toHaveBeenCalled();
+        });
+    });
+    describe('supervisor:schedule', () => {
+        it('sends schedule data to websocket', async () => {
+            await handler.handle('supervisor:schedule', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(1);
+            const msg = JSON.parse(ws.sent[0]);
+            expect(msg.type).toBe('supervisor:schedule_update');
+            expect(msg.data.tasks).toHaveLength(1);
+            expect(msg.data.tasks[0].name).toBe('Health Check');
+        });
+    });
+    describe('closed websocket', () => {
+        it('does not send when readyState is not OPEN', async () => {
+            ws.readyState = 3; // CLOSED
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(0);
+        });
+    });
+    describe('unknown action', () => {
+        it('does not send anything for unhandled actions', async () => {
+            await handler.handle('unknown:action', undefined, ws, broadcast);
+            expect(ws.sent).toHaveLength(0);
+        });
+    });
+    // -------------------------------------------------------------------------
+    // P1: Data format completeness
+    // -------------------------------------------------------------------------
+    describe('data format completeness', () => {
+        it('supervisor:learning response has all LearningStats fields', async () => {
+            await handler.handle('supervisor:learning', undefined, ws, broadcast);
+            const msg = JSON.parse(ws.sent[0]);
+            const data = msg.data;
+            expect(data).toHaveProperty('totalCommands');
+            expect(data).toHaveProperty('uniquePatterns');
+            expect(data).toHaveProperty('topPatterns');
+            expect(data).toHaveProperty('suggestions');
+            expect(data).toHaveProperty('knowledgeBaseSize');
+        });
+        it('supervisor:schedule response has tasks array with correct shape', async () => {
+            await handler.handle('supervisor:schedule', undefined, ws, broadcast);
+            const msg = JSON.parse(ws.sent[0]);
+            expect(msg.data).toHaveProperty('tasks');
+            expect(Array.isArray(msg.data.tasks)).toBe(true);
+            const task = msg.data.tasks[0];
+            expect(task).toHaveProperty('id');
+            expect(task).toHaveProperty('name');
+            expect(task).toHaveProperty('cronExpression');
+            expect(task).toHaveProperty('taskType');
+            expect(task).toHaveProperty('enabled');
+            expect(task).toHaveProperty('history');
+        });
+    });
+});
+//# sourceMappingURL=supervisor-handler.test.js.map

package/dashboard/dist-server/server/ws/handlers/supervisor-handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-handler.test.js","sourceRoot":"","sources":["../../../../src/server/ws/handlers/supervisor-handler.test.ts"],"names":[],"mappings":"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"}

package/dashboard/dist-server/server/ws/ws-handler.d.ts

@@ -0,0 +1,8 @@
+import type { WebSocket } from 'ws';
+import type { WsEventType } from '../../shared/ws-protocol.js';
+export interface WsHandler {
+    /** Actions this handler responds to */
+    readonly actions: readonly string[];
+    /** Handle a client message */
+    handle(action: string, data: unknown, ws: WebSocket, broadcast: (type: WsEventType, data: unknown) => void): Promise<void>;
+}

package/dashboard/dist-server/server/ws/ws-handler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ws-handler.js.map

package/dashboard/dist-server/server/ws/ws-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-handler.js","sourceRoot":"","sources":["../../../src/server/ws/ws-handler.ts"],"names":[],"mappings":""}

package/dashboard/dist-server/server/ws/ws-manager.d.ts

@@ -0,0 +1,33 @@
+import type { IncomingMessage } from 'node:http';
+import type { Duplex } from 'node:stream';
+import type { WsEventType } from '../../shared/ws-protocol.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import type { WsHandler } from './ws-handler.js';
+export declare class WebSocketManager {
+    private readonly eventBus;
+    private readonly wss;
+    private readonly clients;
+    private readonly eventListener;
+    private readonly routingTable;
+    constructor(eventBus: DashboardEventBus, handlers: WsHandler[]);
+    /**
+     * Handle HTTP upgrade request — call from server 'upgrade' event.
+     */
+    handleUpgrade(request: IncomingMessage, socket: Duplex, head: Buffer): void;
+    /**
+     * Broadcast a typed message to all connected WS clients.
+     */
+    broadcast(type: WsEventType, data: unknown): void;
+    /**
+     * Send an error response back to the originating client.
+     */
+    private sendError;
+    /**
+     * Dispatch client messages — lookup handler from routing table and delegate.
+     */
+    private handleClientMessage;
+    /** Return the number of connected clients */
+    getClientCount(): number;
+    /** Close all clients, unsubscribe from EventBus, close WebSocketServer */
+    destroy(): void;
+}

package/dashboard/dist-server/server/ws/ws-manager.js

@@ -0,0 +1,124 @@
+import { WebSocketServer, WebSocket } from 'ws';
+// ---------------------------------------------------------------------------
+// WebSocketManager — manages WS clients, bridges EventBus to WS broadcast
+// ---------------------------------------------------------------------------
+export class WebSocketManager {
+    eventBus;
+    wss;
+    clients = new Set();
+    eventListener;
+    routingTable = new Map();
+    constructor(eventBus, handlers) {
+        this.eventBus = eventBus;
+        // Build routing table from handlers
+        for (const handler of handlers) {
+            for (const action of handler.actions) {
+                this.routingTable.set(action, handler);
+            }
+        }
+        this.wss = new WebSocketServer({ noServer: true });
+        // Subscribe to all EventBus events and broadcast as WsServerMessage
+        this.eventListener = (event) => {
+            this.broadcast(event.type, event.data);
+        };
+        this.eventBus.onAny(this.eventListener);
+        // Handle new connections
+        this.wss.on('connection', (ws) => {
+            this.clients.add(ws);
+            // Send initial connected message
+            const connectedMsg = {
+                type: 'connected',
+                data: null,
+                timestamp: new Date().toISOString(),
+            };
+            ws.send(JSON.stringify(connectedMsg));
+            // Handle incoming messages from client
+            ws.on('message', (raw) => {
+                try {
+                    const text = raw.toString();
+                    const msg = JSON.parse(text);
+                    this.handleClientMessage(ws, msg);
+                }
+                catch {
+                    console.warn('[WS] Failed to parse client message');
+                }
+            });
+            // Clean up on close
+            ws.on('close', () => {
+                this.clients.delete(ws);
+            });
+            ws.on('error', () => {
+                this.clients.delete(ws);
+            });
+        });
+    }
+    /**
+     * Handle HTTP upgrade request — call from server 'upgrade' event.
+     */
+    handleUpgrade(request, socket, head) {
+        this.wss.handleUpgrade(request, socket, head, (ws) => {
+            this.wss.emit('connection', ws, request);
+        });
+    }
+    /**
+     * Broadcast a typed message to all connected WS clients.
+     */
+    broadcast(type, data) {
+        if (this.clients.size === 0)
+            return;
+        const msg = {
+            type,
+            data,
+            timestamp: new Date().toISOString(),
+        };
+        const payload = JSON.stringify(msg);
+        for (const client of this.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(payload);
+            }
+        }
+    }
+    /**
+     * Send an error response back to the originating client.
+     */
+    sendError(ws, action, error) {
+        if (ws.readyState !== WebSocket.OPEN)
+            return;
+        const msg = {
+            type: 'agent:status',
+            data: { action, error },
+            timestamp: new Date().toISOString(),
+        };
+        ws.send(JSON.stringify(msg));
+    }
+    /**
+     * Dispatch client messages — lookup handler from routing table and delegate.
+     */
+    handleClientMessage(ws, msg) {
+        const handler = this.routingTable.get(msg.action);
+        if (!handler) {
+            console.log(`[WS] Unknown client action: ${msg.action}`);
+            return;
+        }
+        handler
+            .handle(msg.action, msg, ws, (type, data) => this.broadcast(type, data))
+            .catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            this.sendError(ws, msg.action, message);
+        });
+    }
+    /** Return the number of connected clients */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /** Close all clients, unsubscribe from EventBus, close WebSocketServer */
+    destroy() {
+        this.eventBus.offAny(this.eventListener);
+        for (const client of this.clients) {
+            client.close();
+        }
+        this.clients.clear();
+        this.wss.close();
+    }
+}
+//# sourceMappingURL=ws-manager.js.map

package/dashboard/dist-server/server/ws/ws-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-manager.js","sourceRoot":"","sources":["../../../src/server/ws/ws-manager.ts"],"names":[],"mappings":"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"}