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 { PersistedAutomationHostFilter } from '../automation-host-filter'
import type { PersistedMobileClientTabSelections } from '../persisted-state-types'
import type {
ManualRepoOrderEntry,
VisibleWorkspaceHostIds,
WorkspaceHostOrder,
WorkspaceHostScope
} from '../ui-chrome-types'
import type { SavedPortForward } from '../ssh-types'
import {
parseClientHostedBrowserCloseIntents,
parseMobileSelections,
parseSavedPortForwards,
parseUiRouting
} from './orcad-migration-client-state-parsing'
import { isWorkspaceHostId } from './orcad-migration-client-state-value-validation'
import { isRecord } from './orcad-migration-manifest-fields'
import type { ClientHostedBrowserCloseIntent } from '../client-hosted-browser-close-intent'
export type OrcadMigrationUiRoutingState = {
lastActiveRepoId?: string | null
lastActiveWorktreeId?: string | null
filterRepoIds?: string[]
showDotfilesByWorktree?: Record<string, boolean>
setupScriptPromptDismissedRepoIds?: string[]
manualRepoOrder?: ManualRepoOrderEntry[]
workspaceHostScope?: WorkspaceHostScope
visibleWorkspaceHostIds?: VisibleWorkspaceHostIds
workspaceHostOrder?: WorkspaceHostOrder
automationHostFilter?: PersistedAutomationHostFilter
acknowledgedAgentsByPaneKey?: Record<string, number>
}
export type OrcadMigrationClientHostedBrowserCloseIntent = ClientHostedBrowserCloseIntent & {
sourceEnvironmentId: string
}
export type OrcadMigrationClientStatePayload = {
mobileClientTabSelectionsByDeviceId?: PersistedMobileClientTabSelections
uiRouting?: OrcadMigrationUiRoutingState
savedPortForwards?: SavedPortForward[]
clientHostedBrowserCloseIntents?: OrcadMigrationClientHostedBrowserCloseIntent[]
}
export function parseOrcadMigrationClientState(value: unknown): OrcadMigrationClientStatePayload {
if (!isRecord(value)) {
throw new Error('orcad_migration_dormant_client_state_invalid')
}
const mobile =
value.mobileClientTabSelectionsByDeviceId === undefined
? undefined
: parseMobileSelections(value.mobileClientTabSelectionsByDeviceId)
const uiRouting = value.uiRouting === undefined ? undefined : parseUiRouting(value.uiRouting)
const savedPortForwards =
value.savedPortForwards === undefined
? undefined
: parseSavedPortForwards(value.savedPortForwards)
const closeIntents =
value.clientHostedBrowserCloseIntents === undefined
? undefined
: parseClientHostedBrowserCloseIntents(value.clientHostedBrowserCloseIntents)
return {
...(mobile && Object.keys(mobile).length > 0
? { mobileClientTabSelectionsByDeviceId: mobile }
: {}),
...(uiRouting && Object.keys(uiRouting).length > 0 ? { uiRouting } : {}),
...(savedPortForwards && savedPortForwards.length > 0 ? { savedPortForwards } : {}),
...(closeIntents && closeIntents.length > 0
? { clientHostedBrowserCloseIntents: closeIntents }
: {})
}
}
export function assertOrcadMigrationClientStateReferences(args: {
clientState: OrcadMigrationClientStatePayload | undefined
repositoryIds: ReadonlySet<string>
owns: (ownerKey: string) => boolean
}): void {
const clientState = args.clientState
if (!clientState) {
return
}
for (const selections of Object.values(clientState.mobileClientTabSelectionsByDeviceId ?? {})) {
for (const worktreeId of Object.keys(selections)) {
if (!args.owns(worktreeId)) {
throw new Error('orcad_migration_dormant_mobile_selection_scope_invalid')
}
}
}
for (const intent of clientState.clientHostedBrowserCloseIntents ?? []) {
if (!intent.sourceEnvironmentId || !args.owns(intent.worktreeId)) {
throw new Error('orcad_migration_dormant_client_close_intent_scope_invalid')
}
}
const ui = clientState.uiRouting
if (!ui) {
return
}
if (ui.lastActiveRepoId && !args.repositoryIds.has(ui.lastActiveRepoId)) {
throw new Error('orcad_migration_dormant_ui_routing_scope_invalid')
}
if (ui.lastActiveWorktreeId && !args.owns(ui.lastActiveWorktreeId)) {
throw new Error('orcad_migration_dormant_ui_routing_scope_invalid')
}
for (const repoId of ui.filterRepoIds ?? []) {
if (!args.repositoryIds.has(repoId)) {
throw new Error('orcad_migration_dormant_ui_routing_scope_invalid')
}
}
for (const ownerKey of Object.keys(ui.showDotfilesByWorktree ?? {})) {
if (!args.owns(ownerKey)) {
throw new Error('orcad_migration_dormant_ui_routing_scope_invalid')
}
}
for (const repoId of ui.setupScriptPromptDismissedRepoIds ?? []) {
if (!args.repositoryIds.has(repoId)) {
throw new Error('orcad_migration_dormant_ui_routing_scope_invalid')
}
}
for (const entry of ui.manualRepoOrder ?? []) {
if (!args.repositoryIds.has(entry.repoId) || !isWorkspaceHostId(entry.hostId)) {
throw new Error('orcad_migration_dormant_ui_routing_scope_invalid')
}
}
}