docs(subagent): document explicit product provider opt-in

This commit is contained in:
pku-xht
2026-08-13 16:27:48 +08:00
parent dff9462bea
commit 93c0032216
16 changed files with 48 additions and 38 deletions

View File

@@ -198,9 +198,9 @@
toolName: subagent_fork
backgroundMode: continuable
# Product providers are host-plane singletons. Copy this preset, then
# remove `disabled` from either ordinary tool row to expose that product
# only to agents composed from the copy.
# Production dsh does not install these optional providers. An opting-in
# Profile mounts each provider once on the host plane; copy this preset,
# then remove `disabled` from the matching tool row.
- id: tool-subagent-codex
name: '@deepseek-ai/dsh-tool-subagent'
disabled: true

View File

@@ -185,9 +185,9 @@
toolName: subagent_fork
backgroundMode: continuable
# Product providers are host-plane singletons. Copy this preset, then
# remove `disabled` from either ordinary tool row to expose that product
# only to agents composed from the copy.
# Production dsh does not install these optional providers. An opting-in
# Profile mounts each provider once on the host plane; copy this preset,
# then remove `disabled` from the matching tool row.
- id: tool-subagent-codex
name: '@deepseek-ai/dsh-tool-subagent'
disabled: true

View File

@@ -147,7 +147,7 @@ Copy these disabled templates from a shipped full preset and remove `disabled` o
maxDepth: provider-managed
```
The two rows are independent. Leaving both disabled preserves the copied preset, enabling one exposes only that product tool, and enabling both exposes both. `backgroundMode: one-shot` keeps omitted or `false` calls in the foreground and lets explicit `run_in_background: true` return a generic Job id. Full presets already carry `tool-jobs`, while the host carries the job registry; retain both when making a custom composition so `job_output`, `job_list`, `job_kill`, cancellation, and completion notices stay available. The host must provide `codex` or `claude` on `PATH`; the preset does not install, authenticate, select a model for, or probe either product.
The two rows are independent. Leaving both disabled preserves the copied preset, enabling one exposes only that product tool, and enabling both exposes both. Production `dsh` does not install or mount either optional provider: before enabling a row, the Profile must install the matching `@deepseek-ai/dsh-subagent-codex` or `@deepseek-ai/dsh-subagent-claude-code` package and mount it once on the host plane. A preset cannot provide that host dependency. `backgroundMode: one-shot` keeps omitted or `false` calls in the foreground and lets explicit `run_in_background: true` return a generic Job id. Full presets already carry `tool-jobs`, while the base host carries the job registry; retain both so `job_output`, `job_list`, `job_kill`, cancellation, and completion notices stay available. The host must also provide `codex` or `claude` on `PATH`; the preset does not install, authenticate, select a model for, or probe either product.
## What not to move into a preset

View File

@@ -197,9 +197,9 @@
toolName: subagent_fork
backgroundMode: continuable
# Product providers are host-plane singletons. Copy this preset, then
# remove `disabled` from either ordinary tool row to expose that product
# only to agents composed from the copy.
# Production dsh does not install these optional providers. An opting-in
# Profile mounts each provider once on the host plane; copy this preset,
# then remove `disabled` from the matching tool row.
- id: tool-subagent-codex
name: '@deepseek-ai/dsh-tool-subagent'
disabled: true