maestro-flow 0.1.0

package/dashboard/dist-server/server/agents/sdk-message-translator.test.js

@@ -0,0 +1,327 @@
+import { describe, it, expect } from 'vitest';
+import { SdkMessageTranslator } from './sdk-message-translator.js';
+describe('SdkMessageTranslator', () => {
+    const PID = 'test-process-001';
+    function createTranslator() {
+        return new SdkMessageTranslator(PID);
+    }
+    // --- test_sdk_message_translator_assistant_text ---
+    describe('assistant text translation', () => {
+        it('translates assistant text block to assistant_message', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [{ type: 'text', text: 'Hello world' }],
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('assistant_message');
+            expect(entries[0]).toMatchObject({
+                processId: PID,
+                type: 'assistant_message',
+                content: 'Hello world',
+                partial: false,
+            });
+        });
+        it('translates thinking block to thinking entry', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [{ type: 'thinking', thinking: 'Let me think...' }],
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('thinking');
+            expect(entries[0]).toMatchObject({
+                type: 'thinking',
+                content: 'Let me think...',
+            });
+        });
+        it('translates multiple content blocks from single assistant message', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [
+                        { type: 'thinking', thinking: 'Reasoning...' },
+                        { type: 'text', text: 'Answer here' },
+                    ],
+                },
+            });
+            expect(entries).toHaveLength(2);
+            expect(entries[0].type).toBe('thinking');
+            expect(entries[1].type).toBe('assistant_message');
+        });
+        it('translates assistant error to error entry', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                error: 'Something went wrong',
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('error');
+            expect(entries[0]).toMatchObject({
+                type: 'error',
+                message: 'Assistant error: Something went wrong',
+            });
+        });
+    });
+    // --- test_sdk_message_translator_tool_use_routing ---
+    describe('tool use routing', () => {
+        it('routes Edit tool to file_change with action=modify', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [
+                        {
+                            type: 'tool_use',
+                            id: 'tu-1',
+                            name: 'Edit',
+                            input: { file_path: '/src/main.ts' },
+                        },
+                    ],
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('file_change');
+            expect(entries[0]).toMatchObject({
+                type: 'file_change',
+                path: '/src/main.ts',
+                action: 'modify',
+            });
+        });
+        it('routes Write tool to file_change with action=create', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [
+                        {
+                            type: 'tool_use',
+                            id: 'tu-2',
+                            name: 'Write',
+                            input: { file_path: '/src/new-file.ts' },
+                        },
+                    ],
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('file_change');
+            expect(entries[0]).toMatchObject({
+                type: 'file_change',
+                path: '/src/new-file.ts',
+                action: 'create',
+            });
+        });
+        it('routes Bash tool to command_exec', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [
+                        {
+                            type: 'tool_use',
+                            id: 'tu-3',
+                            name: 'Bash',
+                            input: { command: 'npm test' },
+                        },
+                    ],
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('command_exec');
+            expect(entries[0]).toMatchObject({
+                type: 'command_exec',
+                command: 'npm test',
+            });
+        });
+        it('routes unknown tool to generic tool_use', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [
+                        {
+                            type: 'tool_use',
+                            id: 'tu-4',
+                            name: 'Read',
+                            input: { file_path: '/some/path' },
+                        },
+                    ],
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('tool_use');
+            expect(entries[0]).toMatchObject({
+                type: 'tool_use',
+                name: 'Read',
+                status: 'running',
+            });
+        });
+        it('correlates tool_use result with pending tool', () => {
+            const translator = createTranslator();
+            // First: tool_use block
+            translator.translate({
+                type: 'assistant',
+                message: {
+                    content: [
+                        { type: 'tool_use', id: 'tu-5', name: 'Bash', input: { command: 'ls' } },
+                    ],
+                },
+            });
+            // Then: tool result
+            const entries = translator.translate({
+                type: 'user',
+                tool_use_result: {
+                    tool_use_id: 'tu-5',
+                    output: 'file1.ts\nfile2.ts',
+                    is_error: false,
+                },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0].type).toBe('command_exec');
+            expect(entries[0]).toMatchObject({
+                type: 'command_exec',
+                command: 'ls',
+                output: 'file1.ts\nfile2.ts',
+                exitCode: 0,
+            });
+        });
+    });
+    // --- test_sdk_message_translator_result_success ---
+    describe('result success translation', () => {
+        it('translates success result to assistant_message + token_usage + status_change', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'result',
+                subtype: 'success',
+                result: 'Task completed successfully',
+                usage: {
+                    input_tokens: 1000,
+                    output_tokens: 500,
+                    cache_read_input_tokens: 200,
+                    cache_creation_input_tokens: 100,
+                },
+            });
+            expect(entries).toHaveLength(3);
+            expect(entries[0].type).toBe('assistant_message');
+            expect(entries[0]).toMatchObject({
+                content: 'Task completed successfully',
+                partial: false,
+            });
+            expect(entries[1].type).toBe('token_usage');
+            expect(entries[1]).toMatchObject({
+                inputTokens: 1000,
+                outputTokens: 500,
+                cacheReadTokens: 200,
+                cacheWriteTokens: 100,
+            });
+            expect(entries[2].type).toBe('status_change');
+            expect(entries[2]).toMatchObject({
+                status: 'stopped',
+            });
+        });
+        it('handles success result without result text', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'result',
+                subtype: 'success',
+                usage: { input_tokens: 100, output_tokens: 50 },
+            });
+            // Should have token_usage + status_change (no assistant_message since no result text)
+            expect(entries).toHaveLength(2);
+            expect(entries[0].type).toBe('token_usage');
+            expect(entries[1].type).toBe('status_change');
+        });
+    });
+    // --- test_sdk_message_translator_result_error ---
+    describe('result error translation', () => {
+        it('translates error result to error + status_change', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'result',
+                subtype: 'error',
+                error: 'Rate limit exceeded',
+            });
+            expect(entries).toHaveLength(2);
+            expect(entries[0].type).toBe('error');
+            expect(entries[0]).toMatchObject({
+                message: 'Rate limit exceeded',
+                code: 'error',
+            });
+            expect(entries[1].type).toBe('status_change');
+            expect(entries[1]).toMatchObject({
+                status: 'error',
+                reason: 'error',
+            });
+        });
+    });
+    // --- Additional coverage ---
+    describe('other message types', () => {
+        it('translates system init to status_change running', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({ type: 'system', subtype: 'init' });
+            expect(entries).toHaveLength(1);
+            expect(entries[0]).toMatchObject({ type: 'status_change', status: 'running' });
+        });
+        it('translates rate_limit_event to error', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({ type: 'rate_limit_event' });
+            expect(entries).toHaveLength(1);
+            expect(entries[0]).toMatchObject({
+                type: 'error',
+                message: 'Rate limit reached',
+                code: 'RATE_LIMIT',
+            });
+        });
+        it('translates tool_progress to tool_use running', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'tool_progress',
+                tool_name: 'Bash',
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0]).toMatchObject({
+                type: 'tool_use',
+                name: 'Bash',
+                status: 'running',
+            });
+        });
+        it('skips internal SDK message types', () => {
+            const translator = createTranslator();
+            const skippedTypes = [
+                'compact_boundary',
+                'user_message_replay',
+                'auth_status',
+                'hook_response',
+                'prompt_suggestion',
+                'status',
+            ];
+            for (const type of skippedTypes) {
+                const entries = translator.translate({ type });
+                expect(entries).toHaveLength(0);
+            }
+        });
+        it('skips unknown message types', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({ type: 'totally_unknown_type' });
+            expect(entries).toHaveLength(0);
+        });
+        it('translates user message (non-tool-result, non-synthetic)', () => {
+            const translator = createTranslator();
+            const entries = translator.translate({
+                type: 'user',
+                message: { content: [{ type: 'text', text: 'Hello' }] },
+            });
+            expect(entries).toHaveLength(1);
+            expect(entries[0]).toMatchObject({
+                type: 'user_message',
+                content: 'Hello',
+            });
+        });
+    });
+});
+//# sourceMappingURL=sdk-message-translator.test.js.map

