Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

2.8 KB
Raw Blame
import { describe, expect, it, vi } from 'vitest'
import { VIEWERS_UNAVAILABLE } from './api.js'
import { createViewerStreams, NOT_SERVED } from './viewerStreams.js'

function setup(taken = true) {
  const viewers = {
    stream: vi.fn(() => taken),
    surface: vi.fn(async () => ({ data: 'jpeg' })),
    closed: vi.fn(),
  }
  let on: typeof viewers | null = viewers
  const send = vi.fn(() => true)
  const streams = createViewerStreams(() => on, send)
  return { viewers, send, streams, off: () => { on = null } }
}

describe('this machine\'s viewers, served to a client over its connection', () => {
  it('hands each frame of a stream to the viewers, and says nothing itself when they take it', () => {
    const { viewers, send, streams } = setup()
    streams.frame('c1', 'viewer_request', { streamId: 's1', agentId: 'a1' })
    expect(viewers.stream).toHaveBeenCalledWith('c1', 'viewer_request', { streamId: 's1', agentId: 'a1' })
    expect(send).not.toHaveBeenCalled()
  })

  it('refuses a stream at once when the viewers do not take it, so the client never waits out its timeout', () => {
    const { send, streams } = setup(false)
    streams.frame('c1', 'viewer_request', { streamId: 's1' })
    streams.frame('c1', 'viewer_data', { streamId: 's1', data: 'AA==' })
    expect(send.mock.calls).toEqual([
      ['c1', 'viewer_close', { streamId: 's1', error: NOT_SERVED }],
      ['c1', 'viewer_close', { streamId: 's1', error: NOT_SERVED }],
    ])
    // A close needs no answer, and a frame of no stream has nobody to tell.
    streams.frame('c1', 'viewer_close', { streamId: 's1' })
    streams.frame('c1', 'viewer_request', { streamId: '../bad id' })
    streams.frame('c1', 'viewer_request', {})
    expect(send).toHaveBeenCalledTimes(2)
  })

  it('refuses every stream while the viewers are off, and answers a surface unavailable', async () => {
    const { viewers, send, streams, off } = setup()
    off()
    streams.frame('c1', 'viewer_request', { streamId: 's1' })
    expect(send).toHaveBeenCalledWith('c1', 'viewer_close', { streamId: 's1', error: NOT_SERVED })
    await expect(streams.surface('c1', { surfaceId: 'v' })).resolves.toEqual(VIEWERS_UNAVAILABLE)
    streams.closed('c1')
    streams.closedAll()
    expect(viewers.stream).not.toHaveBeenCalled()
    expect(viewers.closed).not.toHaveBeenCalled()
  })

  it('asks the viewers for a client\'s rendered frame', async () => {
    const { viewers, streams } = setup()
    await expect(streams.surface('c1', { surfaceId: 'v' })).resolves.toEqual({ data: 'jpeg' })
    expect(viewers.surface).toHaveBeenCalledWith('c1', { surfaceId: 'v' })
  })

  it('tells the viewers a connection went, or that every one did', () => {
    const { viewers, streams } = setup()
    streams.closed('c1')
    streams.closedAll()
    expect(viewers.closed.mock.calls).toEqual([['c1'], []])
  })
})