@liangjie559567/ultrapower 5.0.4

package/dist/mcp/__tests__/job-state-db-deprecation.test.js

@@ -0,0 +1,119 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { existsSync, mkdirSync, rmSync } from 'fs';
+import { join } from 'path';
+import { initJobDb, closeJobDb, closeAllJobDbs, isJobDbInitialized, upsertJob, getJob, } from '../job-state-db.js';
+const TEST_DIR_A = join(process.cwd(), '.test-jobdb-deprecation-a-' + process.pid);
+const TEST_DIR_B = join(process.cwd(), '.test-jobdb-deprecation-b-' + process.pid);
+function createTestJob(overrides = {}) {
+    return {
+        provider: 'codex',
+        jobId: 'test-' + Math.random().toString(36).slice(2, 8),
+        slug: 'test-prompt',
+        status: 'spawned',
+        pid: 12345,
+        promptFile: '/test/prompt.md',
+        responseFile: '/test/response.md',
+        model: 'gpt-5.3-codex',
+        agentRole: 'architect',
+        spawnedAt: new Date().toISOString(),
+        ...overrides,
+    };
+}
+describe('job-state-db deprecation warnings', () => {
+    beforeEach(() => {
+        // Ensure clean state
+        closeAllJobDbs();
+        for (const dir of [TEST_DIR_A, TEST_DIR_B]) {
+            if (existsSync(dir)) {
+                rmSync(dir, { recursive: true, force: true });
+            }
+            mkdirSync(dir, { recursive: true });
+        }
+    });
+    afterEach(() => {
+        closeAllJobDbs();
+        for (const dir of [TEST_DIR_A, TEST_DIR_B]) {
+            if (existsSync(dir)) {
+                rmSync(dir, { recursive: true, force: true });
+            }
+        }
+    });
+    describe('multi-worktree isolation', () => {
+        it('should keep separate data for different cwd paths', async () => {
+            await initJobDb(TEST_DIR_A);
+            await initJobDb(TEST_DIR_B);
+            const jobA = createTestJob({ jobId: 'job-a', provider: 'codex' });
+            const jobB = createTestJob({ jobId: 'job-b', provider: 'gemini' });
+            upsertJob(jobA, TEST_DIR_A);
+            upsertJob(jobB, TEST_DIR_B);
+            // Each cwd should only see its own jobs
+            expect(getJob('codex', 'job-a', TEST_DIR_A)).not.toBeNull();
+            expect(getJob('gemini', 'job-b', TEST_DIR_A)).toBeNull();
+            expect(getJob('gemini', 'job-b', TEST_DIR_B)).not.toBeNull();
+            expect(getJob('codex', 'job-a', TEST_DIR_B)).toBeNull();
+        });
+    });
+    describe('getDb deprecation warning', () => {
+        it('should emit deprecation warning when getDb() called without cwd and multiple DBs are open', async () => {
+            await initJobDb(TEST_DIR_A);
+            await initJobDb(TEST_DIR_B);
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            // Insert a job without specifying cwd - triggers getDb() no-arg path
+            const job = createTestJob({ jobId: 'warn-test' });
+            upsertJob(job); // no cwd arg
+            const warnings = warnSpy.mock.calls.map(c => c[0]);
+            expect(warnings.some((w) => typeof w === 'string' && w.includes('DEPRECATED') && w.includes('getDb()'))).toBe(true);
+            warnSpy.mockRestore();
+        });
+        it('should not emit deprecation warning with single DB open', async () => {
+            await initJobDb(TEST_DIR_A);
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            const job = createTestJob({ jobId: 'no-warn-test' });
+            upsertJob(job); // no cwd arg, but only one DB
+            const warnings = warnSpy.mock.calls.map(c => c[0]);
+            expect(warnings.some((w) => typeof w === 'string' && w.includes('DEPRECATED') && w.includes('getDb()'))).toBe(false);
+            warnSpy.mockRestore();
+        });
+    });
+    describe('closeAllJobDbs', () => {
+        it('should close all open database connections', async () => {
+            await initJobDb(TEST_DIR_A);
+            await initJobDb(TEST_DIR_B);
+            expect(isJobDbInitialized(TEST_DIR_A)).toBe(true);
+            expect(isJobDbInitialized(TEST_DIR_B)).toBe(true);
+            closeAllJobDbs();
+            expect(isJobDbInitialized(TEST_DIR_A)).toBe(false);
+            expect(isJobDbInitialized(TEST_DIR_B)).toBe(false);
+            expect(isJobDbInitialized()).toBe(false);
+        });
+        it('should be safe to call when no DBs are open', () => {
+            expect(() => closeAllJobDbs()).not.toThrow();
+        });
+        it('should be safe to call multiple times', async () => {
+            await initJobDb(TEST_DIR_A);
+            closeAllJobDbs();
+            closeAllJobDbs();
+            expect(isJobDbInitialized()).toBe(false);
+        });
+    });
+    describe('closeJobDb with specific cwd', () => {
+        it('should close only the specified DB', async () => {
+            await initJobDb(TEST_DIR_A);
+            await initJobDb(TEST_DIR_B);
+            closeJobDb(TEST_DIR_A);
+            expect(isJobDbInitialized(TEST_DIR_A)).toBe(false);
+            expect(isJobDbInitialized(TEST_DIR_B)).toBe(true);
+        });
+    });
+    describe('closeJobDb without cwd deprecation', () => {
+        it('should emit deprecation warning when called without cwd', async () => {
+            await initJobDb(TEST_DIR_A);
+            const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+            closeJobDb(); // no cwd
+            const warnings = warnSpy.mock.calls.map(c => c[0]);
+            expect(warnings.some((w) => typeof w === 'string' && w.includes('DEPRECATED') && w.includes('closeJobDb()'))).toBe(true);
+            warnSpy.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=job-state-db-deprecation.test.js.map

package/dist/mcp/__tests__/job-state-db-deprecation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-state-db-deprecation.test.js","sourceRoot":"","sources":["../../../src/mcp/__tests__/job-state-db-deprecation.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,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EACL,SAAS,EACT,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,MAAM,GACP,MAAM,oBAAoB,CAAC;AAG5B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,4BAA4B,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AACnF,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,4BAA4B,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEnF,SAAS,aAAa,CAAC,YAAgC,EAAE;IACvD,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,SAAS;QACjB,GAAG,EAAE,KAAK;QACV,UAAU,EAAE,iBAAiB;QAC7B,YAAY,EAAE,mBAAmB;QACjC,KAAK,EAAE,eAAe;QACtB,SAAS,EAAE,WAAW;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,UAAU,CAAC,GAAG,EAAE;QACd,qBAAqB;QACrB,cAAc,EAAE,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;YACD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,cAAc,EAAE,CAAC;QACjB,KAAK,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;QACxC,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5B,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5B,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEnE,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAC5B,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YAE5B,wCAAwC;YACxC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC5D,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;YAEzD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC7D,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACzC,EAAE,CAAC,2FAA2F,EAAE,KAAK,IAAI,EAAE;YACzG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5B,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5B,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEvE,qEAAqE;YACrE,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;YAClD,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa;YAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CACjC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC3E,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5B,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEvE,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;YACrD,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,8BAA8B;YAE9C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CACjC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC3E,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAEf,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5B,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5B,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAElD,cAAc,EAAE,CAAC;YAEjB,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;YACrD,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5B,cAAc,EAAE,CAAC;YACjB,cAAc,EAAE,CAAC;YACjB,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5B,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5B,UAAU,CAAC,UAAU,CAAC,CAAC;YAEvB,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAClD,EAAE,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;YACvE,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;YAE5B,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEvE,UAAU,EAAE,CAAC,CAAC,SAAS;YAEvB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CACjC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAChF,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/mcp/__tests__/shared-exec.test.d.ts

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

package/dist/mcp/__tests__/shared-exec.test.d.ts.map

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

package/dist/mcp/__tests__/shared-exec.test.js

@@ -0,0 +1,151 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { mkdirSync, existsSync, rmSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { createStdoutCollector, safeWriteOutputFile, TRUNCATION_MARKER, E_PATH_OUTSIDE_WORKDIR_OUTPUT } from '../shared-exec.js';
+import { clearMcpConfigCache } from '../mcp-config.js';
+describe('createStdoutCollector', () => {
+    it('should accumulate chunks below the limit', () => {
+        const collector = createStdoutCollector(100);
+        collector.append('hello ');
+        collector.append('world');
+        expect(collector.toString()).toBe('hello world');
+        expect(collector.isTruncated).toBe(false);
+    });
+    it('should not truncate at exact limit boundary', () => {
+        const collector = createStdoutCollector(10);
+        collector.append('0123456789'); // exactly 10 bytes
+        expect(collector.toString()).toBe('0123456789');
+        expect(collector.isTruncated).toBe(false);
+    });
+    it('should truncate at limit + 1', () => {
+        const collector = createStdoutCollector(10);
+        collector.append('0123456789X'); // 11 bytes
+        expect(collector.toString()).toBe('0123456789' + TRUNCATION_MARKER);
+        expect(collector.isTruncated).toBe(true);
+    });
+    it('should handle multi-chunk accumulation crossing the limit', () => {
+        const collector = createStdoutCollector(10);
+        collector.append('01234'); // 5 bytes
+        collector.append('56789'); // 10 bytes total - at limit
+        expect(collector.isTruncated).toBe(false);
+        collector.append('X'); // 11 bytes
+        expect(collector.isTruncated).toBe(true);
+        expect(collector.toString()).toBe('0123456789' + TRUNCATION_MARKER);
+    });
+    it('should append truncation marker exactly once', () => {
+        const collector = createStdoutCollector(5);
+        collector.append('12345678'); // way over
+        collector.append('more data'); // ignored
+        collector.append('even more'); // ignored
+        const output = collector.toString();
+        const markerCount = output.split(TRUNCATION_MARKER).length - 1;
+        expect(markerCount).toBe(1);
+    });
+    it('should ignore further appends after truncation', () => {
+        const collector = createStdoutCollector(5);
+        collector.append('abcdefgh'); // triggers truncation
+        const afterFirst = collector.toString();
+        collector.append('ignored');
+        expect(collector.toString()).toBe(afterFirst);
+    });
+    it('should handle empty string appends', () => {
+        const collector = createStdoutCollector(10);
+        collector.append('');
+        collector.append('hello');
+        collector.append('');
+        expect(collector.toString()).toBe('hello');
+        expect(collector.isTruncated).toBe(false);
+    });
+    it('should handle a single large chunk exceeding limit', () => {
+        const collector = createStdoutCollector(3);
+        collector.append('abcdef');
+        expect(collector.toString()).toBe('abc' + TRUNCATION_MARKER);
+        expect(collector.isTruncated).toBe(true);
+    });
+});
+describe('safeWriteOutputFile', () => {
+    const TEST_DIR = join(process.cwd(), '.test-safe-write-' + process.pid);
+    beforeEach(() => {
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true, force: true });
+        }
+        mkdirSync(TEST_DIR, { recursive: true });
+    });
+    afterEach(() => {
+        clearMcpConfigCache();
+        if (existsSync(TEST_DIR)) {
+            rmSync(TEST_DIR, { recursive: true, force: true });
+        }
+    });
+    it('should write content to a file successfully', () => {
+        const result = safeWriteOutputFile('output.txt', 'hello world', TEST_DIR);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.actualPath).toBe(join(TEST_DIR, 'output.txt'));
+        }
+        const content = readFileSync(join(TEST_DIR, 'output.txt'), 'utf-8');
+        expect(content).toBe('hello world');
+    });
+    it('should create intermediate directories', () => {
+        const result = safeWriteOutputFile('sub/dir/output.txt', 'nested', TEST_DIR);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.actualPath).toBe(join(TEST_DIR, 'sub', 'dir', 'output.txt'));
+        }
+        const content = readFileSync(join(TEST_DIR, 'sub', 'dir', 'output.txt'), 'utf-8');
+        expect(content).toBe('nested');
+    });
+    it('should return error for paths outside the base directory in strict mode', () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        // Set strict mode via environment variable
+        const originalPolicy = process.env.OMC_MCP_OUTPUT_PATH_POLICY;
+        process.env.OMC_MCP_OUTPUT_PATH_POLICY = 'strict';
+        clearMcpConfigCache();
+        const result = safeWriteOutputFile('../escape.txt', 'bad', TEST_DIR, '[mcp]');
+        // Restore environment
+        process.env.OMC_MCP_OUTPUT_PATH_POLICY = originalPolicy;
+        // Should return error with E_PATH_OUTSIDE_WORKDIR_OUTPUT
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.errorToken).toBe(E_PATH_OUTSIDE_WORKDIR_OUTPUT);
+            expect(result.errorMessage).toContain('E_PATH_OUTSIDE_WORKDIR_OUTPUT');
+            expect(result.errorMessage).toContain('../escape.txt');
+            expect(result.errorMessage).toContain('working_directory');
+            expect(result.errorMessage).toContain("set OMC_MCP_OUTPUT_PATH_POLICY=redirect_output");
+        }
+        expect(existsSync(join(TEST_DIR, '..', 'escape.txt'))).toBe(false);
+        warnSpy.mockRestore();
+    });
+    it('should redirect output for paths outside the base directory in redirect_output mode', () => {
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        // Set redirect mode via environment variable
+        const originalPolicy = process.env.OMC_MCP_OUTPUT_PATH_POLICY;
+        process.env.OMC_MCP_OUTPUT_PATH_POLICY = 'redirect_output';
+        clearMcpConfigCache();
+        const result = safeWriteOutputFile('/tmp/escape.txt', 'redirected content', TEST_DIR, '[mcp]');
+        // Restore environment
+        process.env.OMC_MCP_OUTPUT_PATH_POLICY = originalPolicy;
+        // Should redirect to .omc/outputs/
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.actualPath).toBe(join(TEST_DIR, '.omc', 'outputs', 'escape.txt'));
+        }
+        const content = readFileSync(join(TEST_DIR, '.omc', 'outputs', 'escape.txt'), 'utf-8');
+        expect(content).toBe('redirected content');
+        warnSpy.mockRestore();
+    });
+    it('should return error response on write failure', () => {
+        // Use a path that will fail - directory as file
+        mkdirSync(join(TEST_DIR, 'is-a-dir'), { recursive: true });
+        // Try to write to a path where a directory exists with the same name
+        // This creates a scenario where writeFileSync will fail
+        const result = safeWriteOutputFile('is-a-dir', 'content', TEST_DIR);
+        // Should return error with E_WRITE_FAILED
+        expect(result.success).toBe(false);
+        if (!result.success) {
+            expect(result.errorToken).toBe('E_WRITE_FAILED');
+            expect(result.errorMessage).toContain('Failed to write output file');
+        }
+    });
+});
+//# sourceMappingURL=shared-exec.test.js.map

