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 { BRIDGE_MAX_ROUTE_PARAM_CHARS } from './bridge/bridge-caps'
import { BridgeInitRouteSchema, type BridgeInitRoute } from './bridge/bridge-envelope'
import { shellRouteHref } from './bridge/page-bootstrap'
import { shellScreenRoute, shellScreenRouteKey } from './shell-screen-route'
import {
mobileFilePreviewShellParams,
normalizeMobileFilePreviewRouteParams
} from '../files/mobile-file-preview-route'
const PREVIEW_PATH = '/h/host-1/files/preview/wt-1'
function previewRoute(absolutePath: string) {
const route = normalizeMobileFilePreviewRouteParams({
hostId: 'host-1',
worktreeId: 'wt-1',
source: 'terminalArtifact',
absolutePath,
grantId: 'grant-1'
})
if (!route.ok) {
throw new Error(route.message)
}
return { pathname: PREVIEW_PATH, params: mobileFilePreviewShellParams(route.params) }
}
describe('the route a switch hands the shell', () => {
it('is one the page could actually be given', () => {
const route = previewRoute('/logs/run.txt')
expect(BridgeInitRouteSchema.safeParse(route).success).toBe(true)
expect(shellScreenRoute(route)).toEqual(route)
})
it('is nothing when a file path is longer than a param may be', () => {
// Use a real Windows long path: without a length guard the bridge drops init.route to null and shows an update refusal over a working native screen.
const route = previewRoute(`/logs/${'a'.repeat(BRIDGE_MAX_ROUTE_PARAM_CHARS)}.txt`)
expect(BridgeInitRouteSchema.safeParse(route).success).toBe(false)
expect(shellScreenRoute(route)).toBeNull()
})
it('is nothing when a worktree id is not a segment the page will route', () => {
// Dot segments survive encodeURIComponent and escape the intended /h/ prefix when resolved.
const route = { pathname: '/h/host-1/files/..', params: { name: 'Files' } }
// Prove schema refusal too so an always-null guard cannot pass.
expect(BridgeInitRouteSchema.safeParse(route).success).toBe(false)
expect(shellScreenRoute(route)).toBeNull()
})
it('keeps a path with a slash, a space and a dot segment, which are params and not segments', () => {
const route = {
pathname: '/h/host-1/files/preview/wt-1',
params: { relativePath: 'docs/../my notes/readme.md', source: 'worktree' }
}
expect(shellScreenRoute(route)).toEqual(route)
})
})
describe('the key a shell screen remounts on', () => {
// Pin native remount keys to the page serializer’s URL; importing its RPC-adjacent module into native routes would cross the platform boundary.
it.each<BridgeInitRoute>([
{ pathname: '/h/host-1/files/wt-1' },
{ pathname: '/h/host-1/files/wt-1', params: { name: 'my worktree' } },
{
pathname: '/h/host-1/files/preview/wt-1',
params: { relativePath: 'docs/my notes/readme.md', source: 'worktree', line: '12' }
}
])('is the href the page would write into its history: %o', (route) => {
expect(shellScreenRouteKey(route)).toBe(shellRouteHref(route))
})
})