docs: trim generated prose

packages/subagent/subagent-spawn/README.md

@@ -1,16 +1,12 @@
 # @deepseek-ai/dsh-subagent-spawn
 
-The in-process **spawn** subagent backend: a [`SubagentProvider`](../subagent/README.md) that runs each child as a **fresh** child [`Agent`](../../core/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`](../../core/agent) teardown.
+In-process provider that runs each request as a fresh child [`Agent`](../../core/agent) on the same Cordis application. The child has a new session and no inherited conversation; it uses the parent model unless overridden.
 
-The run mechanics live in the shared [`@deepseek-ai/dsh-subagent-inprocess`](../subagent-inprocess/README.md) driver (`startInProcessRun`); this backend just passes **no seed** (a fresh child). The [fork](../subagent-fork/README.md) 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. Its `run.started` boundary resolves only after the fresh child is published, so `subagent/start` observers see a live registry entry. See the [driver README](../subagent-inprocess/README.md) for the full lifecycle (depth check, one-shot drive, result read, dispose).
+The package delegates lifecycle work to [`startInProcessRun`](../subagent-inprocess/README.md) with no seed. Child creation, persona, tool filtering, structured output, cancellation, and quiescent disposal are owned by the shared driver. `run.started` resolves only after publication, so `subagent/start` observers can resolve the child from `ctx.agents`.
 
 ## 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](../subagent-inprocess/README.md) 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.
+`{ outputSchema: true, depthLimit: true, toolFilter: true, persona: true }`
 
 ## Config
 

packages/subagent/subagent-spawn/src/index.ts

@@ -1,21 +1,8 @@
 /**
- * The in-process SPAWN subagent backend: registers a {@link SubagentProvider}
- * on `ctx.subagents` that runs each child as a FRESH child {@link Agent} on the
- * same cordis context (its own session, own system prompt, zero parent
- * context). The cheapest transport, reusing the agent factory's quiescent
- * teardown.
- *
- * The run mechanics live in `@deepseek-ai/dsh-subagent-inprocess`
- * ({@link startInProcessRun}); this backend just passes NO seed (a fresh
- * child). The fork backend is an independent peer over the same driver.
- *
- * Structured output (`outputSchema`) is supported through the driver's
- * per-child scoped runtime: the child registers its real-schema capture tool,
- * prompt instruction, and enforcement listeners inside the creation setup
- * window, and its scope owns their lifetime.
- *
- * Plugin export shape: named `name`/`inject`/`Config`/`apply`, NO default.
- *
+ * The in-process SPAWN subagent backend: registers a {@link SubagentProvider} on
+ * `ctx.subagents` that runs each child as a fresh child {@link Agent} on the same cordis
+ * context (its own session, own system prompt, zero parent context). The cheapest transport,
+ * reusing the agent factory's quiescent teardown.
  * @module @deepseek-ai/dsh-subagent-spawn
  */
 
@@ -25,10 +12,8 @@ import type { SubagentCapabilities, SubagentProvider, SubagentStartRequest } fro
 import { startInProcessRun } from '@deepseek-ai/dsh-subagent-inprocess'
 
 export const name = 'subagent-spawn'
-// `tools` is deliberately NOT injected: the shared driver registers structured
-// output through the child's creation context, whose factory already requires
-// the tool service. Keeping it out of this backend's inject list preserves the
-// provider's independent apply timing.
+// `tools` is deliberately not injected: the shared driver registers structured output through
+// the child's creation context, whose factory already requires the tool service.
 export const inject = ['subagents']
 
 /** Config: the registry name to register the provider under. */

packages/subagent/subagent-spawn/tests/subagent-spawn.spec.ts

@@ -148,11 +148,8 @@ describe('dsh-subagent-spawn', () => {
   })
 
   it('settles aborted (without running the child) when the request signal is ALREADY aborted', async () => {
-    // Regression: a signal aborted BEFORE the run starts never fires an `abort`
-    // event, so the listener can't catch it. The driver must check the
-    // already-aborted case up front and settle `aborted` without running the
-    // child — otherwise an already-cancelled request runs to `completed`. The
-    // empty script proves the child's model is never called.
+    // Regression: a signal aborted before the run starts never fires an `abort` event, so the
+    // listener can't catch it.
     const controller = new AbortController()
     controller.abort()
     const { ctx, parent } = await setup([])
@@ -164,12 +161,8 @@ describe('dsh-subagent-spawn', () => {
   })
 
   it('cancelling BEFORE the child turn starts settles aborted, not error', async () => {
-    // Regression: a cancel landing in the pre-turn window clears the queued
-    // prompt before any `turn/end` is logged. Deriving the stop reason from
-    // `turn/end` alone then mis-maps the no-turn case to `error`; the run must
-    // honor the cancel contract and settle `aborted`. The cancel is synchronous
-    // (same tick as start, before the loop's queued-wait continuation runs), so
-    // the turn is dropped and the empty script is never consumed.
+    // Regression: a cancel landing in the pre-turn window clears the queued prompt before any
+    // `turn/end` is logged.
     const { ctx, parent } = await setup([])
     const run = ctx.subagents.start('spawn', { prompt: [{ type: 'text', text: 'p' }], parent })
     run.cancel('early')
@@ -345,9 +338,7 @@ describe('dsh-subagent-spawn', () => {
       parent,
       outputSchema: { type: 'object', properties: { a: { type: 'number' } } },
     })
-    // Let the child's step start streaming, then unload the backend. The
-    // backend owns the child agent, so the unload tears the child down and
-    // the run settles — releasing its own runtime acquisition on the way out.
+    // Let the child's step start streaming, then unload the backend.
     await new Promise(resolve => setTimeout(resolve, 30))
     await fiber.dispose()
     const result = await run.result