Skip to content

armgit / orca

Public Imported from GitHub
0

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.

4.3 KB
Raw Blame
import { describe, expect, it } from 'vitest'
import {
  isTailscaleEndpoint,
  tailscaleHostOfEndpoint,
  tailscalePingCommand,
  withRemoteRuntimeTailscaleHint
} from './remote-runtime-tailscale-hint'

const UNREACHABLE = 'Could not connect to the remote Orca runtime.'

describe('isTailscaleEndpoint', () => {
  it('matches MagicDNS hostnames', () => {
    expect(isTailscaleEndpoint('wss://example-host.tailnet.ts.net')).toBe(true)
    expect(isTailscaleEndpoint('ws://host.ts.net:6768')).toBe(true)
  })

  it('matches the 100.64.0.0/10 CGNAT range', () => {
    expect(isTailscaleEndpoint('ws://100.64.0.5:6768')).toBe(true)
    expect(isTailscaleEndpoint('ws://100.127.255.255:6768')).toBe(true)
  })

  it('matches Tailscale IPv6 (fd7a:115c:a1e0::/48) literals', () => {
    // Pairing endpoints can carry a bracketed IPv6 literal (resolvePairingEndpoint).
    expect(isTailscaleEndpoint('wss://[fd7a:115c:a1e0::1]:443')).toBe(true)
    expect(isTailscaleEndpoint('ws://[fd7a:115c:a1e0:ab12:4843:cd96:626b:1]:6768')).toBe(true)
    expect(isTailscaleEndpoint('ws://[2001:db8::1]:6768')).toBe(false)
    expect(isTailscaleEndpoint('ws://[::1]:6768')).toBe(false)
  })

  it('rejects non-Tailscale hosts and the surrounding 100.x space', () => {
    expect(isTailscaleEndpoint('ws://192.168.1.10:6768')).toBe(false)
    expect(isTailscaleEndpoint('wss://orca.example.com')).toBe(false)
    expect(isTailscaleEndpoint('ws://100.63.0.1:6768')).toBe(false)
    expect(isTailscaleEndpoint('ws://100.128.0.1:6768')).toBe(false)
    expect(isTailscaleEndpoint('ws://notts.net.evil.com')).toBe(false)
    // A DNS name that merely starts with a CGNAT-shaped label is not a TS IP.
    expect(isTailscaleEndpoint('ws://100.64.0.1.example.com:6768')).toBe(false)
  })

  it('handles bare hosts without a scheme and empty input', () => {
    expect(isTailscaleEndpoint('host.ts.net')).toBe(true)
    // A trailing-dot FQDN is still the same tailnet host.
    expect(isTailscaleEndpoint('wss://host.ts.net.')).toBe(true)
    expect(isTailscaleEndpoint('')).toBe(false)
    expect(isTailscaleEndpoint(null)).toBe(false)
    expect(isTailscaleEndpoint(undefined)).toBe(false)
  })
})

describe('withRemoteRuntimeTailscaleHint', () => {
  it('recommends switching to Tailscale when the endpoint is not on a tailnet', () => {
    const result = withRemoteRuntimeTailscaleHint(UNREACHABLE, 'ws://192.168.1.10:6768')
    expect(result).toContain(UNREACHABLE)
    expect(result).toContain('connect both devices to Tailscale')
    expect(result).toContain('https://tailscale.com/download')
  })

  it('points at tailnet-specific causes when the endpoint is already Tailscale', () => {
    const result = withRemoteRuntimeTailscaleHint(UNREACHABLE, 'wss://example-host.tailnet.ts.net')
    expect(result).toContain('Funnel reverted to tailnet-only')
    expect(result).toContain('already-paired devices reconnect with their saved token')
    expect(result).not.toContain('https://tailscale.com/download')
  })

  it('covers the close and timeout failure variants', () => {
    expect(
      withRemoteRuntimeTailscaleHint(
        'Remote Orca runtime closed the connection.',
        'ws://192.168.1.10:6768'
      )
    ).toContain('connect both devices to Tailscale')
    expect(
      withRemoteRuntimeTailscaleHint(
        'Timed out while connecting to the remote Orca runtime.',
        'wss://host.ts.net'
      )
    ).toContain('Funnel reverted to tailnet-only')
  })

  it('leaves non-connectivity errors untouched', () => {
    const auth = 'Remote Orca runtime rejected the pairing token.'
    expect(withRemoteRuntimeTailscaleHint(auth, 'ws://192.168.1.10:6768')).toBe(auth)
  })

  it('is idempotent — does not append the hint twice', () => {
    const once = withRemoteRuntimeTailscaleHint(UNREACHABLE, 'ws://192.168.1.10:6768')
    const twice = withRemoteRuntimeTailscaleHint(once, 'ws://192.168.1.10:6768')
    expect(twice).toBe(once)
  })
})

describe('tailscaleHostOfEndpoint', () => {
  it('returns a pasteable host only when it is plain DNS or IP syntax', () => {
    expect(tailscaleHostOfEndpoint('ws://desk.tail1234.ts.net:6768')).toBe('desk.tail1234.ts.net')
    expect(tailscaleHostOfEndpoint('ws://[fd7a:115c:a1e0::1]:6768')).toBe('fd7a:115c:a1e0::1')
    expect(tailscaleHostOfEndpoint('ws://$(id).ts.net:6768')).toBeNull()
    expect(tailscalePingCommand('100.101.102.103')).toBe('tailscale ping 100.101.102.103')
  })
})