Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
const { runProcessMock } = vi.hoisted(() => ({ runProcessMock: vi.fn() }))
// Mock Orca’s process-host seam to retain windowsHide, argv encoding and tree-termination policy.
vi.mock('@orca/process-host', () => ({ runProcess: runProcessMock }))
import {
getCheapProcessTableSnapshot,
resetCheapProcessTableSnapshotForTests
} from './cheap-process-table-snapshot-reader'
import { PS_TIMEOUT_MS } from './process-table-snapshot-reader'
import {
CHEAP_PS_ARGS,
PS_ARGS,
PS_MAX_BUFFER_BYTES,
parseCheapProcessTableRows,
ProcessTableCaptureError
} from './process-table-snapshot'
function installPs(stdout: string, outputTruncated = false): string[][] {
const calls: string[][] = []
runProcessMock.mockImplementation(async (spec: { program: string; args: readonly string[] }) => {
calls.push([spec.program, ...spec.args])
return { code: 0, signal: null, stdout, stderr: '', timedOut: false, outputTruncated }
})
return calls
}
describe('parseCheapProcessTableRows', () => {
it('parses the macOS column set with a padded lstart marker', () => {
const rows = parseCheapProcessTableRows(
[
' 1 0 1 0 Ss Tue Sep 1 01:49:39 2026',
' 4242 4200 4242 4243 S Thu Sep 3 16:02:01 2026',
' 4243 4242 4243 4243 S+ Thu Sep 3 16:02:05 2026',
''
].join('\n')
)
expect(rows).toEqual([
{ pid: 1, ppid: 0, pgid: 1, tpgid: 0, stat: 'Ss', startTime: 'Tue Sep 1 01:49:39 2026' },
{
pid: 4242,
ppid: 4200,
pgid: 4242,
tpgid: 4243,
stat: 'S',
startTime: 'Thu Sep 3 16:02:01 2026'
},
{
pid: 4243,
ppid: 4242,
pgid: 4243,
tpgid: 4243,
stat: 'S+',
startTime: 'Thu Sep 3 16:02:05 2026'
}
])
})
it('parses the Linux column set, which carries no start marker', () => {
const rows = parseCheapProcessTableRows(
' 2 0 0 -1 S\r\n 900 1 900 900 Ss+\r\n'
)
expect(rows).toEqual([
{ pid: 2, ppid: 0, pgid: 0, tpgid: -1, stat: 'S' },
{ pid: 900, ppid: 1, pgid: 900, tpgid: 900, stat: 'Ss+' }
])
})
it('skips malformed rows rather than failing the capture', () => {
expect(parseCheapProcessTableRows('garbage\n 7 1 7 7 S\n')).toEqual([
{ pid: 7, ppid: 1, pgid: 7, tpgid: 7, stat: 'S' }
])
})
it('treats an empty capture as unreadable, never as "no processes"', () => {
expect(() => parseCheapProcessTableRows('\n\n')).toThrow(ProcessTableCaptureError)
})
})
describe('getCheapProcessTableSnapshot', () => {
beforeEach(() => {
runProcessMock.mockReset()
resetCheapProcessTableSnapshotForTests()
vi.useFakeTimers({ toFake: ['Date'] })
vi.setSystemTime(0)
})
afterEach(() => {
vi.useRealTimers()
})
it('forks ps with the cheap column set only, never tty or command', async () => {
const calls = installPs(' 7 1 7 7 S\n')
await getCheapProcessTableSnapshot()
expect(calls).toEqual([['ps', ...CHEAP_PS_ARGS]])
expect(CHEAP_PS_ARGS.join(' ')).not.toMatch(/tty=|command=|etimes=/)
expect(CHEAP_PS_ARGS).not.toEqual(PS_ARGS)
})
it('coalesces concurrent readers onto one fork and honours the TTL', async () => {
const calls = installPs(' 7 1 7 7 S\n')
await Promise.all([getCheapProcessTableSnapshot(), getCheapProcessTableSnapshot()])
await getCheapProcessTableSnapshot()
expect(calls).toHaveLength(1)
vi.setSystemTime(600)
await getCheapProcessTableSnapshot()
expect(calls).toHaveLength(2)
})
it('passes the full-tier buffer ceiling and timeout to the runner', async () => {
installPs(' 7 1 7 7 S\n')
await getCheapProcessTableSnapshot()
expect(runProcessMock).toHaveBeenCalledWith(
expect.objectContaining({ maxOutputBytes: PS_MAX_BUFFER_BYTES, timeoutMs: PS_TIMEOUT_MS })
)
})
it('names a clipped capture as truncated, a killed one as a timeout, and a non-zero exit by its code', async () => {
installPs(' 7 1 7 7 S\n', true)
await expect(getCheapProcessTableSnapshot()).rejects.toMatchObject({
reason: 'capture_truncated'
})
resetCheapProcessTableSnapshotForTests()
runProcessMock.mockResolvedValueOnce({
code: null,
signal: 'SIGKILL',
stdout: '',
stderr: '',
timedOut: true
})
await expect(getCheapProcessTableSnapshot()).rejects.toMatchObject({
reason: 'capture_timeout'
})
resetCheapProcessTableSnapshotForTests()
runProcessMock.mockResolvedValueOnce({
code: 1,
signal: null,
stdout: '',
stderr: 'ps: bad column',
timedOut: false
})
await expect(getCheapProcessTableSnapshot()).rejects.toMatchObject({ reason: 'ps_exit_1' })
})
})