maestro-flow 0.1.3 → 0.2.0

package/dashboard/dist-server/dashboard/src/server/agents/agent-manager.test.js

@@ -0,0 +1,162 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { AgentManager } from './agent-manager.js';
+import { DashboardEventBus } from '../state/event-bus.js';
+import { EntryNormalizer } from './entry-normalizer.js';
+// Mock fs to prevent real file I/O
+vi.mock('node:fs', () => ({
+    appendFileSync: vi.fn(),
+    writeFileSync: vi.fn(),
+    mkdirSync: vi.fn(),
+    existsSync: vi.fn(() => true),
+}));
+function makeCliProcess(id, prompt = 'test prompt') {
+    return {
+        id,
+        type: 'claude-code',
+        status: 'running',
+        config: { type: 'claude-code', prompt, workDir: '/tmp' },
+        startedAt: new Date().toISOString(),
+    };
+}
+describe('AgentManager — CLI Bridge lifecycle', () => {
+    let manager;
+    let eventBus;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        eventBus = new DashboardEventBus();
+        manager = new AgentManager(eventBus);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    // -----------------------------------------------------------------------
+    // Registration & entry buffering
+    // -----------------------------------------------------------------------
+    it('registerCliProcess makes process visible in listProcesses', () => {
+        const proc = makeCliProcess('cli-1');
+        manager.registerCliProcess(proc);
+        const list = manager.listProcesses();
+        expect(list).toHaveLength(1);
+        expect(list[0].id).toBe('cli-1');
+    });
+    it('addCliEntry buffers entries retrievable via getEntries', () => {
+        const proc = makeCliProcess('cli-2');
+        manager.registerCliProcess(proc);
+        const entry = EntryNormalizer.userMessage('cli-2', 'hello');
+        manager.addCliEntry('cli-2', entry);
+        const entries = manager.getEntries('cli-2');
+        expect(entries).toHaveLength(1);
+        expect(entries[0].content).toBe('hello');
+    });
+    it('addCliEntry caps history at MAX_HISTORY', () => {
+        const proc = makeCliProcess('cli-cap');
+        manager.registerCliProcess(proc);
+        // Push 1001 entries — oldest should be evicted
+        for (let i = 0; i < 1001; i++) {
+            manager.addCliEntry('cli-cap', EntryNormalizer.userMessage('cli-cap', `msg-${i}`));
+        }
+        const entries = manager.getEntries('cli-cap');
+        expect(entries).toHaveLength(1000);
+        // First entry should be msg-1 (msg-0 evicted)
+        expect(entries[0].content).toBe('msg-1');
+    });
+    // -----------------------------------------------------------------------
+    // CLI stop → delayed cleanup (P4 + G2)
+    // -----------------------------------------------------------------------
+    describe('updateCliProcessStatus — delayed cleanup', () => {
+        it('marks process as stopped but keeps entries available', () => {
+            const proc = makeCliProcess('cli-stop');
+            manager.registerCliProcess(proc);
+            manager.addCliEntry('cli-stop', EntryNormalizer.userMessage('cli-stop', 'data'));
+            manager.updateCliProcessStatus('cli-stop', 'stopped');
+            // Entries still available immediately after stop
+            expect(manager.getEntries('cli-stop')).toHaveLength(1);
+            // Process still listed (status updated)
+            const listed = manager.listProcesses().find(p => p.id === 'cli-stop');
+            expect(listed?.status).toBe('stopped');
+        });
+        it('cleans up entries after 5-minute delay', () => {
+            const proc = makeCliProcess('cli-delay');
+            manager.registerCliProcess(proc);
+            manager.addCliEntry('cli-delay', EntryNormalizer.userMessage('cli-delay', 'data'));
+            manager.updateCliProcessStatus('cli-delay', 'stopped');
+            // Before 5 min: still available
+            vi.advanceTimersByTime(4 * 60 * 1000);
+            expect(manager.getEntries('cli-delay')).toHaveLength(1);
+            expect(manager.listProcesses().some(p => p.id === 'cli-delay')).toBe(true);
+            // After 5 min: cleaned up
+            vi.advanceTimersByTime(1 * 60 * 1000 + 1);
+            expect(manager.getEntries('cli-delay')).toHaveLength(0);
+            expect(manager.listProcesses().some(p => p.id === 'cli-delay')).toBe(false);
+        });
+        it('resets cleanup timer on repeated status updates', () => {
+            const proc = makeCliProcess('cli-reset');
+            manager.registerCliProcess(proc);
+            manager.addCliEntry('cli-reset', EntryNormalizer.userMessage('cli-reset', 'data'));
+            manager.updateCliProcessStatus('cli-reset', 'stopped');
+            // Advance 4 minutes, then update status again (resets timer)
+            vi.advanceTimersByTime(4 * 60 * 1000);
+            manager.updateCliProcessStatus('cli-reset', 'error');
+            // Another 4 minutes — still within new 5-min window
+            vi.advanceTimersByTime(4 * 60 * 1000);
+            expect(manager.getEntries('cli-reset')).toHaveLength(1);
+            // Final minute + 1ms — now cleaned up
+            vi.advanceTimersByTime(1 * 60 * 1000 + 1);
+            expect(manager.getEntries('cli-reset')).toHaveLength(0);
+        });
+    });
+    // -----------------------------------------------------------------------
+    // Reconnect recovery scenario (G1 simulation)
+    // -----------------------------------------------------------------------
+    describe('reconnect recovery — entries available for fetch', () => {
+        it('stopped CLI process entries are fetchable within cleanup window', () => {
+            const proc = makeCliProcess('cli-reconnect');
+            manager.registerCliProcess(proc);
+            // Simulate a session with multiple entries
+            const entries = [
+                EntryNormalizer.userMessage('cli-reconnect', 'initial prompt'),
+                EntryNormalizer.assistantMessage('cli-reconnect', 'response text', false),
+                EntryNormalizer.toolUse('cli-reconnect', 'Read', { path: '/test' }, 'completed', 'ok'),
+            ];
+            for (const e of entries)
+                manager.addCliEntry('cli-reconnect', e);
+            // Process stops
+            manager.updateCliProcessStatus('cli-reconnect', 'stopped');
+            // Simulate 2 minutes later — frontend reconnects
+            vi.advanceTimersByTime(2 * 60 * 1000);
+            // listProcesses still returns it (frontend discovers it)
+            const processes = manager.listProcesses();
+            expect(processes.some(p => p.id === 'cli-reconnect')).toBe(true);
+            // getEntries returns full history (frontend loads it)
+            const recovered = manager.getEntries('cli-reconnect');
+            expect(recovered).toHaveLength(3);
+            expect(recovered[0].content).toBe('initial prompt');
+        });
+        it('entries are gone after cleanup window expires', () => {
+            const proc = makeCliProcess('cli-expired');
+            manager.registerCliProcess(proc);
+            manager.addCliEntry('cli-expired', EntryNormalizer.userMessage('cli-expired', 'old data'));
+            manager.updateCliProcessStatus('cli-expired', 'stopped');
+            // 6 minutes later — past cleanup window
+            vi.advanceTimersByTime(6 * 60 * 1000);
+            expect(manager.listProcesses().some(p => p.id === 'cli-expired')).toBe(false);
+            expect(manager.getEntries('cli-expired')).toHaveLength(0);
+        });
+    });
+    // -----------------------------------------------------------------------
+    // EventBus integration
+    // -----------------------------------------------------------------------
+    describe('eventBus emissions', () => {
+        it('does not emit events for CLI bridge operations (read-only registration)', () => {
+            const events = [];
+            eventBus.onAny((e) => events.push(e.type));
+            const proc = makeCliProcess('cli-quiet');
+            manager.registerCliProcess(proc);
+            manager.addCliEntry('cli-quiet', EntryNormalizer.userMessage('cli-quiet', 'test'));
+            // registerCliProcess and addCliEntry are silent — events are emitted
+            // by ws-manager which calls eventBus.emit separately
+            expect(events).toHaveLength(0);
+        });
+    });
+});
+//# sourceMappingURL=agent-manager.test.js.map

