import { afterEach, describe, expect, test } from 'bun:test'; import fs from 'node:fs'; import fsp from 'node:fs/promises'; import http from 'node:http'; import os from 'node:os'; import path from 'node:path'; import { EventEmitter } from 'node:events'; import { PassThrough } from 'node:stream'; import { ElectronSshManager } from './ssh-manager.mjs'; const servers = []; const tempDirs = []; const createChild = () => { const child = new EventEmitter(); child.stdin = new PassThrough(); child.stdout = new PassThrough(); child.stderr = new PassThrough(); child.exitCode = null; child.kill = () => { child.exitCode = 0; return true; }; return child; }; const listen = async (server) => { await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve)); servers.push(server); const address = server.address(); if (!address || typeof address === 'string') throw new Error('Expected TCP server address'); return `http://127.0.0.1:${address.port}`; }; const readBody = async (req) => { let body = ''; for await (const chunk of req) body += chunk.toString(); return body; }; afterEach(async () => { while (servers.length > 0) { const server = servers.pop(); await new Promise((resolve) => server.close(() => resolve())); } while (tempDirs.length > 0) { await fsp.rm(tempDirs.pop(), { recursive: true, force: true }); } }); describe('ElectronSshManager', () => { test('runs Windows SSH commands without ControlMaster and hides the process window', async () => { const calls = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '0.0.0-test', emit: () => undefined, platform: 'win32', spawn: (command, args, options) => { calls.push({ command, args, options }); const child = createChild(); queueMicrotask(() => { child.stdout.end('Linux\n'); child.exitCode = 0; child.emit('close', 0); }); return child; }, }); const parsed = { destination: 'user@example.test', args: [] }; await expect(manager.runRemoteCommand(parsed, 'C:\\Temp\\unused.sock', 'uname -s')).resolves.toBe('Linux\n'); expect(calls).toHaveLength(1); expect(calls[0].command).toBe('ssh'); expect(calls[0].options.windowsHide).toBe(true); expect(calls[0].args).toContain('ControlMaster=no'); expect(calls[0].args).toContain('ControlPath=none'); expect(calls[0].args).toContain('StrictHostKeyChecking=accept-new'); expect(calls[0].args).not.toContain('ControlPath=C:\\Temp\\unused.sock'); }); test('creates a PowerShell-backed askpass helper on Windows', async () => { const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'openchamber-ssh-askpass-test-')); tempDirs.push(tempDir); const manager = new ElectronSshManager({ settingsFilePath: path.join(tempDir, 'settings.json'), appVersion: '0.0.0-test', emit: () => undefined, platform: 'win32', }); const result = await manager.writeAskpassFiles(tempDir); expect(path.basename(result.askpassPath)).toBe('askpass.cmd'); expect(result.cleanupPaths.map((filePath) => path.basename(filePath))).toEqual(['askpass.cmd', 'askpass.ps1']); expect(await fsp.readFile(path.join(tempDir, 'askpass.cmd'), 'utf8')).toContain('WindowsPowerShell'); expect(await fsp.readFile(path.join(tempDir, 'askpass.ps1'), 'utf8')).toContain('OPENCHAMBER_SSH_ASKPASS_VALUE'); }); test('runs each Windows port forward as an independent hidden SSH process', async () => { const calls = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '0.0.0-test', emit: () => undefined, platform: 'win32', spawn: (command, args, options) => { calls.push({ command, args, options }); return createChild(); }, }); const parsed = { destination: 'user@example.test', args: [] }; manager.sshAuth.set(parsed, { askpassPath: 'C:\\OpenChamber\\askpass.cmd', sshPassword: 'secret-value', children: new Set(), }); await manager.spawnMainForward(parsed, 'C:\\Temp\\unused.sock', '127.0.0.1', 3000, 4000); await manager.spawnExtraForward(parsed, 'C:\\Temp\\unused.sock', { id: 'dynamic-1', type: 'dynamic', localHost: '127.0.0.1', localPort: 5000, }); expect(calls).toHaveLength(2); for (const call of calls) { expect(call.command).toBe('ssh'); expect(call.args).toContain('ControlPath=none'); expect(call.args).toContain('-N'); expect(call.options.windowsHide).toBe(true); expect(call.options.env.SSH_ASKPASS).toBe('C:\\OpenChamber\\askpass.cmd'); expect(call.options.env.OPENCHAMBER_SSH_ASKPASS_VALUE).toBe('secret-value'); } expect(calls[0].args).toContain('-L'); expect(calls[1].args).toContain('-D'); }); test('keeps ControlMaster-backed forwarding on non-Windows platforms', async () => { const calls = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '0.0.0-test', emit: () => undefined, platform: 'darwin', spawn: (command, args, options) => { calls.push({ command, args, options }); return createChild(); }, }); const parsed = { destination: 'user@example.test', args: [] }; await manager.spawnMainForward(parsed, '/tmp/control.sock', '127.0.0.1', 3000, 4000); expect(calls).toHaveLength(1); expect(calls[0].args).toContain('ControlPath=/tmp/control.sock'); expect(calls[0].args).not.toContain('ControlPath=none'); expect(calls[0].options.windowsHide).toBeUndefined(); }); test('stops in-flight commands and forwards when disconnecting Windows SSH', async () => { const killedChildren = []; const spawnedChildren = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '0.0.0-test', emit: () => undefined, platform: 'win32', spawn: () => { const child = createChild(); child.kill = () => { killedChildren.push(child); child.exitCode = 1; child.emit('close', 1); return true; }; spawnedChildren.push(child); return child; }, }); const parsed = { destination: 'user@example.test', args: [] }; const mainForward = createChild(); const extraForward = createChild(); for (const child of [mainForward, extraForward]) { child.kill = () => { killedChildren.push(child); child.exitCode = 0; return true; }; } manager.sshAuth.set(parsed, { askpassPath: 'C:\\OpenChamber\\askpass.cmd', sshPassword: null, children: new Set(), }); manager.sessions.set('ssh-1', { instance: { remoteOpenchamber: { mode: 'external', keepRunning: true } }, parsed, controlPath: 'C:\\Temp\\unused.sock', askpassCleanupPaths: [], startedByUs: false, remotePort: null, master: null, mainForward, extraForwards: [{ id: 'dynamic-1', child: extraForward }], }); let commandError = null; const command = manager.runRemoteCommand(parsed, 'C:\\Temp\\unused.sock', 'uname -s').catch((error) => { commandError = error; }); await manager.disconnectInternal('ssh-1', false); await command; expect(commandError?.message).toBe('Remote command failed'); expect(spawnedChildren).toHaveLength(1); expect(new Set(killedChildren)).toEqual(new Set([spawnedChildren[0], mainForward, extraForward])); expect(manager.sessions.has('ssh-1')).toBe(false); }); test('reports bounded, sanitized, and redacted SSH master stderr when startup fails', async () => { const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '0.0.0-test', emit: () => undefined, spawn: () => { const child = createChild(); queueMicrotask(() => { child.exitCode = 1; child.emit('close', 1); }); return child; }, }); const parsed = { destination: 'user@example.test', args: [] }; const master = createChild(); manager.sshAuth.set(parsed, { askpassPath: '/tmp/askpass.sh', sshPassword: 'secret-value', children: new Set(), }); manager.trackSshProcess(master, parsed); master.stderr.write(`muxclient socket failed: secret-value\u0007${'x'.repeat(3000)}`); master.exitCode = 255; try { await manager.waitForMasterReady(parsed, '/tmp/control.sock', 1, master); throw new Error('Expected SSH master startup to fail'); } catch (error) { expect(error.message).toStartWith('muxclient socket failed: [redacted]'); expect(error.message).not.toContain('secret-value'); expect(error.message).not.toContain('\u0007'); expect(error.message.length).toBeLessThanOrEqual(2000); } }); test('stores a client token for forwarded OpenChamber hosts when UI password is configured', async () => { let loginPayload = null; const server = http.createServer(async (req, res) => { if (req.method === 'POST' && req.url === '/auth/session') { loginPayload = JSON.parse(await readBody(req)); res.writeHead(200, { 'Content-Type': 'application/json' }); res.end(JSON.stringify({ authenticated: true, clientToken: 'ssh-client-token' })); return; } res.writeHead(404).end(); }); const localUrl = await listen(server); const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'openchamber-ssh-manager-test-')); tempDirs.push(tempDir); const settingsFilePath = path.join(tempDir, 'settings.json'); const manager = new ElectronSshManager({ settingsFilePath, appVersion: '0.0.0-test', emit: () => undefined, }); const token = await manager.issueClientToken(localUrl, 'ui-secret'); await manager.updateHostRuntime('ssh-1', 'SSH Host', localUrl, token); const settings = JSON.parse(fs.readFileSync(settingsFilePath, 'utf8')); expect(loginPayload).toMatchObject({ password: 'ui-secret', trustDevice: true, issueClientToken: true, }); expect(settings.desktopHosts).toEqual([{ id: 'ssh-1', label: 'SSH Host', url: localUrl, apiUrl: localUrl, clientToken: 'ssh-client-token' }]); }); test('installs OpenChamber into a home-owned npm prefix instead of the root-owned global one', async () => { const commands = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); manager.resolveRemoteTool = async (_parsed, _controlPath, name) => (name === 'npm' ? '/usr/bin/npm' : null); manager.runRemoteCommand = async (_parsed, _controlPath, script) => { commands.push(script); return ''; }; await manager.installOpenChamberManaged({ destination: 'user@example.test', args: [] }, '/tmp/control.sock', '1.2.3', 'auto'); expect(commands).toHaveLength(1); expect(commands[0]).toContain('--prefix "$HOME/.openchamber/npm-global"'); expect(commands[0]).not.toMatch(/npm install -g @openchamber/); }); test('lists every remote OpenChamber binary with its reported version', async () => { const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); manager.runRemoteCommand = async () => [ '/home/pi/.openchamber/npm-global/bin/openchamber\t1.2.3', '/usr/bin/openchamber\t0.9.0', '', ].join('\n'); const candidates = await manager.remoteOpenChamberCandidates({ destination: 'user@example.test', args: [] }, '/tmp/control.sock'); expect(candidates).toEqual([ { binPath: '/home/pi/.openchamber/npm-global/bin/openchamber', version: '1.2.3' }, { binPath: '/usr/bin/openchamber', version: '0.9.0' }, ]); }); test('starts the resolved OpenChamber binary rather than whatever PATH exposes', async () => { let started = ''; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); manager.resolveRemoteTool = async () => '/home/pi/.opencode/bin/opencode'; manager.runRemoteCommand = async (_parsed, _controlPath, script) => { started = script; return '4321\n'; }; const instance = { id: 'ssh-1', auth: {}, remoteOpenchamber: { mode: 'managed' } }; const port = await manager.startRemoteServerManaged( { destination: 'user@example.test', args: [] }, '/tmp/control.sock', instance, 4321, '/home/pi/.openchamber/npm-global/bin/openchamber', ); expect(port).toBe(4321); expect(started).toContain("'/home/pi/.openchamber/npm-global/bin/openchamber' serve"); expect(started).toContain("OPENCODE_BINARY='/home/pi/.opencode/bin/opencode'"); expect(started).toContain('$HOME/.opencode/bin:'); }); test('refuses to start when the remote machine has no opencode CLI', async () => { const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); manager.resolveRemoteTool = async () => null; manager.runRemoteCommand = async () => { throw new Error('should not start the server without a CLI'); }; await expect(manager.startRemoteServerManaged( { destination: 'user@example.test', args: [] }, '/tmp/control.sock', { id: 'ssh-1', auth: {}, remoteOpenchamber: { mode: 'managed' } }, 4321, '/home/pi/.bun/bin/openchamber', )).rejects.toThrow(/opencode CLI is not installed/); }); test('prefers a bun that only exists in the home directory over npm', async () => { const commands = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); // A login shell over SSH does not put ~/.bun/bin on PATH. manager.resolveRemoteTool = async (_parsed, _controlPath, name) => (name === 'bun' ? '/home/pi/.bun/bin/bun' : '/usr/bin/npm'); manager.runRemoteCommand = async (_parsed, _controlPath, script) => { commands.push(script); return ''; }; await manager.installOpenChamberManaged({ destination: 'user@example.test', args: [] }, '/tmp/control.sock', '1.2.3', 'auto'); expect(commands).toEqual(["'/home/pi/.bun/bin/bun' add -g @openchamber/web@1.2.3"]); }); test('stops a remote server it started through the CLI, not the authenticated HTTP route', async () => { const scripts = []; const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); manager.runRemoteCommand = async (_parsed, _controlPath, script) => { scripts.push(script); return ''; }; await manager.stopRemoteServerBestEffort( { destination: 'user@example.test', args: [] }, '/tmp/control.sock', 41777, '/home/pi/.bun/bin/openchamber', ); expect(scripts).toEqual(["'/home/pi/.bun/bin/openchamber' stop --port 41777"]); }); test('publishes the remote server to its network only with a UI password', async () => { const manager = new ElectronSshManager({ settingsFilePath: path.join(os.tmpdir(), 'unused-settings.json'), appVersion: '1.2.3', emit: () => undefined, }); manager.resolveRemoteTool = async () => '/home/pi/.opencode/bin/opencode'; let started = ''; manager.runRemoteCommand = async (_parsed, _controlPath, script) => { started = script; return '4321\n'; }; const parsed = { destination: 'user@example.test', args: [] }; const exposed = { id: 'ssh-1', auth: {}, remoteOpenchamber: { mode: 'managed', bindHost: '0.0.0.0' }, }; await expect(manager.startRemoteServerManaged(parsed, '/tmp/control.sock', exposed, 4321, '/bin/openchamber')) .rejects.toThrow(/requires a UI password/); const secured = { ...exposed, auth: { openchamberPassword: { enabled: true, value: 'remote-secret', store: 'settings' } }, }; await manager.startRemoteServerManaged(parsed, '/tmp/control.sock', secured, 4321, '/bin/openchamber'); expect(started).toContain('--hostname 0.0.0.0'); }); });