package/dist/mcp/__tests__/shared-exec.test.js.map

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

package/dist/mcp/cli-detection.d.ts

@@ -0,0 +1,26 @@
+/**
+ * CLI Detection Utility
+ *
+ * Detects whether Codex and Gemini CLIs are installed and available on the system PATH.
+ * Results are cached per-session to avoid repeated filesystem checks.
+ */
+export interface CliDetectionResult {
+    available: boolean;
+    path?: string;
+    version?: string;
+    error?: string;
+    installHint: string;
+}
+/**
+ * Detect if Codex CLI is installed and available
+ */
+export declare function detectCodexCli(useCache?: boolean): CliDetectionResult;
+/**
+ * Detect if Gemini CLI is installed and available
+ */
+export declare function detectGeminiCli(useCache?: boolean): CliDetectionResult;
+/**
+ * Reset detection cache (useful for testing)
+ */
+export declare function resetDetectionCache(): void;
+//# sourceMappingURL=cli-detection.d.ts.map

package/dist/mcp/cli-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-detection.d.ts","sourceRoot":"","sources":["../../src/mcp/cli-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,UAAO,GAAG,kBAAkB,CA2BlE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,UAAO,GAAG,kBAAkB,CA2BnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}

package/dist/mcp/cli-detection.js

