deepseek-harness/packages/extensions/tool-cordis/tests/cross-mount.spec.ts

import { describe, expect, it } from 'vitest'
import { call, CONSUMER_CODE, CONTENT_OUTPUT_CODE, PROVIDER_CODE, setup, text } from './helpers.ts'

/**
 * Cross-mount composition through ordinary cordis provide/inject semantics:
 * one mount provides a service, another injects it, and mount ids stay the
 * lifecycle handles. Every assertion is against the WORLD — the registry, the
 * service store, real tool dispatch — not the tool's own summary line.
 */

describe('cross-mount provide/inject', () => {
  it('provider first: the consumer activates immediately and its tool reaches the provided service', async () => {
    const ctx = await setup()
    const provider = await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })
    expect(text(provider)).toContain('is running')

    const consumer = await call(ctx, 'cordis_mount', { code: CONSUMER_CODE })
    expect(consumer.isError).toBe(false)
    expect(text(consumer)).toContain('is running')

    // The vm-realm service value is callable across mounts, and the result
    // normalizes into the host realm like any dynamic tool result.
    const greeted = await call(ctx, 'greet', { name: 'harness' })
    expect(greeted.isError).toBe(false)
    expect(text(greeted)).toBe('hi harness')
  })

  it('consumer first: stays pending naming the missing service, then activates when the provider mounts', async () => {
    const ctx = await setup()
    const consumer = await call(ctx, 'cordis_mount', { code: CONSUMER_CODE })
    expect(consumer.isError).toBe(false)
    expect(text(consumer)).toContain('is pending')
    expect(text(consumer)).toContain('missing services: greeter')
    expect(text(await call(ctx, 'cordis_inspect', { what: 'temporary' }))).toContain('waiting for: greeter')
    expect(ctx.tools.get('greet')).toBeUndefined()

    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })
    expect(ctx.tools.get('greet')).toBeDefined()
    expect(text(await call(ctx, 'greet', { name: 'late' }))).toBe('hi late')
  })

  it('unmounting the provider sends the consumer back to pending and unwinds its registrations', async () => {
    const ctx = await setup()
    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })   // dyn-1
    await call(ctx, 'cordis_mount', { code: CONSUMER_CODE })   // dyn-2
    expect(ctx.tools.get('greet')).toBeDefined()

    const unmounted = await call(ctx, 'cordis_unmount', { id: 'dyn-1' })
    expect(unmounted.isError).toBe(false)
    expect(ctx.tools.get('greet')).toBeUndefined()
    const report = text(await call(ctx, 'cordis_inspect', { what: 'temporary' }))
    expect(report).toContain('Temporary Plugin dyn-2: greeter-consumer [pending] — provides: none; waiting for: greeter; lifetime: until unmounted or DSH restarts')
  })

  it('re-providing the service re-runs the consumer through the same guard (active again, tool back)', async () => {
    const ctx = await setup()
    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })   // dyn-1
    await call(ctx, 'cordis_mount', { code: CONSUMER_CODE })   // dyn-2
    await call(ctx, 'cordis_unmount', { id: 'dyn-1' })
    expect(ctx.tools.get('greet')).toBeUndefined()

    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })   // dyn-3
    expect(ctx.tools.get('greet')).toBeDefined()
    expect(text(await call(ctx, 'greet', { name: 'again' }))).toBe('hi again')
    expect(text(await call(ctx, 'cordis_inspect', { what: 'temporary' }))).toContain('Temporary Plugin dyn-2: greeter-consumer [running]')
  })

  it('a duplicate provide fails loud with the owning fiber named, and the failed mount is disposed', async () => {
    const ctx = await setup()
    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })
    const duplicate = await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })
    expect(duplicate.isError).toBe(true)
    expect(text(duplicate)).toContain('has been registered')
    const report = text(await call(ctx, 'cordis_inspect', { what: 'temporary' }))
    expect(report).toContain('Temporary Plugin dyn-1: greeter-provider')
    expect(report).not.toContain('dyn-2')
  })

  it('inspect surfaces the linkage: provides on the provider row, the service in services and api sections', async () => {
    const ctx = await setup()
    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })
    await call(ctx, 'cordis_mount', { code: CONSUMER_CODE })

    const dynamic = text(await call(ctx, 'cordis_inspect', { what: 'temporary' }))
    expect(dynamic).toContain('Temporary Plugin dyn-1: greeter-provider [running] — provides: greeter; waiting for: none; lifetime: until unmounted or DSH restarts')

    const services = text(await call(ctx, 'cordis_inspect', { what: 'services' }))
    expect(services).toContain('- greeter (provided by greeter-provider)')

    const api = text(await call(ctx, 'cordis_inspect', { what: 'api' }))
    expect(api).toContain('- greeter (provided by greeter-provider, no catalog entry)')
  })

  it('a primitive (or null) provided value passes through the façade unwrapped, on both read paths', async () => {
    const ctx = await setup()
    const provider = await call(ctx, 'cordis_mount', {
      code: `
        return {
          name: 'answer-provider',
          apply(ctx) {
            ctx.provide('answer', 42)
            ctx.provide('nothing', null)
          },
        }
      `,
    })
    expect(provider.isError).toBe(false)

    const consumer = await call(ctx, 'cordis_mount', {
      code: `
        return {
          name: 'answer-consumer',
          inject: ['answer', 'nothing', 'tools'],
          apply(ctx) {
            harness.registerTool(ctx, harness.defineTool({
              name: 'answer',
              description: 'Read the provided primitive services.',
              parameters: {},
              ${CONTENT_OUTPUT_CODE}
              async execute() {
                return [{ type: 'text', text: ctx.answer + '/' + ctx.get('answer') + '/' + ctx.nothing }]
              },
            }))
          },
        }
      `,
    })
    expect(consumer.isError).toBe(false)
    expect(text(consumer)).toContain('is running')
    expect(text(await call(ctx, 'answer', {}))).toBe('42/42/null')
  })

  it('unmounting the consumer leaves the provider and its service intact', async () => {
    const ctx = await setup()
    await call(ctx, 'cordis_mount', { code: PROVIDER_CODE })   // dyn-1
    await call(ctx, 'cordis_mount', { code: CONSUMER_CODE })   // dyn-2
    await call(ctx, 'cordis_unmount', { id: 'dyn-2' })

    expect(ctx.tools.get('greet')).toBeUndefined()
    const services = text(await call(ctx, 'cordis_inspect', { what: 'services' }))
    expect(services).toContain('- greeter (provided by greeter-provider)')
    expect(text(await call(ctx, 'cordis_inspect', { what: 'temporary' }))).toContain('Temporary Plugin dyn-1: greeter-provider [running]')
  })
})