package/dashboard/dist-server/dashboard/src/server/agents/agent-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manager.test.js","sourceRoot":"","sources":["../../../../../src/server/agents/agent-manager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,mCAAmC;AACnC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACxB,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;IACvB,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE;IACtB,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;IAClB,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;CAC9B,CAAC,CAAC,CAAC;AAEJ,SAAS,cAAc,CAAC,EAAU,EAAE,MAAM,GAAG,aAAa;IACxD,OAAO;QACL,EAAE;QACF,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;QACxD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,IAAI,OAAqB,CAAC;IAC1B,IAAI,QAA2B,CAAC;IAEhC,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACnC,OAAO,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,iCAAiC;IACjC,0EAA0E;IAE1E,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEjC,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAE,OAAO,CAAC,CAAC,CAAyB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QACvC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEjC,+CAA+C;QAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACrF,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,8CAA8C;QAC9C,MAAM,CAAE,OAAO,CAAC,CAAC,CAAyB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,uCAAuC;IACvC,0EAA0E;IAE1E,QAAQ,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACxD,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;YACxC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,eAAe,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;YAEjF,OAAO,CAAC,sBAAsB,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAEtD,iDAAiD;YACjD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvD,wCAAwC;YACxC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;YACtE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;YACzC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YAEnF,OAAO,CAAC,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAEvD,gCAAgC;YAChC,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE3E,0BAA0B;YAC1B,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;YACzC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YAEnF,OAAO,CAAC,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAEvD,6DAA6D;YAC7D,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACtC,OAAO,CAAC,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAErD,oDAAoD;YACpD,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACtC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAExD,sCAAsC;YACtC,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,8CAA8C;IAC9C,0EAA0E;IAE1E,QAAQ,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAChE,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACzE,MAAM,IAAI,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;YAC7C,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAEjC,2CAA2C;YAC3C,MAAM,OAAO,GAAG;gBACd,eAAe,CAAC,WAAW,CAAC,eAAe,EAAE,gBAAgB,CAAC;gBAC9D,eAAe,CAAC,gBAAgB,CAAC,eAAe,EAAE,eAAe,EAAE,KAAK,CAAC;gBACzE,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC;aACvF,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,OAAO;gBAAE,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;YAEjE,gBAAgB;YAChB,OAAO,CAAC,sBAAsB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YAE3D,iDAAiD;YACjD,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAEtC,yDAAyD;YACzD,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEjE,sDAAsD;YACtD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;YACtD,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,CAAE,SAAS,CAAC,CAAC,CAAyB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,IAAI,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;YAC3C,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,eAAe,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;YAE3F,OAAO,CAAC,sBAAsB,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAEzD,wCAAwC;YACxC,EAAE,CAAC,mBAAmB,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YAEtC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9E,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,uBAAuB;IACvB,0EAA0E;IAE1E,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;YACjF,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAE3C,MAAM,IAAI,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;YACzC,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;YAEnF,qEAAqE;YACrE,qDAAqD;YACrD,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.d.ts