@@ -0,0 +1,80 @@
+/**
+ * CLI Detection Utility
+ *
+ * Detects whether Codex and Gemini CLIs are installed and available on the system PATH.
+ * Results are cached per-session to avoid repeated filesystem checks.
+ */
+import { execSync } from 'child_process';
+// Session-level cache for detection results
+let codexCache = null;
+let geminiCache = null;
+/**
+ * Detect if Codex CLI is installed and available
+ */
+export function detectCodexCli(useCache = true) {
+    if (useCache && codexCache)
+        return codexCache;
+    const installHint = 'Install Codex CLI: npm install -g @openai/codex';
+    try {
+        const command = process.platform === 'win32' ? 'where codex' : 'which codex';
+        const path = execSync(command, { encoding: 'utf-8', timeout: 5000 }).trim();
+        let version;
+        try {
+            version = execSync('codex --version', { encoding: 'utf-8', timeout: 5000 }).trim();
+        }
+        catch {
+            // Version check is optional
+        }
+        const result = { available: true, path, version, installHint };
+        codexCache = result;
+        return result;
+    }
+    catch {
+        const result = {
+            available: false,
+            error: 'Codex CLI not found on PATH',
+            installHint
+        };
+        codexCache = result;
+        return result;
+    }
+}
+/**
+ * Detect if Gemini CLI is installed and available
+ */
+export function detectGeminiCli(useCache = true) {
+    if (useCache && geminiCache)
+        return geminiCache;
+    const installHint = 'Install Gemini CLI: npm install -g @google/gemini-cli (see https://github.com/google-gemini/gemini-cli)';
+    try {
+        const command = process.platform === 'win32' ? 'where gemini' : 'which gemini';
+        const path = execSync(command, { encoding: 'utf-8', timeout: 5000 }).trim();
+        let version;
+        try {
+            version = execSync('gemini --version', { encoding: 'utf-8', timeout: 5000 }).trim();
+        }
+        catch {
+            // Version check is optional
+        }
+        const result = { available: true, path, version, installHint };
+        geminiCache = result;
+        return result;
+    }
+    catch {
+        const result = {
+            available: false,
+            error: 'Gemini CLI not found on PATH',
+            installHint
+        };
+        geminiCache = result;
+        return result;
+    }
+}
+/**
+ * Reset detection cache (useful for testing)
+ */
+export function resetDetectionCache() {
+    codexCache = null;
+    geminiCache = null;
+}
+//# sourceMappingURL=cli-detection.js.map

