deepseek-harness/packages/api/session-controller/tests/client-apply.client.spec.ts

import { Context } from '@deepseek-ai/cordis'
import type { Fiber } from '@deepseek-ai/cordis'
import type {
  ConnectionHandle,
  HostDescription,
} from '@deepseek-ai/dsh-client-connection/client'
import {
  RemoteStreamCarrierError,
  RemoteStream,
  type RemoteStreamOptions,
} from '@deepseek-ai/dsh-api-gateway/client'
import type { SessionId } from '@deepseek-ai/dsh-session/types'
import TypertRegistry from '@deepseek-ai/dsh-typert-registry'
import { afterEach, describe, expect, it, vi } from 'vitest'
import * as SessionClient from '../src/client/index.ts'
import { ClientSessions } from '../src/client/sessions/service.ts'
import { FakeApiClient, fakeRemote } from './fake-api.client.ts'

const DESCRIPTION: HostDescription = {
  version: 'fixture',
  cwd: '/fixture',
  attachedSessions: 0,
  home: '/home/fixture',
  canOpenPath: true,
}

const sid = (value: string): SessionId => value as SessionId

type RemoteListener = (...args: never[]) => void

interface Bench {
  readonly ctx: Context
  readonly api: FakeApiClient
  readonly fiber: Fiber
  readonly sessions: ClientSessions
  dispatch(event: string, ...args: unknown[]): void
  publishHost(description: HostDescription | undefined): void
}

const contexts = new Set<Context>()

afterEach(async () => {
  vi.restoreAllMocks()
  await Promise.all([...contexts].map(async (ctx) => { await ctx.fiber.dispose() }))
  contexts.clear()
})

async function mount(initialHost?: HostDescription): Promise<Bench> {
  const ctx = new Context()
  contexts.add(ctx)
  await ctx.plugin(TypertRegistry)
  const api = new FakeApiClient()
  const remote = fakeRemote(api)
  const listeners = new Map<string, Set<RemoteListener>>()
  const hostListeners = new Set<() => void>()
  let host = initialHost
  const connection: ConnectionHandle = {
    api,
    isLoopback: true,
    hostDescription: {
      getSnapshot: () => host,
      subscribe: (listener) => {
        hostListeners.add(listener)
        return () => { hostListeners.delete(listener) }
      },
    },
    generation: {
      getSnapshot: () => host === undefined
        ? undefined
        : { id: 1, host: { home: host.home } },
      subscribe: (listener) => {
        hostListeners.add(listener)
        return () => { hostListeners.delete(listener) }
      },
    },
    generation: {
      getSnapshot: () => host === undefined
        ? undefined
        : { id: 1, host: { home: host.home } },
      subscribe: (listener) => {
        hostListeners.add(listener)
        return () => { hostListeners.delete(listener) }
      },
    },
    rpc: {
      call: () => Promise.reject(new Error('unexpected generic RPC call')),
    },
    registerGenerationSource: () => () => {},
    start: () => ({ stop: () => {} }),
  }
  ctx.reflect.provide('connection', connection)
  ctx.reflect.provide('remote', {
    ...remote,
    $stream: <Item>(options: RemoteStreamOptions<Item>) => (
      new RemoteStream(connection, options)
    ),
    $on: (event: string, listener: RemoteListener) => {
      const eventListeners = listeners.get(event) ?? new Set<RemoteListener>()
      eventListeners.add(listener)
      listeners.set(event, eventListeners)
      return () => { eventListeners.delete(listener) }
    },
  })
  ctx.reflect.provide('remote.commands', remote.commands)
  ctx.reflect.provide('remote.session', remote.session)
  ctx.reflect.provide('remote.subagents', remote.subagents)
  const fiber = ctx.plugin(SessionClient)
  await fiber
  const sessions = ctx.sessions as ClientSessions
  return {
    ctx,
    api,
    fiber,
    sessions,
    dispatch: (event, ...args) => {
      for (const listener of listeners.get(event) ?? []) listener(...args as never[])
    },
    publishHost: (description) => {
      host = description
      for (const listener of [...hostListeners]) listener()
    },
  }
}

async function flush(): Promise<void> {
  for (let index = 0; index < 12; index++) await Promise.resolve()
}

