import { PassThrough } from 'node:stream' import { describe, expect, it, vi } from 'vitest' import { stat } from 'node:fs/promises' import { basename, delimiter, dirname } from 'node:path' import { Context } from 'cordis' import LocalSubprocessService from '@deepseek-ai/dsh-subprocess-local' import type { SubprocessSpawnSpec, SubprocessTerminalHandle, SubprocessTerminalSpawnSpec } from '@deepseek-ai/dsh-subprocess' function spec(command: string, overrides: Partial = {}): SubprocessSpawnSpec { return { argv: ['bash', '-c', command], cwd: process.cwd(), stdio: { stdin: 'ignore', stdout: { maxBytes: 64_000, spill: { maxBytes: 64 * 1024 * 1024 } }, stderr: { maxBytes: 64_000, spill: { maxBytes: 64 * 1024 * 1024 } }, }, graceMs: 200, ...overrides, } } describe('LocalSubprocessService', () => { it('publishes execution-world paths and removes its private runtime directory', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const root = ctx.subprocess.runtimeRoot expect(ctx.subprocess.cwd).toBe(process.cwd()) expect((await stat(root)).isDirectory()).toBe(true) await fiber.dispose() await expect(stat(root)).rejects.toMatchObject({ code: 'ENOENT' }) }) it('resolves absolute and PATH executables and honors lookup cancellation', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) expect(await ctx.subprocess.resolveExecutable(process.execPath)).toBe(process.execPath) expect(await ctx.subprocess.resolveExecutable(basename(process.execPath), { PATH: dirname(process.execPath), })).toBe(process.execPath) await expect(ctx.subprocess.resolveExecutable('')).rejects.toThrow('must be non-empty') await expect(ctx.subprocess.resolveExecutable('dsh-command-that-does-not-exist', { PATH: '' })) .rejects.toThrow('was not found on PATH') await expect(ctx.subprocess.resolveExecutable('/dsh-absolute-command-that-does-not-exist')) .rejects.toThrow('is not an executable file') await expect(ctx.subprocess.resolveExecutable(process.cwd())) .rejects.toThrow('is not an executable file') await expect(ctx.subprocess.resolveExecutable(process.execPath, {}, AbortSignal.abort('stop'))) .rejects.toBe('stop') await fiber.dispose() }) it('builds Windows executable candidates without empty PATH entries', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const service = ctx.subprocess as LocalSubprocessService const candidates = (service as unknown as { executableCandidates(command: string, env: NodeJS.ProcessEnv): string[] }).executableCandidates.bind(service) const platform = vi.spyOn(process, 'platform', 'get').mockReturnValue('win32') try { expect(candidates('tool', { PATH: `${delimiter}/bin`, PATHEXT: '.EXE;.CMD' })) .toEqual(['/bin/tool.EXE', '/bin/tool.CMD']) expect(candidates('tool.exe', {})).toEqual([]) expect(candidates('tool', { PATH: '/bin' })).toHaveLength(4) } finally { platform.mockRestore() await fiber.dispose() } }) it('validates terminal spawn specs before allocating a PTY', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const base: SubprocessTerminalSpawnSpec = { argv: ['bash'], cwd: process.cwd(), rows: 24, cols: 80, graceMs: 10, } await expect(ctx.subprocess.spawnTerminal({ ...base, argv: [] })).rejects.toThrow('must contain a program') await expect(ctx.subprocess.spawnTerminal({ ...base, argv: [''] })).rejects.toThrow('must contain a program') await expect(ctx.subprocess.spawnTerminal({ ...base, rows: 1.5 })).rejects.toThrow('rows') await expect(ctx.subprocess.spawnTerminal({ ...base, cols: 0 })).rejects.toThrow('cols') await expect(ctx.subprocess.spawnTerminal({ ...base, graceMs: 0 })).rejects.toThrow('graceMs') await expect(ctx.subprocess.spawnTerminal({ ...base, signal: AbortSignal.abort('stop') })).rejects.toBe('stop') await fiber.dispose() }) it('terminates and joins an owned terminal during disposal', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const terminate = vi.fn() const waitForExit = vi.fn(async () => true) const terminal: SubprocessTerminalHandle = { pid: 1, output: new PassThrough(), done: Promise.resolve({ exitCode: 0, signal: null }), write: async () => {}, inspectForeground: async () => undefined, signalForeground: async () => 1, terminate, waitForExit, } ;(ctx.subprocess as unknown as { terminals: Set }).terminals.add(terminal) await fiber.dispose() expect(terminate).toHaveBeenCalledOnce() expect(waitForExit).toHaveBeenCalledOnce() }) it('contains a terminal release failure after top-level exit', async () => { let exitListener: ((event: { exitCode: number; signal?: number }) => void) | undefined const terminal = { pid: 123, onData: () => ({ dispose: () => {} }), onExit: (listener: (event: { exitCode: number; signal?: number }) => void) => { exitListener = listener return { dispose: () => {} } }, write: () => {}, kill: () => {}, } vi.resetModules() vi.doMock('node-pty', () => ({ spawn: () => terminal })) try { const { default: IsolatedLocalSubprocessService } = await import('../src/index.ts') const ctx = new Context() const fiber = await ctx.plugin(IsolatedLocalSubprocessService) const alive = new Set([124]) ;(ctx.subprocess as InstanceType).terminalInspector = { foregroundPgid: () => 123, isStdinWaiting: () => false, processTree: () => [{ pid: 124, started: 'child' }], isAlive: identity => alive.has(identity.pid), signalGroup: () => {}, signalProcess: () => {}, } const handle = await ctx.subprocess.spawnTerminal({ argv: ['shell'], cwd: process.cwd(), rows: 24, cols: 80, graceMs: 1, }) exitListener?.({ exitCode: 0 }) await handle.done await new Promise(resolve => setTimeout(resolve, 10)) alive.clear() handle.terminate() await handle.waitForExit() await fiber.dispose() } finally { vi.doUnmock('node-pty') vi.resetModules() } }) it('registers as ctx.subprocess and spawns managed handles', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const handle = ctx.subprocess.spawn(spec('echo managed')) const result = await handle.done expect(result.exitCode).toBe(0) expect(handle.collected.stdout!.readFrom(0).text).toBe('managed\n') await fiber.dispose() }) it('disposal kills still-running processes and awaits their exit', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const handle = ctx.subprocess.spawn(spec('sleep 60')) await fiber.dispose() const outcome = await handle.done expect(outcome.signal).toBe('SIGTERM') }) it('a settled process leaves the live set (disposal does not re-kill it)', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const handle = ctx.subprocess.spawn(spec('true')) const outcome = await handle.done expect(outcome.exitCode).toBe(0) await fiber.dispose() }) it('disposal tolerates a handle whose spawn already failed', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) const handle = ctx.subprocess.spawn(spec('true', { cwd: '/nonexistent-dir-dsh-subprocess-test' })) await expect(handle.done).rejects.toThrow() await fiber.dispose() }) it('disposal contains a spawn-failure rejection that races teardown', async () => { const ctx = new Context() const fiber = await ctx.plugin(LocalSubprocessService) // Dispose before the rejection continuation removes the handle from the // live set, so teardown itself must swallow the rejected done. const handle = ctx.subprocess.spawn(spec('true', { cwd: '/nonexistent-dir-dsh-subprocess-test' })) await fiber.dispose() await expect(handle.done).rejects.toThrow() }) it('loading a second implementation throws (one processes service per context — cordis standard)', async () => { const ctx = new Context() await ctx.plugin(LocalSubprocessService) class SecondManager extends LocalSubprocessService {} await expect(ctx.plugin(SecondManager)).rejects.toThrow(/service "subprocess" has been registered/) }) })