package/dist/mcp/cli-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-detection.js","sourceRoot":"","sources":["../../src/mcp/cli-detection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAUzC,4CAA4C;AAC5C,IAAI,UAAU,GAA8B,IAAI,CAAC;AACjD,IAAI,WAAW,GAA8B,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAQ,GAAG,IAAI;IAC5C,IAAI,QAAQ,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAE9C,MAAM,WAAW,GAAG,iDAAiD,CAAC;IAEtE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;QAC7E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5E,IAAI,OAA2B,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,GAAG,QAAQ,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrF,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QAED,MAAM,MAAM,GAAuB,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QACnF,UAAU,GAAG,MAAM,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAuB;YACjC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,6BAA6B;YACpC,WAAW;SACZ,CAAC;QACF,UAAU,GAAG,MAAM,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAQ,GAAG,IAAI;IAC7C,IAAI,QAAQ,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEhD,MAAM,WAAW,GAAG,yGAAyG,CAAC;IAE9H,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/E,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5E,IAAI,OAA2B,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,GAAG,QAAQ,CAAC,kBAAkB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACtF,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QAED,MAAM,MAAM,GAAuB,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QACnF,WAAW,GAAG,MAAM,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,MAAM,GAAuB;YACjC,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,8BAA8B;YACrC,WAAW;SACZ,CAAC;QACF,WAAW,GAAG,MAAM,CAAC;QACrB,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,UAAU,GAAG,IAAI,CAAC;IAClB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC"}

