@mrpatronz/nexusflow 2.6.0 → 2.8.0

package/dist/harness/contract.test.js

@@ -0,0 +1,426 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ClaudeCodeAdapter } from './claude.js';
+import { CodexAdapter } from './codex.js';
+describe('Harness Contract Test Suite (Issue #174)', () => {
+    describe('ClaudeCodeAdapter Contract', () => {
+        it('resolves lazy sessionId and normalizes stream events and usage', async () => {
+            async function* fakeQuery() {
+                yield {
+                    type: 'system',
+                    subtype: 'init',
+                    session_id: '123e4567-e89b-12d3-a456-426614174000',
+                };
+                yield {
+                    type: 'stream_event',
+                    event: {
+                        type: 'content_block_delta',
+                        delta: { type: 'text_delta', text: 'Hello from Claude' },
+                    },
+                };
+                yield {
+                    type: 'assistant',
+                    message: {
+                        content: [{ type: 'text', text: 'Hello from Claude' }],
+                    },
+                };
+                yield {
+                    type: 'result',
+                    subtype: 'success',
+                    result: 'Hello from Claude',
+                    total_cost_usd: 0.002,
+                    usage: {
+                        input_tokens: 120,
+                        output_tokens: 30,
+                        cache_read_input_tokens: 40,
+                    },
+                };
+            }
+            const mockQueryFn = vi.fn().mockReturnValue(fakeQuery());
+            const adapter = new ClaudeCodeAdapter(undefined, mockQueryFn);
+            const handle = await adapter.start({
+                prompt: 'Say hello',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { ANTHROPIC_API_KEY: 'sk-ant-test' },
+            });
+            const sessionId = await handle.sessionId();
+            expect(sessionId).toBe('123e4567-e89b-12d3-a456-426614174000');
+            const events = [];
+            for await (const ev of handle.events) {
+                events.push(ev);
+                if (ev.type === 'turn_completed')
+                    break;
+            }
+            expect(events).toContainEqual({
+                type: 'session_started',
+                sessionId: '123e4567-e89b-12d3-a456-426614174000',
+            });
+            expect(events).toContainEqual({
+                type: 'text_delta',
+                text: 'Hello from Claude',
+            });
+            expect(events).toContainEqual({
+                type: 'assistant_message',
+                text: 'Hello from Claude',
+            });
+            expect(events).toContainEqual({
+                type: 'turn_completed',
+                usage: {
+                    inputTokens: 120,
+                    outputTokens: 30,
+                    cachedInputTokens: 40,
+                    costUsdEstimate: 0.002,
+                },
+            });
+            await handle.dispose();
+        });
+        it('cancels active turn cleanly on handle.interrupt() via AbortController', async () => {
+            let aborted = false;
+            async function* fakeLongQuery(args) {
+                const signal = args.options.abortController.signal;
+                signal.addEventListener('abort', () => {
+                    aborted = true;
+                });
+                yield {
+                    type: 'system',
+                    subtype: 'init',
+                    session_id: '123e4567-e89b-12d3-a456-426614174000',
+                };
+                yield {
+                    type: 'stream_event',
+                    event: {
+                        type: 'content_block_delta',
+                        delta: { type: 'text_delta', text: 'Starting long task...' },
+                    },
+                };
+                // Simulate waiting for abort
+                while (!signal.aborted) {
+                    await new Promise((r) => setTimeout(r, 10));
+                }
+            }
+            const mockQueryFn = vi.fn().mockImplementation((args) => fakeLongQuery(args));
+            const adapter = new ClaudeCodeAdapter(undefined, mockQueryFn);
+            const handle = await adapter.start({
+                prompt: 'Long running task',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { ANTHROPIC_API_KEY: 'sk-ant-test' },
+            });
+            await handle.interrupt();
+            expect(aborted).toBe(true);
+            await handle.dispose();
+        });
+    });
+    describe('CodexAdapter Contract & MCP Smoke Test', () => {
+        it('executes Codex thread lifecycle, maps MCP tool items, and normalizes usage', async () => {
+            async function* fakeStream() {
+                yield {
+                    type: 'thread.started',
+                    thread_id: 'codex-thread-12345',
+                };
+                yield {
+                    type: 'item.completed',
+                    item: {
+                        id: 'mcp-call-1',
+                        type: 'mcp_tool_call',
+                        server: 'nexusflow',
+                        tool: 'list_repos',
+                        arguments: {},
+                        status: 'completed',
+                        result: {
+                            content: [{ type: 'text', text: '["repo1"]' }],
+                            structured_content: ['repo1'],
+                        },
+                    },
+                };
+                yield {
+                    type: 'item.completed',
+                    item: {
+                        id: 'agent-msg-1',
+                        type: 'agent_message',
+                        text: 'Found 1 repo in workspace.',
+                    },
+                };
+                yield {
+                    type: 'turn.completed',
+                    usage: {
+                        input_tokens: 200,
+                        output_tokens: 50,
+                        cached_input_tokens: 100,
+                    },
+                };
+            }
+            const mockThread = {
+                id: 'codex-thread-12345',
+                runStreamed: vi.fn().mockResolvedValue({ events: fakeStream() }),
+            };
+            const mockClient = {
+                startThread: vi.fn().mockReturnValue(mockThread),
+            };
+            const adapter = new CodexAdapter({}, () => mockClient);
+            const handle = await adapter.start({
+                prompt: 'List repos via MCP',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { OPENAI_API_KEY: 'sk-test' },
+                mcpServers: {
+                    nexusflow: {
+                        command: process.execPath,
+                        args: ['mcp', 'run'],
+                    },
+                },
+            });
+            const sessionId = await handle.sessionId();
+            expect(sessionId).toBe('codex-thread-12345');
+            const events = [];
+            for await (const ev of handle.events) {
+                events.push(ev);
+                if (ev.type === 'turn_completed')
+                    break;
+            }
+            expect(events).toContainEqual({
+                type: 'session_started',
+                sessionId: 'codex-thread-12345',
+            });
+            expect(events).toContainEqual({
+                type: 'tool_completed',
+                callId: 'mcp-call-1',
+                ok: true,
+                outputSummary: undefined,
+            });
+            expect(events).toContainEqual({
+                type: 'assistant_message',
+                text: 'Found 1 repo in workspace.',
+            });
+            expect(events).toContainEqual({
+                type: 'turn_completed',
+                usage: {
+                    inputTokens: 200,
+                    outputTokens: 50,
+                    cachedInputTokens: 100,
+                },
+            });
+            await handle.dispose();
+        });
+        it('keeps the handle stream open for a queued follow-up turn', async () => {
+            let finishFirstTurn;
+            let finishSecondTurn;
+            const firstTurnFinished = new Promise((resolve) => {
+                finishFirstTurn = resolve;
+            });
+            const secondTurnFinished = new Promise((resolve) => {
+                finishSecondTurn = resolve;
+            });
+            async function* firstTurn() {
+                try {
+                    yield {
+                        type: 'thread.started',
+                        thread_id: 'codex-thread-multi-turn',
+                    };
+                    yield {
+                        type: 'item.completed',
+                        item: {
+                            id: 'agent-msg-first',
+                            type: 'agent_message',
+                            text: 'First response',
+                        },
+                    };
+                    yield {
+                        type: 'turn.completed',
+                        usage: { input_tokens: 10, output_tokens: 2 },
+                    };
+                }
+                finally {
+                    finishFirstTurn();
+                }
+            }
+            async function* secondTurn() {
+                try {
+                    yield {
+                        type: 'item.completed',
+                        item: {
+                            id: 'agent-msg-second',
+                            type: 'agent_message',
+                            text: 'Second response',
+                        },
+                    };
+                    yield {
+                        type: 'turn.completed',
+                        usage: { input_tokens: 12, output_tokens: 3 },
+                    };
+                }
+                finally {
+                    finishSecondTurn();
+                }
+            }
+            const runStreamed = vi.fn()
+                .mockResolvedValueOnce({ events: firstTurn() })
+                .mockResolvedValueOnce({ events: secondTurn() });
+            const mockThread = {
+                id: 'codex-thread-multi-turn',
+                runStreamed,
+            };
+            const mockClient = {
+                startThread: vi.fn().mockReturnValue(mockThread),
+            };
+            const adapter = new CodexAdapter({}, () => mockClient);
+            const handle = await adapter.start({
+                prompt: 'First prompt',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { OPENAI_API_KEY: 'sk-test' },
+            });
+            const events = handle.events[Symbol.asyncIterator]();
+            try {
+                await expect(events.next()).resolves.toEqual({
+                    done: false,
+                    value: { type: 'session_started', sessionId: 'codex-thread-multi-turn' },
+                });
+                await expect(events.next()).resolves.toEqual({
+                    done: false,
+                    value: { type: 'assistant_message', text: 'First response' },
+                });
+                await expect(events.next()).resolves.toMatchObject({
+                    done: false,
+                    value: { type: 'turn_completed' },
+                });
+                await firstTurnFinished;
+                await new Promise((resolve) => setImmediate(resolve));
+                handle.send('Second prompt');
+                await expect(events.next()).resolves.toEqual({
+                    done: false,
+                    value: { type: 'assistant_message', text: 'Second response' },
+                });
+                await expect(events.next()).resolves.toMatchObject({
+                    done: false,
+                    value: { type: 'turn_completed' },
+                });
+                await secondTurnFinished;
+                await new Promise((resolve) => setImmediate(resolve));
+                expect(runStreamed).toHaveBeenNthCalledWith(1, 'First prompt', expect.any(Object));
+                expect(runStreamed).toHaveBeenNthCalledWith(2, 'Second prompt', expect.any(Object));
+                const pendingNext = events.next();
+                const stateBeforeDispose = await Promise.race([
+                    pendingNext.then(() => 'settled'),
+                    new Promise((resolve) => setTimeout(() => resolve('pending'), 25)),
+                ]);
+                expect(stateBeforeDispose).toBe('pending');
+                await handle.dispose();
+                await expect(pendingNext).resolves.toEqual({ done: true, value: undefined });
+            }
+            finally {
+                await handle.dispose();
+            }
+        });
+        it('applies model and native thread options when resuming a Codex thread', async () => {
+            const mockThread = {
+                id: 'codex-thread-resumed',
+                runStreamed: vi.fn(),
+            };
+            const mockClient = {
+                resumeThread: vi.fn().mockReturnValue(mockThread),
+            };
+            const adapter = new CodexAdapter({}, () => mockClient);
+            const handle = await adapter.resume({
+                sessionId: 'codex-thread-resumed',
+                mode: 'resume',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { OPENAI_API_KEY: 'sk-test' },
+                model: 'gpt-5.6-terra',
+                nativeOptions: { sandboxMode: 'read-only' },
+            });
+            expect(mockClient.resumeThread).toHaveBeenCalledWith('codex-thread-resumed', {
+                model: 'gpt-5.6-terra',
+                sandboxMode: 'read-only',
+            });
+            expect(mockThread.runStreamed).not.toHaveBeenCalled();
+            await handle.dispose();
+        });
+        it('cancels active Codex turn on handle.interrupt() via AbortSignal', async () => {
+            let aborted = false;
+            async function* fakeLongStream(signal) {
+                if (signal) {
+                    signal.addEventListener('abort', () => {
+                        aborted = true;
+                    });
+                }
+                yield {
+                    type: 'thread.started',
+                    thread_id: 'codex-thread-abort',
+                };
+                while (!signal?.aborted) {
+                    await new Promise((r) => setTimeout(r, 10));
+                }
+            }
+            const mockThread = {
+                id: 'codex-thread-abort',
+                runStreamed: vi.fn().mockImplementation((_prompt, opts) => {
+                    return Promise.resolve({ events: fakeLongStream(opts?.signal) });
+                }),
+            };
+            const mockClient = {
+                startThread: vi.fn().mockReturnValue(mockThread),
+            };
+            const adapter = new CodexAdapter({}, () => mockClient);
+            const handle = await adapter.start({
+                prompt: 'Long running codex task',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { OPENAI_API_KEY: 'sk-test' },
+            });
+            await handle.interrupt();
+            expect(aborted).toBe(true);
+            await handle.dispose();
+        });
+        it('does not run queued or later prompts after an interrupted turn fails fatally', async () => {
+            let streamWaiting;
+            const streamIsWaiting = new Promise((resolve) => {
+                streamWaiting = resolve;
+            });
+            async function* interruptedStream(signal) {
+                yield {
+                    type: 'thread.started',
+                    thread_id: 'codex-thread-interrupted',
+                };
+                await new Promise((_resolve, reject) => {
+                    const fail = () => reject(new Error('turn aborted'));
+                    if (signal?.aborted) {
+                        fail();
+                        return;
+                    }
+                    signal?.addEventListener('abort', fail, { once: true });
+                    streamWaiting();
+                });
+            }
+            const runStreamed = vi.fn().mockImplementation((_prompt, opts) => (Promise.resolve({ events: interruptedStream(opts?.signal) })));
+            const mockThread = {
+                id: 'codex-thread-interrupted',
+                runStreamed,
+            };
+            const mockClient = {
+                startThread: vi.fn().mockReturnValue(mockThread),
+            };
+            const adapter = new CodexAdapter({}, () => mockClient);
+            const handle = await adapter.start({
+                prompt: 'Active prompt',
+                workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                env: { OPENAI_API_KEY: 'sk-test' },
+            });
+            const events = handle.events[Symbol.asyncIterator]();
+            await expect(events.next()).resolves.toEqual({
+                done: false,
+                value: { type: 'session_started', sessionId: 'codex-thread-interrupted' },
+            });
+            await streamIsWaiting;
+            handle.send('Queued follow-up');
+            await handle.interrupt();
+            await expect(events.next()).resolves.toMatchObject({
+                done: false,
+                value: { type: 'turn_failed', fatal: true },
+            });
+            await expect(events.next()).resolves.toEqual({ done: true, value: undefined });
+            await new Promise((resolve) => setImmediate(resolve));
+            expect(runStreamed).toHaveBeenCalledTimes(1);
+            handle.send('Prompt after fatal failure');
+            await new Promise((resolve) => setImmediate(resolve));
+            expect(runStreamed).toHaveBeenCalledTimes(1);
+            await handle.dispose();
+        });
+    });
+});
+//# sourceMappingURL=contract.test.js.map

