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 { createTerminalTitleTracker } from '../../../src/shared/terminal-output-side-effects'
import type { AgentStatusEntry } from '../../../src/shared/agent-status-types'
import type { TuiAgent } from '../../../src/shared/tui-agent'
import type { MobileSessionTab } from './mobile-session-route-types'
import {
getMobileSessionTabTitle,
getMobileTerminalTabHostAgentIdentity,
resolveMobileTerminalTabAgentId,
resolveMobileTerminalTabOwnedAgentId
} from './mobile-terminal-tab-agent'
function agentStatus(
agentType: string | undefined,
state: AgentStatusEntry['state'] = 'working'
): AgentStatusEntry {
return {
state,
prompt: '',
updatedAt: 1,
stateStartedAt: 1,
paneKey: 'tab-1:leaf-1',
...(agentType ? { agentType } : {}),
stateHistory: []
}
}
function terminalTab(
title: string,
options: {
agentType?: string
state?: AgentStatusEntry['state']
id?: string
launchAgent?: TuiAgent
} = {}
): Extract<MobileSessionTab, { type: 'terminal' }> {
return {
type: 'terminal',
id: options.id ?? 'tab-1',
title,
terminal: 'pty-1',
isActive: true,
...(options.launchAgent ? { launchAgent: options.launchAgent } : {}),
...(options.agentType === undefined
? {}
: { agentStatus: agentStatus(options.agentType, options.state) })
}
}
describe('resolveMobileTerminalTabAgentId', () => {
it.each([
['. | Droid', 'claude'],
['tmux | Droid', 'droid'],
['OC | . | Droid', 'claude'],
['⠋ fix the gemini launcher', 'claude'],
['⠋ add ✦ icon to header', 'claude'],
['⠋ Codex: fix Gemini terminal behavior', 'codex'],
['Fix Codex terminal behavior… - grok', 'grok'],
[`${'x | '.repeat(200)}OC | a | b | c | d | e | f | g | h | Codex`, 'opencode'],
['tmux | 🐋 a | b | c | d | e | f | g | h | Codex', 'dsh'],
['✦ session | Thinking - grok', 'claude'],
['✦ session | Thinking', 'qoder'],
['⠋ - Codex: fix parser - grok', 'grok'],
['✦ Analyze Codex', 'gemini']
])('uses the production OSC normalization for %s', (raw, agent) => {
let title = ''
let observedRaw = ''
const tracker = createTerminalTitleTracker({
onTitle: (emitted, rawTitle) => {
observedRaw = rawTitle
title = emitted
}
})
try {
tracker.handleChunk(`\x1b]0;${raw}\x07`)
expect(raw.length).toBeLessThanOrEqual(1024)
expect(observedRaw).toBe(raw)
expect(
resolveMobileTerminalTabAgentId(
terminalTab(title, { agentType: 'claude', state: 'done', launchAgent: 'claude' })
)
).toBe(agent)
if (raw.includes('OC | ')) {
expect(resolveMobileTerminalTabAgentId(terminalTab(title))).toBe('opencode')
expect(resolveMobileTerminalTabAgentId(terminalTab(title, { launchAgent: 'claude' }))).toBe(
raw.startsWith('x | ') ? 'claude' : 'opencode'
)
}
} finally {
tracker.dispose()
}
})
it('keeps completed Claude ownership when task text names another agent', () => {
expect(
resolveMobileTerminalTabAgentId(
terminalTab('⠋ fix the grok launcher', {
agentType: 'claude',
state: 'done',
launchAgent: 'claude'
})
)
).toBe('claude')
})
it('uses hook-reported agent identity before title fallback', () => {
expect(resolveMobileTerminalTabAgentId(terminalTab('Terminal', { agentType: 'codex' }))).toBe(
'codex'
)
})
it('uses host launch identity before title fallback', () => {
expect(
resolveMobileTerminalTabAgentId(terminalTab('Terminal', { launchAgent: 'claude' }))
).toBe('claude')
})
it('falls back to explicit terminal titles when hook identity is unavailable', () => {
expect(resolveMobileTerminalTabAgentId(terminalTab('✦ Gemini CLI'))).toBe('gemini')
})
it('lets a different agent reclaim a pane whose launched agent finished', () => {
const tab = terminalTab('Codex ready', {
agentType: 'claude',
state: 'done',
launchAgent: 'claude'
})
expect(resolveMobileTerminalTabAgentId(tab)).toBe('codex')
})
it('keeps an OMP-launched tab as OMP when its hook reports pi', () => {
expect(
resolveMobileTerminalTabAgentId(
terminalTab('Terminal', { agentType: 'pi', launchAgent: 'omp' })
)
).toBe('omp')
})
it('treats unknown hook identity as unavailable', () => {
expect(
resolveMobileTerminalTabAgentId(terminalTab('✳ investigating', { agentType: 'unknown' }))
).toBeNull()
expect(
resolveMobileTerminalTabAgentId(terminalTab('Codex ready', { agentType: 'unknown' }))
).toBe('codex')
})
})
describe('host pane identity', () => {
it('prefers the host cursor identity over a claude report from a Claude hook Cursor imported', () => {
const tab = terminalTab('Fix the build - ⏳ Working ···', { agentType: 'claude' })
expect(resolveMobileTerminalTabAgentId(tab)).toBe('claude')
expect(resolveMobileTerminalTabAgentId(tab, 'cursor')).toBe('cursor')
expect(resolveMobileTerminalTabOwnedAgentId(tab, 'cursor')).toBe('cursor')
})
it('ranks host Cursor identity above titles only for panes no hook or launch owns', () => {
const launched = terminalTab('Terminal', { agentType: 'unknown', launchAgent: 'claude' })
expect(resolveMobileTerminalTabOwnedAgentId(launched, 'cursor')).toBe('claude')
expect(resolveMobileTerminalTabAgentId(launched, 'cursor')).toBe('claude')
expect(
resolveMobileTerminalTabAgentId(terminalTab('Fix Codex support - ⏳ Working ···'), 'cursor')
).toBe('cursor')
})
it('keeps a reused pane on its finished hook when terminal.list still caches Cursor', () => {
expect(
resolveMobileTerminalTabAgentId(
terminalTab('Terminal', { agentType: 'codex', state: 'done' }),
'cursor'
)
).toBe('codex')
})
it("does not replace another agent's hook report", () => {
for (const agentType of ['codex', 'grok', 'gemini']) {
expect(
resolveMobileTerminalTabAgentId(terminalTab('Terminal', { agentType }), 'cursor')
).toBe(agentType)
}
})
it('keeps a real Claude tab as Claude when the host says claude or has no identity', () => {
const tab = terminalTab('✳ working', { agentType: 'claude' })
expect(resolveMobileTerminalTabAgentId(tab, 'claude')).toBe('claude')
expect(resolveMobileTerminalTabAgentId(tab, undefined)).toBe('claude')
expect(resolveMobileTerminalTabAgentId(tab, null)).toBe('claude')
})
it('keeps host Cursor identity out of behavioral ownership', () => {
expect(
resolveMobileTerminalTabOwnedAgentId(terminalTab('Saved task name'), 'cursor')
).toBeNull()
})
it('cleans the title with the same host identity the icon uses', () => {
expect(getMobileSessionTabTitle(terminalTab('✳ investigating'))).toBe('✳ investigating')
expect(getMobileSessionTabTitle(terminalTab('✳ investigating'), 'cursor')).toBe('investigating')
})
it("reads the host identity from the terminal.list record of the tab's handle", () => {
const terminals = [
{ handle: 'pty-0', agentIdentity: 'codex' },
{ handle: 'pty-1', agentIdentity: 'cursor' }
]
expect(getMobileTerminalTabHostAgentIdentity(terminalTab('Terminal'), terminals)).toBe('cursor')
expect(
getMobileTerminalTabHostAgentIdentity(
{ ...terminalTab('Terminal'), terminal: null },
terminals
)
).toBeUndefined()
expect(
getMobileTerminalTabHostAgentIdentity(terminalTab('Terminal'), [{ handle: 'pty-1' }])
).toBeUndefined()
})
})
describe('resolveMobileTerminalTabOwnedAgentId', () => {
it('excludes display-only terminal titles from behavioral authority', () => {
expect(resolveMobileTerminalTabOwnedAgentId(terminalTab('✦ Gemini CLI'))).toBeNull()
expect(
resolveMobileTerminalTabOwnedAgentId(terminalTab('Terminal', { launchAgent: 'gemini' }))
).toBe('gemini')
})
})
describe('getMobileSessionTabTitle', () => {
it('strips leading agent decorations when an icon is shown', () => {
expect(getMobileSessionTabTitle(terminalTab('✦ Gemini CLI'))).toBe('Gemini CLI')
})
it('falls back for glyph-only agent titles on mobile', () => {
expect(getMobileSessionTabTitle(terminalTab('✳', { agentType: 'claude' }))).toBe('Terminal')
})
it('strips decorations for launch-owned terminal tabs before hooks arrive', () => {
expect(getMobileSessionTabTitle(terminalTab('✳ working', { launchAgent: 'claude' }))).toBe(
'working'
)
})
it('preserves browser title fallbacks after moving the helper out of the route', () => {
const blankBrowserTab: Extract<MobileSessionTab, { type: 'browser' }> = {
type: 'browser',
id: 'browser-1',
title: '',
url: 'about:blank',
browserWorkspaceId: 'browser-workspace-1',
browserPageId: null,
loading: false,
canGoBack: false,
canGoForward: false,
isActive: true
}
expect(getMobileSessionTabTitle(blankBrowserTab)).toBe('New Browser')
})
it('labels structured agent-session tabs without terminal decoration rules', () => {
expect(
getMobileSessionTabTitle({
type: 'agent-session',
id: 'agent-tab-1',
title: 'Codex Chat',
sessionId: 'session-1',
agent: 'codex',
isActive: true
})
).toBe('Codex Chat')
})
})