Yichen Jiang
9eaa9d22a5
Code Mode was a deployment-wide field on the host `tools` row: a deployment ran every session that way or none. The obvious product shape — 代码模式 beside 标准/极简/创造 in the preset picker — had nothing to hang on. The registry itself cannot move into a preset; the agent loop's scheduler, the api-proxy's presenters, and every tool plugin are its consumers. So split the registry from its projection: `presentAs(mode)` writes one cell on the calling agent's scope layer, exactly as `restrict()` does, and the three reads that decided presentation take that scope's mode instead of the service's. The config `mode` becomes the default agents shadow rather than a process-wide fact. Two consequences are load-bearing. `run_code` now enters a view only for scopes whose own mode presents it — a native agent must not find it dispatchable because another agent in the process does — and the reserved name holds whatever the configured mode, since any agent may select a code mode later. `dsh-agent-tool-mode` is the row a preset carries to declare this. A code mode waits for the host's `codeRuntime` rather than assuming it, so a runtime-less deployment fails the preset at mount, naming the row, instead of at the session's first request. The shipped `code` preset is `standard` plus that row, ordered second.
2.4 KiB
dsh-agent-tool-mode
English | 中文
agent preset 用来声明「模型看到的工具是哪一种形态」的那一行：native（全部 schema）、code（只有 run_code 加一份生成的 TypeScript SDK）或 both。
为什么是一行插件，而不是把注册表搬下来
工具注册表搬不进 preset。它的消费者全在宿主平面——dsh-agent-loop 读它的调度器，dsh-apiproxy 读它的 presenter 来渲染工具卡，每个工具插件都往里注册——而一个服务只有在所有消费者一起下沉时才能下沉。
preset 能拥有的是这份注册表的呈现方式。ctx.tools.presentAs() 只为正在挂载的那个 agent 声明，于是一个 Code Mode 会话可以和多个 native 会话同进程并存，各自看到各自的清单。dsh-tools 那一行上的 mode 仍然是默认值，供未作声明的 agent 使用。
它做什么
native 立即生效。code 类模式则等待 ctx.codeRuntime——这是一个宿主平面服务（dsh-code-runtime-worker）：若某个 preset 在未组装运行时的部署上选择 Code Mode，本行就停在 pending，dsh-agent-presets 会指名此 id 拒绝挂载。另一种做法——先乐观应用——会把失败推迟到该会话的第一次请求，那时操作者对 preset 和组装都已无从下手。
mode 是必填而非有默认值：不带这一行的 preset 本来就会拿到部署默认值，省略它等于这一行白组装了。
一个 agent 只声明一次呈现方式。同一份组装里的第二次声明会被拒绝而不是合并：对「模型看到哪种形态」给出两个答案是矛盾，不是覆盖。
Model Experience
Indirectly, through the projection it selects in dsh-tools: code presents run_code plus a generated SDK section, native presents every tool schema.
KV Cache effect
没有直接的失效影响；呈现方式在 agent 组装时即固定，因此其请求前缀在该会话的整个生命周期内保持稳定。
Known Limitations and Deferred Work
- 运行时仍在宿主平面 —— preset 可以选择 Code Mode，却无法自带它所需的 TypeScript 运行时；未组装运行时的部署也就无法组装任何 code 模式的 preset。