package/dashboard/dist-server/server/agents/sdk-message-translator.test.js.map

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

package/dashboard/dist-server/server/agents/stream-json-adapter.d.ts

@@ -0,0 +1,24 @@
+import type { AgentType, AgentConfig, AgentProcess, ApprovalDecision } from '../../shared/agent-types.js';
+import { BaseAgentAdapter } from './base-adapter.js';
+export declare class StreamJsonAdapter extends BaseAgentAdapter {
+    readonly agentType: AgentType;
+    private readonly executable;
+    private readonly childProcesses;
+    private readonly readlineInterfaces;
+    private readonly lastContentLength;
+    private readonly toolIdNames;
+    private readonly stoppedEmitted;
+    private readonly streamMonitors;
+    private readonly thinkingEmitted;
+    constructor(executable: string, agentType: AgentType);
+    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 parseStreamJsonMessage;
+    private handleMessageEntry;
+    private buildArgs;
+    private emitStopped;
+    private setupProcessListeners;
+    private cleanup;
+}

package/dashboard/dist-server/server/agents/stream-json-adapter.js

@@ -0,0 +1,289 @@
+// ---------------------------------------------------------------------------
+// StreamJsonAdapter — shared adapter for Gemini CLI and Qwen CLI
+// Both use the `-o stream-json` output protocol with identical message shapes.
+// ---------------------------------------------------------------------------
+import { spawn } from 'node:child_process';
+import { createInterface } from 'node:readline';
+import { BaseAgentAdapter } from './base-adapter.js';
+import { EntryNormalizer } from './entry-normalizer.js';
+import { loadEnvFile } from './env-file-loader.js';
+import { StreamMonitor } from './stream-monitor.js';
+import { cleanSpawnEnv } from './env-cleanup.js';
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+export class StreamJsonAdapter extends BaseAgentAdapter {
+    agentType;
+    executable;
+    childProcesses = new Map();
+    readlineInterfaces = new Map();
+    lastContentLength = new Map();
+    toolIdNames = new Map();
+    stoppedEmitted = new Set();
+    streamMonitors = new Map();
+    thinkingEmitted = new Set();
+    constructor(executable, agentType) {
+        super();
+        this.executable = executable;
+        this.agentType = agentType;
+    }
+    // --- Lifecycle hooks -----------------------------------------------------
+    async doSpawn(processId, config) {
+        const args = this.buildArgs(config);
+        const [cmd, ...cmdArgs] = this.executable.split(/\s+/);
+        const envFromFile = config.envFile ? loadEnvFile(config.envFile) : {};
+        const envOverrides = { ...envFromFile, ...config.env };
+        if (config.apiKey) {
+            if (this.agentType === 'gemini') {
+                envOverrides.GEMINI_API_KEY = config.apiKey;
+            }
+            else if (this.agentType === 'qwen') {
+                envOverrides.DASHSCOPE_API_KEY = config.apiKey;
+            }
+        }
+        const childEnv = cleanSpawnEnv(envOverrides);
+        const child = spawn(cmd, [...cmdArgs, ...args], {
+            cwd: config.workDir,
+            env: childEnv,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: true,
+            windowsHide: true,
+        });
+        if (!child.stdout || !child.stdin || !child.stderr) {
+            throw new Error(`Failed to spawn ${this.agentType}: stdio streams not available`);
+        }
+        // Pipe prompt to stdin then close the write end
+        child.stdin.write(config.prompt);
+        child.stdin.end();
+        // Heartbeat monitor: detect stale streams (60s silence)
+        const monitor = new StreamMonitor(() => {
+            this.emitEntry(processId, EntryNormalizer.error(processId, 'Stream stale: no output for 60s', 'stream_stale'));
+        });
+        this.streamMonitors.set(processId, monitor);
+        // Line-by-line parsing of stream-json stdout
+        const rl = createInterface({ input: child.stdout });
+        rl.on('line', (line) => {
+            monitor.heartbeat();
+            this.parseStreamJsonMessage(line, processId);
+        });
+        // Stderr => error entries
+        child.stderr.on('data', (chunk) => {
+            const text = chunk.toString().trim();
+            if (text.length > 0) {
+                this.emitEntry(processId, EntryNormalizer.error(processId, text, 'stderr'));
+            }
+        });
+        // Last-resort fallback: if stdout closes but neither 'exit' nor 'close'
+        // fire on the child (Windows shell: true + npx process tree edge case),
+        // emit stopped after a short delay to let the primary handlers run first.
+        rl.on('close', () => {
+            setTimeout(() => {
+                this.emitStopped(processId, 'stdout closed (readline fallback)');
+            }, 500);
+        });
+        // Process exit handling
+        this.setupProcessListeners(child, processId);
+        // Store references
+        this.childProcesses.set(processId, child);
+        this.readlineInterfaces.set(processId, rl);
+        return {
+            id: processId,
+            type: this.agentType,
+            status: 'running',
+            config,
+            startedAt: new Date().toISOString(),
+            pid: child.pid,
+        };
+    }
+    async doStop(processId) {
+        const child = this.childProcesses.get(processId);
+        if (!child) {
+            return;
+        }
+        const proc = this.getProcess(processId);
+        if (proc) {
+            proc.status = 'stopping';
+            this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'stopping', 'User requested stop'));
+        }
+        // Graceful SIGTERM
+        child.kill('SIGTERM');
+        // SIGKILL fallback after 5 seconds
+        const killTimer = setTimeout(() => {
+            if (!child.killed) {
+                child.kill('SIGKILL');
+            }
+        }, 5000);
+        child.once('exit', () => {
+            clearTimeout(killTimer);
+        });
+        this.cleanup(processId);
+    }
+    async doSendMessage(processId, _content) {
+        // Gemini/Qwen receive prompt via stdin at spawn time.
+        // Follow-up messages are not supported in stream-json mode.
+        throw new Error(`[${this.agentType}] Follow-up messages are not supported in stream-json mode`);
+    }
+    async doRespondApproval(_decision) {
+        // Gemini/Qwen handle approvals via --approval-mode flag, not stdin.
+        // No-op.
+    }
+    // --- Stream-json parsing -------------------------------------------------
+    parseStreamJsonMessage(line, processId) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            return;
+        }
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch {
+            // Non-JSON lines (e.g. npx bootstrap output) are silently skipped
+            return;
+        }
+        if (!msg || typeof msg !== 'object' || !('type' in msg)) {
+            return;
+        }
+        switch (msg.type) {
+            case 'init': {
+                this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'running', 'Session started'));
+                break;
+            }
+            case 'message': {
+                this.handleMessageEntry(msg, processId);
+                break;
+            }
+            case 'tool_use': {
+                const name = msg.tool_name ?? msg.name ?? 'unknown';
+                const input = msg.parameters ?? msg.input ?? {};
+                this.emitEntry(processId, EntryNormalizer.toolUse(processId, name, input, 'running'));
+                // Track tool_id → name mapping for tool_result correlation
+                if (msg.tool_id) {
+                    this.toolIdNames.set(msg.tool_id, name);
+                }
+                break;
+            }
+            case 'tool_result': {
+                const name = msg.tool_id
+                    ? (this.toolIdNames.get(msg.tool_id) ?? msg.name ?? 'unknown')
+                    : (msg.name ?? 'unknown');
+                const isError = msg.is_error || (msg.status !== undefined && msg.status !== 'success');
+                const status = isError ? 'failed' : 'completed';
+                const content = msg.content ?? msg.output;
+                this.emitEntry(processId, EntryNormalizer.toolUse(processId, name, {}, status, content));
+                break;
+            }
+            case 'result': {
+                const usage = msg.usage ?? msg.stats;
+                if (usage) {
+                    this.emitEntry(processId, EntryNormalizer.tokenUsage(processId, usage.input_tokens ?? 0, usage.output_tokens ?? 0));
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    handleMessageEntry(msg, processId) {
+        let content = msg.content ?? '';
+        // Think tag extraction: strip <think> blocks, emit as separate thinking entries
+        if (content.includes('<think>')) {
+            if (content.includes('</think>')) {
+                const thinkMatch = content.match(/<think>([\s\S]*?)<\/think>/);
+                if (thinkMatch && !this.thinkingEmitted.has(processId)) {
+                    const thought = thinkMatch[1].trim();
+                    if (thought.length > 0) {
+                        this.emitEntry(processId, EntryNormalizer.thinking(processId, thought));
+                    }
+                    this.thinkingEmitted.add(processId);
+                }
+                content = content.replace(/<think>[\s\S]*?<\/think>/, '').trimStart();
+            }
+            else {
+                // Incomplete think tag — wait for closing tag in next cumulative chunk
+                return;
+            }
+        }
+        if (msg.delta) {
+            // Cumulative-to-delta conversion: stream-json sends cumulative text
+            const lastLen = this.lastContentLength.get(processId) ?? 0;
+            const delta = content.slice(lastLen);
+            this.lastContentLength.set(processId, content.length);
+            if (delta.length > 0) {
+                this.emitEntry(processId, EntryNormalizer.assistantMessage(processId, delta, true));
+            }
+        }
+        else {
+            // Complete message — reset cumulative tracker and emit full content
+            this.lastContentLength.delete(processId);
+            if (content.length > 0) {
+                this.emitEntry(processId, EntryNormalizer.assistantMessage(processId, content, false));
+            }
+        }
+    }
+    // --- Helpers -------------------------------------------------------------
+    buildArgs(config) {
+        const args = ['-o', 'stream-json'];
+        if (config.model) {
+            args.push('-m', config.model);
+        }
+        if (config.approvalMode === 'auto') {
+            args.push('--approval-mode', 'yolo');
+        }
+        return args;
+    }
+    emitStopped(processId, reason) {
+        if (this.stoppedEmitted.has(processId))
+            return;
+        this.stoppedEmitted.add(processId);
+        this.emitEntry(processId, EntryNormalizer.statusChange(processId, 'stopped', reason));
+        const proc = this.getProcess(processId);
+        if (proc) {
+            proc.status = 'stopped';
+        }
+        this.cleanup(processId);
+        this.removeProcess(processId);
+    }
+    setupProcessListeners(child, processId) {
+        child.on('exit', (code, signal) => {
+            const reason = signal
+                ? `Terminated by signal: ${signal}`
+                : `Exited with code: ${code ?? 'unknown'}`;
+            this.emitStopped(processId, reason);
+        });
+        // Fallback: 'close' fires after exit + stdio close — covers edge cases
+        // where 'exit' is missed on Windows process trees (shell: true + npx).
+        child.on('close', (code, signal) => {
+            const reason = signal
+                ? `Terminated by signal: ${signal}`
+                : `Exited with code: ${code ?? 'unknown'}`;
+            this.emitStopped(processId, reason);
+        });
+        child.on('error', (err) => {
+            this.emitEntry(processId, EntryNormalizer.error(processId, err.message, 'spawn_error'));
+            const proc = this.getProcess(processId);
+            if (proc) {
+                proc.status = 'error';
+            }
+        });
+    }
+    cleanup(processId) {
+        const rl = this.readlineInterfaces.get(processId);
+        if (rl) {
+            rl.close();
+            this.readlineInterfaces.delete(processId);
+        }
+        const monitor = this.streamMonitors.get(processId);
+        if (monitor) {
+            monitor.dispose();
+            this.streamMonitors.delete(processId);
+        }
+        this.childProcesses.delete(processId);
+        this.lastContentLength.delete(processId);
+        this.thinkingEmitted.delete(processId);
+        this.toolIdNames.clear();
+        // Note: stoppedEmitted is intentionally NOT cleared here — it must persist
+        // to guard against the readline close fallback timer firing after cleanup.
+    }
+}
+//# sourceMappingURL=stream-json-adapter.js.map