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, vi } from 'vitest'
import { buildConnectionDiagnosticsReport } from './connection-diagnostics-report'
const NOW = Date.UTC(2026, 6, 9, 22, 0, 0)
describe('buildConnectionDiagnosticsReport', () => {
it('summarizes a failing Tailscale host with its log', () => {
const report = buildConnectionDiagnosticsReport({
hostName: 'Host 1',
endpoint: 'ws://100.65.9.106:6768',
state: 'reconnecting',
reconnectAttempts: 12,
lastConnectedAt: NOW - 5 * 60_000,
platform: 'ios 26.5.1',
appVersion: '0.0.29',
bridgeProtocolVersion: 1,
desktopAppVersion: '1.4.191',
entries: [
{
id: 'log-1',
ts: NOW - 60_000,
level: 'error',
message: 'WebSocket connect timeout',
detail: 'No TCP/WS handshake within 12s — endpoint unreachable?'
}
],
nowMs: NOW
})
expect(report).toContain('App: Orca Mobile 0.0.29 · ios 26.5.1')
expect(report).toContain('Host Orca version: unknown (not currently connected)')
expect(report).not.toContain('1.4.191')
expect(report).toContain('Endpoint: 100.65.9.106:6768 (Tailscale)')
expect(report).toContain('State: reconnecting (reconnect attempts: 12)')
expect(report).toContain('(5m 0s ago)')
expect(report).toContain(
'[error] WebSocket connect timeout — No TCP/WS handshake within 12s — endpoint unreachable?'
)
})
it('marks never-connected sessions and empty logs', () => {
const report = buildConnectionDiagnosticsReport({
hostName: 'Host 2',
endpoint: 'ws://192.168.1.50:6768',
state: 'connecting',
reconnectAttempts: 0,
lastConnectedAt: null,
platform: 'android 15',
appVersion: '0.0.29',
bridgeProtocolVersion: 1,
entries: [],
nowMs: NOW
})
expect(report).toContain('Endpoint: 192.168.1.50:6768')
expect(report).toContain('Host Orca version: unknown')
expect(report).not.toContain('(Tailscale)')
expect(report).toContain('Last connected: never this session')
expect(report).toContain('No connection events recorded.')
})
it('names the bridge version under the app line', () => {
const lines = buildConnectionDiagnosticsReport({
hostName: 'Host 3',
endpoint: 'ws://192.168.1.50:6768',
state: 'connected',
reconnectAttempts: 0,
lastConnectedAt: null,
platform: 'ios 26',
appVersion: '0.0.60',
desktopAppVersion: '1.4.197',
bridgeProtocolVersion: 1,
entries: [],
nowMs: NOW
}).split('\n')
expect(lines.slice(2, 4)).toEqual(['App: Orca Mobile 0.0.60 · ios 26', 'Bridge protocol: 1'])
expect(lines).toContain('Host Orca version: 1.4.197')
})
it('explains the most likely cause and redacts credentials before copying', () => {
const report = buildConnectionDiagnosticsReport({
hostName: 'Host 3',
endpoint: 'ws://100.88.90.25:6768',
state: 'reconnecting',
reconnectAttempts: 4,
lastConnectedAt: null,
platform: 'android 36',
appVersion: '0.0.46',
bridgeProtocolVersion: 1,
activePath: 'tailscale',
pendingPath: 'relay',
entries: [
{
id: 'relay-failure',
ts: NOW - 5_000,
level: 'error',
message: 'Relay: relay dial failed',
detail:
'RelayDirectorHttpError: relay director resolve failed (503); retry after 30000ms; resumeToken=secret-resume-token'
}
],
nowMs: NOW
})
expect(report).toContain(
'Likely cause: Relay service was temporarily unavailable and asked Orca to retry in 30s.'
)
expect(report).toContain('Path: active=tailscale; recovery=relay')
expect(report).toContain('Next step: Keep Orca open; recovery should retry automatically.')
expect(report).toContain('resumeToken=[redacted]')
expect(report).not.toContain('secret-resume-token')
})
it('redacts quoted JSON credentials and never echoes an invalid endpoint', () => {
const report = buildConnectionDiagnosticsReport({
hostName: 'Host 4',
endpoint: 'not-a-url?token=endpoint-secret',
state: 'reconnecting',
reconnectAttempts: 1,
lastConnectedAt: null,
platform: 'android 36',
appVersion: '0.0.47',
bridgeProtocolVersion: 1,
entries: [
{
id: 'json-secret',
ts: NOW,
level: 'error',
message: 'Relay failed',
detail: '{"resumeToken":"json-secret","authorization":"Bearer bearer-secret"}'
}
],
nowMs: NOW
})
expect(report).toContain('Endpoint: invalid endpoint')
expect(report).not.toContain('endpoint-secret')
expect(report).not.toContain('json-secret')
expect(report).not.toContain('bearer-secret')
})
it('bounds a single event line before submission while preserving its identity', () => {
const report = buildConnectionDiagnosticsReport({
hostName: 'Host 5',
endpoint: 'ws://192.168.1.2:6768',
state: 'reconnecting',
reconnectAttempts: 1,
lastConnectedAt: null,
platform: 'android 36',
appVersion: '0.0.47',
bridgeProtocolVersion: 1,
entries: [
{
id: 'oversized',
ts: NOW,
level: 'error',
message: `newest oversized ${'😀'.repeat(2_000)}`
}
],
nowMs: NOW
})
expect(report).toContain('newest oversized')
expect(report).toContain('[truncated]')
expect(new TextEncoder().encode(report.split('\n').at(-1)!).byteLength).toBeLessThanOrEqual(
2048
)
})
it.each([2047, 2048, 2049])('keeps the existing event boundary at %i bytes', (bytes) => {
const prefix = `${new Date(NOW).toISOString()} [error] `
const marker = ' … [truncated]'
const message = 'a'.repeat(bytes - prefix.length)
const report = buildConnectionDiagnosticsReport({
hostName: 'fixture',
endpoint: 'ws://192.168.1.2:6768',
state: 'connected',
reconnectAttempts: 0,
lastConnectedAt: null,
platform: 'ios',
appVersion: 'fixture',
bridgeProtocolVersion: 1,
entries: [{ id: 'boundary', ts: NOW, level: 'error', message }],
nowMs: NOW
})
const available = 2048 - prefix.length - new TextEncoder().encode(marker).byteLength
expect(report.split('\n').at(-1)).toBe(
bytes <= 2048 ? `${prefix}${message}` : `${prefix}${'a'.repeat(available)}${marker}`
)
})
it.each(['a', 'é', '界', '😀', '\ud800', '\udc00'])(
'truncates %j without per-character encoding',
(token) => {
const encode = vi.spyOn(TextEncoder.prototype, 'encode')
const entry = Object.freeze({
id: 'bounded',
ts: NOW,
level: 'error' as const,
message: token.repeat(3000)
})
let report: string
let calls: number
try {
report = buildConnectionDiagnosticsReport({
hostName: 'fixture',
endpoint: 'ws://192.168.1.2:6768',
state: 'reconnecting',
reconnectAttempts: 1,
lastConnectedAt: null,
platform: 'android',
appVersion: 'fixture',
bridgeProtocolVersion: 1,
entries: Object.freeze([entry]),
nowMs: NOW
})
calls = encode.mock.calls.length
} finally {
encode.mockRestore()
}
const prefix = `${new Date(NOW).toISOString()} [error] `
const marker = ' … [truncated]'
const available = 2048 - new TextEncoder().encode(prefix + marker).byteLength
const tokenBytes = new TextEncoder().encode(token).byteLength
expect(report.split('\n').at(-1)).toBe(
`${prefix}${token.repeat(Math.floor(available / tokenBytes))}${marker}`
)
expect(calls).toBeLessThanOrEqual(2)
}
)
})