imccyu
ec601ca13d
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.
71 lines
2.8 KiB
TypeScript
71 lines
2.8 KiB
TypeScript
/**
|
|
* Agent-plane presentation selector: the row an agent preset carries to say
|
|
* which form of its tools the model sees.
|
|
*
|
|
* The tool registry itself stays on the host plane — the agent loop's
|
|
* scheduler, the API proxy's presenters, and every tool plugin are all its
|
|
* consumers, so it cannot move into a preset. What a preset CAN own is the
|
|
* presentation: `ctx.tools.presentAs()` declares it for the mounting agent
|
|
* alone, so a Code Mode agent runs beside native ones in one process.
|
|
*
|
|
* A code mode needs a TypeScript code runtime, which is a host-plane service
|
|
* ([`dsh-code-runtime-worker`](../../code-runtime/code-runtime-worker/README.md)).
|
|
* This row therefore waits for it rather than assuming it: a preset selecting
|
|
* Code Mode against a deployment that composes no runtime fails at mount, named
|
|
* in the preset's own activation audit, instead of at the first prompt.
|
|
* @module @deepseek-ai/dsh-agent-tool-mode
|
|
*/
|
|
|
|
import type { Context } from '@deepseek-ai/cordis'
|
|
import z from '@deepseek-ai/schemastery'
|
|
import type { ToolPresentationMode } from '@deepseek-ai/dsh-tools'
|
|
// Type-only: brings the `ctx.tools` Context merge into this program.
|
|
import type {} from '@deepseek-ai/dsh-tools'
|
|
|
|
/** Cordis plugin name. */
|
|
export const name = 'tool-mode'
|
|
|
|
/**
|
|
* Required services. `codeRuntime` is NOT listed: a `native` row must mount in
|
|
* a deployment that composes no runtime, and the mode-dependent wait is
|
|
* declared inside {@link apply} instead.
|
|
*/
|
|
export const inject = ['tools']
|
|
|
|
/** Plugin config. */
|
|
export interface Config {
|
|
/**
|
|
* The form this agent's model sees. `native` sends every visible schema,
|
|
* `code` sends only `run_code` plus a generated SDK, `both` sends both.
|
|
* Required rather than defaulted: the deployment default is what a preset
|
|
* without this row already gets, so an omitted value would mean the row was
|
|
* composed for nothing.
|
|
*/
|
|
mode: ToolPresentationMode
|
|
}
|
|
|
|
/** Runtime schema. */
|
|
export const Config: z<Config> = z.object({
|
|
mode: z.union(['native', 'code', 'both'] as const).required(),
|
|
})
|
|
|
|
/**
|
|
* Declare this agent's tool presentation.
|
|
* @param ctx - the mounting agent's scope context.
|
|
* @param config - the selected presentation.
|
|
*/
|
|
export function apply(ctx: Context, config: Config): void {
|
|
// `presentAs` is itself the effect — it registers through the calling
|
|
// context and hands back that exact disposer — so the declaration unwinds
|
|
// with this row without a second wrapper owning it.
|
|
if (config.mode === 'native') {
|
|
ctx.tools.presentAs('native')
|
|
return
|
|
}
|
|
// The wait is the loud failure: an entry still pending on `codeRuntime` is
|
|
// what `dsh-agent-presets` reports as an unusable row, naming this id.
|
|
ctx.inject(['codeRuntime'], (runtimeCtx: Context) => {
|
|
runtimeCtx.tools.presentAs(config.mode)
|
|
})
|
|
}
|