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 {
PAIRING_OFFER_VERSION,
PairingOfferSchema,
type PairingOffer
} from './mobile-relay-pairing-offer'
import { normalizePairingBase64 } from './mobile-pairing-base64'
import {
PAIRING_CODE_MAX_CHARACTERS,
PAIRING_INPUT_MAX_CHARACTERS
} from './mobile-pairing-protocol-limits'
export { PAIRING_OFFER_VERSION, PairingOfferSchema }
export type { PairingOffer }
export function encodePairingOffer(offer: PairingOffer): string {
const json = JSON.stringify(PairingOfferSchema.parse(offer))
const base64url = Buffer.from(json, 'utf-8')
.toString('base64')
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '')
if (base64url.length > PAIRING_CODE_MAX_CHARACTERS) {
throw new Error('Pairing offer exceeds safe size')
}
// Android camera intents and Expo Router retain custom-scheme query parameters more reliably than fragments.
return `orca://pair?code=${base64url}`
}
export function decodePairingOffer(url: string): PairingOffer {
if (url.length > PAIRING_INPUT_MAX_CHARACTERS) {
throw new Error('Invalid pairing URL: pairing code exceeds safe size')
}
const code = extractPairingCodeFromUrl(url)
if (!code) {
throw new Error('Invalid pairing URL: must start with orca://pair and include a pairing code')
}
return decodePairingBase64(code)
}
function extractPairingCodeFromUrl(url: string): string | null {
let parsed: URL
try {
parsed = new URL(url)
} catch {
return null
}
// Exact pairing host prevents prefix matches such as orca://pairing from carrying runtime credentials.
if (parsed.protocol !== 'orca:' || parsed.hostname !== 'pair') {
return null
}
if (parsed.pathname !== '' && parsed.pathname !== '/') {
return null
}
const code = parsed.searchParams.get('code')
if (code) {
return code
}
return parsed.hash ? parsed.hash.slice(1) || null : null
}
// Mobile paste accepts either the copied deep link or bare base64 code.
export function parsePairingCode(input: string): PairingOffer | null {
if (input.length > PAIRING_INPUT_MAX_CHARACTERS) {
return null
}
const trimmed = input.trim()
if (!trimmed) {
return null
}
try {
if (trimmed.toLowerCase().startsWith('orca://')) {
return decodePairingOffer(trimmed)
}
return decodePairingBase64(trimmed)
} catch {
return null
}
}
function decodePairingBase64(base64url: string): PairingOffer {
const base64 = normalizePairingBase64(base64url)
const json =
typeof Buffer === 'undefined'
? new TextDecoder().decode(
Uint8Array.from(atob(base64), (character) => character.charCodeAt(0))
)
: Buffer.from(base64, 'base64').toString('utf-8')
return PairingOfferSchema.parse(JSON.parse(json))
}