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 { z } from 'zod'
import {
PAIRING_DEVICE_TOKEN_MAX_CHARACTERS,
PAIRING_ENDPOINT_MAX_CHARACTERS,
PAIRING_PUBLIC_KEY_MAX_CHARACTERS,
PAIRING_RELAY_URL_MAX_CHARACTERS
} from './mobile-pairing-protocol-limits'
import { RuntimeHostDescriptorSchema } from './runtime-host-descriptor'
export const PAIRING_OFFER_VERSION = 2
const PairingScopeSchema = z.enum(['mobile', 'runtime'])
const BASE64URL_16_PATTERN = /^[A-Za-z0-9_-]{16}$/
const BASE64URL_43_PATTERN = /^[A-Za-z0-9_-]{43}$/
const MAX_INVITE_TTL_MS = 10 * 60 * 1000
// Cell-stamped expiry needs skew leeway or an ahead cell clock invalidates every invite (as with host-proof freshness).
const INVITE_EXPIRY_CLOCK_SKEW_MS = 30 * 1000
function isCanonicalHttpsOrigin(value: string): boolean {
if (
value.length > PAIRING_RELAY_URL_MAX_CHARACTERS ||
new TextEncoder().encode(value).length > PAIRING_RELAY_URL_MAX_CHARACTERS
) {
return false
}
try {
const parsed = new URL(value)
return parsed.protocol === 'https:' && value === parsed.origin
} catch {
return false
}
}
function isCanonicalBase64Key(value: string): boolean {
if (!/^[A-Za-z0-9+/]{43}=$/.test(value)) {
return false
}
try {
const decoded = atob(value)
return decoded.length === 32 && btoa(decoded) === value
} catch {
return false
}
}
export function createPairingOfferSchema(now: () => number = () => Date.now()) {
const relaySchema = z.object({
v: z.literal(1),
directorUrl: z
.string()
.min(1)
.refine(isCanonicalHttpsOrigin, 'Expected canonical HTTPS origin'),
cellUrl: z.string().min(1).refine(isCanonicalHttpsOrigin, 'Expected canonical HTTPS origin'),
assignmentEpoch: z.number().int().min(0).max(Number.MAX_SAFE_INTEGER),
relayHostId: z.string().regex(BASE64URL_16_PATTERN),
inviteToken: z.string().regex(BASE64URL_43_PATTERN),
inviteExpiresAt: z
.number()
.int()
.refine((value) => {
const currentTime = now()
return (
value > currentTime &&
value <= currentTime + MAX_INVITE_TTL_MS + INVITE_EXPIRY_CLOCK_SKEW_MS
)
}, 'Expected a future invite expiry no more than 10 minutes away'),
e2eeFraming: z.literal(2)
})
return z
.object({
v: z.literal(PAIRING_OFFER_VERSION),
endpoint: z.string().min(1).max(PAIRING_ENDPOINT_MAX_CHARACTERS),
deviceToken: z.string().min(1).max(PAIRING_DEVICE_TOKEN_MAX_CHARACTERS),
// Pairing pins the Curve25519 key; verify relayHostId from its decoded bytes later.
publicKeyB64: z.string().min(1).max(PAIRING_PUBLIC_KEY_MAX_CHARACTERS),
pairedDeviceId: z.string().min(1).max(128).optional(),
scope: PairingScopeSchema.optional(),
relay: relaySchema.optional(),
// Why catch: a descriptor this build cannot read is dropped, never a reason to refuse pairing.
hostDescriptor: RuntimeHostDescriptorSchema.optional().catch(undefined)
})
.superRefine((offer, ctx) => {
if (offer.relay && offer.scope === 'runtime') {
// Relay v1 supports mobile only; runtime offers would promise unsupported routing/credentials.
ctx.addIssue({
code: 'custom',
path: ['relay'],
message: 'Relay is invalid for runtime scope'
})
}
if (offer.relay && !isCanonicalBase64Key(offer.publicKeyB64)) {
// relayHostId derives from decoded bytes; refuse permissive legacy base64 aliases here.
ctx.addIssue({
code: 'custom',
path: ['publicKeyB64'],
message: 'Relay offers require a canonical 32-byte public key'
})
}
})
}
export const PairingOfferSchema = createPairingOfferSchema()
export type PairingOffer = z.infer<typeof PairingOfferSchema>
export type PairingRelay = NonNullable<PairingOffer['relay']>