@@ -0,0 +1,18 @@
+import type { AgentConfig, AgentProcess, ApprovalDecision } from '../../shared/agent-types.js';
+import { BaseAgentAdapter } from './base-adapter.js';
+export declare class AgentSdkAdapter extends BaseAgentAdapter {
+    readonly agentType: "agent-sdk";
+    private readonly abortControllers;
+    private readonly pendingApprovals;
+    private readonly issueMcpServer;
+    constructor(workflowRoot?: string);
+    protected doSpawn(processId: string, config: AgentConfig): Promise<AgentProcess>;
+    protected doStop(processId: string): Promise<void>;
+    protected doSendMessage(_processId: string, _content: string): Promise<void>;
+    protected doRespondApproval(decision: ApprovalDecision): Promise<void>;
+    private runAgentQuery;
+    private createCanUseToolCallback;
+    private handleCanUseTool;
+    private resolvePermissionMode;
+    private denyAllPendingApprovals;
+}

package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.js

@@ -0,0 +1,219 @@
+// ---------------------------------------------------------------------------
+// AgentSdkAdapter — bridges @anthropic-ai/claude-agent-sdk to BaseAgentAdapter
+// ---------------------------------------------------------------------------
+import { randomUUID } from 'node:crypto';
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { BaseAgentAdapter } from './base-adapter.js';
+import { EntryNormalizer } from './entry-normalizer.js';
+import { SdkMessageTranslator } from './sdk-message-translator.js';
+import { createIssueMcpServer } from './tools/issue-mcp-server.js';
+/** Auto-deny timeout for pending approvals (5 minutes) */
+const APPROVAL_TIMEOUT_MS = 5 * 60 * 1000;
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+export class AgentSdkAdapter extends BaseAgentAdapter {
+    agentType = 'agent-sdk';
+    abortControllers = new Map();
+    pendingApprovals = new Map();
+    issueMcpServer;
+    constructor(workflowRoot) {
+        super();
+        this.issueMcpServer = workflowRoot ? createIssueMcpServer(workflowRoot) : null;
+    }
+    // --- Lifecycle hooks -----------------------------------------------------
+    async doSpawn(processId, config) {
+        const abortController = new AbortController();
+        this.abortControllers.set(processId, abortController);
+        const agentProcess = {
+            id: processId,
+            type: 'agent-sdk',
+            status: 'spawning',
+            config,
+            startedAt: new Date().toISOString(),
+            interactive: false,
+        };
+        // Fire-and-forget the SDK query — errors are handled inside
+        this.runAgentQuery(processId, config, abortController).catch((err) => {
+            const message = err instanceof Error ? err.message : String(err);
+            this.emitEntry(processId, EntryNormalizer.error(processId, message, 'sdk_error'));
+            this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'error', message));
+            const proc = this.getProcess(processId);
+            if (proc) {
+                proc.status = 'error';
+            }
+        });
+        return agentProcess;
+    }
+    async doStop(processId) {
+        // Update status
+        const proc = this.getProcess(processId);
+        if (proc) {
+            proc.status = 'stopping';
+            this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'stopping', 'User requested stop'));
+        }
+        // Abort the SDK query
+        const controller = this.abortControllers.get(processId);
+        if (controller) {
+            controller.abort();
+        }
+        // Deny all pending approvals for this process
+        this.denyAllPendingApprovals(processId);
+        // Cleanup
+        this.abortControllers.delete(processId);
+    }
+    async doSendMessage(_processId, _content) {
+        throw new Error('AgentSdkAdapter does not support interactive messages');
+    }
+    async doRespondApproval(decision) {
+        const pending = this.pendingApprovals.get(decision.id);
+        if (!pending) {
+            throw new Error(`No pending approval found with id: ${decision.id}`);
+        }
+        // Clear the timeout
+        clearTimeout(pending.timeoutId);
+        // Build the permission result
+        const result = decision.allow
+            ? { behavior: 'allow' }
+            : { behavior: 'deny', message: 'User denied permission' };
+        // Resolve the promise to unblock the SDK
+        pending.resolve(result);
+        // Emit approval response entry
+        this.emitEntry(decision.processId, EntryNormalizer.approvalResponse(decision.processId, decision.id, decision.allow));
+        // Cleanup
+        this.pendingApprovals.delete(decision.id);
+    }
+    // --- Private: SDK query execution ----------------------------------------
+    async runAgentQuery(processId, config, abortController) {
+        const translator = new SdkMessageTranslator(processId);
+        // Build SDK options
+        const options = {
+            abortController,
+            cwd: config.workDir,
+            model: config.model,
+            settingSources: ['project'],
+        };
+        // When settingsFile is set, use settings file path and dontAsk mode
+        if (config.settingsFile) {
+            options.settings = config.settingsFile;
+            options.permissionMode = 'dontAsk';
+        }
+        else {
+            // Existing env-based behavior
+            if (config.env || config.baseUrl || config.apiKey) {
+                options.env = { ...process.env, ...config.env };
+            }
+            if (config.baseUrl) {
+                options.env = options.env ?? { ...process.env };
+                options.env.ANTHROPIC_BASE_URL = config.baseUrl;
+            }
+            if (config.apiKey) {
+                options.env = options.env ?? { ...process.env };
+                options.env.ANTHROPIC_API_KEY = config.apiKey;
+            }
+            // Set permission mode based on config
+            const permissionMode = this.resolvePermissionMode(config);
+            options.permissionMode = permissionMode;
+            // If not bypassing permissions, install the canUseTool callback
+            if (permissionMode !== 'bypassPermissions') {
+                options.canUseTool = this.createCanUseToolCallback(processId);
+            }
+            else {
+                options.allowDangerouslySkipPermissions = true;
+            }
+        }
+        // Inject issue MCP server if available
+        if (this.issueMcpServer) {
+            options.mcpServers = { 'issue-monitor': this.issueMcpServer };
+        }
+        // Start the query
+        const queryInstance = query({ prompt: config.prompt, options });
+        // Update status to running
+        const proc = this.getProcess(processId);
+        if (proc) {
+            proc.status = 'running';
+        }
+        this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'running'));
+        // Iterate the async generator
+        for await (const msg of queryInstance) {
+            // Treat each message as a record for the translator
+            const entries = translator.translate(msg);
+            for (const entry of entries) {
+                this.emitEntry(processId, entry);
+            }
+        }
+        // Query completed normally
+        const completedProc = this.getProcess(processId);
+        if (completedProc && completedProc.status !== 'error' && completedProc.status !== 'stopping') {
+            completedProc.status = 'stopped';
+            this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'stopped', 'Query completed'));
+        }
+        // Cleanup
+        this.abortControllers.delete(processId);
+    }
+    // --- Private: Permission handling ----------------------------------------
+    createCanUseToolCallback(processId) {
+        return async (toolName, input, cbOptions) => {
+            return this.handleCanUseTool(processId, toolName, input, cbOptions.signal);
+        };
+    }
+    handleCanUseTool(processId, toolName, toolInput, signal) {
+        const requestId = randomUUID();
+        return new Promise((resolve) => {
+            // Auto-deny after timeout
+            const timeoutId = setTimeout(() => {
+                if (this.pendingApprovals.has(requestId)) {
+                    this.pendingApprovals.delete(requestId);
+                    this.emitEntry(processId, EntryNormalizer.approvalResponse(processId, requestId, false));
+                    resolve({ behavior: 'deny', message: 'Approval timed out (5 minutes)' });
+                }
+            }, APPROVAL_TIMEOUT_MS);
+            // Store the pending approval
+            const pending = {
+                requestId,
+                processId,
+                resolve,
+                timeoutId,
+            };
+            this.pendingApprovals.set(requestId, pending);
+            // Listen for abort to clean up
+            const onAbort = () => {
+                if (this.pendingApprovals.has(requestId)) {
+                    clearTimeout(timeoutId);
+                    this.pendingApprovals.delete(requestId);
+                    resolve({ behavior: 'deny', message: 'Operation aborted' });
+                }
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+            // Emit the approval request entry
+            this.emitEntry(processId, EntryNormalizer.approvalRequest(processId, toolName, toolInput, requestId));
+            // Emit the approval event so listeners can present the UI
+            const request = {
+                id: requestId,
+                processId,
+                toolName,
+                toolInput,
+                timestamp: new Date().toISOString(),
+            };
+            this.emitApproval(processId, request);
+        });
+    }
+    // --- Private: Helpers ----------------------------------------------------
+    resolvePermissionMode(config) {
+        if (config.approvalMode === 'auto') {
+            return 'bypassPermissions';
+        }
+        return 'default';
+    }
+    denyAllPendingApprovals(processId) {
+        for (const [id, pending] of this.pendingApprovals) {
+            if (pending.processId === processId) {
+                clearTimeout(pending.timeoutId);
+                pending.resolve({ behavior: 'deny', message: 'Process stopped' });
+                this.emitEntry(processId, EntryNormalizer.approvalResponse(processId, id, false));
+                this.pendingApprovals.delete(id);
+            }
+        }
+    }
+}
+//# sourceMappingURL=agent-sdk-adapter.js.map

