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 type { AiVaultSessionTitle } from './ai-vault-session-title'
import type { AgentType } from './agent-status-types'
import type { ExecutionHostId } from './execution-host'
export type TabGroupSplitDirection = 'horizontal' | 'vertical'
export type TabGroupLayoutNode =
| { type: 'leaf'; groupId: string }
| {
type: 'split'
direction: TabGroupSplitDirection
first: TabGroupLayoutNode
second: TabGroupLayoutNode
/** Flex ratio of the first child (0–1). Defaults to 0.5 if absent. */
ratio?: number
}
export type TabContentType =
| 'terminal'
| 'editor'
| 'diff'
| 'conflict-review'
| 'check-details'
| 'agent-session'
| 'browser'
| 'simulator'
export type WorkspaceVisibleTabType =
| 'terminal'
| 'editor'
| 'agent-session'
| 'browser'
| 'simulator'
export type CtrlTabOrderMode = 'mru' | 'sequential'
// Many content kinds collapse to editor; resolve a concrete tab and project forward instead of trying to invert equality.
export function toVisibleTabType(contentType: TabContentType): WorkspaceVisibleTabType {
if (
contentType === 'agent-session' ||
contentType === 'browser' ||
contentType === 'terminal' ||
contentType === 'simulator'
) {
return contentType
}
return 'editor'
}
export type Tab = {
id: string // UUID for terminals, filePath for editors (preserves current convention)
entityId: string // ID of the backing content (terminal tab ID, file path, browser workspace ID)
groupId: string
worktreeId: string
/** Owning execution host when the same worktree id is visible from multiple hosts. */
executionHostId?: ExecutionHostId
contentType: TabContentType
label: string // display title (auto-derived from PTY or filename)
generatedLabel?: string | null
/** Stable AI Vault conversation name, bound to its provider session identity. */
aiVaultTitle?: AiVaultSessionTitle | null
quickCommandLabel?: string | null
customLabel: string | null
color: string | null
sortOrder: number
createdAt: number
isPreview?: boolean // preview tabs get replaced by next single-click open
isPinned?: boolean // pinned tabs survive "close others"
/** Provider backing a structured agent-session tab. */
agentSessionAgent?: AgentType
/** Chat overlays retain the mounted terminal; missing/legacy mode uses raw xterm. */
viewMode?: 'terminal' | 'chat'
/** Timestamp when the tab was last focused / activated by the user. */
lastFocusedAt?: number
}
export type TabGroup = {
id: string
worktreeId: string
activeTabId: string | null
tabOrder: string[] // canonical visual order of tab IDs
/** Per-group MRU, newest last, restores the previous tab on close instead of a visual neighbor.
* Legacy sessions omit it; hydration seeds from activeTabId so split groups keep independent histories. */
recentTabIds?: string[]
}