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 { parseExecutionHostId } from '../../../src/shared/execution-host'
import type { HostStackRouteTarget } from '../navigation/host-stack-navigation'
import { mobileSessionRouteTarget } from '../session/mobile-session-route'
import type { HostCredentialStatus } from '../transport/types'
export type NotificationNavigationOptions = {
knownHostIds?: ReadonlySet<string>
credentialStatusByHostId?: ReadonlyMap<string, HostCredentialStatus>
}
function readNonEmptyString(value: unknown): string | null {
return typeof value === 'string' && value.trim().length > 0 ? value : null
}
// Host-only taps need no stack coordination; sessionTarget identifies deep workspace destinations.
export type NotificationNavigationTarget = Readonly<{
hostId: string
sessionTarget: HostStackRouteTarget | null
credentialRecovery?: 'retry' | 're-pair'
}>
export function notificationCredentialRecoveryRoute(
target: NotificationNavigationTarget
): '/' | '/pair-scan' | null {
if (target.credentialRecovery === 're-pair') {
return '/pair-scan'
}
return target.credentialRecovery === 'retry' ? '/' : null
}
export function getNotificationNavigationTarget(
data: unknown,
options: NotificationNavigationOptions = {}
): NotificationNavigationTarget | null {
if (!data || typeof data !== 'object') {
return null
}
const record = data as Record<string, unknown>
const hostId = readNonEmptyString(record.hostId)
if (!hostId) {
return null
}
if (options.knownHostIds && !options.knownHostIds.has(hostId)) {
return null
}
const worktreeId = readNonEmptyString(record.worktreeId)
// Accept only relayed servers; unknown execution hosts retain the paired desktop route.
const executionHost = parseExecutionHostId(readNonEmptyString(record.executionHost))
const credentialStatus = options.credentialStatusByHostId?.get(hostId)
return {
hostId,
sessionTarget: worktreeId
? mobileSessionRouteTarget({
hostId,
worktreeId,
paneKey: readNonEmptyString(record.paneKey) ?? undefined,
...(executionHost?.kind === 'runtime' ? { executionHost: executionHost.id } : {})
})
: null,
...(credentialStatus === 'missing'
? { credentialRecovery: 're-pair' as const }
: credentialStatus === 'temporarily-unavailable'
? { credentialRecovery: 'retry' as const }
: {})
}
}