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.
105 lines
3.6 KiB
TypeScript
105 lines
3.6 KiB
TypeScript
/** Package-local scripted child boundary for deterministic tool-subagent tests. */
|
|
|
|
import type { Context } from '@deepseek-ai/cordis'
|
|
import type { ContentBlock } from '@deepseek-ai/dsh-llm'
|
|
import { SessionId } from '@deepseek-ai/dsh-session'
|
|
import type {
|
|
SubagentCapabilities,
|
|
SubagentProvider,
|
|
SubagentResult,
|
|
SubagentRun,
|
|
SubagentStartRequest,
|
|
SubagentStopReason,
|
|
} from '@deepseek-ai/dsh-subagent'
|
|
|
|
const DEFAULT_CAPABILITIES: SubagentCapabilities = {
|
|
outputSchema: true,
|
|
depthLimit: true,
|
|
toolFilter: true,
|
|
persona: true,
|
|
}
|
|
|
|
/** Options for one scripted provider fixture. */
|
|
export interface Config {
|
|
/** Registry name to register under. */
|
|
name: string
|
|
/** Final text returned by the scripted child. */
|
|
reply?: string
|
|
/** Terminal result reason. */
|
|
stopReason?: SubagentStopReason
|
|
/** Start-time features advertised by the provider. */
|
|
capabilities?: Partial<SubagentCapabilities>
|
|
/** Whether tool descriptions say the child inherits completed turns. */
|
|
inheritsParentContext?: boolean
|
|
/** Structured value returned when the request asks for one. */
|
|
structured?: unknown
|
|
}
|
|
|
|
/** Scripted provider whose result aborts if its signal or disposer wins first. */
|
|
class ScriptedSubagentProvider implements SubagentProvider {
|
|
readonly capabilities: SubagentCapabilities
|
|
readonly inheritsParentContext: boolean
|
|
|
|
constructor(
|
|
readonly name: string,
|
|
private readonly config: Config,
|
|
) {
|
|
this.capabilities = { ...DEFAULT_CAPABILITIES, ...config.capabilities }
|
|
this.inheritsParentContext = config.inheritsParentContext ?? false
|
|
}
|
|
|
|
async start(request: SubagentStartRequest): Promise<SubagentRun> {
|
|
if (request.signal.aborted) throw new Error('scripted subagent start aborted before publication')
|
|
const reply = this.config.reply ?? 'scripted subagent reply'
|
|
const output: ContentBlock[] = [{ type: 'text', text: reply }]
|
|
const wantsStructured = request.outputSchema !== undefined && this.capabilities.outputSchema
|
|
const stopReason = this.config.stopReason ?? 'completed'
|
|
const state = { cancelled: false }
|
|
const onAbort = (): void => { state.cancelled = true }
|
|
request.signal.addEventListener('abort', onAbort, { once: true })
|
|
await Promise.resolve()
|
|
if (state.cancelled) {
|
|
request.signal.removeEventListener('abort', onAbort)
|
|
throw new Error('scripted subagent start aborted before publication')
|
|
}
|
|
|
|
const resultFor = (): SubagentResult => ({
|
|
output,
|
|
...wantsStructured ? { structured: this.config.structured ?? { reply } } : {},
|
|
stopReason: state.cancelled ? 'aborted' : stopReason,
|
|
})
|
|
const result = new Promise<SubagentResult>((resolve) => {
|
|
setTimeout(() => { resolve(resultFor()) }, 0)
|
|
}).finally(() => {
|
|
request.signal.removeEventListener('abort', onAbort)
|
|
})
|
|
|
|
return {
|
|
id: SessionId(`scripted-subagent:${this.name}:${request.parent.id}`),
|
|
localAgent: undefined,
|
|
result,
|
|
dispose(): Promise<void> {
|
|
state.cancelled = true
|
|
request.signal.removeEventListener('abort', onAbort)
|
|
return Promise.resolve()
|
|
},
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Mount one scripted provider through an effect-scoped local plugin.
|
|
* @param ctx - context carrying the real subagent registry.
|
|
* @param config - scripted provider identity and outcome.
|
|
* @returns the fixture plugin's disposable fiber.
|
|
*/
|
|
export function mountScriptedProvider(ctx: Context, config: Config) {
|
|
return ctx.plugin({
|
|
name: 'scripted-subagent-provider',
|
|
inject: ['subagents'],
|
|
apply(pluginCtx: Context): void {
|
|
pluginCtx.subagents.registerProvider(new ScriptedSubagentProvider(config.name, config))
|
|
},
|
|
})
|
|
}
|