package/dashboard/dist-server/dashboard/src/server/agents/agent-sdk-adapter.js.map

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

package/dashboard/dist-server/dashboard/src/server/agents/base-adapter.d.ts

@@ -0,0 +1,47 @@
+import type { AgentType, AgentConfig, AgentProcess, NormalizedEntry, ApprovalRequest, ApprovalDecision } from '../../shared/agent-types.js';
+/** Protocol-agnostic agent interface */
+export interface AgentAdapter {
+    readonly agentType: AgentType;
+    spawn(config: AgentConfig): Promise<AgentProcess>;
+    stop(processId: string): Promise<void>;
+    sendMessage(processId: string, content: string): Promise<void>;
+    onEntry(processId: string, cb: (entry: NormalizedEntry) => void): () => void;
+    onApproval(processId: string, cb: (request: ApprovalRequest) => void): () => void;
+    respondApproval(decision: ApprovalDecision): Promise<void>;
+    supportsInteractive(): boolean;
+    endInput(processId: string): void;
+    getProcess(processId: string): AgentProcess | undefined;
+    listProcesses(): AgentProcess[];
+}
+/** Abstract base class providing process tracking and event callback plumbing */
+export declare abstract class BaseAgentAdapter implements AgentAdapter {
+    abstract readonly agentType: AgentType;
+    protected readonly processes: Map<string, AgentProcess>;
+    private readonly entryCallbacks;
+    private readonly approvalCallbacks;
+    spawn(config: AgentConfig): Promise<AgentProcess>;
+    stop(processId: string): Promise<void>;
+    sendMessage(processId: string, content: string): Promise<void>;
+    onEntry(processId: string, cb: (entry: NormalizedEntry) => void): () => void;
+    onApproval(processId: string, cb: (request: ApprovalRequest) => void): () => void;
+    respondApproval(decision: ApprovalDecision): Promise<void>;
+    getProcess(processId: string): AgentProcess | undefined;
+    listProcesses(): AgentProcess[];
+    supportsInteractive(): boolean;
+    endInput(_processId: string): void;
+    /** Generate a unique process ID */
+    protected generateProcessId(): string;
+    /** Emit a normalized entry to all registered listeners for a process */
+    protected emitEntry(processId: string, entry: NormalizedEntry): void;
+    /** Emit an approval request to all registered listeners for a process */
+    protected emitApproval(processId: string, request: ApprovalRequest): void;
+    /** Add a process to the internal tracking map */
+    protected addProcess(process: AgentProcess): void;
+    /** Remove a process and clean up all associated callbacks */
+    protected removeProcess(processId: string): void;
+    private requireProcess;
+    protected abstract doSpawn(processId: string, config: AgentConfig): Promise<AgentProcess>;
+    protected abstract doStop(processId: string): Promise<void>;
+    protected abstract doSendMessage(processId: string, content: string): Promise<void>;
+    protected abstract doRespondApproval(decision: ApprovalDecision): Promise<void>;
+}

