Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
85 lines
2.9 KiB
TypeScript
85 lines
2.9 KiB
TypeScript
/**
|
|
* Agent-scope primitive spec: the actx minted by createScope carries the
|
|
* tag and the dispatch filter itself, so plain cordis dispatch with the actx
|
|
* as subject routes by agent — same-agent tagged listeners receive,
|
|
* foreign-agent ones are filtered out, untagged listeners hear everything,
|
|
* and a subject-less root dispatch stays unfiltered. Scope-owned listeners
|
|
* dispose with the fiber.
|
|
*/
|
|
import { Context } from '@deepseek-ai/cordis'
|
|
import { describe, expect, it } from 'vitest'
|
|
import type { SessionId } from '@deepseek-ai/dsh-client-connection/client'
|
|
import { createScope, scopeOf } from '../src/client/agents/scope.ts'
|
|
|
|
const sid = (k: string): SessionId => k as SessionId
|
|
|
|
declare module '@deepseek-ai/cordis' {
|
|
interface Events {
|
|
/**
|
|
* Test-only routed probe event.
|
|
* @param payload - marker payload.
|
|
* @mode bail
|
|
*/
|
|
'test/scope-probe'(payload: { from: string }): true | undefined
|
|
}
|
|
}
|
|
|
|
function bench() {
|
|
const root = new Context()
|
|
const a = createScope(root, sid('a'))
|
|
const b = createScope(root, sid('b'))
|
|
const seen: string[] = []
|
|
const listen = (label: string, ctx: Context, answer?: true) => {
|
|
ctx.on('test/scope-probe', (payload) => {
|
|
seen.push(`${label}:${payload.from}`)
|
|
return answer
|
|
})
|
|
}
|
|
return { root, a, b, seen, listen }
|
|
}
|
|
|
|
describe('createScope', () => {
|
|
it('tags the ctx (scopeOf) and leaves the root untagged', () => {
|
|
const { root, a } = bench()
|
|
expect(scopeOf(a.ctx)).toBe(sid('a'))
|
|
expect(scopeOf(root)).toBeUndefined()
|
|
})
|
|
|
|
it('scoped dispatch reaches same-session and untagged listeners, never a foreign session', () => {
|
|
const { root, a, b, seen, listen } = bench()
|
|
listen('a', a.ctx)
|
|
listen('b', b.ctx)
|
|
listen('root', root)
|
|
a.ctx.bail(a.ctx, 'test/scope-probe', { from: 'a' })
|
|
expect(seen).toEqual(['a:a', 'root:a'])
|
|
seen.length = 0
|
|
b.ctx.emit(b.ctx, 'test/scope-probe', { from: 'b' })
|
|
expect(seen).toEqual(['b:b', 'root:b'])
|
|
})
|
|
|
|
it('bail answers the first same-scope listener and skips filtered foreign ones', () => {
|
|
const { a, b, listen } = bench()
|
|
listen('b', b.ctx, true) // registered first, but foreign → filtered out
|
|
expect(a.ctx.bail(a.ctx, 'test/scope-probe', { from: 'a' })).toBeUndefined()
|
|
listen('a', a.ctx, true)
|
|
expect(a.ctx.bail(a.ctx, 'test/scope-probe', { from: 'a' })).toBe(true)
|
|
})
|
|
|
|
it('a subject-less root dispatch is unfiltered (every listener hears it)', () => {
|
|
const { root, a, b, seen, listen } = bench()
|
|
listen('a', a.ctx)
|
|
listen('b', b.ctx)
|
|
listen('root', root)
|
|
root.emit('test/scope-probe', { from: 'root' })
|
|
expect(seen).toEqual(['a:root', 'b:root', 'root:root'])
|
|
})
|
|
|
|
it('fiber disposal removes scope-owned listeners', async () => {
|
|
const { a, seen, listen } = bench()
|
|
listen('a', a.ctx)
|
|
await a.fiber.dispose()
|
|
a.ctx.emit(a.ctx, 'test/scope-probe', { from: 'late' })
|
|
expect(seen).toEqual([])
|
|
})
|
|
})
|