deepseek-harness/packages/subagent/subagent-spawn
2026-07-11 22:55:40 +08:00
..
src fix(core): enforce agent-scoped ownership boundaries 2026-07-11 22:55:26 +08:00
tests fix(core): enforce agent-scoped ownership boundaries 2026-07-11 22:55:26 +08:00
package.json Apply the ts-build-config (lib/types) convention to the new subagent packages 2026-06-22 14:43:51 +08:00
README.md docs: align the agent-scope contracts 2026-07-11 22:55:40 +08:00
tsconfig.json Apply the ts-build-config (lib/types) convention to the new subagent packages 2026-06-22 14:43:51 +08:00

@deepseek-ai/dsh-subagent-spawn

The in-process spawn subagent backend: a SubagentProvider that runs each child as a fresh child Agent on the same cordis context (ctx.agents) — its own session, its own (or the parent's) model, zero inherited conversation. The cheapest transport, reusing the agent factory's quiescent AgentHandle teardown.

The run mechanics live in the shared @deepseek-ai/dsh-subagent-inprocess driver (startInProcessRun); this backend just passes no seed (a fresh child). The fork backend is an independent peer over the same driver — neither knows about the other.

What it does

start(request) delegates to startInProcessRun(ctx, request, {}) with no seed: a fresh child agent with the parent's cwd/parentSession lineage and (by default) the parent's model. The driver creates one run-owner fiber under parent.ctx; parent teardown, this provider's teardown, and manual disposal all converge there before child publication. See the driver README for the full lifecycle (depth check, one-shot drive, result read, dispose).

Capabilities

{ outputSchema: true, depthLimit: true, toolFilter: true, persona: true }. It constructs the child, so it enforces a recursion cap and composes the child's persona, global-tool restriction, and structured runtime inside the agent-creation setup window. At apply it registers this one named provider on ctx.subagents; per-run contributions belong to each child's scope.

Config

Key Meaning
providerName Registry name on ctx.subagents (default spawn).