package/dashboard/dist-server/dashboard/src/server/agents/base-adapter.js

@@ -0,0 +1,113 @@
+// ---------------------------------------------------------------------------
+// AgentAdapter interface + BaseAgentAdapter abstract class
+// Protocol-agnostic agent abstraction layer
+// ---------------------------------------------------------------------------
+import { randomUUID } from 'node:crypto';
+// ---------------------------------------------------------------------------
+// BaseAgentAdapter — abstract base with shared lifecycle management
+// ---------------------------------------------------------------------------
+/** Abstract base class providing process tracking and event callback plumbing */
+export class BaseAgentAdapter {
+    processes = new Map();
+    entryCallbacks = new Map();
+    approvalCallbacks = new Map();
+    // --- Public interface (delegates to abstract hooks) ---------------------
+    async spawn(config) {
+        const processId = this.generateProcessId();
+        const process = await this.doSpawn(processId, config);
+        this.addProcess(process);
+        return process;
+    }
+    async stop(processId) {
+        this.requireProcess(processId);
+        await this.doStop(processId);
+        this.removeProcess(processId);
+    }
+    async sendMessage(processId, content) {
+        this.requireProcess(processId);
+        await this.doSendMessage(processId, content);
+    }
+    onEntry(processId, cb) {
+        let set = this.entryCallbacks.get(processId);
+        if (!set) {
+            set = new Set();
+            this.entryCallbacks.set(processId, set);
+        }
+        set.add(cb);
+        return () => {
+            set.delete(cb);
+            if (set.size === 0) {
+                this.entryCallbacks.delete(processId);
+            }
+        };
+    }
+    onApproval(processId, cb) {
+        let set = this.approvalCallbacks.get(processId);
+        if (!set) {
+            set = new Set();
+            this.approvalCallbacks.set(processId, set);
+        }
+        set.add(cb);
+        return () => {
+            set.delete(cb);
+            if (set.size === 0) {
+                this.approvalCallbacks.delete(processId);
+            }
+        };
+    }
+    async respondApproval(decision) {
+        await this.doRespondApproval(decision);
+    }
+    getProcess(processId) {
+        return this.processes.get(processId);
+    }
+    listProcesses() {
+        return Array.from(this.processes.values());
+    }
+    supportsInteractive() {
+        return false;
+    }
+    endInput(_processId) {
+        // No-op default — override in interactive adapters that need stdin close
+    }
+    // --- Protected helpers for subclasses -----------------------------------
+    /** Generate a unique process ID */
+    generateProcessId() {
+        return randomUUID();
+    }
+    /** Emit a normalized entry to all registered listeners for a process */
+    emitEntry(processId, entry) {
+        const set = this.entryCallbacks.get(processId);
+        if (set) {
+            for (const cb of set) {
+                cb(entry);
+            }
+        }
+    }
+    /** Emit an approval request to all registered listeners for a process */
+    emitApproval(processId, request) {
+        const set = this.approvalCallbacks.get(processId);
+        if (set) {
+            for (const cb of set) {
+                cb(request);
+            }
+        }
+    }
+    /** Add a process to the internal tracking map */
+    addProcess(process) {
+        this.processes.set(process.id, process);
+    }
+    /** Remove a process and clean up all associated callbacks */
+    removeProcess(processId) {
+        this.processes.delete(processId);
+        this.entryCallbacks.delete(processId);
+        this.approvalCallbacks.delete(processId);
+    }
+    // --- Private helpers ----------------------------------------------------
+    requireProcess(processId) {
+        if (!this.processes.has(processId)) {
+            throw new Error(`No process found with id: ${processId}`);
+        }
+    }
+}
+//# sourceMappingURL=base-adapter.js.map

package/dashboard/dist-server/dashboard/src/server/agents/base-adapter.js.map

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

package/dashboard/dist-server/dashboard/src/server/agents/claude-code-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { AgentConfig, AgentProcess, ApprovalDecision } from '../../shared/agent-types.js';
+import { BaseAgentAdapter } from './base-adapter.js';
+export declare class ClaudeCodeAdapter extends BaseAgentAdapter {
+    readonly agentType: "claude-code";
+    private readonly childProcesses;
+    private readonly readlineInterfaces;
+    private readonly pendingApprovals;
+    private readonly streamMonitors;
+    /** Whether this adapter supports interactive follow-up messages */
+    supportsInteractive(): boolean;
+    protected doSpawn(processId: string, config: AgentConfig): Promise<AgentProcess>;
+    protected doStop(processId: string): Promise<void>;
+    /** Close stdin to signal no more input — process exits naturally after finishing current work */
+    endInput(processId: string): void;
+    protected doSendMessage(processId: string, content: string): Promise<void>;
+    protected doRespondApproval(decision: ApprovalDecision): Promise<void>;
+    private parseClaudeMessage;
+    private extractAssistantContent;
+    private handlePermissionRequest;
+    private setupProcessListeners;
+    private cleanup;
+}