package/dist/mcp/codex-core.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Codex MCP Core - Shared business logic for Codex CLI integration
+ *
+ * This module contains all the business logic for the Codex MCP integration.
+ * It is imported by both the in-process SDK server (codex-server.ts) and the
+ * standalone stdio server to eliminate code duplication.
+ *
+ * This module is SDK-agnostic and contains no dependencies on @anthropic-ai/claude-agent-sdk.
+ */
+import type { BackgroundJobMeta } from './prompt-persistence.js';
+import { CODEX_MODEL_FALLBACKS } from '../features/model-routing/external-model-policy.js';
+export declare function isSpawnedPid(pid: number): boolean;
+export declare function clearSpawnedPids(): void;
+export declare const CODEX_DEFAULT_MODEL: string;
+export declare const CODEX_TIMEOUT: number;
+export declare const RATE_LIMIT_RETRY_COUNT: number;
+export declare const RATE_LIMIT_INITIAL_DELAY: number;
+export declare const RATE_LIMIT_MAX_DELAY: number;
+export { CODEX_MODEL_FALLBACKS };
+export declare const CODEX_RECOMMENDED_ROLES: readonly ["architect", "planner", "critic", "analyst", "code-reviewer", "security-reviewer", "tdd-guide"];
+export declare const VALID_REASONING_EFFORTS: readonly ["minimal", "low", "medium", "high", "xhigh"];
+export type ReasoningEffort = typeof VALID_REASONING_EFFORTS[number];
+export declare const MAX_FILE_SIZE: number;
+export declare const MAX_STDOUT_BYTES: number;
+/**
+ * Compute exponential backoff delay with jitter for rate limit retries.
+ * Returns delay in ms: min(initialDelay * 2^attempt, maxDelay) * random(0.5, 1.0)
+ */
+export declare function computeBackoffDelay(attempt: number, initialDelay?: number, maxDelay?: number): number;
+/**
+ * Sleep for the specified duration. Exported for test mockability.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Check if Codex JSONL output contains a model-not-found error
+ */
+export declare function isModelError(output: string): {
+    isError: boolean;
+    message: string;
+};
+/**
+ * Check if an error message or output indicates a rate-limit (429) error
+ * that should trigger a fallback to the next model in the chain.
+ */
+export declare function isRateLimitError(output: string, stderr?: string): {
+    isError: boolean;
+    message: string;
+};
+/**
+ * Check if an error is retryable (model error OR rate limit error)
+ */
+export declare function isRetryableError(output: string, stderr?: string): {
+    isError: boolean;
+    message: string;
+    type: 'model' | 'rate_limit' | 'none';
+};
+/**
+ * Parse Codex JSONL output to extract the final text response
+ *
+ * Codex CLI (--json mode) emits JSONL events. We extract text from:
+ * - item.completed with item.type === "agent_message" (final response text)
+ * - message events with content (string or array of {type: "text", text})
+ * - output_text events with text
+ *
+ * Note: Codex may also write to the output_file directly via shell commands.
+ * If it does, callers should prefer the file content over parsed stdout.
+ */
+export declare function parseCodexOutput(output: string): string;
+/**
+ * Execute Codex CLI command and return the response
+ */
+export declare function executeCodex(prompt: string, model: string, cwd?: string, reasoningEffort?: ReasoningEffort): Promise<string>;
+/**
+ * Execute Codex CLI with model fallback chain and exponential backoff on rate limits.
+ * Falls back on model_not_found or rate limit errors when model was not explicitly provided.
+ * When model IS explicit, retries the same model with backoff on rate limit.
+ */
+export declare function executeCodexWithFallback(prompt: string, model: string | undefined, cwd?: string, fallbackChain?: string[], 
+/** @internal Testing overrides */
+overrides?: {
+    executor?: typeof executeCodex;
+    sleepFn?: typeof sleep;
+}, reasoningEffort?: ReasoningEffort): Promise<{
+    response: string;
+    usedFallback: boolean;
+    actualModel: string;
+}>;
+/**
+ * Execute Codex CLI in background with fallback chain, writing status and response files upon completion
+ */
+export declare function executeCodexBackground(fullPrompt: string, modelInput: string | undefined, jobMeta: BackgroundJobMeta, workingDirectory?: string, reasoningEffort?: ReasoningEffort): {
+    pid: number;
+} | {
+    error: string;
+};
+/**
+ * Validate and read a file for context inclusion
+ */
+export declare function validateAndReadFile(filePath: string, baseDir?: string): string;
+/**
+ * Handle ask_codex tool invocation with all business logic
+ *
+ * This function contains ALL the tool handler logic and can be used by both
+ * the SDK server and the standalone stdio server.
+ */
+export declare function handleAskCodex(args: {
+    prompt?: string;
+    prompt_file?: string;
+    output_file?: string;
+    agent_role: string;
+    model?: string;
+    reasoning_effort?: string;
+    context_files?: string[];
+    background?: boolean;
+    working_directory?: string;
+}): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+//# sourceMappingURL=codex-core.d.ts.map

package/dist/mcp/codex-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-core.d.ts","sourceRoot":"","sources":["../../src/mcp/codex-core.ts"],"names":[],"mappings":"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"}