The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
import { createServer } from 'node:http'
import { chmodSync, mkdirSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import { afterEach, describe, expect, it, beforeEach, vi } from 'vitest'
import { loadOrCreateHookCredential } from './hookAuth.js'
import { legacyDaemonStatus, localDaemonCall, localDaemonStatus, saveDaemonPort, savedDaemonPort } from './daemonEndpoint.js'
import { readDaemonRecord } from './daemonRecord.js'
import { listenLocalSocket, localSocketPath } from './localSocket.js'
import type { PipeTarget } from './windows/pipeClient.js'
// A folder too long for a socket now has one under the home folder: only a home too long as well is left on the port.
beforeEach(() => { vi.stubEnv('HOME', `/${'h'.repeat(120)}`) })
afterEach(() => { vi.unstubAllEnvs() })
const cleanup: Array<() => void | Promise<void>> = []
afterEach(async () => { for (const close of cleanup.splice(0).reverse()) await close() })
function directory(): string {
const path = mkdtempSync('/tmp/hn-owner-')
cleanup.push(() => rmSync(path, { recursive: true, force: true }))
return path
}
describe('per-user daemon discovery', () => {
it('never accepts another user\'s TCP status, including when this user has no socket', async () => {
let foreignRequests = 0
const foreign = createServer((_req, res) => { foreignRequests++; res.end(JSON.stringify({ machineId: 'other-account' })) })
await new Promise<void>((resolve) => foreign.listen(0, '127.0.0.1', resolve))
cleanup.push(() => new Promise<void>((resolve) => foreign.close(() => resolve())))
const port = (foreign.address() as { port: number }).port
const userA = directory(), userB = directory()
const a = await listenLocalSocket((_req, res) => res.end(JSON.stringify({ machineId: 'account-a' })), localSocketPath(userA, port)!)
cleanup.push(a.close)
expect(await localDaemonStatus(userB, port)).toBeNull()
const b = await listenLocalSocket((_req, res) => res.end(JSON.stringify({ machineId: 'account-b', signedIn: false })), localSocketPath(userB, port)!)
cleanup.push(b.close)
expect(await localDaemonStatus(userA, port)).toEqual({ machineId: 'account-a' })
expect(await localDaemonStatus(userB, port)).toEqual({ machineId: 'account-b', signedIn: false })
expect(foreignRequests).toBe(0)
})
it('refuses a socket accessible to other OS users', async () => {
const dir = directory(), port = 19418
let requests = 0
const socket = await listenLocalSocket((_req, res) => { requests++; res.end('{}') }, localSocketPath(dir, port)!)
cleanup.push(socket.close)
chmodSync(socket.path, 0o666)
expect(await localDaemonStatus(dir, port)).toBeNull()
expect(requests).toBe(0)
})
it('treats invalid status responses as unavailable', async () => {
const dir = directory(), port = 19418
let body = 'not json', status = 200
const socket = await listenLocalSocket((_req, res) => { res.statusCode = status; res.end(body) }, localSocketPath(dir, port)!)
cleanup.push(socket.close)
expect(await localDaemonStatus(dir, port)).toBeNull()
body = '[]'
expect(await localDaemonStatus(dir, port)).toBeNull()
body = '{}'; status = 503
expect(await localDaemonStatus(dir, port)).toBeNull()
})
it('persists separate TCP port records per user and configured endpoint', () => {
const a = directory(), b = directory()
expect(savedDaemonPort(a, 18473)).toBe(18473)
saveDaemonPort(a, 18473, 24567)
expect(savedDaemonPort(a, 18473)).toBe(24567)
expect(savedDaemonPort(b, 18473)).toBe(18473)
expect(savedDaemonPort(a, 18474)).toBe(18474)
const file = join(a, 'daemon-18473.json')
expect(statSync(file).mode & 0o777).toBe(0o600)
expect(JSON.parse(readFileSync(file, 'utf8'))).toEqual({ port: 24567 })
for (const body of ['broken', '{}', '{"port":-1}', '{"port":65536}', '{"port":"24567"}']) {
writeFileSync(file, body)
expect(savedDaemonPort(a, 18473)).toBe(18473)
}
})
it('records the Windows pipe and the core\'s pid beside the port, and reads only a pipe name back', () => {
// os.tmpdir(), not directory()'s /tmp: this case runs on Windows too.
const dir = mkdtempSync(join(tmpdir(), 'hn-record-'))
cleanup.push(() => rmSync(dir, { recursive: true, force: true }))
const pipe = `\\\\.\\pipe\\harness-${'a'.repeat(32)}`
saveDaemonPort(dir, 18473, 24567, { pipe, pid: 4242 })
expect(JSON.parse(readFileSync(join(dir, 'daemon-18473.json'), 'utf8'))).toEqual({ port: 24567, pipe, pid: 4242 })
expect(readDaemonRecord(dir, 18473)).toEqual({ port: 24567, pipe, pid: 4242 })
expect(savedDaemonPort(dir, 18473)).toBe(24567)
writeFileSync(join(dir, 'daemon-18473.json'), JSON.stringify({ port: 24567, pipe: 'C:\\evil', pid: -1 }))
expect(readDaemonRecord(dir, 18473)).toEqual({ port: 24567, pipe: null, pid: null })
saveDaemonPort(dir, 18473, 24568)
expect(readDaemonRecord(dir, 18473)).toEqual({ port: 24568, pipe: null, pid: null })
expect(readDaemonRecord(dir, 18474)).toBeNull()
})
it('on Windows, reads back only a local Harness pipe, never a file or another computer\'s pipe', () => {
const dir = mkdtempSync(join(tmpdir(), 'hn-record-'))
cleanup.push(() => rmSync(dir, { recursive: true, force: true }))
const id = 'b'.repeat(32)
const pipe = `\\\\.\\pipe\\harness-${id}`
saveDaemonPort(dir, 18473, 24567, { pipe, pid: 4242 })
expect(readDaemonRecord(dir, 18473, 'win32')).toEqual({ port: 24567, pipe, pid: 4242 })
for (const other of [`C:\\x\\harness-${id}`, `\\\\host\\pipe\\harness-${id}`, `\\\\.\\pipe\\evilharness-${id}`]) {
writeFileSync(join(dir, 'daemon-18473.json'), JSON.stringify({ port: 24567, pipe: other, pid: 4242 }))
expect(readDaemonRecord(dir, 18473, 'win32')).toEqual({ port: 24567, pipe: null, pid: 4242 })
}
})
it('accepts legacy CLI status only when both the saved PID and computer identity match', async () => {
const status = { pid: 43210, computerId: 'this-user', machineId: 'signed-out-local' }
let requests = 0
const server = createServer((_req, res) => { requests++; res.end(JSON.stringify(status)) })
await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve))
cleanup.push(() => new Promise<void>((resolve) => { server.closeAllConnections(); server.close(() => resolve()) }))
const port = (server.address() as { port: number }).port
expect(await legacyDaemonStatus(port, null, 'this-user')).toBeNull()
expect(requests).toBe(0)
expect(await legacyDaemonStatus(port, 43211, 'this-user')).toBeNull()
expect(await legacyDaemonStatus(port, 43210, 'other-user')).toBeNull()
expect(await legacyDaemonStatus(port, 43210, 'this-user')).toEqual(status)
})
it('shows legacy status this OS user\'s local credential when it is given the data dir', async () => {
const status = { pid: 43210, computerId: 'this-user' }
const seen: Array<string | undefined> = []
const server = createServer((req, res) => { seen.push(req.headers['x-harness-local'] as string | undefined); res.end(JSON.stringify(status)) })
await new Promise<void>((resolve) => server.listen(0, '127.0.0.1', resolve))
cleanup.push(() => new Promise<void>((resolve) => { server.closeAllConnections(); server.close(() => resolve()) }))
const port = (server.address() as { port: number }).port
// Too long to hold a socket: the one case where the credential goes to the port.
const dataDir = join(directory(), 'd'.repeat(100))
mkdirSync(dataDir, { mode: 0o700 })
const credential = loadOrCreateHookCredential(dataDir)
expect(await legacyDaemonStatus(port, 43210, 'this-user', dataDir)).toEqual(status)
expect(await legacyDaemonStatus(port, 43210, 'this-user')).toEqual(status)
expect(seen).toEqual([credential, undefined])
})
// Audit W1 (docs/security/2026-11-02-team-account-windows.md): it fell back to the port with this user's credential, and
// the Team account's daemon, started at boot, can hold that port.
it.each([
['no pipe', async (): Promise<PipeTarget | null> => null],
['nothing listening on the pipe', async (): Promise<PipeTarget | null> => ({ pipe: join(directory(), `harness-${'0'.repeat(32)}`), token: Buffer.alloc(32, 1) })],
] as const)('never tries the port on Windows: with %s it fails as a daemon that is down', async (_name, pipe) => {
const dataDir = directory()
loadOrCreateHookCredential(dataDir)
let called = false
const failed = await localDaemonCall(dataDir, 19418, 'POST', '/api/pair', { code: 'one-use' }, {
platform: 'win32', pipe, tcpPort: 24567,
fetch: async () => { called = true; return new Response('{}', { status: 200 }) },
}).catch((error: unknown) => error)
expect(failed).toBeInstanceOf(TypeError)
expect((failed as TypeError).message).toBe('fetch failed')
expect(called).toBe(false)
})
})