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 { describe, expect, it } from 'vitest'
import {
agentChildWorkLiveness,
agentChildWorkLivenessFromEvidence,
type AgentChildWorkLivenessCandidate
} from './agent-status-child-work-liveness'
function child(
over: Partial<AgentChildWorkLivenessCandidate> = {}
): AgentChildWorkLivenessCandidate {
return { kind: 'agent', state: 'working', ...over }
}
describe('agentChildWorkLivenessFromEvidence', () => {
it('ranks a waiting child above live agent work, and that above live watch loops', () => {
expect(
agentChildWorkLivenessFromEvidence({
hasWaitingChildWork: true,
hasLiveAgentWork: true,
hasLiveNonAgentWork: true
})
).toBe('waiting')
expect(
agentChildWorkLivenessFromEvidence({
hasWaitingChildWork: false,
hasLiveAgentWork: true,
hasLiveNonAgentWork: true
})
).toBe('working')
expect(
agentChildWorkLivenessFromEvidence({
hasWaitingChildWork: false,
hasLiveAgentWork: false,
hasLiveNonAgentWork: true
})
).toBe('monitoring')
expect(
agentChildWorkLivenessFromEvidence({
hasWaitingChildWork: false,
hasLiveAgentWork: false,
hasLiveNonAgentWork: false
})
).toBeNull()
})
})
describe('agentChildWorkLiveness', () => {
it('reads working, monitoring and stateless agents as live agent work', () => {
for (const state of ['working', 'monitoring', undefined] as const) {
expect(agentChildWorkLiveness([child({ state })])).toBe('working')
}
})
// Workflows run agents but are not agents themselves; counting them claims children the expanded projection cannot show.
it('reads a live workflow as a watch loop, not as agent work', () => {
expect(agentChildWorkLiveness([child({ kind: 'workflow' })])).toBe('monitoring')
expect(agentChildWorkLiveness([child({ kind: 'workflow', state: undefined })])).toBe(
'monitoring'
)
})
// A child's `blocked` is a failure, not a request for a human; neither it nor lost contact waits.
it('keeps a failed or unverifiable agent live without asking for a human', () => {
for (const state of ['blocked', 'unverifiable'] as const) {
expect(agentChildWorkLiveness([child({ state })])).toBe('working')
expect(agentChildWorkLiveness([child({ kind: 'command', state })])).toBe('monitoring')
}
})
it('reads a child of any kind waiting on a human as waiting, above every other live child', () => {
expect(agentChildWorkLiveness([child({ state: 'waiting' })])).toBe('waiting')
expect(agentChildWorkLiveness([child({ kind: 'command', state: 'waiting' })])).toBe('waiting')
expect(
agentChildWorkLiveness([child(), child({ kind: 'command' }), child({ state: 'waiting' })])
).toBe('waiting')
})
it('retires an agent only on an explicitly settled state', () => {
for (const state of ['done', 'idle'] as const) {
expect(agentChildWorkLiveness([child({ state })])).toBeNull()
}
})
it('reads any shell, monitor or unknown task that is not explicitly settled as a watch loop', () => {
for (const kind of ['command', 'monitor', 'unknown'] as const) {
for (const state of ['working', 'monitoring', 'unverifiable', undefined] as const) {
expect(agentChildWorkLiveness([child({ kind, state })])).toBe('monitoring')
}
for (const state of ['done', 'idle'] as const) {
expect(agentChildWorkLiveness([child({ kind, state })])).toBeNull()
}
}
})
it('lets one live agent outrank any number of watch loops', () => {
expect(
agentChildWorkLiveness([child({ kind: 'command' }), child({ kind: 'monitor' }), child()])
).toBe('working')
})
it('treats an absent or empty list as no child work', () => {
expect(agentChildWorkLiveness(undefined)).toBeNull()
expect(agentChildWorkLiveness([])).toBeNull()
})
})