package/dist/harness/contract.test.js.map

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

package/dist/harness/harness.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=harness.test.d.ts.map

package/dist/harness/harness.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.test.d.ts","sourceRoot":"","sources":["../../src/harness/harness.test.ts"],"names":[],"mappings":""}

package/dist/harness/harness.test.js

@@ -0,0 +1,215 @@
+import { describe, expect, it } from 'vitest';
+import { getAdapter } from './index.js';
+import { Pushable } from './pushable.js';
+import { UnsupportedOperationError, AuthRequiredError } from './interface.js';
+describe('Harness Abstraction Layer', () => {
+    describe('Factory getAdapter', () => {
+        it('returns ClaudeCodeAdapter for claude-code', () => {
+            const adapter = getAdapter('claude-code');
+            expect(adapter.vendor).toBe('claude-code');
+        });
+        it('returns CodexAdapter for codex', () => {
+            const adapter = getAdapter('codex');
+            expect(adapter.vendor).toBe('codex');
+        });
+    });
+    describe('Pushable Async Iterable Queue', () => {
+        it('pushes and yields items sequentially', async () => {
+            const queue = new Pushable();
+            queue.push('item-1');
+            queue.push('item-2');
+            queue.end();
+            const items = [];
+            for await (const item of queue) {
+                items.push(item);
+            }
+            expect(items).toEqual(['item-1', 'item-2']);
+        });
+        it('handles async consumption after end', async () => {
+            const queue = new Pushable();
+            queue.push(10);
+            queue.end();
+            const result = [];
+            for await (const n of queue) {
+                result.push(n);
+            }
+            expect(result).toEqual([10]);
+        });
+        it('drains buffered items to a late subscriber', async () => {
+            const queue = new Pushable();
+            queue.push('a');
+            queue.push('b');
+            queue.push('c');
+            queue.end();
+            const received = [];
+            for await (const item of queue) {
+                received.push(item);
+            }
+            expect(received).toEqual(['a', 'b', 'c']);
+        });
+        it('is idempotent on double-end', async () => {
+            const queue = new Pushable();
+            queue.push('x');
+            queue.end();
+            expect(() => queue.end()).not.toThrow();
+            const items = [];
+            for await (const item of queue) {
+                items.push(item);
+            }
+            expect(items).toEqual(['x']);
+        });
+        it('safely handles dispose() mid-turn without unhandled rejections', async () => {
+            const queue = new Pushable();
+            let closed = false;
+            const safePush = (val) => {
+                if (closed)
+                    return;
+                try {
+                    queue.push(val);
+                }
+                catch {
+                    // Disposed concurrently
+                }
+            };
+            safePush('first-turn');
+            // Simulate concurrent dispose
+            closed = true;
+            queue.end();
+            // In-flight producer tries to push post-disposal
+            expect(() => safePush('in-flight-event')).not.toThrow();
+            const events = [];
+            for await (const ev of queue) {
+                events.push(ev);
+            }
+            expect(events).toEqual(['first-turn']);
+        });
+    });
+    describe('Normalized Contract Stream Verification (Fake Engine)', () => {
+        it('normalizes stream events into canonical HarnessEvent sequence', async () => {
+            const events = [];
+            const out = new Pushable();
+            // Push a canonical turn sequence
+            out.push({ type: 'session_started', sessionId: '123e4567-e89b-12d3-a456-426614174000' });
+            out.push({ type: 'text_delta', text: 'Hel' });
+            out.push({ type: 'text_delta', text: 'lo' });
+            out.push({ type: 'assistant_message', text: 'Hello' });
+            out.push({
+                type: 'turn_completed',
+                usage: {
+                    inputTokens: 100,
+                    outputTokens: 25,
+                    cachedInputTokens: 50,
+                    costUsdEstimate: 0.0015,
+                },
+            });
+            out.end();
+            for await (const ev of out) {
+                events.push(ev);
+            }
+            expect(events).toHaveLength(5);
+            expect(events[0]).toEqual({ type: 'session_started', sessionId: '123e4567-e89b-12d3-a456-426614174000' });
+            expect(events[1]).toEqual({ type: 'text_delta', text: 'Hel' });
+            expect(events[2]).toEqual({ type: 'text_delta', text: 'lo' });
+            expect(events[3]).toEqual({ type: 'assistant_message', text: 'Hello' });
+            expect(events[4]).toEqual({
+                type: 'turn_completed',
+                usage: {
+                    inputTokens: 100,
+                    outputTokens: 25,
+                    cachedInputTokens: 50,
+                    costUsdEstimate: 0.0015,
+                },
+            });
+        });
+        it('serializes errors safely for JSON boundary in turn_failed event', () => {
+            const rawError = new TypeError('Network connection reset');
+            const serialized = {
+                message: rawError.message,
+                name: rawError.name,
+                stack: rawError.stack,
+            };
+            const event = {
+                type: 'turn_failed',
+                error: serialized,
+                fatal: true,
+            };
+            const json = JSON.stringify(event);
+            const parsed = JSON.parse(json);
+            expect(parsed.error.message).toBe('Network connection reset');
+            expect(parsed.error.name).toBe('TypeError');
+            expect(parsed.fatal).toBe(true);
+        });
+    });
+    describe('Authentication Status Detection & Preflight', () => {
+        it('checks authStatus for ClaudeCodeAdapter', async () => {
+            const adapter = getAdapter('claude-code');
+            const status = await adapter.authStatus();
+            expect(status).toHaveProperty('configured');
+            expect(status).toHaveProperty('method');
+        });
+        it('checks authStatus for CodexAdapter', async () => {
+            const adapter = getAdapter('codex');
+            const status = await adapter.authStatus();
+            expect(status).toHaveProperty('configured');
+            expect(status).toHaveProperty('method');
+        });
+        it('detects credentials passed via env parameter (multi-tenant / per-spec)', async () => {
+            const adapter = getAdapter('claude-code');
+            const status = await adapter.authStatus(undefined, { ANTHROPIC_API_KEY: 'test-key' });
+            expect(status.configured).toBe(true);
+            expect(status.method).toBe('api-key');
+            const codexAdapter = getAdapter('codex');
+            const codexStatus = await codexAdapter.authStatus(undefined, {
+                OPENAI_API_KEY: 'sk-test',
+                CODEX_HOME: '/non-existent-codex-home-dir',
+            });
+            expect(codexStatus.configured).toBe(true);
+            expect(codexStatus.method).toBe('api-key');
+            expect(codexStatus.hasApiKeyFallback).toBe(false);
+        });
+        it('correctly sets hasApiKeyFallback for Codex when auth.json exists (Issue #172)', async () => {
+            const codexAdapter = getAdapter('codex');
+            // If no API key and no auth.json in temp dir
+            const unauthStatus = await codexAdapter.authStatus(undefined, {
+                OPENAI_API_KEY: '',
+                CODEX_API_KEY: '',
+                CODEX_HOME: '/non-existent-dir',
+            });
+            // Should cleanly compute method
+            expect(unauthStatus.hasApiKeyFallback).toBeFalsy();
+        });
+        it('throws AuthRequiredError on start() if unauthenticated', async () => {
+            const origKey = process.env.ANTHROPIC_API_KEY;
+            const origToken = process.env.CLAUDE_CODE_OAUTH_TOKEN;
+            delete process.env.ANTHROPIC_API_KEY;
+            delete process.env.CLAUDE_CODE_OAUTH_TOKEN;
+            try {
+                const adapter = getAdapter('claude-code');
+                await expect(adapter.start({
+                    prompt: 'test',
+                    workspace: { workspaceId: 'test-ws', rootPath: 'C:/test' },
+                })).rejects.toThrow(AuthRequiredError);
+            }
+            finally {
+                if (origKey)
+                    process.env.ANTHROPIC_API_KEY = origKey;
+                if (origToken)
+                    process.env.CLAUDE_CODE_OAUTH_TOKEN = origToken;
+            }
+        });
+    });
+    describe('Error Classes', () => {
+        it('formats UnsupportedOperationError message correctly', () => {
+            const err = new UnsupportedOperationError('codex', 'fork', 'no native fork');
+            expect(err.message).toContain('[codex] fork unsupported: no native fork');
+            expect(err.vendor).toBe('codex');
+            expect(err.operation).toBe('fork');
+        });
+        it('formats AuthRequiredError message correctly', () => {
+            const err = new AuthRequiredError('claude-code', 'token missing');
+            expect(err.message).toContain('[claude-code] Authentication required: token missing');
+            expect(err.vendor).toBe('claude-code');
+        });
+    });
+});
+//# sourceMappingURL=harness.test.js.map