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
// Bridge into native storage: Android disables localStorage and iOS origins change per session. Explicit keys prevent pages rewriting pairings/push registrations in the same orca: namespace.
export const PAGE_STORAGE_EXACT_KEYS = [
'orca:last-visited-worktree',
'orca:hostSidebarWidth',
'orca:hostDockWidth',
'orca:terminal-accessory-layout',
'orca:custom-accessory-keys',
'orca:defaultSessionView',
/** Legacy journal access for embedded pages served by older hosts. */
'orca:mobileStructuredSendOperations:v1',
'orca:terminalTextScale',
'orca:terminalAutocompleteEnabled',
'orca:terminalLinkOpenMode'
] as const
export const PAGE_STORAGE_KEY_PREFIXES = [
'orca:pins:',
'orca:nativeChatTabs:',
'orca:terminalLiveInputDisabled:',
'orca:terminalDrafts:'
] as const
export const PAGE_STORAGE_MAX_VALUE_CHARS = 16 * 1024
export const PAGE_STORAGE_MAX_KEY_CHARS = 256
export const PAGE_STORAGE_MAX_ENTRIES = 32
export function isPageStorageKey(key: string): boolean {
if (key.length > PAGE_STORAGE_MAX_KEY_CHARS) {
return false
}
return (
PAGE_STORAGE_EXACT_KEYS.some((allowed) => allowed === key) ||
PAGE_STORAGE_KEY_PREFIXES.some((prefix) => key.startsWith(prefix) && key.length > prefix.length)
)
}
// Derive workspace scope from the pathname both endpoints receive; only session routes currently own workspace keys.
export function pageRouteWorkspace(
pathname: string
): { hostId: string; worktreeId: string } | null {
const segments = pathname.split('/')
if (segments.length !== 5 || segments[0] !== '' || segments[1] !== 'h') {
return null
}
if (segments[3] !== 'session') {
return null
}
try {
const hostId = decodeURIComponent(segments[2] ?? '')
const worktreeId = decodeURIComponent(segments[4] ?? '')
return hostId === '' || worktreeId === '' ? null : { hostId, worktreeId }
} catch {
// Malformed escapes must yield no workspace key, never a key constructed from invalid route text.
return null
}
}
const WORKSPACE_KEY_PREFIXES = [
'orca:nativeChatTabs:',
'orca:terminalLiveInputDisabled:',
'orca:terminalDrafts:'
] as const
function workspaceScopedKey(prefix: string, hostId: string, worktreeId: string): string {
return `${prefix}${encodeURIComponent(hostId)}:${encodeURIComponent(worktreeId)}`
}
// Host-area pages may access any workspace here; encoded host ids contain no colon, preventing cross-host prefix matches.
export function isHostWorkspaceStorageKey(key: string, hostId: string): boolean {
const scope = `${encodeURIComponent(hostId)}:`
return (
isPageStorageKey(key) &&
WORKSPACE_KEY_PREFIXES.some(
(prefix) => key.startsWith(prefix + scope) && key.length > prefix.length + scope.length
)
)
}
// Filter generated keys through the page’s schema bounds: an overlong workspace id must not reject the whole init frame.
export function pageStorageKeysForRoute(hostId: string, routePathname: string): string[] {
const workspace = pageRouteWorkspace(routePathname)
const scoped =
workspace === null || workspace.hostId !== hostId
? []
: WORKSPACE_KEY_PREFIXES.map((prefix) =>
workspaceScopedKey(prefix, hostId, workspace.worktreeId)
)
return [...PAGE_STORAGE_EXACT_KEYS, `orca:pins:${hostId}`, ...scoped].filter(isPageStorageKey)
}
// Narrow key shapes to this host/workspace; host-area pages additionally reach this host’s other workspaces.
export function isPageStorageKeyForRoute(
key: string,
hostId: string,
routePathname: string,
hostArea = false
): boolean {
return (
key.length <= PAGE_STORAGE_MAX_KEY_CHARS &&
(pageStorageKeysForRoute(hostId, routePathname).includes(key) ||
(hostArea && isHostWorkspaceStorageKey(key, hostId)))
)
}
// Refuse writes to oversized values omitted from init, including from old pages that ignore storageOversize; otherwise default data could overwrite the native journal (ruling 33.6).
export function pageMayWriteStorageKey(
key: string,
hostId: string,
route: { pathname: string } | null,
held: PageStorageForInit,
hostArea = false
): boolean {
return (
route !== null &&
isPageStorageKeyForRoute(key, hostId, route.pathname, hostArea) &&
!held.storageOversize.includes(key)
)
}
export type PageStorageForInit = {
storage: Readonly<Record<string, string>>
storageOversize: readonly string[]
}
// Omit oversized values so one large journal cannot reject all of init; report value-cap drops as unwritable to prevent empty page state overwriting native operation ids.
// Entry-cap drops remain writable because their values fit; only missing oversized contents make replacement destructive.
export function pageStorageEntriesForInit(held: Readonly<Record<string, string>>): {
entries: Record<string, string>
dropped: string[]
oversize: string[]
} {
const entries: Record<string, string> = {}
const dropped: string[] = []
const oversize: string[] = []
for (const [key, value] of Object.entries(held)) {
if (value.length > PAGE_STORAGE_MAX_VALUE_CHARS) {
dropped.push(key)
oversize.push(key)
continue
}
if (Object.keys(entries).length >= PAGE_STORAGE_MAX_ENTRIES) {
dropped.push(key)
continue
}
entries[key] = value
}
return { entries, dropped, oversize }
}