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 {
classifySortStampEvent,
isUnreadNews,
enterAgentPaneState,
RECENT_STAMP_THROTTLE_MS,
workspaceSmartStamp,
type AgentPaneState,
type SortStamps
} from './sort-stamps'
import { agentPhaseTransition, type AgentPhase } from '../agent-transitions'
const NOW = 1_000_000
const IDLE: SortStamps = { recentAt: NOW - 60_000 }
function agentEvent(
from: AgentPhase,
to: AgentPhase,
panes: AgentPaneState[],
transition = agentPhaseTransition(from, to)
) {
return { kind: 'agent' as const, from, to, transition, panes }
}
describe('enterAgentPaneState', () => {
it('keeps the same object when the phase holds, so running stays running', () => {
const working = { phase: 'working' as const, at: NOW - 5 }
expect(enterAgentPaneState(working, 'working', NOW)).toBe(working)
})
it('keeps the time an approval was asked when the turn resumes', () => {
expect(enterAgentPaneState({ phase: 'needs-you', at: 7 }, 'working', NOW)).toEqual({
phase: 'working',
at: 7
})
})
})
describe('workspaceSmartStamp', () => {
it('takes the most demanding pane and that tier’s latest entry', () => {
expect(workspaceSmartStamp([])).toEqual({})
expect(
workspaceSmartStamp([
{ phase: 'working', at: 9 },
{ phase: 'done', at: 3 },
{ phase: 'done', at: 5 }
])
).toEqual({ smartTier: 'done', smartAt: 5 })
expect(
workspaceSmartStamp([
{ phase: 'done', at: 9 },
{ phase: 'needs-you', at: 2 }
])
).toEqual({ smartTier: 'needs-you', smartAt: 2 })
})
})
describe('classifySortStampEvent', () => {
it('moves a resumed approval to Working without a Recent stamp, keeping its time', () => {
const current: SortStamps = { recentAt: NOW - 60_000, smartTier: 'needs-you', smartAt: 7 }
expect(
classifySortStampEvent(
current,
agentEvent('needs-you', 'working', [{ phase: 'working', at: 7 }]),
NOW
)
).toEqual({ recentAt: NOW - 60_000, smartTier: 'working', smartAt: 7 })
})
it('drops to Rest without a Recent stamp when the agent leaves', () => {
const current: SortStamps = { recentAt: NOW - 60_000, smartTier: 'done', smartAt: 1 }
expect(classifySortStampEvent(current, agentEvent('done', 'rest', []), NOW)).toEqual({
recentAt: NOW - 60_000
})
})
it('keeps the tier another pane holds', () => {
const current: SortStamps = { recentAt: NOW - 60_000, smartTier: 'needs-you', smartAt: 3 }
const panes = [
{ phase: 'needs-you' as const, at: 3 },
{ phase: 'done' as const, at: NOW }
]
expect(classifySortStampEvent(current, agentEvent('working', 'done', panes), NOW)).toEqual({
recentAt: NOW,
smartTier: 'needs-you',
smartAt: 3
})
})
it('skips a Recent stamp within the throttle, but applies the tier at once', () => {
const current: SortStamps = { recentAt: NOW - RECENT_STAMP_THROTTLE_MS + 1 }
const working = { phase: 'working' as const, at: NOW }
expect(classifySortStampEvent(current, agentEvent('rest', 'working', [working]), NOW)).toEqual({
recentAt: current.recentAt,
smartTier: 'working',
smartAt: NOW
})
expect(classifySortStampEvent(current, { kind: 'bell' }, NOW)).toBeNull()
expect(
classifySortStampEvent(
{ recentAt: NOW - RECENT_STAMP_THROTTLE_MS },
{ kind: 'terminal-started' },
NOW
)
).toEqual({ recentAt: NOW })
})
it('keeps the tier on a bell or terminal start', () => {
const current: SortStamps = { recentAt: 0, smartTier: 'done', smartAt: 4 }
expect(classifySortStampEvent(current, { kind: 'bell' }, NOW)).toEqual({
recentAt: NOW,
smartTier: 'done',
smartAt: 4
})
})
it('returns null when nothing changes', () => {
const current: SortStamps = { recentAt: NOW, smartTier: 'working', smartAt: NOW }
expect(
classifySortStampEvent(
current,
agentEvent('rest', 'working', [{ phase: 'working', at: NOW }]),
NOW
)
).toBeNull()
})
})
describe('the stamps follow the agent transitions', () => {
it('flags a failed turn as news, and a session boundary’s done as none while it still stamps', () => {
expect(isUnreadNews(agentEvent('working', 'done', [], 'errored'))).toBe(true)
const boundary = agentEvent('working', 'done', [{ phase: 'done', at: NOW }], null)
expect(isUnreadNews(boundary)).toBe(false)
expect(classifySortStampEvent(IDLE, boundary, NOW)).toEqual({
recentAt: NOW,
smartTier: 'done',
smartAt: NOW
})
})
})
describe('workspaceSmartStamp once the workspace is read', () => {
it('lets a read Done yield to a Working pane, and keeps a lone read Done', () => {
const done = { phase: 'done' as const, at: 100 }
const working = { phase: 'working' as const, at: 200 }
expect(workspaceSmartStamp([done, working], true)).toEqual({ smartTier: 'done', smartAt: 100 })
expect(workspaceSmartStamp([done, working], false)).toEqual({
smartTier: 'working',
smartAt: 200
})
expect(workspaceSmartStamp([done], false)).toEqual({ smartTier: 'done', smartAt: 100 })
expect(workspaceSmartStamp([done, working, { phase: 'needs-you', at: 50 }], false)).toEqual({
smartTier: 'needs-you',
smartAt: 50
})
})
})