describe('Session Controller Client apply', () => {
  it('routes Session Remote Events and connection generations into the object layer', async () => {
    const connected = vi.spyOn(ClientSessions.prototype, 'handleConnected')
    const error = vi.spyOn(ClientSessions.prototype, 'handleSessionError')
    const bench = await mount()
    expect(connected).not.toHaveBeenCalled()

    bench.dispatch('api-session/added', {
      sessionId: sid('session-1'),
      updatedAt: 1,
      running: false,
      blank: true,
    })
    await flush()
    expect(bench.sessions.list.getSnapshot().byId[sid('session-1')]).toMatchObject({
      running: false,
      updatedAt: 1,
    })

    bench.dispatch('api-session/status', sid('session-1'), true)
    bench.dispatch('api-session/activity', sid('session-1'), 9)
    bench.dispatch('api-session/error', sid('session-1'), 'agent failed')
    await flush()
    expect(bench.sessions.list.getSnapshot().byId[sid('session-1')]).toMatchObject({
      running: true,
      updatedAt: 9,
    })
    expect(error).toHaveBeenCalledWith(sid('session-1'), 'agent failed')

    bench.dispatch('api-session/removed', sid('session-1'))
    await flush()
    expect(bench.sessions.list.getSnapshot().byId[sid('session-1')]).toBeUndefined()

    bench.ctx.emit('connection/reset')
    expect(connected).toHaveBeenCalledOnce()
  })

  it('accepts the control baseline, retries a carrier generation, and reports terminal protocol failure', async () => {
    const accept = vi.spyOn(ClientSessions.prototype, 'handleControlFrame')
    const logged = vi.spyOn(console, 'error').mockImplementation(() => {})
    const bench = await mount(DESCRIPTION)
    await flush()

    expect(accept).toHaveBeenCalledWith({
      type: 'baseline',
      value: { queues: {}, jobs: {}, projections: {} },
    })

    bench.api.failStreams(new RemoteStreamCarrierError('generation lost'))
    await flush()
    expect(accept.mock.calls.filter(([frame]) => frame.type === 'baseline')).toHaveLength(2)

    bench.api.pushControl({ type: 'baseline', value: bench.api.controlBaseline } as never)
    await vi.waitFor(() => {
      expect(logged).toHaveBeenCalledWith(
        '[session-controller] control stream failed:',
        expect.objectContaining({ message: 'session control stream emitted more than one opening snapshot' }),
      )
    })
  })

  it('materializes Host-addressed Agent scopes before the Session list arrives', async () => {
    const bench = await mount()
    const adapter = bench.ctx.typert.contexts.getClient('agent')
    const first = adapter?.resolve(sid('agent-early'))

    expect(first).toBeDefined()
    expect(bench.sessions.scopeOf(first as Context)).toBe(sid('agent-early'))
    expect(adapter?.resolve(sid('agent-early'))).toBe(first)
  })

  it('projects Agent Context identity in both directions and withdraws the adapter on disposal', async () => {
    const bench = await mount(DESCRIPTION)
    await flush()
    expect(bench.sessions.list.getSnapshot().phase).toBe('ready')

    bench.dispatch('api-session/added', {
      sessionId: sid('agent-1'),
      updatedAt: 1,
      running: false,
      blank: true,
    })
    await flush()
    const scoped = bench.sessions.scope(sid('agent-1'))
    const adapter = bench.ctx.typert.contexts.getClient('agent')
    expect(scoped).toBeDefined()
    expect(adapter?.identity(bench.ctx)).toBeUndefined()
    expect(adapter?.identity(scoped!)).toBe(sid('agent-1'))
    expect(adapter?.resolve(sid('agent-1'))).toBe(scoped)

    await bench.fiber.dispose()
    expect(bench.ctx.typert.contexts.getClient('agent')).toBeUndefined()
  })

  it('waits for a Host generation before retrying the control stream', async () => {
    const accept = vi.spyOn(ClientSessions.prototype, 'handleControlFrame')
    const bench = await mount()
    await flush()
    expect(accept.mock.calls.filter(([frame]) => frame.type === 'baseline')).toHaveLength(1)

    bench.api.failStreams(new RemoteStreamCarrierError('offline'))
    await flush()
    expect(accept.mock.calls.filter(([frame]) => frame.type === 'baseline')).toHaveLength(1)

    bench.publishHost(DESCRIPTION)
    await flush()
    expect(accept.mock.calls.filter(([frame]) => frame.type === 'baseline')).toHaveLength(2)
  })
})