diff --git a/docs/api/agent.md b/docs/api/agent.md
index c68cb28f..940d8023 100644
--- a/docs/api/agent.md
+++ b/docs/api/agent.md
@@ -1568,7 +1568,9 @@ the call site.
 
 > **createSurfaceImprovementAdapter**(`opts`): [`ImprovementAdapter`](analyst-loop.md#improvementadapter)\<[`SurfaceImprovementEdit`](#surfaceimprovementedit)\>
 
-Defined in: [agent/improvement-adapter.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/agent/improvement-adapter.ts#L129)
+Defined in: [agent/improvement-adapter.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/agent/improvement-adapter.ts#L130)
+
+The substrate-default `ImprovementAdapter`: resolve each finding's subject to a real surface path, LLM-draft a unified-diff patch, then auto-apply or open a PR.
 
 #### Parameters
 
@@ -1729,7 +1731,9 @@ it's the whole point.
 
 > **validateSurfaces**(`surfaces`, `repoRoot`): readonly [`SurfaceValidationIssue`](#surfacevalidationissue)[]
 
-Defined in: [agent/surfaces.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/agent/surfaces.ts#L197)
+Defined in: [agent/surfaces.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/agent/surfaces.ts#L198)
+
+Validate an `AgentSurfaces` map on disk — missing paths fail loud at `defineAgent` time instead of silently skipping self-improvement edits.
 
 #### Parameters
 
@@ -1751,7 +1755,7 @@ readonly [`SurfaceValidationIssue`](#surfacevalidationissue)[]
 
 > **renderSurfaceIssues**(`issues`, `repoRoot`): `string`
 
-Defined in: [agent/surfaces.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/agent/surfaces.ts#L245)
+Defined in: [agent/surfaces.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/agent/surfaces.ts#L246)
 
 #### Parameters
 
diff --git a/docs/api/analyst-loop.md b/docs/api/analyst-loop.md
index cb2dd561..442f7286 100644
--- a/docs/api/analyst-loop.md
+++ b/docs/api/analyst-loop.md
@@ -828,7 +828,7 @@ Forwarded verbatim from `AnalystRegistry.runStream`.
 
 > **iterationsToTraceStore**\<`Task`, `Output`\>(`iterations`, `budgets?`): `TraceAnalysisStore`
 
-Defined in: [analyst-loop/iterations-to-trace-store.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/analyst-loop/iterations-to-trace-store.ts#L213)
+Defined in: [analyst-loop/iterations-to-trace-store.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/analyst-loop/iterations-to-trace-store.ts#L214)
 
 Build an in-memory `TraceAnalysisStore` over a loop round's iterations. Fail-loud on an
 empty round — there is nothing for an analyst to read, and a silent empty store would
diff --git a/docs/api/index.md b/docs/api/index.md
index 820bdb76..8023d070 100644
--- a/docs/api/index.md
+++ b/docs/api/index.md
@@ -10,7 +10,7 @@
 
 ### CircuitOpenError
 
-Defined in: [conversation/call-policy.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L41)
+Defined in: [conversation/call-policy.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L42)
 
 #### Extends
 
@@ -22,7 +22,7 @@ Defined in: [conversation/call-policy.ts:41](https://github.com/tangle-network/a
 
 > **new CircuitOpenError**(`participant`, `retryAfterMs`): [`CircuitOpenError`](#circuitopenerror)
 
-Defined in: [conversation/call-policy.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L42)
+Defined in: [conversation/call-policy.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L43)
 
 ###### Parameters
 
@@ -46,7 +46,7 @@ Defined in: [conversation/call-policy.ts:42](https://github.com/tangle-network/a
 
 ### DeadlineExceededError
 
-Defined in: [conversation/call-policy.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L50)
+Defined in: [conversation/call-policy.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L51)
 
 #### Extends
 
@@ -58,7 +58,7 @@ Defined in: [conversation/call-policy.ts:50](https://github.com/tangle-network/a
 
 > **new DeadlineExceededError**(`deadlineMs`): [`DeadlineExceededError`](#deadlineexceedederror)
 
-Defined in: [conversation/call-policy.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L51)
+Defined in: [conversation/call-policy.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L52)
 
 ###### Parameters
 
@@ -78,7 +78,7 @@ Defined in: [conversation/call-policy.ts:51](https://github.com/tangle-network/a
 
 ### CircuitBreakerState
 
-Defined in: [conversation/call-policy.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L83)
+Defined in: [conversation/call-policy.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L84)
 
 Live circuit-breaker state — one instance per (participant, conversation run).
 
@@ -88,7 +88,7 @@ Live circuit-breaker state — one instance per (participant, conversation run).
 
 > **new CircuitBreakerState**(`config`): [`CircuitBreakerState`](#circuitbreakerstate)
 
-Defined in: [conversation/call-policy.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L87)
+Defined in: [conversation/call-policy.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L88)
 
 ###### Parameters
 
@@ -106,7 +106,7 @@ Defined in: [conversation/call-policy.ts:87](https://github.com/tangle-network/a
 
 > **preflight**(`participant`, `now?`): `void`
 
-Defined in: [conversation/call-policy.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L93)
+Defined in: [conversation/call-policy.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L94)
 
 Check whether the next call is allowed. Throws `CircuitOpenError` when
 the breaker is open and the cooldown hasn't elapsed.
@@ -129,7 +129,7 @@ the breaker is open and the cooldown hasn't elapsed.
 
 > **recordSuccess**(): `void`
 
-Defined in: [conversation/call-policy.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L103)
+Defined in: [conversation/call-policy.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L104)
 
 ###### Returns
 
@@ -139,7 +139,7 @@ Defined in: [conversation/call-policy.ts:103](https://github.com/tangle-network/
 
 > **recordFailure**(`now?`): `void`
 
-Defined in: [conversation/call-policy.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L108)
+Defined in: [conversation/call-policy.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L109)
 
 ###### Parameters
 
@@ -155,7 +155,7 @@ Defined in: [conversation/call-policy.ts:108](https://github.com/tangle-network/
 
 ### SqlConversationJournal
 
-Defined in: [conversation/journal-sql.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L119)
+Defined in: [conversation/journal-sql.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L120)
 
 SQL-backed ConversationJournal. Two tables — runs (one row per runId, holds
 start/halt timestamps + halt reason) and turns (one row per committed turn,
@@ -172,7 +172,7 @@ payload is the ConversationTurn JSON). Replays the turns table on
 
 > **new SqlConversationJournal**(`db`, `table?`): [`SqlConversationJournal`](#sqlconversationjournal)
 
-Defined in: [conversation/journal-sql.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L126)
+Defined in: [conversation/journal-sql.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L127)
 
 ###### Parameters
 
@@ -200,7 +200,7 @@ Table-name prefix; the journal creates `${table}_runs` and
 
 > **migrate**(): `Promise`\<`void`\>
 
-Defined in: [conversation/journal-sql.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L135)
+Defined in: [conversation/journal-sql.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L136)
 
 Create the journal's tables if absent. Idempotent. Call once at deploy
 (or at app boot) — running on every request is harmless but adds latency.
@@ -213,7 +213,7 @@ Create the journal's tables if absent. Idempotent. Call once at deploy
 
 > **loadRun**(`runId`): `Promise`\<[`ConversationJournalEntry`](#conversationjournalentry) \| `undefined`\>
 
-Defined in: [conversation/journal-sql.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L141)
+Defined in: [conversation/journal-sql.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L142)
 
 Load any prior state for `runId`. Returns `undefined` for a fresh run.
 Implementations MUST NOT mutate the returned object — the runner clones
@@ -238,7 +238,7 @@ identically, so a journal with zero turns is equivalent to "fresh."
 
 > **beginRun**(`runId`, `startedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal-sql.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L167)
+Defined in: [conversation/journal-sql.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L168)
 
 Initialise journal state for a fresh run. Called once per run, before any
 `appendTurn`. Idempotent: calling with an existing runId is a no-op if
@@ -266,7 +266,7 @@ the entry already exists with the same `startedAt`.
 
 > **appendTurn**(`runId`, `turn`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal-sql.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L186)
+Defined in: [conversation/journal-sql.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L187)
 
 Append a committed turn. The runner only calls this AFTER the turn's
 backend stream completed and the credit total has been updated, so an
@@ -294,7 +294,7 @@ appended turn is observed-committed and never speculative.
 
 > **recordHalt**(`runId`, `halt`, `endedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal-sql.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L207)
+Defined in: [conversation/journal-sql.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L208)
 
 Record the run's terminal halt reason + end time. Once called, the run
 is observed-final; subsequent `loadRun` returns the same halt.
@@ -325,7 +325,7 @@ is observed-final; subsequent `loadRun` returns the same halt.
 
 ### InMemoryConversationJournal
 
-Defined in: [conversation/journal.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L58)
+Defined in: [conversation/journal.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L59)
 
 #### Implements
 
@@ -347,7 +347,7 @@ Defined in: [conversation/journal.ts:58](https://github.com/tangle-network/agent
 
 > **loadRun**(`runId`): `Promise`\<[`ConversationJournalEntry`](#conversationjournalentry) \| `undefined`\>
 
-Defined in: [conversation/journal.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L61)
+Defined in: [conversation/journal.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L62)
 
 Load any prior state for `runId`. Returns `undefined` for a fresh run.
 Implementations MUST NOT mutate the returned object — the runner clones
@@ -372,7 +372,7 @@ identically, so a journal with zero turns is equivalent to "fresh."
 
 > **beginRun**(`runId`, `startedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L74)
+Defined in: [conversation/journal.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L75)
 
 Initialise journal state for a fresh run. Called once per run, before any
 `appendTurn`. Idempotent: calling with an existing runId is a no-op if
@@ -400,7 +400,7 @@ the entry already exists with the same `startedAt`.
 
 > **appendTurn**(`runId`, `turn`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L87)
+Defined in: [conversation/journal.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L88)
 
 Append a committed turn. The runner only calls this AFTER the turn's
 backend stream completed and the credit total has been updated, so an
@@ -428,7 +428,7 @@ appended turn is observed-committed and never speculative.
 
 > **recordHalt**(`runId`, `halt`, `endedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L102)
+Defined in: [conversation/journal.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L103)
 
 Record the run's terminal halt reason + end time. Once called, the run
 is observed-final; subsequent `loadRun` returns the same halt.
@@ -459,7 +459,7 @@ is observed-final; subsequent `loadRun` returns the same halt.
 
 ### FileConversationJournal
 
-Defined in: [conversation/journal.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L122)
+Defined in: [conversation/journal.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L123)
 
 JSONL on disk. One line per record; first line is the `begin`, subsequent
 lines are `turn` records, terminal line is `halt`. Replays the whole file
@@ -480,7 +480,7 @@ process crash between writes never loses an acknowledged turn.
 
 > **new FileConversationJournal**(`path`): [`FileConversationJournal`](#fileconversationjournal)
 
-Defined in: [conversation/journal.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L123)
+Defined in: [conversation/journal.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L124)
 
 ###### Parameters
 
@@ -498,7 +498,7 @@ Defined in: [conversation/journal.ts:123](https://github.com/tangle-network/agen
 
 > **loadRun**(`runId`): `Promise`\<[`ConversationJournalEntry`](#conversationjournalentry) \| `undefined`\>
 
-Defined in: [conversation/journal.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L125)
+Defined in: [conversation/journal.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L126)
 
 Load any prior state for `runId`. Returns `undefined` for a fresh run.
 Implementations MUST NOT mutate the returned object — the runner clones
@@ -523,7 +523,7 @@ identically, so a journal with zero turns is equivalent to "fresh."
 
 > **beginRun**(`runId`, `startedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L161)
+Defined in: [conversation/journal.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L162)
 
 Initialise journal state for a fresh run. Called once per run, before any
 `appendTurn`. Idempotent: calling with an existing runId is a no-op if
@@ -551,7 +551,7 @@ the entry already exists with the same `startedAt`.
 
 > **appendTurn**(`runId`, `turn`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L174)
+Defined in: [conversation/journal.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L175)
 
 Append a committed turn. The runner only calls this AFTER the turn's
 backend stream completed and the credit total has been updated, so an
@@ -579,7 +579,7 @@ appended turn is observed-committed and never speculative.
 
 > **recordHalt**(`runId`, `halt`, `endedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L178)
+Defined in: [conversation/journal.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L179)
 
 Record the run's terminal halt reason + end time. Once called, the run
 is observed-final; subsequent `loadRun` returns the same halt.
@@ -610,15 +610,15 @@ is observed-final; subsequent `loadRun` returns the same halt.
 
 ### BackendTransportError
 
-Defined in: [errors.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L65)
-
-#### Stable
+Defined in: [errors.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L68)
 
 A backend transport call (HTTP, gRPC, sidecar IPC) failed with a non-success
 status. Distinct from `JudgeError` (which is structural / unrecoverable)
 because backend failures are sometimes retryable and consumers may want to
 branch on the upstream status code.
 
+#### Stable
+
 #### Extends
 
 - `AgentEvalError`
@@ -629,7 +629,7 @@ branch on the upstream status code.
 
 > **new BackendTransportError**(`backend`, `message`, `options?`): [`BackendTransportError`](#backendtransporterror)
 
-Defined in: [errors.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L76)
+Defined in: [errors.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L79)
 
 ###### Parameters
 
@@ -669,19 +669,19 @@ Defined in: [errors.ts:76](https://github.com/tangle-network/agent-runtime/blob/
 
 > `readonly` **backend**: `string`
 
-Defined in: [errors.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L66)
+Defined in: [errors.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L69)
 
 ##### status?
 
 > `readonly` `optional` **status?**: `number`
 
-Defined in: [errors.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L67)
+Defined in: [errors.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L70)
 
 ##### body?
 
 > `readonly` `optional` **body?**: `string`
 
-Defined in: [errors.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L74)
+Defined in: [errors.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L77)
 
 Truncated upstream response body (≤2 KiB) when available. Diagnostic
 only — surfaces in `backend_error.error.body` and `final.error.body`
@@ -692,13 +692,13 @@ cracking the log line open.
 
 ### RuntimeRunStateError
 
-Defined in: [errors.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L94)
-
-#### Stable
+Defined in: [errors.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L98)
 
 A runtime-run lifecycle method was called in an order the state machine does
 not allow: `persist()` before `complete()`, `complete()` twice, etc.
 
+#### Stable
+
 #### Extends
 
 - `AgentEvalError`
@@ -709,7 +709,7 @@ not allow: `persist()` before `complete()`, `complete()` twice, etc.
 
 > **new RuntimeRunStateError**(`message`, `options?`): [`RuntimeRunStateError`](#runtimerunstateerror)
 
-Defined in: [errors.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L95)
+Defined in: [errors.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L99)
 
 ###### Parameters
 
@@ -735,9 +735,7 @@ Defined in: [errors.ts:95](https://github.com/tangle-network/agent-runtime/blob/
 
 ### PlannerError
 
-Defined in: [errors.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L111)
-
-#### Stable
+Defined in: [errors.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L116)
 
 The dynamic-loop planner returned an unusable topology move — the LLM emitted
 no parseable envelope, an unknown `kind`, or a structurally-invalid move
@@ -747,6 +745,8 @@ cannot drive the kernel. Carries `validation` so cross-package handlers can
 pattern-match without importing the runtime. Fail loud — never substitute a
 default move, or the loop silently runs a topology nobody chose.
 
+#### Stable
+
 #### Extends
 
 - `AgentEvalError`
@@ -757,7 +757,7 @@ default move, or the loop silently runs a topology nobody chose.
 
 > **new PlannerError**(`message`, `options?`): [`PlannerError`](#plannererror)
 
-Defined in: [errors.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L112)
+Defined in: [errors.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/errors.ts#L117)
 
 ###### Parameters
 
@@ -783,7 +783,7 @@ Defined in: [errors.ts:112](https://github.com/tangle-network/agent-runtime/blob
 
 ### InMemoryRuntimeSessionStore
 
-Defined in: [sessions.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L40)
+Defined in: [sessions.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L41)
 
 #### Stable
 
@@ -807,7 +807,7 @@ Defined in: [sessions.ts:40](https://github.com/tangle-network/agent-runtime/blo
 
 > **get**(`sessionId`): `RuntimeSession` \| `undefined`
 
-Defined in: [sessions.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L44)
+Defined in: [sessions.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L45)
 
 ###### Parameters
 
@@ -827,7 +827,7 @@ Defined in: [sessions.ts:44](https://github.com/tangle-network/agent-runtime/blo
 
 > **put**(`session`): `void`
 
-Defined in: [sessions.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L48)
+Defined in: [sessions.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L49)
 
 ###### Parameters
 
@@ -847,7 +847,7 @@ Defined in: [sessions.ts:48](https://github.com/tangle-network/agent-runtime/blo
 
 > **appendEvent**(`sessionId`, `event`): `void`
 
-Defined in: [sessions.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L52)
+Defined in: [sessions.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L53)
 
 ###### Parameters
 
@@ -871,7 +871,7 @@ Defined in: [sessions.ts:52](https://github.com/tangle-network/agent-runtime/blo
 
 > **listEvents**(`sessionId`): [`RuntimeStreamEvent`](#runtimestreamevent)[]
 
-Defined in: [sessions.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L58)
+Defined in: [sessions.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/sessions.ts#L59)
 
 ###### Parameters
 
@@ -891,7 +891,7 @@ Defined in: [sessions.ts:58](https://github.com/tangle-network/agent-runtime/blo
 
 ### CircuitBreakerConfig
 
-Defined in: [conversation/call-policy.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L23)
+Defined in: [conversation/call-policy.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L24)
 
 Circuit-breaker tuning. `failuresToOpen` consecutive failures opens it; closed only after `cooldownMs`.
 
@@ -901,19 +901,19 @@ Circuit-breaker tuning. `failuresToOpen` consecutive failures opens it; closed o
 
 > **failuresToOpen**: `number`
 
-Defined in: [conversation/call-policy.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L24)
+Defined in: [conversation/call-policy.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L25)
 
 ##### cooldownMs
 
 > **cooldownMs**: `number`
 
-Defined in: [conversation/call-policy.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L25)
+Defined in: [conversation/call-policy.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L26)
 
 ***
 
 ### BackendCallPolicy
 
-Defined in: [conversation/call-policy.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L28)
+Defined in: [conversation/call-policy.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L29)
 
 #### Properties
 
@@ -921,7 +921,7 @@ Defined in: [conversation/call-policy.ts:28](https://github.com/tangle-network/a
 
 > `optional` **perAttemptDeadlineMs?**: `number`
 
-Defined in: [conversation/call-policy.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L30)
+Defined in: [conversation/call-policy.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L31)
 
 Per-attempt wall clock limit. Exceeding fires an AbortSignal and is treated as a retryable failure.
 
@@ -929,7 +929,7 @@ Per-attempt wall clock limit. Exceeding fires an AbortSignal and is treated as a
 
 > `optional` **maxRetries?**: `number`
 
-Defined in: [conversation/call-policy.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L32)
+Defined in: [conversation/call-policy.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L33)
 
 Number of retries after the first attempt; total attempts = 1 + maxRetries. Default 0.
 
@@ -937,7 +937,7 @@ Number of retries after the first attempt; total attempts = 1 + maxRetries. Defa
 
 > `optional` **retryBackoffMs?**: [`RetryBackoff`](#retrybackoff)
 
-Defined in: [conversation/call-policy.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L34)
+Defined in: [conversation/call-policy.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L35)
 
 Backoff between attempts. Default 250ms with jitter.
 
@@ -945,7 +945,7 @@ Backoff between attempts. Default 250ms with jitter.
 
 > `optional` **isRetryable?**: [`RetryableErrorPredicate`](#retryableerrorpredicate)
 
-Defined in: [conversation/call-policy.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L36)
+Defined in: [conversation/call-policy.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L37)
 
 Custom retry classifier. Defaults to [defaultIsRetryable](#defaultisretryable).
 
@@ -953,7 +953,7 @@ Custom retry classifier. Defaults to [defaultIsRetryable](#defaultisretryable).
 
 > `optional` **circuitBreaker?**: [`CircuitBreakerConfig`](#circuitbreakerconfig)
 
-Defined in: [conversation/call-policy.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L38)
+Defined in: [conversation/call-policy.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L39)
 
 Circuit breaker that opens after N consecutive failures per participant.
 
@@ -961,7 +961,7 @@ Circuit breaker that opens after N consecutive failures per participant.
 
 ### SqlAdapter
 
-Defined in: [conversation/journal-sql.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L48)
+Defined in: [conversation/journal-sql.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L49)
 
 Minimal SQL driver shape. Implementations forward to whichever client the
 deployment already uses; agent-runtime takes no opinion on which.
@@ -975,7 +975,7 @@ file header accept this convention.
 
 > **exec**(`sql`, `params?`): `Promise`\<\{ `rowsAffected`: `number`; \}\>
 
-Defined in: [conversation/journal-sql.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L50)
+Defined in: [conversation/journal-sql.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L51)
 
 Execute a write statement (INSERT/UPDATE/DELETE/DDL).
 
@@ -997,7 +997,7 @@ readonly `unknown`[]
 
 > **query**\<`TRow`\>(`sql`, `params?`): `Promise`\<`TRow`[]\>
 
-Defined in: [conversation/journal-sql.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L52)
+Defined in: [conversation/journal-sql.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L53)
 
 Execute a read statement (SELECT). Returns rows as plain objects.
 
@@ -1025,7 +1025,7 @@ readonly `unknown`[]
 
 ### D1DatabaseLike
 
-Defined in: [conversation/journal-sql.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L83)
+Defined in: [conversation/journal-sql.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L84)
 
 Structural type matching the surface of `D1Database` we depend on, so the
 SDK never imports `@cloudflare/workers-types`. Consumers pass their real
@@ -1037,7 +1037,7 @@ SDK never imports `@cloudflare/workers-types`. Consumers pass their real
 
 > **prepare**(`sql`): [`D1StmtLike`](#d1stmtlike)
 
-Defined in: [conversation/journal-sql.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L84)
+Defined in: [conversation/journal-sql.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L85)
 
 ###### Parameters
 
@@ -1053,7 +1053,7 @@ Defined in: [conversation/journal-sql.ts:84](https://github.com/tangle-network/a
 
 ### D1StmtLike
 
-Defined in: [conversation/journal-sql.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L86)
+Defined in: [conversation/journal-sql.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L87)
 
 #### Methods
 
@@ -1061,7 +1061,7 @@ Defined in: [conversation/journal-sql.ts:86](https://github.com/tangle-network/a
 
 > **bind**(...`params`): [`D1StmtLike`](#d1stmtlike)
 
-Defined in: [conversation/journal-sql.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L87)
+Defined in: [conversation/journal-sql.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L88)
 
 ###### Parameters
 
@@ -1077,7 +1077,7 @@ Defined in: [conversation/journal-sql.ts:87](https://github.com/tangle-network/a
 
 > **run**(): `Promise`\<`unknown`\>
 
-Defined in: [conversation/journal-sql.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L88)
+Defined in: [conversation/journal-sql.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L89)
 
 ###### Returns
 
@@ -1087,7 +1087,7 @@ Defined in: [conversation/journal-sql.ts:88](https://github.com/tangle-network/a
 
 > **all**\<`TRow`\>(): `Promise`\<\{ `results?`: `TRow`[]; \}\>
 
-Defined in: [conversation/journal-sql.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L89)
+Defined in: [conversation/journal-sql.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L90)
 
 ###### Type Parameters
 
@@ -1103,7 +1103,7 @@ Defined in: [conversation/journal-sql.ts:89](https://github.com/tangle-network/a
 
 ### ConversationJournalEntry
 
-Defined in: [conversation/journal.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L19)
+Defined in: [conversation/journal.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L20)
 
 #### Properties
 
@@ -1111,19 +1111,19 @@ Defined in: [conversation/journal.ts:19](https://github.com/tangle-network/agent
 
 > **runId**: `string`
 
-Defined in: [conversation/journal.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L20)
+Defined in: [conversation/journal.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L21)
 
 ##### startedAt
 
 > **startedAt**: `string`
 
-Defined in: [conversation/journal.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L21)
+Defined in: [conversation/journal.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L22)
 
 ##### halted?
 
 > `optional` **halted?**: [`HaltReason`](#haltreason)
 
-Defined in: [conversation/journal.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L23)
+Defined in: [conversation/journal.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L24)
 
 Set when the run reaches a terminal state.
 
@@ -1131,19 +1131,19 @@ Set when the run reaches a terminal state.
 
 > `optional` **endedAt?**: `string`
 
-Defined in: [conversation/journal.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L24)
+Defined in: [conversation/journal.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L25)
 
 ##### turns
 
 > **turns**: [`ConversationTurn`](#conversationturn)[]
 
-Defined in: [conversation/journal.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L25)
+Defined in: [conversation/journal.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L26)
 
 ***
 
 ### ConversationJournal
 
-Defined in: [conversation/journal.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L28)
+Defined in: [conversation/journal.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L29)
 
 #### Methods
 
@@ -1151,7 +1151,7 @@ Defined in: [conversation/journal.ts:28](https://github.com/tangle-network/agent
 
 > **loadRun**(`runId`): `Promise`\<[`ConversationJournalEntry`](#conversationjournalentry) \| `undefined`\>
 
-Defined in: [conversation/journal.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L35)
+Defined in: [conversation/journal.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L36)
 
 Load any prior state for `runId`. Returns `undefined` for a fresh run.
 Implementations MUST NOT mutate the returned object — the runner clones
@@ -1172,7 +1172,7 @@ identically, so a journal with zero turns is equivalent to "fresh."
 
 > **beginRun**(`runId`, `startedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L42)
+Defined in: [conversation/journal.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L43)
 
 Initialise journal state for a fresh run. Called once per run, before any
 `appendTurn`. Idempotent: calling with an existing runId is a no-op if
@@ -1196,7 +1196,7 @@ the entry already exists with the same `startedAt`.
 
 > **appendTurn**(`runId`, `turn`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L49)
+Defined in: [conversation/journal.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L50)
 
 Append a committed turn. The runner only calls this AFTER the turn's
 backend stream completed and the credit total has been updated, so an
@@ -1220,7 +1220,7 @@ appended turn is observed-committed and never speculative.
 
 > **recordHalt**(`runId`, `halt`, `endedAt`): `Promise`\<`void`\>
 
-Defined in: [conversation/journal.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L55)
+Defined in: [conversation/journal.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal.ts#L56)
 
 Record the run's terminal halt reason + end time. Once called, the run
 is observed-final; subsequent `loadRun` returns the same halt.
@@ -1536,7 +1536,7 @@ Defined in: [conversation/run-persona.ts:210](https://github.com/tangle-network/
 
 ### ConversationParticipant
 
-Defined in: [conversation/types.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L20)
+Defined in: [conversation/types.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L21)
 
 #### Stable
 
@@ -1546,7 +1546,7 @@ Defined in: [conversation/types.ts:20](https://github.com/tangle-network/agent-r
 
 > **name**: `string`
 
-Defined in: [conversation/types.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L25)
+Defined in: [conversation/types.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L26)
 
 Stable name used as the speaker label in the transcript. Must be unique
 within a `Conversation`.
@@ -1555,7 +1555,7 @@ within a `Conversation`.
 
 > **backend**: [`AgentExecutionBackend`](#agentexecutionbackend)
 
-Defined in: [conversation/types.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L32)
+Defined in: [conversation/types.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L33)
 
 Backend that runs this participant's turn. Reuses the existing
 `AgentExecutionBackend` contract from `runAgentTaskStream`, so any
@@ -1566,7 +1566,7 @@ adaptation.
 
 > `optional` **label?**: `string`
 
-Defined in: [conversation/types.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L37)
+Defined in: [conversation/types.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L38)
 
 Optional human label for traces / dashboards. Distinct from `name`, which
 is the addressing key.
@@ -1575,7 +1575,7 @@ is the addressing key.
 
 > `optional` **callPolicy?**: [`BackendCallPolicy`](#backendcallpolicy)
 
-Defined in: [conversation/types.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L43)
+Defined in: [conversation/types.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L44)
 
 Optional per-participant override of the conversation's default
 `callPolicy`. Use to tighten the deadline or raise the retry budget for
@@ -1585,7 +1585,7 @@ a participant known to be slow or flaky.
 
 > `optional` **authSource?**: [`AuthSource`](#authsource-1)
 
-Defined in: [conversation/types.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L63)
+Defined in: [conversation/types.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L64)
 
 Who pays for THIS participant's outbound calls?
 
@@ -1609,7 +1609,7 @@ purely about *whether to also forward the user's identity downstream*.
 
 ### ConversationDriveState
 
-Defined in: [conversation/types.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L76)
+Defined in: [conversation/types.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L77)
 
 #### Stable
 
@@ -1623,25 +1623,25 @@ Defined in: [conversation/types.ts:76](https://github.com/tangle-network/agent-r
 
 > **transcript**: readonly [`ConversationTurn`](#conversationturn)[]
 
-Defined in: [conversation/types.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L77)
+Defined in: [conversation/types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L78)
 
 ##### turnIndex
 
 > **turnIndex**: `number`
 
-Defined in: [conversation/types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L78)
+Defined in: [conversation/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L79)
 
 ##### spentCreditsCents
 
 > **spentCreditsCents**: `number`
 
-Defined in: [conversation/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L79)
+Defined in: [conversation/types.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L80)
 
 ***
 
 ### HaltContext
 
-Defined in: [conversation/types.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L83)
+Defined in: [conversation/types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L84)
 
 #### Stable
 
@@ -1655,7 +1655,7 @@ Defined in: [conversation/types.ts:83](https://github.com/tangle-network/agent-r
 
 > **transcript**: readonly [`ConversationTurn`](#conversationturn)[]
 
-Defined in: [conversation/types.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L77)
+Defined in: [conversation/types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L78)
 
 ###### Inherited from
 
@@ -1665,7 +1665,7 @@ Defined in: [conversation/types.ts:77](https://github.com/tangle-network/agent-r
 
 > **turnIndex**: `number`
 
-Defined in: [conversation/types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L78)
+Defined in: [conversation/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L79)
 
 ###### Inherited from
 
@@ -1675,7 +1675,7 @@ Defined in: [conversation/types.ts:78](https://github.com/tangle-network/agent-r
 
 > **spentCreditsCents**: `number`
 
-Defined in: [conversation/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L79)
+Defined in: [conversation/types.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L80)
 
 ###### Inherited from
 
@@ -1685,13 +1685,13 @@ Defined in: [conversation/types.ts:79](https://github.com/tangle-network/agent-r
 
 > **lastTurn**: [`ConversationTurn`](#conversationturn)
 
-Defined in: [conversation/types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L84)
+Defined in: [conversation/types.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L85)
 
 ***
 
 ### HaltSignal
 
-Defined in: [conversation/types.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L88)
+Defined in: [conversation/types.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L89)
 
 #### Stable
 
@@ -1701,19 +1701,19 @@ Defined in: [conversation/types.ts:88](https://github.com/tangle-network/agent-r
 
 > **halted**: `true`
 
-Defined in: [conversation/types.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L89)
+Defined in: [conversation/types.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L90)
 
 ##### reason
 
 > **reason**: `string`
 
-Defined in: [conversation/types.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L90)
+Defined in: [conversation/types.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L91)
 
 ***
 
 ### ConversationPolicy
 
-Defined in: [conversation/types.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L107)
+Defined in: [conversation/types.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L108)
 
 #### Stable
 
@@ -1723,7 +1723,7 @@ Defined in: [conversation/types.ts:107](https://github.com/tangle-network/agent-
 
 > **maxTurns**: `number`
 
-Defined in: [conversation/types.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L109)
+Defined in: [conversation/types.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L110)
 
 Hard cap on speaker-turns. Each call into a participant's backend counts as 1.
 
@@ -1731,7 +1731,7 @@ Hard cap on speaker-turns. Each call into a participant's backend counts as 1.
 
 > `optional` **maxCreditsCents?**: `number`
 
-Defined in: [conversation/types.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L116)
+Defined in: [conversation/types.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L117)
 
 Hard cap on aggregate credit spend across all participants, in cents.
 Computed by summing `llm_call.costUsd` from every participant's stream.
@@ -1742,7 +1742,7 @@ Unset (`undefined`) means no credit ceiling — the run is bounded only by
 
 > `optional` **turnOrder?**: [`TurnOrder`](#turnorder)
 
-Defined in: [conversation/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L121)
+Defined in: [conversation/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L122)
 
 Speaker selection. Defaults to `'alternate'` for two-participant
 conversations and `'round-robin'` for any other arity.
@@ -1751,7 +1751,7 @@ conversations and `'round-robin'` for any other arity.
 
 > `optional` **haltOn?**: [`HaltPredicate`](#haltpredicate)
 
-Defined in: [conversation/types.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L126)
+Defined in: [conversation/types.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L127)
 
 Optional convergence / content-based halt. Called after every turn ends;
 returning truthy stops the loop with `{ kind: 'predicate', ... }`.
@@ -1760,7 +1760,7 @@ returning truthy stops the loop with `{ kind: 'predicate', ... }`.
 
 > `optional` **defaultCallPolicy?**: [`BackendCallPolicy`](#backendcallpolicy)
 
-Defined in: [conversation/types.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L132)
+Defined in: [conversation/types.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L133)
 
 Default per-turn resilience policy applied to every participant call
 (deadline, retries, circuit breaker). Individual participants may
@@ -1770,7 +1770,7 @@ override via `ConversationParticipant.callPolicy`.
 
 ### ConversationTurn
 
-Defined in: [conversation/types.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L136)
+Defined in: [conversation/types.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L137)
 
 #### Stable
 
@@ -1780,19 +1780,19 @@ Defined in: [conversation/types.ts:136](https://github.com/tangle-network/agent-
 
 > **index**: `number`
 
-Defined in: [conversation/types.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L137)
+Defined in: [conversation/types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L138)
 
 ##### speaker
 
 > **speaker**: `string`
 
-Defined in: [conversation/types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L138)
+Defined in: [conversation/types.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L139)
 
 ##### turnId
 
 > **turnId**: `string`
 
-Defined in: [conversation/types.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L144)
+Defined in: [conversation/types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L145)
 
 Deterministic turn identifier — stable across retries of the same logical
 turn so caching gateways and trace backends can dedupe. Shape:
@@ -1802,13 +1802,13 @@ turn so caching gateways and trace backends can dedupe. Shape:
 
 > **text**: `string`
 
-Defined in: [conversation/types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L145)
+Defined in: [conversation/types.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L146)
 
 ##### usage?
 
 > `optional` **usage?**: `object`
 
-Defined in: [conversation/types.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L151)
+Defined in: [conversation/types.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L152)
 
 Aggregated backend usage for this turn alone. Populated from any
 `llm_call` stream events the backend emitted; `undefined` when the
@@ -1838,7 +1838,7 @@ backend reports no usage.
 
 > **attempts**: `number`
 
-Defined in: [conversation/types.ts:163](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L163)
+Defined in: [conversation/types.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L164)
 
 Number of attempts that ran before this turn committed. `1` is the
 common case; higher means the call policy retried after transient
@@ -1848,19 +1848,19 @@ failures.
 
 > **startedAt**: `string`
 
-Defined in: [conversation/types.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L164)
+Defined in: [conversation/types.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L165)
 
 ##### endedAt
 
 > **endedAt**: `string`
 
-Defined in: [conversation/types.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L165)
+Defined in: [conversation/types.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L166)
 
 ***
 
 ### Conversation
 
-Defined in: [conversation/types.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L169)
+Defined in: [conversation/types.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L170)
 
 #### Stable
 
@@ -1870,19 +1870,19 @@ Defined in: [conversation/types.ts:169](https://github.com/tangle-network/agent-
 
 > **participants**: readonly [`ConversationParticipant`](#conversationparticipant)[]
 
-Defined in: [conversation/types.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L170)
+Defined in: [conversation/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L171)
 
 ##### policy
 
 > **policy**: [`ConversationPolicy`](#conversationpolicy)
 
-Defined in: [conversation/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L171)
+Defined in: [conversation/types.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L172)
 
 ***
 
 ### RunConversationOptions
 
-Defined in: [conversation/types.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L175)
+Defined in: [conversation/types.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L176)
 
 #### Stable
 
@@ -1892,7 +1892,7 @@ Defined in: [conversation/types.ts:175](https://github.com/tangle-network/agent-
 
 > **seed**: `string`
 
-Defined in: [conversation/types.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L177)
+Defined in: [conversation/types.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L178)
 
 First message kicking off the conversation. Routes to the first speaker.
 
@@ -1900,7 +1900,7 @@ First message kicking off the conversation. Routes to the first speaker.
 
 > `optional` **runId?**: `string`
 
-Defined in: [conversation/types.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L184)
+Defined in: [conversation/types.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L185)
 
 Optional run identifier for cross-participant trace correlation. Auto-
 generated when omitted. Reusing a runId against the same `journal`
@@ -1911,7 +1911,7 @@ continues from the first un-recorded turn.
 
 > `optional` **signal?**: `AbortSignal`
 
-Defined in: [conversation/types.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L186)
+Defined in: [conversation/types.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L187)
 
 Cancellation signal — aborts mid-stream and halts with `{ kind: 'abort' }`.
 
@@ -1919,7 +1919,7 @@ Cancellation signal — aborts mid-stream and halts with `{ kind: 'abort' }`.
 
 > `optional` **onEvent?**: (`event`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [conversation/types.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L193)
+Defined in: [conversation/types.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L194)
 
 Event sink for per-turn micro-events. Distinct from the result transcript:
 the sink fires for every text-delta, every turn-start/end, and the
@@ -1940,7 +1940,7 @@ without waiting for the conversation to finish.
 
 > `optional` **journal?**: [`ConversationJournal`](#conversationjournal)
 
-Defined in: [conversation/types.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L200)
+Defined in: [conversation/types.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L201)
 
 Optional durable transcript. When set, the runner persists every
 committed turn before yielding `turn_end`. Reusing the same `runId`
@@ -1951,7 +1951,7 @@ driver process crash mid-run loses zero acknowledged turns.
 
 > `optional` **propagatedHeaders?**: `Readonly`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [conversation/types.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L207)
+Defined in: [conversation/types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L208)
 
 Headers to forward verbatim to every participant backend call (gateway
 propagation: `X-Tangle-Forwarded-Authorization`, run/turn correlation,
@@ -1962,7 +1962,7 @@ their `AgentBackendContext`; backends that ignore the field still work.
 
 > `optional` **inboundDepth?**: `number`
 
-Defined in: [conversation/types.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L213)
+Defined in: [conversation/types.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L214)
 
 Inbound depth at the point this driver was invoked. The runner
 increments it on every outbound participant call; gateways refuse at
@@ -1972,7 +1972,7 @@ increments it on every outbound participant call; gateways refuse at
 
 > `optional` **parentTurnId?**: `string`
 
-Defined in: [conversation/types.ts:220](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L220)
+Defined in: [conversation/types.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L221)
 
 Parent turn id when this conversation is *inside* another turn (i.e. the
 driver is itself a participant via `createConversationBackend`). The
@@ -1983,7 +1983,7 @@ so trace stitching survives nested orchestration.
 
 ### ConversationResult
 
-Defined in: [conversation/types.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L224)
+Defined in: [conversation/types.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L225)
 
 #### Stable
 
@@ -1993,49 +1993,49 @@ Defined in: [conversation/types.ts:224](https://github.com/tangle-network/agent-
 
 > **runId**: `string`
 
-Defined in: [conversation/types.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L225)
+Defined in: [conversation/types.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L226)
 
 ##### transcript
 
 > **transcript**: [`ConversationTurn`](#conversationturn)[]
 
-Defined in: [conversation/types.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L226)
+Defined in: [conversation/types.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L227)
 
 ##### turns
 
 > **turns**: `number`
 
-Defined in: [conversation/types.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L227)
+Defined in: [conversation/types.ts:228](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L228)
 
 ##### spentCreditsCents
 
 > **spentCreditsCents**: `number`
 
-Defined in: [conversation/types.ts:228](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L228)
+Defined in: [conversation/types.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L229)
 
 ##### halted
 
 > **halted**: [`HaltReason`](#haltreason)
 
-Defined in: [conversation/types.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L229)
+Defined in: [conversation/types.ts:230](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L230)
 
 ##### durationMs
 
 > **durationMs**: `number`
 
-Defined in: [conversation/types.ts:230](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L230)
+Defined in: [conversation/types.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L231)
 
 ##### startedAt
 
 > **startedAt**: `string`
 
-Defined in: [conversation/types.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L231)
+Defined in: [conversation/types.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L232)
 
 ##### endedAt
 
 > **endedAt**: `string`
 
-Defined in: [conversation/types.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L232)
+Defined in: [conversation/types.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L233)
 
 ***
 
@@ -2387,7 +2387,7 @@ Content type for the response.
 
 ### VerifyResult
 
-Defined in: [improvement/agentic-generator.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L41)
+Defined in: [improvement/agentic-generator.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L42)
 
 Outcome of verifying a candidate worktree. `feedback` (compiler errors,
  failing test output) is fed into the next shot when `ok` is false.
@@ -2398,19 +2398,19 @@ Outcome of verifying a candidate worktree. `feedback` (compiler errors,
 
 > **ok**: `boolean`
 
-Defined in: [improvement/agentic-generator.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L42)
+Defined in: [improvement/agentic-generator.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L43)
 
 ##### feedback?
 
 > `optional` **feedback?**: `string`
 
-Defined in: [improvement/agentic-generator.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L43)
+Defined in: [improvement/agentic-generator.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L44)
 
 ***
 
 ### AgenticGeneratorOptions
 
-Defined in: [improvement/agentic-generator.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L51)
+Defined in: [improvement/agentic-generator.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L52)
 
 `@tangle-network/agent-runtime` improvement — the CODE-surface proposer for
 agent-eval's improvement loop.
@@ -2431,7 +2431,7 @@ mutates a git worktree via a pluggable `CandidateGenerator`:
 
 > `optional` **harness?**: [`LocalHarness`](mcp.md#localharness)
 
-Defined in: [improvement/agentic-generator.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L53)
+Defined in: [improvement/agentic-generator.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L54)
 
 Local coding harness to run in the worktree. Default `claude`.
 
@@ -2439,7 +2439,7 @@ Local coding harness to run in the worktree. Default `claude`.
 
 > `optional` **timeoutMs?**: `number`
 
-Defined in: [improvement/agentic-generator.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L55)
+Defined in: [improvement/agentic-generator.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L56)
 
 Per-shot wall-clock timeout (ms). Default = `runLocalHarness` default (5m).
 
@@ -2447,7 +2447,7 @@ Per-shot wall-clock timeout (ms). Default = `runLocalHarness` default (5m).
 
 > `optional` **buildPrompt?**: (`args`) => `string`
 
-Defined in: [improvement/agentic-generator.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L58)
+Defined in: [improvement/agentic-generator.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L59)
 
 Build the harness task prompt from the report + findings. Override for
  domain phrasing; the default turns findings into a concrete coder task.
@@ -2472,7 +2472,7 @@ Build the harness task prompt from the report + findings. Override for
 
 > `optional` **verify?**: [`Verifier`](#verifier)
 
-Defined in: [improvement/agentic-generator.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L64)
+Defined in: [improvement/agentic-generator.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L65)
 
 Verify the worktree after each dirtying shot. When set, a candidate that
  fails verification is NOT returned — the failure feeds the next shot
@@ -2484,7 +2484,7 @@ Verify the worktree after each dirtying shot. When set, a candidate that
 
 > `optional` **runHarness?**: (`options`) => `Promise`\<[`LocalHarnessResult`](mcp.md#localharnessresult)\>
 
-Defined in: [improvement/agentic-generator.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L66)
+Defined in: [improvement/agentic-generator.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L67)
 
 Test seam — inject the harness runner (defaults to `runLocalHarness`).
 
@@ -2520,7 +2520,7 @@ Does NOT throw when:
 
 > `optional` **isDirty?**: (`worktreePath`) => `boolean`
 
-Defined in: [improvement/agentic-generator.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L68)
+Defined in: [improvement/agentic-generator.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L69)
 
 Test seam — inject the worktree-dirty check (defaults to `git status`).
 
@@ -2538,7 +2538,7 @@ Test seam — inject the worktree-dirty check (defaults to `git status`).
 
 ### ImproveOptions
 
-Defined in: [improvement/improve.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L47)
+Defined in: [improvement/improve.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L48)
 
 #### Type Parameters
 
@@ -2556,7 +2556,7 @@ Defined in: [improvement/improve.ts:47](https://github.com/tangle-network/agent-
 
 > `optional` **surface?**: [`ImproveSurface`](#improvesurface)
 
-Defined in: [improvement/improve.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L50)
+Defined in: [improvement/improve.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L51)
 
 Which profile lever to optimize. Default `'prompt'`. Selects the default
  generator + the baseline-surface extraction shape.
@@ -2565,7 +2565,7 @@ Which profile lever to optimize. Default `'prompt'`. Selects the default
 
 > `optional` **generator?**: `SurfaceProposer`\<`unknown`\>
 
-Defined in: [improvement/improve.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L54)
+Defined in: [improvement/improve.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L55)
 
 The `SurfaceProposer` that mutates the surface. When unset, the facade
  picks the default for `surface` (`gepaProposer` for prompt, `skillOptProposer`
@@ -2575,7 +2575,7 @@ The `SurfaceProposer` that mutates the surface. When unset, the facade
 
 > `optional` **gate?**: `"none"` \| `"holdout"`
 
-Defined in: [improvement/improve.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L57)
+Defined in: [improvement/improve.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L58)
 
 Gate mode. `'holdout'` (default) runs the held-out promotion gate;
  `'none'` is a baseline-only run (`budget.generations = 0`).
@@ -2584,7 +2584,7 @@ Gate mode. `'holdout'` (default) runs the held-out promotion gate;
 
 > **scenarios**: `TScenario`[]
 
-Defined in: [improvement/improve.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L59)
+Defined in: [improvement/improve.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L60)
 
 Scenarios to evaluate against. Passthrough to `selfImprove`.
 
@@ -2592,7 +2592,7 @@ Scenarios to evaluate against. Passthrough to `selfImprove`.
 
 > **judge**: `JudgeConfig`\<`TArtifact`, `TScenario`\>
 
-Defined in: [improvement/improve.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L61)
+Defined in: [improvement/improve.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L62)
 
 Judge that scores artifacts. Passthrough to `selfImprove`.
 
@@ -2600,7 +2600,7 @@ Judge that scores artifacts. Passthrough to `selfImprove`.
 
 > **agent**: (`surface`, `scenario`, `ctx`) => `Promise`\<`TArtifact`\>
 
-Defined in: [improvement/improve.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L64)
+Defined in: [improvement/improve.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L65)
 
 The agent under improvement — same shape as `selfImprove.agent`: it takes
  the current surface + scenario + ctx and returns the artifact to judge.
@@ -2627,7 +2627,7 @@ The agent under improvement — same shape as `selfImprove.agent`: it takes
 
 > `optional` **budget?**: `SelfImproveBudget`
 
-Defined in: [improvement/improve.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L66)
+Defined in: [improvement/improve.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L67)
 
 Budget + loop shape. Passthrough; `gate: 'none'` forces `generations = 0`.
 
@@ -2635,7 +2635,7 @@ Budget + loop shape. Passthrough; `gate: 'none'` forces `generations = 0`.
 
 > `optional` **llm?**: `SelfImproveLlm`
 
-Defined in: [improvement/improve.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L69)
+Defined in: [improvement/improve.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L70)
 
 LLM config. Passthrough to `selfImprove` AND used to construct the default
  reflective proposer (`gepaProposer`/`skillOptProposer`) when `generator` is unset.
@@ -2644,7 +2644,7 @@ LLM config. Passthrough to `selfImprove` AND used to construct the default
 
 > `optional` **allowedModels?**: readonly `string`[]
 
-Defined in: [improvement/improve.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L73)
+Defined in: [improvement/improve.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L74)
 
 Restrict the run to this subset of models. When set, the reflection model
  (`llm.model`, or the default when unset) must be a member, or `improve()` throws
@@ -2654,7 +2654,7 @@ Restrict the run to this subset of models. When set, the reflection model
 
 ### ImproveResult
 
-Defined in: [improvement/improve.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L76)
+Defined in: [improvement/improve.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L77)
 
 #### Type Parameters
 
@@ -2672,7 +2672,7 @@ Defined in: [improvement/improve.ts:76](https://github.com/tangle-network/agent-
 
 > **profile**: `AgentProfile`
 
-Defined in: [improvement/improve.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L79)
+Defined in: [improvement/improve.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L80)
 
 The profile after improvement: the winner surface applied back into the
  matching field when the gate shipped, else the input profile unchanged.
@@ -2681,7 +2681,7 @@ The profile after improvement: the winner surface applied back into the
 
 > **shipped**: `boolean`
 
-Defined in: [improvement/improve.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L81)
+Defined in: [improvement/improve.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L82)
 
 True when `gateDecision === 'ship'`.
 
@@ -2689,7 +2689,7 @@ True when `gateDecision === 'ship'`.
 
 > **lift**: `number`
 
-Defined in: [improvement/improve.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L83)
+Defined in: [improvement/improve.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L84)
 
 Held-out lift (`winner − baseline` composite).
 
@@ -2697,7 +2697,7 @@ Held-out lift (`winner − baseline` composite).
 
 > **gateDecision**: `"ship"` \| `"hold"` \| `"need_more_work"` \| `"model_ceiling"` \| `"arch_ceiling"`
 
-Defined in: [improvement/improve.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L85)
+Defined in: [improvement/improve.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L86)
 
 The five-valued gate verdict from `selfImprove`.
 
@@ -2705,7 +2705,7 @@ The five-valued gate verdict from `selfImprove`.
 
 > **raw**: `SelfImproveResult`\<`TScenario`, `TArtifact`\>
 
-Defined in: [improvement/improve.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L87)
+Defined in: [improvement/improve.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L88)
 
 Full `selfImprove` result for advanced inspection.
 
@@ -2713,7 +2713,7 @@ Full `selfImprove` result for advanced inspection.
 
 ### CandidateGenerator
 
-Defined in: [improvement/improvement-driver.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L35)
+Defined in: [improvement/improvement-driver.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L36)
 
 The byte-producing seam — the ONE thing that differs between the cheap
  reflective path and the full agentic path. A generator makes (uncommitted)
@@ -2726,7 +2726,7 @@ The byte-producing seam — the ONE thing that differs between the cheap
 
 > **kind**: `string`
 
-Defined in: [improvement/improvement-driver.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L36)
+Defined in: [improvement/improvement-driver.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L37)
 
 #### Methods
 
@@ -2734,7 +2734,7 @@ Defined in: [improvement/improvement-driver.ts:36](https://github.com/tangle-net
 
 > **generate**(`args`): `Promise`\<\{ `applied`: `boolean`; `summary`: `string`; \}\>
 
-Defined in: [improvement/improvement-driver.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L37)
+Defined in: [improvement/improvement-driver.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L38)
 
 ###### Parameters
 
@@ -2783,7 +2783,7 @@ DEPTH: max iterations the generator may take (agentic uses this; the
 
 ### ImprovementDriverOptions
 
-Defined in: [improvement/improvement-driver.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L53)
+Defined in: [improvement/improvement-driver.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L54)
 
 #### Properties
 
@@ -2791,19 +2791,19 @@ Defined in: [improvement/improvement-driver.ts:53](https://github.com/tangle-net
 
 > **worktree**: `WorktreeAdapter`
 
-Defined in: [improvement/improvement-driver.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L54)
+Defined in: [improvement/improvement-driver.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L55)
 
 ##### generator
 
 > **generator**: [`CandidateGenerator`](#candidategenerator)
 
-Defined in: [improvement/improvement-driver.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L55)
+Defined in: [improvement/improvement-driver.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L56)
 
 ##### baseRef?
 
 > `optional` **baseRef?**: `string`
 
-Defined in: [improvement/improvement-driver.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L57)
+Defined in: [improvement/improvement-driver.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L58)
 
 Base ref candidate worktrees fork from. Default `main`.
 
@@ -2857,7 +2857,7 @@ Minimum tools the server must expose to pass. Default 1.
 
 ### ReflectiveGeneratorOptions
 
-Defined in: [improvement/reflective-generator.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/reflective-generator.ts#L20)
+Defined in: [improvement/reflective-generator.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/reflective-generator.ts#L21)
 
 #### Properties
 
@@ -2865,13 +2865,13 @@ Defined in: [improvement/reflective-generator.ts:20](https://github.com/tangle-n
 
 > **improvementAdapter**: [`ImprovementAdapter`](analyst-loop.md#improvementadapter)\<[`SurfaceImprovementEdit`](agent.md#surfaceimprovementedit)\>
 
-Defined in: [improvement/reflective-generator.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/reflective-generator.ts#L21)
+Defined in: [improvement/reflective-generator.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/reflective-generator.ts#L22)
 
 ***
 
 ### DelegatedLoopResult
 
-Defined in: [loop-runner.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L66)
+Defined in: [loop-runner.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L67)
 
 **`Experimental`**
 
@@ -2890,7 +2890,7 @@ Uniform result — never throws from a registered runner; a
 
 > **mode**: `"code"` \| `"review"` \| `"research"` \| `"audit"` \| `"self-improve"`
 
-Defined in: [loop-runner.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L67)
+Defined in: [loop-runner.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L68)
 
 **`Experimental`**
 
@@ -2898,7 +2898,7 @@ Defined in: [loop-runner.ts:67](https://github.com/tangle-network/agent-runtime/
 
 > **ok**: `boolean`
 
-Defined in: [loop-runner.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L68)
+Defined in: [loop-runner.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L69)
 
 **`Experimental`**
 
@@ -2906,7 +2906,7 @@ Defined in: [loop-runner.ts:68](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **output?**: `T`
 
-Defined in: [loop-runner.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L69)
+Defined in: [loop-runner.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L70)
 
 **`Experimental`**
 
@@ -2914,7 +2914,7 @@ Defined in: [loop-runner.ts:69](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **error?**: `string`
 
-Defined in: [loop-runner.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L70)
+Defined in: [loop-runner.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L71)
 
 **`Experimental`**
 
@@ -2922,7 +2922,7 @@ Defined in: [loop-runner.ts:70](https://github.com/tangle-network/agent-runtime/
 
 > **durationMs**: `number`
 
-Defined in: [loop-runner.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L71)
+Defined in: [loop-runner.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L72)
 
 **`Experimental`**
 
@@ -2930,7 +2930,7 @@ Defined in: [loop-runner.ts:71](https://github.com/tangle-network/agent-runtime/
 
 ### RunDelegatedLoopOptions
 
-Defined in: [loop-runner.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L75)
+Defined in: [loop-runner.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L76)
 
 **`Experimental`**
 
@@ -2940,7 +2940,7 @@ Defined in: [loop-runner.ts:75](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **signal?**: `AbortSignal`
 
-Defined in: [loop-runner.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L76)
+Defined in: [loop-runner.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L77)
 
 **`Experimental`**
 
@@ -2948,7 +2948,7 @@ Defined in: [loop-runner.ts:76](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **now?**: () => `number`
 
-Defined in: [loop-runner.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L78)
+Defined in: [loop-runner.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L79)
 
 **`Experimental`**
 
@@ -2962,7 +2962,7 @@ Clock override for deterministic tests.
 
 ### WorktreeLoopRunnerOptions
 
-Defined in: [loop-runner.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L119)
+Defined in: [loop-runner.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L121)
 
 **`Experimental`**
 
@@ -2974,7 +2974,7 @@ Options for the local-repo `code` runner over the GENERIC recursive path.
 
 > **repoRoot**: `string`
 
-Defined in: [loop-runner.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L121)
+Defined in: [loop-runner.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L123)
 
 **`Experimental`**
 
@@ -2984,7 +2984,7 @@ Absolute path to the local git checkout each worktree is cut from.
 
 > **taskPrompt**: `string`
 
-Defined in: [loop-runner.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L123)
+Defined in: [loop-runner.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L125)
 
 **`Experimental`**
 
@@ -2994,7 +2994,7 @@ The instruction handed to every authored harness (composed under each profile's
 
 > **harnesses**: readonly [`AuthoredHarness`](runtime.md#authoredharness)[]
 
-Defined in: [loop-runner.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L125)
+Defined in: [loop-runner.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L127)
 
 **`Experimental`**
 
@@ -3004,7 +3004,7 @@ The supervisor-authored harness profiles — one fanout item (one worktree-CLI l
 
 > **budget**: [`Budget`](runtime.md#budget-12)
 
-Defined in: [loop-runner.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L127)
+Defined in: [loop-runner.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L129)
 
 **`Experimental`**
 
@@ -3014,7 +3014,7 @@ Conserved budget pool bounding the fanout (equal-k holds by construction).
 
 > `optional` **testCmd?**: `string`
 
-Defined in: [loop-runner.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L129)
+Defined in: [loop-runner.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L131)
 
 **`Experimental`**
 
@@ -3024,7 +3024,7 @@ Shell command run in each worktree to derive the tests-PASS signal.
 
 > `optional` **typecheckCmd?**: `string`
 
-Defined in: [loop-runner.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L131)
+Defined in: [loop-runner.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L133)
 
 **`Experimental`**
 
@@ -3034,7 +3034,7 @@ Shell command run in each worktree to derive the typecheck-PASS signal.
 
 > `optional` **require?**: readonly (`"tests"` \| `"typecheck"`)[]
 
-Defined in: [loop-runner.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L133)
+Defined in: [loop-runner.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L135)
 
 **`Experimental`**
 
@@ -3044,7 +3044,7 @@ Which verification signals the deliverable REQUIRES present-and-passing (default
 
 > `optional` **maxDiffLines?**: `number`
 
-Defined in: [loop-runner.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L135)
+Defined in: [loop-runner.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L137)
 
 **`Experimental`**
 
@@ -3054,7 +3054,7 @@ Diff-size cap (lines).
 
 > `optional` **forbiddenPaths?**: `string`[]
 
-Defined in: [loop-runner.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L137)
+Defined in: [loop-runner.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L139)
 
 **`Experimental`**
 
@@ -3064,7 +3064,7 @@ Literal path prefixes the patch must not touch (the secret-floor is always on re
 
 > `optional` **winnerStrategy?**: [`WinnerStrategy`](runtime.md#winnerstrategy)
 
-Defined in: [loop-runner.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L139)
+Defined in: [loop-runner.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L141)
 
 **`Experimental`**
 
@@ -3074,7 +3074,7 @@ Winner-selection strategy among gated candidates. Default `highest-score`.
 
 > `optional` **runGit?**: [`GitRunner`](mcp.md#gitrunner)
 
-Defined in: [loop-runner.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L141)
+Defined in: [loop-runner.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L143)
 
 **`Experimental`**
 
@@ -3084,7 +3084,7 @@ Test seams forwarded to the worktree-CLI leaves so the runner drives offline.
 
 > `optional` **runHarness?**: (`options`) => `Promise`\<[`LocalHarnessResult`](mcp.md#localharnessresult)\>
 
-Defined in: [loop-runner.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L142)
+Defined in: [loop-runner.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L144)
 
 **`Experimental`**
 
@@ -3120,7 +3120,7 @@ Does NOT throw when:
 
 > `optional` **runCommand?**: `WorktreeCheckRunner`
 
-Defined in: [loop-runner.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L143)
+Defined in: [loop-runner.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L145)
 
 **`Experimental`**
 
@@ -3128,7 +3128,7 @@ Defined in: [loop-runner.ts:143](https://github.com/tangle-network/agent-runtime
 
 ### VetoedFact
 
-Defined in: [loop-runner.ts:205](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L205)
+Defined in: [loop-runner.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L208)
 
 **`Experimental`**
 
@@ -3140,7 +3140,7 @@ A fact rejected at the KB gate — surfaced, never dropped.
 
 > **candidate**: [`FactCandidate`](mcp.md#factcandidate)
 
-Defined in: [loop-runner.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L206)
+Defined in: [loop-runner.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L209)
 
 **`Experimental`**
 
@@ -3148,7 +3148,7 @@ Defined in: [loop-runner.ts:206](https://github.com/tangle-network/agent-runtime
 
 > `optional` **vetoedBy?**: `string`
 
-Defined in: [loop-runner.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L207)
+Defined in: [loop-runner.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L210)
 
 **`Experimental`**
 
@@ -3156,7 +3156,7 @@ Defined in: [loop-runner.ts:207](https://github.com/tangle-network/agent-runtime
 
 > `optional` **reason?**: `string`
 
-Defined in: [loop-runner.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L208)
+Defined in: [loop-runner.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L211)
 
 **`Experimental`**
 
@@ -3164,7 +3164,7 @@ Defined in: [loop-runner.ts:208](https://github.com/tangle-network/agent-runtime
 
 ### ResearchLoopResult
 
-Defined in: [loop-runner.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L212)
+Defined in: [loop-runner.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L215)
 
 **`Experimental`**
 
@@ -3174,7 +3174,7 @@ Defined in: [loop-runner.ts:212](https://github.com/tangle-network/agent-runtime
 
 > **accepted**: [`FactCandidate`](mcp.md#factcandidate)[]
 
-Defined in: [loop-runner.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L214)
+Defined in: [loop-runner.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L217)
 
 **`Experimental`**
 
@@ -3184,7 +3184,7 @@ Facts that passed the fail-closed gate — safe to write to the KB.
 
 > **vetoed**: [`VetoedFact`](#vetoedfact)[]
 
-Defined in: [loop-runner.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L216)
+Defined in: [loop-runner.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L219)
 
 **`Experimental`**
 
@@ -3194,7 +3194,7 @@ Facts the gate vetoed in the final round — escalate, do not silently drop.
 
 > **rounds**: `number`
 
-Defined in: [loop-runner.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L218)
+Defined in: [loop-runner.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L221)
 
 **`Experimental`**
 
@@ -3204,7 +3204,7 @@ Research rounds actually run.
 
 ### ResearchLoopRunnerOptions
 
-Defined in: [loop-runner.ts:222](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L222)
+Defined in: [loop-runner.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L225)
 
 **`Experimental`**
 
@@ -3216,7 +3216,7 @@ Options for the default `research` runner.
 
 > **research**: (`round`, `vetoed`) => `Promise`\<[`FactCandidate`](mcp.md#factcandidate)[]\>
 
-Defined in: [loop-runner.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L229)
+Defined in: [loop-runner.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L232)
 
 **`Experimental`**
 
@@ -3243,7 +3243,7 @@ Returns fact candidates carrying their grounding (`verbatimPassage` +
 
 > `optional` **gate?**: [`CreateKbGateOptions`](mcp.md#createkbgateoptions)
 
-Defined in: [loop-runner.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L231)
+Defined in: [loop-runner.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L234)
 
 **`Experimental`**
 
@@ -3253,7 +3253,7 @@ Gate config (extra judges, self-artifact kinds, …). The floor is always on.
 
 > `optional` **maxRounds?**: `number`
 
-Defined in: [loop-runner.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L233)
+Defined in: [loop-runner.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L236)
 
 **`Experimental`**
 
@@ -3263,7 +3263,7 @@ Max research rounds (correct-on-veto remediation). Default 1.
 
 ### ModelInfo
 
-Defined in: [model-resolution.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L21)
+Defined in: [model-resolution.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L22)
 
 A model entry as returned by the Tangle Router `/v1/models` endpoint.
 Intentionally minimal — only the fields resolution + validation read.
@@ -3274,25 +3274,25 @@ Intentionally minimal — only the fields resolution + validation read.
 
 > **id**: `string`
 
-Defined in: [model-resolution.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L22)
+Defined in: [model-resolution.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L23)
 
 ##### name?
 
 > `optional` **name?**: `string`
 
-Defined in: [model-resolution.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L23)
+Defined in: [model-resolution.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L24)
 
 ##### description?
 
 > `optional` **description?**: `string`
 
-Defined in: [model-resolution.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L24)
+Defined in: [model-resolution.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L25)
 
 ##### provider?
 
 > `optional` **provider?**: `string`
 
-Defined in: [model-resolution.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L26)
+Defined in: [model-resolution.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L27)
 
 Provider slug, when the router exposes it (`provider` or `_provider`).
 
@@ -3300,13 +3300,13 @@ Provider slug, when the router exposes it (`provider` or `_provider`).
 
 > `optional` **\_provider?**: `string`
 
-Defined in: [model-resolution.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L27)
+Defined in: [model-resolution.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L28)
 
 ##### architecture?
 
 > `optional` **architecture?**: `object`
 
-Defined in: [model-resolution.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L28)
+Defined in: [model-resolution.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L29)
 
 ###### modality?
 
@@ -3324,7 +3324,7 @@ Defined in: [model-resolution.ts:28](https://github.com/tangle-network/agent-run
 
 ### RouterEnv
 
-Defined in: [model-resolution.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L36)
+Defined in: [model-resolution.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L37)
 
 Env keys the router base URL is resolved from.
 
@@ -3334,19 +3334,19 @@ Env keys the router base URL is resolved from.
 
 > `optional` **TANGLE\_ROUTER\_URL?**: `string`
 
-Defined in: [model-resolution.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L37)
+Defined in: [model-resolution.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L38)
 
 ##### TANGLE\_ROUTER\_BASE\_URL?
 
 > `optional` **TANGLE\_ROUTER\_BASE\_URL?**: `string`
 
-Defined in: [model-resolution.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L38)
+Defined in: [model-resolution.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L39)
 
 ***
 
 ### ResolvedChatModel
 
-Defined in: [model-resolution.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L78)
+Defined in: [model-resolution.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L79)
 
 #### Properties
 
@@ -3354,13 +3354,13 @@ Defined in: [model-resolution.ts:78](https://github.com/tangle-network/agent-run
 
 > **source**: `string`
 
-Defined in: [model-resolution.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L79)
+Defined in: [model-resolution.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L80)
 
 ##### model
 
 > **model**: `string`
 
-Defined in: [model-resolution.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L80)
+Defined in: [model-resolution.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L81)
 
 ***
 
@@ -3868,7 +3868,7 @@ Defined in: [otel-export.ts:608](https://github.com/tangle-network/agent-runtime
 
 ### RuntimeHookEvent
 
-Defined in: [runtime-hooks.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L35)
+Defined in: [runtime-hooks.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L36)
 
 #### Type Parameters
 
@@ -3882,67 +3882,67 @@ Defined in: [runtime-hooks.ts:35](https://github.com/tangle-network/agent-runtim
 
 > **id**: `string`
 
-Defined in: [runtime-hooks.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L36)
+Defined in: [runtime-hooks.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L37)
 
 ##### runId
 
 > **runId**: `string`
 
-Defined in: [runtime-hooks.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L37)
+Defined in: [runtime-hooks.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L38)
 
 ##### scenarioId?
 
 > `optional` **scenarioId?**: `string`
 
-Defined in: [runtime-hooks.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L38)
+Defined in: [runtime-hooks.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L39)
 
 ##### target
 
 > **target**: [`RuntimeHookTarget`](#runtimehooktarget)
 
-Defined in: [runtime-hooks.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L39)
+Defined in: [runtime-hooks.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L40)
 
 ##### phase
 
 > **phase**: [`RuntimeHookPhase`](#runtimehookphase)
 
-Defined in: [runtime-hooks.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L40)
+Defined in: [runtime-hooks.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L41)
 
 ##### timestamp
 
 > **timestamp**: `number`
 
-Defined in: [runtime-hooks.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L41)
+Defined in: [runtime-hooks.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L42)
 
 ##### stepIndex?
 
 > `optional` **stepIndex?**: `number`
 
-Defined in: [runtime-hooks.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L42)
+Defined in: [runtime-hooks.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L43)
 
 ##### parentId?
 
 > `optional` **parentId?**: `string`
 
-Defined in: [runtime-hooks.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L43)
+Defined in: [runtime-hooks.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L44)
 
 ##### payload?
 
 > `optional` **payload?**: `Payload`
 
-Defined in: [runtime-hooks.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L44)
+Defined in: [runtime-hooks.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L45)
 
 ##### metadata?
 
 > `optional` **metadata?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [runtime-hooks.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L45)
+Defined in: [runtime-hooks.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L46)
 
 ***
 
 ### RuntimeHookContext
 
-Defined in: [runtime-hooks.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L48)
+Defined in: [runtime-hooks.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L49)
 
 #### Properties
 
@@ -3950,13 +3950,13 @@ Defined in: [runtime-hooks.ts:48](https://github.com/tangle-network/agent-runtim
 
 > `optional` **signal?**: `AbortSignal`
 
-Defined in: [runtime-hooks.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L49)
+Defined in: [runtime-hooks.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L50)
 
 ***
 
 ### RuntimeDecisionEvidenceRef
 
-Defined in: [runtime-hooks.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L52)
+Defined in: [runtime-hooks.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L53)
 
 #### Properties
 
@@ -3964,31 +3964,31 @@ Defined in: [runtime-hooks.ts:52](https://github.com/tangle-network/agent-runtim
 
 > **source**: `string`
 
-Defined in: [runtime-hooks.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L53)
+Defined in: [runtime-hooks.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L54)
 
 ##### id
 
 > **id**: `string`
 
-Defined in: [runtime-hooks.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L54)
+Defined in: [runtime-hooks.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L55)
 
 ##### detail?
 
 > `optional` **detail?**: `string`
 
-Defined in: [runtime-hooks.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L55)
+Defined in: [runtime-hooks.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L56)
 
 ##### metadata?
 
 > `optional` **metadata?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [runtime-hooks.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L56)
+Defined in: [runtime-hooks.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L57)
 
 ***
 
 ### RuntimeDecisionPoint
 
-Defined in: [runtime-hooks.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L59)
+Defined in: [runtime-hooks.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L60)
 
 #### Properties
 
@@ -3996,61 +3996,61 @@ Defined in: [runtime-hooks.ts:59](https://github.com/tangle-network/agent-runtim
 
 > **id**: `string`
 
-Defined in: [runtime-hooks.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L60)
+Defined in: [runtime-hooks.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L61)
 
 ##### runId
 
 > **runId**: `string`
 
-Defined in: [runtime-hooks.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L61)
+Defined in: [runtime-hooks.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L62)
 
 ##### scenarioId?
 
 > `optional` **scenarioId?**: `string`
 
-Defined in: [runtime-hooks.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L62)
+Defined in: [runtime-hooks.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L63)
 
 ##### stepIndex
 
 > **stepIndex**: `number`
 
-Defined in: [runtime-hooks.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L63)
+Defined in: [runtime-hooks.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L64)
 
 ##### kind
 
 > **kind**: [`RuntimeDecisionKind`](#runtimedecisionkind)
 
-Defined in: [runtime-hooks.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L64)
+Defined in: [runtime-hooks.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L65)
 
 ##### candidateActions
 
 > **candidateActions**: `string`[]
 
-Defined in: [runtime-hooks.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L65)
+Defined in: [runtime-hooks.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L66)
 
 ##### context?
 
 > `optional` **context?**: `string`
 
-Defined in: [runtime-hooks.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L66)
+Defined in: [runtime-hooks.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L67)
 
 ##### evidence
 
 > **evidence**: [`RuntimeDecisionEvidenceRef`](#runtimedecisionevidenceref)[]
 
-Defined in: [runtime-hooks.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L67)
+Defined in: [runtime-hooks.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L68)
 
 ##### metadata?
 
 > `optional` **metadata?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [runtime-hooks.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L68)
+Defined in: [runtime-hooks.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L69)
 
 ***
 
 ### RuntimeHookErrorContext
 
-Defined in: [runtime-hooks.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L71)
+Defined in: [runtime-hooks.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L72)
 
 #### Properties
 
@@ -4058,43 +4058,43 @@ Defined in: [runtime-hooks.ts:71](https://github.com/tangle-network/agent-runtim
 
 > **hook**: `"onEvent"` \| `"onDecisionPoint"`
 
-Defined in: [runtime-hooks.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L72)
+Defined in: [runtime-hooks.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L73)
 
 ##### eventId?
 
 > `optional` **eventId?**: `string`
 
-Defined in: [runtime-hooks.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L73)
+Defined in: [runtime-hooks.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L74)
 
 ##### target?
 
 > `optional` **target?**: [`RuntimeHookTarget`](#runtimehooktarget)
 
-Defined in: [runtime-hooks.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L74)
+Defined in: [runtime-hooks.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L75)
 
 ##### phase?
 
 > `optional` **phase?**: [`RuntimeHookPhase`](#runtimehookphase)
 
-Defined in: [runtime-hooks.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L75)
+Defined in: [runtime-hooks.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L76)
 
 ##### decisionId?
 
 > `optional` **decisionId?**: `string`
 
-Defined in: [runtime-hooks.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L76)
+Defined in: [runtime-hooks.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L77)
 
 ##### decisionKind?
 
 > `optional` **decisionKind?**: [`RuntimeDecisionKind`](#runtimedecisionkind)
 
-Defined in: [runtime-hooks.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L77)
+Defined in: [runtime-hooks.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L78)
 
 ***
 
 ### RuntimeHooks
 
-Defined in: [runtime-hooks.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L87)
+Defined in: [runtime-hooks.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L88)
 
 The observation seam attached to a running loop (never to the portable genome).
 Implement the optional hooks to receive lifecycle events, semantic decision points,
@@ -4108,7 +4108,7 @@ callback-prop zoo.
 
 > `optional` **onEvent?**: (`event`, `context`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime-hooks.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L93)
+Defined in: [runtime-hooks.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L94)
 
 General before/after/event hook. Use this for telemetry, memory capture,
 policy wrapping, child lifecycle observers, or product-specific extension
@@ -4132,7 +4132,7 @@ points.
 
 > `optional` **onDecisionPoint?**: (`point`, `context`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime-hooks.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L98)
+Defined in: [runtime-hooks.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L99)
 
 Semantic decision hook. Belief-state evaluation consumes this, but runtime
 code should keep emitting ordinary lifecycle events as the base layer.
@@ -4155,7 +4155,7 @@ code should keep emitting ordinary lifecycle events as the base layer.
 
 > `optional` **onHookError?**: (`error`, `context`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime-hooks.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L102)
+Defined in: [runtime-hooks.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L103)
 
 ###### Parameters
 
@@ -4175,7 +4175,7 @@ Defined in: [runtime-hooks.ts:102](https://github.com/tangle-network/agent-runti
 
 ### RuntimeRunRow
 
-Defined in: [runtime-run.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L60)
+Defined in: [runtime-run.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L61)
 
 #### Stable
 
@@ -4185,7 +4185,7 @@ Defined in: [runtime-run.ts:60](https://github.com/tangle-network/agent-runtime/
 
 > **id**: `string`
 
-Defined in: [runtime-run.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L62)
+Defined in: [runtime-run.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L63)
 
 Stable runtime-side identifier. Adapters may translate to their own primary key.
 
@@ -4193,85 +4193,85 @@ Stable runtime-side identifier. Adapters may translate to their own primary key.
 
 > **workspaceId**: `string`
 
-Defined in: [runtime-run.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L63)
+Defined in: [runtime-run.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L64)
 
 ##### sessionId?
 
 > `optional` **sessionId?**: `string`
 
-Defined in: [runtime-run.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L64)
+Defined in: [runtime-run.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L65)
 
 ##### agentId?
 
 > `optional` **agentId?**: `string`
 
-Defined in: [runtime-run.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L65)
+Defined in: [runtime-run.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L66)
 
 ##### domain?
 
 > `optional` **domain?**: `string`
 
-Defined in: [runtime-run.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L66)
+Defined in: [runtime-run.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L67)
 
 ##### taskId
 
 > **taskId**: `string`
 
-Defined in: [runtime-run.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L67)
+Defined in: [runtime-run.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L68)
 
 ##### scenarioId?
 
 > `optional` **scenarioId?**: `string`
 
-Defined in: [runtime-run.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L68)
+Defined in: [runtime-run.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L69)
 
 ##### status
 
 > **status**: `RuntimeRunStatus`
 
-Defined in: [runtime-run.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L69)
+Defined in: [runtime-run.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L70)
 
 ##### resultSummary?
 
 > `optional` **resultSummary?**: `string`
 
-Defined in: [runtime-run.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L70)
+Defined in: [runtime-run.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L71)
 
 ##### error?
 
 > `optional` **error?**: `string`
 
-Defined in: [runtime-run.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L71)
+Defined in: [runtime-run.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L72)
 
 ##### cost
 
 > **cost**: `RuntimeRunCost`
 
-Defined in: [runtime-run.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L72)
+Defined in: [runtime-run.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L73)
 
 ##### startedAt
 
 > **startedAt**: `string`
 
-Defined in: [runtime-run.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L73)
+Defined in: [runtime-run.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L74)
 
 ##### completedAt?
 
 > `optional` **completedAt?**: `string`
 
-Defined in: [runtime-run.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L74)
+Defined in: [runtime-run.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L75)
 
 ##### metadata?
 
 > `optional` **metadata?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [runtime-run.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L75)
+Defined in: [runtime-run.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L76)
 
 ***
 
 ### RuntimeRunPersistenceAdapter
 
-Defined in: [runtime-run.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L79)
+Defined in: [runtime-run.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L80)
 
 #### Stable
 
@@ -4281,7 +4281,7 @@ Defined in: [runtime-run.ts:79](https://github.com/tangle-network/agent-runtime/
 
 > **upsert**(`row`): `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime-run.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L87)
+Defined in: [runtime-run.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L88)
 
 Called once when `handle.persist()` runs. Implementations write `row` to
 their durable store (D1, postgres, KV) and return whatever the consumer
@@ -4303,7 +4303,7 @@ retry or log-and-continue.
 
 ### RuntimeRunHandle
 
-Defined in: [runtime-run.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L106)
+Defined in: [runtime-run.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L107)
 
 #### Stable
 
@@ -4313,7 +4313,7 @@ Defined in: [runtime-run.ts:106](https://github.com/tangle-network/agent-runtime
 
 > `readonly` **id**: `string`
 
-Defined in: [runtime-run.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L108)
+Defined in: [runtime-run.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L109)
 
 Stable id assigned at start.
 
@@ -4321,25 +4321,25 @@ Stable id assigned at start.
 
 > `readonly` **workspaceId**: `string`
 
-Defined in: [runtime-run.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L109)
+Defined in: [runtime-run.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L110)
 
 ##### sessionId
 
 > `readonly` **sessionId**: `string` \| `undefined`
 
-Defined in: [runtime-run.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L110)
+Defined in: [runtime-run.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L111)
 
 ##### taskSpec
 
 > `readonly` **taskSpec**: [`AgentTaskSpec`](#agenttaskspec)
 
-Defined in: [runtime-run.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L111)
+Defined in: [runtime-run.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L112)
 
 ##### status
 
 > `readonly` **status**: `RuntimeRunStatus`
 
-Defined in: [runtime-run.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L112)
+Defined in: [runtime-run.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L113)
 
 #### Methods
 
@@ -4347,7 +4347,7 @@ Defined in: [runtime-run.ts:112](https://github.com/tangle-network/agent-runtime
 
 > **observe**(`event`): `void`
 
-Defined in: [runtime-run.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L119)
+Defined in: [runtime-run.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L120)
 
 Observe a single `RuntimeStreamEvent`. The handle ignores non-cost events
 (text deltas, tool calls) silently so consumers can pipe the whole stream
@@ -4367,7 +4367,7 @@ through `handle.observe`. `llm_call` events update the ledger.
 
 > **cost**(): `RuntimeRunCost`
 
-Defined in: [runtime-run.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L122)
+Defined in: [runtime-run.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L123)
 
 Snapshot of the current cost ledger. Safe to call at any time.
 
@@ -4379,7 +4379,7 @@ Snapshot of the current cost ledger. Safe to call at any time.
 
 > **complete**(`input`): `void`
 
-Defined in: [runtime-run.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L129)
+Defined in: [runtime-run.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L130)
 
 Transition to a terminal state. Idempotent for the same status; throws
 `RuntimeRunStateError` for a different terminal status (state machines
@@ -4399,7 +4399,7 @@ don't time-travel).
 
 > **toRow**(`metadata?`): [`RuntimeRunRow`](#runtimerunrow)
 
-Defined in: [runtime-run.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L132)
+Defined in: [runtime-run.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L133)
 
 Build the current row without writing it. Useful for tests + dry runs.
 
@@ -4417,7 +4417,7 @@ Build the current row without writing it. Useful for tests + dry runs.
 
 > **persist**(`metadata?`): `Promise`\<`void`\>
 
-Defined in: [runtime-run.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L139)
+Defined in: [runtime-run.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L140)
 
 Persist the current row via the configured adapter. Must be called after
 `complete()`. Idempotent for the same terminal state (the adapter sees
@@ -4437,7 +4437,7 @@ the same row on retry).
 
 ### RuntimeTelemetryOptions
 
-Defined in: [sanitize.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L29)
+Defined in: [sanitize.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L30)
 
 #### Stable
 
@@ -4447,7 +4447,7 @@ Defined in: [sanitize.ts:29](https://github.com/tangle-network/agent-runtime/blo
 
 > `optional` **includeInputs?**: `boolean`
 
-Defined in: [sanitize.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L34)
+Defined in: [sanitize.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L35)
 
 Include raw task inputs. Off by default because task inputs often contain
 customer facts, credentials, source text, or internal IDs.
@@ -4456,7 +4456,7 @@ customer facts, credentials, source text, or internal IDs.
 
 > `optional` **includeRequirementDescriptions?**: `boolean`
 
-Defined in: [sanitize.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L36)
+Defined in: [sanitize.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L37)
 
 Include requirement descriptions. Secret requirements are always redacted.
 
@@ -4464,7 +4464,7 @@ Include requirement descriptions. Secret requirements are always redacted.
 
 > `optional` **includeEvidenceIds?**: `boolean`
 
-Defined in: [sanitize.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L38)
+Defined in: [sanitize.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L39)
 
 Include evidence IDs. Off by default; counts are safer for shared reports.
 
@@ -4472,7 +4472,7 @@ Include evidence IDs. Off by default; counts are safer for shared reports.
 
 > `optional` **includeUserAnswers?**: `boolean`
 
-Defined in: [sanitize.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L40)
+Defined in: [sanitize.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L41)
 
 Include user answers from question preflight. Off by default.
 
@@ -4480,7 +4480,7 @@ Include user answers from question preflight. Off by default.
 
 > `optional` **includeControlPayloads?**: `boolean`
 
-Defined in: [sanitize.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L42)
+Defined in: [sanitize.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L43)
 
 Include action payloads and action results for control steps. Off by default.
 
@@ -4488,7 +4488,7 @@ Include action payloads and action results for control steps. Off by default.
 
 > `optional` **includeMetadata?**: `boolean`
 
-Defined in: [sanitize.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L44)
+Defined in: [sanitize.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L45)
 
 Include task metadata. Off by default because metadata may carry IDs or policy internals.
 
@@ -4496,7 +4496,7 @@ Include task metadata. Off by default because metadata may carry IDs or policy i
 
 > `optional` **includeEvalDetails?**: `boolean`
 
-Defined in: [sanitize.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L46)
+Defined in: [sanitize.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L47)
 
 Include eval detail/evidence strings. Off by default because validators may echo private input.
 
@@ -4504,7 +4504,7 @@ Include eval detail/evidence strings. Off by default because validators may echo
 
 ### SanitizedKnowledgeReadinessReport
 
-Defined in: [sanitize.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L67)
+Defined in: [sanitize.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L68)
 
 #### Stable
 
@@ -4514,67 +4514,67 @@ Defined in: [sanitize.ts:67](https://github.com/tangle-network/agent-runtime/blo
 
 > **taskId**: `string`
 
-Defined in: [sanitize.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L68)
+Defined in: [sanitize.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L69)
 
 ##### readinessScore
 
 > **readinessScore**: `number`
 
-Defined in: [sanitize.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L69)
+Defined in: [sanitize.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L70)
 
 ##### recommendedAction
 
 > **recommendedAction**: `KnowledgeRecommendedAction`
 
-Defined in: [sanitize.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L70)
+Defined in: [sanitize.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L71)
 
 ##### severity
 
 > **severity**: `ControlSeverity`
 
-Defined in: [sanitize.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L71)
+Defined in: [sanitize.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L72)
 
 ##### reason
 
 > **reason**: `string`
 
-Defined in: [sanitize.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L72)
+Defined in: [sanitize.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L73)
 
 ##### blockingMissingRequirements
 
 > **blockingMissingRequirements**: `SanitizedKnowledgeRequirement`[]
 
-Defined in: [sanitize.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L73)
+Defined in: [sanitize.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L74)
 
 ##### nonBlockingGaps
 
 > **nonBlockingGaps**: `SanitizedKnowledgeRequirement`[]
 
-Defined in: [sanitize.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L74)
+Defined in: [sanitize.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L75)
 
 ##### evidenceCount
 
 > **evidenceCount**: `number`
 
-Defined in: [sanitize.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L75)
+Defined in: [sanitize.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L76)
 
 ##### evidenceIds?
 
 > `optional` **evidenceIds?**: `string`[]
 
-Defined in: [sanitize.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L76)
+Defined in: [sanitize.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L77)
 
 ##### missingRequirementIds
 
 > **missingRequirementIds**: `string`[]
 
-Defined in: [sanitize.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L77)
+Defined in: [sanitize.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L78)
 
 ***
 
 ### RuntimeEventCollector
 
-Defined in: [sanitize.ts:492](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L492)
+Defined in: [sanitize.ts:493](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L493)
 
 #### Stable
 
@@ -4602,7 +4602,7 @@ Defined in: [sanitize.ts:492](https://github.com/tangle-network/agent-runtime/bl
 
 > **onEvent**: (`event`) => `void`
 
-Defined in: [sanitize.ts:498](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L498)
+Defined in: [sanitize.ts:499](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L499)
 
 ###### Parameters
 
@@ -4618,13 +4618,13 @@ Defined in: [sanitize.ts:498](https://github.com/tangle-network/agent-runtime/bl
 
 > **events**: `Record`\<`string`, `unknown`\>[]
 
-Defined in: [sanitize.ts:499](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L499)
+Defined in: [sanitize.ts:500](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L500)
 
 ***
 
 ### RuntimeStreamEventCollector
 
-Defined in: [sanitize.ts:522](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L522)
+Defined in: [sanitize.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L523)
 
 #### Stable
 
@@ -4634,13 +4634,13 @@ Defined in: [sanitize.ts:522](https://github.com/tangle-network/agent-runtime/bl
 
 > **onEvent**: `RuntimeStreamEventSink`
 
-Defined in: [sanitize.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L523)
+Defined in: [sanitize.ts:524](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L524)
 
 ##### events
 
 > **events**: `Record`\<`string`, `unknown`\>[]
 
-Defined in: [sanitize.ts:524](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L524)
+Defined in: [sanitize.ts:525](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L525)
 
 #### Methods
 
@@ -4648,7 +4648,7 @@ Defined in: [sanitize.ts:524](https://github.com/tangle-network/agent-runtime/bl
 
 > **summary**(): `RuntimeStreamEventSummary`
 
-Defined in: [sanitize.ts:526](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L526)
+Defined in: [sanitize.ts:527](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L527)
 
 Snapshot of a small streaming-flavored summary derived from collected events.
 
@@ -5164,7 +5164,7 @@ Defined in: [tool-loop.ts:330](https://github.com/tangle-network/agent-runtime/b
 
 ### AgentTaskSpec
 
-Defined in: [types.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L26)
+Defined in: [types.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L27)
 
 #### Stable
 
@@ -5174,19 +5174,19 @@ Defined in: [types.ts:26](https://github.com/tangle-network/agent-runtime/blob/m
 
 > **id**: `string`
 
-Defined in: [types.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L27)
+Defined in: [types.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L28)
 
 ##### intent
 
 > **intent**: `string`
 
-Defined in: [types.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L28)
+Defined in: [types.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L29)
 
 ##### domain?
 
 > `optional` **domain?**: `string`
 
-Defined in: [types.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L30)
+Defined in: [types.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L31)
 
 Domain is metadata, not an architectural boundary: tax, legal, gtm, creative, blueprint, redteam, etc.
 
@@ -5194,31 +5194,31 @@ Domain is metadata, not an architectural boundary: tax, legal, gtm, creative, bl
 
 > `optional` **inputs?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [types.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L31)
+Defined in: [types.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L32)
 
 ##### requiredKnowledge?
 
 > `optional` **requiredKnowledge?**: `KnowledgeRequirement`[]
 
-Defined in: [types.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L32)
+Defined in: [types.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L33)
 
 ##### budget?
 
 > `optional` **budget?**: `Partial`\<`ControlBudget`\>
 
-Defined in: [types.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L33)
+Defined in: [types.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L34)
 
 ##### metadata?
 
 > `optional` **metadata?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [types.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L34)
+Defined in: [types.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L35)
 
 ***
 
 ### AgentKnowledgeProvider
 
-Defined in: [types.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L38)
+Defined in: [types.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L39)
 
 #### Stable
 
@@ -5228,7 +5228,7 @@ Defined in: [types.ts:38](https://github.com/tangle-network/agent-runtime/blob/m
 
 > `optional` **buildReadiness**(`task`): `KnowledgeReadinessReport` \| `Promise`\<`KnowledgeReadinessReport`\>
 
-Defined in: [types.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L39)
+Defined in: [types.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L40)
 
 ###### Parameters
 
@@ -5244,7 +5244,7 @@ Defined in: [types.ts:39](https://github.com/tangle-network/agent-runtime/blob/m
 
 > `optional` **answerQuestions**(`questions`, `task`): `Record`\<`string`, `string`\> \| `Promise`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [types.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L40)
+Defined in: [types.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L41)
 
 ###### Parameters
 
@@ -5264,7 +5264,7 @@ Defined in: [types.ts:40](https://github.com/tangle-network/agent-runtime/blob/m
 
 > `optional` **executeAcquisitionPlans**(`plans`, `task`): `string`[] \| `Promise`\<`string`[]\>
 
-Defined in: [types.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L44)
+Defined in: [types.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L45)
 
 ###### Parameters
 
@@ -5284,7 +5284,7 @@ Defined in: [types.ts:44](https://github.com/tangle-network/agent-runtime/blob/m
 
 > `optional` **refreshReadiness**(`input`): `KnowledgeReadinessReport` \| `Promise`\<`KnowledgeReadinessReport`\>
 
-Defined in: [types.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L48)
+Defined in: [types.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L49)
 
 ###### Parameters
 
@@ -5314,7 +5314,7 @@ Defined in: [types.ts:48](https://github.com/tangle-network/agent-runtime/blob/m
 
 ### AgentTaskContext
 
-Defined in: [types.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L57)
+Defined in: [types.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L58)
 
 #### Stable
 
@@ -5342,73 +5342,73 @@ Defined in: [types.ts:57](https://github.com/tangle-network/agent-runtime/blob/m
 
 > **task**: [`AgentTaskSpec`](#agenttaskspec)
 
-Defined in: [types.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L63)
+Defined in: [types.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L64)
 
 ##### knowledge
 
 > **knowledge**: `KnowledgeReadinessReport`
 
-Defined in: [types.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L64)
+Defined in: [types.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L65)
 
 ##### state
 
 > **state**: `TState`
 
-Defined in: [types.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L65)
+Defined in: [types.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L66)
 
 ##### evals
 
 > **evals**: `TEval`[]
 
-Defined in: [types.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L66)
+Defined in: [types.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L67)
 
 ##### history
 
 > **history**: `ControlStep`\<`TState`, `TAction`, `TActionResult`, `TEval`\>[]
 
-Defined in: [types.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L67)
+Defined in: [types.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L68)
 
 ##### budget
 
 > **budget**: `ControlBudget`
 
-Defined in: [types.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L68)
+Defined in: [types.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L69)
 
 ##### stepIndex
 
 > **stepIndex**: `number`
 
-Defined in: [types.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L69)
+Defined in: [types.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L70)
 
 ##### wallMs
 
 > **wallMs**: `number`
 
-Defined in: [types.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L70)
+Defined in: [types.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L71)
 
 ##### spentCostUsd
 
 > **spentCostUsd**: `number`
 
-Defined in: [types.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L71)
+Defined in: [types.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L72)
 
 ##### remainingCostUsd?
 
 > `optional` **remainingCostUsd?**: `number`
 
-Defined in: [types.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L72)
+Defined in: [types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L73)
 
 ##### abortSignal
 
 > **abortSignal**: `AbortSignal`
 
-Defined in: [types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L73)
+Defined in: [types.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L74)
 
 ***
 
 ### AgentAdapter
 
-Defined in: [types.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L77)
+Defined in: [types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L78)
 
 #### Stable
 
@@ -5436,7 +5436,7 @@ Defined in: [types.ts:77](https://github.com/tangle-network/agent-runtime/blob/m
 
 > **observe**(`ctx`): `TState` \| `Promise`\<`TState`\>
 
-Defined in: [types.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L83)
+Defined in: [types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L84)
 
 ###### Parameters
 
@@ -5466,7 +5466,7 @@ Defined in: [types.ts:83](https://github.com/tangle-network/agent-runtime/blob/m
 
 > **validate**(`ctx`): `TEval`[] \| `Promise`\<`TEval`[]\>
 
-Defined in: [types.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L90)
+Defined in: [types.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L91)
 
 ###### Parameters
 
@@ -5500,7 +5500,7 @@ Defined in: [types.ts:90](https://github.com/tangle-network/agent-runtime/blob/m
 
 > **decide**(`ctx`): `ControlDecision`\<`TAction`\> \| `Promise`\<`ControlDecision`\<`TAction`\>\>
 
-Defined in: [types.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L98)
+Defined in: [types.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L99)
 
 ###### Parameters
 
@@ -5516,7 +5516,7 @@ Defined in: [types.ts:98](https://github.com/tangle-network/agent-runtime/blob/m
 
 > **act**(`action`, `ctx`): `TActionResult` \| `Promise`\<`TActionResult`\>
 
-Defined in: [types.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L102)
+Defined in: [types.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L103)
 
 ###### Parameters
 
@@ -5536,7 +5536,7 @@ Defined in: [types.ts:102](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **shouldStop**(`ctx`): `Promise`\<\{ `stop`: `boolean`; `pass`: `boolean`; `reason`: `string`; `score?`: `number`; \}\> \| \{ `stop`: `boolean`; `pass`: `boolean`; `reason`: `string`; `score?`: `number`; \}
 
-Defined in: [types.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L107)
+Defined in: [types.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L108)
 
 ###### Parameters
 
@@ -5552,7 +5552,7 @@ Defined in: [types.ts:107](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **onKnowledgeBlocked**(`ctx`): `ControlDecision`\<`TAction`\> \| `Promise`\<`ControlDecision`\<`TAction`\>\>
 
-Defined in: [types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L121)
+Defined in: [types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L122)
 
 ###### Parameters
 
@@ -5582,7 +5582,7 @@ Defined in: [types.ts:121](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **getActionCostUsd**(`ctx`): `number` \| `undefined`
 
-Defined in: [types.ts:128](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L128)
+Defined in: [types.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L129)
 
 ###### Parameters
 
@@ -5620,7 +5620,7 @@ Defined in: [types.ts:128](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **projectRunRecords**(`result`, `task`): `RunRecord`[]
 
-Defined in: [types.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L137)
+Defined in: [types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L138)
 
 ###### Parameters
 
@@ -5640,9 +5640,7 @@ Defined in: [types.ts:137](https://github.com/tangle-network/agent-runtime/blob/
 
 ### BackendErrorDetail
 
-Defined in: [types.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L210)
-
-#### Stable
+Defined in: [types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L212)
 
 Typed transport / backend failure detail. Carried on `backend_error` and
 `final` events when the backend's stream throws or the upstream HTTP call
@@ -5656,13 +5654,15 @@ misconfigured proxy never bloats event payloads or logs. Consumers needing
 the full body should inspect the underlying `BackendTransportError.body`
 via a custom `mapEvent` or backend wrapper.
 
+#### Stable
+
 #### Properties
 
 ##### kind
 
 > **kind**: `"backend"` \| `"transport"`
 
-Defined in: [types.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L216)
+Defined in: [types.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L218)
 
 `'transport'` — upstream HTTP / network failure with optional status code.
 `'backend'` — the backend's `stream()` generator threw for a non-transport
@@ -5672,13 +5672,13 @@ reason (e.g. a custom adapter error, sandbox crash).
 
 > **message**: `string`
 
-Defined in: [types.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L217)
+Defined in: [types.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L219)
 
 ##### status?
 
 > `optional` **status?**: `number`
 
-Defined in: [types.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L219)
+Defined in: [types.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L221)
 
 Upstream HTTP status when known. `0` for connection / abort errors.
 
@@ -5686,7 +5686,7 @@ Upstream HTTP status when known. `0` for connection / abort errors.
 
 > `optional` **body?**: `string`
 
-Defined in: [types.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L221)
+Defined in: [types.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L223)
 
 Truncated response body (≤2 KiB). Diagnostic only — never machine-parsed.
 
@@ -5694,9 +5694,7 @@ Truncated response body (≤2 KiB). Diagnostic only — never machine-parsed.
 
 ### OpenAIChatTool
 
-Defined in: [types.ts:239](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L239)
-
-#### Stable
+Defined in: [types.ts:242](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L242)
 
 OpenAI Chat Completions tool descriptor. The shape mirrors the
 `/v1/chat/completions` `tools[]` parameter so callers can pass tool
@@ -5710,19 +5708,21 @@ MCP `tools/list` at config time and project the result into this shape. The
 runtime intentionally does NOT depend on `@modelcontextprotocol/sdk` —
 keeping the backend transport thin lets domain repos own MCP plumbing.
 
+#### Stable
+
 #### Properties
 
 ##### type
 
 > **type**: `"function"`
 
-Defined in: [types.ts:240](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L240)
+Defined in: [types.ts:243](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L243)
 
 ##### function
 
 > **function**: `object`
 
-Defined in: [types.ts:241](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L241)
+Defined in: [types.ts:244](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L244)
 
 ###### name
 
@@ -5740,7 +5740,7 @@ Defined in: [types.ts:241](https://github.com/tangle-network/agent-runtime/blob/
 
 ### RuntimeSessionStore
 
-Defined in: [types.ts:456](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L456)
+Defined in: [types.ts:461](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L461)
 
 #### Stable
 
@@ -5750,7 +5750,7 @@ Defined in: [types.ts:456](https://github.com/tangle-network/agent-runtime/blob/
 
 > **get**(`sessionId`): `RuntimeSession` \| `Promise`\<`RuntimeSession` \| `undefined`\> \| `undefined`
 
-Defined in: [types.ts:457](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L457)
+Defined in: [types.ts:462](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L462)
 
 ###### Parameters
 
@@ -5766,7 +5766,7 @@ Defined in: [types.ts:457](https://github.com/tangle-network/agent-runtime/blob/
 
 > **put**(`session`): `void` \| `Promise`\<`void`\>
 
-Defined in: [types.ts:458](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L458)
+Defined in: [types.ts:463](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L463)
 
 ###### Parameters
 
@@ -5782,7 +5782,7 @@ Defined in: [types.ts:458](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **appendEvent**(`sessionId`, `event`): `void` \| `Promise`\<`void`\>
 
-Defined in: [types.ts:459](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L459)
+Defined in: [types.ts:464](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L464)
 
 ###### Parameters
 
@@ -5802,7 +5802,7 @@ Defined in: [types.ts:459](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **listEvents**(`sessionId`): [`RuntimeStreamEvent`](#runtimestreamevent)[] \| `Promise`\<[`RuntimeStreamEvent`](#runtimestreamevent)[]\>
 
-Defined in: [types.ts:460](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L460)
+Defined in: [types.ts:465](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L465)
 
 ###### Parameters
 
@@ -5818,7 +5818,7 @@ Defined in: [types.ts:460](https://github.com/tangle-network/agent-runtime/blob/
 
 ### AgentBackendInput
 
-Defined in: [types.ts:464](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L464)
+Defined in: [types.ts:469](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L469)
 
 #### Stable
 
@@ -5828,19 +5828,19 @@ Defined in: [types.ts:464](https://github.com/tangle-network/agent-runtime/blob/
 
 > **task**: [`AgentTaskSpec`](#agenttaskspec)
 
-Defined in: [types.ts:465](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L465)
+Defined in: [types.ts:470](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L470)
 
 ##### message?
 
 > `optional` **message?**: `string`
 
-Defined in: [types.ts:466](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L466)
+Defined in: [types.ts:471](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L471)
 
 ##### messages?
 
 > `optional` **messages?**: `object`[]
 
-Defined in: [types.ts:467](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L467)
+Defined in: [types.ts:472](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L472)
 
 ###### role
 
@@ -5854,13 +5854,13 @@ Defined in: [types.ts:467](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **inputs?**: `Record`\<`string`, `unknown`\>
 
-Defined in: [types.ts:468](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L468)
+Defined in: [types.ts:473](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L473)
 
 ***
 
 ### AgentBackendContext
 
-Defined in: [types.ts:472](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L472)
+Defined in: [types.ts:477](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L477)
 
 #### Stable
 
@@ -5870,31 +5870,31 @@ Defined in: [types.ts:472](https://github.com/tangle-network/agent-runtime/blob/
 
 > **task**: [`AgentTaskSpec`](#agenttaskspec)
 
-Defined in: [types.ts:473](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L473)
+Defined in: [types.ts:478](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L478)
 
 ##### knowledge
 
 > **knowledge**: `KnowledgeReadinessReport`
 
-Defined in: [types.ts:474](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L474)
+Defined in: [types.ts:479](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L479)
 
 ##### session
 
 > **session**: `RuntimeSession`
 
-Defined in: [types.ts:475](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L475)
+Defined in: [types.ts:480](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L480)
 
 ##### signal?
 
 > `optional` **signal?**: `AbortSignal`
 
-Defined in: [types.ts:476](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L476)
+Defined in: [types.ts:481](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L481)
 
 ##### runId?
 
 > `optional` **runId?**: `string`
 
-Defined in: [types.ts:482](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L482)
+Defined in: [types.ts:487](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L487)
 
 Conversation/run identifier when this call is part of a multi-agent run.
 Backends should stamp it into any trace/log emission so cross-participant
@@ -5904,7 +5904,7 @@ events correlate. Absent when the call is a stand-alone `runAgentTask`.
 
 > `optional` **turnId?**: `string`
 
-Defined in: [types.ts:487](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L487)
+Defined in: [types.ts:492](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L492)
 
 Deterministic turn id for this single call. Stable across retries of the
 same logical turn so a caching gateway / idempotent backend can dedupe.
@@ -5913,7 +5913,7 @@ same logical turn so a caching gateway / idempotent backend can dedupe.
 
 > `optional` **parentTurnId?**: `string`
 
-Defined in: [types.ts:493](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L493)
+Defined in: [types.ts:498](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L498)
 
 If this call is itself nested inside a higher-order conversation
 (recursion via `createConversationBackend`), the enclosing turn's id.
@@ -5923,7 +5923,7 @@ Used for trace stitching across nested orchestration.
 
 > `optional` **propagatedHeaders?**: `Readonly`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [types.ts:500](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L500)
+Defined in: [types.ts:505](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L505)
 
 Headers to forward verbatim to any outbound HTTP the backend issues:
 `X-Tangle-Forwarded-Authorization`, `X-Tangle-Forwarded-Depth`,
@@ -5934,7 +5934,7 @@ the outbound request; backends that don't issue HTTP may ignore them.
 
 ### AgentExecutionBackend
 
-Defined in: [types.ts:504](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L504)
+Defined in: [types.ts:509](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L509)
 
 #### Stable
 
@@ -5950,7 +5950,7 @@ Defined in: [types.ts:504](https://github.com/tangle-network/agent-runtime/blob/
 
 > **kind**: `string`
 
-Defined in: [types.ts:505](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L505)
+Defined in: [types.ts:510](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L510)
 
 #### Methods
 
@@ -5958,7 +5958,7 @@ Defined in: [types.ts:505](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **start**(`input`, `context`): `RuntimeSession` \| `Promise`\<`RuntimeSession`\>
 
-Defined in: [types.ts:506](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L506)
+Defined in: [types.ts:511](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L511)
 
 ###### Parameters
 
@@ -5978,7 +5978,7 @@ Defined in: [types.ts:506](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **resume**(`session`, `input`, `context`): `RuntimeSession` \| `Promise`\<`RuntimeSession`\>
 
-Defined in: [types.ts:510](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L510)
+Defined in: [types.ts:515](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L515)
 
 ###### Parameters
 
@@ -6002,7 +6002,7 @@ Defined in: [types.ts:510](https://github.com/tangle-network/agent-runtime/blob/
 
 > **stream**(`input`, `context`): `AsyncIterable`\<[`RuntimeStreamEvent`](#runtimestreamevent)\>
 
-Defined in: [types.ts:515](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L515)
+Defined in: [types.ts:520](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L520)
 
 ###### Parameters
 
@@ -6022,7 +6022,7 @@ Defined in: [types.ts:515](https://github.com/tangle-network/agent-runtime/blob/
 
 > `optional` **stop**(`session`, `reason`): `void` \| `Promise`\<`void`\>
 
-Defined in: [types.ts:516](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L516)
+Defined in: [types.ts:521](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L521)
 
 ###### Parameters
 
@@ -6042,7 +6042,7 @@ Defined in: [types.ts:516](https://github.com/tangle-network/agent-runtime/blob/
 
 ### AgentTaskRunResult
 
-Defined in: [types.ts:552](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L552)
+Defined in: [types.ts:557](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L557)
 
 #### Stable
 
@@ -6070,55 +6070,55 @@ Defined in: [types.ts:552](https://github.com/tangle-network/agent-runtime/blob/
 
 > **task**: [`AgentTaskSpec`](#agenttaskspec)
 
-Defined in: [types.ts:558](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L558)
+Defined in: [types.ts:563](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L563)
 
 ##### status
 
 > **status**: [`AgentTaskStatus`](#agenttaskstatus)
 
-Defined in: [types.ts:559](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L559)
+Defined in: [types.ts:564](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L564)
 
 ##### knowledge
 
 > **knowledge**: `KnowledgeReadinessReport`
 
-Defined in: [types.ts:560](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L560)
+Defined in: [types.ts:565](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L565)
 
 ##### questions
 
 > **questions**: `UserQuestion`[]
 
-Defined in: [types.ts:561](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L561)
+Defined in: [types.ts:566](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L566)
 
 ##### acquisitionPlans
 
 > **acquisitionPlans**: `DataAcquisitionPlan`[]
 
-Defined in: [types.ts:562](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L562)
+Defined in: [types.ts:567](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L567)
 
 ##### userAnswers
 
 > **userAnswers**: `Record`\<`string`, `string`\>
 
-Defined in: [types.ts:563](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L563)
+Defined in: [types.ts:568](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L568)
 
 ##### acquiredEvidenceIds
 
 > **acquiredEvidenceIds**: `string`[]
 
-Defined in: [types.ts:564](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L564)
+Defined in: [types.ts:569](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L569)
 
 ##### control
 
 > **control**: `ControlRunResult`\<`TState`, `TAction`, `TActionResult`, `TEval`\>
 
-Defined in: [types.ts:565](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L565)
+Defined in: [types.ts:570](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L570)
 
 ##### runRecords
 
 > **runRecords**: `RunRecord`[]
 
-Defined in: [types.ts:566](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L566)
+Defined in: [types.ts:571](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L571)
 
 ## Type Aliases
 
@@ -6126,7 +6126,7 @@ Defined in: [types.ts:566](https://github.com/tangle-network/agent-runtime/blob/
 
 > **RetryableErrorPredicate** = (`err`) => `boolean`
 
-Defined in: [conversation/call-policy.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L17)
+Defined in: [conversation/call-policy.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L18)
 
 Pure judgment of whether an error is worth retrying. Defaults: TimeoutError, AbortError, fetch-level network errors.
 
@@ -6146,7 +6146,7 @@ Pure judgment of whether an error is worth retrying. Defaults: TimeoutError, Abo
 
 > **RetryBackoff** = `number` \| ((`attempt`) => `number`)
 
-Defined in: [conversation/call-policy.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L20)
+Defined in: [conversation/call-policy.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L21)
 
 Backoff between attempts. Constant ms, or `(attempt: 1-indexed) => ms`.
 
@@ -6156,7 +6156,7 @@ Backoff between attempts. Constant ms, or `(attempt: 1-indexed) => ms`.
 
 > **ForwardHeaderName** = *typeof* [`FORWARD_HEADERS`](#forward_headers)\[keyof *typeof* [`FORWARD_HEADERS`](#forward_headers)\]
 
-Defined in: [conversation/headers.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L34)
+Defined in: [conversation/headers.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L35)
 
 ***
 
@@ -6164,7 +6164,7 @@ Defined in: [conversation/headers.ts:34](https://github.com/tangle-network/agent
 
 > **PropagatedHeaders** = `Readonly`\<`Record`\<`string`, `string`\>\>
 
-Defined in: [conversation/headers.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L110)
+Defined in: [conversation/headers.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L111)
 
 Header bag carried through `AgentBackendContext.propagatedHeaders` so
 backends that opt in can merge them into their outbound HTTP requests.
@@ -6188,7 +6188,7 @@ A persona that drives the conversation: either a full driver `AgentProfile`
 
 > **AuthSource** = `"forward-user"` \| `"agent-owned"` \| ((`state`) => `"forward-user"` \| `"agent-owned"`)
 
-Defined in: [conversation/types.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L67)
+Defined in: [conversation/types.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L68)
 
 #### Stable
 
@@ -6198,7 +6198,7 @@ Defined in: [conversation/types.ts:67](https://github.com/tangle-network/agent-r
 
 > **TurnOrder** = `"alternate"` \| `"round-robin"` \| ((`state`) => `number`)
 
-Defined in: [conversation/types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L73)
+Defined in: [conversation/types.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L74)
 
 #### Stable
 
@@ -6208,7 +6208,7 @@ Defined in: [conversation/types.ts:73](https://github.com/tangle-network/agent-r
 
 > **HaltPredicate** = (`ctx`) => `boolean` \| [`HaltSignal`](#haltsignal) \| `Promise`\<`boolean` \| [`HaltSignal`](#haltsignal)\>
 
-Defined in: [conversation/types.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L94)
+Defined in: [conversation/types.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L95)
 
 #### Parameters
 
@@ -6228,7 +6228,7 @@ Defined in: [conversation/types.ts:94](https://github.com/tangle-network/agent-r
 
 > **HaltReason** = \{ `kind`: `"max_turns"`; `turns`: `number`; \} \| \{ `kind`: `"max_credits"`; `spentCents`: `number`; `capCents`: `number`; \} \| \{ `kind`: `"predicate"`; `reason`: `string`; \} \| \{ `kind`: `"abort"`; \} \| \{ `kind`: `"participant_error"`; `participant`: `string`; `message`: `string`; \}
 
-Defined in: [conversation/types.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L99)
+Defined in: [conversation/types.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L100)
 
 #### Stable
 
@@ -6238,7 +6238,7 @@ Defined in: [conversation/types.ts:99](https://github.com/tangle-network/agent-r
 
 > **ConversationStreamEvent** = \{ `type`: `"conversation_start"`; `runId`: `string`; `participants`: readonly `string`[]; `seed`: `string`; `timestamp`: `string`; \} \| \{ `type`: `"conversation_resumed"`; `runId`: `string`; `participants`: readonly `string`[]; `transcript`: readonly [`ConversationTurn`](#conversationturn)[]; `timestamp`: `string`; \} \| \{ `type`: `"turn_start"`; `runId`: `string`; `index`: `number`; `speaker`: `string`; `turnId`: `string`; `attempt`: `number`; `timestamp`: `string`; \} \| \{ `type`: `"turn_text_delta"`; `runId`: `string`; `index`: `number`; `speaker`: `string`; `turnId`: `string`; `text`: `string`; `timestamp?`: `string`; \} \| \{ `type`: `"turn_retry"`; `runId`: `string`; `index`: `number`; `speaker`: `string`; `turnId`: `string`; `attempt`: `number`; `reason`: `string`; `timestamp`: `string`; \} \| \{ `type`: `"turn_end"`; `runId`: `string`; `turn`: [`ConversationTurn`](#conversationturn); `timestamp`: `string`; \} \| \{ `type`: `"conversation_end"`; `runId`: `string`; `result`: [`ConversationResult`](#conversationresult); `timestamp`: `string`; \}
 
-Defined in: [conversation/types.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L236)
+Defined in: [conversation/types.ts:237](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/types.ts#L237)
 
 #### Stable
 
@@ -6248,7 +6248,7 @@ Defined in: [conversation/types.ts:236](https://github.com/tangle-network/agent-
 
 > **Verifier** = (`worktreePath`) => `Promise`\<[`VerifyResult`](#verifyresult)\> \| [`VerifyResult`](#verifyresult)
 
-Defined in: [improvement/agentic-generator.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L49)
+Defined in: [improvement/agentic-generator.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L50)
 
 Verifies the edited worktree. Sync or async; throws only on a setup fault
  (a candidate that fails verification returns `{ok:false}`, it does not
@@ -6270,7 +6270,7 @@ Verifies the edited worktree. Sync or async; throws only on a setup fault
 
 > **ImproveSurface** = `"prompt"` \| `"skills"` \| `"tools"` \| `"mcp"` \| `"hooks"` \| `"code"`
 
-Defined in: [improvement/improve.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L45)
+Defined in: [improvement/improve.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L46)
 
 The agent-profile lever `improve` optimizes. Mirrors the AgentProfile-law
  profile levers; `code` is the implementation-tier surface.
@@ -6281,7 +6281,7 @@ The agent-profile lever `improve` optimizes. Mirrors the AgentProfile-law
 
 > **DelegatedLoopMode** = *typeof* [`DELEGATED_LOOP_MODES`](#delegated_loop_modes)\[`number`\]
 
-Defined in: [loop-runner.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L49)
+Defined in: [loop-runner.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L50)
 
 **`Experimental`**
 
@@ -6291,7 +6291,7 @@ Defined in: [loop-runner.ts:49](https://github.com/tangle-network/agent-runtime/
 
 > **DelegatedLoopRunner**\<`T`\> = (`signal`) => `Promise`\<`T`\>
 
-Defined in: [loop-runner.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L58)
+Defined in: [loop-runner.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L59)
 
 **`Experimental`**
 
@@ -6320,7 +6320,7 @@ A pre-configured loop for one mode. Returns the mode's raw
 
 > **DelegatedLoopRegistry** = `Partial`\<`Record`\<[`DelegatedLoopMode`](#delegatedloopmode), [`DelegatedLoopRunner`](#delegatedlooprunner)\>\>
 
-Defined in: [loop-runner.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L62)
+Defined in: [loop-runner.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L63)
 
 **`Experimental`**
 
@@ -6333,7 +6333,7 @@ Mode → configured runner. Partial: only register the modes a
 
 > **RuntimeHookPhase** = `"before"` \| `"after"` \| `"error"` \| `"event"`
 
-Defined in: [runtime-hooks.ts:9](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L9)
+Defined in: [runtime-hooks.ts:10](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L10)
 
 **`Experimental`**
 
@@ -6347,7 +6347,7 @@ loop or product harness that is running the profile.
 
 > **RuntimeHookTarget** = `"agent.run"` \| `"agent.turn"` \| `"agent.tool_call"` \| `"agent.spawn"` \| `"agent.child"` \| `"agent.plan"` \| `"agent.decision"` \| `string` & `object`
 
-Defined in: [runtime-hooks.ts:11](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L11)
+Defined in: [runtime-hooks.ts:12](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L12)
 
 ***
 
@@ -6355,7 +6355,7 @@ Defined in: [runtime-hooks.ts:11](https://github.com/tangle-network/agent-runtim
 
 > **RuntimeDecisionKind** = `"continue"` \| `"verify"` \| `"ask"` \| `"retry"` \| `"stop"` \| `"memory-write"` \| `"memory-read"` \| `"tool-select"` \| `"skill-select"` \| `"workflow-select"` \| `"surface-promote"` \| `string` & `object`
 
-Defined in: [runtime-hooks.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L21)
+Defined in: [runtime-hooks.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L22)
 
 ***
 
@@ -6460,7 +6460,7 @@ Defined in: [tool-loop.ts:298](https://github.com/tangle-network/agent-runtime/b
 
 > **AgentTaskStatus** = `"completed"` \| `"blocked"` \| `"failed"` \| `"aborted"`
 
-Defined in: [types.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L144)
+Defined in: [types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L145)
 
 #### Stable
 
@@ -6470,7 +6470,7 @@ Defined in: [types.ts:144](https://github.com/tangle-network/agent-runtime/blob/
 
 > **AgentRuntimeEvent**\<`TState`, `TAction`, `TActionResult`, `TEval`\> = \{ `type`: `"task_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); \} \| \{ `type`: `"readiness_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); \} \| \{ `type`: `"readiness_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `knowledge`: `KnowledgeReadinessReport`; \} \| \{ `type`: `"questions_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `questions`: `UserQuestion`[]; \} \| \{ `type`: `"questions_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `questions`: `UserQuestion`[]; `userAnswers`: `Record`\<`string`, `string`\>; \} \| \{ `type`: `"acquisition_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `acquisitionPlans`: `DataAcquisitionPlan`[]; \} \| \{ `type`: `"acquisition_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `acquisitionPlans`: `DataAcquisitionPlan`[]; `acquiredEvidenceIds`: `string`[]; \} \| \{ `type`: `"control_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `knowledge`: `KnowledgeReadinessReport`; \} \| \{ `type`: `"control_step"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `step`: `ControlStep`\<`TState`, `TAction`, `TActionResult`, `TEval`\>; \} \| \{ `type`: `"control_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `control`: `ControlRunResult`\<`TState`, `TAction`, `TActionResult`, `TEval`\>; \} \| \{ `type`: `"task_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `status`: [`AgentTaskStatus`](#agenttaskstatus); `reason`: `string`; \}
 
-Defined in: [types.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L147)
+Defined in: [types.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L148)
 
 #### Type Parameters
 
@@ -6498,7 +6498,7 @@ Defined in: [types.ts:147](https://github.com/tangle-network/agent-runtime/blob/
 
 > **AgentRuntimeEventSink**\<`TState`, `TAction`, `TActionResult`, `TEval`\> = (`event`) => `Promise`\<`void`\> \| `void`
 
-Defined in: [types.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L188)
+Defined in: [types.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L189)
 
 #### Type Parameters
 
@@ -6536,36 +6536,36 @@ Defined in: [types.ts:188](https://github.com/tangle-network/agent-runtime/blob/
 
 > **OpenAIChatToolChoice** = `"auto"` \| `"none"` \| `"required"` \| \{ `type`: `"function"`; `function`: \{ `name`: `string`; \}; \}
 
-Defined in: [types.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L256)
-
-#### Stable
+Defined in: [types.ts:260](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L260)
 
 `tool_choice` parameter for OpenAI-compat chat. Same shape as the OpenAI
 spec: `'auto'` (default — model decides), `'none'` (disable tool calling
 for this turn), `'required'` (force a tool call), or a specific function
 pin `{ type: 'function', function: { name } }`.
 
+#### Stable
+
 ***
 
 ### OpenAIChatResponseFormat
 
 > **OpenAIChatResponseFormat** = \{ `type`: `"text"`; \} \| \{ `type`: `"json_object"`; \} \| \{ `type`: `"json_schema"`; `json_schema`: `Record`\<`string`, `unknown`\>; \}
 
-Defined in: [types.ts:269](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L269)
-
-#### Stable
+Defined in: [types.ts:274](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L274)
 
 `response_format` parameter for OpenAI-compatible chat endpoints. Use
 `json_object` when the caller needs syntactically valid JSON, or
 `json_schema` when the upstream provider supports schema-constrained JSON.
 
+#### Stable
+
 ***
 
 ### RuntimeStreamEvent
 
 > **RuntimeStreamEvent** = \{ `type`: `"task_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `timestamp`: `string`; \} \| \{ `type`: `"readiness_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `timestamp`: `string`; \} \| \{ `type`: `"readiness_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `knowledge`: `KnowledgeReadinessReport`; `decision`: `KnowledgeReadinessDecision`; `timestamp`: `string`; \} \| \{ `type`: `"questions_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `questions`: `UserQuestion`[]; `timestamp`: `string`; \} \| \{ `type`: `"questions_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `questions`: `UserQuestion`[]; `userAnswers`: `Record`\<`string`, `string`\>; `timestamp`: `string`; \} \| \{ `type`: `"acquisition_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `acquisitionPlans`: `DataAcquisitionPlan`[]; `timestamp`: `string`; \} \| \{ `type`: `"acquisition_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `acquisitionPlans`: `DataAcquisitionPlan`[]; `acquiredEvidenceIds`: `string`[]; `timestamp`: `string`; \} \| \{ `type`: `"session_created"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `session`: `RuntimeSession`; `timestamp`: `string`; \} \| \{ `type`: `"session_resumed"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `session`: `RuntimeSession`; `timestamp`: `string`; \} \| \{ `type`: `"backend_start"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `session`: `RuntimeSession`; `backend`: `string`; `timestamp`: `string`; \} \| \{ `type`: `"text_delta"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `text`: `string`; `timestamp?`: `string`; \} \| \{ `type`: `"reasoning_delta"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `text`: `string`; `timestamp?`: `string`; \} \| \{ `type`: `"tool_call"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `toolName`: `string`; `toolCallId?`: `string`; `args?`: `unknown`; `timestamp?`: `string`; \} \| \{ `type`: `"tool_result"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `toolName`: `string`; `toolCallId?`: `string`; `result?`: `unknown`; `timestamp?`: `string`; \} \| \{ `type`: `"llm_call"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `model`: `string`; `tokensIn?`: `number`; `tokensOut?`: `number`; `costUsd?`: `number`; `latencyMs?`: `number`; `finishReason?`: `string`; `timestamp?`: `string`; \} \| \{ `type`: `"artifact"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `artifactId`: `string`; `name?`: `string`; `mimeType?`: `string`; `uri?`: `string`; `content?`: `string`; `metadata?`: `Record`\<`string`, `unknown`\>; `timestamp?`: `string`; \} \| \{ `type`: `"proposal_created"`; `task?`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `proposalId`: `string`; `title`: `string`; `status?`: `"pending"` \| `"approved"` \| `"rejected"`; `content?`: `string`; `timestamp?`: `string`; \} \| \{ `type`: `"backend_error"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `backend`: `string`; `message`: `string`; `recoverable`: `boolean`; `error?`: [`BackendErrorDetail`](#backenderrordetail); `timestamp`: `string`; \} \| \{ `type`: `"backend_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `session`: `RuntimeSession`; `backend`: `string`; `timestamp`: `string`; \} \| \{ `type`: `"task_end"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `status`: [`AgentTaskStatus`](#agenttaskstatus); `reason`: `string`; `timestamp`: `string`; \} \| \{ `type`: `"final"`; `task`: [`AgentTaskSpec`](#agenttaskspec); `session?`: `RuntimeSession`; `status`: [`AgentTaskStatus`](#agenttaskstatus); `reason`: `string`; `text?`: `string`; `metadata?`: `Record`\<`string`, `unknown`\>; `error?`: [`BackendErrorDetail`](#backenderrordetail); `timestamp`: `string`; \}
 
-Defined in: [types.ts:275](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L275)
+Defined in: [types.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/types.ts#L280)
 
 #### Union Members
 
@@ -6786,7 +6786,7 @@ MUST map this to `RunRecord.error` rather than recording silent
 
 > `const` **defaultIsRetryable**: [`RetryableErrorPredicate`](#retryableerrorpredicate)
 
-Defined in: [conversation/call-policy.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L62)
+Defined in: [conversation/call-policy.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L63)
 
 Default retryable classification — network/timeout class errors. Errors
 a model deliberately throws (validation, refusal, 4xx) are not retried;
@@ -6798,7 +6798,7 @@ those represent real outcomes, not transient infrastructure faults.
 
 > `const` **FORWARD\_HEADERS**: `object`
 
-Defined in: [conversation/headers.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L19)
+Defined in: [conversation/headers.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L20)
 
 Standard names — lowercased so Headers maps interop on every runtime.
 
@@ -6846,7 +6846,7 @@ Logical conversation peer label at the sending side, for trace stitching.
 
 > `const` **DEFAULT\_MAX\_DEPTH**: `4` = `4`
 
-Defined in: [conversation/headers.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L37)
+Defined in: [conversation/headers.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L38)
 
 Hard cap on chained gateway hops; refused beyond this. Default keeps recursion bounded.
 
@@ -6856,7 +6856,7 @@ Hard cap on chained gateway hops; refused beyond this. Default keeps recursion b
 
 > `const` **DELEGATED\_LOOP\_MODES**: readonly \[`"code"`, `"review"`, `"research"`, `"audit"`, `"self-improve"`\]
 
-Defined in: [loop-runner.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L46)
+Defined in: [loop-runner.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L47)
 
 **`Experimental`**
 
@@ -6868,7 +6868,7 @@ Every delegated-loop mode, for validation + CLI surfaces.
 
 > `const` **DEFAULT\_ROUTER\_BASE\_URL**: `"https://router.tangle.tools"` = `'https://router.tangle.tools'`
 
-Defined in: [model-resolution.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L41)
+Defined in: [model-resolution.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L42)
 
 ***
 
@@ -6886,7 +6886,7 @@ Wire version the eval-runs ingest enforces (X-Tangle-Wire-Version + body).
 
 > **createIterableBackend**\<`TInput`\>(`options`): [`AgentExecutionBackend`](#agentexecutionbackend)\<`TInput`\>
 
-Defined in: [backends.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/backends.ts#L29)
+Defined in: [backends.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/backends.ts#L30)
 
 #### Type Parameters
 
@@ -6930,7 +6930,7 @@ Defined in: [backends.ts:29](https://github.com/tangle-network/agent-runtime/blo
 
 > **createSandboxPromptBackend**\<`TBox`, `TInput`\>(`options`): [`AgentExecutionBackend`](#agentexecutionbackend)\<`TInput`\>
 
-Defined in: [backends.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/backends.ts#L40)
+Defined in: [backends.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/backends.ts#L41)
 
 #### Type Parameters
 
@@ -6974,7 +6974,38 @@ Defined in: [backends.ts:40](https://github.com/tangle-network/agent-runtime/blo
 
 > **createOpenAICompatibleBackend**\<`TInput`\>(`options`): [`AgentExecutionBackend`](#agentexecutionbackend)\<`TInput`\>
 
-Defined in: [backends.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/backends.ts#L206)
+Defined in: [backends.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/backends.ts#L208)
+
+OpenAI-compat streaming backend. Routes `runAgentTaskStream` through any
+`POST /chat/completions` endpoint that speaks OpenAI's SSE protocol —
+Tangle Router, OpenAI direct, OpenRouter, Groq, DeepSeek, Together. The
+router also fronts Anthropic models in Anthropic-native SSE shape; this
+backend handles both.
+
+### Tool calls
+
+Pass `tools` (and optionally `toolChoice`) to forward an OpenAI Chat
+Completions `tools[]` array on every request. Streamed `tool_call` chunks
+are buffered until the model finalizes them (either `finish_reason:
+'tool_calls'` for OpenAI shape or a `content_block_stop` for Anthropic
+`tool_use` blocks proxied through the router), then emitted as a single
+`tool_call` RuntimeStreamEvent with the assembled `args`.
+
+The backend does NOT execute tools — it surfaces calls for the caller's
+own dispatcher (typically the product's MCP / sandbox runtime) to fulfill
+and feed back as a subsequent `messages` turn. This keeps the transport
+thin and lets the agent host own tool dispatch policy.
+
+### Fail-loud errors
+
+Non-success HTTP responses (4xx/5xx) and exhausted retry budgets throw
+`BackendTransportError` from inside the `stream()` generator. The runtime
+catches the throw, yields a `backend_error` with a typed `error` field
+(`kind`, `status`, truncated `body`) and a terminal `final` event with
+`status: 'failed'` carrying the same detail. Consumers MUST map
+`final.error` onto their `RunRecord.error` — silently treating an empty
+`finalText` as "agent produced nothing" hides credit exhaustion, auth
+failure, and upstream outages.
 
 #### Type Parameters
 
@@ -7040,44 +7071,13 @@ OpenAI Chat Completions `response_format`. Omit for provider default text.
 
 #### Stable
 
-OpenAI-compat streaming backend. Routes `runAgentTaskStream` through any
-`POST /chat/completions` endpoint that speaks OpenAI's SSE protocol —
-Tangle Router, OpenAI direct, OpenRouter, Groq, DeepSeek, Together. The
-router also fronts Anthropic models in Anthropic-native SSE shape; this
-backend handles both.
-
-### Tool calls
-
-Pass `tools` (and optionally `toolChoice`) to forward an OpenAI Chat
-Completions `tools[]` array on every request. Streamed `tool_call` chunks
-are buffered until the model finalizes them (either `finish_reason:
-'tool_calls'` for OpenAI shape or a `content_block_stop` for Anthropic
-`tool_use` blocks proxied through the router), then emitted as a single
-`tool_call` RuntimeStreamEvent with the assembled `args`.
-
-The backend does NOT execute tools — it surfaces calls for the caller's
-own dispatcher (typically the product's MCP / sandbox runtime) to fulfill
-and feed back as a subsequent `messages` turn. This keeps the transport
-thin and lets the agent host own tool dispatch policy.
-
-### Fail-loud errors
-
-Non-success HTTP responses (4xx/5xx) and exhausted retry budgets throw
-`BackendTransportError` from inside the `stream()` generator. The runtime
-catches the throw, yields a `backend_error` with a typed `error` field
-(`kind`, `status`, truncated `body`) and a terminal `final` event with
-`status: 'failed'` carrying the same detail. Consumers MUST map
-`final.error` onto their `RunRecord.error` — silently treating an empty
-`finalText` as "agent produced nothing" hides credit exhaustion, auth
-failure, and upstream outages.
-
 ***
 
 ### makePerAttemptSignal()
 
 > **makePerAttemptSignal**(`parentSignal`, `deadlineMs`): `object`
 
-Defined in: [conversation/call-policy.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L126)
+Defined in: [conversation/call-policy.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L127)
 
 Build a per-attempt AbortSignal linked to the parent signal AND fired when
 the deadline elapses. The returned `dispose()` MUST be called in a
@@ -7127,7 +7127,7 @@ the underlying operation throws.
 
 > **computeBackoff**(`spec`, `attempt`): `number`
 
-Defined in: [conversation/call-policy.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L166)
+Defined in: [conversation/call-policy.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L167)
 
 Compute the delay before the next attempt. Default: 250ms exponential with jitter.
 
@@ -7151,7 +7151,7 @@ Compute the delay before the next attempt. Default: 250ms exponential with jitte
 
 > **sleep**(`ms`): `Promise`\<`void`\>
 
-Defined in: [conversation/call-policy.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L176)
+Defined in: [conversation/call-policy.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/call-policy.ts#L177)
 
 #### Parameters
 
@@ -7169,7 +7169,7 @@ Defined in: [conversation/call-policy.ts:176](https://github.com/tangle-network/
 
 > **createConversationBackend**(`options`): [`AgentExecutionBackend`](#agentexecutionbackend)
 
-Defined in: [conversation/conversation-backend.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/conversation-backend.ts#L28)
+Defined in: [conversation/conversation-backend.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/conversation-backend.ts#L29)
 
 #### Parameters
 
@@ -7195,7 +7195,7 @@ Optional backend kind label. Defaults to `'conversation'`.
 
 > **defineConversation**(`input`): [`Conversation`](#conversation)
 
-Defined in: [conversation/define-conversation.ts:13](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/define-conversation.ts#L13)
+Defined in: [conversation/define-conversation.ts:14](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/define-conversation.ts#L14)
 
 #### Parameters
 
@@ -7219,7 +7219,7 @@ Defined in: [conversation/define-conversation.ts:13](https://github.com/tangle-n
 
 > **readDepth**(`headers`): `number`
 
-Defined in: [conversation/headers.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L52)
+Defined in: [conversation/headers.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L53)
 
 Read the depth counter off an inbound request. Missing → 0 (caller is the
 origin). Non-integer → throws — silent coercion would let a bad caller
@@ -7241,7 +7241,7 @@ reset depth and bypass the limit.
 
 > **isDepthExceeded**(`inboundDepth`, `max?`): `boolean`
 
-Defined in: [conversation/headers.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L70)
+Defined in: [conversation/headers.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L71)
 
 Refuse further forwarding when the inbound depth has reached the limit.
 Callers (the gateway middleware) translate the boolean to an HTTP 413.
@@ -7266,7 +7266,7 @@ Callers (the gateway middleware) translate the boolean to an HTTP 413.
 
 > **buildForwardHeaders**(`input`): `Record`\<`string`, `string`\>
 
-Defined in: [conversation/headers.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L81)
+Defined in: [conversation/headers.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/headers.ts#L82)
 
 Build the headers to emit on an outbound participant call, given the
 conversation's propagation context. Depth is incremented from the inbound
@@ -7312,7 +7312,7 @@ right wallet.
 
 > **d1ToSqlAdapter**(`db`): [`SqlAdapter`](#sqladapter)
 
-Defined in: [conversation/journal-sql.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L60)
+Defined in: [conversation/journal-sql.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/journal-sql.ts#L61)
 
 Adapt a Cloudflare D1 binding to the SqlAdapter shape. Lives here so D1
 consumers don't have to write the wrapper themselves; the runtime never
@@ -7334,7 +7334,7 @@ imports `@cloudflare/workers-types` directly (peer-style typing).
 
 > **runConversation**(`conversation`, `options`): `Promise`\<[`ConversationResult`](#conversationresult)\>
 
-Defined in: [conversation/run-conversation.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/run-conversation.ts#L64)
+Defined in: [conversation/run-conversation.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/run-conversation.ts#L65)
 
 #### Parameters
 
@@ -7356,7 +7356,9 @@ Defined in: [conversation/run-conversation.ts:64](https://github.com/tangle-netw
 
 > **runConversationStream**(`conversation`, `options`): `AsyncIterable`\<[`ConversationStreamEvent`](#conversationstreamevent)\>
 
-Defined in: [conversation/run-conversation.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/run-conversation.ts#L82)
+Defined in: [conversation/run-conversation.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/run-conversation.ts#L84)
+
+Streaming conversation orchestrator: drives N participants in turn through their own backends, enforcing `maxTurns` / `maxCreditsCents` / `haltOn`, yielding per-event stream markers.
 
 #### Parameters
 
@@ -7433,7 +7435,16 @@ axis is the persona, and the runner is the cell. Meters the worker through
 
 > **turnId**(`runId`, `index`, `speaker`): `string`
 
-Defined in: [conversation/turn-id.ts:14](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/turn-id.ts#L14)
+Defined in: [conversation/turn-id.ts:15](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/turn-id.ts#L15)
+
+Deterministic turn identifier. Stable across retries of the same logical
+turn so backends (and any caching gateway in between) can dedupe on it.
+A retry triggered by a network blip or deadline timeout MUST produce the
+same `turn_id`; only the underlying attempt count differs.
+
+Shape: `${runId}.t${index}.${speakerSlug}` — readable in logs, sortable by
+turn index, attributable to a speaker. Slugify keeps the speaker portion
+URL-safe so it can ride in HTTP headers without escaping.
 
 #### Parameters
 
@@ -7455,22 +7466,13 @@ Defined in: [conversation/turn-id.ts:14](https://github.com/tangle-network/agent
 
 #### Stable
 
-Deterministic turn identifier. Stable across retries of the same logical
-turn so backends (and any caching gateway in between) can dedupe on it.
-A retry triggered by a network blip or deadline timeout MUST produce the
-same `turn_id`; only the underlying attempt count differs.
-
-Shape: `${runId}.t${index}.${speakerSlug}` — readable in logs, sortable by
-turn index, attributable to a speaker. Slugify keeps the speaker portion
-URL-safe so it can ride in HTTP headers without escaping.
-
 ***
 
 ### slugifySpeaker()
 
 > **slugifySpeaker**(`speaker`): `string`
 
-Defined in: [conversation/turn-id.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/turn-id.ts#L24)
+Defined in: [conversation/turn-id.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/conversation/turn-id.ts#L25)
 
 Reduce a speaker name to ASCII alphanumerics + dashes. Preserves enough
 substance to read in a log line; collisions between speakers within a
@@ -7558,20 +7560,9 @@ Wire integration:
 
 > **agenticGenerator**(`opts?`): [`CandidateGenerator`](#candidategenerator)
 
-Defined in: [improvement/agentic-generator.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L71)
+Defined in: [improvement/agentic-generator.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L73)
 
-`@tangle-network/agent-runtime` improvement — the CODE-surface proposer for
-agent-eval's improvement loop.
-
-The ONE entry point for optimization is agent-eval's `selfImprove`
-(`@tangle-network/agent-eval/contract`) — text/config surfaces, held-out gated,
-with `analyzeGeneration` for analyst-fed reflection and `analyzeRuns` /
-`fromOtelSpans` / `partitionRunsByAuthoringModel` for production intake +
-cohorting. This module supplies only the one genuinely runtime-specific piece:
-a CODE-surface `SurfaceProposer` you pass to `selfImprove` as `proposer`, which
-mutates a git worktree via a pluggable `CandidateGenerator`:
-  - `reflectiveGenerator` — cheap, no sandbox, applies pre-drafted patches
-  - `agenticGenerator`     — full coding harness in the worktree, multi-shot
+Full-agentic `CandidateGenerator` (the `shots=N, sandbox=on` setting): run a real coding harness inside the candidate worktree so the agent makes the change in place.
 
 #### Parameters
 
@@ -7589,7 +7580,7 @@ mutates a git worktree via a pluggable `CandidateGenerator`:
 
 > **commandVerifier**(`command`, `args?`, `timeoutMs?`): [`Verifier`](#verifier)
 
-Defined in: [improvement/agentic-generator.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L159)
+Defined in: [improvement/agentic-generator.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/agentic-generator.ts#L161)
 
 A `Verifier` that runs a command in the worktree: exit 0 ⇒ ok, any other
  exit ⇒ failed with stdout+stderr as feedback. The common case — verify by
@@ -7658,7 +7649,7 @@ Defined in: [improvement/build-prompts.ts:43](https://github.com/tangle-network/
 
 > **improve**\<`TScenario`, `TArtifact`\>(`profile`, `findings`, `opts`): `Promise`\<[`ImproveResult`](#improveresult)\<`TScenario`, `TArtifact`\>\>
 
-Defined in: [improvement/improve.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L199)
+Defined in: [improvement/improve.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improve.ts#L200)
 
 Run the held-out-gated self-improvement loop on ONE profile surface.
 
@@ -7710,7 +7701,9 @@ Optimize the system prompt, default holdout gate:
 
 > **improvementDriver**(`opts`): `SurfaceProposer`\<`AnalystFinding`\>
 
-Defined in: [improvement/improvement-driver.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L60)
+Defined in: [improvement/improvement-driver.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/improvement-driver.ts#L62)
+
+The one reflective/agentic improvement proposer (`SurfaceProposer`): owns the candidate worktree lifecycle and delegates HOW a change is produced to a pluggable `CandidateGenerator`.
 
 #### Parameters
 
@@ -7746,7 +7739,9 @@ Defined in: [improvement/mcp-serve-verifier.ts:43](https://github.com/tangle-net
 
 > **reflectiveGenerator**(`opts`): [`CandidateGenerator`](#candidategenerator)
 
-Defined in: [improvement/reflective-generator.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/reflective-generator.ts#L24)
+Defined in: [improvement/reflective-generator.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/improvement/reflective-generator.ts#L26)
+
+Cheap no-sandbox `CandidateGenerator` (the `shots=1` setting): draft surface edits via the improvement adapter and apply them as one coherent candidate.
 
 #### Parameters
 
@@ -7764,7 +7759,7 @@ Defined in: [improvement/reflective-generator.ts:24](https://github.com/tangle-n
 
 > **isDelegatedLoopMode**(`value`): value is "code" \| "review" \| "research" \| "audit" \| "self-improve"
 
-Defined in: [loop-runner.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L52)
+Defined in: [loop-runner.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L53)
 
 **`Experimental`**
 
@@ -7786,7 +7781,7 @@ value is "code" \| "review" \| "research" \| "audit" \| "self-improve"
 
 > **runDelegatedLoop**\<`T`\>(`mode`, `registry`, `options?`): `Promise`\<[`DelegatedLoopResult`](#delegatedloopresult)\<`T`\>\>
 
-Defined in: [loop-runner.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L89)
+Defined in: [loop-runner.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L91)
 
 **`Experimental`**
 
@@ -7825,7 +7820,7 @@ config bug, not a silent no-op. A runner that throws is captured as
 
 > **worktreeLoopRunner**(`options`): [`DelegatedLoopRunner`](#delegatedlooprunner)\<`WorktreeHarnessResult`\>
 
-Defined in: [loop-runner.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L159)
+Defined in: [loop-runner.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L162)
 
 **`Experimental`**
 
@@ -7855,7 +7850,7 @@ patch artifact, or throws when no candidate is delivered (fail loud, never a vac
 
 > **researchLoopRunner**(`o`): [`DelegatedLoopRunner`](#delegatedlooprunner)\<[`ResearchLoopResult`](#researchloopresult)\>
 
-Defined in: [loop-runner.ts:244](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L244)
+Defined in: [loop-runner.ts:249](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L249)
 
 **`Experimental`**
 
@@ -7882,11 +7877,11 @@ never silently dropped) so the caller audits vs retries.
 
 > **selfImproveLoopRunner**\<`TScenario`, `TArtifact`\>(`options`): [`DelegatedLoopRunner`](#delegatedlooprunner)\<`SelfImproveResult`\<`TScenario`, `TArtifact`\>\>
 
-Defined in: [loop-runner.ts:271](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L271)
+Defined in: [loop-runner.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L280)
 
 **`Experimental`**
 
-`self-improve` mode — agent-eval's one-call closed loop (held-out gated).
+`self-improve` mode — agent-eval's one-call closed improvement loop (held-out gated).
 
 #### Type Parameters
 
@@ -7914,7 +7909,7 @@ Defined in: [loop-runner.ts:271](https://github.com/tangle-network/agent-runtime
 
 > **auditLoopRunner**\<`TProposal`, `TEdit`\>(`options`): [`DelegatedLoopRunner`](#delegatedlooprunner)\<[`RunAnalystLoopResult`](analyst-loop.md#runanalystloopresult)\<`TProposal`, `TEdit`\>\>
 
-Defined in: [loop-runner.ts:278](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L278)
+Defined in: [loop-runner.ts:291](https://github.com/tangle-network/agent-runtime/blob/main/src/loop-runner.ts#L291)
 
 **`Experimental`**
 
@@ -7946,7 +7941,7 @@ Defined in: [loop-runner.ts:278](https://github.com/tangle-network/agent-runtime
 
 > **mcpToolsForRuntimeMcp**(): [`OpenAIChatTool`](#openaichattool)[]
 
-Defined in: [mcp/openai-tools.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/openai-tools.ts#L62)
+Defined in: [mcp/openai-tools.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/openai-tools.ts#L64)
 
 **`Experimental`**
 
@@ -7964,7 +7959,7 @@ Completions `tools[]` shape. The order is stable: `delegate_feedback`,
 
 > **mcpToolsForRuntimeMcpSubset**(`names`): [`OpenAIChatTool`](#openaichattool)[]
 
-Defined in: [mcp/openai-tools.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/openai-tools.ts#L90)
+Defined in: [mcp/openai-tools.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/openai-tools.ts#L93)
 
 **`Experimental`**
 
@@ -7989,7 +7984,7 @@ readonly `string`[]
 
 > **resolveRouterBaseUrl**(`env?`): `string`
 
-Defined in: [model-resolution.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L44)
+Defined in: [model-resolution.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L45)
 
 Resolve the router base URL from env, normalised — no trailing `/v1` or `/`.
 
@@ -8009,7 +8004,7 @@ Resolve the router base URL from env, normalised — no trailing `/v1` or `/`.
 
 > **getModels**(`routerBaseUrl?`): `Promise`\<[`ModelInfo`](#modelinfo)[]\>
 
-Defined in: [model-resolution.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L54)
+Defined in: [model-resolution.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L55)
 
 Fetch the model catalog from the router's `/v1/models`. Throws on a non-2xx
 response — callers decide whether to fail open (empty catalog) or closed.
@@ -8030,7 +8025,7 @@ response — callers decide whether to fail open (empty catalog) or closed.
 
 > **cleanModelId**(`value`): `string` \| `undefined`
 
-Defined in: [model-resolution.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L66)
+Defined in: [model-resolution.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L67)
 
 Trim a candidate model id; `undefined` for non-strings and blanks.
 
@@ -8050,7 +8045,7 @@ Trim a candidate model id; `undefined` for non-strings and blanks.
 
 > **resolveChatModel**(`candidates`, `fallback`): [`ResolvedChatModel`](#resolvedchatmodel)
 
-Defined in: [model-resolution.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L89)
+Defined in: [model-resolution.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L90)
 
 Resolve a chat model by precedence: the first candidate carrying a
 non-blank model wins, else `fallback`. The caller owns the precedence
@@ -8077,7 +8072,7 @@ etc.) while the first-non-blank logic and the telemetry shape stay shared.
 
 > **validateChatModelId**(`modelId`, `options?`): `Promise`\<`ChatModelValidation`\>
 
-Defined in: [model-resolution.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L129)
+Defined in: [model-resolution.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/model-resolution.ts#L130)
 
 Validate a caller-supplied chat-model id. Rejects non-strings, malformed
 ids, and ids absent from both the caller's `allowlist` and the live router
@@ -8274,7 +8269,9 @@ Throws only on a missing key or network failure.
 
 > **decideKnowledgeReadiness**(`report`, `options?`): `KnowledgeReadinessDecision`
 
-Defined in: [readiness.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/readiness.ts#L22)
+Defined in: [readiness.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/readiness.ts#L27)
+
+Map a `KnowledgeReadinessReport` to a three-state branch (`ready` / `blocked` / `caveat`) the runtime, route handlers, and UI shells all switch on.
 
 #### Parameters
 
@@ -8300,7 +8297,7 @@ Defined in: [readiness.ts:22](https://github.com/tangle-network/agent-runtime/bl
 
 > **applyRunRecordDefaults**(`records`, `scenarioId`, `controlFailureClass`): `RunRecord`[]
 
-Defined in: [run.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/run.ts#L48)
+Defined in: [run.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/run.ts#L49)
 
 Stamp cross-cutting defaults onto adapter-projected RunRecords without
  overriding anything the adapter set explicitly:
@@ -8334,7 +8331,9 @@ Stamp cross-cutting defaults onto adapter-projected RunRecords without
 
 > **runAgentTask**\<`TState`, `TAction`, `TActionResult`, `TEval`\>(`options`): `Promise`\<[`AgentTaskRunResult`](#agenttaskrunresult)\<`TState`, `TAction`, `TActionResult`, `TEval`\>\>
 
-Defined in: [run.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/run.ts#L83)
+Defined in: [run.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/run.ts#L88)
+
+Single-shot task lifecycle for adapter-driven tasks: readiness-gated, emits the runtime lifecycle event vocabulary, session-store pluggable.
 
 #### Type Parameters
 
@@ -8372,7 +8371,9 @@ Defined in: [run.ts:83](https://github.com/tangle-network/agent-runtime/blob/mai
 
 > **runAgentTaskStream**\<`TInput`\>(`options`): `AsyncIterable`\<[`RuntimeStreamEvent`](#runtimestreamevent)\>
 
-Defined in: [run.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/run.ts#L197)
+Defined in: [run.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/run.ts#L206)
+
+Streaming task lifecycle: delegates execution to an `AgentExecutionBackend` (model API, sandbox, or custom iterable) and yields lifecycle events as they happen.
 
 #### Type Parameters
 
@@ -8398,7 +8399,7 @@ Defined in: [run.ts:197](https://github.com/tangle-network/agent-runtime/blob/ma
 
 > **defineRuntimeHooks**(`hooks`): [`RuntimeHooks`](#runtimehooks)
 
-Defined in: [runtime-hooks.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L106)
+Defined in: [runtime-hooks.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L107)
 
 Identity helper that types a [RuntimeHooks](#runtimehooks) literal so the fields are inferred.
 
@@ -8418,7 +8419,7 @@ Identity helper that types a [RuntimeHooks](#runtimehooks) literal so the fields
 
 > **composeRuntimeHooks**(...`entries`): [`RuntimeHooks`](#runtimehooks)
 
-Defined in: [runtime-hooks.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L115)
+Defined in: [runtime-hooks.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L116)
 
 Merge several [RuntimeHooks](#runtimehooks) into one. Falsy entries are dropped (so you can
 pass `flag && hooks`), and every observer's `onEvent`/`onDecisionPoint` fires for each
@@ -8440,7 +8441,7 @@ event. Use this to attach N observers to a loop instead of a second event bus.
 
 > **notifyRuntimeHookEvent**(`hooks`, `event`, `context?`): `void`
 
-Defined in: [runtime-hooks.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L156)
+Defined in: [runtime-hooks.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L157)
 
 #### Parameters
 
@@ -8466,7 +8467,7 @@ Defined in: [runtime-hooks.ts:156](https://github.com/tangle-network/agent-runti
 
 > **notifyRuntimeDecisionPoint**(`hooks`, `point`, `context?`): `void`
 
-Defined in: [runtime-hooks.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L186)
+Defined in: [runtime-hooks.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-hooks.ts#L187)
 
 #### Parameters
 
@@ -8492,7 +8493,10 @@ Defined in: [runtime-hooks.ts:186](https://github.com/tangle-network/agent-runti
 
 > **startRuntimeRun**(`options`): [`RuntimeRunHandle`](#runtimerunhandle)
 
-Defined in: [runtime-run.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L148)
+Defined in: [runtime-run.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime-run.ts#L150)
+
+Construct a runtime-run handle. The returned handle is mutable across its
+lifetime; consumers should not share it across requests.
 
 #### Parameters
 
@@ -8506,16 +8510,13 @@ Defined in: [runtime-run.ts:148](https://github.com/tangle-network/agent-runtime
 
 #### Stable
 
-Construct a runtime-run handle. The returned handle is mutable across its
-lifetime; consumers should not share it across requests.
-
 ***
 
 ### sanitizeKnowledgeReadinessReport()
 
 > **sanitizeKnowledgeReadinessReport**(`report`, `options?`): [`SanitizedKnowledgeReadinessReport`](#sanitizedknowledgereadinessreport)
 
-Defined in: [sanitize.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L81)
+Defined in: [sanitize.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L82)
 
 #### Parameters
 
@@ -8539,7 +8540,7 @@ Defined in: [sanitize.ts:81](https://github.com/tangle-network/agent-runtime/blo
 
 > **sanitizeAgentRuntimeEvent**\<`TState`, `TAction`, `TActionResult`, `TEval`\>(`event`, `options?`): `Record`\<`string`, `unknown`\>
 
-Defined in: [sanitize.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L104)
+Defined in: [sanitize.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L105)
 
 #### Type Parameters
 
@@ -8581,7 +8582,7 @@ Defined in: [sanitize.ts:104](https://github.com/tangle-network/agent-runtime/bl
 
 > **sanitizeRuntimeStreamEvent**(`event`, `options?`): `Record`\<`string`, `unknown`\>
 
-Defined in: [sanitize.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L160)
+Defined in: [sanitize.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L161)
 
 #### Parameters
 
@@ -8605,7 +8606,7 @@ Defined in: [sanitize.ts:160](https://github.com/tangle-network/agent-runtime/bl
 
 > **createRuntimeEventCollector**\<`TState`, `TAction`, `TActionResult`, `TEval`\>(`options?`): [`RuntimeEventCollector`](#runtimeeventcollector)\<`TState`, `TAction`, `TActionResult`, `TEval`\>
 
-Defined in: [sanitize.ts:530](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L530)
+Defined in: [sanitize.ts:531](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L531)
 
 #### Type Parameters
 
@@ -8643,7 +8644,14 @@ Defined in: [sanitize.ts:530](https://github.com/tangle-network/agent-runtime/bl
 
 > **createRuntimeStreamEventCollector**(`options?`): [`RuntimeStreamEventCollector`](#runtimestreameventcollector)
 
-Defined in: [sanitize.ts:557](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L557)
+Defined in: [sanitize.ts:559](https://github.com/tangle-network/agent-runtime/blob/main/src/sanitize.ts#L559)
+
+Streaming-event counterpart of `createRuntimeEventCollector`. Pass each
+event yielded by `runAgentTaskStream` through `onEvent` and read the
+sanitized copies off `events`; the same `RuntimeTelemetryOptions` redaction
+flags apply. Kept distinct from `createRuntimeEventCollector` because the
+stream and non-stream event shapes overlap on `type` literals — dispatching
+on `type` alone would misroute events.
 
 #### Parameters
 
@@ -8657,20 +8665,13 @@ Defined in: [sanitize.ts:557](https://github.com/tangle-network/agent-runtime/bl
 
 #### Stable
 
-Streaming-event counterpart of `createRuntimeEventCollector`. Pass each
-event yielded by `runAgentTaskStream` through `onEvent` and read the
-sanitized copies off `events`; the same `RuntimeTelemetryOptions` redaction
-flags apply. Kept distinct from `createRuntimeEventCollector` because the
-stream and non-stream event shapes overlap on `type` literals — dispatching
-on `type` alone would misroute events.
-
 ***
 
 ### readinessServerSentEvent()
 
 > **readinessServerSentEvent**(`report`, `options?`): `string`
 
-Defined in: [sse.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/sse.ts#L41)
+Defined in: [sse.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/sse.ts#L42)
 
 #### Parameters
 
@@ -8694,7 +8695,7 @@ Defined in: [sse.ts:41](https://github.com/tangle-network/agent-runtime/blob/mai
 
 > **runtimeStreamServerSentEvent**(`event`, `options?`): `string`
 
-Defined in: [sse.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/sse.ts#L56)
+Defined in: [sse.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/sse.ts#L57)
 
 #### Parameters
 
diff --git a/docs/api/intelligence.md b/docs/api/intelligence.md
index 243c9fdb..5402fd5b 100644
--- a/docs/api/intelligence.md
+++ b/docs/api/intelligence.md
@@ -10,7 +10,7 @@
 
 ### CapabilityNotAdmittedError
 
-Defined in: [intelligence/capability.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L245)
+Defined in: [intelligence/capability.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L246)
 
 A binding kind whose resolver case is typed but not yet admitted (rag-index,
 memory-store, wasm, a2a). Thrown by the resolver — NEVER faked into a working
@@ -27,7 +27,7 @@ resolver grows them later behind their lifecycle + admission gate.
 
 > **new CapabilityNotAdmittedError**(`kind`, `capabilityId`, `reason`): [`CapabilityNotAdmittedError`](#capabilitynotadmittederror)
 
-Defined in: [intelligence/capability.ts:248](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L248)
+Defined in: [intelligence/capability.ts:249](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L249)
 
 ###### Parameters
 
@@ -57,19 +57,19 @@ Defined in: [intelligence/capability.ts:248](https://github.com/tangle-network/a
 
 > `readonly` **kind**: `"inline"` \| `"file"` \| `"http"` \| `"sandbox-code"` \| `"mcp-stdio"` \| `"mcp-remote"` \| `"process-on-infra"` \| `"rag-index"` \| `"memory-store"` \| `"wasm"` \| `"a2a"`
 
-Defined in: [intelligence/capability.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L246)
+Defined in: [intelligence/capability.ts:247](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L247)
 
 ##### capabilityId
 
 > `readonly` **capabilityId**: `string`
 
-Defined in: [intelligence/capability.ts:247](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L247)
+Defined in: [intelligence/capability.ts:248](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L248)
 
 ## Interfaces
 
 ### CredentialRef
 
-Defined in: [intelligence/capability.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L71)
+Defined in: [intelligence/capability.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L72)
 
 A named secret a binding requires — declared, never carried.
 
@@ -79,13 +79,13 @@ A named secret a binding requires — declared, never carried.
 
 > **key**: `string`
 
-Defined in: [intelligence/capability.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L72)
+Defined in: [intelligence/capability.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L73)
 
 ***
 
 ### HostSpec
 
-Defined in: [intelligence/capability.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L94)
+Defined in: [intelligence/capability.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L95)
 
 The host a `process-on-infra` binding provisions before its inner binding.
 Reuses `createExecutor`'s backend-as-data vocabulary — no new runtime invented.
@@ -98,43 +98,43 @@ cost; `ports` are the inner server's listen ports the host must expose.
 
 > **backend**: `"router"` \| `"sandbox"` \| `"cli"`
 
-Defined in: [intelligence/capability.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L95)
+Defined in: [intelligence/capability.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L96)
 
 ##### image?
 
 > `optional` **image?**: `string`
 
-Defined in: [intelligence/capability.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L96)
+Defined in: [intelligence/capability.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L97)
 
 ##### ports?
 
 > `optional` **ports?**: `number`[]
 
-Defined in: [intelligence/capability.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L97)
+Defined in: [intelligence/capability.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L98)
 
 ##### warm?
 
 > `optional` **warm?**: `boolean`
 
-Defined in: [intelligence/capability.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L98)
+Defined in: [intelligence/capability.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L99)
 
 ##### idleTtlMs?
 
 > `optional` **idleTtlMs?**: `number`
 
-Defined in: [intelligence/capability.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L99)
+Defined in: [intelligence/capability.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L100)
 
 ##### costTag?
 
 > `optional` **costTag?**: `string`
 
-Defined in: [intelligence/capability.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L100)
+Defined in: [intelligence/capability.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L101)
 
 ***
 
 ### CertProvenance
 
-Defined in: [intelligence/capability.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L154)
+Defined in: [intelligence/capability.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L155)
 
 The certify lane's held-out lift travelling WITH delivery. The shipped
 `CertifiedArtifact` envelope minus its content (which moves into the binding
@@ -154,37 +154,37 @@ mix of null-path and non-null-path artifacts.
 
 > **contentHash**: `string`
 
-Defined in: [intelligence/capability.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L155)
+Defined in: [intelligence/capability.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L156)
 
 ##### version
 
 > **version**: `number` \| `null`
 
-Defined in: [intelligence/capability.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L156)
+Defined in: [intelligence/capability.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L157)
 
 ##### lift
 
 > **lift**: `string` \| `null`
 
-Defined in: [intelligence/capability.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L157)
+Defined in: [intelligence/capability.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L158)
 
 ##### promotedAt
 
 > **promotedAt**: `string`
 
-Defined in: [intelligence/capability.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L158)
+Defined in: [intelligence/capability.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L159)
 
 ##### sourcePath
 
 > **sourcePath**: `string` \| `null`
 
-Defined in: [intelligence/capability.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L159)
+Defined in: [intelligence/capability.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L160)
 
 ***
 
 ### CertifiedCapability
 
-Defined in: [intelligence/capability.ts:163](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L163)
+Defined in: [intelligence/capability.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L164)
 
 One certified unit of agent power.
 
@@ -194,37 +194,37 @@ One certified unit of agent power.
 
 > **id**: `string`
 
-Defined in: [intelligence/capability.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L164)
+Defined in: [intelligence/capability.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L165)
 
 ##### iface
 
 > **iface**: [`CapabilityInterface`](#capabilityinterface)
 
-Defined in: [intelligence/capability.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L165)
+Defined in: [intelligence/capability.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L166)
 
 ##### binding
 
 > **binding**: [`DeliveryBinding`](#deliverybinding)
 
-Defined in: [intelligence/capability.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L166)
+Defined in: [intelligence/capability.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L167)
 
 ##### auth
 
 > **auth**: [`CapabilityAuth`](#capabilityauth)
 
-Defined in: [intelligence/capability.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L167)
+Defined in: [intelligence/capability.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L168)
 
 ##### provenance
 
 > **provenance**: [`CertProvenance`](#certprovenance)
 
-Defined in: [intelligence/capability.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L168)
+Defined in: [intelligence/capability.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L169)
 
 ***
 
 ### CapabilityManifest
 
-Defined in: [intelligence/capability.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L176)
+Defined in: [intelligence/capability.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L177)
 
 The strict generalization of `CertifiedProfile`. `promptSurface` is kept
 during the migration window (the shipped pull lane still emits it); new
@@ -236,31 +236,31 @@ capabilities live in `capabilities`.
 
 > **target**: `string`
 
-Defined in: [intelligence/capability.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L177)
+Defined in: [intelligence/capability.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L178)
 
 ##### generatedAt
 
 > **generatedAt**: `string`
 
-Defined in: [intelligence/capability.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L178)
+Defined in: [intelligence/capability.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L179)
 
 ##### promptSurface
 
 > **promptSurface**: [`CertifiedPromptSurface`](#certifiedpromptsurface) \| `null`
 
-Defined in: [intelligence/capability.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L179)
+Defined in: [intelligence/capability.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L180)
 
 ##### capabilities
 
 > **capabilities**: [`CertifiedCapability`](#certifiedcapability)[]
 
-Defined in: [intelligence/capability.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L180)
+Defined in: [intelligence/capability.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L181)
 
 ***
 
 ### ResolvedRetrieval
 
-Defined in: [intelligence/capability.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L186)
+Defined in: [intelligence/capability.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L187)
 
 One retrieval handle. The agent never learns vector vs graph vs index.
 
@@ -270,7 +270,7 @@ One retrieval handle. The agent never learns vector vs graph vs index.
 
 > **name**: `string`
 
-Defined in: [intelligence/capability.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L187)
+Defined in: [intelligence/capability.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L188)
 
 #### Methods
 
@@ -278,7 +278,7 @@ Defined in: [intelligence/capability.ts:187](https://github.com/tangle-network/a
 
 > **retrieve**(`query`, `k?`): `Promise`\<`object`[]\>
 
-Defined in: [intelligence/capability.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L188)
+Defined in: [intelligence/capability.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L189)
 
 ###### Parameters
 
@@ -298,7 +298,7 @@ Defined in: [intelligence/capability.ts:188](https://github.com/tangle-network/a
 
 ### ResolvedHook
 
-Defined in: [intelligence/capability.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L193)
+Defined in: [intelligence/capability.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L194)
 
 One resolved hook — event + the command/matcher the seam folds into
  `AgentProfile.hooks`.
@@ -309,25 +309,25 @@ One resolved hook — event + the command/matcher the seam folds into
 
 > **event**: `string`
 
-Defined in: [intelligence/capability.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L194)
+Defined in: [intelligence/capability.ts:195](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L195)
 
 ##### command
 
 > **command**: `string`
 
-Defined in: [intelligence/capability.ts:195](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L195)
+Defined in: [intelligence/capability.ts:196](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L196)
 
 ##### matcher?
 
 > `optional` **matcher?**: `string`
 
-Defined in: [intelligence/capability.ts:196](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L196)
+Defined in: [intelligence/capability.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L197)
 
 ***
 
 ### ResolvedSubagent
 
-Defined in: [intelligence/capability.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L200)
+Defined in: [intelligence/capability.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L201)
 
 One resolved subagent — folded into `AgentProfile.subagents`.
 
@@ -337,25 +337,25 @@ One resolved subagent — folded into `AgentProfile.subagents`.
 
 > **name**: `string`
 
-Defined in: [intelligence/capability.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L201)
+Defined in: [intelligence/capability.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L202)
 
 ##### description?
 
 > `optional` **description?**: `string`
 
-Defined in: [intelligence/capability.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L202)
+Defined in: [intelligence/capability.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L203)
 
 ##### prompt?
 
 > `optional` **prompt?**: `string`
 
-Defined in: [intelligence/capability.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L203)
+Defined in: [intelligence/capability.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L204)
 
 ***
 
 ### ResolvedSurface
 
-Defined in: [intelligence/capability.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L212)
+Defined in: [intelligence/capability.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L213)
 
 What `composeCertifiedProfile` produces. Every binding fans into the same
 slots, consumed identically by the in-process seam (`RouterToolsSeam.{tools,
@@ -368,7 +368,7 @@ executeToolCall}` + folded prompt) and the sandbox seam (`AgentProfile`).
 
 > **tools**: [`ToolSpec`](runtime.md#toolspec)[]
 
-Defined in: [intelligence/capability.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L214)
+Defined in: [intelligence/capability.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L215)
 
 Host-side tool defs → `RouterToolsSeam.tools` / agent-app `extraTools`.
 
@@ -376,7 +376,7 @@ Host-side tool defs → `RouterToolsSeam.tools` / agent-app `extraTools`.
 
 > **mcpConnections**: `Record`\<`string`, `AgentProfileMcpServer`\>
 
-Defined in: [intelligence/capability.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L219)
+Defined in: [intelligence/capability.ts:220](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L220)
 
 Sandbox-side tool delivery → `AgentProfile.mcp` / in-proc `createMcpEnvironment`.
 
@@ -384,7 +384,7 @@ Sandbox-side tool delivery → `AgentProfile.mcp` / in-proc `createMcpEnvironmen
 
 > **promptAdditions**: `string`[]
 
-Defined in: [intelligence/capability.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L221)
+Defined in: [intelligence/capability.ts:222](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L222)
 
 Prompt-context additions, byte-stable-ordered → folded system prompt.
 
@@ -392,7 +392,7 @@ Prompt-context additions, byte-stable-ordered → folded system prompt.
 
 > **files**: `object`[]
 
-Defined in: [intelligence/capability.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L223)
+Defined in: [intelligence/capability.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L224)
 
 Workspace files → `AgentProfile.resources.files`.
 
@@ -412,7 +412,7 @@ Workspace files → `AgentProfile.resources.files`.
 
 > **retrieval**: [`ResolvedRetrieval`](#resolvedretrieval)[]
 
-Defined in: [intelligence/capability.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L225)
+Defined in: [intelligence/capability.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L226)
 
 Uniform retrieval handles.
 
@@ -420,7 +420,7 @@ Uniform retrieval handles.
 
 > **hooks**: [`ResolvedHook`](#resolvedhook)[]
 
-Defined in: [intelligence/capability.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L227)
+Defined in: [intelligence/capability.ts:228](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L228)
 
 Hooks → `AgentProfile.hooks`.
 
@@ -428,7 +428,7 @@ Hooks → `AgentProfile.hooks`.
 
 > **subagents**: [`ResolvedSubagent`](#resolvedsubagent)[]
 
-Defined in: [intelligence/capability.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L229)
+Defined in: [intelligence/capability.ts:230](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L230)
 
 Subagents → `AgentProfile.subagents`.
 
@@ -436,7 +436,7 @@ Subagents → `AgentProfile.subagents`.
 
 > **systemPrompt**: `string`
 
-Defined in: [intelligence/capability.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L232)
+Defined in: [intelligence/capability.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L233)
 
 The folded system prompt — base + the byte-stable prompt additions, exactly
  as `composeCertifiedPrompt` renders the inline/context capabilities.
@@ -447,7 +447,7 @@ The folded system prompt — base + the byte-stable prompt additions, exactly
 
 > **execute**(`name`, `args`, `task`): `Promise`\<`string`\>
 
-Defined in: [intelligence/capability.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L217)
+Defined in: [intelligence/capability.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L218)
 
 Host-side dispatch for a resolved tool. Throws when `name` is unknown so a
  mis-dispatch is loud, never a silent empty string.
@@ -474,7 +474,7 @@ Host-side dispatch for a resolved tool. Throws when `name` is unknown so a
 
 > **dispose**(): `Promise`\<`void`\>
 
-Defined in: [intelligence/capability.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L234)
+Defined in: [intelligence/capability.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L235)
 
 Tear down provisioned hosts (reverse dependency order).
 
@@ -486,7 +486,7 @@ Tear down provisioned hosts (reverse dependency order).
 
 ### CertifiedArtifact
 
-Defined in: [intelligence/delivery.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L33)
+Defined in: [intelligence/delivery.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L34)
 
 A promoted, certified artifact (one entry in the composed profile).
 
@@ -496,31 +496,31 @@ A promoted, certified artifact (one entry in the composed profile).
 
 > **path**: `string` \| `null`
 
-Defined in: [intelligence/delivery.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L34)
+Defined in: [intelligence/delivery.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L35)
 
 ##### content
 
 > **content**: `string`
 
-Defined in: [intelligence/delivery.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L35)
+Defined in: [intelligence/delivery.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L36)
 
 ##### contentHash
 
 > **contentHash**: `string`
 
-Defined in: [intelligence/delivery.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L36)
+Defined in: [intelligence/delivery.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L37)
 
 ##### version
 
 > **version**: `number` \| `null`
 
-Defined in: [intelligence/delivery.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L37)
+Defined in: [intelligence/delivery.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L38)
 
 ##### lift
 
 > **lift**: `string` \| `null`
 
-Defined in: [intelligence/delivery.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L40)
+Defined in: [intelligence/delivery.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L41)
 
 Held-out gate lift attached at certification, e.g. "+3.1pp" — never a
  within-run claim. `null` when the promotion carried no lift record.
@@ -529,13 +529,13 @@ Held-out gate lift attached at certification, e.g. "+3.1pp" — never a
 
 > **promotedAt**: `string`
 
-Defined in: [intelligence/delivery.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L41)
+Defined in: [intelligence/delivery.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L42)
 
 ***
 
 ### CertifiedPromptSurface
 
-Defined in: [intelligence/delivery.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L45)
+Defined in: [intelligence/delivery.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L46)
 
 The active promoted prompt surface for a target.
 
@@ -545,31 +545,31 @@ The active promoted prompt surface for a target.
 
 > **surface**: `string`
 
-Defined in: [intelligence/delivery.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L46)
+Defined in: [intelligence/delivery.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L47)
 
 ##### surfaceHash
 
 > **surfaceHash**: `string`
 
-Defined in: [intelligence/delivery.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L47)
+Defined in: [intelligence/delivery.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L48)
 
 ##### version
 
 > **version**: `number` \| `null`
 
-Defined in: [intelligence/delivery.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L48)
+Defined in: [intelligence/delivery.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L49)
 
 ##### lift
 
 > **lift**: `string` \| `null`
 
-Defined in: [intelligence/delivery.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L49)
+Defined in: [intelligence/delivery.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L50)
 
 ***
 
 ### CertifiedProfile
 
-Defined in: [intelligence/delivery.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L54)
+Defined in: [intelligence/delivery.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L55)
 
 The composed certified profile — exactly the shape the plane's
  `GET /v1/profiles/:target/composed` returns.
@@ -580,31 +580,31 @@ The composed certified profile — exactly the shape the plane's
 
 > **target**: `string`
 
-Defined in: [intelligence/delivery.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L55)
+Defined in: [intelligence/delivery.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L56)
 
 ##### generatedAt
 
 > **generatedAt**: `string`
 
-Defined in: [intelligence/delivery.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L56)
+Defined in: [intelligence/delivery.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L57)
 
 ##### promptSurface
 
 > **promptSurface**: [`CertifiedPromptSurface`](#certifiedpromptsurface) \| `null`
 
-Defined in: [intelligence/delivery.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L57)
+Defined in: [intelligence/delivery.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L58)
 
 ##### artifacts
 
 > **artifacts**: `Record`\<`string`, [`CertifiedArtifact`](#certifiedartifact)[]\>
 
-Defined in: [intelligence/delivery.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L58)
+Defined in: [intelligence/delivery.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L59)
 
 ***
 
 ### PullCertifiedOptions
 
-Defined in: [intelligence/delivery.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L67)
+Defined in: [intelligence/delivery.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L68)
 
 #### Extended by
 
@@ -616,7 +616,7 @@ Defined in: [intelligence/delivery.ts:67](https://github.com/tangle-network/agen
 
 > **target**: `string`
 
-Defined in: [intelligence/delivery.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L69)
+Defined in: [intelligence/delivery.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L70)
 
 The agent target certified artifacts are promoted under.
 
@@ -624,7 +624,7 @@ The agent target certified artifacts are promoted under.
 
 > `optional` **apiKey?**: `string`
 
-Defined in: [intelligence/delivery.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L71)
+Defined in: [intelligence/delivery.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L72)
 
 Bearer key. Defaults to `process.env.TANGLE_API_KEY`.
 
@@ -632,7 +632,7 @@ Bearer key. Defaults to `process.env.TANGLE_API_KEY`.
 
 > `optional` **baseUrl?**: `string`
 
-Defined in: [intelligence/delivery.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L74)
+Defined in: [intelligence/delivery.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L75)
 
 Plane base URL. Defaults to `process.env.TANGLE_INTELLIGENCE_URL` then
  `https://intelligence.tangle.tools`.
@@ -641,7 +641,7 @@ Plane base URL. Defaults to `process.env.TANGLE_INTELLIGENCE_URL` then
 
 > `optional` **fetchImpl?**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [intelligence/delivery.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L76)
+Defined in: [intelligence/delivery.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L77)
 
 fetch impl (tests / non-global-fetch runtimes). Defaults to global fetch.
 
@@ -663,7 +663,7 @@ fetch impl (tests / non-global-fetch runtimes). Defaults to global fetch.
 
 > `optional` **timeoutMs?**: `number`
 
-Defined in: [intelligence/delivery.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L80)
+Defined in: [intelligence/delivery.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L81)
 
 Abort the pull after this many ms so a hung plane never blocks the caller.
  Default 10000. The timeout surfaces as a normal fail-closed `succeeded:
@@ -673,7 +673,7 @@ Abort the pull after this many ms so a hung plane never blocks the caller.
 
 ### CertifiedPromptSource
 
-Defined in: [intelligence/delivery.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L186)
+Defined in: [intelligence/delivery.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L187)
 
 A cached, self-refreshing source of a target's certified prompt additions —
  the prompt-only delivery lane for callers that assemble their OWN system
@@ -688,7 +688,7 @@ A cached, self-refreshing source of a target's certified prompt additions —
 
 > **compose**(`base`): `Promise`\<`string`\>
 
-Defined in: [intelligence/delivery.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L189)
+Defined in: [intelligence/delivery.ts:190](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L190)
 
 Refresh (window-respecting) then fold the certified additions into a
  base system prompt. Returns `base` unchanged when nothing is promoted.
@@ -707,7 +707,7 @@ Refresh (window-respecting) then fold the certified additions into a
 
 > **current**(): [`CertifiedProfile`](#certifiedprofile) \| `null`
 
-Defined in: [intelligence/delivery.ts:191](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L191)
+Defined in: [intelligence/delivery.ts:192](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L192)
 
 The certified profile currently in effect (`null` = none pulled yet).
 
@@ -719,7 +719,7 @@ The certified profile currently in effect (`null` = none pulled yet).
 
 > **refresh**(): `Promise`\<`void`\>
 
-Defined in: [intelligence/delivery.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L193)
+Defined in: [intelligence/delivery.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L194)
 
 Pull now if the refresh window has elapsed; coalesced and fail-closed.
 
@@ -731,7 +731,7 @@ Pull now if the refresh window has elapsed; coalesced and fail-closed.
 
 ### CertifiedPromptSourceOptions
 
-Defined in: [intelligence/delivery.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L198)
+Defined in: [intelligence/delivery.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L199)
 
 Options for [createCertifiedPromptSource](#createcertifiedpromptsource) — the pull coordinates plus
  the refresh cadence.
@@ -746,7 +746,7 @@ Options for [createCertifiedPromptSource](#createcertifiedpromptsource) — the
 
 > **target**: `string`
 
-Defined in: [intelligence/delivery.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L69)
+Defined in: [intelligence/delivery.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L70)
 
 The agent target certified artifacts are promoted under.
 
@@ -758,7 +758,7 @@ The agent target certified artifacts are promoted under.
 
 > `optional` **apiKey?**: `string`
 
-Defined in: [intelligence/delivery.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L71)
+Defined in: [intelligence/delivery.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L72)
 
 Bearer key. Defaults to `process.env.TANGLE_API_KEY`.
 
@@ -770,7 +770,7 @@ Bearer key. Defaults to `process.env.TANGLE_API_KEY`.
 
 > `optional` **baseUrl?**: `string`
 
-Defined in: [intelligence/delivery.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L74)
+Defined in: [intelligence/delivery.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L75)
 
 Plane base URL. Defaults to `process.env.TANGLE_INTELLIGENCE_URL` then
  `https://intelligence.tangle.tools`.
@@ -783,7 +783,7 @@ Plane base URL. Defaults to `process.env.TANGLE_INTELLIGENCE_URL` then
 
 > `optional` **fetchImpl?**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [intelligence/delivery.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L76)
+Defined in: [intelligence/delivery.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L77)
 
 fetch impl (tests / non-global-fetch runtimes). Defaults to global fetch.
 
@@ -809,7 +809,7 @@ fetch impl (tests / non-global-fetch runtimes). Defaults to global fetch.
 
 > `optional` **timeoutMs?**: `number`
 
-Defined in: [intelligence/delivery.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L80)
+Defined in: [intelligence/delivery.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L81)
 
 Abort the pull after this many ms so a hung plane never blocks the caller.
  Default 10000. The timeout surfaces as a normal fail-closed `succeeded:
@@ -823,7 +823,7 @@ Abort the pull after this many ms so a hung plane never blocks the caller.
 
 > `optional` **refreshMs?**: `number`
 
-Defined in: [intelligence/delivery.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L200)
+Defined in: [intelligence/delivery.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L201)
 
 Min interval between certified-profile pulls. Default 5m.
 
@@ -831,7 +831,7 @@ Min interval between certified-profile pulls. Default 5m.
 
 ### AppliedIntelligence
 
-Defined in: [intelligence/delivery.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L245)
+Defined in: [intelligence/delivery.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L246)
 
 What the delivery wrapper hands the agent each run.
 
@@ -841,7 +841,7 @@ What the delivery wrapper hands the agent each run.
 
 > **certified**: [`CertifiedProfile`](#certifiedprofile) \| `null`
 
-Defined in: [intelligence/delivery.ts:248](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L248)
+Defined in: [intelligence/delivery.ts:249](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L249)
 
 The certified profile in effect (null when none promoted / pull failed —
  fail-closed: the agent runs on its base surface).
@@ -852,7 +852,7 @@ The certified profile in effect (null when none promoted / pull failed —
 
 > **composePrompt**(`base`): `string`
 
-Defined in: [intelligence/delivery.ts:250](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L250)
+Defined in: [intelligence/delivery.ts:251](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L251)
 
 Fold the certified prompt surface into a base system prompt.
 
@@ -870,7 +870,7 @@ Fold the certified prompt surface into a base system prompt.
 
 ### DeliveryConfig
 
-Defined in: [intelligence/delivery.ts:258](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L258)
+Defined in: [intelligence/delivery.ts:259](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L259)
 
 Delivery config = the Observe config plus the pull target + refresh cadence.
 
@@ -884,7 +884,7 @@ Delivery config = the Observe config plus the pull target + refresh cadence.
 
 > `optional` **target?**: `string`
 
-Defined in: [intelligence/delivery.ts:260](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L260)
+Defined in: [intelligence/delivery.ts:261](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L261)
 
 Pull target. Defaults to `project`.
 
@@ -892,7 +892,7 @@ Pull target. Defaults to `project`.
 
 > `optional` **baseUrl?**: `string`
 
-Defined in: [intelligence/delivery.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L263)
+Defined in: [intelligence/delivery.ts:264](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L264)
 
 Plane base URL for the pull (NOT the OTLP `endpoint`). Defaults to
  `TANGLE_INTELLIGENCE_URL` then `https://intelligence.tangle.tools`.
@@ -901,7 +901,7 @@ Plane base URL for the pull (NOT the OTLP `endpoint`). Defaults to
 
 > `optional` **refreshMs?**: `number`
 
-Defined in: [intelligence/delivery.ts:265](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L265)
+Defined in: [intelligence/delivery.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L266)
 
 Min interval between certified-profile pulls. Default 5m.
 
@@ -909,7 +909,7 @@ Min interval between certified-profile pulls. Default 5m.
 
 > `optional` **timeoutMs?**: `number`
 
-Defined in: [intelligence/delivery.ts:267](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L267)
+Defined in: [intelligence/delivery.ts:268](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L268)
 
 Per-pull timeout in ms (fail-closed on a hung plane). Default 10000.
 
@@ -917,7 +917,7 @@ Per-pull timeout in ms (fail-closed on a hung plane). Default 10000.
 
 > `optional` **fetchImpl?**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [intelligence/delivery.ts:269](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L269)
+Defined in: [intelligence/delivery.ts:270](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L270)
 
 fetch impl for the pull (tests). Defaults to global fetch.
 
@@ -939,7 +939,7 @@ fetch impl for the pull (tests). Defaults to global fetch.
 
 > **project**: `string`
 
-Defined in: [intelligence/index.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L131)
+Defined in: [intelligence/index.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L132)
 
 Stable project id — the tenant dimension every trace is tagged with.
 
@@ -951,7 +951,7 @@ Stable project id — the tenant dimension every trace is tagged with.
 
 > `optional` **apiKey?**: `string`
 
-Defined in: [intelligence/index.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L133)
+Defined in: [intelligence/index.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L134)
 
 Bearer key for the Intelligence ingest. Reads `TANGLE_API_KEY` when omitted.
 
@@ -963,7 +963,7 @@ Bearer key for the Intelligence ingest. Reads `TANGLE_API_KEY` when omitted.
 
 > `optional` **effort?**: [`EffortTier`](#efforttier) \| \{ `tier`: [`EffortTier`](#efforttier); `overrides?`: `Partial`\<[`EffortSettings`](#effortsettings)\>; \}
 
-Defined in: [intelligence/index.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L135)
+Defined in: [intelligence/index.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L136)
 
 Effort tier (default `'standard'`) plus optional per-field overrides.
 
@@ -975,7 +975,7 @@ Effort tier (default `'standard'`) plus optional per-field overrides.
 
 > `optional` **endpoint?**: `string`
 
-Defined in: [intelligence/index.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L142)
+Defined in: [intelligence/index.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L143)
 
 OTLP ingest base. The underlying exporter appends `/v1/traces`, so point
 this at the OTLP route (e.g. `https://intelligence.tangle.tools/v1/otlp`).
@@ -990,7 +990,7 @@ omitted; absent all three, export is a no-op (best-effort by construction).
 
 > `optional` **redact?**: `false` \| [`Redactor`](#redactor)
 
-Defined in: [intelligence/index.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L148)
+Defined in: [intelligence/index.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L149)
 
 Redaction hook run over every exported input/output. A function replaces
 the default scrubber; `false` opts out entirely (raw fidelity, caller has
@@ -1004,7 +1004,7 @@ sanitized upstream); omitted ⇒ the built-in `defaultRedactor`.
 
 > `optional` **surfaces?**: `string`[]
 
-Defined in: [intelligence/index.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L150)
+Defined in: [intelligence/index.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L151)
 
 Mutable surfaces a later PR mode would edit. Recorded for `doctor()` only.
 
@@ -1016,7 +1016,7 @@ Mutable surfaces a later PR mode would edit. Recorded for `doctor()` only.
 
 > `optional` **checks?**: `string`[]
 
-Defined in: [intelligence/index.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L152)
+Defined in: [intelligence/index.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L153)
 
 Verification checks a later PR mode would gate on. Recorded for `doctor()` only.
 
@@ -1028,7 +1028,7 @@ Verification checks a later PR mode would gate on. Recorded for `doctor()` only.
 
 > `optional` **repo?**: [`RepoConfig`](#repoconfig)
 
-Defined in: [intelligence/index.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L154)
+Defined in: [intelligence/index.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L155)
 
 Repo access a later PR mode would need. Recorded for `doctor()` only.
 
@@ -1040,7 +1040,7 @@ Repo access a later PR mode would need. Recorded for `doctor()` only.
 
 ### EffortSettings
 
-Defined in: [intelligence/effort.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L31)
+Defined in: [intelligence/effort.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L32)
 
 The flat, resolved settings a tier compiles to. Every field is individually
 overridable through `resolveEffort`. Pure data — read by the wrapper, never
@@ -1052,7 +1052,7 @@ self-executing.
 
 > **analysts**: `boolean`
 
-Defined in: [intelligence/effort.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L33)
+Defined in: [intelligence/effort.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L34)
 
 Whether trace-derived analyst diagnosis may spawn. `false` ⇒ no analyst.
 
@@ -1060,7 +1060,7 @@ Whether trace-derived analyst diagnosis may spawn. `false` ⇒ no analyst.
 
 > **corpus**: [`CorpusAccess`](#corpusaccess)
 
-Defined in: [intelligence/effort.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L35)
+Defined in: [intelligence/effort.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L36)
 
 Cross-run corpus access this tier permits.
 
@@ -1068,7 +1068,7 @@ Cross-run corpus access this tier permits.
 
 > **fanout**: `number`
 
-Defined in: [intelligence/effort.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L37)
+Defined in: [intelligence/effort.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L38)
 
 Parallel candidate width. `1` ⇒ single-shot, no breadth.
 
@@ -1076,7 +1076,7 @@ Parallel candidate width. `1` ⇒ single-shot, no breadth.
 
 > **loops**: `boolean`
 
-Defined in: [intelligence/effort.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L39)
+Defined in: [intelligence/effort.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L40)
 
 Whether multi-step improvement loops (refine / fanout-vote) may run.
 
@@ -1084,7 +1084,7 @@ Whether multi-step improvement loops (refine / fanout-vote) may run.
 
 > **intelligenceBudgetUsd**: `number` \| `null`
 
-Defined in: [intelligence/effort.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L46)
+Defined in: [intelligence/effort.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L47)
 
 Ceiling, in USD, for INTELLIGENCE-class spawns only (analysts, corpus,
 loops) — NOT base inference. `0` refuses every intelligence spawn; `null`
@@ -1095,7 +1095,7 @@ inference is billed on its own channel and is never constrained here.
 
 ### EffortOverridesCompiled
 
-Defined in: [intelligence/effort.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L156)
+Defined in: [intelligence/effort.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L157)
 
 The run-config overrides an `EffortSettings` compiles to — the bridge between the
 pure effort policy and the orchestration entrypoints (`runPersonified` / the
@@ -1120,7 +1120,7 @@ loop. The caller reads these flags to decide WHAT to pass:
 
 > **withAnalyst**: `boolean`
 
-Defined in: [intelligence/effort.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L158)
+Defined in: [intelligence/effort.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L159)
 
 Construct + pass a `ScopeAnalyst`? `false` ⇒ omit it (degrade to the base agent).
 
@@ -1128,7 +1128,7 @@ Construct + pass a `ScopeAnalyst`? `false` ⇒ omit it (degrade to the base agen
 
 > **fanout**: `number`
 
-Defined in: [intelligence/effort.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L160)
+Defined in: [intelligence/effort.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L161)
 
 `ShapeBudget.fanout` width to pass to `runPersonified`.
 
@@ -1136,7 +1136,7 @@ Defined in: [intelligence/effort.ts:160](https://github.com/tangle-network/agent
 
 > **withLoops**: `boolean`
 
-Defined in: [intelligence/effort.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L162)
+Defined in: [intelligence/effort.ts:163](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L163)
 
 Run the multi-step improvement cycle, or no-op it for this run?
 
@@ -1144,7 +1144,7 @@ Run the multi-step improvement cycle, or no-op it for this run?
 
 > **intelligenceBudgetUsd**: `number` \| `null`
 
-Defined in: [intelligence/effort.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L164)
+Defined in: [intelligence/effort.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L165)
 
 Intelligence-class spend ceiling. `0` refuses every intelligence spawn; `null` uncapped.
 
@@ -1152,7 +1152,7 @@ Intelligence-class spend ceiling. `0` refuses every intelligence spawn; `null` u
 
 ### UsageSplit
 
-Defined in: [intelligence/index.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L110)
+Defined in: [intelligence/index.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L111)
 
 The per-class cost split carried by every trace and outcome. `off` ⇒
 `intelligenceUsd: 0` by construction — there is no intelligence spawn to
@@ -1164,7 +1164,7 @@ bill. This is a classification on the trace, NOT a budget-pool split.
 
 > **inferenceUsd**: `number`
 
-Defined in: [intelligence/index.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L112)
+Defined in: [intelligence/index.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L113)
 
 Base-stream (model) spend in USD.
 
@@ -1172,7 +1172,7 @@ Base-stream (model) spend in USD.
 
 > **intelligenceUsd**: `number`
 
-Defined in: [intelligence/index.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L114)
+Defined in: [intelligence/index.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L115)
 
 Intelligence-spawn spend in USD. Provably `0` at the OFF tier.
 
@@ -1180,7 +1180,7 @@ Intelligence-spawn spend in USD. Provably `0` at the OFF tier.
 
 ### RepoConfig
 
-Defined in: [intelligence/index.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L120)
+Defined in: [intelligence/index.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L121)
 
 Repo coordinates a product may declare for the (later) Gated-PR mode. The
  Observe slice only records their PRESENCE for `doctor()`; it never touches
@@ -1192,25 +1192,25 @@ Repo coordinates a product may declare for the (later) Gated-PR mode. The
 
 > **owner**: `string`
 
-Defined in: [intelligence/index.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L121)
+Defined in: [intelligence/index.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L122)
 
 ##### name
 
 > **name**: `string`
 
-Defined in: [intelligence/index.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L122)
+Defined in: [intelligence/index.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L123)
 
 ##### baseBranch
 
 > **baseBranch**: `string`
 
-Defined in: [intelligence/index.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L123)
+Defined in: [intelligence/index.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L124)
 
 ***
 
 ### IntelligenceConfig
 
-Defined in: [intelligence/index.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L129)
+Defined in: [intelligence/index.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L130)
 
 Client configuration. `project` + `apiKey` are the Observe minimum; the
  rest tune effort, endpoint, redaction, and (for `doctor()` readiness)
@@ -1226,7 +1226,7 @@ Client configuration. `project` + `apiKey` are the Observe minimum; the
 
 > **project**: `string`
 
-Defined in: [intelligence/index.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L131)
+Defined in: [intelligence/index.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L132)
 
 Stable project id — the tenant dimension every trace is tagged with.
 
@@ -1234,7 +1234,7 @@ Stable project id — the tenant dimension every trace is tagged with.
 
 > `optional` **apiKey?**: `string`
 
-Defined in: [intelligence/index.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L133)
+Defined in: [intelligence/index.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L134)
 
 Bearer key for the Intelligence ingest. Reads `TANGLE_API_KEY` when omitted.
 
@@ -1242,7 +1242,7 @@ Bearer key for the Intelligence ingest. Reads `TANGLE_API_KEY` when omitted.
 
 > `optional` **effort?**: [`EffortTier`](#efforttier) \| \{ `tier`: [`EffortTier`](#efforttier); `overrides?`: `Partial`\<[`EffortSettings`](#effortsettings)\>; \}
 
-Defined in: [intelligence/index.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L135)
+Defined in: [intelligence/index.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L136)
 
 Effort tier (default `'standard'`) plus optional per-field overrides.
 
@@ -1250,7 +1250,7 @@ Effort tier (default `'standard'`) plus optional per-field overrides.
 
 > `optional` **endpoint?**: `string`
 
-Defined in: [intelligence/index.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L142)
+Defined in: [intelligence/index.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L143)
 
 OTLP ingest base. The underlying exporter appends `/v1/traces`, so point
 this at the OTLP route (e.g. `https://intelligence.tangle.tools/v1/otlp`).
@@ -1261,7 +1261,7 @@ omitted; absent all three, export is a no-op (best-effort by construction).
 
 > `optional` **redact?**: `false` \| [`Redactor`](#redactor)
 
-Defined in: [intelligence/index.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L148)
+Defined in: [intelligence/index.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L149)
 
 Redaction hook run over every exported input/output. A function replaces
 the default scrubber; `false` opts out entirely (raw fidelity, caller has
@@ -1271,7 +1271,7 @@ sanitized upstream); omitted ⇒ the built-in `defaultRedactor`.
 
 > `optional` **surfaces?**: `string`[]
 
-Defined in: [intelligence/index.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L150)
+Defined in: [intelligence/index.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L151)
 
 Mutable surfaces a later PR mode would edit. Recorded for `doctor()` only.
 
@@ -1279,7 +1279,7 @@ Mutable surfaces a later PR mode would edit. Recorded for `doctor()` only.
 
 > `optional` **checks?**: `string`[]
 
-Defined in: [intelligence/index.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L152)
+Defined in: [intelligence/index.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L153)
 
 Verification checks a later PR mode would gate on. Recorded for `doctor()` only.
 
@@ -1287,7 +1287,7 @@ Verification checks a later PR mode would gate on. Recorded for `doctor()` only.
 
 > `optional` **repo?**: [`RepoConfig`](#repoconfig)
 
-Defined in: [intelligence/index.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L154)
+Defined in: [intelligence/index.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L155)
 
 Repo access a later PR mode would need. Recorded for `doctor()` only.
 
@@ -1295,7 +1295,7 @@ Repo access a later PR mode would need. Recorded for `doctor()` only.
 
 ### TraceMeta
 
-Defined in: [intelligence/index.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L158)
+Defined in: [intelligence/index.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L159)
 
 Metadata describing one traced run. `runId`/`traceId` default to fresh ids.
 
@@ -1305,7 +1305,7 @@ Metadata describing one traced run. `runId`/`traceId` default to fresh ids.
 
 > `optional` **input?**: `unknown`
 
-Defined in: [intelligence/index.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L160)
+Defined in: [intelligence/index.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L161)
 
 The run's input — exported through the redactor.
 
@@ -1313,7 +1313,7 @@ The run's input — exported through the redactor.
 
 > `optional` **runId?**: `string`
 
-Defined in: [intelligence/index.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L162)
+Defined in: [intelligence/index.ts:163](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L163)
 
 Stable run id. Defaults to a fresh id.
 
@@ -1321,7 +1321,7 @@ Stable run id. Defaults to a fresh id.
 
 > `optional` **traceId?**: `string`
 
-Defined in: [intelligence/index.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L164)
+Defined in: [intelligence/index.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L165)
 
 32-hex trace id. Defaults to a fresh id.
 
@@ -1329,7 +1329,7 @@ Defined in: [intelligence/index.ts:164](https://github.com/tangle-network/agent-
 
 > `optional` **model?**: `string`
 
-Defined in: [intelligence/index.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L166)
+Defined in: [intelligence/index.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L167)
 
 Model id, when known — stamped on the span.
 
@@ -1337,7 +1337,7 @@ Model id, when known — stamped on the span.
 
 > `optional` **provider?**: `string`
 
-Defined in: [intelligence/index.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L168)
+Defined in: [intelligence/index.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L169)
 
 Provider name, when known — stamped on the span.
 
@@ -1345,7 +1345,7 @@ Provider name, when known — stamped on the span.
 
 > `optional` **labels?**: `Record`\<`string`, `string` \| `number` \| `boolean`\>
 
-Defined in: [intelligence/index.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L170)
+Defined in: [intelligence/index.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L171)
 
 Arbitrary extra labels (string/number/boolean) stamped on the span.
 
@@ -1353,7 +1353,7 @@ Arbitrary extra labels (string/number/boolean) stamped on the span.
 
 ### TraceHandle
 
-Defined in: [intelligence/index.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L179)
+Defined in: [intelligence/index.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L180)
 
 The trace handle a `traceRun` body records into. `recordOutput` captures the
 agent's result (redacted on export); `recordOutcome` captures the scored
@@ -1366,7 +1366,7 @@ an un-recorded run still exports a span with whatever was set.
 
 > **recordOutput**(`output`): `void`
 
-Defined in: [intelligence/index.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L181)
+Defined in: [intelligence/index.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L182)
 
 Capture the run's output. Exported through the redactor.
 
@@ -1384,7 +1384,7 @@ Capture the run's output. Exported through the redactor.
 
 > **recordOutcome**(`outcome`): `void`
 
-Defined in: [intelligence/index.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L188)
+Defined in: [intelligence/index.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L189)
 
 Capture the run's outcome. `usage` defaults to inference-only
 (`intelligenceUsd: 0`) — the OFF baseline; an intelligence-enabled run
@@ -1419,7 +1419,7 @@ treated as pure inference.
 
 ### RecordTraceMeta
 
-Defined in: [intelligence/index.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L197)
+Defined in: [intelligence/index.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L198)
 
 Metadata for [IntelligenceClient.recordTrace](#recordtrace).
 
@@ -1429,7 +1429,7 @@ Metadata for [IntelligenceClient.recordTrace](#recordtrace).
 
 > `optional` **traceId?**: `string`
 
-Defined in: [intelligence/index.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L199)
+Defined in: [intelligence/index.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L200)
 
 32-hex trace id to anchor every span to. Defaults to a fresh id.
 
@@ -1437,7 +1437,7 @@ Defined in: [intelligence/index.ts:199](https://github.com/tangle-network/agent-
 
 > `optional` **rootParentSpanId?**: `string`
 
-Defined in: [intelligence/index.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L202)
+Defined in: [intelligence/index.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L203)
 
 Span id of an enclosing span the loop root should parent under (e.g. a
  `traceRun` span). Omitted ⇒ the loop root is the trace root.
@@ -1446,7 +1446,7 @@ Span id of an enclosing span the loop root should parent under (e.g. a
 
 ### TraceOutcome
 
-Defined in: [intelligence/index.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L207)
+Defined in: [intelligence/index.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L208)
 
 The resolved outcome of one traced run, surfaced on the export span and
  available to the caller for downstream billing assertions.
@@ -1457,25 +1457,25 @@ The resolved outcome of one traced run, surfaced on the export span and
 
 > **runId**: `string`
 
-Defined in: [intelligence/index.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L208)
+Defined in: [intelligence/index.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L209)
 
 ##### traceId
 
 > **traceId**: `string`
 
-Defined in: [intelligence/index.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L209)
+Defined in: [intelligence/index.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L210)
 
 ##### project
 
 > **project**: `string`
 
-Defined in: [intelligence/index.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L210)
+Defined in: [intelligence/index.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L211)
 
 ##### effort
 
 > **effort**: [`EffortSettings`](#effortsettings)
 
-Defined in: [intelligence/index.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L212)
+Defined in: [intelligence/index.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L213)
 
 The resolved effort settings this run executed under.
 
@@ -1483,7 +1483,7 @@ The resolved effort settings this run executed under.
 
 > **intelligenceOff**: `boolean`
 
-Defined in: [intelligence/index.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L214)
+Defined in: [intelligence/index.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L215)
 
 True when this run ran as pure passthrough (the OFF floor).
 
@@ -1491,19 +1491,19 @@ True when this run ran as pure passthrough (the OFF floor).
 
 > `optional` **success?**: `boolean`
 
-Defined in: [intelligence/index.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L215)
+Defined in: [intelligence/index.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L216)
 
 ##### score?
 
 > `optional` **score?**: `number`
 
-Defined in: [intelligence/index.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L216)
+Defined in: [intelligence/index.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L217)
 
 ##### usage
 
 > **usage**: [`UsageSplit`](#usagesplit)
 
-Defined in: [intelligence/index.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L218)
+Defined in: [intelligence/index.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L219)
 
 Per-class billing split. `intelligenceUsd` is `0` at the OFF tier.
 
@@ -1511,7 +1511,7 @@ Per-class billing split. `intelligenceUsd` is `0` at the OFF tier.
 
 ### IntelligenceClient
 
-Defined in: [intelligence/index.ts:222](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L222)
+Defined in: [intelligence/index.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L223)
 
 The Observe-mode Intelligence client.
 
@@ -1521,7 +1521,7 @@ The Observe-mode Intelligence client.
 
 > `readonly` **project**: `string`
 
-Defined in: [intelligence/index.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L224)
+Defined in: [intelligence/index.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L225)
 
 The resolved project id.
 
@@ -1529,7 +1529,7 @@ The resolved project id.
 
 > `readonly` **effort**: [`EffortSettings`](#effortsettings)
 
-Defined in: [intelligence/index.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L226)
+Defined in: [intelligence/index.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L227)
 
 The resolved effort settings.
 
@@ -1539,7 +1539,7 @@ The resolved effort settings.
 
 > **traceRun**\<`T`\>(`meta`, `fn`): `Promise`\<`T`\>
 
-Defined in: [intelligence/index.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L232)
+Defined in: [intelligence/index.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L233)
 
 Run `fn` under a trace, export one span best-effort, and return whatever
 `fn` returns. Telemetry-export failures are swallowed; an error THROWN by
@@ -1569,7 +1569,7 @@ Run `fn` under a trace, export one span best-effort, and return whatever
 
 > **recordTrace**(`events`, `meta?`): `string`
 
-Defined in: [intelligence/index.ts:242](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L242)
+Defined in: [intelligence/index.ts:243](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L243)
 
 Export a run's full loop topology — the ordered `LoopTraceEvent` stream a
 `runLoop`/`Supervisor` run emits — as a nested OTLP span tree (loop → round →
@@ -1597,7 +1597,7 @@ readonly [`LoopTraceEvent`](runtime.md#looptraceevent)[]
 
 > **doctor**(): [`DoctorReport`](#doctorreport)
 
-Defined in: [intelligence/index.ts:248](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L248)
+Defined in: [intelligence/index.ts:249](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L249)
 
 Network-free readiness report: which adoption modes are reachable given
 this config. Observe is always reachable; Recommend needs outcomes; PR
@@ -1611,7 +1611,7 @@ needs checks + surfaces + repo.
 
 > **flush**(): `Promise`\<`void`\>
 
-Defined in: [intelligence/index.ts:250](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L250)
+Defined in: [intelligence/index.ts:251](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L251)
 
 Flush any pending export spans. Best-effort; resolves even if export fails.
 
@@ -1623,7 +1623,7 @@ Flush any pending export spans. Best-effort; resolves even if export fails.
 
 ### ModeReadiness
 
-Defined in: [intelligence/index.ts:254](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L254)
+Defined in: [intelligence/index.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L255)
 
 One mode's readiness verdict.
 
@@ -1633,13 +1633,13 @@ One mode's readiness verdict.
 
 > **ready**: `boolean`
 
-Defined in: [intelligence/index.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L255)
+Defined in: [intelligence/index.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L256)
 
 ##### missing
 
 > **missing**: `string`[]
 
-Defined in: [intelligence/index.ts:257](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L257)
+Defined in: [intelligence/index.ts:258](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L258)
 
 Inputs this mode still needs, when not ready. Empty when ready.
 
@@ -1647,7 +1647,7 @@ Inputs this mode still needs, when not ready. Empty when ready.
 
 ### DoctorReport
 
-Defined in: [intelligence/index.ts:261](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L261)
+Defined in: [intelligence/index.ts:262](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L262)
 
 The `doctor()` readiness report — Mode-readiness without any network call.
 
@@ -1657,19 +1657,19 @@ The `doctor()` readiness report — Mode-readiness without any network call.
 
 > **project**: `string`
 
-Defined in: [intelligence/index.ts:262](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L262)
+Defined in: [intelligence/index.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L263)
 
 ##### effort
 
 > **effort**: [`EffortSettings`](#effortsettings)
 
-Defined in: [intelligence/index.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L263)
+Defined in: [intelligence/index.ts:264](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L264)
 
 ##### exportConfigured
 
 > **exportConfigured**: `boolean`
 
-Defined in: [intelligence/index.ts:265](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L265)
+Defined in: [intelligence/index.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L266)
 
 True when an OTLP endpoint is configured (export will actually ship).
 
@@ -1677,7 +1677,7 @@ True when an OTLP endpoint is configured (export will actually ship).
 
 > **modes**: `object`
 
-Defined in: [intelligence/index.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L266)
+Defined in: [intelligence/index.ts:267](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L267)
 
 ###### observe
 
@@ -1695,7 +1695,7 @@ Defined in: [intelligence/index.ts:266](https://github.com/tangle-network/agent-
 
 ### ProvisionedHost
 
-Defined in: [intelligence/resolver.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L49)
+Defined in: [intelligence/resolver.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L50)
 
 A live, provisioned host the resolver tore up for a `process-on-infra` arm.
  `teardown()` runs at `dispose()` in reverse provisioning order.
@@ -1706,7 +1706,7 @@ A live, provisioned host the resolver tore up for a `process-on-infra` arm.
 
 > `optional` **mcpConnection?**: `AgentProfileMcpServer`
 
-Defined in: [intelligence/resolver.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L52)
+Defined in: [intelligence/resolver.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L53)
 
 Lower the inner binding's mcp connection now that the host is up; the URL/
  command points at the host. Absent when the host serves a non-mcp inner.
@@ -1717,7 +1717,7 @@ Lower the inner binding's mcp connection now that the host is up; the URL/
 
 > **teardown**(): `Promise`\<`void`\>
 
-Defined in: [intelligence/resolver.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L53)
+Defined in: [intelligence/resolver.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L54)
 
 ###### Returns
 
@@ -1727,7 +1727,7 @@ Defined in: [intelligence/resolver.ts:53](https://github.com/tangle-network/agen
 
 ### ResolveCtx
 
-Defined in: [intelligence/resolver.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L61)
+Defined in: [intelligence/resolver.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L62)
 
 Per-call, per-tenant context the resolver reads. Everything that touches the
 network, a secret, or an infra provisioner is INJECTED so the manifest carries
@@ -1739,7 +1739,7 @@ no live secret and the substrate-free caller wires only what it can host.
 
 > `optional` **tenant?**: `string`
 
-Defined in: [intelligence/resolver.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L63)
+Defined in: [intelligence/resolver.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L64)
 
 Stable tenant id — namespaces billing + teardown (`tenant#target`).
 
@@ -1747,7 +1747,7 @@ Stable tenant id — namespaces billing + teardown (`tenant#target`).
 
 > `optional` **fetchImpl?**: (`input`, `init?`) => `Promise`\<`Response`\>
 
-Defined in: [intelligence/resolver.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L65)
+Defined in: [intelligence/resolver.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L66)
 
 fetch impl for http tools. Defaults to global fetch; absent ⇒ http tools fail loud.
 
@@ -1769,7 +1769,7 @@ fetch impl for http tools. Defaults to global fetch; absent ⇒ http tools fail
 
 > `optional` **resolveSecret?**: (`auth`, `tenant`) => `Promise`\<\{ `succeeded`: `true`; `value`: `string`; \} \| \{ `succeeded`: `false`; `error`: `string`; \}\>
 
-Defined in: [intelligence/resolver.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L71)
+Defined in: [intelligence/resolver.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L72)
 
 Resolve a declared credential to a live secret for THIS tenant. Returns a
 typed outcome — inspect `succeeded` before `value`. Absent ⇒ a binding that
@@ -1793,7 +1793,7 @@ declares non-`none` auth fails loud (never a request with no credential).
 
 > `optional` **runSandboxCode?**: (`code`, `entry`, `args`, `task`) => `Promise`\<`string`\>
 
-Defined in: [intelligence/resolver.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L80)
+Defined in: [intelligence/resolver.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L81)
 
 Run a `sandbox-code` body per call. Injected by the host that owns a sandbox
 client (the spine does not import the sandbox executor). Absent ⇒
@@ -1825,7 +1825,7 @@ client (the spine does not import the sandbox executor). Absent ⇒
 
 > `optional` **provisionHost?**: (`host`, `inner`, `costTag`) => `Promise`\<[`ProvisionedHost`](#provisionedhost)\>
 
-Defined in: [intelligence/resolver.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L92)
+Defined in: [intelligence/resolver.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L93)
 
 Provision a host for a `process-on-infra` binding, then serve the inner
 binding inside it. Injected by the host that owns `createExecutor`. Absent ⇒
@@ -1854,7 +1854,7 @@ binding INSIDE the host and returns the connection + a teardown.
 
 > `optional` **probeLiveToolNames?**: (`capabilityId`) => `Promise`\<`string`[]\>
 
-Defined in: [intelligence/resolver.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L105)
+Defined in: [intelligence/resolver.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L106)
 
 Drift probe: return the LIVE tool names a resolved surface exposes for a
 given capability id (a `tools/list` over an mcp connection, the agent's
@@ -1877,7 +1877,7 @@ check enforces only the host-side executor↔spec parity (no live probe).
 
 > `optional` **onDrop?**: (`capabilityId`, `error`) => `void`
 
-Defined in: [intelligence/resolver.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L113)
+Defined in: [intelligence/resolver.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L114)
 
 Observe a DROPPED capability — a per-capability resolve failure that is
 fail-closed (the capability is omitted, never half-wired). The drop is the
@@ -1905,7 +1905,7 @@ carrying an un-admitted binding kind is a hard error, not a soft drop).
 
 > **JsonSchema** = `Record`\<`string`, `unknown`\>
 
-Defined in: [intelligence/capability.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L36)
+Defined in: [intelligence/capability.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L37)
 
 A JSON Schema object describing a tool's parameters. Kept structural — the
  resolver forwards it verbatim into a `ToolSpec` / MCP `tools/list` check.
@@ -1916,7 +1916,7 @@ A JSON Schema object describing a tool's parameters. Kept structural — the
 
 > **CapabilityInterface** = \{ `surface`: `"tool"`; `name`: `string`; `description?`: `string`; `parameters`: [`JsonSchema`](#jsonschema); `returns?`: [`JsonSchema`](#jsonschema); \} \| \{ `surface`: `"mcp"`; `serverName`: `string`; `toolset?`: `string`[]; \} \| \{ `surface`: `"context"`; `kind`: `"prompt-surface"` \| `"skill"` \| `"instructions"`; `name`: `string`; \} \| \{ `surface`: `"retrieval"`; `name`: `string`; `description?`: `string`; `topK?`: `number`; \} \| \{ `surface`: `"hook"`; `event`: `string`; `matcher?`: `string`; \} \| \{ `surface`: `"subagent"`; `name`: `string`; `description?`: `string`; \}
 
-Defined in: [intelligence/capability.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L42)
+Defined in: [intelligence/capability.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L43)
 
 What the agent consumes. CLOSED — a new runtime kind NEVER extends this. Each
 arm maps slot-for-slot onto `AgentProfile` + the host `RouterToolsSeam`.
@@ -1927,7 +1927,7 @@ arm maps slot-for-slot onto `AgentProfile` + the host `RouterToolsSeam`.
 
 > **CapabilitySurface** = [`CapabilityInterface`](#capabilityinterface)\[`"surface"`\]
 
-Defined in: [intelligence/capability.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L57)
+Defined in: [intelligence/capability.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L58)
 
 Every interface surface tag — the closed set the resolver fans into slots.
 
@@ -1937,7 +1937,7 @@ Every interface surface tag — the closed set the resolver fans into slots.
 
 > **ContentRef** = \{ `kind`: `"inline"`; `content`: `string`; \} \| \{ `kind`: `"github"`; `repository?`: `string`; `path`: `string`; `ref?`: `string`; \} \| \{ `kind`: `"blob"`; `uri`: `string`; `sha256`: `string`; `bytes?`: `number`; \}
 
-Defined in: [intelligence/capability.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L65)
+Defined in: [intelligence/capability.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L66)
 
 Where a capability's bytes live. A leaked manifest carries no live secret and
 no inlined blob: `github`/`blob` are pointers resolved at provision time.
@@ -1948,7 +1948,7 @@ no inlined blob: `github`/`blob` are pointers resolved at provision time.
 
 > **CapabilityAuth** = \{ `mode`: `"none"`; \} \| \{ `mode`: `"tangle-key"`; \} \| \{ `mode`: `"hub-connection"`; `providerId`: `string`; `scopes?`: `string`[]; \} \| \{ `mode`: `"secret-ref"`; `key`: `string`; \}
 
-Defined in: [intelligence/capability.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L80)
+Defined in: [intelligence/capability.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L81)
 
 How a binding authenticates at resolve time. Declared as a REQUIREMENT in the
 manifest; the live secret is resolved per-tenant by the resolver context,
@@ -1960,7 +1960,7 @@ never inlined here.
 
 > **DeliveryBinding** = \{ `kind`: `"inline"`; `content`: [`ContentRef`](#contentref); \} \| \{ `kind`: `"file"`; `path`: `string`; `content`: [`ContentRef`](#contentref); `executable?`: `boolean`; \} \| \{ `kind`: `"http"`; `url`: `string`; `method?`: `string`; `auth?`: [`CapabilityAuth`](#capabilityauth); \} \| \{ `kind`: `"sandbox-code"`; `entry`: `string`; `code`: [`ContentRef`](#contentref); `runtime?`: `string`; `harness?`: `string`; \} \| \{ `kind`: `"mcp-stdio"`; `command`: `string`; `args?`: `string`[]; `env?`: `Record`\<`string`, `string`\>; `cwd?`: `string`; \} \| \{ `kind`: `"mcp-remote"`; `url`: `string`; `transport`: `"http"` \| `"sse"`; `headers?`: `Record`\<`string`, `string`\>; \} \| \{ `kind`: `"process-on-infra"`; `host`: [`HostSpec`](#hostspec); `inner`: [`DeliveryBinding`](#deliverybinding); \} \| \{ `kind`: `"rag-index"`; `index`: [`ContentRef`](#contentref); `embedModel`: `string`; `topK?`: `number`; \} \| \{ `kind`: `"memory-store"`; `provision`: `"sqlite"` \| `"neo4j"` \| `"vector"`; `seed?`: [`ContentRef`](#contentref); \} \| \{ `kind`: `"wasm"`; `module`: [`ContentRef`](#contentref); `exports`: `string`[]; \} \| \{ `kind`: `"a2a"`; `endpoint`: `string`; `card`: [`ContentRef`](#contentref); `auth?`: [`CapabilityAuth`](#capabilityauth); \}
 
-Defined in: [intelligence/capability.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L108)
+Defined in: [intelligence/capability.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L109)
 
 How a capability is backed. OPEN tagged union — THE extension point. All arms
 are typed even when the resolver does not yet admit them; an un-admitted arm
@@ -1972,7 +1972,7 @@ throws [CapabilityNotAdmittedError](#capabilitynotadmittederror) at resolve, nev
 
 > **DeliveryBindingKind** = [`DeliveryBinding`](#deliverybinding)\[`"kind"`\]
 
-Defined in: [intelligence/capability.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L137)
+Defined in: [intelligence/capability.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L138)
 
 Every binding kind — the open set the resolver dispatches over.
 
@@ -1982,7 +1982,7 @@ Every binding kind — the open set the resolver dispatches over.
 
 > **PullOutcome** = \{ `succeeded`: `true`; `value`: [`CertifiedProfile`](#certifiedprofile); \} \| \{ `succeeded`: `false`; `error`: `string`; `status?`: `number`; \}
 
-Defined in: [intelligence/delivery.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L63)
+Defined in: [intelligence/delivery.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L64)
 
 Typed outcome for the pull — inspect `succeeded` before `value`. A 404
  (nothing promoted yet) is a normal, non-error `succeeded: false`.
@@ -1993,7 +1993,7 @@ Typed outcome for the pull — inspect `succeeded` before `value`. A 404
 
 > **DeliveredAgent**\<`I`, `O`\> = (`input`, `applied`) => `Promise`\<`O`\>
 
-Defined in: [intelligence/delivery.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L255)
+Defined in: [intelligence/delivery.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L256)
 
 An agent wrapped by [withCertifiedDelivery](#withcertifieddelivery): receives the input plus
  the certified intelligence delivered for this run.
@@ -2028,7 +2028,7 @@ An agent wrapped by [withCertifiedDelivery](#withcertifieddelivery): receives th
 
 > **EffortTier** = `"off"` \| `"eco"` \| `"standard"` \| `"thorough"` \| `"max"`
 
-Defined in: [intelligence/effort.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L19)
+Defined in: [intelligence/effort.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L20)
 
 The named effort tiers, lowest to highest. `'off'` is the honest floor
  below `'eco'`: intelligence fully off, telemetry still best-effort.
@@ -2039,7 +2039,7 @@ The named effort tiers, lowest to highest. `'off'` is the honest floor
 
 > **CorpusAccess** = `"off"` \| `"read"` \| `"read-write"`
 
-Defined in: [intelligence/effort.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L24)
+Defined in: [intelligence/effort.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L25)
 
 Corpus access an intelligence tier permits. `'off'` reads and writes
  nothing; `'read'` consults the cross-run corpus without contributing;
@@ -2051,7 +2051,7 @@ Corpus access an intelligence tier permits. `'off'` reads and writes
 
 > **EffortOverrides** = `Partial`\<[`EffortSettings`](#effortsettings)\>
 
-Defined in: [intelligence/effort.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L51)
+Defined in: [intelligence/effort.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L52)
 
 Per-field overrides applied on top of a tier preset. Any subset of the
  resolved settings; each provided field wins over the preset.
@@ -2062,7 +2062,7 @@ Per-field overrides applied on top of a tier preset. Any subset of the
 
 > **UsageClass** = `"inference"` \| `"intelligence"`
 
-Defined in: [intelligence/index.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L103)
+Defined in: [intelligence/index.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L104)
 
 Usage class for billing. Base-stream tokens bill `'inference'`; every
  intelligence spawn (analyst, corpus, loop) bills `'intelligence'`. The
@@ -2074,7 +2074,7 @@ Usage class for billing. Base-stream tokens bill `'inference'`; every
 
 > **Agent**\<`TInput`, `TOutput`\> = (`input`) => `Promise`\<`TOutput`\>
 
-Defined in: [intelligence/index.ts:519](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L519)
+Defined in: [intelligence/index.ts:520](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L520)
 
 A generic agent: one async input → output. The shape `withTangleIntelligence`
  preserves exactly.
@@ -2105,7 +2105,7 @@ A generic agent: one async input → output. The shape `withTangleIntelligence`
 
 > **ClientOrConfig** = [`IntelligenceClient`](#intelligenceclient) \| [`IntelligenceConfig`](#intelligenceconfig)
 
-Defined in: [intelligence/index.ts:522](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L522)
+Defined in: [intelligence/index.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L523)
 
 Either a built client or the config to build one.
 
@@ -2115,7 +2115,7 @@ Either a built client or the config to build one.
 
 > **Redactor** = (`value`) => `unknown`
 
-Defined in: [intelligence/redact.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/redact.ts#L17)
+Defined in: [intelligence/redact.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/redact.ts#L18)
 
 A redactor maps an arbitrary trace value to a safe-to-export value. Pure;
  must not throw on cyclic input (the default tolerates cycles).
@@ -2136,7 +2136,7 @@ A redactor maps an arbitrary trace value to a safe-to-export value. Pure;
 
 > `const` **defaultEffortTier**: [`EffortTier`](#efforttier) = `'standard'`
 
-Defined in: [intelligence/effort.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L94)
+Defined in: [intelligence/effort.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L95)
 
 The default tier when a client declares no effort. `'standard'` turns
  intelligence on with sensible knobs; opt down to `'off'`/`'eco'` or up to
@@ -2148,7 +2148,7 @@ The default tier when a client declares no effort. `'standard'` turns
 
 > **manifestFromProfile**(`profile`): [`CapabilityManifest`](#capabilitymanifest)
 
-Defined in: [intelligence/capability.ts:365](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L365)
+Defined in: [intelligence/capability.ts:366](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/capability.ts#L366)
 
 Lower the EXISTING plane wire (`CertifiedProfile`) into a `CapabilityManifest`.
 `prompt-surface`/`skill` artifacts → `context`/inline capabilities (the
@@ -2173,7 +2173,7 @@ This delivers the spine against today's wire before the plane changes.
 
 > **pullCertified**(`opts`): `Promise`\<[`PullOutcome`](#pulloutcome)\>
 
-Defined in: [intelligence/delivery.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L106)
+Defined in: [intelligence/delivery.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L107)
 
 Pull the certified composed profile for a target. Fail-closed: a network
 error or a non-2xx returns a typed `succeeded: false` (never throws), so a
@@ -2196,7 +2196,7 @@ the normal "nothing promoted yet" signal, carried as `status: 404`.
 
 > **composeCertifiedPrompt**(`base`, `certified`): `string`
 
-Defined in: [intelligence/delivery.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L166)
+Defined in: [intelligence/delivery.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L167)
 
 Fold the certified prompt surface (and any certified prompt-folding artifacts:
 `prompt-surface` / `skill` / `instructions`) into a base system prompt under a
@@ -2226,7 +2226,7 @@ usable certified content.
 
 > **createCertifiedPromptSource**(`opts`): [`CertifiedPromptSource`](#certifiedpromptsource)
 
-Defined in: [intelligence/delivery.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L209)
+Defined in: [intelligence/delivery.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L210)
 
 Create the cached certified-prompt source — the ONE module-scope-cache +
 coalesced-refresh + keep-last-known implementation. Product wiring uses this
@@ -2249,7 +2249,7 @@ rather than hand-rolling the same lines around `pullCertified`, and
 
 > **withCertifiedDelivery**\<`I`, `O`\>(`agent`, `config`): (`input`) => `Promise`\<`O`\> & `object`
 
-Defined in: [intelligence/delivery.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L280)
+Defined in: [intelligence/delivery.ts:281](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/delivery.ts#L281)
 
 Wrap an agent so it (a) Observes each run via the shipped Observe client and
 (b) RECEIVES the tenant's certified artifacts pulled from the deployed plane.
@@ -2288,7 +2288,7 @@ gate-certified surface, the next refresh delivers it to the running agent.
 
 > **resolveEffort**(`tier`, `overrides?`): [`EffortSettings`](#effortsettings)
 
-Defined in: [intelligence/effort.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L107)
+Defined in: [intelligence/effort.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L108)
 
 Compile a named tier (plus optional per-field overrides) into the flat
 `EffortSettings` the wrapper reads. Pure: same inputs → same object, no I/O,
@@ -2320,7 +2320,7 @@ owns, not a default the composer leaks.
 
 > **isIntelligenceOff**(`settings`): `boolean`
 
-Defined in: [intelligence/effort.ts:128](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L128)
+Defined in: [intelligence/effort.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L129)
 
 True when these settings admit NO intelligence spawn — the passthrough
 predicate the wrapper branches on. Every intelligence axis must be off:
@@ -2344,7 +2344,7 @@ OFF floor and the wrapper treats them as an intelligence-enabled run.
 
 > **compileEffort**(`settings`): [`EffortOverridesCompiled`](#effortoverridescompiled)
 
-Defined in: [intelligence/effort.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L178)
+Defined in: [intelligence/effort.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/effort.ts#L179)
 
 Compile resolved `EffortSettings` into the orchestration overrides above. Pure: same
 input → same object, no I/O, no execution, no construction. It is the single place that
@@ -2372,7 +2372,7 @@ compile to `withAnalyst: true`, the tier's `fanout`, and `withLoops: true`.
 
 > **createIntelligenceClient**(`config`): [`IntelligenceClient`](#intelligenceclient)
 
-Defined in: [intelligence/index.ts:330](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L330)
+Defined in: [intelligence/index.ts:331](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L331)
 
 Create an Observe-mode Intelligence client. Resolves effort, endpoint, and
 redactor up front; the exporter is built lazily and is `undefined` when no
@@ -2395,7 +2395,7 @@ construction).
 
 > **withTangleIntelligence**\<`TInput`, `TOutput`\>(`agent`, `clientOrConfig`): [`Agent`](#agent)\<`TInput`, `TOutput`\>
 
-Defined in: [intelligence/index.ts:537](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L537)
+Defined in: [intelligence/index.ts:538](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/index.ts#L538)
 
 Wrap a generic `agent` with best-effort Observe-mode tracing, returning the
 SAME shape. Each call runs the agent under a trace and exports one span; an
@@ -2435,7 +2435,7 @@ zero intelligence spawns, `intelligenceUsd: 0` on the trace.
 
 > **defaultRedactor**(`value`): `unknown`
 
-Defined in: [intelligence/redact.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/redact.ts#L56)
+Defined in: [intelligence/redact.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/redact.ts#L57)
 
 The built-in redactor. Walks objects and arrays; replaces values under
 secret-bearing keys wholesale; scrubs in-value patterns from every string.
@@ -2458,7 +2458,7 @@ Cycle-safe (a seen-set short-circuits self-referential payloads to
 
 > **resolveRedactor**(`redact`): [`Redactor`](#redactor)
 
-Defined in: [intelligence/redact.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/redact.ts#L91)
+Defined in: [intelligence/redact.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/redact.ts#L92)
 
 Resolve the redactor a client uses. A caller-supplied hook replaces the
 default entirely (the customer owns their PII rules); absent one, the
@@ -2482,7 +2482,7 @@ fidelity. Opt-out is loud (an explicit `false`), never a silent default.
 
 > **composeCertifiedProfile**(`base`, `manifest`, `ctx?`): `Promise`\<[`ResolvedSurface`](#resolvedsurface)\>
 
-Defined in: [intelligence/resolver.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L158)
+Defined in: [intelligence/resolver.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L159)
 
 Compose a certified profile into a uniform `ResolvedSurface`. Additive over
 `composeCertifiedPrompt`: the inline/context fold is delegated to
@@ -2518,7 +2518,7 @@ Fail-closed: a `null` manifest returns the base surface only.
 
 > **composeCertifiedProfileFromWire**(`base`, `profile`, `ctx?`): `Promise`\<[`ResolvedSurface`](#resolvedsurface)\>
 
-Defined in: [intelligence/resolver.ts:663](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L663)
+Defined in: [intelligence/resolver.ts:664](https://github.com/tangle-network/agent-runtime/blob/main/src/intelligence/resolver.ts#L664)
 
 Lower a plane `CertifiedProfile` straight into a `ResolvedSurface` via
  `manifestFromProfile` — the convenience the shipped pull lane calls when it
diff --git a/docs/api/mcp.md b/docs/api/mcp.md
index 730d4438..bdf6494b 100644
--- a/docs/api/mcp.md
+++ b/docs/api/mcp.md
@@ -10,7 +10,7 @@
 
 ### DelegationStateCorruptError
 
-Defined in: [mcp/delegation-store.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L54)
+Defined in: [mcp/delegation-store.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L55)
 
 **`Experimental`**
 
@@ -31,7 +31,7 @@ which archives the corrupt file and starts fresh.
 
 > **new DelegationStateCorruptError**(`message`, `options?`): [`DelegationStateCorruptError`](#delegationstatecorrupterror)
 
-Defined in: [mcp/delegation-store.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L55)
+Defined in: [mcp/delegation-store.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L56)
 
 **`Experimental`**
 
@@ -59,7 +59,7 @@ Defined in: [mcp/delegation-store.ts:55](https://github.com/tangle-network/agent
 
 ### DelegationPersistenceError
 
-Defined in: [mcp/delegation-store.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L68)
+Defined in: [mcp/delegation-store.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L69)
 
 **`Experimental`**
 
@@ -78,7 +78,7 @@ silently demote durable mode to in-memory mode.
 
 > **new DelegationPersistenceError**(`message`, `options?`): [`DelegationPersistenceError`](#delegationpersistenceerror)
 
-Defined in: [mcp/delegation-store.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L69)
+Defined in: [mcp/delegation-store.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L70)
 
 **`Experimental`**
 
@@ -106,7 +106,7 @@ Defined in: [mcp/delegation-store.ts:69](https://github.com/tangle-network/agent
 
 ### InMemoryDelegationStore
 
-Defined in: [mcp/delegation-store.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L75)
+Defined in: [mcp/delegation-store.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L76)
 
 **`Experimental`**
 
@@ -132,7 +132,7 @@ Defined in: [mcp/delegation-store.ts:75](https://github.com/tangle-network/agent
 
 > **loadAll**(): `Promise`\<[`DelegationRecord`](#delegationrecord)[]\>
 
-Defined in: [mcp/delegation-store.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L78)
+Defined in: [mcp/delegation-store.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L79)
 
 **`Experimental`**
 
@@ -153,7 +153,7 @@ file is an empty store; an unparseable one throws
 
 > **upsert**(`record`): `Promise`\<`void`\>
 
-Defined in: [mcp/delegation-store.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L82)
+Defined in: [mcp/delegation-store.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L83)
 
 **`Experimental`**
 
@@ -177,7 +177,7 @@ Insert or replace the record keyed by `record.taskId`.
 
 > **lookupIdempotencyKey**(`key`): `Promise`\<`string` \| `undefined`\>
 
-Defined in: [mcp/delegation-store.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L86)
+Defined in: [mcp/delegation-store.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L87)
 
 **`Experimental`**
 
@@ -204,7 +204,7 @@ processes without holding the full record set.
 
 > **remove**(`taskIds`): `Promise`\<`void`\>
 
-Defined in: [mcp/delegation-store.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L93)
+Defined in: [mcp/delegation-store.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L94)
 
 **`Experimental`**
 
@@ -228,7 +228,7 @@ readonly `string`[]
 
 ### FileDelegationStore
 
-Defined in: [mcp/delegation-store.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L130)
+Defined in: [mcp/delegation-store.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L131)
 
 **`Experimental`**
 
@@ -252,7 +252,7 @@ and corruption-detectable without a database dependency.
 
 > **new FileDelegationStore**(`options`): [`FileDelegationStore`](#filedelegationstore)
 
-Defined in: [mcp/delegation-store.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L138)
+Defined in: [mcp/delegation-store.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L139)
 
 **`Experimental`**
 
@@ -272,7 +272,7 @@ Defined in: [mcp/delegation-store.ts:138](https://github.com/tangle-network/agen
 
 > **loadAll**(): `Promise`\<[`DelegationRecord`](#delegationrecord)[]\>
 
-Defined in: [mcp/delegation-store.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L143)
+Defined in: [mcp/delegation-store.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L144)
 
 **`Experimental`**
 
@@ -293,7 +293,7 @@ file is an empty store; an unparseable one throws
 
 > **upsert**(`record`): `Promise`\<`void`\>
 
-Defined in: [mcp/delegation-store.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L180)
+Defined in: [mcp/delegation-store.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L181)
 
 **`Experimental`**
 
@@ -317,7 +317,7 @@ Insert or replace the record keyed by `record.taskId`.
 
 > **lookupIdempotencyKey**(`key`): `Promise`\<`string` \| `undefined`\>
 
-Defined in: [mcp/delegation-store.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L186)
+Defined in: [mcp/delegation-store.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L187)
 
 **`Experimental`**
 
@@ -344,7 +344,7 @@ processes without holding the full record set.
 
 > **remove**(`taskIds`): `Promise`\<`void`\>
 
-Defined in: [mcp/delegation-store.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L194)
+Defined in: [mcp/delegation-store.ts:195](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L195)
 
 **`Experimental`**
 
@@ -368,7 +368,7 @@ readonly `string`[]
 
 ### InMemoryFeedbackStore
 
-Defined in: [mcp/feedback-store.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L41)
+Defined in: [mcp/feedback-store.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L42)
 
 **`Experimental`**
 
@@ -394,7 +394,7 @@ Defined in: [mcp/feedback-store.ts:41](https://github.com/tangle-network/agent-r
 
 > **put**(`event`): `Promise`\<`void`\>
 
-Defined in: [mcp/feedback-store.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L44)
+Defined in: [mcp/feedback-store.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L45)
 
 **`Experimental`**
 
@@ -418,7 +418,7 @@ Append a new event. Never dedupes — every rating is its own event.
 
 > **list**(`filter?`): `Promise`\<[`FeedbackEvent`](#feedbackevent)[]\>
 
-Defined in: [mcp/feedback-store.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L48)
+Defined in: [mcp/feedback-store.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L49)
 
 **`Experimental`**
 
@@ -449,7 +449,7 @@ across all namespaces. Returns events in insertion order.
 
 ### DelegationTaskQueue
 
-Defined in: [mcp/task-queue.ts:242](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L242)
+Defined in: [mcp/task-queue.ts:243](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L243)
 
 **`Experimental`**
 
@@ -459,7 +459,7 @@ Defined in: [mcp/task-queue.ts:242](https://github.com/tangle-network/agent-runt
 
 > **new DelegationTaskQueue**(`options?`): [`DelegationTaskQueue`](#delegationtaskqueue)
 
-Defined in: [mcp/task-queue.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L256)
+Defined in: [mcp/task-queue.ts:257](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L257)
 
 **`Experimental`**
 
@@ -479,7 +479,7 @@ Defined in: [mcp/task-queue.ts:256](https://github.com/tangle-network/agent-runt
 
 > `static` **restore**(`options?`): `Promise`\<[`DelegationTaskQueue`](#delegationtaskqueue)\>
 
-Defined in: [mcp/task-queue.ts:292](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L292)
+Defined in: [mcp/task-queue.ts:293](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L293)
 
 **`Experimental`**
 
@@ -509,7 +509,7 @@ The retention cap applies to the loaded set as well.
 
 > **submit**\<`Args`\>(`input`): [`SubmitOutput`](#submitoutput)
 
-Defined in: [mcp/task-queue.ts:305](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L305)
+Defined in: [mcp/task-queue.ts:306](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L306)
 
 **`Experimental`**
 
@@ -538,7 +538,7 @@ the queue does not accept work it cannot journal.
 
 > **status**(`taskId`, `opts?`): [`DelegationStatusResult`](#delegationstatusresult) \| `undefined`
 
-Defined in: [mcp/task-queue.ts:355](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L355)
+Defined in: [mcp/task-queue.ts:356](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L356)
 
 **`Experimental`**
 
@@ -567,7 +567,7 @@ default so status polls stay light.
 
 > **cancel**(`taskId`): `boolean`
 
-Defined in: [mcp/task-queue.ts:368](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L368)
+Defined in: [mcp/task-queue.ts:369](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L369)
 
 **`Experimental`**
 
@@ -591,7 +591,7 @@ UI on `running` forever.
 
 > **attachFeedback**(`taskId`, `snapshot`): `boolean`
 
-Defined in: [mcp/task-queue.ts:388](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L388)
+Defined in: [mcp/task-queue.ts:389](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L389)
 
 **`Experimental`**
 
@@ -618,7 +618,7 @@ kinds are not queue-bound).
 
 > **history**(`args?`): [`DelegationHistoryEntry`](#delegationhistoryentry)[]
 
-Defined in: [mcp/task-queue.ts:400](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L400)
+Defined in: [mcp/task-queue.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L401)
 
 **`Experimental`**
 
@@ -639,7 +639,7 @@ Query the recorded delegations. Returns entries newest-first (by
 
 > **flush**(): `Promise`\<`void`\>
 
-Defined in: [mcp/task-queue.ts:419](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L419)
+Defined in: [mcp/task-queue.ts:420](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L420)
 
 **`Experimental`**
 
@@ -655,7 +655,7 @@ handing the store's backing file to another process.
 
 > **inflightCount**(): `number`
 
-Defined in: [mcp/task-queue.ts:435](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L435)
+Defined in: [mcp/task-queue.ts:436](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L436)
 
 **`Experimental`**
 
@@ -669,7 +669,7 @@ Test-only — number of in-flight (non-terminal) records.
 
 ### DetectExecutorArgs
 
-Defined in: [mcp/bin-helpers.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L20)
+Defined in: [mcp/bin-helpers.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L21)
 
 **`Experimental`**
 
@@ -679,7 +679,7 @@ Defined in: [mcp/bin-helpers.ts:20](https://github.com/tangle-network/agent-runt
 
 > **sandboxClient**: [`SandboxClient`](runtime.md#sandboxclient-3)
 
-Defined in: [mcp/bin-helpers.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L21)
+Defined in: [mcp/bin-helpers.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L22)
 
 **`Experimental`**
 
@@ -687,7 +687,7 @@ Defined in: [mcp/bin-helpers.ts:21](https://github.com/tangle-network/agent-runt
 
 > `optional` **env?**: `Record`\<`string`, `string` \| `undefined`\>
 
-Defined in: [mcp/bin-helpers.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L23)
+Defined in: [mcp/bin-helpers.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L24)
 
 **`Experimental`**
 
@@ -697,7 +697,7 @@ Raw env (defaults to `process.env`). Pass an explicit map for tests.
 
 > `optional` **resolveFleet?**: (`client`, `fleetId`) => `Promise`\<[`FleetHandle`](#fleethandle)\>
 
-Defined in: [mcp/bin-helpers.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L29)
+Defined in: [mcp/bin-helpers.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L30)
 
 **`Experimental`**
 
@@ -723,7 +723,7 @@ shape against the structural `FleetHandle` contract.
 
 ### DelegateRunCtx
 
-Defined in: [mcp/delegates.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L56)
+Defined in: [mcp/delegates.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L57)
 
 **`Experimental`**
 
@@ -733,7 +733,7 @@ Defined in: [mcp/delegates.ts:56](https://github.com/tangle-network/agent-runtim
 
 > **signal**: `AbortSignal`
 
-Defined in: [mcp/delegates.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L57)
+Defined in: [mcp/delegates.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L58)
 
 **`Experimental`**
 
@@ -741,7 +741,7 @@ Defined in: [mcp/delegates.ts:57](https://github.com/tangle-network/agent-runtim
 
 > `optional` **detachedSessionRef?**: `string`
 
-Defined in: [mcp/delegates.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L65)
+Defined in: [mcp/delegates.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L66)
 
 **`Experimental`**
 
@@ -754,7 +754,7 @@ onto the `driveTurn` tick path instead of holding a stream.
 
 > `optional` **traceEmitter?**: [`LoopTraceEmitter`](runtime.md#looptraceemitter)
 
-Defined in: [mcp/delegates.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L74)
+Defined in: [mcp/delegates.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L75)
 
 **`Experimental`**
 
@@ -769,7 +769,7 @@ the same stream.
 
 > **report**(`progress`): `void`
 
-Defined in: [mcp/delegates.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L58)
+Defined in: [mcp/delegates.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L59)
 
 **`Experimental`**
 
@@ -787,7 +787,7 @@ Defined in: [mcp/delegates.ts:58](https://github.com/tangle-network/agent-runtim
 
 > `optional` **updateDetachedSessionRef**(`ref`): `void`
 
-Defined in: [mcp/delegates.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L67)
+Defined in: [mcp/delegates.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L68)
 
 **`Experimental`**
 
@@ -807,7 +807,7 @@ Rebind the record's resume key (e.g. once the sandbox id is known).
 
 ### CoderReview
 
-Defined in: [mcp/delegates.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L97)
+Defined in: [mcp/delegates.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L98)
 
 **`Experimental`**
 
@@ -819,7 +819,7 @@ Structured review verdict over a coder candidate.
 
 > **approved**: `boolean`
 
-Defined in: [mcp/delegates.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L99)
+Defined in: [mcp/delegates.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L100)
 
 **`Experimental`**
 
@@ -829,7 +829,7 @@ Gate: only approved candidates are eligible to win.
 
 > **recommendation**: `"ship"` \| `"approve-with-nits"` \| `"changes-requested"` \| `"reject"`
 
-Defined in: [mcp/delegates.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L101)
+Defined in: [mcp/delegates.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L102)
 
 **`Experimental`**
 
@@ -839,7 +839,7 @@ Reviewer's recommendation — surfaced in traces.
 
 > **readiness**: `number`
 
-Defined in: [mcp/delegates.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L103)
+Defined in: [mcp/delegates.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L104)
 
 **`Experimental`**
 
@@ -849,7 +849,7 @@ Readiness 0..1, used by the `highest-readiness` winner-selection strategy.
 
 > `optional` **notes?**: `string`
 
-Defined in: [mcp/delegates.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L104)
+Defined in: [mcp/delegates.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L105)
 
 **`Experimental`**
 
@@ -857,7 +857,7 @@ Defined in: [mcp/delegates.ts:104](https://github.com/tangle-network/agent-runti
 
 ### DetachedSessionDelegateOptions
 
-Defined in: [mcp/delegates.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L136)
+Defined in: [mcp/delegates.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L138)
 
 **`Experimental`**
 
@@ -867,7 +867,7 @@ Defined in: [mcp/delegates.ts:136](https://github.com/tangle-network/agent-runti
 
 > `optional` **executor?**: [`DelegationExecutor`](#delegationexecutor)
 
-Defined in: [mcp/delegates.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L143)
+Defined in: [mcp/delegates.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L145)
 
 **`Experimental`**
 
@@ -880,7 +880,7 @@ one or the other, not both.
 
 > `optional` **sandboxClient?**: [`SandboxClient`](runtime.md#sandboxclient-3)
 
-Defined in: [mcp/delegates.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L148)
+Defined in: [mcp/delegates.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L150)
 
 **`Experimental`**
 
@@ -891,7 +891,7 @@ Convenience shorthand for sibling placement. Equivalent to
 
 > `optional` **workerProfile?**: `AgentProfile`
 
-Defined in: [mcp/delegates.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L156)
+Defined in: [mcp/delegates.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L158)
 
 **`Experimental`**
 
@@ -905,7 +905,7 @@ profile is used.
 
 > `optional` **harness?**: `string`
 
-Defined in: [mcp/delegates.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L158)
+Defined in: [mcp/delegates.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L160)
 
 **`Experimental`**
 
@@ -915,7 +915,7 @@ Backend harness for the single-coder path (sets `metadata.backendType`). Default
 
 > `optional` **model?**: `string`
 
-Defined in: [mcp/delegates.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L160)
+Defined in: [mcp/delegates.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L162)
 
 **`Experimental`**
 
@@ -925,7 +925,7 @@ Model override for the single-coder path.
 
 > `optional` **systemPrompt?**: `string`
 
-Defined in: [mcp/delegates.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L166)
+Defined in: [mcp/delegates.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L168)
 
 **`Experimental`**
 
@@ -937,7 +937,7 @@ harness runs under this stance. Omit to keep the profile's own prompt.
 
 > `optional` **fanoutHarnesses?**: `string`[]
 
-Defined in: [mcp/delegates.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L168)
+Defined in: [mcp/delegates.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L170)
 
 **`Experimental`**
 
@@ -947,7 +947,7 @@ Default `['claude-code', 'codex', 'opencode/zai-coding-plan/glm-5.1']` when vari
 
 > `optional` **fanoutModels?**: (`string` \| `undefined`)[]
 
-Defined in: [mcp/delegates.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L170)
+Defined in: [mcp/delegates.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L172)
 
 **`Experimental`**
 
@@ -957,7 +957,7 @@ Optional per-harness model override for `variants > 1`.
 
 > `optional` **maxConcurrency?**: `number`
 
-Defined in: [mcp/delegates.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L172)
+Defined in: [mcp/delegates.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L174)
 
 **`Experimental`**
 
@@ -967,7 +967,7 @@ Hard cap on the kernel's per-batch concurrency. Default 4.
 
 > `optional` **reviewer?**: [`CoderReviewer`](#coderreviewer)
 
-Defined in: [mcp/delegates.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L179)
+Defined in: [mcp/delegates.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L181)
 
 **`Experimental`**
 
@@ -980,7 +980,7 @@ but wrong/unsafe" class the deterministic validator can't see.
 
 > `optional` **winnerSelection?**: [`DetachedWinnerSelection`](#detachedwinnerselection)
 
-Defined in: [mcp/delegates.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L181)
+Defined in: [mcp/delegates.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L183)
 
 **`Experimental`**
 
@@ -990,7 +990,7 @@ Winner-selection strategy among eligible candidates. Default `highest-score`.
 
 > `optional` **traceEmitter?**: [`LoopTraceEmitter`](runtime.md#looptraceemitter)
 
-Defined in: [mcp/delegates.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L193)
+Defined in: [mcp/delegates.ts:195](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L195)
 
 **`Experimental`**
 
@@ -1008,7 +1008,7 @@ event stream for them so this emitter observes detached work too.
 
 > `optional` **detachedTickIntervalMs?**: `number`
 
-Defined in: [mcp/delegates.ts:195](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L195)
+Defined in: [mcp/delegates.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L197)
 
 **`Experimental`**
 
@@ -1018,7 +1018,7 @@ Tick cadence (ms) for the detached single-variant path. Default 5000.
 
 > `optional` **detachedWallCapMs?**: `number`
 
-Defined in: [mcp/delegates.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L197)
+Defined in: [mcp/delegates.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L199)
 
 **`Experimental`**
 
@@ -1028,7 +1028,7 @@ Wall-clock cap (ms) forwarded to `driveTurn` for detached turns.
 
 ### SettleDetachedCoderTurnOptions
 
-Defined in: [mcp/delegates.ts:438](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L438)
+Defined in: [mcp/delegates.ts:440](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L440)
 
 **`Experimental`**
 
@@ -1038,7 +1038,7 @@ Defined in: [mcp/delegates.ts:438](https://github.com/tangle-network/agent-runti
 
 > **task**: [`CoderTask`](profiles.md#codertask)
 
-Defined in: [mcp/delegates.ts:439](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L439)
+Defined in: [mcp/delegates.ts:441](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L441)
 
 **`Experimental`**
 
@@ -1046,7 +1046,7 @@ Defined in: [mcp/delegates.ts:439](https://github.com/tangle-network/agent-runti
 
 > **sessionId**: `string`
 
-Defined in: [mcp/delegates.ts:441](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L441)
+Defined in: [mcp/delegates.ts:443](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L443)
 
 **`Experimental`**
 
@@ -1056,7 +1056,7 @@ Session id of the detached turn — used as the synthesized event id.
 
 > **signal**: `AbortSignal`
 
-Defined in: [mcp/delegates.ts:442](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L442)
+Defined in: [mcp/delegates.ts:444](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L444)
 
 **`Experimental`**
 
@@ -1064,7 +1064,7 @@ Defined in: [mcp/delegates.ts:442](https://github.com/tangle-network/agent-runti
 
 > `optional` **harness?**: `string`
 
-Defined in: [mcp/delegates.ts:443](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L443)
+Defined in: [mcp/delegates.ts:445](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L445)
 
 **`Experimental`**
 
@@ -1072,7 +1072,7 @@ Defined in: [mcp/delegates.ts:443](https://github.com/tangle-network/agent-runti
 
 > `optional` **model?**: `string`
 
-Defined in: [mcp/delegates.ts:444](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L444)
+Defined in: [mcp/delegates.ts:446](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L446)
 
 **`Experimental`**
 
@@ -1080,7 +1080,7 @@ Defined in: [mcp/delegates.ts:444](https://github.com/tangle-network/agent-runti
 
 > `optional` **reviewer?**: [`CoderReviewer`](#coderreviewer)
 
-Defined in: [mcp/delegates.ts:446](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L446)
+Defined in: [mcp/delegates.ts:448](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L448)
 
 **`Experimental`**
 
@@ -1090,7 +1090,7 @@ Same gate as the streaming path: an unapproved candidate cannot win.
 
 ### DelegationStore
 
-Defined in: [mcp/delegation-store.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L23)
+Defined in: [mcp/delegation-store.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L24)
 
 **`Experimental`**
 
@@ -1100,7 +1100,7 @@ Defined in: [mcp/delegation-store.ts:23](https://github.com/tangle-network/agent
 
 > **loadAll**(): `Promise`\<[`DelegationRecord`](#delegationrecord)[]\>
 
-Defined in: [mcp/delegation-store.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L30)
+Defined in: [mcp/delegation-store.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L31)
 
 **`Experimental`**
 
@@ -1117,7 +1117,7 @@ file is an empty store; an unparseable one throws
 
 > **upsert**(`record`): `Promise`\<`void`\>
 
-Defined in: [mcp/delegation-store.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L32)
+Defined in: [mcp/delegation-store.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L33)
 
 **`Experimental`**
 
@@ -1137,7 +1137,7 @@ Insert or replace the record keyed by `record.taskId`.
 
 > **lookupIdempotencyKey**(`key`): `Promise`\<`string` \| `undefined`\>
 
-Defined in: [mcp/delegation-store.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L39)
+Defined in: [mcp/delegation-store.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L40)
 
 **`Experimental`**
 
@@ -1160,7 +1160,7 @@ processes without holding the full record set.
 
 > **remove**(`taskIds`): `Promise`\<`void`\>
 
-Defined in: [mcp/delegation-store.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L41)
+Defined in: [mcp/delegation-store.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L42)
 
 **`Experimental`**
 
@@ -1180,7 +1180,7 @@ readonly `string`[]
 
 ### FileDelegationStoreOptions
 
-Defined in: [mcp/delegation-store.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L99)
+Defined in: [mcp/delegation-store.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L100)
 
 **`Experimental`**
 
@@ -1190,7 +1190,7 @@ Defined in: [mcp/delegation-store.ts:99](https://github.com/tangle-network/agent
 
 > **filePath**: `string`
 
-Defined in: [mcp/delegation-store.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L101)
+Defined in: [mcp/delegation-store.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L102)
 
 **`Experimental`**
 
@@ -1200,7 +1200,7 @@ Absolute path of the JSON state file. Parent directories are created on first wr
 
 > `optional` **recoverCorrupt?**: `boolean`
 
-Defined in: [mcp/delegation-store.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L107)
+Defined in: [mcp/delegation-store.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-store.ts#L108)
 
 **`Experimental`**
 
@@ -1212,7 +1212,7 @@ throwing `DelegationStateCorruptError`. Default false.
 
 ### DelegationTraceSpan
 
-Defined in: [mcp/delegation-trace.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L31)
+Defined in: [mcp/delegation-trace.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L32)
 
 **`Experimental`**
 
@@ -1228,7 +1228,7 @@ them, so a consumer can re-export journal traces losslessly.
 
 > **spanId**: `string`
 
-Defined in: [mcp/delegation-trace.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L32)
+Defined in: [mcp/delegation-trace.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L33)
 
 **`Experimental`**
 
@@ -1236,7 +1236,7 @@ Defined in: [mcp/delegation-trace.ts:32](https://github.com/tangle-network/agent
 
 > `optional` **parentSpanId?**: `string`
 
-Defined in: [mcp/delegation-trace.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L34)
+Defined in: [mcp/delegation-trace.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L35)
 
 **`Experimental`**
 
@@ -1246,7 +1246,7 @@ Absent on the tree root.
 
 > **name**: `string`
 
-Defined in: [mcp/delegation-trace.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L36)
+Defined in: [mcp/delegation-trace.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L37)
 
 **`Experimental`**
 
@@ -1256,7 +1256,7 @@ Defined in: [mcp/delegation-trace.ts:36](https://github.com/tangle-network/agent
 
 > **kind**: `"loop"` \| `"round"` \| `"branch"`
 
-Defined in: [mcp/delegation-trace.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L38)
+Defined in: [mcp/delegation-trace.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L39)
 
 **`Experimental`**
 
@@ -1266,7 +1266,7 @@ Topology level: loop root, plan round, or iteration branch.
 
 > **startMs**: `number`
 
-Defined in: [mcp/delegation-trace.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L39)
+Defined in: [mcp/delegation-trace.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L40)
 
 **`Experimental`**
 
@@ -1274,7 +1274,7 @@ Defined in: [mcp/delegation-trace.ts:39](https://github.com/tangle-network/agent
 
 > **endMs**: `number`
 
-Defined in: [mcp/delegation-trace.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L40)
+Defined in: [mcp/delegation-trace.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L41)
 
 **`Experimental`**
 
@@ -1282,7 +1282,7 @@ Defined in: [mcp/delegation-trace.ts:40](https://github.com/tangle-network/agent
 
 > `optional` **meta?**: `Record`\<`string`, `string` \| `number` \| `boolean`\>
 
-Defined in: [mcp/delegation-trace.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L41)
+Defined in: [mcp/delegation-trace.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L42)
 
 **`Experimental`**
 
@@ -1290,7 +1290,7 @@ Defined in: [mcp/delegation-trace.ts:41](https://github.com/tangle-network/agent
 
 ### DelegationTraceCaps
 
-Defined in: [mcp/delegation-trace.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L51)
+Defined in: [mcp/delegation-trace.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L52)
 
 **`Experimental`**
 
@@ -1300,7 +1300,7 @@ Defined in: [mcp/delegation-trace.ts:51](https://github.com/tangle-network/agent
 
 > `optional` **maxSpans?**: `number`
 
-Defined in: [mcp/delegation-trace.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L53)
+Defined in: [mcp/delegation-trace.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L54)
 
 **`Experimental`**
 
@@ -1310,7 +1310,7 @@ Default [DELEGATION\_TRACE\_MAX\_SPANS](#delegation_trace_max_spans).
 
 > `optional` **maxBytes?**: `number`
 
-Defined in: [mcp/delegation-trace.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L56)
+Defined in: [mcp/delegation-trace.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L57)
 
 **`Experimental`**
 
@@ -1321,7 +1321,7 @@ Default [DELEGATION\_TRACE\_MAX\_BYTES](#delegation_trace_max_bytes). Approximat
 
 ### CappedDelegationTrace
 
-Defined in: [mcp/delegation-trace.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L60)
+Defined in: [mcp/delegation-trace.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L61)
 
 **`Experimental`**
 
@@ -1331,7 +1331,7 @@ Defined in: [mcp/delegation-trace.ts:60](https://github.com/tangle-network/agent
 
 > **trace**: [`DelegationTraceSpan`](#delegationtracespan)[]
 
-Defined in: [mcp/delegation-trace.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L61)
+Defined in: [mcp/delegation-trace.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L62)
 
 **`Experimental`**
 
@@ -1339,7 +1339,7 @@ Defined in: [mcp/delegation-trace.ts:61](https://github.com/tangle-network/agent
 
 > **truncated**: `boolean`
 
-Defined in: [mcp/delegation-trace.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L63)
+Defined in: [mcp/delegation-trace.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L64)
 
 **`Experimental`**
 
@@ -1349,7 +1349,7 @@ True when oldest spans were dropped to honor the caps.
 
 ### DelegationTraceCollector
 
-Defined in: [mcp/delegation-trace.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L123)
+Defined in: [mcp/delegation-trace.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L124)
 
 **`Experimental`**
 
@@ -1365,7 +1365,7 @@ journal, unlike the OTEL path which drops it.
 
 > **emitter**: [`LoopTraceEmitter`](runtime.md#looptraceemitter)
 
-Defined in: [mcp/delegation-trace.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L124)
+Defined in: [mcp/delegation-trace.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L125)
 
 **`Experimental`**
 
@@ -1375,7 +1375,7 @@ Defined in: [mcp/delegation-trace.ts:124](https://github.com/tangle-network/agen
 
 > **settle**(): `void`
 
-Defined in: [mcp/delegation-trace.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L126)
+Defined in: [mcp/delegation-trace.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L127)
 
 **`Experimental`**
 
@@ -1389,7 +1389,7 @@ Flush buffered events of runs that never reached `loop.ended`.
 
 ### DriveTurnCapableBox
 
-Defined in: [mcp/detached-turn.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L67)
+Defined in: [mcp/detached-turn.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L68)
 
 **`Experimental`**
 
@@ -1405,7 +1405,7 @@ is invoked on abort so the remote run actually stops.
 
 > **driveTurn**(`message`, `opts`): `Promise`\<[`DriveTurnTick`](#driveturntick)\>
 
-Defined in: [mcp/detached-turn.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L68)
+Defined in: [mcp/detached-turn.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L69)
 
 **`Experimental`**
 
@@ -1437,7 +1437,7 @@ Defined in: [mcp/detached-turn.ts:68](https://github.com/tangle-network/agent-ru
 
 > `optional` **\_sessionCancel**(`id`): `Promise`\<`void`\>
 
-Defined in: [mcp/detached-turn.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L72)
+Defined in: [mcp/detached-turn.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L73)
 
 **`Experimental`**
 
@@ -1455,7 +1455,7 @@ Defined in: [mcp/detached-turn.ts:72](https://github.com/tangle-network/agent-ru
 
 ### DetachedSessionRefParts
 
-Defined in: [mcp/detached-turn.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L83)
+Defined in: [mcp/detached-turn.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L84)
 
 **`Experimental`**
 
@@ -1470,7 +1470,7 @@ loud rather than dispatching onto a guessed box.
 
 > **sessionId**: `string`
 
-Defined in: [mcp/detached-turn.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L84)
+Defined in: [mcp/detached-turn.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L85)
 
 **`Experimental`**
 
@@ -1478,7 +1478,7 @@ Defined in: [mcp/detached-turn.ts:84](https://github.com/tangle-network/agent-ru
 
 > `optional` **sandboxId?**: `string`
 
-Defined in: [mcp/detached-turn.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L85)
+Defined in: [mcp/detached-turn.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L86)
 
 **`Experimental`**
 
@@ -1486,7 +1486,7 @@ Defined in: [mcp/detached-turn.ts:85](https://github.com/tangle-network/agent-ru
 
 ### DetachedTurn
 
-Defined in: [mcp/detached-turn.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L135)
+Defined in: [mcp/detached-turn.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L136)
 
 **`Experimental`**
 
@@ -1498,7 +1498,7 @@ The terminal payload of a finished detached turn.
 
 > **text**: `string`
 
-Defined in: [mcp/detached-turn.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L137)
+Defined in: [mcp/detached-turn.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L138)
 
 **`Experimental`**
 
@@ -1508,7 +1508,7 @@ Final assistant text.
 
 > **result**: `Record`\<`string`, `unknown`\>
 
-Defined in: [mcp/detached-turn.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L139)
+Defined in: [mcp/detached-turn.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L140)
 
 **`Experimental`**
 
@@ -1518,7 +1518,7 @@ The SDK's cached AgentExecutionResult-shape record for the turn.
 
 ### RunDetachedTurnOptions
 
-Defined in: [mcp/detached-turn.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L166)
+Defined in: [mcp/detached-turn.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L167)
 
 **`Experimental`**
 
@@ -1528,7 +1528,7 @@ Defined in: [mcp/detached-turn.ts:166](https://github.com/tangle-network/agent-r
 
 > **client**: [`SandboxClient`](runtime.md#sandboxclient-3)
 
-Defined in: [mcp/detached-turn.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L168)
+Defined in: [mcp/detached-turn.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L169)
 
 **`Experimental`**
 
@@ -1538,7 +1538,7 @@ Sandbox client used to acquire the box (the delegate's executor client).
 
 > **spec**: [`AgentRunSpec`](runtime.md#agentrunspec)\<`unknown`\>
 
-Defined in: [mcp/detached-turn.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L170)
+Defined in: [mcp/detached-turn.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L171)
 
 **`Experimental`**
 
@@ -1548,7 +1548,7 @@ Profile + overrides for box acquisition — same spec the streaming path uses.
 
 > **prompt**: `string`
 
-Defined in: [mcp/detached-turn.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L172)
+Defined in: [mcp/detached-turn.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L173)
 
 **`Experimental`**
 
@@ -1558,7 +1558,7 @@ The full turn prompt; consumed by `driveTurn`'s dispatch leg.
 
 > **sessionId**: `string`
 
-Defined in: [mcp/detached-turn.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L174)
+Defined in: [mcp/detached-turn.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L175)
 
 **`Experimental`**
 
@@ -1568,7 +1568,7 @@ Deterministic resume key, minted at submit time (`parseDetachedSessionRef(ref).s
 
 > **signal**: `AbortSignal`
 
-Defined in: [mcp/detached-turn.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L181)
+Defined in: [mcp/detached-turn.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L182)
 
 **`Experimental`**
 
@@ -1576,7 +1576,7 @@ Defined in: [mcp/detached-turn.ts:181](https://github.com/tangle-network/agent-r
 
 > `optional` **tickIntervalMs?**: `number`
 
-Defined in: [mcp/detached-turn.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L184)
+Defined in: [mcp/detached-turn.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L185)
 
 **`Experimental`**
 
@@ -1586,7 +1586,7 @@ Delay between `running` ticks (ms). Default 5000.
 
 > `optional` **wallCapMs?**: `number`
 
-Defined in: [mcp/detached-turn.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L186)
+Defined in: [mcp/detached-turn.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L187)
 
 **`Experimental`**
 
@@ -1596,7 +1596,7 @@ Wall-clock cap forwarded to `driveTurn` — the SDK cancels and fails a session
 
 > `optional` **traceEmitter?**: [`LoopTraceEmitter`](runtime.md#looptraceemitter)
 
-Defined in: [mcp/detached-turn.ts:196](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L196)
+Defined in: [mcp/detached-turn.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L197)
 
 **`Experimental`**
 
@@ -1612,7 +1612,7 @@ this driver tag.
 
 > `optional` **placement?**: `"sibling"` \| `"fleet"`
 
-Defined in: [mcp/detached-turn.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L198)
+Defined in: [mcp/detached-turn.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L199)
 
 **`Experimental`**
 
@@ -1624,7 +1624,7 @@ Physical placement stamped on the synthesized dispatch event. Default `'sibling'
 
 > **bindSandbox**(`sandboxId`): `void`
 
-Defined in: [mcp/detached-turn.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L180)
+Defined in: [mcp/detached-turn.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L181)
 
 **`Experimental`**
 
@@ -1646,7 +1646,7 @@ a restart can resolve the box again.
 
 > **report**(`progress`): `void`
 
-Defined in: [mcp/detached-turn.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L182)
+Defined in: [mcp/detached-turn.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L183)
 
 **`Experimental`**
 
@@ -1664,7 +1664,7 @@ Defined in: [mcp/detached-turn.ts:182](https://github.com/tangle-network/agent-r
 
 ### DetachedTurnResumeDriverOptions
 
-Defined in: [mcp/detached-turn.ts:365](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L365)
+Defined in: [mcp/detached-turn.ts:366](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L366)
 
 **`Experimental`**
 
@@ -1674,7 +1674,7 @@ Defined in: [mcp/detached-turn.ts:365](https://github.com/tangle-network/agent-r
 
 > `optional` **intervalMs?**: `number`
 
-Defined in: [mcp/detached-turn.ts:390](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L390)
+Defined in: [mcp/detached-turn.ts:391](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L391)
 
 **`Experimental`**
 
@@ -1684,7 +1684,7 @@ Delay between `running` ticks (ms). Default 5000.
 
 > `optional` **wallCapMs?**: `number`
 
-Defined in: [mcp/detached-turn.ts:392](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L392)
+Defined in: [mcp/detached-turn.ts:393](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L393)
 
 **`Experimental`**
 
@@ -1696,7 +1696,7 @@ Wall-clock cap forwarded to `driveTurn` on every tick.
 
 > **resolveSandbox**(`sandboxId`): `Promise`\<[`DriveTurnCapableBox`](#driveturncapablebox)\>
 
-Defined in: [mcp/detached-turn.ts:371](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L371)
+Defined in: [mcp/detached-turn.ts:372](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L372)
 
 **`Experimental`**
 
@@ -1718,7 +1718,7 @@ a thrown tick settles the record as failed, which is the truth.
 
 > **buildMessage**(`record`): `string`
 
-Defined in: [mcp/detached-turn.ts:378](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L378)
+Defined in: [mcp/detached-turn.ts:379](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L379)
 
 **`Experimental`**
 
@@ -1741,7 +1741,7 @@ prompt the delegate would have sent.
 
 > **settleOutput**(`turn`, `record`, `ctx`): `CoderOutput` \| [`UiAuditorDelegationOutput`](#uiauditordelegationoutput) \| [`ResearchOutputShape`](#researchoutputshape) \| `Promise`\<`CoderOutput` \| [`UiAuditorDelegationOutput`](#uiauditordelegationoutput) \| [`ResearchOutputShape`](#researchoutputshape)\>
 
-Defined in: [mcp/detached-turn.ts:384](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L384)
+Defined in: [mcp/detached-turn.ts:385](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L385)
 
 **`Experimental`**
 
@@ -1773,7 +1773,7 @@ profile's gate — the queue settles the record as failed with that error.
 
 ### DelegationExecutor
 
-Defined in: [mcp/executor.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L25)
+Defined in: [mcp/executor.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L26)
 
 **`Experimental`**
 
@@ -1783,7 +1783,7 @@ Defined in: [mcp/executor.ts:25](https://github.com/tangle-network/agent-runtime
 
 > `readonly` **client**: [`SandboxClient`](runtime.md#sandboxclient-3)
 
-Defined in: [mcp/executor.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L27)
+Defined in: [mcp/executor.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L28)
 
 **`Experimental`**
 
@@ -1793,7 +1793,7 @@ Sandbox client the kernel calls. Returned with `describePlacement` set.
 
 > `readonly` `optional` **placement?**: `"sibling"` \| `"fleet"` \| `"in-process"`
 
-Defined in: [mcp/executor.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L37)
+Defined in: [mcp/executor.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L38)
 
 **`Experimental`**
 
@@ -1809,7 +1809,7 @@ absent means "unknown" and detached dispatch is not enabled for it.
 
 > **describe**(): `string`
 
-Defined in: [mcp/executor.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L29)
+Defined in: [mcp/executor.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L30)
 
 **`Experimental`**
 
@@ -1823,7 +1823,7 @@ Best-effort one-liner used in stderr boot logs and diagnostics.
 
 ### SiblingSandboxExecutorOptions
 
-Defined in: [mcp/executor.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L41)
+Defined in: [mcp/executor.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L42)
 
 **`Experimental`**
 
@@ -1833,7 +1833,7 @@ Defined in: [mcp/executor.ts:41](https://github.com/tangle-network/agent-runtime
 
 > **client**: [`SandboxClient`](runtime.md#sandboxclient-3)
 
-Defined in: [mcp/executor.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L42)
+Defined in: [mcp/executor.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L43)
 
 **`Experimental`**
 
@@ -1841,7 +1841,7 @@ Defined in: [mcp/executor.ts:42](https://github.com/tangle-network/agent-runtime
 
 ### FleetHandle
 
-Defined in: [mcp/executor.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L82)
+Defined in: [mcp/executor.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L83)
 
 **`Experimental`**
 
@@ -1855,7 +1855,7 @@ sandbox SDK.
 
 > `readonly` **fleetId**: `string`
 
-Defined in: [mcp/executor.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L83)
+Defined in: [mcp/executor.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L84)
 
 **`Experimental`**
 
@@ -1863,7 +1863,7 @@ Defined in: [mcp/executor.ts:83](https://github.com/tangle-network/agent-runtime
 
 > `readonly` **ids**: readonly `string`[]
 
-Defined in: [mcp/executor.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L85)
+Defined in: [mcp/executor.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L86)
 
 **`Experimental`**
 
@@ -1875,7 +1875,7 @@ Machine ids in dispatch-eligible order. The executor round-robins.
 
 > **sandbox**(`machineId`): `Promise`\<`SandboxInstance`\>
 
-Defined in: [mcp/executor.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L89)
+Defined in: [mcp/executor.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L90)
 
 **`Experimental`**
 
@@ -1897,7 +1897,7 @@ every other fleet machine's filesystem too.
 
 ### FleetWorkspaceExecutorOptions
 
-Defined in: [mcp/executor.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L93)
+Defined in: [mcp/executor.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L94)
 
 **`Experimental`**
 
@@ -1907,7 +1907,7 @@ Defined in: [mcp/executor.ts:93](https://github.com/tangle-network/agent-runtime
 
 > **fleet**: [`FleetHandle`](#fleethandle)
 
-Defined in: [mcp/executor.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L94)
+Defined in: [mcp/executor.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L95)
 
 **`Experimental`**
 
@@ -1915,7 +1915,7 @@ Defined in: [mcp/executor.ts:94](https://github.com/tangle-network/agent-runtime
 
 > `optional` **selectMachine?**: (`call`) => `string`
 
-Defined in: [mcp/executor.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L100)
+Defined in: [mcp/executor.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L101)
 
 **`Experimental`**
 
@@ -1943,7 +1943,7 @@ readonly `string`[]
 
 > `optional` **excludeMachineIds?**: readonly `string`[]
 
-Defined in: [mcp/executor.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L105)
+Defined in: [mcp/executor.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L106)
 
 **`Experimental`**
 
@@ -1954,7 +1954,7 @@ machineId so workers don't compete with the orchestrator on the same VM.
 
 ### FeedbackEvent
 
-Defined in: [mcp/feedback-store.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L20)
+Defined in: [mcp/feedback-store.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L21)
 
 **`Experimental`**
 
@@ -1964,7 +1964,7 @@ Defined in: [mcp/feedback-store.ts:20](https://github.com/tangle-network/agent-r
 
 > **id**: `string`
 
-Defined in: [mcp/feedback-store.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L21)
+Defined in: [mcp/feedback-store.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L22)
 
 **`Experimental`**
 
@@ -1972,7 +1972,7 @@ Defined in: [mcp/feedback-store.ts:21](https://github.com/tangle-network/agent-r
 
 > **refersTo**: [`FeedbackRefersTo`](#feedbackrefersto)
 
-Defined in: [mcp/feedback-store.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L22)
+Defined in: [mcp/feedback-store.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L23)
 
 **`Experimental`**
 
@@ -1980,7 +1980,7 @@ Defined in: [mcp/feedback-store.ts:22](https://github.com/tangle-network/agent-r
 
 > **rating**: [`FeedbackRating`](#feedbackrating)
 
-Defined in: [mcp/feedback-store.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L23)
+Defined in: [mcp/feedback-store.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L24)
 
 **`Experimental`**
 
@@ -1988,7 +1988,7 @@ Defined in: [mcp/feedback-store.ts:23](https://github.com/tangle-network/agent-r
 
 > **by**: `"agent"` \| `"user"` \| `"downstream-judge"`
 
-Defined in: [mcp/feedback-store.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L24)
+Defined in: [mcp/feedback-store.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L25)
 
 **`Experimental`**
 
@@ -1996,7 +1996,7 @@ Defined in: [mcp/feedback-store.ts:24](https://github.com/tangle-network/agent-r
 
 > **capturedAt**: `string`
 
-Defined in: [mcp/feedback-store.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L25)
+Defined in: [mcp/feedback-store.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L26)
 
 **`Experimental`**
 
@@ -2004,7 +2004,7 @@ Defined in: [mcp/feedback-store.ts:25](https://github.com/tangle-network/agent-r
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/feedback-store.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L26)
+Defined in: [mcp/feedback-store.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L27)
 
 **`Experimental`**
 
@@ -2012,7 +2012,7 @@ Defined in: [mcp/feedback-store.ts:26](https://github.com/tangle-network/agent-r
 
 ### FeedbackStore
 
-Defined in: [mcp/feedback-store.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L30)
+Defined in: [mcp/feedback-store.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L31)
 
 **`Experimental`**
 
@@ -2022,7 +2022,7 @@ Defined in: [mcp/feedback-store.ts:30](https://github.com/tangle-network/agent-r
 
 > **put**(`event`): `Promise`\<`void`\>
 
-Defined in: [mcp/feedback-store.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L32)
+Defined in: [mcp/feedback-store.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L33)
 
 **`Experimental`**
 
@@ -2042,7 +2042,7 @@ Append a new event. Never dedupes — every rating is its own event.
 
 > **list**(`filter?`): `Promise`\<[`FeedbackEvent`](#feedbackevent)[]\>
 
-Defined in: [mcp/feedback-store.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L37)
+Defined in: [mcp/feedback-store.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L38)
 
 **`Experimental`**
 
@@ -2069,7 +2069,7 @@ across all namespaces. Returns events in insertion order.
 
 ### InProcessExecutorOptions
 
-Defined in: [mcp/in-process-executor.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L33)
+Defined in: [mcp/in-process-executor.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L34)
 
 **`Experimental`**
 
@@ -2079,7 +2079,7 @@ Defined in: [mcp/in-process-executor.ts:33](https://github.com/tangle-network/ag
 
 > **repoRoot**: `string`
 
-Defined in: [mcp/in-process-executor.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L35)
+Defined in: [mcp/in-process-executor.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L36)
 
 **`Experimental`**
 
@@ -2089,7 +2089,7 @@ Absolute path to the git repo (the workspace). Worktrees go under `<repoRoot>/.a
 
 > `optional` **harnesses?**: readonly [`LocalHarness`](#localharness)[]
 
-Defined in: [mcp/in-process-executor.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L37)
+Defined in: [mcp/in-process-executor.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L38)
 
 **`Experimental`**
 
@@ -2099,7 +2099,7 @@ Harnesses to round-robin across `create()` calls. One entry = no fanout. Default
 
 > `optional` **testCmd?**: `string`
 
-Defined in: [mcp/in-process-executor.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L39)
+Defined in: [mcp/in-process-executor.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L40)
 
 **`Experimental`**
 
@@ -2109,7 +2109,7 @@ Optional per-delegation test command run in the worktree after the harness exits
 
 > `optional` **typecheckCmd?**: `string`
 
-Defined in: [mcp/in-process-executor.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L41)
+Defined in: [mcp/in-process-executor.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L42)
 
 **`Experimental`**
 
@@ -2119,7 +2119,7 @@ Optional per-delegation typecheck command. Same shape as `testCmd`.
 
 > `optional` **harnessTimeoutMs?**: `number`
 
-Defined in: [mcp/in-process-executor.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L43)
+Defined in: [mcp/in-process-executor.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L44)
 
 **`Experimental`**
 
@@ -2129,7 +2129,7 @@ Wall-clock cap per harness subprocess (ms). Default 5min.
 
 > `optional` **postCheckTimeoutMs?**: `number`
 
-Defined in: [mcp/in-process-executor.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L45)
+Defined in: [mcp/in-process-executor.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L46)
 
 **`Experimental`**
 
@@ -2139,7 +2139,7 @@ Wall-clock cap per test/typecheck subprocess (ms). Default 2min.
 
 > `optional` **runGit?**: [`GitRunner`](#gitrunner)
 
-Defined in: [mcp/in-process-executor.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L47)
+Defined in: [mcp/in-process-executor.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L48)
 
 **`Experimental`**
 
@@ -2149,7 +2149,7 @@ Test seam — override the git runner used by the worktree helpers.
 
 > `optional` **runHarness?**: (`options`) => `Promise`\<[`LocalHarnessResult`](#localharnessresult)\>
 
-Defined in: [mcp/in-process-executor.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L49)
+Defined in: [mcp/in-process-executor.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L50)
 
 **`Experimental`**
 
@@ -2187,7 +2187,7 @@ Does NOT throw when:
 
 > `optional` **runPostCheck?**: (`cmd`, `cwd`, `signal?`) => `Promise`\<\{ `exitCode`: `number`; `stdout`: `string`; `stderr`: `string`; \}\>
 
-Defined in: [mcp/in-process-executor.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L52)
+Defined in: [mcp/in-process-executor.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L53)
 
 **`Experimental`**
 
@@ -2216,7 +2216,7 @@ Test seam — override the post-check runner (defaults to a `sh -c` spawn). A th
 
 ### InProcessExecutorDescribePlacement
 
-Defined in: [mcp/in-process-executor.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L60)
+Defined in: [mcp/in-process-executor.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L61)
 
 **`Experimental`**
 
@@ -2230,7 +2230,7 @@ Defined in: [mcp/in-process-executor.ts:60](https://github.com/tangle-network/ag
 
 > `optional` **worktreePath?**: `string`
 
-Defined in: [mcp/in-process-executor.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L62)
+Defined in: [mcp/in-process-executor.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L63)
 
 **`Experimental`**
 
@@ -2240,7 +2240,7 @@ Worktree path in the parent sandbox's filesystem (set so traces correlate to on-
 
 > `optional` **harness?**: [`LocalHarness`](#localharness)
 
-Defined in: [mcp/in-process-executor.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L64)
+Defined in: [mcp/in-process-executor.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L65)
 
 **`Experimental`**
 
@@ -2250,7 +2250,7 @@ Which harness handled this delegation.
 
 > **kind**: `"sibling"` \| `"fleet"`
 
-Defined in: [runtime/types.ts:399](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L399)
+Defined in: [runtime/types.ts:400](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L400)
 
 **`Experimental`**
 
@@ -2262,7 +2262,7 @@ Defined in: [runtime/types.ts:399](https://github.com/tangle-network/agent-runti
 
 > `optional` **sandboxId?**: `string`
 
-Defined in: [runtime/types.ts:400](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L400)
+Defined in: [runtime/types.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L401)
 
 **`Experimental`**
 
@@ -2274,7 +2274,7 @@ Defined in: [runtime/types.ts:400](https://github.com/tangle-network/agent-runti
 
 > `optional` **fleetId?**: `string`
 
-Defined in: [runtime/types.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L401)
+Defined in: [runtime/types.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L402)
 
 **`Experimental`**
 
@@ -2286,7 +2286,7 @@ Defined in: [runtime/types.ts:401](https://github.com/tangle-network/agent-runti
 
 > `optional` **machineId?**: `string`
 
-Defined in: [runtime/types.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L402)
+Defined in: [runtime/types.ts:403](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L403)
 
 **`Experimental`**
 
@@ -2298,7 +2298,7 @@ Defined in: [runtime/types.ts:402](https://github.com/tangle-network/agent-runti
 
 ### FactCandidate
 
-Defined in: [mcp/kb-gate.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L24)
+Defined in: [mcp/kb-gate.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L25)
 
 **`Experimental`**
 
@@ -2310,7 +2310,7 @@ A fact proposed for the KB, with its grounding.
 
 > **claim**: `string`
 
-Defined in: [mcp/kb-gate.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L26)
+Defined in: [mcp/kb-gate.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L27)
 
 **`Experimental`**
 
@@ -2320,7 +2320,7 @@ The atomic claim text.
 
 > `optional` **value?**: `string` \| `number`
 
-Defined in: [mcp/kb-gate.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L28)
+Defined in: [mcp/kb-gate.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L29)
 
 **`Experimental`**
 
@@ -2330,7 +2330,7 @@ Optional extracted value (number or string) the claim asserts.
 
 > **verbatimPassage**: `string`
 
-Defined in: [mcp/kb-gate.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L30)
+Defined in: [mcp/kb-gate.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L31)
 
 **`Experimental`**
 
@@ -2340,7 +2340,7 @@ Verbatim span lifted from the source that backs the claim.
 
 > **sourceText**: `string`
 
-Defined in: [mcp/kb-gate.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L32)
+Defined in: [mcp/kb-gate.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L33)
 
 **`Experimental`**
 
@@ -2350,7 +2350,7 @@ The raw source text the passage must be grounded in.
 
 > `optional` **citation?**: `string`
 
-Defined in: [mcp/kb-gate.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L34)
+Defined in: [mcp/kb-gate.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L35)
 
 **`Experimental`**
 
@@ -2360,7 +2360,7 @@ Where the fact claims to come from — checked for circular/self citations.
 
 ### FactJudgeVerdict
 
-Defined in: [mcp/kb-gate.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L38)
+Defined in: [mcp/kb-gate.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L39)
 
 **`Experimental`**
 
@@ -2370,7 +2370,7 @@ Defined in: [mcp/kb-gate.ts:38](https://github.com/tangle-network/agent-runtime/
 
 > **accept**: `boolean`
 
-Defined in: [mcp/kb-gate.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L39)
+Defined in: [mcp/kb-gate.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L40)
 
 **`Experimental`**
 
@@ -2378,7 +2378,7 @@ Defined in: [mcp/kb-gate.ts:39](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **reason?**: `string`
 
-Defined in: [mcp/kb-gate.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L40)
+Defined in: [mcp/kb-gate.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L41)
 
 **`Experimental`**
 
@@ -2386,7 +2386,7 @@ Defined in: [mcp/kb-gate.ts:40](https://github.com/tangle-network/agent-runtime/
 
 ### FactJudge
 
-Defined in: [mcp/kb-gate.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L45)
+Defined in: [mcp/kb-gate.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L46)
 
 **`Experimental`**
 
@@ -2399,7 +2399,7 @@ A pluggable fact validator. Throw is NOT allowed — return a
 
 > **name**: `string`
 
-Defined in: [mcp/kb-gate.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L46)
+Defined in: [mcp/kb-gate.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L47)
 
 **`Experimental`**
 
@@ -2409,7 +2409,7 @@ Defined in: [mcp/kb-gate.ts:46](https://github.com/tangle-network/agent-runtime/
 
 > **judge**(`candidate`): [`FactJudgeVerdict`](#factjudgeverdict) \| `Promise`\<[`FactJudgeVerdict`](#factjudgeverdict)\>
 
-Defined in: [mcp/kb-gate.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L47)
+Defined in: [mcp/kb-gate.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L48)
 
 **`Experimental`**
 
@@ -2427,7 +2427,7 @@ Defined in: [mcp/kb-gate.ts:47](https://github.com/tangle-network/agent-runtime/
 
 ### KbGateResult
 
-Defined in: [mcp/kb-gate.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L51)
+Defined in: [mcp/kb-gate.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L52)
 
 **`Experimental`**
 
@@ -2437,7 +2437,7 @@ Defined in: [mcp/kb-gate.ts:51](https://github.com/tangle-network/agent-runtime/
 
 > **accepted**: `boolean`
 
-Defined in: [mcp/kb-gate.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L52)
+Defined in: [mcp/kb-gate.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L53)
 
 **`Experimental`**
 
@@ -2445,7 +2445,7 @@ Defined in: [mcp/kb-gate.ts:52](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **vetoedBy?**: `string`
 
-Defined in: [mcp/kb-gate.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L54)
+Defined in: [mcp/kb-gate.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L55)
 
 **`Experimental`**
 
@@ -2455,7 +2455,7 @@ Name of the judge that vetoed; undefined when accepted.
 
 > `optional` **reason?**: `string`
 
-Defined in: [mcp/kb-gate.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L55)
+Defined in: [mcp/kb-gate.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L56)
 
 **`Experimental`**
 
@@ -2463,7 +2463,7 @@ Defined in: [mcp/kb-gate.ts:55](https://github.com/tangle-network/agent-runtime/
 
 ### CreateKbGateOptions
 
-Defined in: [mcp/kb-gate.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L59)
+Defined in: [mcp/kb-gate.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L60)
 
 **`Experimental`**
 
@@ -2473,7 +2473,7 @@ Defined in: [mcp/kb-gate.ts:59](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **judges?**: [`FactJudge`](#factjudge)[]
 
-Defined in: [mcp/kb-gate.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L61)
+Defined in: [mcp/kb-gate.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L62)
 
 **`Experimental`**
 
@@ -2483,7 +2483,7 @@ Extra judges appended after the built-in floor (e.g. an LLM judge).
 
 > `optional` **minPassageChars?**: `number`
 
-Defined in: [mcp/kb-gate.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L63)
+Defined in: [mcp/kb-gate.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L64)
 
 **`Experimental`**
 
@@ -2493,7 +2493,7 @@ Minimum verbatim-passage length. Default 12 — kills empty/stub passages.
 
 > `optional` **selfArtifactKinds?**: `string`[]
 
-Defined in: [mcp/kb-gate.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L70)
+Defined in: [mcp/kb-gate.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L71)
 
 **`Experimental`**
 
@@ -2506,7 +2506,7 @@ Default `[]` (no circular check unless the consumer declares its kinds).
 
 ### RunLocalHarnessOptions
 
-Defined in: [mcp/local-harness.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L107)
+Defined in: [mcp/local-harness.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L108)
 
 **`Experimental`**
 
@@ -2516,7 +2516,7 @@ Defined in: [mcp/local-harness.ts:107](https://github.com/tangle-network/agent-r
 
 > **harness**: [`LocalHarness`](#localharness)
 
-Defined in: [mcp/local-harness.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L108)
+Defined in: [mcp/local-harness.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L109)
 
 **`Experimental`**
 
@@ -2524,7 +2524,7 @@ Defined in: [mcp/local-harness.ts:108](https://github.com/tangle-network/agent-r
 
 > **cwd**: `string`
 
-Defined in: [mcp/local-harness.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L110)
+Defined in: [mcp/local-harness.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L111)
 
 **`Experimental`**
 
@@ -2534,7 +2534,7 @@ Working directory for the subprocess (typically a worktree path).
 
 > **taskPrompt**: `string`
 
-Defined in: [mcp/local-harness.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L112)
+Defined in: [mcp/local-harness.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L113)
 
 **`Experimental`**
 
@@ -2544,7 +2544,7 @@ Prompt forwarded as the harness CLI's task argument.
 
 > `optional` **invocation?**: `object`
 
-Defined in: [mcp/local-harness.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L120)
+Defined in: [mcp/local-harness.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L121)
 
 **`Experimental`**
 
@@ -2566,7 +2566,7 @@ is used unchanged.
 
 > `optional` **timeoutMs?**: `number`
 
-Defined in: [mcp/local-harness.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L122)
+Defined in: [mcp/local-harness.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L123)
 
 **`Experimental`**
 
@@ -2576,7 +2576,7 @@ Wall-clock kill deadline (ms). Default 5 min. Subprocess SIGTERMed on expiry.
 
 > `optional` **signal?**: `AbortSignal`
 
-Defined in: [mcp/local-harness.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L124)
+Defined in: [mcp/local-harness.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L125)
 
 **`Experimental`**
 
@@ -2586,7 +2586,7 @@ Caller cancellation. SIGTERM is sent on abort.
 
 > `optional` **env?**: `ProcessEnv`
 
-Defined in: [mcp/local-harness.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L126)
+Defined in: [mcp/local-harness.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L127)
 
 **`Experimental`**
 
@@ -2596,7 +2596,7 @@ Override env (defaults to inheriting from the parent).
 
 > `optional` **spawn?**: (`command`, `args`, `opts`) => `ChildProcess`
 
-Defined in: [mcp/local-harness.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L131)
+Defined in: [mcp/local-harness.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L132)
 
 **`Experimental`**
 
@@ -2635,7 +2635,7 @@ readonly `string`[]
 
 ### LocalHarnessResult
 
-Defined in: [mcp/local-harness.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L143)
+Defined in: [mcp/local-harness.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L144)
 
 **`Experimental`**
 
@@ -2645,7 +2645,7 @@ Defined in: [mcp/local-harness.ts:143](https://github.com/tangle-network/agent-r
 
 > **exitCode**: `number` \| `null`
 
-Defined in: [mcp/local-harness.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L145)
+Defined in: [mcp/local-harness.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L146)
 
 **`Experimental`**
 
@@ -2655,7 +2655,7 @@ OS exit code. `null` when killed before exit.
 
 > **stdout**: `string`
 
-Defined in: [mcp/local-harness.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L147)
+Defined in: [mcp/local-harness.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L148)
 
 **`Experimental`**
 
@@ -2665,7 +2665,7 @@ Concatenated stdout.
 
 > **stderr**: `string`
 
-Defined in: [mcp/local-harness.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L149)
+Defined in: [mcp/local-harness.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L150)
 
 **`Experimental`**
 
@@ -2675,7 +2675,7 @@ Concatenated stderr.
 
 > **killedBySignal**: `Signals` \| `null`
 
-Defined in: [mcp/local-harness.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L151)
+Defined in: [mcp/local-harness.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L152)
 
 **`Experimental`**
 
@@ -2685,7 +2685,7 @@ Set when the process exited via signal (timeout / abort).
 
 > **durationMs**: `number`
 
-Defined in: [mcp/local-harness.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L153)
+Defined in: [mcp/local-harness.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L154)
 
 **`Experimental`**
 
@@ -2695,7 +2695,7 @@ Wall-clock duration ms (spawn → exit).
 
 > **timedOut**: `boolean`
 
-Defined in: [mcp/local-harness.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L155)
+Defined in: [mcp/local-harness.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L156)
 
 **`Experimental`**
 
@@ -2705,7 +2705,7 @@ Set when timeoutMs elapsed before exit.
 
 ### McpServerOptions
 
-Defined in: [mcp/server.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L62)
+Defined in: [mcp/server.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L63)
 
 **`Experimental`**
 
@@ -2715,7 +2715,7 @@ Defined in: [mcp/server.ts:62](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **delegateSupervisor?**: [`DelegateHandlerOptions`](#delegatehandleroptions)
 
-Defined in: [mcp/server.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L69)
+Defined in: [mcp/server.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L70)
 
 **`Experimental`**
 
@@ -2728,7 +2728,7 @@ wire here.
 
 > `optional` **uiAuditorDelegate?**: [`UiAuditorDelegate`](#uiauditordelegate)
 
-Defined in: [mcp/server.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L76)
+Defined in: [mcp/server.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L77)
 
 **`Experimental`**
 
@@ -2741,7 +2741,7 @@ canonical in-process choice is `createInProcessUiAuditClient` from
 
 > `optional` **feedbackStore?**: [`FeedbackStore`](#feedbackstore)
 
-Defined in: [mcp/server.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L78)
+Defined in: [mcp/server.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L79)
 
 **`Experimental`**
 
@@ -2751,7 +2751,7 @@ Override the default in-memory feedback store.
 
 > `optional` **queue?**: [`DelegationTaskQueue`](#delegationtaskqueue)
 
-Defined in: [mcp/server.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L80)
+Defined in: [mcp/server.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L81)
 
 **`Experimental`**
 
@@ -2761,7 +2761,7 @@ Override the default in-memory task queue.
 
 > `optional` **extraTools?**: [`McpToolDescriptor`](#mcptooldescriptor)[]
 
-Defined in: [mcp/server.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L86)
+Defined in: [mcp/server.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L87)
 
 **`Experimental`**
 
@@ -2773,7 +2773,7 @@ duplicate name throws so delegation tools cannot be shadowed silently.
 
 > `optional` **traceContext?**: [`TraceContext`](#tracecontext-2)
 
-Defined in: [mcp/server.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L92)
+Defined in: [mcp/server.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L93)
 
 **`Experimental`**
 
@@ -2785,7 +2785,7 @@ pass `traceContext` to that queue's constructor instead.
 
 > `optional` **serverName?**: `string`
 
-Defined in: [mcp/server.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L94)
+Defined in: [mcp/server.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L95)
 
 **`Experimental`**
 
@@ -2795,7 +2795,7 @@ Server display name surfaced via `initialize`. Default `'agent-runtime-mcp'`.
 
 > `optional` **serverVersion?**: `string`
 
-Defined in: [mcp/server.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L96)
+Defined in: [mcp/server.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L97)
 
 **`Experimental`**
 
@@ -2805,7 +2805,7 @@ Server version surfaced via `initialize`. Default = the package version baked at
 
 ### McpToolDescriptor
 
-Defined in: [mcp/server.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L100)
+Defined in: [mcp/server.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L101)
 
 **`Experimental`**
 
@@ -2815,7 +2815,7 @@ Defined in: [mcp/server.ts:100](https://github.com/tangle-network/agent-runtime/
 
 > **name**: `string`
 
-Defined in: [mcp/server.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L101)
+Defined in: [mcp/server.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L102)
 
 **`Experimental`**
 
@@ -2823,7 +2823,7 @@ Defined in: [mcp/server.ts:101](https://github.com/tangle-network/agent-runtime/
 
 > **description**: `string`
 
-Defined in: [mcp/server.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L102)
+Defined in: [mcp/server.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L103)
 
 **`Experimental`**
 
@@ -2831,7 +2831,7 @@ Defined in: [mcp/server.ts:102](https://github.com/tangle-network/agent-runtime/
 
 > **inputSchema**: `Record`\<`string`, `unknown`\>
 
-Defined in: [mcp/server.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L103)
+Defined in: [mcp/server.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L104)
 
 **`Experimental`**
 
@@ -2839,7 +2839,7 @@ Defined in: [mcp/server.ts:103](https://github.com/tangle-network/agent-runtime/
 
 > **handler**: (`raw`) => `Promise`\<`unknown`\>
 
-Defined in: [mcp/server.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L104)
+Defined in: [mcp/server.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L105)
 
 **`Experimental`**
 
@@ -2857,7 +2857,7 @@ Defined in: [mcp/server.ts:104](https://github.com/tangle-network/agent-runtime/
 
 ### McpServer
 
-Defined in: [mcp/server.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L108)
+Defined in: [mcp/server.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L109)
 
 **`Experimental`**
 
@@ -2867,7 +2867,7 @@ Defined in: [mcp/server.ts:108](https://github.com/tangle-network/agent-runtime/
 
 > `readonly` **tools**: `ReadonlyMap`\<`string`, [`McpToolDescriptor`](#mcptooldescriptor)\>
 
-Defined in: [mcp/server.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L110)
+Defined in: [mcp/server.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L111)
 
 **`Experimental`**
 
@@ -2877,7 +2877,7 @@ Tools currently registered (depend on which delegates were wired).
 
 > `readonly` **queue**: [`DelegationTaskQueue`](#delegationtaskqueue)
 
-Defined in: [mcp/server.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L112)
+Defined in: [mcp/server.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L113)
 
 **`Experimental`**
 
@@ -2887,7 +2887,7 @@ The underlying queue — exposed so tests can introspect it.
 
 > `readonly` **feedbackStore**: [`FeedbackStore`](#feedbackstore)
 
-Defined in: [mcp/server.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L114)
+Defined in: [mcp/server.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L115)
 
 **`Experimental`**
 
@@ -2899,7 +2899,7 @@ The feedback store — exposed for the same reason.
 
 > **handle**(`message`): `Promise`\<[`JsonRpcResponse`](#jsonrpcresponse) \| `null`\>
 
-Defined in: [mcp/server.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L116)
+Defined in: [mcp/server.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L117)
 
 **`Experimental`**
 
@@ -2919,7 +2919,7 @@ Handle a single parsed JSON-RPC message. Returns the response object (or `null`
 
 > **serve**(`transport?`): `Promise`\<`void`\>
 
-Defined in: [mcp/server.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L118)
+Defined in: [mcp/server.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L119)
 
 **`Experimental`**
 
@@ -2939,7 +2939,7 @@ Drive the server on a stdio-shaped transport until `stop()` is called.
 
 > **stop**(): `void`
 
-Defined in: [mcp/server.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L120)
+Defined in: [mcp/server.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L121)
 
 **`Experimental`**
 
@@ -2953,7 +2953,7 @@ Stop a `serve` call. Subsequent requests are rejected.
 
 ### McpTransport
 
-Defined in: [mcp/server.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L124)
+Defined in: [mcp/server.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L125)
 
 **`Experimental`**
 
@@ -2963,7 +2963,7 @@ Defined in: [mcp/server.ts:124](https://github.com/tangle-network/agent-runtime/
 
 > **input**: `ReadableStream`
 
-Defined in: [mcp/server.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L125)
+Defined in: [mcp/server.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L126)
 
 **`Experimental`**
 
@@ -2971,7 +2971,7 @@ Defined in: [mcp/server.ts:125](https://github.com/tangle-network/agent-runtime/
 
 > **output**: `WritableStream`
 
-Defined in: [mcp/server.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L126)
+Defined in: [mcp/server.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L127)
 
 **`Experimental`**
 
@@ -2979,7 +2979,7 @@ Defined in: [mcp/server.ts:126](https://github.com/tangle-network/agent-runtime/
 
 ### JsonRpcMessage
 
-Defined in: [mcp/server.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L130)
+Defined in: [mcp/server.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L131)
 
 **`Experimental`**
 
@@ -2989,7 +2989,7 @@ Defined in: [mcp/server.ts:130](https://github.com/tangle-network/agent-runtime/
 
 > **jsonrpc**: `"2.0"`
 
-Defined in: [mcp/server.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L131)
+Defined in: [mcp/server.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L132)
 
 **`Experimental`**
 
@@ -2997,7 +2997,7 @@ Defined in: [mcp/server.ts:131](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **id?**: `string` \| `number` \| `null`
 
-Defined in: [mcp/server.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L132)
+Defined in: [mcp/server.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L133)
 
 **`Experimental`**
 
@@ -3005,7 +3005,7 @@ Defined in: [mcp/server.ts:132](https://github.com/tangle-network/agent-runtime/
 
 > **method**: `string`
 
-Defined in: [mcp/server.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L133)
+Defined in: [mcp/server.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L134)
 
 **`Experimental`**
 
@@ -3013,7 +3013,7 @@ Defined in: [mcp/server.ts:133](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **params?**: `unknown`
 
-Defined in: [mcp/server.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L134)
+Defined in: [mcp/server.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L135)
 
 **`Experimental`**
 
@@ -3021,7 +3021,7 @@ Defined in: [mcp/server.ts:134](https://github.com/tangle-network/agent-runtime/
 
 ### JsonRpcResponse
 
-Defined in: [mcp/server.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L138)
+Defined in: [mcp/server.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L139)
 
 **`Experimental`**
 
@@ -3031,7 +3031,7 @@ Defined in: [mcp/server.ts:138](https://github.com/tangle-network/agent-runtime/
 
 > **jsonrpc**: `"2.0"`
 
-Defined in: [mcp/server.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L139)
+Defined in: [mcp/server.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L140)
 
 **`Experimental`**
 
@@ -3039,7 +3039,7 @@ Defined in: [mcp/server.ts:139](https://github.com/tangle-network/agent-runtime/
 
 > **id**: `string` \| `number` \| `null`
 
-Defined in: [mcp/server.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L140)
+Defined in: [mcp/server.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L141)
 
 **`Experimental`**
 
@@ -3047,7 +3047,7 @@ Defined in: [mcp/server.ts:140](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **result?**: `unknown`
 
-Defined in: [mcp/server.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L141)
+Defined in: [mcp/server.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L142)
 
 **`Experimental`**
 
@@ -3055,7 +3055,7 @@ Defined in: [mcp/server.ts:141](https://github.com/tangle-network/agent-runtime/
 
 > `optional` **error?**: `object`
 
-Defined in: [mcp/server.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L142)
+Defined in: [mcp/server.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L143)
 
 **`Experimental`**
 
@@ -3075,7 +3075,7 @@ Defined in: [mcp/server.ts:142](https://github.com/tangle-network/agent-runtime/
 
 ### DelegationRecord
 
-Defined in: [mcp/task-queue.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L65)
+Defined in: [mcp/task-queue.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L66)
 
 **`Experimental`**
 
@@ -3088,7 +3088,7 @@ persistent stores round-trip records through `JSON.stringify`.
 
 > **taskId**: `string`
 
-Defined in: [mcp/task-queue.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L66)
+Defined in: [mcp/task-queue.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L67)
 
 **`Experimental`**
 
@@ -3096,7 +3096,7 @@ Defined in: [mcp/task-queue.ts:66](https://github.com/tangle-network/agent-runti
 
 > **profile**: [`DelegationProfile`](#delegationprofile)
 
-Defined in: [mcp/task-queue.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L67)
+Defined in: [mcp/task-queue.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L68)
 
 **`Experimental`**
 
@@ -3104,7 +3104,7 @@ Defined in: [mcp/task-queue.ts:67](https://github.com/tangle-network/agent-runti
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/task-queue.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L68)
+Defined in: [mcp/task-queue.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L69)
 
 **`Experimental`**
 
@@ -3112,7 +3112,7 @@ Defined in: [mcp/task-queue.ts:68](https://github.com/tangle-network/agent-runti
 
 > **args**: `AnyDelegateArgs`
 
-Defined in: [mcp/task-queue.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L69)
+Defined in: [mcp/task-queue.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L70)
 
 **`Experimental`**
 
@@ -3120,7 +3120,7 @@ Defined in: [mcp/task-queue.ts:69](https://github.com/tangle-network/agent-runti
 
 > **status**: [`DelegationStatus`](#delegationstatus)
 
-Defined in: [mcp/task-queue.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L70)
+Defined in: [mcp/task-queue.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L71)
 
 **`Experimental`**
 
@@ -3128,7 +3128,7 @@ Defined in: [mcp/task-queue.ts:70](https://github.com/tangle-network/agent-runti
 
 > `optional` **progress?**: [`DelegationProgress`](#delegationprogress)
 
-Defined in: [mcp/task-queue.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L71)
+Defined in: [mcp/task-queue.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L72)
 
 **`Experimental`**
 
@@ -3136,7 +3136,7 @@ Defined in: [mcp/task-queue.ts:71](https://github.com/tangle-network/agent-runti
 
 > `optional` **result?**: [`DelegationResultPayload`](#delegationresultpayload)
 
-Defined in: [mcp/task-queue.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L72)
+Defined in: [mcp/task-queue.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L73)
 
 **`Experimental`**
 
@@ -3144,7 +3144,7 @@ Defined in: [mcp/task-queue.ts:72](https://github.com/tangle-network/agent-runti
 
 > `optional` **error?**: [`DelegationError`](#delegationerror)
 
-Defined in: [mcp/task-queue.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L73)
+Defined in: [mcp/task-queue.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L74)
 
 **`Experimental`**
 
@@ -3152,7 +3152,7 @@ Defined in: [mcp/task-queue.ts:73](https://github.com/tangle-network/agent-runti
 
 > `optional` **costUsd?**: `number`
 
-Defined in: [mcp/task-queue.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L74)
+Defined in: [mcp/task-queue.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L75)
 
 **`Experimental`**
 
@@ -3160,7 +3160,7 @@ Defined in: [mcp/task-queue.ts:74](https://github.com/tangle-network/agent-runti
 
 > **startedAt**: `string`
 
-Defined in: [mcp/task-queue.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L75)
+Defined in: [mcp/task-queue.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L76)
 
 **`Experimental`**
 
@@ -3168,7 +3168,7 @@ Defined in: [mcp/task-queue.ts:75](https://github.com/tangle-network/agent-runti
 
 > `optional` **completedAt?**: `string`
 
-Defined in: [mcp/task-queue.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L76)
+Defined in: [mcp/task-queue.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L77)
 
 **`Experimental`**
 
@@ -3176,7 +3176,7 @@ Defined in: [mcp/task-queue.ts:76](https://github.com/tangle-network/agent-runti
 
 > `optional` **idempotencyKey?**: `string`
 
-Defined in: [mcp/task-queue.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L78)
+Defined in: [mcp/task-queue.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L79)
 
 **`Experimental`**
 
@@ -3186,7 +3186,7 @@ Sha-prefix hash of the canonical input — used for idempotency lookup.
 
 > `optional` **detachedSessionRef?**: `string`
 
-Defined in: [mcp/task-queue.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L85)
+Defined in: [mcp/task-queue.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L86)
 
 **`Experimental`**
 
@@ -3199,7 +3199,7 @@ restart settles the record as failed.
 
 > **feedback**: [`DelegationFeedbackSnapshot`](#delegationfeedbacksnapshot)[]
 
-Defined in: [mcp/task-queue.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L87)
+Defined in: [mcp/task-queue.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L88)
 
 **`Experimental`**
 
@@ -3209,7 +3209,7 @@ Feedback events keyed by this delegation's taskId.
 
 > `optional` **trace?**: [`DelegationTraceSpan`](#delegationtracespan)[]
 
-Defined in: [mcp/task-queue.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L94)
+Defined in: [mcp/task-queue.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L95)
 
 **`Experimental`**
 
@@ -3222,7 +3222,7 @@ via `capDelegationTrace` — see `traceTruncated`.
 
 > `optional` **traceTruncated?**: `true`
 
-Defined in: [mcp/task-queue.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L96)
+Defined in: [mcp/task-queue.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L97)
 
 **`Experimental`**
 
@@ -3232,7 +3232,7 @@ Present when oldest trace spans were dropped to honor the trace caps.
 
 > `optional` **traceId?**: `string`
 
-Defined in: [mcp/task-queue.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L103)
+Defined in: [mcp/task-queue.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L104)
 
 **`Experimental`**
 
@@ -3245,7 +3245,7 @@ without parsing spans. Restored records keep their persisted identity.
 
 > `optional` **parentSpanId?**: `string`
 
-Defined in: [mcp/task-queue.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L105)
+Defined in: [mcp/task-queue.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L106)
 
 **`Experimental`**
 
@@ -3255,7 +3255,7 @@ Caller span that dispatched the delegation, when one was inherited.
 
 ### SubmitInput
 
-Defined in: [mcp/task-queue.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L109)
+Defined in: [mcp/task-queue.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L110)
 
 **`Experimental`**
 
@@ -3271,7 +3271,7 @@ Defined in: [mcp/task-queue.ts:109](https://github.com/tangle-network/agent-runt
 
 > **profile**: [`DelegationProfile`](#delegationprofile)
 
-Defined in: [mcp/task-queue.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L110)
+Defined in: [mcp/task-queue.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L111)
 
 **`Experimental`**
 
@@ -3279,7 +3279,7 @@ Defined in: [mcp/task-queue.ts:110](https://github.com/tangle-network/agent-runt
 
 > **args**: `Args`
 
-Defined in: [mcp/task-queue.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L111)
+Defined in: [mcp/task-queue.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L112)
 
 **`Experimental`**
 
@@ -3287,7 +3287,7 @@ Defined in: [mcp/task-queue.ts:111](https://github.com/tangle-network/agent-runt
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/task-queue.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L112)
+Defined in: [mcp/task-queue.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L113)
 
 **`Experimental`**
 
@@ -3295,7 +3295,7 @@ Defined in: [mcp/task-queue.ts:112](https://github.com/tangle-network/agent-runt
 
 > `optional` **idempotencyKey?**: `string`
 
-Defined in: [mcp/task-queue.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L113)
+Defined in: [mcp/task-queue.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L114)
 
 **`Experimental`**
 
@@ -3303,7 +3303,7 @@ Defined in: [mcp/task-queue.ts:113](https://github.com/tangle-network/agent-runt
 
 > `optional` **detachedSessionRef?**: `string`
 
-Defined in: [mcp/task-queue.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L120)
+Defined in: [mcp/task-queue.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L121)
 
 **`Experimental`**
 
@@ -3316,7 +3316,7 @@ hands it to the `resumeDelegate` seam instead of failing the record.
 
 > **run**: (`ctx`) => `Promise`\<`CoderOutput` \| [`UiAuditorDelegationOutput`](#uiauditordelegationoutput) \| [`ResearchOutputShape`](#researchoutputshape)\>
 
-Defined in: [mcp/task-queue.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L127)
+Defined in: [mcp/task-queue.ts:128](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L128)
 
 **`Experimental`**
 
@@ -3339,7 +3339,7 @@ queue wraps it with the profile tag.
 
 ### DelegationRunContext
 
-Defined in: [mcp/task-queue.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L131)
+Defined in: [mcp/task-queue.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L132)
 
 **`Experimental`**
 
@@ -3351,7 +3351,7 @@ Context handed to a `SubmitInput.run` function.
 
 > **signal**: `AbortSignal`
 
-Defined in: [mcp/task-queue.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L132)
+Defined in: [mcp/task-queue.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L133)
 
 **`Experimental`**
 
@@ -3359,7 +3359,7 @@ Defined in: [mcp/task-queue.ts:132](https://github.com/tangle-network/agent-runt
 
 > `optional` **detachedSessionRef?**: `string`
 
-Defined in: [mcp/task-queue.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L135)
+Defined in: [mcp/task-queue.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L136)
 
 **`Experimental`**
 
@@ -3369,7 +3369,7 @@ The `detachedSessionRef` recorded at submit, when one was supplied.
 
 > `optional` **traceEmitter?**: [`LoopTraceEmitter`](runtime.md#looptraceemitter)
 
-Defined in: [mcp/task-queue.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L153)
+Defined in: [mcp/task-queue.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L154)
 
 **`Experimental`**
 
@@ -3387,7 +3387,7 @@ contexts stay source-compatible.
 
 > **report**(`progress`): `void`
 
-Defined in: [mcp/task-queue.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L133)
+Defined in: [mcp/task-queue.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L134)
 
 **`Experimental`**
 
@@ -3405,7 +3405,7 @@ Defined in: [mcp/task-queue.ts:133](https://github.com/tangle-network/agent-runt
 
 > **updateDetachedSessionRef**(`ref`): `void`
 
-Defined in: [mcp/task-queue.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L143)
+Defined in: [mcp/task-queue.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L144)
 
 **`Experimental`**
 
@@ -3429,7 +3429,7 @@ ref — erasing the resume key would silently make the record unresumable.
 
 ### SubmitOutput
 
-Defined in: [mcp/task-queue.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L157)
+Defined in: [mcp/task-queue.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L158)
 
 **`Experimental`**
 
@@ -3439,7 +3439,7 @@ Defined in: [mcp/task-queue.ts:157](https://github.com/tangle-network/agent-runt
 
 > **taskId**: `string`
 
-Defined in: [mcp/task-queue.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L158)
+Defined in: [mcp/task-queue.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L159)
 
 **`Experimental`**
 
@@ -3447,7 +3447,7 @@ Defined in: [mcp/task-queue.ts:158](https://github.com/tangle-network/agent-runt
 
 > **reused**: `boolean`
 
-Defined in: [mcp/task-queue.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L160)
+Defined in: [mcp/task-queue.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L161)
 
 **`Experimental`**
 
@@ -3457,7 +3457,7 @@ True when a prior matching `idempotencyKey` returned an existing record.
 
 ### DelegationResumeContext
 
-Defined in: [mcp/task-queue.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L177)
+Defined in: [mcp/task-queue.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L178)
 
 **`Experimental`**
 
@@ -3467,7 +3467,7 @@ Defined in: [mcp/task-queue.ts:177](https://github.com/tangle-network/agent-runt
 
 > **signal**: `AbortSignal`
 
-Defined in: [mcp/task-queue.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L179)
+Defined in: [mcp/task-queue.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L180)
 
 **`Experimental`**
 
@@ -3479,7 +3479,7 @@ Fired by `cancel(taskId)`; the driver should stop the remote run when it can.
 
 > **report**(`progress`): `void`
 
-Defined in: [mcp/task-queue.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L180)
+Defined in: [mcp/task-queue.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L181)
 
 **`Experimental`**
 
@@ -3497,7 +3497,7 @@ Defined in: [mcp/task-queue.ts:180](https://github.com/tangle-network/agent-runt
 
 ### DelegationResumeDriver
 
-Defined in: [mcp/task-queue.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L193)
+Defined in: [mcp/task-queue.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L194)
 
 **`Experimental`**
 
@@ -3514,7 +3514,7 @@ terminal and are not retried.
 
 > `optional` **intervalMs?**: `number`
 
-Defined in: [mcp/task-queue.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L199)
+Defined in: [mcp/task-queue.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L200)
 
 **`Experimental`**
 
@@ -3526,7 +3526,7 @@ Delay between `running` ticks, in milliseconds. Default 5000.
 
 > **tick**(`task`, `ctx`): `Promise`\<[`DelegationResumeTick`](#delegationresumetick)\>
 
-Defined in: [mcp/task-queue.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L194)
+Defined in: [mcp/task-queue.ts:195](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L195)
 
 **`Experimental`**
 
@@ -3554,7 +3554,7 @@ Defined in: [mcp/task-queue.ts:194](https://github.com/tangle-network/agent-runt
 
 ### DelegationTaskQueueOptions
 
-Defined in: [mcp/task-queue.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L203)
+Defined in: [mcp/task-queue.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L204)
 
 **`Experimental`**
 
@@ -3564,7 +3564,7 @@ Defined in: [mcp/task-queue.ts:203](https://github.com/tangle-network/agent-runt
 
 > `optional` **generateId?**: () => `string`
 
-Defined in: [mcp/task-queue.ts:205](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L205)
+Defined in: [mcp/task-queue.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L206)
 
 **`Experimental`**
 
@@ -3578,7 +3578,7 @@ ID generator override; default `randomTaskId`.
 
 > `optional` **now?**: () => `string`
 
-Defined in: [mcp/task-queue.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L207)
+Defined in: [mcp/task-queue.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L208)
 
 **`Experimental`**
 
@@ -3592,7 +3592,7 @@ Clock override; default `() => new Date().toISOString()`.
 
 > `optional` **store?**: [`DelegationStore`](#delegationstore)
 
-Defined in: [mcp/task-queue.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L215)
+Defined in: [mcp/task-queue.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L216)
 
 **`Experimental`**
 
@@ -3606,7 +3606,7 @@ constructing with `new` never loads prior state.
 
 > `optional` **resumeDelegate?**: [`DelegationResumeDriver`](#delegationresumedriver)
 
-Defined in: [mcp/task-queue.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L217)
+Defined in: [mcp/task-queue.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L218)
 
 **`Experimental`**
 
@@ -3616,7 +3616,7 @@ Resume seam for restored in-flight records that carry a `detachedSessionRef`.
 
 > `optional` **maxTerminalRecords?**: `number`
 
-Defined in: [mcp/task-queue.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L223)
+Defined in: [mcp/task-queue.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L224)
 
 **`Experimental`**
 
@@ -3628,7 +3628,7 @@ store once the cap is exceeded. Default unbounded.
 
 > `optional` **onPersistError?**: (`error`) => `void`
 
-Defined in: [mcp/task-queue.ts:230](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L230)
+Defined in: [mcp/task-queue.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L231)
 
 **`Experimental`**
 
@@ -3651,7 +3651,7 @@ degrading durable mode to memory-only would lie to the caller.
 
 > `optional` **traceContext?**: [`TraceContext`](#tracecontext-2)
 
-Defined in: [mcp/task-queue.ts:238](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L238)
+Defined in: [mcp/task-queue.ts:239](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L239)
 
 **`Experimental`**
 
@@ -3665,7 +3665,7 @@ they were persisted with.
 
 ### Check
 
-Defined in: [mcp/tools/checks.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L82)
+Defined in: [mcp/tools/checks.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L83)
 
 One lens — a composable analyst kind. Identity fields mirror `TraceAnalystKindSpec` so a kind is
  upgradeable to the full agentic factory; `lookFor` is the lens question the actor applies.
@@ -3676,19 +3676,19 @@ One lens — a composable analyst kind. Identity fields mirror `TraceAnalystKind
 
 > `readonly` **id**: `string`
 
-Defined in: [mcp/tools/checks.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L83)
+Defined in: [mcp/tools/checks.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L84)
 
 ##### description
 
 > `readonly` **description**: `string`
 
-Defined in: [mcp/tools/checks.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L84)
+Defined in: [mcp/tools/checks.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L85)
 
 ##### area
 
 > `readonly` **area**: `string`
 
-Defined in: [mcp/tools/checks.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L86)
+Defined in: [mcp/tools/checks.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L87)
 
 Coarse classification stamped on every finding this kind emits (the renderer groups by it).
 
@@ -3696,13 +3696,13 @@ Coarse classification stamped on every finding this kind emits (the renderer gro
 
 > `readonly` **version**: `string`
 
-Defined in: [mcp/tools/checks.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L87)
+Defined in: [mcp/tools/checks.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L88)
 
 ##### lookFor
 
 > `readonly` **lookFor**: `string`
 
-Defined in: [mcp/tools/checks.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L89)
+Defined in: [mcp/tools/checks.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L90)
 
 The lens — what this analyst looks for in the trace.
 
@@ -3710,7 +3710,7 @@ The lens — what this analyst looks for in the trace.
 
 ### CheckRunnerOptions
 
-Defined in: [mcp/tools/checks.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L209)
+Defined in: [mcp/tools/checks.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L210)
 
 #### Properties
 
@@ -3718,25 +3718,25 @@ Defined in: [mcp/tools/checks.ts:209](https://github.com/tangle-network/agent-ru
 
 > **routerBaseUrl**: `string`
 
-Defined in: [mcp/tools/checks.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L210)
+Defined in: [mcp/tools/checks.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L211)
 
 ##### routerKey
 
 > **routerKey**: `string`
 
-Defined in: [mcp/tools/checks.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L211)
+Defined in: [mcp/tools/checks.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L212)
 
 ##### model
 
 > **model**: `string`
 
-Defined in: [mcp/tools/checks.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L212)
+Defined in: [mcp/tools/checks.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L213)
 
 ##### chat?
 
 > `optional` **chat?**: (`system`, `user`) => `Promise`\<`string`\>
 
-Defined in: [mcp/tools/checks.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L214)
+Defined in: [mcp/tools/checks.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L215)
 
 Test/override seam — replace the LLM call. Default: a router chat completion.
 
@@ -3758,7 +3758,7 @@ Test/override seam — replace the LLM call. Default: a router chat completion.
 
 ### SettledWorker
 
-Defined in: [mcp/tools/coordination.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L21)
+Defined in: [mcp/tools/coordination.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L22)
 
 A worker the driver has drained via `await_event`.
 
@@ -3768,43 +3768,43 @@ A worker the driver has drained via `await_event`.
 
 > `readonly` **id**: `string`
 
-Defined in: [mcp/tools/coordination.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L22)
+Defined in: [mcp/tools/coordination.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L23)
 
 ##### status
 
 > `readonly` **status**: `"done"` \| `"down"`
 
-Defined in: [mcp/tools/coordination.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L23)
+Defined in: [mcp/tools/coordination.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L24)
 
 ##### score?
 
 > `readonly` `optional` **score?**: `number`
 
-Defined in: [mcp/tools/coordination.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L24)
+Defined in: [mcp/tools/coordination.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L25)
 
 ##### valid?
 
 > `readonly` `optional` **valid?**: `boolean`
 
-Defined in: [mcp/tools/coordination.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L25)
+Defined in: [mcp/tools/coordination.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L26)
 
 ##### outRef?
 
 > `readonly` `optional` **outRef?**: `string`
 
-Defined in: [mcp/tools/coordination.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L26)
+Defined in: [mcp/tools/coordination.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L27)
 
 ##### reason?
 
 > `readonly` `optional` **reason?**: `string`
 
-Defined in: [mcp/tools/coordination.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L27)
+Defined in: [mcp/tools/coordination.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L28)
 
 ***
 
 ### Question
 
-Defined in: [mcp/tools/coordination.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L38)
+Defined in: [mcp/tools/coordination.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L39)
 
 #### Extended by
 
@@ -3816,49 +3816,49 @@ Defined in: [mcp/tools/coordination.ts:38](https://github.com/tangle-network/age
 
 > `readonly` **id**: `string`
 
-Defined in: [mcp/tools/coordination.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L39)
+Defined in: [mcp/tools/coordination.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L40)
 
 ##### from
 
 > `readonly` **from**: `string`
 
-Defined in: [mcp/tools/coordination.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L40)
+Defined in: [mcp/tools/coordination.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L41)
 
 ##### level
 
 > `readonly` **level**: `QuestionLevel`
 
-Defined in: [mcp/tools/coordination.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L41)
+Defined in: [mcp/tools/coordination.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L42)
 
 ##### question
 
 > `readonly` **question**: `string`
 
-Defined in: [mcp/tools/coordination.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L42)
+Defined in: [mcp/tools/coordination.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L43)
 
 ##### reason
 
 > `readonly` **reason**: `string`
 
-Defined in: [mcp/tools/coordination.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L43)
+Defined in: [mcp/tools/coordination.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L44)
 
 ##### urgency
 
 > `readonly` **urgency**: `QuestionUrgency`
 
-Defined in: [mcp/tools/coordination.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L44)
+Defined in: [mcp/tools/coordination.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L45)
 
 ##### options?
 
 > `readonly` `optional` **options?**: readonly `QuestionOption`[]
 
-Defined in: [mcp/tools/coordination.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L45)
+Defined in: [mcp/tools/coordination.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L46)
 
 ***
 
 ### QuestionRecord
 
-Defined in: [mcp/tools/coordination.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L53)
+Defined in: [mcp/tools/coordination.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L54)
 
 #### Extends
 
@@ -3870,7 +3870,7 @@ Defined in: [mcp/tools/coordination.ts:53](https://github.com/tangle-network/age
 
 > `readonly` **id**: `string`
 
-Defined in: [mcp/tools/coordination.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L39)
+Defined in: [mcp/tools/coordination.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L40)
 
 ###### Inherited from
 
@@ -3880,7 +3880,7 @@ Defined in: [mcp/tools/coordination.ts:39](https://github.com/tangle-network/age
 
 > `readonly` **from**: `string`
 
-Defined in: [mcp/tools/coordination.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L40)
+Defined in: [mcp/tools/coordination.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L41)
 
 ###### Inherited from
 
@@ -3890,7 +3890,7 @@ Defined in: [mcp/tools/coordination.ts:40](https://github.com/tangle-network/age
 
 > `readonly` **level**: `QuestionLevel`
 
-Defined in: [mcp/tools/coordination.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L41)
+Defined in: [mcp/tools/coordination.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L42)
 
 ###### Inherited from
 
@@ -3900,7 +3900,7 @@ Defined in: [mcp/tools/coordination.ts:41](https://github.com/tangle-network/age
 
 > `readonly` **question**: `string`
 
-Defined in: [mcp/tools/coordination.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L42)
+Defined in: [mcp/tools/coordination.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L43)
 
 ###### Inherited from
 
@@ -3910,7 +3910,7 @@ Defined in: [mcp/tools/coordination.ts:42](https://github.com/tangle-network/age
 
 > `readonly` **reason**: `string`
 
-Defined in: [mcp/tools/coordination.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L43)
+Defined in: [mcp/tools/coordination.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L44)
 
 ###### Inherited from
 
@@ -3920,7 +3920,7 @@ Defined in: [mcp/tools/coordination.ts:43](https://github.com/tangle-network/age
 
 > `readonly` **urgency**: `QuestionUrgency`
 
-Defined in: [mcp/tools/coordination.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L44)
+Defined in: [mcp/tools/coordination.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L45)
 
 ###### Inherited from
 
@@ -3930,7 +3930,7 @@ Defined in: [mcp/tools/coordination.ts:44](https://github.com/tangle-network/age
 
 > `readonly` `optional` **options?**: readonly `QuestionOption`[]
 
-Defined in: [mcp/tools/coordination.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L45)
+Defined in: [mcp/tools/coordination.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L46)
 
 ###### Inherited from
 
@@ -3940,25 +3940,25 @@ Defined in: [mcp/tools/coordination.ts:45](https://github.com/tangle-network/age
 
 > `readonly` **status**: `"open"` \| `"answered"` \| `"deferred"` \| `"escalated"`
 
-Defined in: [mcp/tools/coordination.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L54)
+Defined in: [mcp/tools/coordination.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L55)
 
 ##### decision?
 
 > `readonly` `optional` **decision?**: [`QuestionDecision`](#questiondecision)
 
-Defined in: [mcp/tools/coordination.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L55)
+Defined in: [mcp/tools/coordination.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L56)
 
 ##### openedAt
 
 > `readonly` **openedAt**: `number`
 
-Defined in: [mcp/tools/coordination.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L56)
+Defined in: [mcp/tools/coordination.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L57)
 
 ***
 
 ### CoordinationToolsOptions
 
-Defined in: [mcp/tools/coordination.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L94)
+Defined in: [mcp/tools/coordination.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L95)
 
 #### Properties
 
@@ -3966,37 +3966,37 @@ Defined in: [mcp/tools/coordination.ts:94](https://github.com/tangle-network/age
 
 > `readonly` **scope**: [`Scope`](runtime.md#scope-1)\<`unknown`\>
 
-Defined in: [mcp/tools/coordination.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L95)
+Defined in: [mcp/tools/coordination.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L96)
 
 ##### blobs
 
 > `readonly` **blobs**: [`ResultBlobStore`](runtime.md#resultblobstore)
 
-Defined in: [mcp/tools/coordination.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L96)
+Defined in: [mcp/tools/coordination.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L97)
 
 ##### makeWorkerAgent
 
 > `readonly` **makeWorkerAgent**: [`MakeWorkerAgent`](runtime.md#makeworkeragent)
 
-Defined in: [mcp/tools/coordination.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L97)
+Defined in: [mcp/tools/coordination.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L98)
 
 ##### perWorker
 
 > `readonly` **perWorker**: [`Budget`](runtime.md#budget-12)
 
-Defined in: [mcp/tools/coordination.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L98)
+Defined in: [mcp/tools/coordination.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L99)
 
 ##### analysts?
 
 > `readonly` `optional` **analysts?**: [`AnalystRegistry`](runtime.md#analystregistry)
 
-Defined in: [mcp/tools/coordination.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L99)
+Defined in: [mcp/tools/coordination.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L100)
 
 ##### onEvent?
 
 > `readonly` `optional` **onEvent?**: (`event`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [mcp/tools/coordination.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L100)
+Defined in: [mcp/tools/coordination.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L101)
 
 ###### Parameters
 
@@ -4012,13 +4012,13 @@ Defined in: [mcp/tools/coordination.ts:100](https://github.com/tangle-network/ag
 
 > `readonly` `optional` **questionPolicy?**: [`QuestionPolicy`](#questionpolicy)
 
-Defined in: [mcp/tools/coordination.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L101)
+Defined in: [mcp/tools/coordination.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L102)
 
 ##### analyzeOnSettle?
 
 > `readonly` `optional` **analyzeOnSettle?**: readonly `string`[]
 
-Defined in: [mcp/tools/coordination.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L106)
+Defined in: [mcp/tools/coordination.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L107)
 
 Analyst kind ids to run AUTOMATICALLY when a worker settles `done` (the analyst-on-settle
  hook). Each result is published as a `finding` event on the bus — pass-through to subscribers
@@ -4029,7 +4029,7 @@ Analyst kind ids to run AUTOMATICALLY when a worker settles `done` (the analyst-
 
 > `readonly` `optional` **maxLiveWorkers?**: `number`
 
-Defined in: [mcp/tools/coordination.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L112)
+Defined in: [mcp/tools/coordination.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L113)
 
 Hard cap on how many workers may be LIVE (spawned but not yet settled) at once. `spawn_agent`
  counts the scope's non-terminal nodes and fails closed (`error: 'max-live-workers'`) BEFORE
@@ -4041,7 +4041,7 @@ Hard cap on how many workers may be LIVE (spawned but not yet settled) at once.
 
 ### CoordinationTools
 
-Defined in: [mcp/tools/coordination.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L122)
+Defined in: [mcp/tools/coordination.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L123)
 
 The supervisor-side toolbox returned by [createCoordinationTools](#createcoordinationtools): the MCP tool
 descriptors a driver `AgentProfile` calls to spawn, steer, observe, and settle workers
@@ -4055,7 +4055,7 @@ choice, steerable counterpart to the one-shot own-sandbox delegation MCP.
 
 > `readonly` **tools**: [`McpToolDescriptor`](#mcptooldescriptor)[]
 
-Defined in: [mcp/tools/coordination.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L123)
+Defined in: [mcp/tools/coordination.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L124)
 
 #### Methods
 
@@ -4063,7 +4063,7 @@ Defined in: [mcp/tools/coordination.ts:123](https://github.com/tangle-network/ag
 
 > **isStopped**(): `boolean`
 
-Defined in: [mcp/tools/coordination.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L124)
+Defined in: [mcp/tools/coordination.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L125)
 
 ###### Returns
 
@@ -4073,7 +4073,7 @@ Defined in: [mcp/tools/coordination.ts:124](https://github.com/tangle-network/ag
 
 > **stopReason**(): `string` \| `undefined`
 
-Defined in: [mcp/tools/coordination.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L125)
+Defined in: [mcp/tools/coordination.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L126)
 
 ###### Returns
 
@@ -4083,7 +4083,7 @@ Defined in: [mcp/tools/coordination.ts:125](https://github.com/tangle-network/ag
 
 > **settled**(): readonly [`SettledWorker`](#settledworker)[]
 
-Defined in: [mcp/tools/coordination.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L126)
+Defined in: [mcp/tools/coordination.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L127)
 
 ###### Returns
 
@@ -4093,7 +4093,7 @@ readonly [`SettledWorker`](#settledworker)[]
 
 > **questions**(): readonly [`QuestionRecord`](#questionrecord)[]
 
-Defined in: [mcp/tools/coordination.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L127)
+Defined in: [mcp/tools/coordination.ts:128](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L128)
 
 ###### Returns
 
@@ -4103,7 +4103,7 @@ readonly [`QuestionRecord`](#questionrecord)[]
 
 > **history**(): readonly [`BusRecord`](runtime.md#busrecord)\<[`CoordinationEvent`](runtime.md#coordinationevent)\>[]
 
-Defined in: [mcp/tools/coordination.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L131)
+Defined in: [mcp/tools/coordination.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L132)
 
 The full ordered log of every bus event — UP (settled / question / finding) and DOWN
  (steer / answer) — the observability audit + replay trail. Each record carries seq,
@@ -4117,7 +4117,7 @@ readonly [`BusRecord`](runtime.md#busrecord)\<[`CoordinationEvent`](runtime.md#c
 
 > **stats**(): [`BusStats`](runtime.md#busstats)
 
-Defined in: [mcp/tools/coordination.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L133)
+Defined in: [mcp/tools/coordination.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L134)
 
 Bus throughput counters (published / pulled / by-kind) for live dashboards.
 
@@ -4129,7 +4129,7 @@ Bus throughput counters (published / pulled / by-kind) for live dashboards.
 
 > **raiseFinding**(`finding`): `Promise`\<`void`\>
 
-Defined in: [mcp/tools/coordination.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L137)
+Defined in: [mcp/tools/coordination.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L138)
 
 Raise a `finding` on the bus from outside the settle hook — the seam an ONLINE detector
  (mid-run, on the worker pipe) uses to tell the driver "this worker is looping/erroring" the
@@ -4149,7 +4149,7 @@ Raise a `finding` on the bus from outside the settle hook — the seam an ONLINE
 
 > **drainResolved**(): `Promise`\<`number`\>
 
-Defined in: [mcp/tools/coordination.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L146)
+Defined in: [mcp/tools/coordination.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L147)
 
 Post-loop drain: pull every ALREADY-settled, unpulled child into the ledger (publishing each
 as a `settled` bus event for the audit trail) WITHOUT awaiting live children. The driver
@@ -4166,7 +4166,7 @@ nobody is left to read a finding, and analysts spend real compute). Returns the
 
 ### DelegateArgs
 
-Defined in: [mcp/tools/delegate.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L67)
+Defined in: [mcp/tools/delegate.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L68)
 
 Parsed `delegate` tool arguments.
 
@@ -4176,25 +4176,25 @@ Parsed `delegate` tool arguments.
 
 > **intent**: `string`
 
-Defined in: [mcp/tools/delegate.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L68)
+Defined in: [mcp/tools/delegate.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L69)
 
 ##### model?
 
 > `optional` **model?**: `string`
 
-Defined in: [mcp/tools/delegate.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L69)
+Defined in: [mcp/tools/delegate.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L70)
 
 ##### runId?
 
 > `optional` **runId?**: `string`
 
-Defined in: [mcp/tools/delegate.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L70)
+Defined in: [mcp/tools/delegate.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L71)
 
 ***
 
 ### DelegateHandlerOptions
 
-Defined in: [mcp/tools/delegate.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L102)
+Defined in: [mcp/tools/delegate.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L103)
 
 **`Experimental`**
 
@@ -4204,7 +4204,7 @@ Defined in: [mcp/tools/delegate.ts:102](https://github.com/tangle-network/agent-
 
 > **router**: [`RouterConfig`](runtime.md#routerconfig)
 
-Defined in: [mcp/tools/delegate.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L104)
+Defined in: [mcp/tools/delegate.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L105)
 
 **`Experimental`**
 
@@ -4214,7 +4214,7 @@ The supervisor brain's router substrate (REQUIRED — the default supervisor is
 
 > **backend**: [`ExecutorConfig`](runtime.md#executorconfig)
 
-Defined in: [mcp/tools/delegate.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L106)
+Defined in: [mcp/tools/delegate.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L107)
 
 **`Experimental`**
 
@@ -4224,7 +4224,7 @@ WHERE the authored workers run. Required for `supervise()` to spawn anything.
 
 > `optional` **deliverable?**: [`DeliverableSpec`](runtime.md#deliverablespec)\<`unknown`\>
 
-Defined in: [mcp/tools/delegate.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L108)
+Defined in: [mcp/tools/delegate.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L109)
 
 **`Experimental`**
 
@@ -4234,7 +4234,7 @@ The completion oracle the authored workers settle against (settled ⟺ delivered
 
 > `optional` **model?**: `string`
 
-Defined in: [mcp/tools/delegate.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L110)
+Defined in: [mcp/tools/delegate.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L111)
 
 **`Experimental`**
 
@@ -4244,7 +4244,7 @@ Default supervisor brain model when a call omits `model`.
 
 > `optional` **allowedModels?**: readonly `string`[]
 
-Defined in: [mcp/tools/delegate.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L112)
+Defined in: [mcp/tools/delegate.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L113)
 
 **`Experimental`**
 
@@ -4254,7 +4254,7 @@ Restrict the run to this subset of models.
 
 ### TraceContext
 
-Defined in: [mcp/trace-propagation.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L24)
+Defined in: [mcp/trace-propagation.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L25)
 
 #### Properties
 
@@ -4262,7 +4262,7 @@ Defined in: [mcp/trace-propagation.ts:24](https://github.com/tangle-network/agen
 
 > **traceId**: `string`
 
-Defined in: [mcp/trace-propagation.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L26)
+Defined in: [mcp/trace-propagation.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L27)
 
 Trace id inherited from the parent process, or a fresh one.
 
@@ -4270,7 +4270,7 @@ Trace id inherited from the parent process, or a fresh one.
 
 > `optional` **parentSpanId?**: `string`
 
-Defined in: [mcp/trace-propagation.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L28)
+Defined in: [mcp/trace-propagation.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L29)
 
 Parent span id from the delegation that launched this MCP server.
 
@@ -4278,7 +4278,7 @@ Parent span id from the delegation that launched this MCP server.
 
 ### DelegateCodeConfig
 
-Defined in: [mcp/types.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L34)
+Defined in: [mcp/types.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L35)
 
 **`Experimental`**
 
@@ -4293,7 +4293,7 @@ validator behavior.
 
 > `optional` **testCmd?**: `string`
 
-Defined in: [mcp/types.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L35)
+Defined in: [mcp/types.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L36)
 
 **`Experimental`**
 
@@ -4301,7 +4301,7 @@ Defined in: [mcp/types.ts:35](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **typecheckCmd?**: `string`
 
-Defined in: [mcp/types.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L36)
+Defined in: [mcp/types.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L37)
 
 **`Experimental`**
 
@@ -4309,7 +4309,7 @@ Defined in: [mcp/types.ts:36](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **forbiddenPaths?**: `string`[]
 
-Defined in: [mcp/types.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L37)
+Defined in: [mcp/types.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L38)
 
 **`Experimental`**
 
@@ -4317,7 +4317,7 @@ Defined in: [mcp/types.ts:37](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **maxDiffLines?**: `number`
 
-Defined in: [mcp/types.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L38)
+Defined in: [mcp/types.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L39)
 
 **`Experimental`**
 
@@ -4325,7 +4325,7 @@ Defined in: [mcp/types.ts:38](https://github.com/tangle-network/agent-runtime/bl
 
 ### DelegateCodeArgs
 
-Defined in: [mcp/types.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L42)
+Defined in: [mcp/types.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L43)
 
 **`Experimental`**
 
@@ -4335,7 +4335,7 @@ Defined in: [mcp/types.ts:42](https://github.com/tangle-network/agent-runtime/bl
 
 > **goal**: `string`
 
-Defined in: [mcp/types.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L44)
+Defined in: [mcp/types.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L45)
 
 **`Experimental`**
 
@@ -4345,7 +4345,7 @@ Natural-language description of what the coder must accomplish.
 
 > **repoRoot**: `string`
 
-Defined in: [mcp/types.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L46)
+Defined in: [mcp/types.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L47)
 
 **`Experimental`**
 
@@ -4355,7 +4355,7 @@ Absolute path inside the sandbox where the repo lives.
 
 > `optional` **contextHint?**: `string`
 
-Defined in: [mcp/types.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L48)
+Defined in: [mcp/types.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L49)
 
 **`Experimental`**
 
@@ -4365,7 +4365,7 @@ Optional free-form context the agent surfaces in the prompt prelude.
 
 > `optional` **variants?**: `number`
 
-Defined in: [mcp/types.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L54)
+Defined in: [mcp/types.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L55)
 
 **`Experimental`**
 
@@ -4377,7 +4377,7 @@ passing patch. Default 1.
 
 > `optional` **config?**: [`DelegateCodeConfig`](#delegatecodeconfig)
 
-Defined in: [mcp/types.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L56)
+Defined in: [mcp/types.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L57)
 
 **`Experimental`**
 
@@ -4387,7 +4387,7 @@ Validator + prompt overrides the agent knows for this repo.
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/types.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L58)
+Defined in: [mcp/types.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L59)
 
 **`Experimental`**
 
@@ -4397,7 +4397,7 @@ Multi-tenant scope (customer-id, workspace-id).
 
 ### DelegateCodeResult
 
-Defined in: [mcp/types.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L62)
+Defined in: [mcp/types.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L63)
 
 **`Experimental`**
 
@@ -4407,7 +4407,7 @@ Defined in: [mcp/types.ts:62](https://github.com/tangle-network/agent-runtime/bl
 
 > **taskId**: `string`
 
-Defined in: [mcp/types.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L63)
+Defined in: [mcp/types.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L64)
 
 **`Experimental`**
 
@@ -4415,7 +4415,7 @@ Defined in: [mcp/types.ts:63](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **estimatedDurationMs?**: `number`
 
-Defined in: [mcp/types.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L65)
+Defined in: [mcp/types.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L66)
 
 **`Experimental`**
 
@@ -4425,7 +4425,7 @@ Best-effort hint — coder loops can take minutes-to-hours.
 
 ### DelegateResearchConfig
 
-Defined in: [mcp/types.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L72)
+Defined in: [mcp/types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L73)
 
 **`Experimental`**
 
@@ -4435,7 +4435,7 @@ Defined in: [mcp/types.ts:72](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **recencyWindow?**: `object`
 
-Defined in: [mcp/types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L73)
+Defined in: [mcp/types.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L74)
 
 **`Experimental`**
 
@@ -4451,7 +4451,7 @@ Defined in: [mcp/types.ts:73](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **maxItems?**: `number`
 
-Defined in: [mcp/types.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L74)
+Defined in: [mcp/types.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L75)
 
 **`Experimental`**
 
@@ -4459,7 +4459,7 @@ Defined in: [mcp/types.ts:74](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **minConfidence?**: `number`
 
-Defined in: [mcp/types.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L75)
+Defined in: [mcp/types.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L76)
 
 **`Experimental`**
 
@@ -4467,7 +4467,7 @@ Defined in: [mcp/types.ts:75](https://github.com/tangle-network/agent-runtime/bl
 
 ### DelegateResearchArgs
 
-Defined in: [mcp/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L79)
+Defined in: [mcp/types.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L80)
 
 **`Experimental`**
 
@@ -4477,7 +4477,7 @@ Defined in: [mcp/types.ts:79](https://github.com/tangle-network/agent-runtime/bl
 
 > **question**: `string`
 
-Defined in: [mcp/types.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L80)
+Defined in: [mcp/types.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L81)
 
 **`Experimental`**
 
@@ -4485,7 +4485,7 @@ Defined in: [mcp/types.ts:80](https://github.com/tangle-network/agent-runtime/bl
 
 > **namespace**: `string`
 
-Defined in: [mcp/types.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L81)
+Defined in: [mcp/types.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L82)
 
 **`Experimental`**
 
@@ -4493,7 +4493,7 @@ Defined in: [mcp/types.ts:81](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **scope?**: `string`
 
-Defined in: [mcp/types.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L82)
+Defined in: [mcp/types.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L83)
 
 **`Experimental`**
 
@@ -4501,7 +4501,7 @@ Defined in: [mcp/types.ts:82](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **sources?**: [`ResearchSource`](#researchsource)[]
 
-Defined in: [mcp/types.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L83)
+Defined in: [mcp/types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L84)
 
 **`Experimental`**
 
@@ -4509,7 +4509,7 @@ Defined in: [mcp/types.ts:83](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **variants?**: `number`
 
-Defined in: [mcp/types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L84)
+Defined in: [mcp/types.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L85)
 
 **`Experimental`**
 
@@ -4517,7 +4517,7 @@ Defined in: [mcp/types.ts:84](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **config?**: [`DelegateResearchConfig`](#delegateresearchconfig)
 
-Defined in: [mcp/types.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L85)
+Defined in: [mcp/types.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L86)
 
 **`Experimental`**
 
@@ -4525,7 +4525,7 @@ Defined in: [mcp/types.ts:85](https://github.com/tangle-network/agent-runtime/bl
 
 ### DelegateResearchResult
 
-Defined in: [mcp/types.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L89)
+Defined in: [mcp/types.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L90)
 
 **`Experimental`**
 
@@ -4535,7 +4535,7 @@ Defined in: [mcp/types.ts:89](https://github.com/tangle-network/agent-runtime/bl
 
 > **taskId**: `string`
 
-Defined in: [mcp/types.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L90)
+Defined in: [mcp/types.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L91)
 
 **`Experimental`**
 
@@ -4543,7 +4543,7 @@ Defined in: [mcp/types.ts:90](https://github.com/tangle-network/agent-runtime/bl
 
 > `optional` **estimatedDurationMs?**: `number`
 
-Defined in: [mcp/types.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L91)
+Defined in: [mcp/types.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L92)
 
 **`Experimental`**
 
@@ -4551,7 +4551,7 @@ Defined in: [mcp/types.ts:91](https://github.com/tangle-network/agent-runtime/bl
 
 ### FeedbackRefersTo
 
-Defined in: [mcp/types.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L95)
+Defined in: [mcp/types.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L96)
 
 **`Experimental`**
 
@@ -4561,7 +4561,7 @@ Defined in: [mcp/types.ts:95](https://github.com/tangle-network/agent-runtime/bl
 
 > **kind**: `"artifact"` \| `"delegation"` \| `"outcome"`
 
-Defined in: [mcp/types.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L96)
+Defined in: [mcp/types.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L97)
 
 **`Experimental`**
 
@@ -4569,7 +4569,7 @@ Defined in: [mcp/types.ts:96](https://github.com/tangle-network/agent-runtime/bl
 
 > **ref**: `string`
 
-Defined in: [mcp/types.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L98)
+Defined in: [mcp/types.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L99)
 
 **`Experimental`**
 
@@ -4579,7 +4579,7 @@ For `'delegation'`, this is the taskId.
 
 ### FeedbackRating
 
-Defined in: [mcp/types.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L102)
+Defined in: [mcp/types.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L103)
 
 **`Experimental`**
 
@@ -4589,7 +4589,7 @@ Defined in: [mcp/types.ts:102](https://github.com/tangle-network/agent-runtime/b
 
 > **score**: `number`
 
-Defined in: [mcp/types.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L104)
+Defined in: [mcp/types.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L105)
 
 **`Experimental`**
 
@@ -4599,7 +4599,7 @@ Defined in: [mcp/types.ts:104](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **label?**: `"good"` \| `"bad"` \| `"neutral"` \| `"mixed"`
 
-Defined in: [mcp/types.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L105)
+Defined in: [mcp/types.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L106)
 
 **`Experimental`**
 
@@ -4607,7 +4607,7 @@ Defined in: [mcp/types.ts:105](https://github.com/tangle-network/agent-runtime/b
 
 > **notes**: `string`
 
-Defined in: [mcp/types.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L106)
+Defined in: [mcp/types.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L107)
 
 **`Experimental`**
 
@@ -4615,7 +4615,7 @@ Defined in: [mcp/types.ts:106](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegateFeedbackArgs
 
-Defined in: [mcp/types.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L110)
+Defined in: [mcp/types.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L111)
 
 **`Experimental`**
 
@@ -4625,7 +4625,7 @@ Defined in: [mcp/types.ts:110](https://github.com/tangle-network/agent-runtime/b
 
 > **refersTo**: [`FeedbackRefersTo`](#feedbackrefersto)
 
-Defined in: [mcp/types.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L111)
+Defined in: [mcp/types.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L112)
 
 **`Experimental`**
 
@@ -4633,7 +4633,7 @@ Defined in: [mcp/types.ts:111](https://github.com/tangle-network/agent-runtime/b
 
 > **rating**: [`FeedbackRating`](#feedbackrating)
 
-Defined in: [mcp/types.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L112)
+Defined in: [mcp/types.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L113)
 
 **`Experimental`**
 
@@ -4641,7 +4641,7 @@ Defined in: [mcp/types.ts:112](https://github.com/tangle-network/agent-runtime/b
 
 > **by**: `"agent"` \| `"user"` \| `"downstream-judge"`
 
-Defined in: [mcp/types.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L113)
+Defined in: [mcp/types.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L114)
 
 **`Experimental`**
 
@@ -4649,7 +4649,7 @@ Defined in: [mcp/types.ts:113](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **capturedAt?**: `string`
 
-Defined in: [mcp/types.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L115)
+Defined in: [mcp/types.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L116)
 
 **`Experimental`**
 
@@ -4659,7 +4659,7 @@ ISO timestamp; defaults to server clock when omitted.
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/types.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L116)
+Defined in: [mcp/types.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L117)
 
 **`Experimental`**
 
@@ -4667,7 +4667,7 @@ Defined in: [mcp/types.ts:116](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegateFeedbackResult
 
-Defined in: [mcp/types.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L120)
+Defined in: [mcp/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L121)
 
 **`Experimental`**
 
@@ -4677,7 +4677,7 @@ Defined in: [mcp/types.ts:120](https://github.com/tangle-network/agent-runtime/b
 
 > **recorded**: `true`
 
-Defined in: [mcp/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L121)
+Defined in: [mcp/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L122)
 
 **`Experimental`**
 
@@ -4685,7 +4685,7 @@ Defined in: [mcp/types.ts:121](https://github.com/tangle-network/agent-runtime/b
 
 > **id**: `string`
 
-Defined in: [mcp/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L122)
+Defined in: [mcp/types.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L123)
 
 **`Experimental`**
 
@@ -4693,7 +4693,7 @@ Defined in: [mcp/types.ts:122](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegationStatusArgs
 
-Defined in: [mcp/types.ts:126](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L126)
+Defined in: [mcp/types.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L127)
 
 **`Experimental`**
 
@@ -4703,7 +4703,7 @@ Defined in: [mcp/types.ts:126](https://github.com/tangle-network/agent-runtime/b
 
 > **taskId**: `string`
 
-Defined in: [mcp/types.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L127)
+Defined in: [mcp/types.ts:128](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L128)
 
 **`Experimental`**
 
@@ -4711,7 +4711,7 @@ Defined in: [mcp/types.ts:127](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **includeTrace?**: `boolean`
 
-Defined in: [mcp/types.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L134)
+Defined in: [mcp/types.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L135)
 
 **`Experimental`**
 
@@ -4724,7 +4724,7 @@ cost) rather than just the state machine.
 
 ### DelegationProgress
 
-Defined in: [mcp/types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L138)
+Defined in: [mcp/types.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L139)
 
 **`Experimental`**
 
@@ -4734,7 +4734,7 @@ Defined in: [mcp/types.ts:138](https://github.com/tangle-network/agent-runtime/b
 
 > **iteration**: `number`
 
-Defined in: [mcp/types.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L139)
+Defined in: [mcp/types.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L140)
 
 **`Experimental`**
 
@@ -4742,7 +4742,7 @@ Defined in: [mcp/types.ts:139](https://github.com/tangle-network/agent-runtime/b
 
 > **phase**: `string`
 
-Defined in: [mcp/types.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L140)
+Defined in: [mcp/types.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L141)
 
 **`Experimental`**
 
@@ -4750,7 +4750,7 @@ Defined in: [mcp/types.ts:140](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegationError
 
-Defined in: [mcp/types.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L144)
+Defined in: [mcp/types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L145)
 
 **`Experimental`**
 
@@ -4760,7 +4760,7 @@ Defined in: [mcp/types.ts:144](https://github.com/tangle-network/agent-runtime/b
 
 > **message**: `string`
 
-Defined in: [mcp/types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L145)
+Defined in: [mcp/types.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L146)
 
 **`Experimental`**
 
@@ -4768,7 +4768,7 @@ Defined in: [mcp/types.ts:145](https://github.com/tangle-network/agent-runtime/b
 
 > **kind**: `string`
 
-Defined in: [mcp/types.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L146)
+Defined in: [mcp/types.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L147)
 
 **`Experimental`**
 
@@ -4776,7 +4776,7 @@ Defined in: [mcp/types.ts:146](https://github.com/tangle-network/agent-runtime/b
 
 ### UiAuditorDelegationOutput
 
-Defined in: [mcp/types.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L170)
+Defined in: [mcp/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L171)
 
 **`Experimental`**
 
@@ -4792,7 +4792,7 @@ relative path to the regenerated index.md.
 
 > **workspaceDir**: `string`
 
-Defined in: [mcp/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L171)
+Defined in: [mcp/types.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L172)
 
 **`Experimental`**
 
@@ -4800,7 +4800,7 @@ Defined in: [mcp/types.ts:171](https://github.com/tangle-network/agent-runtime/b
 
 > **indexFile**: `string`
 
-Defined in: [mcp/types.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L172)
+Defined in: [mcp/types.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L173)
 
 **`Experimental`**
 
@@ -4808,7 +4808,7 @@ Defined in: [mcp/types.ts:172](https://github.com/tangle-network/agent-runtime/b
 
 > **findings**: [`UiFinding`](profiles.md#uifinding)[]
 
-Defined in: [mcp/types.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L173)
+Defined in: [mcp/types.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L174)
 
 **`Experimental`**
 
@@ -4816,7 +4816,7 @@ Defined in: [mcp/types.ts:173](https://github.com/tangle-network/agent-runtime/b
 
 > **iterations**: `number`
 
-Defined in: [mcp/types.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L175)
+Defined in: [mcp/types.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L176)
 
 **`Experimental`**
 
@@ -4826,7 +4826,7 @@ Total iterations the loop ran for this delegation.
 
 ### DelegateUiAuditRoute
 
-Defined in: [mcp/types.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L182)
+Defined in: [mcp/types.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L183)
 
 Optional per-route capture spec the agent surfaces over the wire.
 
@@ -4836,7 +4836,7 @@ Optional per-route capture spec the agent surfaces over the wire.
 
 > **name**: `string`
 
-Defined in: [mcp/types.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L184)
+Defined in: [mcp/types.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L185)
 
 Stable route name (used in screenshot filenames + finding metadata).
 
@@ -4844,7 +4844,7 @@ Stable route name (used in screenshot filenames + finding metadata).
 
 > **url**: `string`
 
-Defined in: [mcp/types.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L186)
+Defined in: [mcp/types.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L187)
 
 Fully-qualified URL.
 
@@ -4852,7 +4852,7 @@ Fully-qualified URL.
 
 > `optional` **viewports?**: readonly `object`[]
 
-Defined in: [mcp/types.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L188)
+Defined in: [mcp/types.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L189)
 
 Viewports to capture at. Defaults to `[{ width: 1280, height: 800 }]`.
 
@@ -4860,7 +4860,7 @@ Viewports to capture at. Defaults to `[{ width: 1280, height: 800 }]`.
 
 > `optional` **fullPage?**: `boolean`
 
-Defined in: [mcp/types.ts:190](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L190)
+Defined in: [mcp/types.ts:191](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L191)
 
 Default false. Full-page captures for the broad lenses.
 
@@ -4868,7 +4868,7 @@ Default false. Full-page captures for the broad lenses.
 
 > `optional` **waitFor?**: `string`
 
-Defined in: [mcp/types.ts:192](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L192)
+Defined in: [mcp/types.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L193)
 
 Selector to wait for before capture.
 
@@ -4876,7 +4876,7 @@ Selector to wait for before capture.
 
 ### DelegateUiAuditConfig
 
-Defined in: [mcp/types.ts:196](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L196)
+Defined in: [mcp/types.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L197)
 
 **`Experimental`**
 
@@ -4886,7 +4886,7 @@ Defined in: [mcp/types.ts:196](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **lenses?**: `UiAuditLensFilter`
 
-Defined in: [mcp/types.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L201)
+Defined in: [mcp/types.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L202)
 
 **`Experimental`**
 
@@ -4897,7 +4897,7 @@ preserved — the driver iterates lens-by-lens.
 
 > `optional` **maxIterations?**: `number`
 
-Defined in: [mcp/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L203)
+Defined in: [mcp/types.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L204)
 
 **`Experimental`**
 
@@ -4907,7 +4907,7 @@ Maximum total iterations across all (lens × route) pairs. Default 33 (11 lenses
 
 > `optional` **maxConcurrency?**: `number`
 
-Defined in: [mcp/types.ts:205](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L205)
+Defined in: [mcp/types.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L206)
 
 **`Experimental`**
 
@@ -4917,7 +4917,7 @@ Maximum concurrent iterations within a single plan() round. Default 2.
 
 > `optional` **productContext?**: `string`
 
-Defined in: [mcp/types.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L207)
+Defined in: [mcp/types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L208)
 
 **`Experimental`**
 
@@ -4927,7 +4927,7 @@ Free-form product context surfaced to the judge.
 
 ### DelegateUiAuditArgs
 
-Defined in: [mcp/types.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L211)
+Defined in: [mcp/types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L212)
 
 **`Experimental`**
 
@@ -4937,7 +4937,7 @@ Defined in: [mcp/types.ts:211](https://github.com/tangle-network/agent-runtime/b
 
 > **workspaceDir**: `string`
 
-Defined in: [mcp/types.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L213)
+Defined in: [mcp/types.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L214)
 
 **`Experimental`**
 
@@ -4947,7 +4947,7 @@ Workspace root for the audit (absolute path).
 
 > **routes**: readonly [`DelegateUiAuditRoute`](#delegateuiauditroute)[]
 
-Defined in: [mcp/types.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L215)
+Defined in: [mcp/types.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L216)
 
 **`Experimental`**
 
@@ -4957,7 +4957,7 @@ Routes to audit. Must be non-empty.
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/types.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L217)
+Defined in: [mcp/types.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L218)
 
 **`Experimental`**
 
@@ -4967,7 +4967,7 @@ Multi-tenant scope.
 
 > `optional` **config?**: [`DelegateUiAuditConfig`](#delegateuiauditconfig)
 
-Defined in: [mcp/types.ts:218](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L218)
+Defined in: [mcp/types.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L219)
 
 **`Experimental`**
 
@@ -4975,7 +4975,7 @@ Defined in: [mcp/types.ts:218](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegateUiAuditResult
 
-Defined in: [mcp/types.ts:222](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L222)
+Defined in: [mcp/types.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L223)
 
 **`Experimental`**
 
@@ -4985,7 +4985,7 @@ Defined in: [mcp/types.ts:222](https://github.com/tangle-network/agent-runtime/b
 
 > **taskId**: `string`
 
-Defined in: [mcp/types.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L223)
+Defined in: [mcp/types.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L224)
 
 **`Experimental`**
 
@@ -4993,7 +4993,7 @@ Defined in: [mcp/types.ts:223](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **estimatedDurationMs?**: `number`
 
-Defined in: [mcp/types.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L224)
+Defined in: [mcp/types.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L225)
 
 **`Experimental`**
 
@@ -5001,7 +5001,7 @@ Defined in: [mcp/types.ts:224](https://github.com/tangle-network/agent-runtime/b
 
 ### ResearchOutputShape
 
-Defined in: [mcp/types.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L234)
+Defined in: [mcp/types.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L235)
 
 **`Experimental`**
 
@@ -5020,7 +5020,7 @@ a dependency cycle, so the MCP layer treats it structurally.
 
 > **items**: `unknown`[]
 
-Defined in: [mcp/types.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L235)
+Defined in: [mcp/types.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L236)
 
 **`Experimental`**
 
@@ -5028,7 +5028,7 @@ Defined in: [mcp/types.ts:235](https://github.com/tangle-network/agent-runtime/b
 
 > **citations**: `unknown`[]
 
-Defined in: [mcp/types.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L236)
+Defined in: [mcp/types.ts:237](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L237)
 
 **`Experimental`**
 
@@ -5036,7 +5036,7 @@ Defined in: [mcp/types.ts:236](https://github.com/tangle-network/agent-runtime/b
 
 > **proposedWrites**: `unknown`[]
 
-Defined in: [mcp/types.ts:237](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L237)
+Defined in: [mcp/types.ts:238](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L238)
 
 **`Experimental`**
 
@@ -5044,7 +5044,7 @@ Defined in: [mcp/types.ts:237](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **gaps?**: `string`[]
 
-Defined in: [mcp/types.ts:238](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L238)
+Defined in: [mcp/types.ts:239](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L239)
 
 **`Experimental`**
 
@@ -5052,7 +5052,7 @@ Defined in: [mcp/types.ts:238](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **notes?**: `string`
 
-Defined in: [mcp/types.ts:239](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L239)
+Defined in: [mcp/types.ts:240](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L240)
 
 **`Experimental`**
 
@@ -5060,7 +5060,7 @@ Defined in: [mcp/types.ts:239](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegationStatusResult
 
-Defined in: [mcp/types.ts:244](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L244)
+Defined in: [mcp/types.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L245)
 
 **`Experimental`**
 
@@ -5070,7 +5070,7 @@ Defined in: [mcp/types.ts:244](https://github.com/tangle-network/agent-runtime/b
 
 > **taskId**: `string`
 
-Defined in: [mcp/types.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L245)
+Defined in: [mcp/types.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L246)
 
 **`Experimental`**
 
@@ -5078,7 +5078,7 @@ Defined in: [mcp/types.ts:245](https://github.com/tangle-network/agent-runtime/b
 
 > **profile**: [`DelegationProfile`](#delegationprofile)
 
-Defined in: [mcp/types.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L246)
+Defined in: [mcp/types.ts:247](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L247)
 
 **`Experimental`**
 
@@ -5086,7 +5086,7 @@ Defined in: [mcp/types.ts:246](https://github.com/tangle-network/agent-runtime/b
 
 > **status**: [`DelegationStatus`](#delegationstatus)
 
-Defined in: [mcp/types.ts:247](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L247)
+Defined in: [mcp/types.ts:248](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L248)
 
 **`Experimental`**
 
@@ -5094,7 +5094,7 @@ Defined in: [mcp/types.ts:247](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **progress?**: [`DelegationProgress`](#delegationprogress)
 
-Defined in: [mcp/types.ts:248](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L248)
+Defined in: [mcp/types.ts:249](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L249)
 
 **`Experimental`**
 
@@ -5102,7 +5102,7 @@ Defined in: [mcp/types.ts:248](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **result?**: [`DelegationResultPayload`](#delegationresultpayload)
 
-Defined in: [mcp/types.ts:249](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L249)
+Defined in: [mcp/types.ts:250](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L250)
 
 **`Experimental`**
 
@@ -5110,7 +5110,7 @@ Defined in: [mcp/types.ts:249](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **error?**: [`DelegationError`](#delegationerror)
 
-Defined in: [mcp/types.ts:250](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L250)
+Defined in: [mcp/types.ts:251](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L251)
 
 **`Experimental`**
 
@@ -5118,7 +5118,7 @@ Defined in: [mcp/types.ts:250](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **costUsd?**: `number`
 
-Defined in: [mcp/types.ts:251](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L251)
+Defined in: [mcp/types.ts:252](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L252)
 
 **`Experimental`**
 
@@ -5126,7 +5126,7 @@ Defined in: [mcp/types.ts:251](https://github.com/tangle-network/agent-runtime/b
 
 > **startedAt**: `string`
 
-Defined in: [mcp/types.ts:252](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L252)
+Defined in: [mcp/types.ts:253](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L253)
 
 **`Experimental`**
 
@@ -5134,7 +5134,7 @@ Defined in: [mcp/types.ts:252](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **completedAt?**: `string`
 
-Defined in: [mcp/types.ts:253](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L253)
+Defined in: [mcp/types.ts:254](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L254)
 
 **`Experimental`**
 
@@ -5142,7 +5142,7 @@ Defined in: [mcp/types.ts:253](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **trace?**: [`DelegationTraceSpan`](#delegationtracespan)[]
 
-Defined in: [mcp/types.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L255)
+Defined in: [mcp/types.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L256)
 
 **`Experimental`**
 
@@ -5152,7 +5152,7 @@ Compact loop-trace span tree; present only when `includeTrace: true` was passed
 
 > `optional` **traceTruncated?**: `true`
 
-Defined in: [mcp/types.ts:257](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L257)
+Defined in: [mcp/types.ts:258](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L258)
 
 **`Experimental`**
 
@@ -5162,7 +5162,7 @@ Present when oldest trace spans were dropped to honor the trace caps.
 
 > `optional` **traceId?**: `string`
 
-Defined in: [mcp/types.ts:259](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L259)
+Defined in: [mcp/types.ts:260](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L260)
 
 **`Experimental`**
 
@@ -5172,7 +5172,7 @@ Inherited trace identity recorded at submit — join key into the caller's trace
 
 > `optional` **parentSpanId?**: `string`
 
-Defined in: [mcp/types.ts:261](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L261)
+Defined in: [mcp/types.ts:262](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L262)
 
 **`Experimental`**
 
@@ -5182,7 +5182,7 @@ Caller span that dispatched the delegation, when one was inherited.
 
 ### DelegationHistoryArgs
 
-Defined in: [mcp/types.ts:265](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L265)
+Defined in: [mcp/types.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L266)
 
 **`Experimental`**
 
@@ -5192,7 +5192,7 @@ Defined in: [mcp/types.ts:265](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/types.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L266)
+Defined in: [mcp/types.ts:267](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L267)
 
 **`Experimental`**
 
@@ -5200,7 +5200,7 @@ Defined in: [mcp/types.ts:266](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **profile?**: [`DelegationProfile`](#delegationprofile)
 
-Defined in: [mcp/types.ts:267](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L267)
+Defined in: [mcp/types.ts:268](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L268)
 
 **`Experimental`**
 
@@ -5208,7 +5208,7 @@ Defined in: [mcp/types.ts:267](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **since?**: `string`
 
-Defined in: [mcp/types.ts:269](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L269)
+Defined in: [mcp/types.ts:270](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L270)
 
 **`Experimental`**
 
@@ -5218,7 +5218,7 @@ ISO date — only delegations started at-or-after `since` are returned.
 
 > `optional` **limit?**: `number`
 
-Defined in: [mcp/types.ts:271](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L271)
+Defined in: [mcp/types.ts:272](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L272)
 
 **`Experimental`**
 
@@ -5228,7 +5228,7 @@ Default 50. Hard cap 500.
 
 ### DelegationFeedbackSnapshot
 
-Defined in: [mcp/types.ts:275](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L275)
+Defined in: [mcp/types.ts:276](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L276)
 
 **`Experimental`**
 
@@ -5238,7 +5238,7 @@ Defined in: [mcp/types.ts:275](https://github.com/tangle-network/agent-runtime/b
 
 > **id**: `string`
 
-Defined in: [mcp/types.ts:276](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L276)
+Defined in: [mcp/types.ts:277](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L277)
 
 **`Experimental`**
 
@@ -5246,7 +5246,7 @@ Defined in: [mcp/types.ts:276](https://github.com/tangle-network/agent-runtime/b
 
 > **score**: `number`
 
-Defined in: [mcp/types.ts:277](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L277)
+Defined in: [mcp/types.ts:278](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L278)
 
 **`Experimental`**
 
@@ -5254,7 +5254,7 @@ Defined in: [mcp/types.ts:277](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **label?**: `"good"` \| `"bad"` \| `"neutral"` \| `"mixed"`
 
-Defined in: [mcp/types.ts:278](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L278)
+Defined in: [mcp/types.ts:279](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L279)
 
 **`Experimental`**
 
@@ -5262,7 +5262,7 @@ Defined in: [mcp/types.ts:278](https://github.com/tangle-network/agent-runtime/b
 
 > **by**: `"agent"` \| `"user"` \| `"downstream-judge"`
 
-Defined in: [mcp/types.ts:279](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L279)
+Defined in: [mcp/types.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L280)
 
 **`Experimental`**
 
@@ -5270,7 +5270,7 @@ Defined in: [mcp/types.ts:279](https://github.com/tangle-network/agent-runtime/b
 
 > **notes**: `string`
 
-Defined in: [mcp/types.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L280)
+Defined in: [mcp/types.ts:281](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L281)
 
 **`Experimental`**
 
@@ -5278,7 +5278,7 @@ Defined in: [mcp/types.ts:280](https://github.com/tangle-network/agent-runtime/b
 
 > **capturedAt**: `string`
 
-Defined in: [mcp/types.ts:281](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L281)
+Defined in: [mcp/types.ts:282](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L282)
 
 **`Experimental`**
 
@@ -5286,7 +5286,7 @@ Defined in: [mcp/types.ts:281](https://github.com/tangle-network/agent-runtime/b
 
 ### DelegationHistoryEntry
 
-Defined in: [mcp/types.ts:285](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L285)
+Defined in: [mcp/types.ts:286](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L286)
 
 **`Experimental`**
 
@@ -5296,7 +5296,7 @@ Defined in: [mcp/types.ts:285](https://github.com/tangle-network/agent-runtime/b
 
 > **taskId**: `string`
 
-Defined in: [mcp/types.ts:286](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L286)
+Defined in: [mcp/types.ts:287](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L287)
 
 **`Experimental`**
 
@@ -5304,7 +5304,7 @@ Defined in: [mcp/types.ts:286](https://github.com/tangle-network/agent-runtime/b
 
 > **profile**: [`DelegationProfile`](#delegationprofile)
 
-Defined in: [mcp/types.ts:287](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L287)
+Defined in: [mcp/types.ts:288](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L288)
 
 **`Experimental`**
 
@@ -5312,7 +5312,7 @@ Defined in: [mcp/types.ts:287](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **namespace?**: `string`
 
-Defined in: [mcp/types.ts:288](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L288)
+Defined in: [mcp/types.ts:289](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L289)
 
 **`Experimental`**
 
@@ -5320,7 +5320,7 @@ Defined in: [mcp/types.ts:288](https://github.com/tangle-network/agent-runtime/b
 
 > **args**: [`DelegateCodeArgs`](#delegatecodeargs) \| [`DelegateUiAuditArgs`](#delegateuiauditargs) \| [`DelegateResearchArgs`](#delegateresearchargs)
 
-Defined in: [mcp/types.ts:289](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L289)
+Defined in: [mcp/types.ts:290](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L290)
 
 **`Experimental`**
 
@@ -5328,7 +5328,7 @@ Defined in: [mcp/types.ts:289](https://github.com/tangle-network/agent-runtime/b
 
 > **status**: [`DelegationStatus`](#delegationstatus)
 
-Defined in: [mcp/types.ts:290](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L290)
+Defined in: [mcp/types.ts:291](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L291)
 
 **`Experimental`**
 
@@ -5336,7 +5336,7 @@ Defined in: [mcp/types.ts:290](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **feedback?**: [`DelegationFeedbackSnapshot`](#delegationfeedbacksnapshot)[]
 
-Defined in: [mcp/types.ts:291](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L291)
+Defined in: [mcp/types.ts:292](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L292)
 
 **`Experimental`**
 
@@ -5344,7 +5344,7 @@ Defined in: [mcp/types.ts:291](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **costUsd?**: `number`
 
-Defined in: [mcp/types.ts:292](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L292)
+Defined in: [mcp/types.ts:293](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L293)
 
 **`Experimental`**
 
@@ -5352,7 +5352,7 @@ Defined in: [mcp/types.ts:292](https://github.com/tangle-network/agent-runtime/b
 
 > **startedAt**: `string`
 
-Defined in: [mcp/types.ts:293](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L293)
+Defined in: [mcp/types.ts:294](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L294)
 
 **`Experimental`**
 
@@ -5360,7 +5360,7 @@ Defined in: [mcp/types.ts:293](https://github.com/tangle-network/agent-runtime/b
 
 > `optional` **completedAt?**: `string`
 
-Defined in: [mcp/types.ts:294](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L294)
+Defined in: [mcp/types.ts:295](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L295)
 
 **`Experimental`**
 
@@ -5368,7 +5368,7 @@ Defined in: [mcp/types.ts:294](https://github.com/tangle-network/agent-runtime/b
 
 > **hasTrace**: `boolean`
 
-Defined in: [mcp/types.ts:300](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L300)
+Defined in: [mcp/types.ts:301](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L301)
 
 **`Experimental`**
 
@@ -5380,7 +5380,7 @@ light by design — fetch the spans via
 
 > `optional` **traceId?**: `string`
 
-Defined in: [mcp/types.ts:302](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L302)
+Defined in: [mcp/types.ts:303](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L303)
 
 **`Experimental`**
 
@@ -5390,7 +5390,7 @@ Inherited trace identity recorded at submit — join key into the caller's trace
 
 ### DelegationHistoryResult
 
-Defined in: [mcp/types.ts:306](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L306)
+Defined in: [mcp/types.ts:307](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L307)
 
 **`Experimental`**
 
@@ -5400,7 +5400,7 @@ Defined in: [mcp/types.ts:306](https://github.com/tangle-network/agent-runtime/b
 
 > **delegations**: [`DelegationHistoryEntry`](#delegationhistoryentry)[]
 
-Defined in: [mcp/types.ts:307](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L307)
+Defined in: [mcp/types.ts:308](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L308)
 
 **`Experimental`**
 
@@ -5408,7 +5408,7 @@ Defined in: [mcp/types.ts:307](https://github.com/tangle-network/agent-runtime/b
 
 ### WorktreeHandle
 
-Defined in: [mcp/worktree.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L21)
+Defined in: [mcp/worktree.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L22)
 
 **`Experimental`**
 
@@ -5418,7 +5418,7 @@ Defined in: [mcp/worktree.ts:21](https://github.com/tangle-network/agent-runtime
 
 > **path**: `string`
 
-Defined in: [mcp/worktree.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L23)
+Defined in: [mcp/worktree.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L24)
 
 **`Experimental`**
 
@@ -5428,7 +5428,7 @@ Absolute path to the worktree directory.
 
 > **baseSha**: `string`
 
-Defined in: [mcp/worktree.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L25)
+Defined in: [mcp/worktree.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L26)
 
 **`Experimental`**
 
@@ -5438,7 +5438,7 @@ SHA the worktree was created at.
 
 > **branch**: `string`
 
-Defined in: [mcp/worktree.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L27)
+Defined in: [mcp/worktree.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L28)
 
 **`Experimental`**
 
@@ -5448,7 +5448,7 @@ Branch name created for this worktree (typically `delegate/<runId>`).
 
 ### CreateWorktreeOptions
 
-Defined in: [mcp/worktree.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L31)
+Defined in: [mcp/worktree.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L32)
 
 **`Experimental`**
 
@@ -5458,7 +5458,7 @@ Defined in: [mcp/worktree.ts:31](https://github.com/tangle-network/agent-runtime
 
 > **repoRoot**: `string`
 
-Defined in: [mcp/worktree.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L33)
+Defined in: [mcp/worktree.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L34)
 
 **`Experimental`**
 
@@ -5468,7 +5468,7 @@ Absolute path to the main git checkout.
 
 > **runId**: `string`
 
-Defined in: [mcp/worktree.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L35)
+Defined in: [mcp/worktree.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L36)
 
 **`Experimental`**
 
@@ -5478,7 +5478,7 @@ Unique id for the worktree path + branch. Use the delegation run id.
 
 > `optional` **variantsDir?**: `string`
 
-Defined in: [mcp/worktree.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L37)
+Defined in: [mcp/worktree.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L38)
 
 **`Experimental`**
 
@@ -5488,7 +5488,7 @@ Parent directory the worktree lives under. Defaults to `.agent-worktrees`.
 
 > `optional` **baseRef?**: `string`
 
-Defined in: [mcp/worktree.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L39)
+Defined in: [mcp/worktree.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L40)
 
 **`Experimental`**
 
@@ -5498,7 +5498,7 @@ Override the base ref (default `HEAD`).
 
 > `optional` **runGit?**: [`GitRunner`](#gitrunner)
 
-Defined in: [mcp/worktree.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L41)
+Defined in: [mcp/worktree.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L42)
 
 **`Experimental`**
 
@@ -5508,7 +5508,7 @@ Test seam — inject a custom git runner.
 
 ### DiffOptions
 
-Defined in: [mcp/worktree.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L45)
+Defined in: [mcp/worktree.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L46)
 
 **`Experimental`**
 
@@ -5518,7 +5518,7 @@ Defined in: [mcp/worktree.ts:45](https://github.com/tangle-network/agent-runtime
 
 > **worktree**: [`WorktreeHandle`](#worktreehandle)
 
-Defined in: [mcp/worktree.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L47)
+Defined in: [mcp/worktree.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L48)
 
 **`Experimental`**
 
@@ -5528,7 +5528,7 @@ Worktree to diff.
 
 > `optional` **baseRef?**: `string`
 
-Defined in: [mcp/worktree.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L49)
+Defined in: [mcp/worktree.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L50)
 
 **`Experimental`**
 
@@ -5538,7 +5538,7 @@ What to compare against. Default `worktree.baseSha`.
 
 > `optional` **runGit?**: [`GitRunner`](#gitrunner)
 
-Defined in: [mcp/worktree.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L51)
+Defined in: [mcp/worktree.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L52)
 
 **`Experimental`**
 
@@ -5548,7 +5548,7 @@ Test seam.
 
 ### DiffResult
 
-Defined in: [mcp/worktree.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L55)
+Defined in: [mcp/worktree.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L56)
 
 **`Experimental`**
 
@@ -5558,7 +5558,7 @@ Defined in: [mcp/worktree.ts:55](https://github.com/tangle-network/agent-runtime
 
 > **patch**: `string`
 
-Defined in: [mcp/worktree.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L56)
+Defined in: [mcp/worktree.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L57)
 
 **`Experimental`**
 
@@ -5566,7 +5566,7 @@ Defined in: [mcp/worktree.ts:56](https://github.com/tangle-network/agent-runtime
 
 > **stats**: `object`
 
-Defined in: [mcp/worktree.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L57)
+Defined in: [mcp/worktree.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L58)
 
 **`Experimental`**
 
@@ -5586,7 +5586,7 @@ Defined in: [mcp/worktree.ts:57](https://github.com/tangle-network/agent-runtime
 
 ### RemoveWorktreeOptions
 
-Defined in: [mcp/worktree.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L65)
+Defined in: [mcp/worktree.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L66)
 
 **`Experimental`**
 
@@ -5596,7 +5596,7 @@ Defined in: [mcp/worktree.ts:65](https://github.com/tangle-network/agent-runtime
 
 > **worktree**: [`WorktreeHandle`](#worktreehandle)
 
-Defined in: [mcp/worktree.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L66)
+Defined in: [mcp/worktree.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L67)
 
 **`Experimental`**
 
@@ -5604,7 +5604,7 @@ Defined in: [mcp/worktree.ts:66](https://github.com/tangle-network/agent-runtime
 
 > **repoRoot**: `string`
 
-Defined in: [mcp/worktree.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L67)
+Defined in: [mcp/worktree.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L68)
 
 **`Experimental`**
 
@@ -5612,7 +5612,7 @@ Defined in: [mcp/worktree.ts:67](https://github.com/tangle-network/agent-runtime
 
 > `optional` **force?**: `boolean`
 
-Defined in: [mcp/worktree.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L69)
+Defined in: [mcp/worktree.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L70)
 
 **`Experimental`**
 
@@ -5622,7 +5622,7 @@ Force removal even if dirty (default true; the loser of a fanout has uncommitted
 
 > `optional` **runGit?**: [`GitRunner`](#gitrunner)
 
-Defined in: [mcp/worktree.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L71)
+Defined in: [mcp/worktree.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L72)
 
 **`Experimental`**
 
@@ -5634,7 +5634,7 @@ Test seam.
 
 > **CoderDelegate** = (`args`, `ctx`) => `Promise`\<`CoderOutput`\>
 
-Defined in: [mcp/delegates.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L80)
+Defined in: [mcp/delegates.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L81)
 
 **`Experimental`**
 
@@ -5662,7 +5662,7 @@ The coder delegate closure — given the coder args + run context, drives the
 
 > **UiAuditorDelegate** = (`args`, `ctx`) => `Promise`\<[`UiAuditorDelegationOutput`](#uiauditordelegationoutput)\>
 
-Defined in: [mcp/delegates.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L91)
+Defined in: [mcp/delegates.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L92)
 
 **`Experimental`**
 
@@ -5692,7 +5692,7 @@ model seam. See `createInProcessUiAuditClient` + `uiAuditorProfile` in
 
 > **CoderReviewer** = (`output`, `task`, `ctx`) => `Promise`\<[`CoderReview`](#coderreview)\> \| [`CoderReview`](#coderreview)
 
-Defined in: [mcp/delegates.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L116)
+Defined in: [mcp/delegates.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L118)
 
 **`Experimental`**
 
@@ -5728,7 +5728,7 @@ judge, a `pnpm review` command, anything returning a `CoderReview`.
 
 > **DetachedWinnerSelection** = `"highest-score"` \| `"smallest-diff"` \| `"highest-readiness"` \| `"first-approved"`
 
-Defined in: [mcp/delegates.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L129)
+Defined in: [mcp/delegates.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L131)
 
 **`Experimental`**
 
@@ -5744,7 +5744,7 @@ reviewer-only strategy this path keeps that the generic selector does not expres
 
 > **DriveTurnTick** = \{ `state`: `"completed"`; `text`: `string`; `result`: `Record`\<`string`, `unknown`\>; \} \| \{ `state`: `"running"`; `startedAt?`: `Date`; `elapsedMs?`: `number`; \} \| \{ `state`: `"failed"`; `error`: `string`; \}
 
-Defined in: [mcp/detached-turn.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L53)
+Defined in: [mcp/detached-turn.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L54)
 
 **`Experimental`**
 
@@ -5758,7 +5758,7 @@ SDK contract — re-invoking with the same ids returns the same outcome.
 
 > **LocalHarness** = `"claude"` \| `"codex"` \| `"opencode"`
 
-Defined in: [mcp/local-harness.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L23)
+Defined in: [mcp/local-harness.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L24)
 
 Local coding harness available inside the sandbox.
 
@@ -5768,7 +5768,7 @@ Local coding harness available inside the sandbox.
 
 > **DelegationResumeTick** = \{ `state`: `"running"`; \} \| \{ `state`: `"completed"`; `output`: [`DelegationResultPayload`](#delegationresultpayload)\[`"output"`\]; `costUsd?`: `number`; \} \| \{ `state`: `"failed"`; `error`: [`DelegationError`](#delegationerror); \}
 
-Defined in: [mcp/task-queue.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L171)
+Defined in: [mcp/task-queue.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L172)
 
 **`Experimental`**
 
@@ -5783,7 +5783,7 @@ after `intervalMs`; `completed` / `failed` settle the record.
 
 > **QuestionDecision** = \{ `kind`: `"answer"`; `answer`: `string`; `by`: `string`; \} \| \{ `kind`: `"defer"`; `reason`: `string`; \} \| \{ `kind`: `"escalate"`; `to`: `"parent"` \| `"user"` \| `string`; `reason`: `string`; \}
 
-Defined in: [mcp/tools/coordination.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L48)
+Defined in: [mcp/tools/coordination.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L49)
 
 ***
 
@@ -5791,7 +5791,7 @@ Defined in: [mcp/tools/coordination.ts:48](https://github.com/tangle-network/age
 
 > **QuestionPolicy** = `"auto"` \| `"mustDecide"` \| `"bubble"` \| `"failClosed"`
 
-Defined in: [mcp/tools/coordination.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L60)
+Defined in: [mcp/tools/coordination.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L61)
 
 ***
 
@@ -5799,7 +5799,7 @@ Defined in: [mcp/tools/coordination.ts:60](https://github.com/tangle-network/age
 
 > **DelegateResult** = \{ `status`: `"winner"`; `out`: `unknown`; `outRef`: `string`; `spentTotal`: [`Spend`](runtime.md#spend); \} \| \{ `status`: `"no-winner"`; `reason`: `string`; `spentTotal`: [`Spend`](runtime.md#spend); \}
 
-Defined in: [mcp/tools/delegate.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L97)
+Defined in: [mcp/tools/delegate.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L98)
 
 The synchronous result the `delegate` tool returns to the calling agent: the delivered output (or
  the no-winner reason) PLUS the conserved spend of the whole delegation.
@@ -5810,7 +5810,7 @@ The synchronous result the `delegate` tool returns to the calling agent: the del
 
 > **DelegationProfile** = `"coder"` \| `"researcher"` \| `"ui-auditor"`
 
-Defined in: [mcp/types.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L21)
+Defined in: [mcp/types.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L22)
 
 **`Experimental`**
 
@@ -5820,7 +5820,7 @@ Defined in: [mcp/types.ts:21](https://github.com/tangle-network/agent-runtime/bl
 
 > **DelegationStatus** = `"pending"` \| `"running"` \| `"completed"` \| `"failed"` \| `"cancelled"`
 
-Defined in: [mcp/types.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L24)
+Defined in: [mcp/types.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L25)
 
 **`Experimental`**
 
@@ -5830,7 +5830,7 @@ Defined in: [mcp/types.ts:24](https://github.com/tangle-network/agent-runtime/bl
 
 > **ResearchSource** = `"web"` \| `"corpus"` \| `"twitter"` \| `"github"` \| `"docs"`
 
-Defined in: [mcp/types.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L69)
+Defined in: [mcp/types.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L70)
 
 **`Experimental`**
 
@@ -5840,7 +5840,7 @@ Defined in: [mcp/types.ts:69](https://github.com/tangle-network/agent-runtime/bl
 
 > **DelegationResultPayload** = \{ `profile`: `"coder"`; `output`: `CoderOutput`; \} \| \{ `profile`: `"researcher"`; `output`: [`ResearchOutputShape`](#researchoutputshape); \} \| \{ `profile`: `"ui-auditor"`; `output`: [`UiAuditorDelegationOutput`](#uiauditordelegationoutput); \}
 
-Defined in: [mcp/types.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L156)
+Defined in: [mcp/types.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/types.ts#L157)
 
 **`Experimental`**
 
@@ -5854,7 +5854,7 @@ The MCP wire carries it as JSON either way.
 
 > **GitRunner** = (`args`, `opts`) => `object`
 
-Defined in: [mcp/worktree.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L75)
+Defined in: [mcp/worktree.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L76)
 
 Pluggable git runner (sync) — replaceable in tests.
 
@@ -5892,7 +5892,7 @@ Pluggable git runner (sync) — replaceable in tests.
 
 > `const` **DELEGATION\_TRACE\_MAX\_SPANS**: `512` = `512`
 
-Defined in: [mcp/delegation-trace.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L45)
+Defined in: [mcp/delegation-trace.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L46)
 
 **`Experimental`**
 
@@ -5904,7 +5904,7 @@ Default cap on spans retained per delegation record.
 
 > `const` **DELEGATION\_TRACE\_MAX\_BYTES**: `number`
 
-Defined in: [mcp/delegation-trace.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L48)
+Defined in: [mcp/delegation-trace.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L49)
 
 **`Experimental`**
 
@@ -5916,7 +5916,7 @@ Default cap on the serialized trace payload per record, in bytes.
 
 > `const` **defaultChecks**: `Record`\<`string`, [`Check`](#check)\>
 
-Defined in: [mcp/tools/checks.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L93)
+Defined in: [mcp/tools/checks.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L94)
 
 The built-in lens directory. Domain-blind (about any agent trace); compose at test time.
 
@@ -5926,7 +5926,7 @@ The built-in lens directory. Domain-blind (about any agent trace); compose at te
 
 > `const` **DELEGATE\_FEEDBACK\_TOOL\_NAME**: `"delegate_feedback"` = `'delegate_feedback'`
 
-Defined in: [mcp/tools/delegate-feedback.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L24)
+Defined in: [mcp/tools/delegate-feedback.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L25)
 
 **`Experimental`**
 
@@ -5936,7 +5936,7 @@ Defined in: [mcp/tools/delegate-feedback.ts:24](https://github.com/tangle-networ
 
 > `const` **DELEGATE\_FEEDBACK\_DESCRIPTION**: `string`
 
-Defined in: [mcp/tools/delegate-feedback.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L27)
+Defined in: [mcp/tools/delegate-feedback.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L28)
 
 **`Experimental`**
 
@@ -5946,7 +5946,7 @@ Defined in: [mcp/tools/delegate-feedback.ts:27](https://github.com/tangle-networ
 
 > `const` **DELEGATE\_FEEDBACK\_INPUT\_SCHEMA**: `object`
 
-Defined in: [mcp/tools/delegate-feedback.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L51)
+Defined in: [mcp/tools/delegate-feedback.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L52)
 
 **`Experimental`**
 
@@ -6098,7 +6098,7 @@ Defined in: [mcp/tools/delegate-feedback.ts:51](https://github.com/tangle-networ
 
 > `const` **DELEGATE\_UI\_AUDIT\_TOOL\_NAME**: `"delegate_ui_audit"` = `'delegate_ui_audit'`
 
-Defined in: [mcp/tools/delegate-ui-audit.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L29)
+Defined in: [mcp/tools/delegate-ui-audit.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L30)
 
 **`Experimental`**
 
@@ -6108,7 +6108,7 @@ Defined in: [mcp/tools/delegate-ui-audit.ts:29](https://github.com/tangle-networ
 
 > `const` **DELEGATE\_UI\_AUDIT\_DESCRIPTION**: `string`
 
-Defined in: [mcp/tools/delegate-ui-audit.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L32)
+Defined in: [mcp/tools/delegate-ui-audit.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L33)
 
 **`Experimental`**
 
@@ -6118,7 +6118,7 @@ Defined in: [mcp/tools/delegate-ui-audit.ts:32](https://github.com/tangle-networ
 
 > `const` **DELEGATE\_UI\_AUDIT\_INPUT\_SCHEMA**: `object`
 
-Defined in: [mcp/tools/delegate-ui-audit.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L85)
+Defined in: [mcp/tools/delegate-ui-audit.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L86)
 
 **`Experimental`**
 
@@ -6374,7 +6374,7 @@ Defined in: [mcp/tools/delegate-ui-audit.ts:85](https://github.com/tangle-networ
 
 > `const` **DELEGATE\_TOOL\_NAME**: `"delegate"` = `'delegate'`
 
-Defined in: [mcp/tools/delegate.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L25)
+Defined in: [mcp/tools/delegate.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L26)
 
 **`Experimental`**
 
@@ -6384,7 +6384,7 @@ Defined in: [mcp/tools/delegate.ts:25](https://github.com/tangle-network/agent-r
 
 > `const` **DELEGATE\_DESCRIPTION**: `string`
 
-Defined in: [mcp/tools/delegate.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L28)
+Defined in: [mcp/tools/delegate.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L29)
 
 **`Experimental`**
 
@@ -6394,7 +6394,7 @@ Defined in: [mcp/tools/delegate.ts:28](https://github.com/tangle-network/agent-r
 
 > `const` **DELEGATE\_INPUT\_SCHEMA**: `object`
 
-Defined in: [mcp/tools/delegate.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L46)
+Defined in: [mcp/tools/delegate.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L47)
 
 **`Experimental`**
 
@@ -6458,7 +6458,7 @@ Defined in: [mcp/tools/delegate.ts:46](https://github.com/tangle-network/agent-r
 
 > `const` **DELEGATION\_HISTORY\_TOOL\_NAME**: `"delegation_history"` = `'delegation_history'`
 
-Defined in: [mcp/tools/delegation-history.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L17)
+Defined in: [mcp/tools/delegation-history.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L18)
 
 **`Experimental`**
 
@@ -6468,7 +6468,7 @@ Defined in: [mcp/tools/delegation-history.ts:17](https://github.com/tangle-netwo
 
 > `const` **DELEGATION\_HISTORY\_DESCRIPTION**: `string`
 
-Defined in: [mcp/tools/delegation-history.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L20)
+Defined in: [mcp/tools/delegation-history.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L21)
 
 **`Experimental`**
 
@@ -6478,7 +6478,7 @@ Defined in: [mcp/tools/delegation-history.ts:20](https://github.com/tangle-netwo
 
 > `const` **DELEGATION\_HISTORY\_INPUT\_SCHEMA**: `object`
 
-Defined in: [mcp/tools/delegation-history.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L41)
+Defined in: [mcp/tools/delegation-history.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L42)
 
 **`Experimental`**
 
@@ -6550,7 +6550,7 @@ Defined in: [mcp/tools/delegation-history.ts:41](https://github.com/tangle-netwo
 
 > `const` **DELEGATION\_STATUS\_TOOL\_NAME**: `"delegation_status"` = `'delegation_status'`
 
-Defined in: [mcp/tools/delegation-status.ts:16](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L16)
+Defined in: [mcp/tools/delegation-status.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L17)
 
 **`Experimental`**
 
@@ -6560,7 +6560,7 @@ Defined in: [mcp/tools/delegation-status.ts:16](https://github.com/tangle-networ
 
 > `const` **DELEGATION\_STATUS\_DESCRIPTION**: `string`
 
-Defined in: [mcp/tools/delegation-status.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L19)
+Defined in: [mcp/tools/delegation-status.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L20)
 
 **`Experimental`**
 
@@ -6570,7 +6570,7 @@ Defined in: [mcp/tools/delegation-status.ts:19](https://github.com/tangle-networ
 
 > `const` **DELEGATION\_STATUS\_INPUT\_SCHEMA**: `object`
 
-Defined in: [mcp/tools/delegation-status.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L41)
+Defined in: [mcp/tools/delegation-status.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L42)
 
 **`Experimental`**
 
@@ -6622,7 +6622,7 @@ Defined in: [mcp/tools/delegation-status.ts:41](https://github.com/tangle-networ
 
 > **detectExecutor**(`args`): `Promise`\<[`DelegationExecutor`](#delegationexecutor)\>
 
-Defined in: [mcp/bin-helpers.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L46)
+Defined in: [mcp/bin-helpers.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/bin-helpers.ts#L47)
 
 **`Experimental`**
 
@@ -6653,7 +6653,7 @@ sibling mode would lie about workspace topology.
 
 > **detachedSessionDelegate**(`options`): [`CoderDelegate`](#coderdelegate)
 
-Defined in: [mcp/delegates.ts:217](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L217)
+Defined in: [mcp/delegates.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L219)
 
 **`Experimental`**
 
@@ -6687,7 +6687,7 @@ behind `MCP_ENABLE_DETACHED_RESUME`.
 
 > **coderTaskFromArgs**(`args`): [`CoderTask`](profiles.md#codertask)
 
-Defined in: [mcp/delegates.ts:426](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L426)
+Defined in: [mcp/delegates.ts:428](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L428)
 
 **`Experimental`**
 
@@ -6712,7 +6712,7 @@ process dispatched.
 
 > **settleDetachedCoderTurn**(`turn`, `options`): `Promise`\<`CoderOutput`\>
 
-Defined in: [mcp/delegates.ts:464](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L464)
+Defined in: [mcp/delegates.ts:466](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegates.ts#L466)
 
 **`Experimental`**
 
@@ -6748,7 +6748,7 @@ advertised on the generic `worktreeFanout` path. This helper (with `coderTaskFro
 
 > **buildDelegationTraceSpans**(`events`): [`DelegationTraceSpan`](#delegationtracespan)[]
 
-Defined in: [mcp/delegation-trace.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L73)
+Defined in: [mcp/delegation-trace.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L74)
 
 **`Experimental`**
 
@@ -6772,7 +6772,7 @@ readonly [`LoopTraceEvent`](runtime.md#looptraceevent)[]
 
 > **capDelegationTrace**(`spans`, `caps?`): [`CappedDelegationTrace`](#cappeddelegationtrace)
 
-Defined in: [mcp/delegation-trace.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L97)
+Defined in: [mcp/delegation-trace.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L98)
 
 **`Experimental`**
 
@@ -6803,7 +6803,7 @@ readonly [`DelegationTraceSpan`](#delegationtracespan)[]
 
 > **createDelegationTraceCollector**(`onSpans`): [`DelegationTraceCollector`](#delegationtracecollector)
 
-Defined in: [mcp/delegation-trace.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L130)
+Defined in: [mcp/delegation-trace.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L131)
 
 **`Experimental`**
 
@@ -6823,7 +6823,7 @@ Defined in: [mcp/delegation-trace.ts:130](https://github.com/tangle-network/agen
 
 > **composeLoopTraceEmitters**(...`emitters`): [`LoopTraceEmitter`](runtime.md#looptraceemitter) \| `undefined`
 
-Defined in: [mcp/delegation-trace.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L184)
+Defined in: [mcp/delegation-trace.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/delegation-trace.ts#L185)
 
 **`Experimental`**
 
@@ -6848,7 +6848,7 @@ so callers keep the kernel's "no emitter, no events" fast path.
 
 > **formatDetachedSessionRef**(`parts`): `string`
 
-Defined in: [mcp/detached-turn.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L95)
+Defined in: [mcp/detached-turn.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L96)
 
 **`Experimental`**
 
@@ -6872,7 +6872,7 @@ bound. Ids must not contain the `;`/`=` delimiters.
 
 > **parseDetachedSessionRef**(`raw`): [`DetachedSessionRefParts`](#detachedsessionrefparts)
 
-Defined in: [mcp/detached-turn.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L103)
+Defined in: [mcp/detached-turn.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L104)
 
 **`Experimental`**
 
@@ -6894,7 +6894,7 @@ Inverse of [formatDetachedSessionRef](#formatdetachedsessionref); throws `Valida
 
 > **detachedTurnEvents**(`sessionId`, `turn`): `SandboxEvent`[]
 
-Defined in: [mcp/detached-turn.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L150)
+Defined in: [mcp/detached-turn.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L151)
 
 **`Experimental`**
 
@@ -6923,7 +6923,7 @@ for adapters that scan assistant text for the fenced result block.
 
 > **runDetachedTurn**(`options`): `Promise`\<[`DetachedTurn`](#detachedturn)\>
 
-Defined in: [mcp/detached-turn.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L211)
+Defined in: [mcp/detached-turn.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L212)
 
 **`Experimental`**
 
@@ -6950,7 +6950,7 @@ teardown, which is exactly the case the resume driver re-attaches to.
 
 > **createDetachedTurnResumeDriver**(`options`): [`DelegationResumeDriver`](#delegationresumedriver)
 
-Defined in: [mcp/detached-turn.ts:415](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L415)
+Defined in: [mcp/detached-turn.ts:416](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/detached-turn.ts#L416)
 
 **`Experimental`**
 
@@ -6987,7 +6987,7 @@ fleet machine, and destroying a fleet machine would be unrecoverable.
 
 > **createSiblingSandboxExecutor**(`options`): [`DelegationExecutor`](#delegationexecutor)
 
-Defined in: [mcp/executor.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L54)
+Defined in: [mcp/executor.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L55)
 
 **`Experimental`**
 
@@ -7013,7 +7013,7 @@ only added behavior is a `describePlacement` tag the kernel reads.
 
 > **createFleetWorkspaceExecutor**(`options`): [`DelegationExecutor`](#delegationexecutor)
 
-Defined in: [mcp/executor.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L116)
+Defined in: [mcp/executor.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/executor.ts#L117)
 
 **`Experimental`**
 
@@ -7038,7 +7038,7 @@ cross-sandbox copy step.
 
 > **eventToSnapshot**(`event`): [`DelegationFeedbackSnapshot`](#delegationfeedbacksnapshot)
 
-Defined in: [mcp/feedback-store.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L66)
+Defined in: [mcp/feedback-store.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/feedback-store.ts#L67)
 
 **`Experimental`**
 
@@ -7061,7 +7061,7 @@ Project a `FeedbackEvent` down to the snapshot shape carried on
 
 > **createInProcessExecutor**(`options`): [`DelegationExecutor`](#delegationexecutor)
 
-Defined in: [mcp/in-process-executor.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L87)
+Defined in: [mcp/in-process-executor.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/in-process-executor.ts#L88)
 
 **`Experimental`**
 
@@ -7087,7 +7087,7 @@ raw `WorktreeHarnessResult` (the content-addressed patch artifact). The authored
 
 > **createKbGate**(`options?`): (`candidate`) => `Promise`\<[`KbGateResult`](#kbgateresult)\>
 
-Defined in: [mcp/kb-gate.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L137)
+Defined in: [mcp/kb-gate.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/kb-gate.ts#L139)
 
 **`Experimental`**
 
@@ -7111,7 +7111,7 @@ then any consumer judges, returning on the first veto.
 
 > **runLocalHarness**(`options`): `Promise`\<[`LocalHarnessResult`](#localharnessresult)\>
 
-Defined in: [mcp/local-harness.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L179)
+Defined in: [mcp/local-harness.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/local-harness.ts#L180)
 
 **`Experimental`**
 
@@ -7147,10 +7147,12 @@ Does NOT throw when:
 
 > **createMcpServer**(`options?`): [`McpServer`](#mcpserver)
 
-Defined in: [mcp/server.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L150)
+Defined in: [mcp/server.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L155)
 
 **`Experimental`**
 
+Stdio JSON-RPC MCP server exposing the delegation tools (`delegate`, `delegate_feedback`, `delegation_status`, `delegation_history`, optional `delegate_ui_audit`) to sandbox coding-harness agents.
+
 #### Parameters
 
 ##### options?
@@ -7167,7 +7169,7 @@ Defined in: [mcp/server.ts:150](https://github.com/tangle-network/agent-runtime/
 
 > **createInProcessTransport**(): `object`
 
-Defined in: [mcp/server.ts:334](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L334)
+Defined in: [mcp/server.ts:339](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/server.ts#L339)
 
 **`Experimental`**
 
@@ -7219,7 +7221,7 @@ client writes to it) and the server-side stream (the test reads from it).
 
 > **hashIdempotencyInput**(`value`): `string`
 
-Defined in: [mcp/task-queue.ts:805](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L805)
+Defined in: [mcp/task-queue.ts:806](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/task-queue.ts#L806)
 
 **`Experimental`**
 
@@ -7242,7 +7244,7 @@ collisions only affect dedupe, never correctness.
 
 > **liftFindings**(`kind`, `rows`, `producedAt`): `AnalystFinding`[]
 
-Defined in: [mcp/tools/checks.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L143)
+Defined in: [mcp/tools/checks.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L144)
 
 Lift validated raw rows into `AnalystFinding`s (agent-eval `makeFinding` stamps `finding_id`/
  `produced_at`), then enforce the trace-derived firewall (selector ≠ judge). Pure — no LLM.
@@ -7271,7 +7273,7 @@ Lift validated raw rows into `AnalystFinding`s (agent-eval `makeFinding` stamps
 
 > **renderTrace**(`trace`): `string`
 
-Defined in: [mcp/tools/checks.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L183)
+Defined in: [mcp/tools/checks.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L184)
 
 Render a worker's trace (tool calls + results) into the text an analyst lens reads. Generic over
  the trace shape: a `{ messages }` conversation, a bare message array, else stringified.
@@ -7292,7 +7294,7 @@ Render a worker's trace (tool calls + results) into the text an analyst lens rea
 
 > **runCheck**(`kind`, `trace`, `opts`, `producedAt`): `Promise`\<`AnalystFinding`[]\>
 
-Defined in: [mcp/tools/checks.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L219)
+Defined in: [mcp/tools/checks.ts:220](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L220)
 
 Run ONE lens over a trace → findings. Generic over any kind: prompt = the lens + the agent-eval
  finding schema; the model's JSON array is parsed (`parseRawFinding`), lifted, and firewalled.
@@ -7325,7 +7327,7 @@ Run ONE lens over a trace → findings. Generic over any kind: prompt = the lens
 
 > **makeCheckRunner**(`kinds`, `opts`): (`kindId`, `trace`, `producedAt`) => `Promise`\<`AnalystFinding`[] \| \{ `error`: `string`; \}\>
 
-Defined in: [mcp/tools/checks.ts:271](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L271)
+Defined in: [mcp/tools/checks.ts:272](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/checks.ts#L272)
 
 Build a `run_analyst` runner over a kind directory.
 Returns findings, or a typed error for an unknown kind. `producedAt` is
@@ -7351,7 +7353,7 @@ passed in because replay-safe paths must not read `Date.now`.
 
 > **createCoordinationTools**(`opts`): [`CoordinationTools`](#coordinationtools)
 
-Defined in: [mcp/tools/coordination.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L169)
+Defined in: [mcp/tools/coordination.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L170)
 
 Build the driver's MCP tools over a live scope.
 
@@ -7371,7 +7373,7 @@ Build the driver's MCP tools over a live scope.
 
 > **validateDelegateFeedbackArgs**(`raw`): [`DelegateFeedbackArgs`](#delegatefeedbackargs)
 
-Defined in: [mcp/tools/delegate-feedback.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L82)
+Defined in: [mcp/tools/delegate-feedback.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L83)
 
 **`Experimental`**
 
@@ -7391,7 +7393,7 @@ Defined in: [mcp/tools/delegate-feedback.ts:82](https://github.com/tangle-networ
 
 > **createDelegateFeedbackHandler**(`options`): (`raw`) => `Promise`\<[`DelegateFeedbackResult`](#delegatefeedbackresult)\>
 
-Defined in: [mcp/tools/delegate-feedback.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L159)
+Defined in: [mcp/tools/delegate-feedback.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-feedback.ts#L160)
 
 **`Experimental`**
 
@@ -7411,7 +7413,7 @@ Defined in: [mcp/tools/delegate-feedback.ts:159](https://github.com/tangle-netwo
 
 > **validateDelegateUiAuditArgs**(`raw`): [`DelegateUiAuditArgs`](#delegateuiauditargs)
 
-Defined in: [mcp/tools/delegate-ui-audit.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L113)
+Defined in: [mcp/tools/delegate-ui-audit.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L114)
 
 **`Experimental`**
 
@@ -7431,7 +7433,7 @@ Defined in: [mcp/tools/delegate-ui-audit.ts:113](https://github.com/tangle-netwo
 
 > **createDelegateUiAuditHandler**(`options`): (`raw`) => `Promise`\<[`DelegateUiAuditResult`](#delegateuiauditresult)\>
 
-Defined in: [mcp/tools/delegate-ui-audit.ts:299](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L299)
+Defined in: [mcp/tools/delegate-ui-audit.ts:300](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate-ui-audit.ts#L300)
 
 **`Experimental`**
 
@@ -7451,7 +7453,7 @@ Defined in: [mcp/tools/delegate-ui-audit.ts:299](https://github.com/tangle-netwo
 
 > **validateDelegateArgs**(`raw`): [`DelegateArgs`](#delegateargs)
 
-Defined in: [mcp/tools/delegate.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L74)
+Defined in: [mcp/tools/delegate.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L75)
 
 **`Experimental`**
 
@@ -7471,7 +7473,7 @@ Defined in: [mcp/tools/delegate.ts:74](https://github.com/tangle-network/agent-r
 
 > **createDelegateHandler**(`options`): (`raw`) => `Promise`\<[`DelegateResult`](#delegateresult)\>
 
-Defined in: [mcp/tools/delegate.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L135)
+Defined in: [mcp/tools/delegate.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegate.ts#L136)
 
 Build the `delegate` tool handler. Closes over the injected supervisor substrate (`router` /
 `backend` / `deliverable`); each call routes the agent's intent to `delegate()` and returns the
@@ -7493,7 +7495,7 @@ delivered output with its conserved cost.
 
 > **validateDelegationHistoryArgs**(`raw`): [`DelegationHistoryArgs`](#delegationhistoryargs)
 
-Defined in: [mcp/tools/delegation-history.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L53)
+Defined in: [mcp/tools/delegation-history.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L54)
 
 **`Experimental`**
 
@@ -7513,7 +7515,7 @@ Defined in: [mcp/tools/delegation-history.ts:53](https://github.com/tangle-netwo
 
 > **createDelegationHistoryHandler**(`options`): (`raw`) => `Promise`\<[`DelegationHistoryResult`](#delegationhistoryresult)\>
 
-Defined in: [mcp/tools/delegation-history.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L94)
+Defined in: [mcp/tools/delegation-history.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-history.ts#L95)
 
 **`Experimental`**
 
@@ -7533,7 +7535,7 @@ Defined in: [mcp/tools/delegation-history.ts:94](https://github.com/tangle-netwo
 
 > **validateDelegationStatusArgs**(`raw`): [`DelegationStatusArgs`](#delegationstatusargs)
 
-Defined in: [mcp/tools/delegation-status.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L56)
+Defined in: [mcp/tools/delegation-status.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L57)
 
 **`Experimental`**
 
@@ -7553,7 +7555,7 @@ Defined in: [mcp/tools/delegation-status.ts:56](https://github.com/tangle-networ
 
 > **createDelegationStatusHandler**(`options`): (`raw`) => `Promise`\<[`DelegationStatusResult`](#delegationstatusresult)\>
 
-Defined in: [mcp/tools/delegation-status.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L81)
+Defined in: [mcp/tools/delegation-status.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/delegation-status.ts#L82)
 
 **`Experimental`**
 
@@ -7573,7 +7575,7 @@ Defined in: [mcp/tools/delegation-status.ts:81](https://github.com/tangle-networ
 
 > **readTraceContextFromEnv**(): [`TraceContext`](#tracecontext-2)
 
-Defined in: [mcp/trace-propagation.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L35)
+Defined in: [mcp/trace-propagation.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L36)
 
 Read trace context from the process environment.
 Returns a context with inherited ids or a freshly generated root.
@@ -7588,7 +7590,7 @@ Returns a context with inherited ids or a freshly generated root.
 
 > **createPropagatingTraceEmitter**(`ctx`): `object`
 
-Defined in: [mcp/trace-propagation.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L48)
+Defined in: [mcp/trace-propagation.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L49)
 
 Create a LoopTraceEmitter that:
   1. Parents all spans under the inherited PARENT_SPAN_ID.
@@ -7624,7 +7626,7 @@ Returns both the emitter and the optional exporter handle for shutdown.
 
 > **traceContextToEnv**(`ctx`): `Record`\<`string`, `string`\>
 
-Defined in: [mcp/trace-propagation.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L85)
+Defined in: [mcp/trace-propagation.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/trace-propagation.ts#L86)
 
 Build env vars to pass to a child MCP subprocess so it inherits the
 current trace context.
@@ -7645,7 +7647,7 @@ current trace context.
 
 > **createWorktree**(`options`): `Promise`\<[`WorktreeHandle`](#worktreehandle)\>
 
-Defined in: [mcp/worktree.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L113)
+Defined in: [mcp/worktree.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L114)
 
 **`Experimental`**
 
@@ -7665,7 +7667,7 @@ Defined in: [mcp/worktree.ts:113](https://github.com/tangle-network/agent-runtim
 
 > **captureWorktreeDiff**(`options`): `Promise`\<[`DiffResult`](#diffresult)\>
 
-Defined in: [mcp/worktree.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L133)
+Defined in: [mcp/worktree.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L134)
 
 **`Experimental`**
 
@@ -7685,7 +7687,7 @@ Defined in: [mcp/worktree.ts:133](https://github.com/tangle-network/agent-runtim
 
 > **removeWorktree**(`options`): `Promise`\<`void`\>
 
-Defined in: [mcp/worktree.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L173)
+Defined in: [mcp/worktree.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree.ts#L174)
 
 **`Experimental`**
 
diff --git a/docs/api/primitive-catalog.md b/docs/api/primitive-catalog.md
index 156b5a22..15ff31bb 100644
--- a/docs/api/primitive-catalog.md
+++ b/docs/api/primitive-catalog.md
@@ -19,9 +19,9 @@ Import from `@tangle-network/agent-runtime` — 208 exports.
 
 | Symbol | Kind | Summary |
 |---|---|---|
-| `agenticGenerator` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `agenticGenerator` | function | Full-agentic `CandidateGenerator` (the `shots=N, sandbox=on` setting): run a real coding harness inside the candidate worktree so the agent makes the change in place. |
 | `applyRunRecordDefaults` | function | Stamp cross-cutting defaults onto adapter-projected RunRecords without |
-| `auditLoopRunner` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `auditLoopRunner` | function | `audit` mode — analyst loop over captured trace/run data. |
 | `buildForwardHeaders` | function | Build the headers to emit on an outbound participant call, given the |
 | `buildLoopOtelSpans` | function | Build a nested, real-duration OTLP span tree for ONE loop run from its full |
 | `buildLoopSpanNodes` | function | Sink-neutral core behind {@link buildLoopOtelSpans}: reconstruct the |
@@ -29,46 +29,46 @@ Import from `@tangle-network/agent-runtime` — 208 exports.
 | `commandVerifier` | function | A `Verifier` that runs a command in the worktree: exit 0 ⇒ ok, any other |
 | `composeRuntimeHooks` | function | Merge several {@link RuntimeHooks} into one. Falsy entries are dropped (so you can |
 | `computeBackoff` | function | Compute the delay before the next attempt. Default: 250ms exponential with jitter. |
-| `createConversationBackend` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createConversationBackend` | function | Wrap a `Conversation` so it satisfies `AgentExecutionBackend`. The result is |
 | `createIterableBackend` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `createOpenAICompatibleBackend` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createOpenAICompatibleBackend` | function | OpenAI-compat streaming backend. Routes `runAgentTaskStream` through any |
 | `createOtelExporter` | function | Create an OTEL exporter. Returns undefined when no endpoint is configured. |
 | `createRuntimeEventCollector` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `createRuntimeStreamEventCollector` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createRuntimeStreamEventCollector` | function | Streaming-event counterpart of `createRuntimeEventCollector`. Pass each |
 | `createSandboxPromptBackend` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `d1ToSqlAdapter` | function | Adapt a Cloudflare D1 binding to the SqlAdapter shape. Lives here so D1 |
-| `decideKnowledgeReadiness` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `defineConversation` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `decideKnowledgeReadiness` | function | Map a `KnowledgeReadinessReport` to a three-state branch (`ready` / `blocked` / `caveat`) the runtime, route handlers, and UI shells all switch on. |
+| `defineConversation` | function | Declarative constructor for a multi-agent `Conversation`. Validates inputs |
 | `defineRuntimeHooks` | function | Identity helper that types a {@link RuntimeHooks} literal so the fields are inferred. |
 | `deriveExecutionId` | function | Derive a stable executionId from the run identity. The same |
 | `exportEvalRuns` | function | Ship self-improvement eval-run events to Tangle Intelligence. Unlike the |
 | `getModels` | function | Fetch the model catalog from the router's `/v1/models`. Throws on a non-2xx |
 | `handleChatTurn` | function | Run one chat turn. Returns immediately with a `ReadableStream` body; |
 | `improve` | function | Run the held-out-gated self-improvement loop on ONE profile surface. |
-| `improvementDriver` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `improvementDriver` | function | The one reflective/agentic improvement proposer (`SurfaceProposer`): owns the candidate worktree lifecycle and delegates HOW a change is produced to a pluggable `CandidateGenerator`. |
 | `isDelegatedLoopMode` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `isDepthExceeded` | function | Refuse further forwarding when the inbound depth has reached the limit. |
 | `loopEventToOtelSpan` | function | Convert a LoopTraceEvent into an OtelSpan for export. |
 | `makePerAttemptSignal` | function | Build a per-attempt AbortSignal linked to the parent signal AND fired when |
 | `mcpBuildPrompt` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `mcpServeVerifier` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `mcpToolsForRuntimeMcp` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `mcpToolsForRuntimeMcpSubset` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `mcpToolsForRuntimeMcp` | function | Returns the queue-bound delegation tools projected into OpenAI Chat |
+| `mcpToolsForRuntimeMcpSubset` | function | Subset filter — return only the projected tools whose `function.name` |
 | `notifyRuntimeDecisionPoint` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `notifyRuntimeHookEvent` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `parseLoopRunnerArgv` | function | Parse `--mode X --config Y` from an argv tail (`process.argv.slice(2)`). |
 | `readDepth` | function | Read the depth counter off an inbound request. Missing → 0 (caller is the |
 | `readinessServerSentEvent` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `reflectiveGenerator` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `researchLoopRunner` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `reflectiveGenerator` | function | Cheap no-sandbox `CandidateGenerator` (the `shots=1` setting): draft surface edits via the improvement adapter and apply them as one coherent candidate. |
+| `researchLoopRunner` | function | `research` mode — research-in-a-loop with valid-only KB growth. |
 | `resolveChatModel` | function | Resolve a chat model by precedence: the first candidate carrying a |
 | `resolveRouterBaseUrl` | function | Resolve the router base URL from env, normalised — no trailing `/v1` or `/`. |
-| `runAgentTask` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `runAgentTaskStream` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `runConversation` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `runConversationStream` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `runDelegatedLoop` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `runLoopRunnerCli` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `runAgentTask` | function | Single-shot task lifecycle for adapter-driven tasks: readiness-gated, emits the runtime lifecycle event vocabulary, session-store pluggable. |
+| `runAgentTaskStream` | function | Streaming task lifecycle: delegates execution to an `AgentExecutionBackend` (model API, sandbox, or custom iterable) and yields lifecycle events as they happen. |
+| `runConversation` | function | Conversation orchestrator. Drives N participants in turn through their own |
+| `runConversationStream` | function | Streaming conversation orchestrator: drives N participants in turn through their own backends, enforcing `maxTurns` / `maxCreditsCents` / `haltOn`, yielding per-event stream markers. |
+| `runDelegatedLoop` | function | Dispatch a configured loop by mode. Fails loud (throws `ConfigError`) when no |
+| `runLoopRunnerCli` | function | Pure CLI core (no process / argv / IO) so it's unit-testable: validate the |
 | `runPersonaConversation` | function | Run one worker profile against one persona as a multi-round conversation. |
 | `runPersonaDispatch` | function | Wrap {@link runPersonaConversation} as a `ProfileDispatchFn` for |
 | `runtimeStreamServerSentEvent` | function | _(no summary — add a TSDoc line at the declaration)_ |
@@ -76,15 +76,15 @@ Import from `@tangle-network/agent-runtime` — 208 exports.
 | `sanitizeAgentRuntimeEvent` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `sanitizeKnowledgeReadinessReport` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `sanitizeRuntimeStreamEvent` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `selfImproveLoopRunner` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `selfImproveLoopRunner` | function | `self-improve` mode — agent-eval's one-call closed improvement loop (held-out gated). |
 | `sleep` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `slugifySpeaker` | function | Reduce a speaker name to ASCII alphanumerics + dashes. Preserves enough |
-| `startRuntimeRun` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `startRuntimeRun` | function | Construct a runtime-run handle. The returned handle is mutable across its |
 | `streamToolLoop` | function | Streaming bounded tool loop: yields each raw turn event (the caller maps + |
 | `toolBuildPrompt` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `turnId` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `turnId` | function | Deterministic turn identifier. Stable across retries of the same logical |
 | `validateChatModelId` | function | Validate a caller-supplied chat-model id. Rejects non-strings, malformed |
-| `worktreeLoopRunner` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `worktreeLoopRunner` | function | `code` mode on the GENERIC recursive path: author one `AgentProfile` per harness, run them as a |
 | `DEFAULT_MAX_DEPTH` | const | Hard cap on chained gateway hops; refused beyond this. Default keeps recursion bounded. |
 | `DEFAULT_ROUTER_BASE_URL` | const | _(no summary — add a TSDoc line at the declaration)_ |
 | `defaultIsRetryable` | const | Default retryable classification — network/timeout class errors. Errors |
@@ -92,7 +92,7 @@ Import from `@tangle-network/agent-runtime` — 208 exports.
 | `FORWARD_HEADERS` | const | Standard names — lowercased so Headers maps interop on every runtime. |
 | `INTELLIGENCE_WIRE_VERSION` | const | Wire version the eval-runs ingest enforces (X-Tangle-Wire-Version + body). |
 | `AgentEvalError` | class | _(no summary — add a TSDoc line at the declaration)_ |
-| `BackendTransportError` | class | _(no summary — add a TSDoc line at the declaration)_ |
+| `BackendTransportError` | class | A backend transport call (HTTP, gRPC, sidecar IPC) failed with a non-success |
 | `CircuitBreakerState` | class | Live circuit-breaker state — one instance per (participant, conversation run). |
 | `CircuitOpenError` | class | _(no summary — add a TSDoc line at the declaration)_ |
 | `ConfigError` | class | Configuration missing or malformed (`HOME` unset, required image not supplied, env var absent). |
@@ -102,132 +102,47 @@ Import from `@tangle-network/agent-runtime` — 208 exports.
 | `InMemoryRuntimeSessionStore` | class | _(no summary — add a TSDoc line at the declaration)_ |
 | `JudgeError` | class | A judge call failed in a way that's not retryable: schema parse failure, bad rubric, conflicting dimensions. |
 | `NotFoundError` | class | A named resource (run, span, rubric, scenario, dataset row, route) does not exist. |
-| `PlannerError` | class | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeRunStateError` | class | _(no summary — add a TSDoc line at the declaration)_ |
+| `PlannerError` | class | The dynamic-loop planner returned an unusable topology move — the LLM emitted |
+| `RuntimeRunStateError` | class | A runtime-run lifecycle method was called in an order the state machine does |
 | `SqlConversationJournal` | class | SQL-backed ConversationJournal. Two tables — runs (one row per runId, holds |
 | `ValidationError` | class | Caller passed invalid arguments (out of range, mutually-exclusive options, bad shape). |
-| `AgentAdapter` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentBackendContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentBackendInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentExecutionBackend` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgenticGeneratorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentKnowledgeProvider` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTaskContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTaskRunResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTaskSpec` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BackendCallPolicy` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BackendErrorDetail` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `BackendErrorDetail` | interface | Typed transport / backend failure detail. Carried on `backend_error` and |
 | `CandidateGenerator` | interface | The byte-producing seam — the ONE thing that differs between the cheap |
 | `ChatStreamEvent` | interface | The NDJSON line protocol every product chat client already speaks. |
-| `ChatTurnHooks` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ChatTurnIdentity` | interface | Identity of a chat turn. `tenantId` is the workspace id for workspace- |
 | `ChatTurnProducer` | interface | The live side of a turn — what the product's `produce` hook returns. |
-| `ChatTurnResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CircuitBreakerConfig` | interface | Circuit-breaker tuning. `failuresToOpen` consecutive failures opens it; closed only after `cooldownMs`. |
-| `ControlBudget` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ControlEvalResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ControlRunResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ControlStep` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `Conversation` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationDriveState` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationJournal` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationJournalEntry` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationParticipant` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationPolicy` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationTurn` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `ConversationJournalEntry` | interface | Durable conversation transcript — survives a driver process crash mid-run. |
 | `D1DatabaseLike` | interface | Structural type matching the surface of `D1Database` we depend on, so the |
-| `D1StmtLike` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DataAcquisitionPlan` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegatedLoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvalRunEvent` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvalRunGeneration` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvalRunsExportConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvalRunsExportResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `HaltContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `HaltSignal` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ImprovementDriverOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ImproveOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ImproveResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `KnowledgeReadinessReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `KnowledgeRequirement` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopRunnerCliArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopRunnerCliResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopSpanNode` | interface | Sink-neutral node in a reconstructed loop span tree. The root node's |
 | `McpServeSpec` | interface | `mcpServeVerifier` — the intrinsic verifier for a built MCP server: the |
 | `ModelInfo` | interface | A model entry as returned by the Tangle Router `/v1/models` endpoint. |
-| `OpenAIChatTool` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `OtelAttribute` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `OpenAIChatTool` | interface | OpenAI Chat Completions tool descriptor. The shape mirrors the |
 | `OtelExportConfig` | interface | OTEL span exporter — streams LoopTraceEvents to an OTLP/HTTP collector. |
-| `OtelExporter` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `OtelSpan` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `PersonaConversationResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ReflectiveGeneratorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ResearchLoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ResearchLoopRunnerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ResolvedChatModel` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `ReflectiveGeneratorOptions` | interface | `reflectiveGenerator` — the cheap, no-sandbox `CandidateGenerator`. It drafts |
 | `RouterEnv` | interface | Env keys the router base URL is resolved from. |
-| `RunChatTurnInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunConversationOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunDelegatedLoopOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunPersonaConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunPersonaConversationOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RunRecord` | interface | Mandatory paper-grade fields for a single evaluation run. Optional |
-| `RuntimeDecisionEvidenceRef` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeDecisionPoint` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeEventCollector` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeHookContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeHookErrorContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeHookEvent` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RuntimeHooks` | interface | The observation seam attached to a running loop (never to the portable genome). |
-| `RuntimeRunHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeRunPersistenceAdapter` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeRunRow` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeSessionStore` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeStreamEventCollector` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeTelemetryOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunToolLoopOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SanitizedKnowledgeReadinessReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SqlAdapter` | interface | Minimal SQL driver shape. Implementations forward to whichever client the |
-| `StreamToolLoopOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ToolLoopAssistantToolCall` | interface | One OpenAI-shaped tool-call entry carried on an assistant message. |
 | `ToolLoopCall` | interface | Bounded turn-level tool-dispatch loop. |
-| `ToolLoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `VerifyResult` | interface | Outcome of verifying a candidate worktree. `feedback` (compiler errors, |
-| `VetoedFact` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WorktreeLoopRunnerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentEvalErrorCode` | type | Error taxonomy for `@tangle-network/agent-eval`. |
-| `AgentRuntimeEvent` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentRuntimeEventSink` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTaskStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuthSource` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `ControlDecision` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConversationStreamEvent` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegatedLoopMode` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegatedLoopRegistry` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegatedLoopRunner` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `ForwardHeaderName` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `HaltPredicate` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `HaltReason` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `ImproveSurface` | type | The agent-profile lever `improve` optimizes. Mirrors the AgentProfile-law |
-| `OpenAIChatResponseFormat` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `OpenAIChatToolChoice` | type | _(no summary — add a TSDoc line at the declaration)_ |
+| `OpenAIChatResponseFormat` | type | `response_format` parameter for OpenAI-compatible chat endpoints. Use |
+| `OpenAIChatToolChoice` | type | `tool_choice` parameter for OpenAI-compat chat. Same shape as the OpenAI |
 | `PersonaDriver` | type | A persona that drives the conversation: either a full driver `AgentProfile` |
 | `PropagatedHeaders` | type | Header bag carried through `AgentBackendContext.propagatedHeaders` so |
 | `RetryableErrorPredicate` | type | Pure judgment of whether an error is worth retrying. Defaults: TimeoutError, AbortError, fetch-level network errors. |
 | `RetryBackoff` | type | Backoff between attempts. Constant ms, or `(attempt: 1-indexed) => ms`. |
-| `RuntimeDecisionKind` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeHookPhase` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeHookTarget` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `RuntimeStreamEvent` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `StreamToolLoopYield` | type | _(no summary — add a TSDoc line at the declaration)_ |
+| `RuntimeHookPhase` | type | Runtime hook contracts. Hooks are execution-scoped observers, not part of an |
 | `ToolCallOutcome` | type | Outcome of one tool dispatch — structurally compatible with a hub/integration |
-| `ToolLoopEvent` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `ToolLoopMessage` | type | A message in the running conversation the loop sends to `streamTurn`. |
 | `ToolLoopStopReason` | type | Why the loop stopped. `completed` = model finished naturally; `stuck-loop` = |
-| `TurnOrder` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `Verifier` | type | Verifies the edited worktree. Sync or async; throws only on a setup fault |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AgentAdapter`, `AgentBackendContext`, `AgentBackendInput`, `AgentExecutionBackend`, `AgenticGeneratorOptions`, `AgentKnowledgeProvider`, `AgentTaskContext`, `AgentTaskRunResult`, `AgentTaskSpec`, `BackendCallPolicy`, `ChatTurnHooks`, `ChatTurnResult`, `ControlBudget`, `ControlEvalResult`, `ControlRunResult`, `ControlStep`, `Conversation`, `ConversationDriveState`, `ConversationJournal`, `ConversationParticipant`, `ConversationPolicy`, `ConversationResult`, `ConversationTurn`, `D1StmtLike`, `DataAcquisitionPlan`, `DelegatedLoopResult`, `EvalRunEvent`, `EvalRunGeneration`, `EvalRunsExportConfig`, `EvalRunsExportResult`, `HaltContext`, `HaltSignal`, `ImprovementDriverOptions`, `ImproveOptions`, `ImproveResult`, `KnowledgeReadinessReport`, `KnowledgeRequirement`, `LoopRunnerCliArgs`, `LoopRunnerCliResult`, `OtelAttribute`, `OtelExporter`, `OtelSpan`, `PersonaConversationResult`, `ResearchLoopResult`, `ResearchLoopRunnerOptions`, `ResolvedChatModel`, `RunChatTurnInput`, `RunConversationOptions`, `RunDelegatedLoopOptions`, `RunPersonaConfig`, `RunPersonaConversationOptions`, `RuntimeDecisionEvidenceRef`, `RuntimeDecisionPoint`, `RuntimeEventCollector`, `RuntimeHookContext`, `RuntimeHookErrorContext`, `RuntimeHookEvent`, `RuntimeRunHandle`, `RuntimeRunPersistenceAdapter`, `RuntimeRunRow`, `RuntimeSessionStore`, `RuntimeStreamEventCollector`, `RuntimeTelemetryOptions`, `RunToolLoopOptions`, `SanitizedKnowledgeReadinessReport`, `StreamToolLoopOptions`, `ToolLoopResult`, `VetoedFact`, `WorktreeLoopRunnerOptions`, `AgentRuntimeEvent`, `AgentRuntimeEventSink`, `AgentTaskStatus`, `AuthSource`, `ControlDecision`, `ConversationStreamEvent`, `DelegatedLoopMode`, `DelegatedLoopRegistry`, `DelegatedLoopRunner`, `ForwardHeaderName`, `HaltPredicate`, `HaltReason`, `RuntimeDecisionKind`, `RuntimeHookTarget`, `RuntimeStreamEvent`, `StreamToolLoopYield`, `ToolLoopEvent`, `TurnOrder`.
+
 ### Vertical agent — manifest + improvement adapter
 
 Import from `@tangle-network/agent-runtime/agent` — 33 exports.
@@ -236,38 +151,26 @@ Import from `@tangle-network/agent-runtime/agent` — 33 exports.
 |---|---|---|
 | `collectAgentRun` | function | Drain `act`'s `events` into an array AND await its `output`. Useful for |
 | `createSandboxAct` | function | Build an `AgentRuntime.act` implementation backed by a single prod-profile |
-| `createSurfaceImprovementAdapter` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createSurfaceImprovementAdapter` | function | The substrate-default `ImprovementAdapter`: resolve each finding's subject to a real surface path, LLM-draft a unified-diff patch, then auto-apply or open a PR. |
 | `createSurfaceKnowledgeAdapter` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `defineAgent` | function | Construct a validated agent manifest. Throws `AgentManifestError` |
 | `measureOutcome` | function | Run `runAnalystLoop` and stamp an `OutcomeMeasurement` onto the |
 | `renderSurfaceIssues` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `resolveSubjectPath` | function | Resolve a parsed `FindingSubject` to the file path the substrate |
 | `unimplementedAgentRun` | function | Stub for agents whose `runtime.act` is not yet wired to the substrate's |
-| `validateSurfaces` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `validateSurfaces` | function | Validate an `AgentSurfaces` map on disk — missing paths fail loud at `defineAgent` time instead of silently skipping self-improvement edits. |
 | `AgentManifestError` | class | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentManifest` | interface | The full agent manifest. Each agent ships ONE of these. |
-| `AgentRubric` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentRunContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentRunInvocation` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentRuntime` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentSurfaces` | interface | Surface declarations. Every path is repo-relative (or absolute) at |
-| `AnalystConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AutoApplyPolicy` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CreateSandboxActOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CreateSurfaceImprovementAdapterOpts` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CreateSurfaceKnowledgeAdapterOpts` | interface | Substrate-default `KnowledgeAdapter` — wraps agent-knowledge's |
-| `DraftPatchInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DraftPatchOutput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `JudgeConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `KnowledgeAdapterDeps` | interface | Build the adapter. We accept the agent-knowledge functions as DI so |
 | `OutcomeMeasurement` | interface | `OutcomeMeasurement` — the missing metric that turns the analyst |
-| `OutcomeMeasurementOpts` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ResolvedSurface` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RubricDimension` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SurfaceImprovementEdit` | interface | Substrate-default `ImprovementAdapter` — surfaces-driven, LLM-drafted |
 | `SurfaceLifecycle` | interface | One profile surface's artifact-lifecycle wiring — the declarative config a |
 | `SurfaceValidationIssue` | interface | Validate that every declared surface exists on disk under `repoRoot`. |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AgentRubric`, `AgentRunContext`, `AgentRunInvocation`, `AgentRuntime`, `AnalystConfig`, `AutoApplyPolicy`, `CreateSandboxActOptions`, `CreateSurfaceImprovementAdapterOpts`, `DraftPatchInput`, `DraftPatchOutput`, `JudgeConfig`, `OutcomeMeasurementOpts`, `ResolvedSurface`, `RubricDimension`.
+
 ### Intelligence SDK — Observe + provable-OFF billing
 
 Import from `@tangle-network/agent-runtime/intelligence` — 63 exports.
@@ -309,7 +212,6 @@ Import from `@tangle-network/agent-runtime/intelligence` — 63 exports.
 | `IntelligenceConfig` | interface | Client configuration. `project` + `apiKey` are the Observe minimum; the |
 | `ModeReadiness` | interface | One mode's readiness verdict. |
 | `ProvisionedHost` | interface | A live, provisioned host the resolver tore up for a `process-on-infra` arm. |
-| `PullCertifiedOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RecordTraceMeta` | interface | Metadata for {@link IntelligenceClient.recordTrace}. |
 | `RepoConfig` | interface | Repo coordinates a product may declare for the (later) Gated-PR mode. The |
 | `ResolveCtx` | interface | Per-call, per-tenant context the resolver reads. Everything that touches the |
@@ -338,42 +240,44 @@ Import from `@tangle-network/agent-runtime/intelligence` — 63 exports.
 | `Redactor` | type | A redactor maps an arbitrary trace value to a safe-to-export value. Pure; |
 | `UsageClass` | type | Usage class for billing. Base-stream tokens bill `'inference'`; every |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `PullCertifiedOptions`.
+
 ### Recursive atom + loop kernel (alias of ./runtime)
 
 Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 
 | Symbol | Kind | Summary |
 |---|---|---|
-| `acquireSandbox` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `acquireSandbox` | function | Cold-start-resilient sandbox acquisition: create by name, observe readiness from the sandbox's own status (not the create call), and re-attach after gateway timeouts. |
 | `analyzeTrace` | function | Collect the source's spans and run the agent-eval batch analyzers over them under one `runId`. |
 | `anytimeReport` | function | Derive anytime metrics from waterfall spans. `targets` are the satisficing score |
 | `asAuthoredProfile` | function | Narrow an untyped `spawn_agent` profile argument to an `AuthoredProfile`, or null if the |
 | `assertModelAllowed` | function | Throw a `ConfigError` when `allowed` is set, `model` is defined, and `model` is not a |
 | `assertStrategyContract` | function | Static CONTRACT lint over an authored strategy module — the module-boundary |
 | `assessAuthoredProfile` | function | OBSERVE one authored `AgentProfile` and score its richness (no judge verdict is read). The task |
-| `auditIntent` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `auditIntent` | function | The route-rigor analyst: compare declared vs revealed vs user intent over a trajectory and return aligned / drifting / diverged with evidence and one recommended intervention. |
 | `authoredWorker` | function | Build a worker AGENT from a profile the supervisor authored: the authored `systemPrompt` + |
 | `authorStrategy` | function | Author + load a strategy from losses. Throws when the author emits no loadable module; |
 | `breadthStrategy` | function | BREADTH: K independent rollouts (each own artifact), verifier picks the best. |
 | `buildSteerContext` | function | Build the `SteerContext` a combinator reads to steer (its `loopUntil.until`, `widen` gate, any |
-| `completionAuthorizes` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `completionAuthorizes` | function | Decide whether a `CompletionVerdict` may end the node under the policy: authority scales with the verdict's determinism, and probabilistic verdicts must clear `minConfidence`. |
 | `computeFindingId` | function | Compute the stable finding_id from the identity-defining fields. |
 | `contentAddress` | function | Mint the content-addressed `outRef` for a result artifact: `sha256:<hex>` over a |
 | `createAgentEnvironmentProviderRegistry` | function | Create a registry that resolves provider names to concrete provider instances. |
 | `createBudgetPool` | function | Create a conserved reservation pool from a root `Budget`. `now()` is injected so the |
-| `createEventBus` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createEventBus` | function | Create the child→parent coordination bus: one typed pipe for settled outputs, questions, and analyst findings, with a priority-ordered pull queue and a pass-through subscribe lane. |
 | `createExecutor` | function | The single built-in executor factory. Picks a leaf backend by data (`config.backend`), |
 | `createExecutorRegistry` | function | The open resolver/registry. Pre-registers the three built-ins under their |
-| `createInbox` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createInbox` | function | Create the worker-side inbox for the down-leg: the driver's `steer_agent` / `answer_question` messages queue here and the worker's loop drains them at step boundaries and before settle. |
 | `createInMemoryRunContext` | function | Build a fresh in-memory run context. Every call returns NEW stores (no shared global |
-| `createMcpEnvironment` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createMcpEnvironment` | function | Wrap any MCP server as an `Environment`: `tools/list` becomes `AgenticTool[]` with provider-safe schemas; the domain supplies only the artifact lifecycle hooks. |
 | `createPushTraceSource` | function | A push source for OWNED tool loops (router-tools / cli-bridge tool dispatch): the loop calls |
 | `createSandboxLineage` | function | Build a lineage bound to one client + its probed capabilities. The |
-| `createScope` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createScope` | function | Create the reactive `Scope` a driver's `Agent.act` runs inside: spawn children on an atomically reserved conserved budget, settle via the `next()` cursor, journal for replay. |
 | `createScopeAnalyst` | function | Build a `ScopeAnalyst` that spawns the analyst agent through `Scope.spawn` (so its compute is |
 | `createShapeRegistry` | function | Build a fresh open `ShapeRegistry`. A factory is stored type-erased and re-cast on resolve — the |
-| `createSupervisor` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `createVerifierEnvironment` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createSupervisor` | function | The `Supervisor` impl (KEYSTONE, build step 5). |
+| `createVerifierEnvironment` | function | Any checkable task as an `Environment`, no tool surface required: the artifact is the worker's answer and the domain is one deployable `check` over it. |
 | `createWaterfallCollector` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `createWorktreeCliExecutor` | function | Build a worktree-CLI leaf `Executor`. Per-spawn (a fresh worktree + abort + teardown each), so a |
 | `decodeToolPart` | function | Decode a part with a specific harness's adapter when known, else try every registered adapter |
@@ -394,21 +298,21 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `finalizeBestDelivered` | function | Keep-best finalize under the completion-oracle: return the highest-scoring DELIVERED child's |
 | `flatWidenGate` | function | The flat default `ScopeWidenGate` — never widens, keeping the R2 selector≠judge collision |
 | `gateOnDeliverable` | function | Wrap an `Executor` so its settlement `valid` reflects the deliverable check, not the |
-| `gitWorkspace` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `harvestCorpus` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `gitWorkspace` | function | A `Workspace` over a git checkout: materialize an isolated worktree at `ref`, commit produced changes (conflict-aware), and read `head` — hooks disabled, identity pinned. |
+| `harvestCorpus` | function | Batch the firewalled `observe()` analyst over completed runs and accrete the trace-derived facts into the durable corpus — the production-traces→corpus write side of the flywheel. |
 | `inlineSandboxClient` | function | Adapt an `ExecutorFactory` into a `SandboxClient` for `runLoop`. The factory is |
 | `inProcessSandboxClient` | function | Adapt a single `onPrompt(prompt, ctx)` callback into a `SandboxClient` for |
 | `jjWorkspace` | function | A jj-backed `Workspace` (Jujutsu, colocated with git for the durable remote). |
 | `leaderboard` | function | Aggregate a fleet of records into the ranked, multi-axis report. Pure — no IO, deterministic. |
-| `localShell` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `localShell` | function | Host-process `Shell`: run a command via `execFile`, resolving `{ stdout, stderr, code }` (never throws on non-zero exit). |
 | `loopCampaignDispatch` | function | Adapter for plain `runCampaign` scenarios. This is the runtime-side pair for |
 | `loopDispatch` | function | Adapter for `runProfileMatrix` (profile is an axis). Returns a |
 | `loopUntil` | function | `loopUntil(seed, spec)` — one `step` child per round; `fold` accumulates each settlement into |
 | `makeFinding` | function | Convenience factory: produce a fully-formed AnalystFinding with the |
 | `mapSandboxEvent` | function | Project one `SandboxEvent` onto the `RuntimeStreamEvent` chat-UX vocabulary, |
 | `naiveDriver` | function | `naiveDriver` — the no-signal steering control. |
-| `observe` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `openSandboxRun` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `observe` | function | The third-person trace analyst: read a worker's trace and produce steer findings for the next attempt plus durable `learned` facts for the cross-run corpus. |
+| `openSandboxRun` | function | Open a sandbox run. Harness-agnostic: the harness lives in |
 | `pairwiseSignificance` | function | Compare EVERY profile pair on the scenarios they both ran — paired-bootstrap effect + CI, a real |
 | `panel` | function | `panel(spec)` — spawn the M judge children over the SAME artifact, drain their settlements, |
 | `patchDelivered` | function | Build the `DeliverableSpec<WorktreePatchArtifact>`: `check(artifact)` runs the shared mechanical |
@@ -417,7 +321,7 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `printBenchmarkReport` | function | Pretty-print a report — the "free optimization" verdict, with the cost vector. |
 | `probeSandboxCapabilities` | function | Probe (and memoize per client) what the loop may rely on. A client without a |
 | `profileRichnessFinding` | function | Turn a {@link ProfileRichness} verdict into a bus-routable `AnalystFinding` (area `profile-quality`). |
-| `promotionGate` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `promotionGate` | function | Statistical promotion decision over a holdout benchmark: a seeded paired bootstrap (`heldoutSignificance`) whose CI lower bound must clear `deltaThreshold`. |
 | `providerAsExecutor` | function | Adapt an environment provider into an `ExecutorFactory` for `createExecutor`. |
 | `providerAsSandboxClient` | function | Adapt a neutral environment provider to the `SandboxClient` interface used by existing loop paths. |
 | `registerShape` | function | Register a composed shape on the default `builtinShapes` registry — the one-call extension |
@@ -434,14 +338,14 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `resolveSandboxClient` | function | Resolve a `SandboxClient` for the chosen backend. The generic, dep-light core |
 | `routerBrain` | function | The router as a supervisor BRAIN: the canonical `ToolLoopChat` seam backed by the router's |
 | `routerChatWithTools` | function | A router completion WITH tool-calling — the operator driver's LLM seam. Passes OpenAI-shape |
-| `routerChatWithUsage` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `routerChatWithUsage` | function | One OpenAI-compatible chat completion through the Tangle router, returning text + REAL token usage (`undefined` when the provider omits it — never a fabricated 0). |
 | `routerToolLoop` | function | The tool-using router backend: a real agentic loop OVER the Tangle router (which |
 | `runAgentic` | function | Run a Strategy through the keystone Supervisor — `Agent.act` over a conserved-budget Scope. |
 | `runBenchmark` | function | Run the requested strategies over the tasks, scored by the Environment's own check. |
 | `runInWorkspace` | function | Run a worker `body` inside a FRESH clone of a shared `Workspace`, then commit its work back |
-| `runLoop` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `runLoop` | function | The round-synchronous loop kernel: each round `driver.plan()` fans N tasks to sandboxes (bounded concurrency), parses + validates each output, and folds results through `driver.decide`. |
 | `runPersonified` | function | Compose the persona + chosen shape onto a fresh keystone `Supervisor`. Resolves the shape |
-| `runStrategyEvolution` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `runStrategyEvolution` | function | Multi-generation strategy search: author candidates from tournament losses, play them against the incumbent at equal budget, promote via `promotionGate` on an untouched holdout slice. |
 | `sandboxClientAsProvider` | function | Adapt a `SandboxClient` into the shared `AgentEnvironmentProvider` contract. |
 | `sandboxSessionTraceSource` | function | The SANDBOX / fleet trace source: read a box session's message parts and decode the harness's tool |
 | `selectChampion` | function | Search-side champion selection over a tournament report. |
@@ -452,9 +356,9 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `spendFromUsageEvents` | function | Fold a normalized `UsageEvent` array into a `Spend`. Tokens and usd are separate |
 | `stopSentinel` | function | A unique, attributable stop sentinel for a node (ralph-loop style). Deterministic from the |
 | `sumSandboxUsage` | function | Sum the token usage + USD cost of a sandbox turn's events — the one honest way to meter an |
-| `supervise` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `supervise` | function | One-call supervisor: build + run a supervisor from its profile with sensible defaults; the raw `supervisorAgent` + `createSupervisor().run` seams stay available for power use. |
 | `superviseSurface` | function | Drive a team of agents (spawned + steered by `profile`) to solve a graded `AgenticSurface` task, and |
-| `supervisorAgent` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `supervisorAgent` | function | Build a supervisor `Agent` from its profile: the brain resolves from `profile.harness` (backend-as-data), the same resolution rule as every worker. |
 | `supervisorInstructions` | function | The supervisor SKILL — the how-to the supervisor reads (its system prompt). THE optimizable |
 | `trajectoryReport` | function | Reconstruct the whole spawn tree for `root` with per-node + rolled-up `Spend`. Reads the |
 | `verify` | function | `verify(spec)` — an IMPLEMENT child produces a candidate, then a SEPARATE VERIFIER child grades |
@@ -463,15 +367,15 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `workerFromBackend` | function | Build the worker seam from a backend (WHERE workers run) + an optional completion oracle (the |
 | `worktreeFanout` | function | Build the worktree fanout combinator. Run it with `runPersonified({ persona, shape, task, budget })` |
 | `adaptiveRefine` | const | A NEW strategy, authored from the steps (~20 lines): refine, but when a steered shot |
-| `assertTraceDerivedFindings` | const | _(no summary — add a TSDoc line at the declaration)_ |
+| `assertTraceDerivedFindings` | const | Analyst-on-scope (G1) — the analyze→findings→steer wire over the reactive `Scope`. |
 | `builtinShapes` | const | The default registry `runPersonified` resolves a shape name against. Empty by construction — |
 | `cliWorktreeExecutor` | const | The leaf `createWorktreeCliExecutor` as a backend-as-data factory: a supervisor-authored |
 | `defaultAnalystInstruction` | const | The default observer instruction — exported so an optimizer can seed its population. |
 | `defaultAuditorInstruction` | const | _(no summary — add a TSDoc line at the declaration)_ |
 | `defaultDelegateBudget` | const | The conserved pool a `delegate()` call applies when the caller does not pass its own `budget`. |
 | `defaultProfileRichnessThresholds` | const | _(no summary — add a TSDoc line at the declaration)_ |
-| `refine` | const | _(no summary — add a TSDoc line at the declaration)_ |
-| `sample` | const | _(no summary — add a TSDoc line at the declaration)_ |
+| `refine` | const | Built-in `Strategy`: attempt → `observe()` reads the trace → steer the next attempt → repeat (deepen one lineage). |
+| `sample` | const | Built-in `Strategy`: K independent attempts, keep the best-verifying (best-of-N / resample). |
 | `sampleThenRefine` | const | The explore-then-exploit MIX: spend ⌈budget/2⌉ on independent samples (kept open), |
 | `strategyAuthorContract` | const | The compressed consumable a skill carries: everything an author needs to emit a loop. |
 | `FileCorpus` | class | JSONL on disk — one validated `CorpusRecord` per line, append-only. `query` replays the whole |
@@ -479,63 +383,32 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `InMemoryResultBlobStore` | class | In-memory `ResultBlobStore`. Content-addressed: `put` verifies the supplied |
 | `InMemorySpawnJournal` | class | In-memory `SpawnJournal`. Appends are observed-committed only; the impl enforces |
 | `SandboxInstance` | class | A sandbox instance with methods for interaction. |
-| `SandboxRunAbortError` | class | _(no summary — add a TSDoc line at the declaration)_ |
+| `SandboxRunAbortError` | class | Thrown when a turn is aborted/timed-out mid-settle. Carries the events drained |
 | `Agent` | interface | One self-similar atom. A leaf is an `Agent` that never calls `scope.spawn`; a driver |
-| `AgentEnvironment` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentCapabilities` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentEvent` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentProvider` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentEnvironmentProviderRegistry` | interface | In-memory registry for named `AgentEnvironmentProvider` instances. |
-| `AgentEnvironmentQuery` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentSummary` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgenticOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgenticRunResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgenticSurface` | interface | A stateful, checkable environment an agent operates over with tools. Open behind one interface. |
 | `AgenticTask` | interface | The general agentic primitive — sequential (depth) and parallel (breadth) over a shared, |
-| `AgenticTool` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentProfile` | interface | Public provider-neutral agent profile contract. |
 | `AgentRunSpec` | interface | Sandbox-SDK-shaped agent specification. |
-| `AgentSession` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentSessionRef` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentSpec` | interface | `AgentProfile` does NOT carry a `harness`/backend field — `harness` lives on the |
-| `AgentTurnInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTurnResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AnalystFinding` | interface | Unified envelope every analyst emits. Schema-versioned so renderers |
-| `AnalystRegistry` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AnytimeReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AnytimeStrategySummary` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AnytimeTaskCurve` | interface | anytimeReport — time-to-satisfactory-output metrics, derived entirely from the |
-| `ArtifactHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AuditIntentInput` | interface | auditIntent — the route-rigor analyst: is this trajectory even going the RIGHT WAY? |
-| `AuditIntentOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuthoredHarness` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AuthoredProfile` | interface | What the supervisor AUTHORS per sub-task — a worker recipe (a partial `AgentProfile`). |
-| `AuthoredStrategy` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuthorStrategyOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `BenchmarkCell` | interface | One strategy's outcome on one task — the per-task cell an optimizer consumes. |
-| `BenchmarkConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BenchmarkLift` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BenchmarkReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BenchmarkStrategySummary` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BenchmarkTaskRow` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `BenchmarkReport` | interface | Benchmark output: per-strategy means plus the full per-task × per-strategy losses table an optimizer mines. |
 | `Budget` | interface | A budget envelope on a spawn or the root. All ceilings; the pool reserves against them. |
-| `BudgetPool` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `BusEvent` | interface | Every bus event is a discriminated union member keyed by `type`. |
 | `BusRecord` | interface | A published event stamped for ordering and observability. `seq` is the monotonic publish index; |
-| `BusStats` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ChampionPick` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CheckpointCapableBox` | interface | Loop-side widening of the box's optional checkpoint method. The |
-| `CheckpointRef` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CheckpointRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CompletionAnalyst` | interface | Reads a node's trace → a completion verdict. Same input shape as the `analyze` hook, so |
 | `CompletionEvidence` | interface | Trace-derived evidence for a completion claim — an artifact (output) or a verifier metric, |
 | `CompletionPolicy` | interface | When a verdict authorizes the driver to END. Deterministic → trust (ground truth); |
 | `CompletionVerdict` | interface | The "is it done?" verdict an analyst returns to the parent. |
-| `CoordinationMcpHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `CoordinationMcpHandle` | interface | Serve the coordination verbs (spawn_agent / await_event / observe_agent / steer_agent / stop) |
 | `Corpus` | interface | The durable cross-run corpus — the learning-flywheel store. DISTINCT from `SpawnJournal` |
 | `CorpusFilter` | interface | A corpus query filter — every field is an AND-narrowing; an omitted field does not constrain. |
 | `CorpusRecord` | interface | One accreted fact in the cross-run corpus — the learning-flywheel's durable unit. DISTINCT from |
-| `CreateAgentEnvironmentInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CreateSandboxOptions` | interface | Configuration for creating a new sandbox. |
 | `CreateScopeAnalystOptions` | interface | The analyst run an `Agent<unknown, AnalystFinding[]>` performs over the children settled so far. |
 | `CriuCapableClient` | interface | Narrowed view of the optional CRIU probe. The loop-side `SandboxClient` |
@@ -543,22 +416,13 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `DefinePersonaInput` | interface | The minimal input to build a `Persona`. Mirrors `Persona` but lets the builder default |
 | `DelegateOptions` | interface | Inputs to {@link delegate}. The intent is the first positional arg; everything here is optional |
 | `DeliverableSpec` | interface | The deployable completion oracle passed to {@link gateOnDeliverable}: a `check` that |
-| `Driver` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DriverAgentOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `DriverAgentOptions` | interface | `driverAgent` — the driver's BRAIN. |
 | `DumbDriverOptions` | interface | Options for {@link dumbDriver}. |
 | `EqualKArm` | interface | One arm of an equal-k comparison — a labeled trajectory (a `TrajectoryReport` is one arm's whole |
 | `EqualKOnCostOptions` | interface | `equalKOnCost(arms, { tolerance? })` — assert arms are comparable at EQUAL conserved COST |
 | `EqualKVerdict` | interface | The equal-k-on-cost verdict: whether every arm spent within `tolerance` of the others on the |
-| `EventBus` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvolutionArchiveNode` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `EvolutionAuthor` | interface | runStrategyEvolution — the multi-generation strategy search: per generation the system |
-| `EvolutionBandInfo` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvolutionCandidate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvolutionGeneration` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvolutionReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExecCtx` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExecRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExecResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `ExecCtx` | interface | Execution context for `runLoop`: the sandbox client the kernel creates boxes through, plus optional runtime hooks. |
 | `Executor` | interface | The leaf runtime — ONE open interface, not a closed union. `execute` returns a |
 | `ExecutorContext` | interface | Construction context handed to a `ExecutorFactory` — the seams a built-in needs |
 | `ExecutorRegistry` | interface | The OPEN resolver: maps an `AgentSpec` to a `ExecutorFactory`. The default |
@@ -566,82 +430,46 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `FanoutOptions` | interface | `fanout(items, { synthesize? })` — N children spawned in one round (one per item, bounded by |
 | `FanoutSynthesis` | interface | How a fanout's synthesis child is built + read. `synthesisTask` projects the drained child |
 | `ForkCapableBox` | interface | Loop-side widening of the box's optional fork method. |
-| `ForkRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `GitWorkspaceOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `HarvestCorpusOptions` | interface | harvestCorpus — production traces → corpus, the G2 bridge (the playbook's step 6). |
-| `HarvestFailure` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `HarvestReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `Inbox` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `InboxMessage` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `InboxMessage` | interface | The worker-side receive end of the down-leg: a per-worker inbox an executor exposes as |
 | `InMemoryRunContext` | interface | The bundle of stores a supervised run needs, shaped to spread into `SupervisorOpts`. |
 | `InMemoryRunContextOptions` | interface | Options for the in-memory run context. |
 | `InProcessPromptCtx` | interface | Context handed to each `onPrompt` call. |
-| `InProcessSandboxClientOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `IntentAudit` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `Interval` | interface | A 95%-by-default confidence interval. |
-| `Iteration` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `Leaderboard` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LeaderboardOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LeaderboardRow` | interface | One leaderboard row — a harness×model profile, every measured column. |
 | `LoopCampaignDispatchOptions` | interface | Options for adapting plain agent-eval campaign scenarios into runtime `runLoop` cells. |
-| `LoopDecisionPayload` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopDispatchOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopEndedPayload` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopIterationDispatchPayload` | interface | Where the iteration's worker was placed. `sibling` = a fresh sandbox the |
-| `LoopIterationEndedPayload` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopIterationStartedPayload` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopLineageOptions` | interface | Opt-in box-lineage controls for `runLoop`. Default OFF — with both flags |
-| `LoopPlanDescription` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopPlanPayload` | interface | Emitted once per `plan()` round, immediately after the driver plans. Carries |
-| `LoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopSandboxPlacement` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopStartedPayload` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopTeardownFailedPayload` | interface | Emitted when a box's `delete()` throws or times out during teardown — the |
 | `LoopTokenUsage` | interface | LLM token usage. Structurally matches agent-eval's `RunTokenUsage` / |
-| `LoopTraceEmitter` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopUntilSpec` | interface | `loopUntil({ until, step })` — iterative deepening inside the conserved pool: spawn one `step` |
 | `LoopUntilState` | interface | The accumulated state `loopUntil` threads across rounds — the running candidate + the round |
-| `LoopWinner` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `McpEndpoint` | interface | Where a handle's MCP server lives; headers carry per-artifact scoping. |
-| `McpEnvironmentOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `MountManifestEntry` | interface | One mounted resource recorded during box preparation — a pure provenance |
 | `NaiveDriverOptions` | interface | Options for {@link naiveDriver}. |
-| `Observation` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ObserveInput` | interface | The third-person observer — the connective tissue that closes the loop. |
-| `ObserveOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `OpenSandboxRunOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `OutputAdapter` | interface | Stream of `SandboxEvent`s → typed `Output`. |
-| `PairwiseOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `PairwiseVerdict` | interface | One profile pair compared on the scenarios they BOTH ran — the "who actually beat whom" verdict. |
 | `PanelJudge` | interface | One judge in a panel — a labeled persona-derived judge child. Content (the rubric) lives in |
 | `PanelSpec` | interface | `panel(judges)` — M judges over ONE artifact, merged WRITE-ONLY (selector≠judge taken to its |
 | `PanelVerdict` | interface | One judge child's settled verdict, surfaced to the write-only `merge`. `down` judges carry no |
-| `PatchDeliverableOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `Persona` | interface | The "act like X" record. A thin composition over the keystone's `AgentSpec`: it pairs the |
 | `PersonaContext` | interface | The persona context blob — who the loop is acting as. Open by intent: a persona names its |
 | `PersonaExecutors` | interface | How a persona supplies executor resolution. Either a pre-built registry (factories already |
 | `PipelineStage` | interface | `pipeline(stages)` — sequential composition: each stage's `Outcome.deliverable` feeds the next |
-| `PlacementInfo` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProfileRichness` | interface | Per-field verdict on one authored profile — the raw material the bench renders + scores. |
 | `ProfileRichnessThresholds` | interface | Thresholds below which a system prompt is treated as a thin stub. Tunable per call. |
-| `PromotionGateOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `PromotionVerdict` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProviderAsSandboxClientOptions` | interface | Options for exposing an `AgentEnvironmentProvider` through the legacy sandbox client port. |
 | `ProviderExecutorOptions` | interface | Options for running a provider as a supervise-mode executor. |
 | `ProviderSeam` | interface | Generic environment provider executor config. External packages implement |
-| `PublishOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RegistryAnalyzeProjection` | interface | Project a `ScopeAnalyzeInput` into the `AnalystRegistry.run` arguments. The registry runs over a |
 | `RenderCorpusToInstructionsOptions` | interface | Project accreted corpus facts into an `AgentProfile`'s instruction seams — the learning-flywheel |
 | `ReservationTicket` | interface | Opaque, single-use reservation handle returned by `reserve` and consumed by |
 | `ResolveSandboxClientOptions` | interface | The product-facing backend selector: one call picks the execution transport a |
-| `ResourceRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ResultBlobStore` | interface | Content-addressed result blobs (the `outRef` → artifact map) backing the replay |
-| `RouterChatResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RouterChatToolsResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RouterConfig` | interface | The one router chat client: direct OpenAI-compatible completions through the |
 | `RouterToolCall` | interface | A tool-call the model emitted (provider-neutral; mirrors the runtime's ToolCallRequest). |
-| `RouterToolLoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunAgenticOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RunPersonifiedOptions` | interface | The end-to-end entrypoint. Builds the persona's root `Agent` from the chosen shape, then |
 | `RunProvenance` | interface | Domain-free run provenance: a manifest of what was mounted into the run's |
 | `SandboxCapabilities` | interface | What the loop kernel is allowed to know about a sandbox backend: a single |
@@ -650,7 +478,6 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `SandboxEvent` | interface | SSE event from sandbox streaming. |
 | `SandboxLineage` | interface | Owns box + session handles for one loop run and offers the three |
 | `SandboxLineageHandle` | interface | A live box plus the session that threads its iterations together. Handed back |
-| `SandboxRun` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `Scope` | interface | The budget-conserving reactive scope an `Agent.act` runs inside. `spawn` reserves |
 | `ScopeAnalyst` | interface | The reactive analyst seam — the PORT of the round-synchronous driver's `analyze` hook |
 | `ScopeAnalyzeInput` | interface | Input to a `ScopeAnalyst.analyze` — the root task framing + the children settled so far. |
@@ -662,62 +489,40 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `ShapeContext` | interface | The construction context a `LoopShape` factory receives. Carries the persona's resolved |
 | `ShapeRegistry` | interface | The open shape registry — the extension point that makes a new loop-shape ONE file + one |
 | `ShotPersona` | interface | A role for one shot — multi-agent loops (researcher + engineer, a panel of k |
-| `ShotSpec` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `Spend` | interface | Conserved spend, reconciled from the normalized `UsageEvent` stream. Tokens and usd |
 | `SteerContext` | interface | How a combinator's `act` consumes findings to steer — the SINGLE firewalled steer surface a |
 | `Strategy` | interface | A Strategy is HOW you spend the compute budget to beat the Environment's check — it |
 | `StrategyCtx` | interface | What a strategy body composes with: the artifact lifecycle, the budget, and the two steps. |
-| `StrategyEvolutionConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `StrategyResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SuperviseOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SuperviseSurfaceOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SuperviseSurfaceResult` | interface | The deployable outcome of a supervised surface run. |
 | `Supervisor` | interface | Owns the conserved pool, the spawn log, the abort cascade, the OTP intensity breaker, |
-| `SupervisorAgentDeps` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SupervisorOpts` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SupervisorProfile` | interface | The supervisor's profile — the subset of an `AgentProfile` that selects + shapes its brain. |
-| `SurfaceScore` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SurfaceWorkerConfig` | interface | How a worker runs the surface task (its router substrate + per-attempt bounds). |
 | `SurfaceWorkerOut` | interface | What a surface worker settles with — the surface verdict the driver + deliverable read. `resolved` is |
 | `ToolLoopCompaction` | interface | Self-compaction — bound the loop's OWN context window the way a fresh-respawn (dumb-Ralph) loop |
-| `ToolSpec` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `TraceSource` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `TrajectoryAnalysis` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `TrajectoryAnalysis` | interface | The SETTLE-time analyst: when a worker finishes, collect its tool spans from a `TraceSource` and run |
 | `TrajectoryNode` | interface | One node in the reconstructed trajectory tree — a driver OR a leaf, with its OWN spend and the |
 | `TrajectoryReport` | interface | The whole reconstructed trajectory — the realized tree + its root-rolled-up total. The |
 | `TrajectoryReportOptions` | interface | `trajectoryReport(journal, blobs, root, { withOutputs? })` — reconstruct the whole tree with |
 | `TreeView` | interface | The live tree — what `scope.view` / `RootHandle.view()` materialize for a viewer. |
-| `TurnResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `TurnResult` | interface | One finished turn over the artifact. A failed FS read is surfaced in `readError` |
 | `UsageSink` | interface | The slice of an agent-eval campaign `DispatchContext.cost` this needs. |
-| `ValidationCtx` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `Validator` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `VerifierEnvironmentOptions` | interface | createVerifierEnvironment — ANY checkable task as an `Environment`, no tool surface |
 | `VerifySpec` | interface | `verify({ implement, verifier })` — the 2-node sequential gate: an IMPLEMENT child produces a |
-| `WatchTraceOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WaterfallCollector` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WaterfallReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `WatchTraceOptions` | interface | The ONLINE analyst: watch a `TraceSource` and fold each tool span through agent-eval's published |
 | `WaterfallSpan` | interface | createWaterfallCollector — 100% trajectory observability from the lifecycle stream: |
 | `WidenGate` | interface | The progressive-widening gate (MCTS-PW). Decides whether a settled child is |
 | `WidenLineage` | interface | A lineage the gate may widen toward — the settled child that looked promising + the findings |
 | `WidenSpec` | interface | `widen({ gate })` (G5) — the STREAMING spawn-on-completion driver. Unlike the static-fanout |
-| `Workspace` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WorkspaceRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WorkspaceRun` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WorktreeCliExecutorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `WorktreeCommandResult` | interface | Outcome of one verification command run in the worktree (test or typecheck). |
-| `WorktreeFanoutOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentEnvironmentProviderRef` | type | Provider object or registry name accepted by runtime provider adapters. |
-| `AgentEnvironmentStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentProfileRef` | type | Portable profile reference: inline profile or provider catalog id. |
-| `AgentSessionStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `ApplyContinuation` | type | Fold a steering string into the caller's Task shape, producing the Task for |
 | `AssertTraceDerivedFindings` | type | The firewall assertion contract, re-stated for the reactive seam (PORT of |
 | `BudgetReadout` | type | Post-reservation pool readout — the shape `Scope.budget` exposes. `tokensLeft`, |
-| `ChampionPolicy` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `CombinatorShape` | type | A combinator is just a `LoopShape`: a factory `(ShapeContext) => Agent` whose `Agent.act` |
 | `CoordinationEvent` | type | Every message on the one typed pipe. UP (child→parent): question / settled / finding — queued for |
 | `DefinePersona` | type | Builds a frozen `Persona`, failing loud on the executors-supplied invariant (neither a |
-| `Deliverable` | type | _(no summary — add a TSDoc line at the declaration)_ |
+| `Deliverable` | type | How a typed deliverable `Out` is materialized from a finished turn. |
 | `DriveHarness` | type | How to run a sandboxed harness as the DRIVER, with the coordination verbs mounted — the substrate |
 | `Environment` | type | A checkable task domain — implement these 5 hooks and the suite does the rest. The |
 | `EqualKOnCost` | type | `equalKOnCost(arms, opts)` — the cross-arm equal-compute check on conserved cost. |
@@ -729,9 +534,7 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `InProcessOnPrompt` | type | The user callback: given a prompt and its round, produce the box's event |
 | `LoopOptionsForDispatch` | type | runLoop options minus the `ctx` (loopDispatch builds the ctx). |
 | `LoopShape` | type | A reusable act-body factory. Given the persona's content + seams (`ShapeContext`), it |
-| `LoopTraceEvent` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopUntil` | type | `loopUntil(spec)` — build the iterative-deepening combinator. `seed` is the initial state. |
-| `MakeWorkerAgent` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `MountRecorder` | type | Records a mounted resource into the run's provenance manifest. Passed to |
 | `Outcome` | type | The terminal contract Drew wants: a loop returns a FINISHED deliverable, or the concrete |
 | `Panel` | type | `panel(spec)` — build the M-judge write-only-merge combinator. |
@@ -751,9 +554,10 @@ Import from `@tangle-network/agent-runtime/loops` — 409 exports.
 | `Widen` | type | `widen(spec)` — build the streaming progressive-widening combinator. |
 | `WidenDecision` | type | A widening decision: extend one lineage by one child, or stop widening. `flatWidenGate` |
 | `WinnerStrategy` | type | Built-in valid-only winner strategies for `selectValidWinner` (selector≠judge): best gated-valid |
-| `WorkspaceCommit` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `WorktreePatchArtifact` | type | Terminal artifact of one worktree-CLI run — the canonical worktree-harness result (the captured |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AgentEnvironment`, `AgentEnvironmentCapabilities`, `AgentEnvironmentEvent`, `AgentEnvironmentProvider`, `AgentEnvironmentQuery`, `AgentEnvironmentSummary`, `AgenticOptions`, `AgenticRunResult`, `AgenticTool`, `AgentSession`, `AgentSessionRef`, `AgentTurnInput`, `AgentTurnResult`, `AnalystRegistry`, `AnytimeReport`, `AnytimeStrategySummary`, `ArtifactHandle`, `AuditIntentOptions`, `AuthoredHarness`, `AuthoredStrategy`, `AuthorStrategyOptions`, `BenchmarkConfig`, `BenchmarkLift`, `BenchmarkStrategySummary`, `BenchmarkTaskRow`, `BudgetPool`, `BusStats`, `ChampionPick`, `CheckpointRef`, `CheckpointRequest`, `CreateAgentEnvironmentInput`, `Driver`, `EventBus`, `EvolutionArchiveNode`, `EvolutionBandInfo`, `EvolutionCandidate`, `EvolutionGeneration`, `EvolutionReport`, `ExecRequest`, `ExecResult`, `ForkRequest`, `GitWorkspaceOptions`, `HarvestFailure`, `HarvestReport`, `Inbox`, `InProcessSandboxClientOptions`, `IntentAudit`, `Iteration`, `Leaderboard`, `LeaderboardOptions`, `LoopDecisionPayload`, `LoopDispatchOptions`, `LoopEndedPayload`, `LoopIterationEndedPayload`, `LoopIterationStartedPayload`, `LoopPlanDescription`, `LoopResult`, `LoopSandboxPlacement`, `LoopStartedPayload`, `LoopTraceEmitter`, `LoopWinner`, `McpEnvironmentOptions`, `Observation`, `ObserveOptions`, `OpenSandboxRunOptions`, `PairwiseOptions`, `PatchDeliverableOptions`, `PlacementInfo`, `PromotionGateOptions`, `PromotionVerdict`, `PublishOptions`, `ResourceRequest`, `RouterChatResult`, `RouterChatToolsResult`, `RouterToolLoopResult`, `RunAgenticOptions`, `SandboxRun`, `ShotSpec`, `StrategyEvolutionConfig`, `StrategyResult`, `SuperviseOptions`, `SuperviseSurfaceOptions`, `SupervisorAgentDeps`, `SupervisorOpts`, `SurfaceScore`, `ToolSpec`, `TraceSource`, `ValidationCtx`, `Validator`, `WaterfallCollector`, `WaterfallReport`, `Workspace`, `WorkspaceRequest`, `WorkspaceRun`, `WorktreeCliExecutorOptions`, `WorktreeFanoutOptions`, `AgentEnvironmentStatus`, `AgentSessionStatus`, `ChampionPolicy`, `LoopTraceEvent`, `MakeWorkerAgent`, `WorkspaceCommit`.
+
 ### Environment provider adapters — generic sandbox/compute bridge
 
 Import from `@tangle-network/agent-runtime/environment-provider` — 32 exports.
@@ -765,33 +569,14 @@ Import from `@tangle-network/agent-runtime/environment-provider` — 32 exports.
 | `providerAsSandboxClient` | function | Adapt a neutral environment provider to the `SandboxClient` interface used by existing loop paths. |
 | `resolveAgentEnvironmentProvider` | function | Resolve a provider instance or registry name, failing loudly when a name is unknown. |
 | `sandboxClientAsProvider` | function | Adapt a `SandboxClient` into the shared `AgentEnvironmentProvider` contract. |
-| `AgentEnvironment` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentCapabilities` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentEvent` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentProvider` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentEnvironmentProviderRegistry` | interface | In-memory registry for named `AgentEnvironmentProvider` instances. |
-| `AgentEnvironmentQuery` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentEnvironmentSummary` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentSession` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentSessionRef` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTurnInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AgentTurnResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CheckpointRef` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CheckpointRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CreateAgentEnvironmentInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExecRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExecResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ForkRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `PlacementInfo` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProviderAsSandboxClientOptions` | interface | Options for exposing an `AgentEnvironmentProvider` through the legacy sandbox client port. |
 | `ProviderExecutorOptions` | interface | Options for running a provider as a supervise-mode executor. |
-| `ResourceRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SandboxClientProviderOptions` | interface | Options for wrapping the current Tangle sandbox client as an environment provider. |
-| `WorkspaceRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentEnvironmentProviderRef` | type | Provider object or registry name accepted by runtime provider adapters. |
-| `AgentEnvironmentStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `AgentProfileRef` | type | Portable profile reference: inline profile or provider catalog id. |
-| `AgentSessionStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
+
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AgentEnvironment`, `AgentEnvironmentCapabilities`, `AgentEnvironmentEvent`, `AgentEnvironmentProvider`, `AgentEnvironmentQuery`, `AgentEnvironmentSummary`, `AgentSession`, `AgentSessionRef`, `AgentTurnInput`, `AgentTurnResult`, `CheckpointRef`, `CheckpointRequest`, `CreateAgentEnvironmentInput`, `ExecRequest`, `ExecResult`, `ForkRequest`, `PlacementInfo`, `ResourceRequest`, `WorkspaceRequest`, `AgentEnvironmentStatus`, `AgentSessionStatus`.
 
 ### Analyst loop — trace findings on a running loop
 
@@ -806,15 +591,11 @@ Import from `@tangle-network/agent-runtime/analyst-loop` — 15 exports.
 | `AutoApplyPolicy` | interface | Tunable safety rails for auto-apply. |
 | `FindingsStoreLike` | interface | Narrowed shape we accept for `FindingsStore`. |
 | `ImprovementAdapter` | interface | Improvement-side bridge — proposes / applies prompt + tool + scaffolding edits. |
-| `ImprovementEditBatch` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ImprovementReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `KnowledgeAdapter` | interface | Knowledge-side bridge — consumers wire `proposeFromFindings` from agent-knowledge. |
-| `KnowledgeProposalBatch` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `KnowledgeReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunAnalystLoopOpts` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunAnalystLoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AnalystLoopEvent` | type | Events emitted by `runAnalystLoop` via `opts.onEvent`. UIs and |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `ImprovementEditBatch`, `ImprovementReport`, `KnowledgeProposalBatch`, `KnowledgeReport`, `RunAnalystLoopOpts`, `RunAnalystLoopResult`.
+
 ### Artifact lifecycle — generate → measure → promote → compose
 
 Import from `@tangle-network/agent-runtime/lifecycle` — 59 exports.
@@ -843,32 +624,23 @@ Import from `@tangle-network/agent-runtime/lifecycle` — 59 exports.
 | `ArtifactRegistry` | class | A typed, in-memory registry of `ProfileArtifact`s with stable ids. |
 | `ArtifactPayloads` | interface | The payload for each `ArtifactKind`. The shapes are the SAME types the |
 | `ArtifactQuery` | interface | Filter for `list`. Omit a field to leave that dimension unconstrained. |
-| `BuildableGeneratorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `BuiltCandidate` | interface | The result of building ONE candidate in its own worktree. A build either |
 | `CandidateGenerator` | interface | Produces fresh, UNMEASURED candidate artifacts for ONE profile surface. |
 | `CandidateOutcome` | interface | The per-candidate record of what the loop decided and why. |
 | `ComposeProfileOptions` | interface | `composeProfile` — fold the top-k active artifacts back into a profile. |
 | `DedupeOptions` | interface | `dedupeArtifacts` — retire the redundant half of a non-stacking pair. |
-| `DedupeResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DriftCheck` | interface | Per-artifact record of what the re-measure found and decided. |
 | `DriftWatchOptions` | interface | `driftWatch` — the scheduled re-measure that DEMOTES decayed artifacts. |
-| `DriftWatchResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `EvalResult` | interface | The result of running an eval over ONE profile: a composite score and the cost |
 | `GenerateContext` | interface | The read-only context a generator sees when proposing candidates. It is the |
-| `HeldOutPromotionGateOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `MarginalLift` | interface | The marginal lift of one artifact: the with/without ablation. |
-| `MeasureMarginalLiftOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `PairStackCheck` | interface | The stacking verdict for one pair of active artifacts. |
-| `ProductionPromptGeneratorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProfileArtifact` | interface | A discrete, individually-promotable piece of an agent profile. |
 | `PromotionGate` | interface | Decides whether ONE measured candidate is promoted. The lifecycle calls this |
 | `PromotionVerdict` | interface | The verdict a gate returns for one candidate. |
 | `PromptDraft` | interface | A proposed prompt instruction line plus the WHY behind it. The `rationale` |
-| `PromptGeneratorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RunLifecycleOptions` | interface | `runLifecycle` — the ONE closed-loop orchestrator: generate → measure → |
-| `RunLifecycleResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SkillDraft` | interface | A distilled skill draft: a name + the `SKILL.md` body. |
-| `SkillGeneratorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `WorktreeBuildOptions` | interface | `worktreeBuildCandidate` — the PRODUCTION `BuildCandidate`: one fan-out leaf |
 | `ArtifactInput` | type | The input to `register` — everything on `ProfileArtifact` except the |
 | `ArtifactKind` | type | The profile levers an artifact can target. One-to-one with the §1.5 profile |
@@ -881,6 +653,8 @@ Import from `@tangle-network/agent-runtime/lifecycle` — 59 exports.
 | `RefinePrompt` | type | REFINE — incumbent-grounded rewrites. Given the lifecycle context, return |
 | `RefineSkill` | type | REFINE — improve ONE distilled draft (wording, structure, examples). The |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `BuildableGeneratorOptions`, `DedupeResult`, `DriftWatchResult`, `HeldOutPromotionGateOptions`, `MeasureMarginalLiftOptions`, `ProductionPromptGeneratorOptions`, `PromptGeneratorOptions`, `RunLifecycleResult`, `SkillGeneratorOptions`.
+
 ### Built-in agent profiles
 
 Import from `@tangle-network/agent-runtime/profiles` — 43 exports.
@@ -900,37 +674,21 @@ Import from `@tangle-network/agent-runtime/profiles` — 43 exports.
 | `readAuditRegistry` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `registerCaptures` | function | Record screenshots taken for a route in the registry, without filing a |
 | `summarizeRegistry` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `uiAuditorProfile` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `uiAuditorProfile` | function | Preset `runLoop` bundle for vision-driven UI audits: returns the `AgentRunSpec`, output adapter, validator, and prompt formatter the loop kernel needs. |
 | `writeAuditIndex` | function | Regenerate `<workspace>/index.md` from registry.json. |
 | `LENS_BRIEFS` | const | _(no summary — add a TSDoc line at the declaration)_ |
 | `SHARED_AUDITOR_RULES` | const | _(no summary — add a TSDoc line at the declaration)_ |
 | `UI_FINDING_SEVERITIES` | const | Frozen severity tuple, ordered worst → least bad for sort/report. |
 | `UI_LENSES` | const | Frozen tuple of lenses for validation + iteration. |
-| `AppendFindingsResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuditIndex` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuditRegistry` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuditRegistryCapture` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BrowserContextHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BrowserHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CoderTask` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `InProcessUiAuditClientOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `PageHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RegisterCapturesOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `UiAuditCapture` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `UiAuditCaptureRequest` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `UiAuditorProfileOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `UiAuditOutput` | interface | Output of one iteration. `findings` is the headline payload; `captures` |
 | `UiAuditTask` | interface | One iteration's task: audit a single (lens × route) pair, capturing the |
-| `UiAuditViewport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `UiFinding` | interface | A single UI audit finding — the unit of work a contributor can act on. |
 | `UiFindingScreenshot` | interface | Pointer to a screenshot referenced by a finding (workspace-relative path). |
-| `UiJudgeInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `UiJudgeOutput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `UiJudgeTokenUsage` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `UiFindingSeverity` | type | Severity scale. |
-| `UiJudge` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `UiLens` | type | Canonical audit lenses. Each lens scopes a finding to a single class of |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AppendFindingsResult`, `AuditIndex`, `AuditRegistry`, `AuditRegistryCapture`, `BrowserContextHandle`, `BrowserHandle`, `CoderTask`, `InProcessUiAuditClientOptions`, `PageHandle`, `RegisterCapturesOptions`, `UiAuditCapture`, `UiAuditCaptureRequest`, `UiAuditorProfileOptions`, `UiAuditViewport`, `UiJudgeInput`, `UiJudgeOutput`, `UiJudgeTokenUsage`, `UiJudge`.
+
 ### Platform glue
 
 Import from `@tangle-network/agent-runtime/platform` — 20 exports.
@@ -941,22 +699,13 @@ Import from `@tangle-network/agent-runtime/platform` — 20 exports.
 | `PlatformAuthError` | class | _(no summary — add a TSDoc line at the declaration)_ |
 | `PlatformHubClient` | class | _(no summary — add a TSDoc line at the declaration)_ |
 | `PlatformHubError` | class | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuthorizeUrlOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CatalogResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConnectionHealth` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ConnectionHealthResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExchangeCodeResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ExecInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `HealthCheck` | interface | Last-known health for a connection, derived from the connection row. |
-| `MintTokenInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `MintTokenResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `PlatformAuthClientOptions` | interface | Server-side client for the Tangle platform's cross-site SSO bridge. |
 | `PlatformCatalogProvider` | interface | A connectable provider in the catalog (`/v1/hub/providers`). |
 | `PlatformConnection` | interface | A live integration connection, as returned by `/v1/hub/connections`. |
 | `PlatformHubClientOptions` | interface | Server-side client for the Tangle platform's integration hub |
-| `PlatformHubStatus` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `StartAuthInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `StartAuthResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AuthorizeUrlOptions`, `CatalogResult`, `ConnectionHealth`, `ConnectionHealthResult`, `ExchangeCodeResult`, `ExecInput`, `MintTokenInput`, `MintTokenResult`, `PlatformHubStatus`, `StartAuthInput`, `StartAuthResult`.
 
 ### MCP servers — delegate / coordination / detached-session
 
@@ -980,8 +729,8 @@ Import from `@tangle-network/agent-runtime/mcp` — 170 exports.
 | `createFleetWorkspaceExecutor` | function | Build an executor that resolves each delegated iteration to an existing |
 | `createInProcessExecutor` | function | Build an in-process executor. Returns a {@link DelegationExecutor} whose `client.create()` |
 | `createInProcessTransport` | function | In-process pair of `Readable` + `Writable` streams suitable for driving |
-| `createKbGate` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `createMcpServer` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `createKbGate` | function | Build a fail-closed KB gate. The returned function runs the built-in floor |
+| `createMcpServer` | function | Stdio JSON-RPC MCP server exposing the delegation tools (`delegate`, `delegate_feedback`, `delegation_status`, `delegation_history`, optional `delegate_ui_audit`) to sandbox coding-harness agents. |
 | `createPropagatingTraceEmitter` | function | Create a LoopTraceEmitter that: |
 | `createSiblingSandboxExecutor` | function | Wrap a raw sandbox SDK client so the kernel emits |
 | `createWorktree` | function | _(no summary — add a TSDoc line at the declaration)_ |
@@ -993,8 +742,8 @@ Import from `@tangle-network/agent-runtime/mcp` — 170 exports.
 | `hashIdempotencyInput` | function | Best-effort stable hash for use as `idempotencyKey`. Not cryptographic; |
 | `liftFindings` | function | Lift validated raw rows into `AnalystFinding`s (agent-eval `makeFinding` stamps `finding_id`/ |
 | `makeCheckRunner` | function | Build a `run_analyst` runner over a kind directory. |
-| `mcpToolsForRuntimeMcp` | function | _(no summary — add a TSDoc line at the declaration)_ |
-| `mcpToolsForRuntimeMcpSubset` | function | _(no summary — add a TSDoc line at the declaration)_ |
+| `mcpToolsForRuntimeMcp` | function | Returns the queue-bound delegation tools projected into OpenAI Chat |
+| `mcpToolsForRuntimeMcpSubset` | function | Subset filter — return only the projected tools whose `function.name` |
 | `parseDetachedSessionRef` | function | _(no summary — add a TSDoc line at the declaration)_ |
 | `readTraceContextFromEnv` | function | Read trace context from the process environment. |
 | `removeWorktree` | function | _(no summary — add a TSDoc line at the declaration)_ |
@@ -1033,108 +782,34 @@ Import from `@tangle-network/agent-runtime/mcp` — 170 exports.
 | `FileDelegationStore` | class | JSON-file persistence for the delegation queue. Each write serializes |
 | `InMemoryDelegationStore` | class | _(no summary — add a TSDoc line at the declaration)_ |
 | `InMemoryFeedbackStore` | class | _(no summary — add a TSDoc line at the declaration)_ |
-| `AnalystRegistry` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CappedDelegationTrace` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `Check` | interface | One lens — a composable analyst kind. Identity fields mirror `TraceAnalystKindSpec` so a kind is |
-| `CheckRunnerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CoderReview` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CoordinationTools` | interface | The supervisor-side toolbox returned by {@link createCoordinationTools}: the MCP tool |
-| `CoordinationToolsOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CreateKbGateOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CreateWorktreeOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegateArgs` | interface | Parsed `delegate` tool arguments. |
-| `DelegateCodeArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegateCodeConfig` | interface | Minimal `CoderTask` overrides exposed over the MCP wire. The full |
-| `DelegateCodeResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateFeedbackArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateFeedbackResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateHandlerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateResearchArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateResearchConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateResearchResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateRunCtx` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateUiAuditArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateUiAuditConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegateUiAuditResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegateUiAuditRoute` | interface | Optional per-route capture spec the agent surfaces over the wire. |
-| `DelegationError` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationExecutor` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationFeedbackSnapshot` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationHistoryArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationHistoryEntry` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationHistoryResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationProgress` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegationRecord` | interface | Must be JSON-safe end to end (`args`, `result`, `error`, `feedback`) — |
-| `DelegationResumeContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegationResumeDriver` | interface | Re-attaches restored in-flight records to their detached runs. The queue |
-| `DelegationRunContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationStatusArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationStatusResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationStore` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationTaskQueueOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DelegationTraceCaps` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegationTraceCollector` | interface | Per-delegation trace collector. Buffers `LoopTraceEvent`s per runId |
 | `DelegationTraceSpan` | interface | One span of a delegation's compact trace. Flat (parent linkage by id), all |
-| `DetachedSessionDelegateOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DetachedSessionRefParts` | interface | Decoded `DelegationRecord.detachedSessionRef`. `sandboxId` is absent between |
-| `DetachedTurn` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DetachedTurnResumeDriverOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DetectExecutorArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DiffOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `DiffResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DriveTurnCapableBox` | interface | The box surface detached turns need. `SandboxInstance` |
-| `FactCandidate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FactJudge` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FactJudgeVerdict` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FeedbackEvent` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FeedbackRating` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FeedbackRefersTo` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FeedbackStore` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FileDelegationStoreOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `FleetHandle` | interface | Minimal `SandboxFleet` surface the fleet executor calls. Declared |
-| `FleetWorkspaceExecutorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `InProcessExecutorDescribePlacement` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `InProcessExecutorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `JsonRpcMessage` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `JsonRpcResponse` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `KbGateResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LocalHarnessResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `McpServer` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `McpServerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `McpToolDescriptor` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `McpTransport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `Question` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `QuestionRecord` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RemoveWorktreeOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ResearchOutputShape` | interface | Loose shape of a research output over the wire — the substrate cannot |
-| `RunDetachedTurnOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunLocalHarnessOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SettleDetachedCoderTurnOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SettledWorker` | interface | A worker the driver has drained via `await_event`. |
-| `SiblingSandboxExecutorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SubmitInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SubmitOutput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `TraceContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+| `TraceContext` | interface | Trace context propagation for MCP subprocess. |
 | `UiAuditorDelegationOutput` | interface | Wire-shape of a completed UI-audit delegation. The `findings` array |
-| `WorktreeHandle` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CoderDelegate` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `CoderReviewer` | type | _(no summary — add a TSDoc line at the declaration)_ |
+| `CoderReviewer` | type | Optional adversarial reviewer over a coder candidate that already passed |
 | `CoordinationEvent` | type | Every message on the one typed pipe. UP (child→parent): question / settled / finding — queued for |
 | `DelegateResult` | type | The synchronous result the `delegate` tool returns to the calling agent: the delivered output (or |
-| `DelegationProfile` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `DelegationResultPayload` | type | Polymorphic `result` field: `CoderOutput` when the underlying profile |
 | `DelegationResumeTick` | type | One observation of a detached run, mapped 1:1 from a single-tick driver |
-| `DelegationStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `DetachedWinnerSelection` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `DriveTurnTick` | type | Structural mirror of the sandbox SDK's `TurnDriveResult` (>= 0.6). |
 | `GitRunner` | type | Pluggable git runner (sync) — replaceable in tests. |
 | `LocalHarness` | type | Local coding harness available inside the sandbox. |
-| `MakeWorkerAgent` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `QuestionDecision` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `QuestionPolicy` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `ResearchSource` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `UiAuditorDelegate` | type | UI-auditor delegate — fully consumer-injected. agent-runtime ships no |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AnalystRegistry`, `CappedDelegationTrace`, `CheckRunnerOptions`, `CoderReview`, `CoordinationToolsOptions`, `CreateKbGateOptions`, `CreateWorktreeOptions`, `DelegateCodeArgs`, `DelegateCodeResult`, `DelegateFeedbackArgs`, `DelegateFeedbackResult`, `DelegateHandlerOptions`, `DelegateResearchArgs`, `DelegateResearchConfig`, `DelegateResearchResult`, `DelegateRunCtx`, `DelegateUiAuditArgs`, `DelegateUiAuditConfig`, `DelegateUiAuditResult`, `DelegationError`, `DelegationExecutor`, `DelegationFeedbackSnapshot`, `DelegationHistoryArgs`, `DelegationHistoryEntry`, `DelegationHistoryResult`, `DelegationProgress`, `DelegationResumeContext`, `DelegationRunContext`, `DelegationStatusArgs`, `DelegationStatusResult`, `DelegationStore`, `DelegationTaskQueueOptions`, `DelegationTraceCaps`, `DetachedSessionDelegateOptions`, `DetachedTurn`, `DetachedTurnResumeDriverOptions`, `DetectExecutorArgs`, `DiffOptions`, `DiffResult`, `FactCandidate`, `FactJudge`, `FactJudgeVerdict`, `FeedbackEvent`, `FeedbackRating`, `FeedbackRefersTo`, `FeedbackStore`, `FileDelegationStoreOptions`, `FleetWorkspaceExecutorOptions`, `InProcessExecutorDescribePlacement`, `InProcessExecutorOptions`, `JsonRpcMessage`, `JsonRpcResponse`, `KbGateResult`, `LocalHarnessResult`, `McpServer`, `McpServerOptions`, `McpToolDescriptor`, `McpTransport`, `Question`, `QuestionRecord`, `RemoveWorktreeOptions`, `RunDetachedTurnOptions`, `RunLocalHarnessOptions`, `SettleDetachedCoderTurnOptions`, `SiblingSandboxExecutorOptions`, `SubmitInput`, `SubmitOutput`, `WorktreeHandle`, `CoderDelegate`, `DelegationProfile`, `DelegationStatus`, `DetachedWinnerSelection`, `MakeWorkerAgent`, `QuestionDecision`, `QuestionPolicy`, `ResearchSource`.
+
 ## 2. agent-eval — substrate primitives to REUSE
 
 The scoring/measurement/judge substrate. **Do NOT re-implement a judge, an authenticity check, a verifier, a statistics routine, a profile-matrix runner, or usage extraction** — import them from here. The category→subpath mapping is curated; the symbols are generated.
@@ -1171,11 +846,10 @@ Import from `@tangle-network/agent-eval` — 30 exports.
 | `adversarialJudge` | const | Adversarial judge — red-teams agent responses. |
 | `codeExecutionJudge` | const | Code execution judge — evaluates whether code blocks are valid and runnable. |
 | `coherenceJudge` | const | Coherence judge — evaluates multi-turn consistency and progression. |
-| `CalibrationResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ContinuousCalibrationResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `JudgeConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CachedJudge` | type | The wrapped judge: same `JudgeConfig` seam, plus hit/miss observability. |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `CalibrationResult`, `ContinuousCalibrationResult`, `JudgeConfig`.
+
 ### AUTHENTICITY — is-this-real / anti-Goodhart gate
 
 Import from `@tangle-network/agent-eval/authenticity` — 14 exports.
@@ -1187,15 +861,10 @@ Import from `@tangle-network/agent-eval/authenticity` — 14 exports.
 | `scoreAuthenticity` | function | Deterministic authenticity scan of produced files. Pure — same files in, |
 | `scoreAuthenticityNuance` | function | LLM nuance scoring — judges the "looks real but is hollow" axis structure |
 | `scoreRealnessBlended` | function | Score realness using the cheapest sufficient signal: trust the deterministic |
-| `AuthenticityNuance` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuthenticityResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AuthenticitySignals` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BlendedRealness` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProducedFile` | interface | Authenticity — "is this real, or convincing BS?" |
-| `RealnessGate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RealnessJudgment` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CompleteFn` | type | A minimal completion fn — inject your model caller (router/tcloud). Keeps |
-| `RealnessBand` | type | _(no summary — add a TSDoc line at the declaration)_ |
+
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AuthenticityNuance`, `AuthenticityResult`, `AuthenticitySignals`, `BlendedRealness`, `RealnessGate`, `RealnessJudgment`, `RealnessBand`.
 
 ### VERIFICATION — multi-layer verifier + semantic grading
 
@@ -1209,11 +878,11 @@ Import from `@tangle-network/agent-eval` — 10 exports.
 | `verifyCompletion` | function | Verify whether a run completed the task. `checkCorrectness` is injected — |
 | `verifyManifest` | function | Verify that a signed manifest has not been tampered with. |
 | `MultiLayerVerifier` | class | _(no summary — add a TSDoc line at the declaration)_ |
-| `Finding` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `VerificationReport` | interface | Extends the substrate verdict spine: `valid` = `allPass` and `score` = |
-| `VerifyOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LayerStatus` | type | Multi-layer verifier — ordered pipeline of verification layers. |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `Finding`, `VerifyOptions`.
+
 ### STATISTICS — significance, intervals, effect size
 
 Import from `@tangle-network/agent-eval` — 49 exports.
@@ -1251,24 +920,11 @@ Import from `@tangle-network/agent-eval` — 49 exports.
 | `wilcoxonSignedRank` | function | Wilcoxon signed-rank test — paired non-parametric alternative. |
 | `wilson` | function | Wilson score interval for a binomial proportion. Correct at small n and near |
 | `normalizeScores` | const | Identity: dimensions already follow "higher = better" by prompt convention |
-| `BootstrapOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BootstrapResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CorpusAgreementOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CorpusAgreementPerDimension` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CorpusAgreementReport` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CorpusScoreRecord` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EProcess` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EProcessOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EProcessState` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EProcessStep` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `McNemarResult` | interface | Result of a McNemar paired-binary significance test. |
-| `PairedBootstrapOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `PairedBootstrapResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProportionInterval` | interface | A binomial proportion estimate with a confidence interval. |
 | `RiskDifferenceResult` | interface | A paired binary effect size (treatment rate − control rate) with a CI. |
-| `WeightedCompositeInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `WeightedCompositeResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CliffsMagnitude` | type | _(no summary — add a TSDoc line at the declaration)_ |
+
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `BootstrapOptions`, `BootstrapResult`, `CorpusAgreementOptions`, `CorpusAgreementPerDimension`, `CorpusAgreementReport`, `CorpusScoreRecord`, `EProcess`, `EProcessOptions`, `EProcessState`, `EProcessStep`, `PairedBootstrapOptions`, `PairedBootstrapResult`, `WeightedCompositeInput`, `WeightedCompositeResult`, `CliffsMagnitude`.
 
 ### CAMPAIGN — profile matrix, gates, improvement loop
 
@@ -1344,131 +1000,60 @@ Import from `@tangle-network/agent-eval/campaign` — 206 exports.
 | `ProfileMatrixError` | class | Thrown when the matrix is misconfigured (no profiles, a profile whose model |
 | `SkillPatchParseError` | class | Parse + validate the patch response. Throws `SkillPatchParseError` when the |
 | `WorktreeAdapterError` | class | _(no summary — add a TSDoc line at the declaration)_ |
-| `AcceptedEdit` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AceProposerOptions` | interface | `aceProposer` — Agentic Context Engineering: an APPEND-MOSTLY curator, the |
 | `AnalystArtifact` | interface | The analyst's output for one scenario — the artifact the judge scores. |
 | `AnalystScenario` | interface | A labeled trace scenario: a FIXED trace corpus plus the failure modes a |
-| `ApplySkillPatchResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `AxisEvidence` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BuildAnalystSurfaceDispatchOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BuildEvidenceVectorOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `BuildLoopProvenanceArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CampaignAggregates` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CampaignArtifactWriter` | interface | Scoped artifact writer — `write(path, content)` lands under |
-| `CampaignBreakdown` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `CampaignCellResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CampaignCostMeter` | interface | Cell-scoped cost meter. NOTHING is captured automatically — |
-| `CampaignResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `CampaignStorage` | interface | `CampaignStorage` — the filesystem seam `runCampaign` writes through |
 | `CampaignTraceWriter` | interface | Scoped trace writer handed to each dispatch — every span |
 | `CodeSurface` | interface | A tier-4 code surface — a candidate change to the agent's |
-| `CompareProposersOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DefaultProductionGateOptions` | interface | `defaultProductionGate` — composes the substrate's existing safety |
-| `DimensionRegression` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `DispatchContext` | interface | Context handed to every dispatch invocation. Scoped — every |
-| `EmitLoopProvenanceArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EmitLoopProvenanceResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `EvidenceVector` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `EvolutionaryProposerOptions` | interface | `evolutionaryProposer` — adapts a stateless `Mutator` (population mutation: |
-| `FailureModeRecallJudgeOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FapoAttributionSignals` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `FapoEntryConfig` | interface | FAPO reviewed-escalation policy. This is an orchestration layer over |
-| `FapoFailureCluster` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FapoProposerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FapoReviewInput` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FapoReviewIssue` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FapoReviewResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `FapoScopeContract` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `FsLabeledScenarioStoreOptions` | interface | Filesystem `LabeledScenarioStore` adapter. The default capture sink for |
 | `Gate` | interface | Composable promotion gate. |
-| `GateContext` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `GateResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `GenerationCandidate` | interface | One scored candidate surface in a generation. `dimensions` + `scenarios` |
-| `GenerationRecord` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `GepaProposerConstraints` | interface | `gepaProposer` — a reflective `SurfaceProposer` for prompt-tier surfaces. |
-| `GepaProposerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `GitWorktreeAdapterOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `HaloProposerOptions` | interface | `haloProposer` — wraps the REAL halo-engine (Inference.net's hierarchical |
 | `HeldOutGateOptions` | interface | Thin Gate adapter — exposes delta-threshold-on-holdout as a composable |
-| `HeldoutSignificance` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `HeldoutSignificanceOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `JudgeAggregate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `JudgeConfig` | interface | Pluggable dimensional scorer. `score` is the contract: |
-| `JudgeDimension` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `JudgeScore` | interface | The canonical judge verdict shape — one declaration, shared by campaign |
-| `LabeledScenarioRecord` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LabeledScenarioSampleArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LabeledScenarioStore` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LabeledScenarioWrite` | interface | Required-provenance write. The store rejects writes that |
-| `LlmJudgeOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopProvenanceBackend` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `LoopProvenanceCandidate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `LoopProvenanceRecord` | interface | The durable provenance record. Aligns to the hosted `EvalRunEvent` path but |
 | `MemoryCurationProposerOptions` | interface | `memoryCurationProposer` — a CURATOR `SurfaceProposer`, the complement to the |
 | `Mutator` | interface | Stateless surface mutation — given findings + current |
 | `OpenAutoPrOptions` | interface | `openAutoPr` — thin shell-out helper for the `runImprovementLoop` preset's |
-| `OpenAutoPrResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `OptimizerConfig` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `OptimizerEntryConfig` | interface | Shared corpus + transport for the three built-in optimizer entries. |
 | `PairedHoldout` | interface | Statistical held-out promotion machinery — the trustworthy core the |
-| `ParameterCandidate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ParameterChange` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ParameterSweepProposerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ParetoParent` | interface | A non-dominated parent on the GEPA Pareto frontier — a |
-| `ParetoSignificanceGateOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `PlaybackContext` | interface | Dispatch context plus the profile under test (which cheap model, etc.). |
 | `PlaybackDriver` | interface | Drives the real product through a story and returns the runtime event stream |
 | `PlaybackStep` | interface | One step of a user story — what the user does. The driver interprets |
-| `ProfileSummary` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `PromotionObjective` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProposeContext` | interface | Everything a proposer may read to plan the next |
 | `ProposedCandidate` | interface | A proposer output carrying the surface AND the WHY behind |
-| `ProposePatchesArgs` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ProposerComparison` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ProposerEntry` | interface | What an optimizer produced: the surface it promoted + what it cost to get |
-| `ProposerPairwise` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ProposerScore` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RejectedEdit` | interface | A patch that was tried and not accepted — fed back to the model so it does |
 | `RunCampaignOptions` | interface | `runCampaign` — Pass A substrate primitive. ONE function that orchestrates |
 | `RunEvalOptions` | interface | `runEval` — the simplest preset over `runCampaign`. No optimizer, no |
-| `RunImprovementLoopResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunOptimizationResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunProfileMatrixOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunProfileMatrixResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `RunSkillOptOptions` | interface | `runSkillOpt` — the SkillOpt epoch hill-climb (Microsoft, arXiv:2605.23904). |
-| `RunSkillOptResult` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `Scenario` | interface | Stable identifier + kind tag for any scenario. Consumers |
-| `ScenarioAggregate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ScenarioRollup` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `ScoreboardRenderOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `ScoreboardRow` | interface | One row of the launch scoreboard — story × requirement → PASS/FAIL. |
 | `ScoreboardSummary` | interface | Launch-readiness headline counts rolled up from the per-requirement rows. |
-| `SequentialDecideFn` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SequentialDecideOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SequentialObservation` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SequentialPairedGate` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SequentialPairedGateOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SessionScript` | interface | One session within a multi-session journey. Dispatch is |
-| `SkillOptEpochRecord` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SkillOptEvidence` | interface | Evidence the optimizer reflects on: where the current surface is weakest. |
-| `SkillOptProposer` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `SkillOptProposerOptions` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SkillPatch` | interface | A named, attributable bundle of ops the optimizer proposes as one edit. |
-| `SkillPatchRejection` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `SurfaceProposer` | interface | A surface-improvement strategy. Given the current best |
 | `TraceAnalystProposerOptions` | interface | `traceAnalystProposer` — wraps agent-eval's OWN trace-analyst engine |
-| `TraceSpan` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `UserStory` | interface | A user story = a runnable product journey plus the requirements that define |
 | `UserStoryVerdict` | interface | A scored user story — the completion verdict plus its human title. |
 | `Worktree` | interface | VCS-pluggable worktree adapter. One improvement = one worktree, PR-like |
-| `WorktreeAdapter` | interface | _(no summary — add a TSDoc line at the declaration)_ |
 | `AxisVerdict` | type | Per-axis verdict from the good-direction paired bootstrap. |
 | `CampaignTokenUsage` | type | Token usage accumulated for a cell. Aliased to the canonical `RunTokenUsage` |
 | `DispatchFn` | type | One function: scenario + ctx → artifact. Dispatcher chooses |
 | `FapoOptimizationLevel` | type | FAPO (Fully Autonomous Prompt Optimization) is an orchestration policy, not |
 | `GateDecision` | type | Five-valued verdict taxonomy (MOSS-paper alignment). |
-| `JsonPrimitive` | type | _(no summary — add a TSDoc line at the declaration)_ |
-| `JsonValue` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `LabeledScenarioSource` | type | Source tag — required on every store write. Used by the |
 | `LabelTrust` | type | How much a label can be trusted to evaluate against — the gold-admission |
 | `LlmJudgeDimension` | type | A rubric dimension as a bare key or the full `{ key, description }` shape. A |
@@ -1477,12 +1062,12 @@ Import from `@tangle-network/agent-eval/campaign` — 206 exports.
 | `OptimizationProposer` | type | Optional vocabulary alias. The loop is the optimizer; this object is the |
 | `ProfileDispatchFn` | type | Dispatch for one cell: render `profile` against `scenario`, returning the |
 | `PromotionPolicy` | type | A promotion strategy: a pure function from the evidence vector to a verdict. |
-| `RedactionStatus` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `RunImprovementLoopOptions` | type | `runImprovementLoop` — the gated-promotion shell around the improvement |
-| `RunOptimizationOptions` | type | _(no summary — add a TSDoc line at the declaration)_ |
 | `SequentialDecision` | type | Anytime-valid sequential promotion gate — an e-process (betting |
 | `SkillPatchOp` | type | A single bounded edit against a skill surface. |
 
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `AcceptedEdit`, `ApplySkillPatchResult`, `AxisEvidence`, `BuildAnalystSurfaceDispatchOptions`, `BuildEvidenceVectorOptions`, `BuildLoopProvenanceArgs`, `CampaignAggregates`, `CampaignBreakdown`, `CampaignCellResult`, `CampaignResult`, `CompareProposersOptions`, `DimensionRegression`, `EmitLoopProvenanceArgs`, `EmitLoopProvenanceResult`, `EvidenceVector`, `FailureModeRecallJudgeOptions`, `FapoAttributionSignals`, `FapoFailureCluster`, `FapoProposerOptions`, `FapoReviewInput`, `FapoReviewIssue`, `FapoReviewResult`, `FapoScopeContract`, `GateContext`, `GateResult`, `GenerationRecord`, `GepaProposerOptions`, `GitWorktreeAdapterOptions`, `HeldoutSignificance`, `HeldoutSignificanceOptions`, `JudgeAggregate`, `JudgeDimension`, `LabeledScenarioRecord`, `LabeledScenarioSampleArgs`, `LabeledScenarioStore`, `LlmJudgeOptions`, `LoopProvenanceBackend`, `LoopProvenanceCandidate`, `OpenAutoPrResult`, `OptimizerConfig`, `ParameterCandidate`, `ParameterChange`, `ParameterSweepProposerOptions`, `ParetoSignificanceGateOptions`, `ProfileSummary`, `PromotionObjective`, `ProposePatchesArgs`, `ProposerComparison`, `ProposerPairwise`, `ProposerScore`, `RunImprovementLoopResult`, `RunOptimizationResult`, `RunProfileMatrixOptions`, `RunProfileMatrixResult`, `RunSkillOptResult`, `ScenarioAggregate`, `ScenarioRollup`, `ScoreboardRenderOptions`, `SequentialDecideFn`, `SequentialDecideOptions`, `SequentialObservation`, `SequentialPairedGate`, `SequentialPairedGateOptions`, `SkillOptEpochRecord`, `SkillOptProposer`, `SkillOptProposerOptions`, `SkillPatchRejection`, `TraceSpan`, `WorktreeAdapter`, `JsonPrimitive`, `JsonValue`, `RedactionStatus`, `RunOptimizationOptions`.
+
 ### TOKEN / USAGE — usage extraction + run-record usage types
 
 Import from `@tangle-network/agent-eval` — 5 exports.
@@ -1492,5 +1077,5 @@ Import from `@tangle-network/agent-eval` — 5 exports.
 | `extractUsage` | function | Pull `{ input, output, cached? }` from a parsed chat-completions response |
 | `extractUsageFromResponse` | function | Extract usage from an HTTP `Response` without consuming the caller's body: |
 | `extractUsageFromSse` | function | Sum token usage across an SSE response body. Each `data:` line is parsed and |
-| `LlmUsage` | interface | _(no summary — add a TSDoc line at the declaration)_ |
-| `RunTokenUsage` | interface | _(no summary — add a TSDoc line at the declaration)_ |
+
+**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): `LlmUsage`, `RunTokenUsage`.
diff --git a/docs/api/profiles.md b/docs/api/profiles.md
index 7f20e2b5..cdbc7863 100644
--- a/docs/api/profiles.md
+++ b/docs/api/profiles.md
@@ -10,7 +10,7 @@
 
 ### AuditRegistry
 
-Defined in: [audit/issue-writer.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L30)
+Defined in: [audit/issue-writer.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L31)
 
 **`Experimental`**
 
@@ -20,7 +20,7 @@ Defined in: [audit/issue-writer.ts:30](https://github.com/tangle-network/agent-r
 
 > **schemaVersion**: `1`
 
-Defined in: [audit/issue-writer.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L31)
+Defined in: [audit/issue-writer.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L32)
 
 **`Experimental`**
 
@@ -28,7 +28,7 @@ Defined in: [audit/issue-writer.ts:31](https://github.com/tangle-network/agent-r
 
 > **findings**: [`UiFinding`](#uifinding)[]
 
-Defined in: [audit/issue-writer.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L32)
+Defined in: [audit/issue-writer.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L33)
 
 **`Experimental`**
 
@@ -36,7 +36,7 @@ Defined in: [audit/issue-writer.ts:32](https://github.com/tangle-network/agent-r
 
 > **routes**: `Record`\<`string`, \{ `url?`: `string`; `captures`: [`AuditRegistryCapture`](#auditregistrycapture)[]; \}\>
 
-Defined in: [audit/issue-writer.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L34)
+Defined in: [audit/issue-writer.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L35)
 
 **`Experimental`**
 
@@ -46,7 +46,7 @@ Route → URL + captures sidecar; preserved across runs.
 
 ### AuditRegistryCapture
 
-Defined in: [audit/issue-writer.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L38)
+Defined in: [audit/issue-writer.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L39)
 
 **`Experimental`**
 
@@ -56,7 +56,7 @@ Defined in: [audit/issue-writer.ts:38](https://github.com/tangle-network/agent-r
 
 > **file**: `string`
 
-Defined in: [audit/issue-writer.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L39)
+Defined in: [audit/issue-writer.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L40)
 
 **`Experimental`**
 
@@ -64,7 +64,7 @@ Defined in: [audit/issue-writer.ts:39](https://github.com/tangle-network/agent-r
 
 > `optional` **viewport?**: `string`
 
-Defined in: [audit/issue-writer.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L40)
+Defined in: [audit/issue-writer.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L41)
 
 **`Experimental`**
 
@@ -72,7 +72,7 @@ Defined in: [audit/issue-writer.ts:40](https://github.com/tangle-network/agent-r
 
 > `optional` **fullPage?**: `boolean`
 
-Defined in: [audit/issue-writer.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L41)
+Defined in: [audit/issue-writer.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L42)
 
 **`Experimental`**
 
@@ -80,7 +80,7 @@ Defined in: [audit/issue-writer.ts:41](https://github.com/tangle-network/agent-r
 
 > `optional` **elementSelector?**: `string`
 
-Defined in: [audit/issue-writer.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L42)
+Defined in: [audit/issue-writer.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L43)
 
 **`Experimental`**
 
@@ -88,7 +88,7 @@ Defined in: [audit/issue-writer.ts:42](https://github.com/tangle-network/agent-r
 
 > **capturedAt**: `string`
 
-Defined in: [audit/issue-writer.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L43)
+Defined in: [audit/issue-writer.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L44)
 
 **`Experimental`**
 
@@ -96,7 +96,7 @@ Defined in: [audit/issue-writer.ts:43](https://github.com/tangle-network/agent-r
 
 ### AppendFindingsResult
 
-Defined in: [audit/issue-writer.ts:254](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L254)
+Defined in: [audit/issue-writer.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L255)
 
 **`Experimental`**
 
@@ -106,7 +106,7 @@ Defined in: [audit/issue-writer.ts:254](https://github.com/tangle-network/agent-
 
 > **written**: [`UiFinding`](#uifinding)[]
 
-Defined in: [audit/issue-writer.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L256)
+Defined in: [audit/issue-writer.ts:257](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L257)
 
 **`Experimental`**
 
@@ -116,7 +116,7 @@ Findings with id + createdAt assigned, in input order.
 
 > **files**: `string`[]
 
-Defined in: [audit/issue-writer.ts:258](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L258)
+Defined in: [audit/issue-writer.ts:259](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L259)
 
 **`Experimental`**
 
@@ -126,7 +126,7 @@ Workspace-relative path to each issue Markdown file, in input order.
 
 ### RegisterCapturesOptions
 
-Defined in: [audit/issue-writer.ts:336](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L336)
+Defined in: [audit/issue-writer.ts:337](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L337)
 
 **`Experimental`**
 
@@ -136,7 +136,7 @@ Defined in: [audit/issue-writer.ts:336](https://github.com/tangle-network/agent-
 
 > **route**: `string`
 
-Defined in: [audit/issue-writer.ts:337](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L337)
+Defined in: [audit/issue-writer.ts:338](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L338)
 
 **`Experimental`**
 
@@ -144,7 +144,7 @@ Defined in: [audit/issue-writer.ts:337](https://github.com/tangle-network/agent-
 
 > `optional` **url?**: `string`
 
-Defined in: [audit/issue-writer.ts:338](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L338)
+Defined in: [audit/issue-writer.ts:339](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L339)
 
 **`Experimental`**
 
@@ -152,7 +152,7 @@ Defined in: [audit/issue-writer.ts:338](https://github.com/tangle-network/agent-
 
 > **captures**: readonly [`AuditRegistryCapture`](#auditregistrycapture)[]
 
-Defined in: [audit/issue-writer.ts:339](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L339)
+Defined in: [audit/issue-writer.ts:340](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L340)
 
 **`Experimental`**
 
@@ -160,7 +160,7 @@ Defined in: [audit/issue-writer.ts:339](https://github.com/tangle-network/agent-
 
 ### AuditIndex
 
-Defined in: [audit/issue-writer.ts:369](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L369)
+Defined in: [audit/issue-writer.ts:370](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L370)
 
 **`Experimental`**
 
@@ -170,7 +170,7 @@ Defined in: [audit/issue-writer.ts:369](https://github.com/tangle-network/agent-
 
 > **total**: `number`
 
-Defined in: [audit/issue-writer.ts:371](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L371)
+Defined in: [audit/issue-writer.ts:372](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L372)
 
 **`Experimental`**
 
@@ -180,7 +180,7 @@ Total findings in the workspace.
 
 > **bySeverity**: `Record`\<[`UiFinding`](#uifinding)\[`"severity"`\], `number`\>
 
-Defined in: [audit/issue-writer.ts:372](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L372)
+Defined in: [audit/issue-writer.ts:373](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L373)
 
 **`Experimental`**
 
@@ -188,7 +188,7 @@ Defined in: [audit/issue-writer.ts:372](https://github.com/tangle-network/agent-
 
 > **byLens**: `Partial`\<`Record`\<[`UiLens`](#uilens), `number`\>\>
 
-Defined in: [audit/issue-writer.ts:373](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L373)
+Defined in: [audit/issue-writer.ts:374](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L374)
 
 **`Experimental`**
 
@@ -196,7 +196,7 @@ Defined in: [audit/issue-writer.ts:373](https://github.com/tangle-network/agent-
 
 > **byRoute**: `Record`\<`string`, `number`\>
 
-Defined in: [audit/issue-writer.ts:374](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L374)
+Defined in: [audit/issue-writer.ts:375](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L375)
 
 **`Experimental`**
 
@@ -204,7 +204,7 @@ Defined in: [audit/issue-writer.ts:374](https://github.com/tangle-network/agent-
 
 ### CoderTask
 
-Defined in: [profiles/coder.ts:15](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L15)
+Defined in: [profiles/coder.ts:16](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L16)
 
 **`Experimental`**
 
@@ -216,7 +216,7 @@ The per-task inputs `coderTaskToPrompt` renders + the worktree gate enforces.
 
 > **goal**: `string`
 
-Defined in: [profiles/coder.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L17)
+Defined in: [profiles/coder.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L18)
 
 **`Experimental`**
 
@@ -226,7 +226,7 @@ What the agent must accomplish. Free-form prose.
 
 > **repoRoot**: `string`
 
-Defined in: [profiles/coder.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L19)
+Defined in: [profiles/coder.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L20)
 
 **`Experimental`**
 
@@ -236,7 +236,7 @@ Absolute path inside the sandbox where the repo lives.
 
 > `optional` **baseBranch?**: `string`
 
-Defined in: [profiles/coder.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L21)
+Defined in: [profiles/coder.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L22)
 
 **`Experimental`**
 
@@ -246,7 +246,7 @@ Default `main`. The branch the agent diffs against.
 
 > `optional` **testCmd?**: `string`
 
-Defined in: [profiles/coder.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L23)
+Defined in: [profiles/coder.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L24)
 
 **`Experimental`**
 
@@ -256,7 +256,7 @@ Default `pnpm test --run`.
 
 > `optional` **typecheckCmd?**: `string`
 
-Defined in: [profiles/coder.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L25)
+Defined in: [profiles/coder.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L26)
 
 **`Experimental`**
 
@@ -266,7 +266,7 @@ Default `pnpm typecheck`.
 
 > `optional` **contextFiles?**: `string`[]
 
-Defined in: [profiles/coder.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L27)
+Defined in: [profiles/coder.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L28)
 
 **`Experimental`**
 
@@ -276,7 +276,7 @@ Files the agent may inspect for context. Surfaced verbatim in the prompt.
 
 > `optional` **forbiddenPaths?**: `string`[]
 
-Defined in: [profiles/coder.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L32)
+Defined in: [profiles/coder.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L33)
 
 **`Experimental`**
 
@@ -287,7 +287,7 @@ Use glob-free literal path prefixes for unambiguous enforcement.
 
 > `optional` **maxDiffLines?**: `number`
 
-Defined in: [profiles/coder.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L34)
+Defined in: [profiles/coder.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L35)
 
 **`Experimental`**
 
@@ -297,7 +297,7 @@ Default 400. Hard cap; the gate hard-fails when exceeded.
 
 ### InProcessUiAuditClientOptions
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L45)
+Defined in: [profiles/ui-auditor/in-process-client.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L46)
 
 **`Experimental`**
 
@@ -307,7 +307,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:45](https://github.com/tan
 
 > **workspaceDir**: `string`
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L51)
+Defined in: [profiles/ui-auditor/in-process-client.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L52)
 
 **`Experimental`**
 
@@ -319,7 +319,7 @@ are workspace-relative (`screenshots/<filename>`).
 
 > **judge**: [`UiJudge`](#uijudge)
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L53)
+Defined in: [profiles/ui-auditor/in-process-client.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L54)
 
 **`Experimental`**
 
@@ -329,7 +329,7 @@ The vision judge that turns captures into findings.
 
 > `optional` **navPolicy?**: `"strict"` \| `"spa"`
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L62)
+Defined in: [profiles/ui-auditor/in-process-client.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L63)
 
 **`Experimental`**
 
@@ -344,7 +344,7 @@ connections and never settle.
 
 > `optional` **launchBrowser?**: () => `Promise`\<[`BrowserHandle`](#browserhandle)\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L68)
+Defined in: [profiles/ui-auditor/in-process-client.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L69)
 
 **`Experimental`**
 
@@ -360,7 +360,7 @@ different channel, or a fleet adapter.
 
 ### BrowserHandle
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L72)
+Defined in: [profiles/ui-auditor/in-process-client.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L73)
 
 **`Experimental`**
 
@@ -370,7 +370,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:72](https://github.com/tan
 
 > **newContext**(`options?`): `Promise`\<[`BrowserContextHandle`](#browsercontexthandle)\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L73)
+Defined in: [profiles/ui-auditor/in-process-client.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L74)
 
 **`Experimental`**
 
@@ -398,7 +398,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:73](https://github.com/tan
 
 > **close**(): `Promise`\<`void`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L76)
+Defined in: [profiles/ui-auditor/in-process-client.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L77)
 
 **`Experimental`**
 
@@ -410,7 +410,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:76](https://github.com/tan
 
 ### BrowserContextHandle
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L80)
+Defined in: [profiles/ui-auditor/in-process-client.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L81)
 
 **`Experimental`**
 
@@ -420,7 +420,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:80](https://github.com/tan
 
 > **newPage**(): `Promise`\<[`PageHandle`](#pagehandle)\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L81)
+Defined in: [profiles/ui-auditor/in-process-client.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L82)
 
 **`Experimental`**
 
@@ -432,7 +432,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:81](https://github.com/tan
 
 > **close**(): `Promise`\<`void`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L82)
+Defined in: [profiles/ui-auditor/in-process-client.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L83)
 
 **`Experimental`**
 
@@ -444,7 +444,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:82](https://github.com/tan
 
 ### PageHandle
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L86)
+Defined in: [profiles/ui-auditor/in-process-client.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L87)
 
 **`Experimental`**
 
@@ -454,7 +454,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:86](https://github.com/tan
 
 > **setViewportSize**(`size`): `Promise`\<`void`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L87)
+Defined in: [profiles/ui-auditor/in-process-client.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L88)
 
 **`Experimental`**
 
@@ -478,7 +478,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:87](https://github.com/tan
 
 > **goto**(`url`, `options?`): `Promise`\<`unknown`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L88)
+Defined in: [profiles/ui-auditor/in-process-client.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L89)
 
 **`Experimental`**
 
@@ -506,7 +506,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:88](https://github.com/tan
 
 > **waitForSelector**(`selector`, `options?`): `Promise`\<`unknown`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L89)
+Defined in: [profiles/ui-auditor/in-process-client.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L90)
 
 **`Experimental`**
 
@@ -530,7 +530,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:89](https://github.com/tan
 
 > **waitForTimeout**(`ms`): `Promise`\<`void`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L90)
+Defined in: [profiles/ui-auditor/in-process-client.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L91)
 
 **`Experimental`**
 
@@ -548,7 +548,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:90](https://github.com/tan
 
 > **screenshot**(`options`): `Promise`\<`void`\>
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L91)
+Defined in: [profiles/ui-auditor/in-process-client.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L92)
 
 **`Experimental`**
 
@@ -572,7 +572,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:91](https://github.com/tan
 
 > **locator**(`selector`): `object`
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L92)
+Defined in: [profiles/ui-auditor/in-process-client.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L93)
 
 **`Experimental`**
 
@@ -614,7 +614,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:92](https://github.com/tan
 
 ### UiJudgeTokenUsage
 
-Defined in: [profiles/ui-auditor/judge.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L30)
+Defined in: [profiles/ui-auditor/judge.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L31)
 
 **`Experimental`**
 
@@ -624,7 +624,7 @@ Defined in: [profiles/ui-auditor/judge.ts:30](https://github.com/tangle-network/
 
 > **input**: `number`
 
-Defined in: [profiles/ui-auditor/judge.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L31)
+Defined in: [profiles/ui-auditor/judge.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L32)
 
 **`Experimental`**
 
@@ -632,7 +632,7 @@ Defined in: [profiles/ui-auditor/judge.ts:31](https://github.com/tangle-network/
 
 > **output**: `number`
 
-Defined in: [profiles/ui-auditor/judge.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L32)
+Defined in: [profiles/ui-auditor/judge.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L33)
 
 **`Experimental`**
 
@@ -640,7 +640,7 @@ Defined in: [profiles/ui-auditor/judge.ts:32](https://github.com/tangle-network/
 
 ### UiJudgeInput
 
-Defined in: [profiles/ui-auditor/judge.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L36)
+Defined in: [profiles/ui-auditor/judge.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L37)
 
 **`Experimental`**
 
@@ -650,7 +650,7 @@ Defined in: [profiles/ui-auditor/judge.ts:36](https://github.com/tangle-network/
 
 > **lens**: [`UiLens`](#uilens)
 
-Defined in: [profiles/ui-auditor/judge.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L37)
+Defined in: [profiles/ui-auditor/judge.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L38)
 
 **`Experimental`**
 
@@ -658,7 +658,7 @@ Defined in: [profiles/ui-auditor/judge.ts:37](https://github.com/tangle-network/
 
 > **captures**: readonly [`UiAuditCapture`](#uiauditcapture)[]
 
-Defined in: [profiles/ui-auditor/judge.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L38)
+Defined in: [profiles/ui-auditor/judge.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L39)
 
 **`Experimental`**
 
@@ -666,7 +666,7 @@ Defined in: [profiles/ui-auditor/judge.ts:38](https://github.com/tangle-network/
 
 > `optional` **productContext?**: `string`
 
-Defined in: [profiles/ui-auditor/judge.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L40)
+Defined in: [profiles/ui-auditor/judge.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L41)
 
 **`Experimental`**
 
@@ -676,7 +676,7 @@ Free-form product context the consumer wants the judge to know.
 
 > `optional` **knownFindingIds?**: readonly `number`[]
 
-Defined in: [profiles/ui-auditor/judge.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L42)
+Defined in: [profiles/ui-auditor/judge.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L43)
 
 **`Experimental`**
 
@@ -686,7 +686,7 @@ Findings already on file across earlier iterations — for similarTo linkage.
 
 > **promptText**: `string`
 
-Defined in: [profiles/ui-auditor/judge.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L44)
+Defined in: [profiles/ui-auditor/judge.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L45)
 
 **`Experimental`**
 
@@ -696,7 +696,7 @@ The full prompt the loop kernel synthesized for this iteration.
 
 > **signal**: `AbortSignal`
 
-Defined in: [profiles/ui-auditor/judge.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L46)
+Defined in: [profiles/ui-auditor/judge.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L47)
 
 **`Experimental`**
 
@@ -706,7 +706,7 @@ Cooperative cancellation.
 
 ### UiJudgeOutput
 
-Defined in: [profiles/ui-auditor/judge.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L50)
+Defined in: [profiles/ui-auditor/judge.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L51)
 
 **`Experimental`**
 
@@ -716,7 +716,7 @@ Defined in: [profiles/ui-auditor/judge.ts:50](https://github.com/tangle-network/
 
 > **findings**: [`UiFinding`](#uifinding)[]
 
-Defined in: [profiles/ui-auditor/judge.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L51)
+Defined in: [profiles/ui-auditor/judge.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L52)
 
 **`Experimental`**
 
@@ -724,7 +724,7 @@ Defined in: [profiles/ui-auditor/judge.ts:51](https://github.com/tangle-network/
 
 > `optional` **notes?**: `string`
 
-Defined in: [profiles/ui-auditor/judge.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L53)
+Defined in: [profiles/ui-auditor/judge.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L54)
 
 **`Experimental`**
 
@@ -734,7 +734,7 @@ Optional triage commentary.
 
 > `optional` **tokenUsage?**: [`UiJudgeTokenUsage`](#uijudgetokenusage)
 
-Defined in: [profiles/ui-auditor/judge.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L55)
+Defined in: [profiles/ui-auditor/judge.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L56)
 
 **`Experimental`**
 
@@ -744,7 +744,7 @@ Optional usage; folded into the kernel cost ledger when present.
 
 > `optional` **costUsd?**: `number`
 
-Defined in: [profiles/ui-auditor/judge.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L57)
+Defined in: [profiles/ui-auditor/judge.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L58)
 
 **`Experimental`**
 
@@ -754,7 +754,7 @@ Optional total cost in USD.
 
 ### UiAuditorProfileOptions
 
-Defined in: [profiles/ui-auditor/profile.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L22)
+Defined in: [profiles/ui-auditor/profile.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L23)
 
 **`Experimental`**
 
@@ -764,7 +764,7 @@ Defined in: [profiles/ui-auditor/profile.ts:22](https://github.com/tangle-networ
 
 > `optional` **name?**: `string`
 
-Defined in: [profiles/ui-auditor/profile.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L26)
+Defined in: [profiles/ui-auditor/profile.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L27)
 
 **`Experimental`**
 
@@ -774,7 +774,7 @@ Stable name surfaced in trace events. Defaults to `ui-auditor`.
 
 > `optional` **model?**: `string`
 
-Defined in: [profiles/ui-auditor/profile.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L31)
+Defined in: [profiles/ui-auditor/profile.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L32)
 
 **`Experimental`**
 
@@ -785,7 +785,7 @@ The consumer's `SandboxClient` chooses how to interpret it.
 
 > `optional` **task?**: [`UiAuditTask`](#uiaudittask)
 
-Defined in: [profiles/ui-auditor/profile.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L37)
+Defined in: [profiles/ui-auditor/profile.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L38)
 
 **`Experimental`**
 
@@ -797,7 +797,7 @@ use; less strict than passing the task explicitly.
 
 ### UiFindingScreenshot
 
-Defined in: [profiles/ui-auditor/substrate.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L68)
+Defined in: [profiles/ui-auditor/substrate.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L69)
 
 Pointer to a screenshot referenced by a finding (workspace-relative path).
 
@@ -807,25 +807,25 @@ Pointer to a screenshot referenced by a finding (workspace-relative path).
 
 > **path**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L69)
+Defined in: [profiles/ui-auditor/substrate.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L70)
 
 ##### viewport?
 
 > `optional` **viewport?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L70)
+Defined in: [profiles/ui-auditor/substrate.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L71)
 
 ##### label?
 
 > `optional` **label?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L71)
+Defined in: [profiles/ui-auditor/substrate.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L72)
 
 ***
 
 ### UiFinding
 
-Defined in: [profiles/ui-auditor/substrate.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L81)
+Defined in: [profiles/ui-auditor/substrate.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L82)
 
 A single UI audit finding — the unit of work a contributor can act on.
 
@@ -839,7 +839,7 @@ lens, missing title, etc.
 
 > `optional` **id?**: `number`
 
-Defined in: [profiles/ui-auditor/substrate.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L83)
+Defined in: [profiles/ui-auditor/substrate.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L84)
 
 Monotonic id assigned by the writer when persisting. Optional in-transit.
 
@@ -847,25 +847,25 @@ Monotonic id assigned by the writer when persisting. Optional in-transit.
 
 > **title**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L84)
+Defined in: [profiles/ui-auditor/substrate.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L85)
 
 ##### lens
 
 > **lens**: [`UiLens`](#uilens)
 
-Defined in: [profiles/ui-auditor/substrate.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L85)
+Defined in: [profiles/ui-auditor/substrate.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L86)
 
 ##### severity
 
 > **severity**: [`UiFindingSeverity`](#uifindingseverity)
 
-Defined in: [profiles/ui-auditor/substrate.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L86)
+Defined in: [profiles/ui-auditor/substrate.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L87)
 
 ##### route
 
 > **route**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L88)
+Defined in: [profiles/ui-auditor/substrate.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L89)
 
 Logical route the finding was observed on (e.g. `home`, `checkout-step-2`).
 
@@ -873,7 +873,7 @@ Logical route the finding was observed on (e.g. `home`, `checkout-step-2`).
 
 > `optional` **url?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L90)
+Defined in: [profiles/ui-auditor/substrate.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L91)
 
 Fully qualified URL the finding was observed at.
 
@@ -881,7 +881,7 @@ Fully qualified URL the finding was observed at.
 
 > `optional` **viewport?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L92)
+Defined in: [profiles/ui-auditor/substrate.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L93)
 
 Viewport string the offending capture was taken at (e.g. `1280x800`).
 
@@ -889,7 +889,7 @@ Viewport string the offending capture was taken at (e.g. `1280x800`).
 
 > `optional` **selector?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L94)
+Defined in: [profiles/ui-auditor/substrate.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L95)
 
 CSS selector pinning the offending element, when one can be identified.
 
@@ -897,7 +897,7 @@ CSS selector pinning the offending element, when one can be identified.
 
 > **observation**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L96)
+Defined in: [profiles/ui-auditor/substrate.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L97)
 
 1–3 sentences describing what the screenshot shows that is wrong.
 
@@ -905,7 +905,7 @@ Defined in: [profiles/ui-auditor/substrate.ts:96](https://github.com/tangle-netw
 
 > **impact**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L98)
+Defined in: [profiles/ui-auditor/substrate.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L99)
 
 Who is affected and how.
 
@@ -913,7 +913,7 @@ Who is affected and how.
 
 > **suggestedFix**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L100)
+Defined in: [profiles/ui-auditor/substrate.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L101)
 
 A specific change a contributor could apply without asking back.
 
@@ -921,7 +921,7 @@ A specific change a contributor could apply without asking back.
 
 > `optional` **reproSteps?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L102)
+Defined in: [profiles/ui-auditor/substrate.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L103)
 
 Optional explicit reproduction steps. Writer synthesizes from route/url/selector when omitted.
 
@@ -929,7 +929,7 @@ Optional explicit reproduction steps. Writer synthesizes from route/url/selector
 
 > `optional` **tags?**: readonly `string`[]
 
-Defined in: [profiles/ui-auditor/substrate.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L104)
+Defined in: [profiles/ui-auditor/substrate.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L105)
 
 Free-form tags.
 
@@ -937,7 +937,7 @@ Free-form tags.
 
 > **screenshots**: readonly [`UiFindingScreenshot`](#uifindingscreenshot)[]
 
-Defined in: [profiles/ui-auditor/substrate.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L106)
+Defined in: [profiles/ui-auditor/substrate.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L107)
 
 Screenshot references — must be non-empty for actionable findings.
 
@@ -945,7 +945,7 @@ Screenshot references — must be non-empty for actionable findings.
 
 > `optional` **similarTo?**: readonly `number`[]
 
-Defined in: [profiles/ui-auditor/substrate.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L108)
+Defined in: [profiles/ui-auditor/substrate.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L109)
 
 Cross-references to similar findings already on file, by id.
 
@@ -953,7 +953,7 @@ Cross-references to similar findings already on file, by id.
 
 > `optional` **createdAt?**: `string`
 
-Defined in: [profiles/ui-auditor/substrate.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L110)
+Defined in: [profiles/ui-auditor/substrate.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L111)
 
 ISO-8601 creation timestamp set by the writer when persisted.
 
@@ -961,7 +961,7 @@ ISO-8601 creation timestamp set by the writer when persisted.
 
 ### UiAuditViewport
 
-Defined in: [profiles/ui-auditor/task.ts:16](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L16)
+Defined in: [profiles/ui-auditor/task.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L17)
 
 **`Experimental`**
 
@@ -971,7 +971,7 @@ Defined in: [profiles/ui-auditor/task.ts:16](https://github.com/tangle-network/a
 
 > **width**: `number`
 
-Defined in: [profiles/ui-auditor/task.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L17)
+Defined in: [profiles/ui-auditor/task.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L18)
 
 **`Experimental`**
 
@@ -979,7 +979,7 @@ Defined in: [profiles/ui-auditor/task.ts:17](https://github.com/tangle-network/a
 
 > **height**: `number`
 
-Defined in: [profiles/ui-auditor/task.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L18)
+Defined in: [profiles/ui-auditor/task.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L19)
 
 **`Experimental`**
 
@@ -987,7 +987,7 @@ Defined in: [profiles/ui-auditor/task.ts:18](https://github.com/tangle-network/a
 
 ### UiAuditCaptureRequest
 
-Defined in: [profiles/ui-auditor/task.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L22)
+Defined in: [profiles/ui-auditor/task.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L23)
 
 **`Experimental`**
 
@@ -997,7 +997,7 @@ Defined in: [profiles/ui-auditor/task.ts:22](https://github.com/tangle-network/a
 
 > **route**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L27)
+Defined in: [profiles/ui-auditor/task.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L28)
 
 **`Experimental`**
 
@@ -1008,7 +1008,7 @@ filenames and finding metadata.
 
 > **url**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L29)
+Defined in: [profiles/ui-auditor/task.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L30)
 
 **`Experimental`**
 
@@ -1018,7 +1018,7 @@ Fully qualified URL the iteration audits.
 
 > `optional` **viewport?**: [`UiAuditViewport`](#uiauditviewport)
 
-Defined in: [profiles/ui-auditor/task.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L31)
+Defined in: [profiles/ui-auditor/task.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L32)
 
 **`Experimental`**
 
@@ -1028,7 +1028,7 @@ Default `{ width: 1280, height: 800 }`.
 
 > `optional` **fullPage?**: `boolean`
 
-Defined in: [profiles/ui-auditor/task.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L33)
+Defined in: [profiles/ui-auditor/task.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L34)
 
 **`Experimental`**
 
@@ -1038,7 +1038,7 @@ Default `false`.
 
 > `optional` **waitFor?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L35)
+Defined in: [profiles/ui-auditor/task.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L36)
 
 **`Experimental`**
 
@@ -1048,7 +1048,7 @@ CSS selector to wait for before capturing.
 
 > `optional` **waitMs?**: `number`
 
-Defined in: [profiles/ui-auditor/task.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L37)
+Defined in: [profiles/ui-auditor/task.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L38)
 
 **`Experimental`**
 
@@ -1058,7 +1058,7 @@ Extra milliseconds to wait after navigation settles. Default `500`.
 
 > `optional` **elementSelector?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L39)
+Defined in: [profiles/ui-auditor/task.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L40)
 
 **`Experimental`**
 
@@ -1068,7 +1068,7 @@ Optional CSS selector — capture only the matched element.
 
 > `optional` **label?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L41)
+Defined in: [profiles/ui-auditor/task.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L42)
 
 **`Experimental`**
 
@@ -1078,7 +1078,7 @@ Optional human-readable label appended to the screenshot filename.
 
 ### UiAuditTask
 
-Defined in: [profiles/ui-auditor/task.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L54)
+Defined in: [profiles/ui-auditor/task.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L55)
 
 **`Experimental`**
 
@@ -1095,7 +1095,7 @@ brief.
 
 > **lens**: [`UiLens`](#uilens)
 
-Defined in: [profiles/ui-auditor/task.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L56)
+Defined in: [profiles/ui-auditor/task.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L57)
 
 **`Experimental`**
 
@@ -1105,7 +1105,7 @@ The audit lens that scopes which findings are valid this iteration.
 
 > **captures**: readonly [`UiAuditCaptureRequest`](#uiauditcapturerequest)[]
 
-Defined in: [profiles/ui-auditor/task.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L58)
+Defined in: [profiles/ui-auditor/task.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L59)
 
 **`Experimental`**
 
@@ -1115,7 +1115,7 @@ Required captures. Order is preserved; index 0 is the primary frame.
 
 > `optional` **productContext?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L63)
+Defined in: [profiles/ui-auditor/task.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L64)
 
 **`Experimental`**
 
@@ -1126,7 +1126,7 @@ name, target audience, copy tone). Surfaced as a prompt prelude.
 
 > `optional` **knownFindingIds?**: readonly `number`[]
 
-Defined in: [profiles/ui-auditor/task.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L69)
+Defined in: [profiles/ui-auditor/task.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L70)
 
 **`Experimental`**
 
@@ -1138,7 +1138,7 @@ pile-on duplicates.
 
 ### UiAuditCapture
 
-Defined in: [profiles/ui-auditor/task.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L73)
+Defined in: [profiles/ui-auditor/task.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L74)
 
 **`Experimental`**
 
@@ -1148,7 +1148,7 @@ Defined in: [profiles/ui-auditor/task.ts:73](https://github.com/tangle-network/a
 
 > **path**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L75)
+Defined in: [profiles/ui-auditor/task.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L76)
 
 **`Experimental`**
 
@@ -1158,7 +1158,7 @@ Workspace-relative path to the screenshot file.
 
 > **viewport**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L76)
+Defined in: [profiles/ui-auditor/task.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L77)
 
 **`Experimental`**
 
@@ -1166,7 +1166,7 @@ Defined in: [profiles/ui-auditor/task.ts:76](https://github.com/tangle-network/a
 
 > **fullPage**: `boolean`
 
-Defined in: [profiles/ui-auditor/task.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L77)
+Defined in: [profiles/ui-auditor/task.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L78)
 
 **`Experimental`**
 
@@ -1174,7 +1174,7 @@ Defined in: [profiles/ui-auditor/task.ts:77](https://github.com/tangle-network/a
 
 > `optional` **elementSelector?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L78)
+Defined in: [profiles/ui-auditor/task.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L79)
 
 **`Experimental`**
 
@@ -1182,7 +1182,7 @@ Defined in: [profiles/ui-auditor/task.ts:78](https://github.com/tangle-network/a
 
 > `optional` **label?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L79)
+Defined in: [profiles/ui-auditor/task.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L80)
 
 **`Experimental`**
 
@@ -1190,7 +1190,7 @@ Defined in: [profiles/ui-auditor/task.ts:79](https://github.com/tangle-network/a
 
 > **route**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L80)
+Defined in: [profiles/ui-auditor/task.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L81)
 
 **`Experimental`**
 
@@ -1198,7 +1198,7 @@ Defined in: [profiles/ui-auditor/task.ts:80](https://github.com/tangle-network/a
 
 > **url**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L81)
+Defined in: [profiles/ui-auditor/task.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L82)
 
 **`Experimental`**
 
@@ -1206,7 +1206,7 @@ Defined in: [profiles/ui-auditor/task.ts:81](https://github.com/tangle-network/a
 
 > **capturedAt**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L83)
+Defined in: [profiles/ui-auditor/task.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L84)
 
 **`Experimental`**
 
@@ -1216,7 +1216,7 @@ Wall-clock when the capture completed.
 
 ### UiAuditOutput
 
-Defined in: [profiles/ui-auditor/task.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L93)
+Defined in: [profiles/ui-auditor/task.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L94)
 
 **`Experimental`**
 
@@ -1230,7 +1230,7 @@ carries judge commentary that didn't rise to a finding.
 
 > **lens**: [`UiLens`](#uilens)
 
-Defined in: [profiles/ui-auditor/task.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L94)
+Defined in: [profiles/ui-auditor/task.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L95)
 
 **`Experimental`**
 
@@ -1238,7 +1238,7 @@ Defined in: [profiles/ui-auditor/task.ts:94](https://github.com/tangle-network/a
 
 > **findings**: [`UiFinding`](#uifinding)[]
 
-Defined in: [profiles/ui-auditor/task.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L95)
+Defined in: [profiles/ui-auditor/task.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L96)
 
 **`Experimental`**
 
@@ -1246,7 +1246,7 @@ Defined in: [profiles/ui-auditor/task.ts:95](https://github.com/tangle-network/a
 
 > **captures**: [`UiAuditCapture`](#uiauditcapture)[]
 
-Defined in: [profiles/ui-auditor/task.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L96)
+Defined in: [profiles/ui-auditor/task.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L97)
 
 **`Experimental`**
 
@@ -1254,7 +1254,7 @@ Defined in: [profiles/ui-auditor/task.ts:96](https://github.com/tangle-network/a
 
 > `optional` **notes?**: `string`
 
-Defined in: [profiles/ui-auditor/task.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L98)
+Defined in: [profiles/ui-auditor/task.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/task.ts#L99)
 
 **`Experimental`**
 
@@ -1266,7 +1266,7 @@ Optional judge commentary (debug / triage aid).
 
 > **UiJudge** = (`input`) => `Promise`\<[`UiJudgeOutput`](#uijudgeoutput)\>
 
-Defined in: [profiles/ui-auditor/judge.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L61)
+Defined in: [profiles/ui-auditor/judge.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/judge.ts#L62)
 
 **`Experimental`**
 
@@ -1286,7 +1286,7 @@ Defined in: [profiles/ui-auditor/judge.ts:61](https://github.com/tangle-network/
 
 > **UiLens** = `"consistency"` \| `"hierarchy"` \| `"layout"` \| `"ux-flow"` \| `"duplication"` \| `"accessibility"` \| `"responsive"` \| `"states"` \| `"content"` \| `"interaction"` \| `"performance-perceived"` \| `"other"`
 
-Defined in: [profiles/ui-auditor/substrate.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L20)
+Defined in: [profiles/ui-auditor/substrate.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L21)
 
 Canonical audit lenses. Each lens scopes a finding to a single class of
 problem so a single audit pass can iterate them without pile-on findings
@@ -1298,7 +1298,7 @@ under a generic label.
 
 > **UiFindingSeverity** = `"low"` \| `"med"` \| `"high"` \| `"critical"`
 
-Defined in: [profiles/ui-auditor/substrate.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L57)
+Defined in: [profiles/ui-auditor/substrate.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L58)
 
 Severity scale.
   - `critical` — blocks a core task or is an accessibility blocker.
@@ -1312,7 +1312,7 @@ Severity scale.
 
 > `const` **SHARED\_AUDITOR\_RULES**: `string`
 
-Defined in: [profiles/ui-auditor/lens-prompts.ts:17](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/lens-prompts.ts#L17)
+Defined in: [profiles/ui-auditor/lens-prompts.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/lens-prompts.ts#L18)
 
 **`Experimental`**
 
@@ -1322,7 +1322,7 @@ Defined in: [profiles/ui-auditor/lens-prompts.ts:17](https://github.com/tangle-n
 
 > `const` **LENS\_BRIEFS**: `Record`\<[`UiLens`](#uilens), `string`\>
 
-Defined in: [profiles/ui-auditor/lens-prompts.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/lens-prompts.ts#L39)
+Defined in: [profiles/ui-auditor/lens-prompts.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/lens-prompts.ts#L40)
 
 **`Experimental`**
 
@@ -1332,7 +1332,7 @@ Defined in: [profiles/ui-auditor/lens-prompts.ts:39](https://github.com/tangle-n
 
 > `const` **UI\_LENSES**: readonly [`UiLens`](#uilens)[]
 
-Defined in: [profiles/ui-auditor/substrate.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L35)
+Defined in: [profiles/ui-auditor/substrate.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L36)
 
 Frozen tuple of lenses for validation + iteration.
 
@@ -1342,7 +1342,7 @@ Frozen tuple of lenses for validation + iteration.
 
 > `const` **UI\_FINDING\_SEVERITIES**: readonly [`UiFindingSeverity`](#uifindingseverity)[]
 
-Defined in: [profiles/ui-auditor/substrate.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L60)
+Defined in: [profiles/ui-auditor/substrate.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/substrate.ts#L61)
 
 Frozen severity tuple, ordered worst → least bad for sort/report.
 
@@ -1352,7 +1352,7 @@ Frozen severity tuple, ordered worst → least bad for sort/report.
 
 > **initAuditWorkspace**(`workspaceDir`): `Promise`\<`void`\>
 
-Defined in: [audit/issue-writer.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L78)
+Defined in: [audit/issue-writer.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L79)
 
 **`Experimental`**
 
@@ -1372,7 +1372,7 @@ Defined in: [audit/issue-writer.ts:78](https://github.com/tangle-network/agent-r
 
 > **readAuditRegistry**(`workspaceDir`): `Promise`\<[`AuditRegistry`](#auditregistry)\>
 
-Defined in: [audit/issue-writer.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L92)
+Defined in: [audit/issue-writer.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L93)
 
 **`Experimental`**
 
@@ -1392,7 +1392,7 @@ Defined in: [audit/issue-writer.ts:92](https://github.com/tangle-network/agent-r
 
 > **appendFindings**(`workspaceDir`, `findings`): `Promise`\<[`AppendFindingsResult`](#appendfindingsresult)\>
 
-Defined in: [audit/issue-writer.ts:272](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L272)
+Defined in: [audit/issue-writer.ts:273](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L273)
 
 **`Experimental`**
 
@@ -1424,7 +1424,7 @@ readonly [`UiFinding`](#uifinding)[]
 
 > **registerCaptures**(`workspaceDir`, `options`): `Promise`\<`void`\>
 
-Defined in: [audit/issue-writer.ts:349](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L349)
+Defined in: [audit/issue-writer.ts:350](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L350)
 
 **`Experimental`**
 
@@ -1452,7 +1452,7 @@ exist for resume / dedup purposes.
 
 > **summarizeRegistry**(`reg`): [`AuditIndex`](#auditindex)
 
-Defined in: [audit/issue-writer.ts:378](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L378)
+Defined in: [audit/issue-writer.ts:379](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L379)
 
 **`Experimental`**
 
@@ -1472,7 +1472,7 @@ Defined in: [audit/issue-writer.ts:378](https://github.com/tangle-network/agent-
 
 > **writeAuditIndex**(`workspaceDir`): `Promise`\<`string`\>
 
-Defined in: [audit/issue-writer.ts:400](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L400)
+Defined in: [audit/issue-writer.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/audit/issue-writer.ts#L401)
 
 **`Experimental`**
 
@@ -1494,7 +1494,7 @@ Regenerate `<workspace>/index.md` from registry.json.
 
 > **coderTaskToPrompt**(`task`): `string`
 
-Defined in: [profiles/coder.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L38)
+Defined in: [profiles/coder.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/coder.ts#L39)
 
 **`Experimental`**
 
@@ -1516,7 +1516,7 @@ Render a `CoderTask` into the per-task instruction handed to the coder profile.
 
 > **createInProcessUiAuditClient**(`options`): [`SandboxClient`](runtime.md#sandboxclient-3) & `object`
 
-Defined in: [profiles/ui-auditor/in-process-client.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L189)
+Defined in: [profiles/ui-auditor/in-process-client.ts:190](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/in-process-client.ts#L190)
 
 **`Experimental`**
 
@@ -1534,7 +1534,7 @@ Defined in: [profiles/ui-auditor/in-process-client.ts:189](https://github.com/ta
 
 > **buildAuditorSystemPrompt**(`lens`): `string`
 
-Defined in: [profiles/ui-auditor/lens-prompts.ts:128](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/lens-prompts.ts#L128)
+Defined in: [profiles/ui-auditor/lens-prompts.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/lens-prompts.ts#L129)
 
 **`Experimental`**
 
@@ -1556,7 +1556,7 @@ Build a system prompt for a single auditor iteration.
 
 > **parseAuditorEvents**(`events`): [`UiAuditOutput`](#uiauditoutput)
 
-Defined in: [profiles/ui-auditor/output-adapter.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/output-adapter.ts#L32)
+Defined in: [profiles/ui-auditor/output-adapter.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/output-adapter.ts#L33)
 
 **`Experimental`**
 
@@ -1576,10 +1576,12 @@ Defined in: [profiles/ui-auditor/output-adapter.ts:32](https://github.com/tangle
 
 > **uiAuditorProfile**(`options?`): `object`
 
-Defined in: [profiles/ui-auditor/profile.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L41)
+Defined in: [profiles/ui-auditor/profile.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/profile.ts#L46)
 
 **`Experimental`**
 
+Preset `runLoop` bundle for vision-driven UI audits: returns the `AgentRunSpec`, output adapter, validator, and prompt formatter the loop kernel needs.
+
 #### Parameters
 
 ##### options?
@@ -1626,7 +1628,7 @@ Defined in: [profiles/ui-auditor/profile.ts:41](https://github.com/tangle-networ
 
 > **encodeAuditTaskEnvelope**(`task`): `string`
 
-Defined in: [profiles/ui-auditor/prompt.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/prompt.ts#L25)
+Defined in: [profiles/ui-auditor/prompt.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/prompt.ts#L26)
 
 **`Experimental`**
 
@@ -1646,7 +1648,7 @@ Defined in: [profiles/ui-auditor/prompt.ts:25](https://github.com/tangle-network
 
 > **decodeAuditTaskEnvelope**(`prompt`): [`UiAuditTask`](#uiaudittask) \| `undefined`
 
-Defined in: [profiles/ui-auditor/prompt.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/prompt.ts#L36)
+Defined in: [profiles/ui-auditor/prompt.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/prompt.ts#L37)
 
 **`Experimental`**
 
@@ -1670,7 +1672,7 @@ not valid JSON.
 
 > **formatAuditorPrompt**(`task`): `string`
 
-Defined in: [profiles/ui-auditor/prompt.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/prompt.ts#L55)
+Defined in: [profiles/ui-auditor/prompt.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/prompt.ts#L56)
 
 **`Experimental`**
 
@@ -1690,7 +1692,7 @@ Defined in: [profiles/ui-auditor/prompt.ts:55](https://github.com/tangle-network
 
 > **createUiAuditorValidator**(`task`): [`Validator`](runtime.md#validator)\<[`UiAuditOutput`](#uiauditoutput)\>
 
-Defined in: [profiles/ui-auditor/validator.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/validator.ts#L51)
+Defined in: [profiles/ui-auditor/validator.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/profiles/ui-auditor/validator.ts#L52)
 
 **`Experimental`**
 
diff --git a/docs/api/runtime.md b/docs/api/runtime.md
index 726fbda0..3eb9e1a8 100644
--- a/docs/api/runtime.md
+++ b/docs/api/runtime.md
@@ -10,7 +10,7 @@
 
 ### InMemoryResultBlobStore
 
-Defined in: [durable/spawn-journal.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L69)
+Defined in: [durable/spawn-journal.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L70)
 
 In-memory `ResultBlobStore`. Content-addressed: `put` verifies the supplied
 `outRef` matches the artifact's hash so a stale/forged ref fails loud rather than
@@ -36,7 +36,7 @@ silently rehydrating the wrong payload. Idempotent on an identical re-put.
 
 > **put**(`outRef`, `artifact`): `Promise`\<`void`\>
 
-Defined in: [durable/spawn-journal.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L72)
+Defined in: [durable/spawn-journal.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L73)
 
 ###### Parameters
 
@@ -60,7 +60,7 @@ Defined in: [durable/spawn-journal.ts:72](https://github.com/tangle-network/agen
 
 > **get**(`outRef`): `Promise`\<`unknown`\>
 
-Defined in: [durable/spawn-journal.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L77)
+Defined in: [durable/spawn-journal.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L78)
 
 ###### Parameters
 
@@ -80,7 +80,7 @@ Defined in: [durable/spawn-journal.ts:77](https://github.com/tangle-network/agen
 
 ### InMemorySpawnJournal
 
-Defined in: [durable/spawn-journal.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L139)
+Defined in: [durable/spawn-journal.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L140)
 
 In-memory `SpawnJournal`. Appends are observed-committed only; the impl enforces
 the corruption guards a durable replay rests on:
@@ -108,7 +108,7 @@ the corruption guards a durable replay rests on:
 
 > **loadTree**(`root`): `Promise`\<`SpawnEvent`[] \| `undefined`\>
 
-Defined in: [durable/spawn-journal.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L142)
+Defined in: [durable/spawn-journal.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L143)
 
 ###### Parameters
 
@@ -128,7 +128,7 @@ Defined in: [durable/spawn-journal.ts:142](https://github.com/tangle-network/age
 
 > **beginTree**(`root`, `at`): `Promise`\<`void`\>
 
-Defined in: [durable/spawn-journal.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L148)
+Defined in: [durable/spawn-journal.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L149)
 
 ###### Parameters
 
@@ -152,7 +152,7 @@ Defined in: [durable/spawn-journal.ts:148](https://github.com/tangle-network/age
 
 > **appendEvent**(`root`, `ev`): `Promise`\<`void`\>
 
-Defined in: [durable/spawn-journal.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L161)
+Defined in: [durable/spawn-journal.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L162)
 
 ###### Parameters
 
@@ -176,7 +176,7 @@ Defined in: [durable/spawn-journal.ts:161](https://github.com/tangle-network/age
 
 ### InMemoryCorpus
 
-Defined in: [runtime/personify/corpus.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L161)
+Defined in: [runtime/personify/corpus.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L162)
 
 In-memory `Corpus`. Keyed by record `id`; `append` validates the record, is idempotent on an
 identical re-append, and returns a typed `{ succeeded: false }` on a conflicting re-append under
@@ -202,7 +202,7 @@ the same `id` (never overwrites). `query` routes through the single-sourced `app
 
 > **append**(`record`): `Promise`\<\{ `succeeded`: `true`; \} \| \{ `succeeded`: `false`; `error`: `string`; \}\>
 
-Defined in: [runtime/personify/corpus.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L164)
+Defined in: [runtime/personify/corpus.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L165)
 
 Append one accreted fact. Idempotent on an identical record; returns a typed outcome —
  inspect `succeeded` before treating it as durable (no silent write-through on conflict).
@@ -225,7 +225,7 @@ Append one accreted fact. Idempotent on an identical record; returns a typed out
 
 > **query**(`filter`): `Promise`\<readonly [`CorpusRecord`](#corpusrecord)[]\>
 
-Defined in: [runtime/personify/corpus.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L186)
+Defined in: [runtime/personify/corpus.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L187)
 
 Query accreted facts by filter — most-confident first. Returns the matching records (an
  empty array when none match is a valid result, NOT an error).
@@ -248,7 +248,7 @@ Query accreted facts by filter — most-confident first. Returns the matching re
 
 ### FileCorpus
 
-Defined in: [runtime/personify/corpus.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L202)
+Defined in: [runtime/personify/corpus.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L203)
 
 JSONL on disk — one validated `CorpusRecord` per line, append-only. `query` replays the whole
 file, validating every line (a malformed line fails loud — a corrupted corpus must never read
@@ -268,7 +268,7 @@ journal, but the interface stays separate (a learned fact is not a replay record
 
 > **new FileCorpus**(`path`): [`FileCorpus`](#filecorpus)
 
-Defined in: [runtime/personify/corpus.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L203)
+Defined in: [runtime/personify/corpus.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L204)
 
 ###### Parameters
 
@@ -286,7 +286,7 @@ Defined in: [runtime/personify/corpus.ts:203](https://github.com/tangle-network/
 
 > **append**(`record`): `Promise`\<\{ `succeeded`: `true`; \} \| \{ `succeeded`: `false`; `error`: `string`; \}\>
 
-Defined in: [runtime/personify/corpus.ts:205](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L205)
+Defined in: [runtime/personify/corpus.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L206)
 
 Append one accreted fact. Idempotent on an identical record; returns a typed outcome —
  inspect `succeeded` before treating it as durable (no silent write-through on conflict).
@@ -309,7 +309,7 @@ Append one accreted fact. Idempotent on an identical record; returns a typed out
 
 > **query**(`filter`): `Promise`\<readonly [`CorpusRecord`](#corpusrecord)[]\>
 
-Defined in: [runtime/personify/corpus.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L233)
+Defined in: [runtime/personify/corpus.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L234)
 
 Query accreted facts by filter — most-confident first. Returns the matching records (an
  empty array when none match is a valid result, NOT an error).
@@ -332,7 +332,7 @@ Query accreted facts by filter — most-confident first. Returns the matching re
 
 ### SandboxRunAbortError
 
-Defined in: [runtime/sandbox-run.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L76)
+Defined in: [runtime/sandbox-run.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L79)
 
 **`Experimental`**
 
@@ -354,7 +354,7 @@ loop kernel, scope, supervise runtime) keep matching it unchanged.
 
 > **new SandboxRunAbortError**(`events`, `readError?`): [`SandboxRunAbortError`](#sandboxrunaborterror)
 
-Defined in: [runtime/sandbox-run.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L82)
+Defined in: [runtime/sandbox-run.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L85)
 
 **`Experimental`**
 
@@ -382,7 +382,7 @@ Defined in: [runtime/sandbox-run.ts:82](https://github.com/tangle-network/agent-
 
 > `readonly` **name**: `"AbortError"` = `'AbortError'`
 
-Defined in: [runtime/sandbox-run.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L77)
+Defined in: [runtime/sandbox-run.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L80)
 
 **`Experimental`**
 
@@ -394,7 +394,7 @@ Defined in: [runtime/sandbox-run.ts:77](https://github.com/tangle-network/agent-
 
 > `readonly` **events**: `SandboxEvent`[]
 
-Defined in: [runtime/sandbox-run.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L79)
+Defined in: [runtime/sandbox-run.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L82)
 
 **`Experimental`**
 
@@ -404,7 +404,7 @@ Events drained from the stream before the abort interrupted the turn.
 
 > `readonly` `optional` **readError?**: `string`
 
-Defined in: [runtime/sandbox-run.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L81)
+Defined in: [runtime/sandbox-run.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L84)
 
 **`Experimental`**
 
@@ -414,7 +414,7 @@ The last artifact read error, if the abort fired during the retry loop.
 
 ### AnalystRegistry
 
-Defined in: [mcp/tools/coordination.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L62)
+Defined in: [mcp/tools/coordination.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L63)
 
 #### Properties
 
@@ -422,13 +422,13 @@ Defined in: [mcp/tools/coordination.ts:62](https://github.com/tangle-network/age
 
 > `readonly` **kinds**: readonly `object`[]
 
-Defined in: [mcp/tools/coordination.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L63)
+Defined in: [mcp/tools/coordination.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L64)
 
 ##### run
 
 > `readonly` **run**: (`kindId`, `trace`) => `Promise`\<`unknown`\>
 
-Defined in: [mcp/tools/coordination.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L64)
+Defined in: [mcp/tools/coordination.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L65)
 
 ###### Parameters
 
@@ -448,7 +448,7 @@ Defined in: [mcp/tools/coordination.ts:64](https://github.com/tangle-network/age
 
 ### WorktreeCommandResult
 
-Defined in: [mcp/worktree-harness.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L39)
+Defined in: [mcp/worktree-harness.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L40)
 
 Outcome of one verification command run in the worktree (test or typecheck).
 
@@ -458,7 +458,7 @@ Outcome of one verification command run in the worktree (test or typecheck).
 
 > **command**: `string`
 
-Defined in: [mcp/worktree-harness.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L41)
+Defined in: [mcp/worktree-harness.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L42)
 
 The shell command line that was run.
 
@@ -466,7 +466,7 @@ The shell command line that was run.
 
 > **passed**: `boolean`
 
-Defined in: [mcp/worktree-harness.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L43)
+Defined in: [mcp/worktree-harness.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L44)
 
 Did the command exit 0? The PASS signal a deliverable gate / coder output reads.
 
@@ -474,7 +474,7 @@ Did the command exit 0? The PASS signal a deliverable gate / coder output reads.
 
 > **exitCode**: `number` \| `null`
 
-Defined in: [mcp/worktree-harness.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L45)
+Defined in: [mcp/worktree-harness.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L46)
 
 OS exit code, or `null` when killed before exit.
 
@@ -482,7 +482,7 @@ OS exit code, or `null` when killed before exit.
 
 > **output**: `string`
 
-Defined in: [mcp/worktree-harness.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L47)
+Defined in: [mcp/worktree-harness.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/worktree-harness.ts#L48)
 
 Combined stdout+stderr (capped) — surfaced in traces for diagnosis.
 
@@ -1179,7 +1179,7 @@ Below this many shared scenarios a paired test can't defensibly separate two pro
 
 ### CompletionEvidence
 
-Defined in: [runtime/completion.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L29)
+Defined in: [runtime/completion.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L30)
 
 Trace-derived evidence for a completion claim — an artifact (output) or a verifier metric,
  never the judge's own verdict. Mirrors the steer-firewall's provenance discipline.
@@ -1190,19 +1190,19 @@ Trace-derived evidence for a completion claim — an artifact (output) or a veri
 
 > **kind**: `"artifact"` \| `"metric"`
 
-Defined in: [runtime/completion.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L30)
+Defined in: [runtime/completion.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L31)
 
 ##### uri
 
 > **uri**: `string`
 
-Defined in: [runtime/completion.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L31)
+Defined in: [runtime/completion.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L32)
 
 ***
 
 ### CompletionVerdict
 
-Defined in: [runtime/completion.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L35)
+Defined in: [runtime/completion.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L36)
 
 The "is it done?" verdict an analyst returns to the parent.
 
@@ -1212,13 +1212,13 @@ The "is it done?" verdict an analyst returns to the parent.
 
 > **done**: `boolean`
 
-Defined in: [runtime/completion.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L36)
+Defined in: [runtime/completion.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L37)
 
 ##### determinism
 
 > **determinism**: `"deterministic"` \| `"probabilistic"`
 
-Defined in: [runtime/completion.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L38)
+Defined in: [runtime/completion.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L39)
 
 How verifiable the claim is — sets whether the driver trusts it or validates it.
 
@@ -1226,7 +1226,7 @@ How verifiable the claim is — sets whether the driver trusts it or validates i
 
 > `optional` **reasons?**: `string`
 
-Defined in: [runtime/completion.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L40)
+Defined in: [runtime/completion.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L41)
 
 Why the analyst believes it is (or isn't) done — what the driver validates.
 
@@ -1234,7 +1234,7 @@ Why the analyst believes it is (or isn't) done — what the driver validates.
 
 > `optional` **confidence?**: `number`
 
-Defined in: [runtime/completion.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L42)
+Defined in: [runtime/completion.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L43)
 
 0..1, for probabilistic verdicts; the driver's validation threshold reads this.
 
@@ -1242,13 +1242,13 @@ Defined in: [runtime/completion.ts:42](https://github.com/tangle-network/agent-r
 
 > `optional` **evidence?**: readonly [`CompletionEvidence`](#completionevidence)[]
 
-Defined in: [runtime/completion.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L43)
+Defined in: [runtime/completion.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L44)
 
 ***
 
 ### CompletionAnalyst
 
-Defined in: [runtime/completion.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L48)
+Defined in: [runtime/completion.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L49)
 
 Reads a node's trace → a completion verdict. Same input shape as the `analyze` hook, so
  ONE analyst node can back both channels (findings for steer, a verdict for stop).
@@ -1269,7 +1269,7 @@ Reads a node's trace → a completion verdict. Same input shape as the `analyze`
 
 > **assess**(`input`): [`CompletionVerdict`](#completionverdict) \| `Promise`\<[`CompletionVerdict`](#completionverdict)\>
 
-Defined in: [runtime/completion.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L49)
+Defined in: [runtime/completion.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L50)
 
 ###### Parameters
 
@@ -1291,7 +1291,7 @@ readonly [`Iteration`](#iteration-1)\<`Task`, `Output`\>[]
 
 ### CompletionPolicy
 
-Defined in: [runtime/completion.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L57)
+Defined in: [runtime/completion.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L58)
 
 When a verdict authorizes the driver to END. Deterministic → trust (ground truth);
  probabilistic → validate by confidence threshold (the driver's check).
@@ -1302,7 +1302,7 @@ When a verdict authorizes the driver to END. Deterministic → trust (ground tru
 
 > `optional` **minConfidence?**: `number`
 
-Defined in: [runtime/completion.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L59)
+Defined in: [runtime/completion.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L60)
 
 Minimum confidence a PROBABILISTIC verdict must clear to end. Default 0.8.
 
@@ -1988,7 +1988,7 @@ Operator-facing markdown: what the observer noticed + what to change.
 
 ### CreateScopeAnalystOptions
 
-Defined in: [runtime/personify/analyst.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L68)
+Defined in: [runtime/personify/analyst.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L69)
 
 The analyst run an `Agent<unknown, AnalystFinding[]>` performs over the children settled so far.
 The combinator supplies the analyst's task projection (how to frame the drained settlements as
@@ -2007,7 +2007,7 @@ firewall is enforced afterwards by `createScopeAnalyst`, not by the analyst itse
 
 > `readonly` **analyst**: [`Agent`](#agent)\<`unknown`, readonly `AnalystFinding`[]\>
 
-Defined in: [runtime/personify/analyst.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L72)
+Defined in: [runtime/personify/analyst.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L73)
 
 The analyst agent the combinator spawns over the trace. `harness` is the persona's choice
  (`null` for an inline router analyst, a `BackendType` for a sandboxed one). Its `act` returns
@@ -2017,7 +2017,7 @@ The analyst agent the combinator spawns over the trace. `harness` is the persona
 
 > `readonly` **budget**: [`Budget`](#budget-12)
 
-Defined in: [runtime/personify/analyst.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L78)
+Defined in: [runtime/personify/analyst.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L79)
 
 The conserved budget reserved for one analyst spawn. The pool reserves against it and fails
  closed; an analyst that cannot be admitted is a fail-loud abort, never silent empty findings.
@@ -2026,7 +2026,7 @@ The conserved budget reserved for one analyst spawn. The pool reserves against i
 
 > `readonly` `optional` **label?**: `string`
 
-Defined in: [runtime/personify/analyst.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L80)
+Defined in: [runtime/personify/analyst.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L81)
 
 Trace/journal label for the spawned analyst child. Default `'analyst'`.
 
@@ -2036,7 +2036,7 @@ Trace/journal label for the spawned analyst child. Default `'analyst'`.
 
 > **buildTask**(`input`): `unknown`
 
-Defined in: [runtime/personify/analyst.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L75)
+Defined in: [runtime/personify/analyst.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L76)
 
 Build the analyst agent's task from the analyze input (the root-task framing + the children
  drained so far). Pure projection — the analyst interprets it, this never reads it.
@@ -2055,7 +2055,7 @@ Build the analyst agent's task from the analyze input (the root-task framing + t
 
 ### RegistryAnalyzeProjection
 
-Defined in: [runtime/personify/analyst.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L183)
+Defined in: [runtime/personify/analyst.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L184)
 
 Project a `ScopeAnalyzeInput` into the `AnalystRegistry.run` arguments. The registry runs over a
 `runId` + `AnalystRunInputs` (a trace store / run record / artifact dir), NOT in-memory scope
@@ -2069,19 +2069,19 @@ bridge; it only runs the projected inputs and firewalls the merged findings.
 
 > `readonly` **runId**: `string`
 
-Defined in: [runtime/personify/analyst.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L184)
+Defined in: [runtime/personify/analyst.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L185)
 
 ##### inputs
 
 > `readonly` **inputs**: `AnalystRunInputs`
 
-Defined in: [runtime/personify/analyst.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L185)
+Defined in: [runtime/personify/analyst.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L186)
 
 ##### opts?
 
 > `readonly` `optional` **opts?**: `object`
 
-Defined in: [runtime/personify/analyst.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L187)
+Defined in: [runtime/personify/analyst.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L188)
 
 Optional `run` opts (e.g. `priorFindings`) forwarded verbatim to the registry.
 
@@ -2097,7 +2097,7 @@ Optional `run` opts (e.g. `priorFindings`) forwarded verbatim to the registry.
 
 ### Persona
 
-Defined in: [runtime/personify/types.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L70)
+Defined in: [runtime/personify/types.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L71)
 
 The "act like X" record. A thin composition over the keystone's `AgentSpec`: it pairs the
 root spec (the executor mapping for the root agent the shape builds) with the CONTENT a
@@ -2122,7 +2122,7 @@ persona string is ever hardcoded in a shape or the engine.
 
 > `readonly` **name**: `string`
 
-Defined in: [runtime/personify/types.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L72)
+Defined in: [runtime/personify/types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L73)
 
 Stable persona name — used as the trace/journal label root, never as content.
 
@@ -2130,7 +2130,7 @@ Stable persona name — used as the trace/journal label root, never as content.
 
 > `readonly` **root**: [`AgentSpec`](#agentspec)
 
-Defined in: [runtime/personify/types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L78)
+Defined in: [runtime/personify/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L79)
 
 The root agent's executor mapping (profile + harness + optional BYO executor). The
 shape's root `Agent` carries THIS as its `executorSpec`; child specs the shape spawns
@@ -2140,7 +2140,7 @@ are derived from / resolved against the same persona registry (see `ShapeContext
 
 > `readonly` **directive**: `string`
 
-Defined in: [runtime/personify/types.ts:80](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L80)
+Defined in: [runtime/personify/types.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L81)
 
 The goal framing handed to the shape — the "what to achieve", not "how".
 
@@ -2148,7 +2148,7 @@ The goal framing handed to the shape — the "what to achieve", not "how".
 
 > `readonly` **context**: [`PersonaContext`](#personacontext-1)
 
-Defined in: [runtime/personify/types.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L83)
+Defined in: [runtime/personify/types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L84)
 
 Who the loop is acting as — the opaque persona context blob the shape may inject into
  child tasks. Opaque to the framework; only the persona's profiles/prompts interpret it.
@@ -2157,7 +2157,7 @@ Who the loop is acting as — the opaque persona context blob the shape may inje
 
 > `readonly` **executors**: [`PersonaExecutors`](#personaexecutors-1)
 
-Defined in: [runtime/personify/types.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L91)
+Defined in: [runtime/personify/types.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L92)
 
 The executor seams (router endpoint+key, sandbox client, cli bin) the built-in runtimes
 read off `ExecutorContext.seams`, OR a fully pre-configured registry. The supervisor
@@ -2169,7 +2169,7 @@ on each `AgentSpec`). Carried here so `runPersonified` can build `SupervisorOpts
 
 > `readonly` `optional` **extensions?**: `Readonly`\<`Record`\<`string`, `unknown`\>\>
 
-Defined in: [runtime/personify/types.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L96)
+Defined in: [runtime/personify/types.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L97)
 
 Forward-compatible extension bag — a later world-model / memory / tool-budget field is an
 additive key here, never a breaking change to the `Persona` shape. Opaque to the engine.
@@ -2178,7 +2178,7 @@ additive key here, never a breaking change to the `Persona` shape. Opaque to the
 
 > `readonly` `optional` **\_\_deliverable?**: `D`
 
-Defined in: [runtime/personify/types.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L99)
+Defined in: [runtime/personify/types.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L100)
 
 Phantom: binds the persona to its deliverable type so `runPersonified` infers `D` from
  the persona and the chosen shape must agree. Type-only — never present at runtime.
@@ -2187,7 +2187,7 @@ Phantom: binds the persona to its deliverable type so `runPersonified` infers `D
 
 ### PersonaContext
 
-Defined in: [runtime/personify/types.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L104)
+Defined in: [runtime/personify/types.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L105)
 
 The persona context blob — who the loop is acting as. Open by intent: a persona names its
  own role/audience/constraints; the framework treats it as opaque content.
@@ -2204,7 +2204,7 @@ Open content bag — persona-specific fields a shape's child tasks may carry.
 
 > `readonly` **role**: `string`
 
-Defined in: [runtime/personify/types.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L106)
+Defined in: [runtime/personify/types.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L107)
 
 The role the loop embodies ("senior staff engineer", "equity research analyst", …).
 
@@ -2212,7 +2212,7 @@ The role the loop embodies ("senior staff engineer", "equity research analyst",
 
 > `readonly` `optional` **notes?**: `string`
 
-Defined in: [runtime/personify/types.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L108)
+Defined in: [runtime/personify/types.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L109)
 
 Optional freeform framing the persona's prompts/profiles consume.
 
@@ -2220,7 +2220,7 @@ Optional freeform framing the persona's prompts/profiles consume.
 
 ### PersonaExecutors
 
-Defined in: [runtime/personify/types.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L118)
+Defined in: [runtime/personify/types.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L119)
 
 How a persona supplies executor resolution. Either a pre-built registry (factories already
 closed over their seams) OR the raw seam bag the engine uses to construct a registry +
@@ -2232,7 +2232,7 @@ thread the seams onto each spawn. Exactly one is required — fail loud if neith
 
 > `readonly` `optional` **registry?**: [`ExecutorRegistry`](#executorregistry)
 
-Defined in: [runtime/personify/types.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L120)
+Defined in: [runtime/personify/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L121)
 
 A registry whose factories already capture their seams. Highest precedence.
 
@@ -2240,7 +2240,7 @@ A registry whose factories already capture their seams. Highest precedence.
 
 > `readonly` `optional` **seams?**: `Readonly`\<`Record`\<`string`, `unknown`\>\>
 
-Defined in: [runtime/personify/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L122)
+Defined in: [runtime/personify/types.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L123)
 
 Raw seams to thread onto built-in runtimes (`router`/`sandbox`/`cli` keys).
 
@@ -2248,7 +2248,7 @@ Raw seams to thread onto built-in runtimes (`router`/`sandbox`/`cli` keys).
 
 ### DefinePersonaInput
 
-Defined in: [runtime/personify/types.ts:129](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L129)
+Defined in: [runtime/personify/types.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L130)
 
 The minimal input to build a `Persona`. Mirrors `Persona` but lets the builder default
  the executors-supplied invariant check and freeze the record.
@@ -2265,43 +2265,43 @@ The minimal input to build a `Persona`. Mirrors `Persona` but lets the builder d
 
 > `readonly` **name**: `string`
 
-Defined in: [runtime/personify/types.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L130)
+Defined in: [runtime/personify/types.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L131)
 
 ##### root
 
 > `readonly` **root**: [`AgentSpec`](#agentspec)
 
-Defined in: [runtime/personify/types.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L131)
+Defined in: [runtime/personify/types.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L132)
 
 ##### directive
 
 > `readonly` **directive**: `string`
 
-Defined in: [runtime/personify/types.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L132)
+Defined in: [runtime/personify/types.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L133)
 
 ##### context
 
 > `readonly` **context**: [`PersonaContext`](#personacontext-1)
 
-Defined in: [runtime/personify/types.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L133)
+Defined in: [runtime/personify/types.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L134)
 
 ##### executors
 
 > `readonly` **executors**: [`PersonaExecutors`](#personaexecutors-1)
 
-Defined in: [runtime/personify/types.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L134)
+Defined in: [runtime/personify/types.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L135)
 
 ##### extensions?
 
 > `readonly` `optional` **extensions?**: `Readonly`\<`Record`\<`string`, `unknown`\>\>
 
-Defined in: [runtime/personify/types.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L135)
+Defined in: [runtime/personify/types.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L136)
 
 ##### \_\_deliverable?
 
 > `readonly` `optional` **\_\_deliverable?**: `D`
 
-Defined in: [runtime/personify/types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L138)
+Defined in: [runtime/personify/types.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L139)
 
 Phantom: pins the input's deliverable type so `definePersona<D>` returns a `Persona<D>`
  the caller's shape must agree with. Type-only — never supplied at a call site.
@@ -2310,7 +2310,7 @@ Phantom: pins the input's deliverable type so `definePersona<D>` returns a `Pers
 
 ### ShapeBudget
 
-Defined in: [runtime/personify/types.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L153)
+Defined in: [runtime/personify/types.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L154)
 
 Budget knobs a shape reads to size its fanout/children WITHOUT owning the conserved pool.
 The root budget lives on `SupervisorOpts.budget`; the shape only needs the per-child
@@ -2323,7 +2323,7 @@ against them and fails closed, so an over-eager shape can never overspend.
 
 > `readonly` **perChild**: [`Budget`](#budget-12)
 
-Defined in: [runtime/personify/types.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L155)
+Defined in: [runtime/personify/types.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L156)
 
 Per-child spawn budget the shape reserves for each leaf/sub-loop it opens.
 
@@ -2331,7 +2331,7 @@ Per-child spawn budget the shape reserves for each leaf/sub-loop it opens.
 
 > `readonly` **fanout**: `number`
 
-Defined in: [runtime/personify/types.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L157)
+Defined in: [runtime/personify/types.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L158)
 
 Max children a fanout step may open in one round (the shape's structural width).
 
@@ -2339,7 +2339,7 @@ Max children a fanout step may open in one round (the shape's structural width).
 
 ### ShapeContext
 
-Defined in: [runtime/personify/types.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L167)
+Defined in: [runtime/personify/types.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L168)
 
 The construction context a `LoopShape` factory receives. Carries the persona's resolved
 executor seams + the budget knobs, plus the ONE helper a shape needs to spawn a child
@@ -2359,19 +2359,19 @@ registry directly — it asks the context, keeping resolution single-sourced.
 
 > `readonly` **persona**: [`Persona`](#persona)\<`D`\>
 
-Defined in: [runtime/personify/types.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L168)
+Defined in: [runtime/personify/types.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L169)
 
 ##### budget
 
 > `readonly` **budget**: [`ShapeBudget`](#shapebudget)
 
-Defined in: [runtime/personify/types.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L169)
+Defined in: [runtime/personify/types.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L170)
 
 ##### analyst?
 
 > `readonly` `optional` **analyst?**: [`ScopeAnalyst`](#scopeanalyst)\<`D`\>
 
-Defined in: [runtime/personify/types.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L182)
+Defined in: [runtime/personify/types.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L183)
 
 The scope analyst (selector≠judge firewall) the combinator steers from. Absent ⇒ the
  dormant default (empty findings → gates read deliverables/state only).
@@ -2382,7 +2382,7 @@ The scope analyst (selector≠judge firewall) the combinator steers from. Absent
 
 > **spawnChild**(`name`, `spec`): [`Agent`](#agent)\<`unknown`, [`Outcome`](#outcome-1)\<`D`\>\>
 
-Defined in: [runtime/personify/types.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L176)
+Defined in: [runtime/personify/types.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L177)
 
 Wrap an `AgentSpec` into a leaf `Agent` carrying it as `executorSpec`, so the shape can
 `scope.spawn(spawnChild(spec), task, opts)`. `name` labels the child for traces. The
@@ -2407,7 +2407,7 @@ spec drives the resolved `Executor`; `act` exists only to satisfy the `Agent` sh
 
 > **childSpec**(`profile`, `harness?`): [`AgentSpec`](#agentspec)
 
-Defined in: [runtime/personify/types.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L179)
+Defined in: [runtime/personify/types.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L180)
 
 Derive a child `AgentSpec` from the persona's root spec with an overridden profile —
  the seam a shape uses to give a worker a narrower role/prompt than the root persona.
@@ -2430,7 +2430,7 @@ Derive a child `AgentSpec` from the persona's root spec with an overridden profi
 
 ### ShapeRegistry
 
-Defined in: [runtime/personify/types.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L201)
+Defined in: [runtime/personify/types.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L202)
 
 The open shape registry — the extension point that makes a new loop-shape ONE file + one
 `registerShape` call with zero edits elsewhere. `resolve` returns a typed outcome (inspect
@@ -2442,7 +2442,7 @@ The open shape registry — the extension point that makes a new loop-shape ONE
 
 > **register**\<`Task`, `D`\>(`name`, `factory`): `void`
 
-Defined in: [runtime/personify/types.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L202)
+Defined in: [runtime/personify/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L203)
 
 ###### Type Parameters
 
@@ -2472,7 +2472,7 @@ Defined in: [runtime/personify/types.ts:202](https://github.com/tangle-network/a
 
 > **resolve**\<`Task`, `D`\>(`name`): \{ `succeeded`: `true`; `value`: [`LoopShape`](#loopshape)\<`Task`, `D`\>; \} \| \{ `succeeded`: `false`; `error`: `string`; \}
 
-Defined in: [runtime/personify/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L203)
+Defined in: [runtime/personify/types.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L204)
 
 ###### Type Parameters
 
@@ -2498,7 +2498,7 @@ Defined in: [runtime/personify/types.ts:203](https://github.com/tangle-network/a
 
 > **names**(): `string`[]
 
-Defined in: [runtime/personify/types.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L207)
+Defined in: [runtime/personify/types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L208)
 
 The registered shape names — for diagnostics + a fail-loud "unknown shape" message.
 
@@ -2510,7 +2510,7 @@ The registered shape names — for diagnostics + a fail-loud "unknown shape" mes
 
 ### RunPersonifiedOptions
 
-Defined in: [runtime/personify/types.ts:222](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L222)
+Defined in: [runtime/personify/types.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L223)
 
 The end-to-end entrypoint. Builds the persona's root `Agent` from the chosen shape, then
 runs it through a fresh `createSupervisor` over the persona's executors + the supplied
@@ -2537,13 +2537,13 @@ default registry). The journal/blobs default to in-memory impls in the engine wh
 
 > `readonly` **persona**: [`Persona`](#persona)\<`D`\>
 
-Defined in: [runtime/personify/types.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L223)
+Defined in: [runtime/personify/types.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L224)
 
 ##### shape
 
 > `readonly` **shape**: `string` \| [`LoopShape`](#loopshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/types.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L225)
+Defined in: [runtime/personify/types.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L226)
 
 A resolved shape factory OR a registered shape name.
 
@@ -2551,19 +2551,19 @@ A resolved shape factory OR a registered shape name.
 
 > `readonly` **task**: `Task`
 
-Defined in: [runtime/personify/types.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L226)
+Defined in: [runtime/personify/types.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L227)
 
 ##### budget
 
 > `readonly` **budget**: [`Budget`](#budget-12)
 
-Defined in: [runtime/personify/types.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L227)
+Defined in: [runtime/personify/types.ts:228](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L228)
 
 ##### shapeBudget?
 
 > `readonly` `optional` **shapeBudget?**: `Partial`\<[`ShapeBudget`](#shapebudget)\>
 
-Defined in: [runtime/personify/types.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L229)
+Defined in: [runtime/personify/types.ts:230](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L230)
 
 Per-child sizing + fanout width handed to the shape. Defaults derive from `budget`.
 
@@ -2571,7 +2571,7 @@ Per-child sizing + fanout width handed to the shape. Defaults derive from `budge
 
 > `readonly` `optional` **runId?**: `string`
 
-Defined in: [runtime/personify/types.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L231)
+Defined in: [runtime/personify/types.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L232)
 
 Trace/journal root key. Defaults to the persona name + a run discriminator in the engine.
 
@@ -2579,19 +2579,19 @@ Trace/journal root key. Defaults to the persona name + a run discriminator in th
 
 > `readonly` `optional` **journal?**: `SpawnJournal`
 
-Defined in: [runtime/personify/types.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L232)
+Defined in: [runtime/personify/types.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L233)
 
 ##### blobs?
 
 > `readonly` `optional` **blobs?**: [`ResultBlobStore`](#resultblobstore)
 
-Defined in: [runtime/personify/types.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L233)
+Defined in: [runtime/personify/types.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L234)
 
 ##### maxDepth?
 
 > `readonly` `optional` **maxDepth?**: `number`
 
-Defined in: [runtime/personify/types.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L235)
+Defined in: [runtime/personify/types.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L236)
 
 Runtime recursion-depth ceiling, paired with the conserved pool.
 
@@ -2599,7 +2599,7 @@ Runtime recursion-depth ceiling, paired with the conserved pool.
 
 > `readonly` `optional` **maxRestarts?**: `number`
 
-Defined in: [runtime/personify/types.ts:237](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L237)
+Defined in: [runtime/personify/types.ts:238](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L238)
 
 OTP intensity breaker bounds, forwarded to the supervisor verbatim.
 
@@ -2607,13 +2607,13 @@ OTP intensity breaker bounds, forwarded to the supervisor verbatim.
 
 > `readonly` `optional` **withinMs?**: `number`
 
-Defined in: [runtime/personify/types.ts:238](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L238)
+Defined in: [runtime/personify/types.ts:239](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L239)
 
 ##### handle?
 
 > `readonly` `optional` **handle?**: `RootHandle`\<[`Outcome`](#outcome-1)\<`D`\>\>
 
-Defined in: [runtime/personify/types.ts:240](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L240)
+Defined in: [runtime/personify/types.ts:241](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L241)
 
 A live root handle to attach (view/signal/abort) before the run starts.
 
@@ -2621,7 +2621,7 @@ A live root handle to attach (view/signal/abort) before the run starts.
 
 > `readonly` `optional` **now?**: () => `number`
 
-Defined in: [runtime/personify/types.ts:241](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L241)
+Defined in: [runtime/personify/types.ts:242](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L242)
 
 ###### Returns
 
@@ -2631,13 +2631,13 @@ Defined in: [runtime/personify/types.ts:241](https://github.com/tangle-network/a
 
 > `readonly` `optional` **signal?**: `AbortSignal`
 
-Defined in: [runtime/personify/types.ts:242](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L242)
+Defined in: [runtime/personify/types.ts:243](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L243)
 
 ##### analyst?
 
 > `readonly` `optional` **analyst?**: [`ScopeAnalyst`](#scopeanalyst)\<`D`\>
 
-Defined in: [runtime/personify/types.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L245)
+Defined in: [runtime/personify/types.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L246)
 
 Optional scope analyst threaded into the shape's ShapeContext so loopUntil/widen steer
  on trace-derived findings instead of the dormant empty default.
@@ -2646,7 +2646,7 @@ Optional scope analyst threaded into the shape's ShapeContext so loopUntil/widen
 
 > `readonly` `optional` **hooks?**: [`RuntimeHooks`](index.md#runtimehooks)
 
-Defined in: [runtime/personify/types.ts:251](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L251)
+Defined in: [runtime/personify/types.ts:252](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L252)
 
 Lifecycle stream sink, forwarded to `SupervisorOpts.hooks` so the root `Scope`'s
 `agent.spawn`/`agent.child` events flow to an observer (e.g. the Intelligence SDK's
@@ -2656,7 +2656,7 @@ trace export). Absent ⇒ no stream (the run is silent, as today).
 
 ### PipelineStage
 
-Defined in: [runtime/personify/wave-types.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L76)
+Defined in: [runtime/personify/wave-types.ts:77](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L77)
 
 `pipeline(stages)` — sequential composition: each stage's `Outcome.deliverable` feeds the next
 stage's task (via `feed`). The first `blocked` stage short-circuits the whole pipeline (its
@@ -2687,7 +2687,7 @@ not a named shape. A stage names only its label + how to derive its task from th
 
 > `readonly` **label**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L78)
+Defined in: [runtime/personify/wave-types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L79)
 
 Trace/journal label for this stage's spawned child.
 
@@ -2697,7 +2697,7 @@ Trace/journal label for this stage's spawned child.
 
 > **feed**(`prior`, `ctx`, `rootTask`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L81)
+Defined in: [runtime/personify/wave-types.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L82)
 
 Derive this stage's task from the prior stage's deliverable (or the root task for stage 0).
  Pure projection — the framework never interprets the result; the resolved leaf does.
@@ -2724,7 +2724,7 @@ Derive this stage's task from the prior stage's deliverable (or the root task fo
 
 > **collect**(`settled`): [`Outcome`](#outcome-1)\<`StepOut`\>
 
-Defined in: [runtime/personify/wave-types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L84)
+Defined in: [runtime/personify/wave-types.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L85)
 
 Read this stage's settled child output into the typed `StepOut` the next stage feeds on.
  Fail loud (return a `blocked`) when the child produced nothing usable for the next stage.
@@ -2743,7 +2743,7 @@ Read this stage's settled child output into the typed `StepOut` the next stage f
 
 ### FanoutOptions
 
-Defined in: [runtime/personify/wave-types.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L105)
+Defined in: [runtime/personify/wave-types.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L106)
 
 `fanout(items, { synthesize? })` — N children spawned in one round (one per item, bounded by
 the conserved pool's fail-closed admission), drained via `scope.next()`, then optionally a
@@ -2772,7 +2772,7 @@ persona's.
 
 > `optional` **synthesize?**: [`FanoutSynthesis`](#fanoutsynthesis)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L124)
+Defined in: [runtime/personify/wave-types.ts:125](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L125)
 
 Optional synthesis over the gathered child results: when present, the combinator spawns ONE
 synthesis child whose task is built from the drained settlements, and its `done` output is
@@ -2783,7 +2783,7 @@ The synthesis child is a SEPARATE keystone agent (not a re-rank behind the drive
 
 > `optional` **selectWinner?**: [`FanoutWinnerSelector`](#fanoutwinnerselector)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L133)
+Defined in: [runtime/personify/wave-types.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L134)
 
 Winner-selection strategy among the gathered `done` children when there is no `synthesize`.
 Receives the SAME `Iteration[]` the default selector reads (each child's output is its
@@ -2798,7 +2798,7 @@ synthesis child IS the selection); supplying both is a config error.
 
 > **itemTask**(`item`, `index`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L108)
+Defined in: [runtime/personify/wave-types.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L109)
 
 One child task per item: `item` + the index discriminator. The persona's directive/context
  is threaded in by the combinator; this only supplies the per-item discriminator.
@@ -2825,7 +2825,7 @@ One child task per item: `item` + the index discriminator. The persona's directi
 
 > `optional` **label**(`item`, `index`): `string`
 
-Defined in: [runtime/personify/wave-types.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L110)
+Defined in: [runtime/personify/wave-types.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L111)
 
 Per-item child label (defaults to `item:<index>` in the impl).
 
@@ -2847,7 +2847,7 @@ Per-item child label (defaults to `item:<index>` in the impl).
 
 > `optional` **itemSpec**(`item`, `index`, `ctx`): [`AgentSpec`](#agentspec)
 
-Defined in: [runtime/personify/wave-types.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L117)
+Defined in: [runtime/personify/wave-types.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L118)
 
 Optional per-item `AgentSpec` override. When set, each item's child is spawned against the
 returned spec instead of `persona.root` — the seam a heterogeneous fanout uses to give each
@@ -2876,7 +2876,7 @@ leaf). Absent ⇒ every item runs against the persona's root spec (the homogeneo
 
 ### FanoutSynthesis
 
-Defined in: [runtime/personify/wave-types.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L149)
+Defined in: [runtime/personify/wave-types.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L150)
 
 How a fanout's synthesis child is built + read. `synthesisTask` projects the drained child
  settlements into the synthesis child's task; `collect` reads its settled output into the
@@ -2894,7 +2894,7 @@ How a fanout's synthesis child is built + read. `synthesisTask` projects the dra
 
 > **synthesisTask**(`gathered`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L150)
+Defined in: [runtime/personify/wave-types.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L151)
 
 ###### Parameters
 
@@ -2914,7 +2914,7 @@ readonly [`Settled`](#settled-2)\<[`Outcome`](#outcome-1)\<`D`\>\>[]
 
 > **collect**(`settled`): [`Outcome`](#outcome-1)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L151)
+Defined in: [runtime/personify/wave-types.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L152)
 
 ###### Parameters
 
@@ -2930,7 +2930,7 @@ Defined in: [runtime/personify/wave-types.ts:151](https://github.com/tangle-netw
 
 ### LoopUntilSpec
 
-Defined in: [runtime/personify/wave-types.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L170)
+Defined in: [runtime/personify/wave-types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L171)
 
 `loopUntil({ until, step })` — iterative deepening inside the conserved pool: spawn one `step`
 child per round, ask `until` whether the accumulated state satisfies the goal, and stop when it
@@ -2961,7 +2961,7 @@ and an `until` that reads the test-finding; the combinator owns only the round/s
 
 > **step**(`rootTask`, `state`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L172)
+Defined in: [runtime/personify/wave-types.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L173)
 
 Build the next step child's task from the root task + the state accumulated so far.
 
@@ -2987,7 +2987,7 @@ Build the next step child's task from the root task + the state accumulated so f
 
 > **fold**(`prior`, `settled`): [`LoopUntilState`](#loopuntilstate-2)\<`State`\>
 
-Defined in: [runtime/personify/wave-types.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L174)
+Defined in: [runtime/personify/wave-types.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L175)
 
 Fold one settled step into the accumulated state (the loop's running deliverable candidate).
 
@@ -3009,7 +3009,7 @@ Fold one settled step into the accumulated state (the loop's running deliverable
 
 > **until**(`state`, `findings`): [`Outcome`](#outcome-1)\<`D`\> \| `null`
 
-Defined in: [runtime/personify/wave-types.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L180)
+Defined in: [runtime/personify/wave-types.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L181)
 
 The satisfiability gate: given the accumulated state + the round's trace findings, has the
 goal been reached? Returns the terminal deliverable when satisfied, or `null` to keep going.
@@ -3033,7 +3033,7 @@ readonly `AnalystFinding`[]
 
 > `optional` **label**(`round`): `string`
 
-Defined in: [runtime/personify/wave-types.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L182)
+Defined in: [runtime/personify/wave-types.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L183)
 
 Per-round step label (defaults to `step:<round>` in the impl).
 
@@ -3051,7 +3051,7 @@ Per-round step label (defaults to `step:<round>` in the impl).
 
 ### LoopUntilState
 
-Defined in: [runtime/personify/wave-types.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L187)
+Defined in: [runtime/personify/wave-types.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L188)
 
 The accumulated state `loopUntil` threads across rounds — the running candidate + the round
  index, so `step`/`fold`/`until` are pure functions of it (replay-safe, no wall-clock).
@@ -3068,19 +3068,19 @@ The accumulated state `loopUntil` threads across rounds — the running candidat
 
 > `readonly` **round**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L188)
+Defined in: [runtime/personify/wave-types.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L189)
 
 ##### value
 
 > `readonly` **value**: `State`
 
-Defined in: [runtime/personify/wave-types.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L189)
+Defined in: [runtime/personify/wave-types.ts:190](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L190)
 
 ***
 
 ### PanelSpec
 
-Defined in: [runtime/personify/wave-types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L208)
+Defined in: [runtime/personify/wave-types.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L209)
 
 `panel(judges)` — M judges over ONE artifact, merged WRITE-ONLY (selector≠judge taken to its
 limit). The combinator spawns the M judge children over the same input artifact, drains their
@@ -3107,7 +3107,7 @@ different personas; the rubric lives in each judge persona's profile, not the co
 
 > `readonly` **judges**: readonly [`PanelJudge`](#paneljudge)[]
 
-Defined in: [runtime/personify/wave-types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L212)
+Defined in: [runtime/personify/wave-types.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L213)
 
 The M judge child specs: each is a persona-derived child (a narrower judge profile). The
  combinator spawns one child per entry over the SAME `artifact` and never lets one judge's
@@ -3119,7 +3119,7 @@ The M judge child specs: each is a persona-derived child (a narrower judge profi
 
 > **judgeTask**(`artifact`, `judge`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L214)
+Defined in: [runtime/personify/wave-types.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L215)
 
 Build one judge child's task from the shared artifact under review + the judge descriptor.
 
@@ -3145,7 +3145,7 @@ Build one judge child's task from the shared artifact under review + the judge d
 
 > **merge**(`verdicts`, `artifact`): [`Outcome`](#outcome-1)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:220](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L220)
+Defined in: [runtime/personify/wave-types.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L221)
 
 Write-only merge: fold the M settled judge verdicts into the panel's terminal `Outcome<D>`.
 Pure over the drained settlements — it MUST NOT spawn, re-judge, or feed one verdict into
@@ -3169,7 +3169,7 @@ readonly [`PanelVerdict`](#panelverdict)[]
 
 ### PanelJudge
 
-Defined in: [runtime/personify/wave-types.ts:225](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L225)
+Defined in: [runtime/personify/wave-types.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L226)
 
 One judge in a panel — a labeled persona-derived judge child. Content (the rubric) lives in
  the judge's profile; this carries only the label + the optional weight the merge may read.
@@ -3180,13 +3180,13 @@ One judge in a panel — a labeled persona-derived judge child. Content (the rub
 
 > `readonly` **label**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L226)
+Defined in: [runtime/personify/wave-types.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L227)
 
 ##### weight?
 
 > `readonly` `optional` **weight?**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:228](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L228)
+Defined in: [runtime/personify/wave-types.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L229)
 
 Optional merge weight (a write-only hint the `merge` fold may use; default-equal in the impl).
 
@@ -3194,7 +3194,7 @@ Optional merge weight (a write-only hint the `merge` fold may use; default-equal
 
 ### PanelVerdict
 
-Defined in: [runtime/personify/wave-types.ts:233](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L233)
+Defined in: [runtime/personify/wave-types.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L234)
 
 One judge child's settled verdict, surfaced to the write-only `merge`. `down` judges carry no
  verdict (excluded from the merge `n`, like an infra-errored cell).
@@ -3205,19 +3205,19 @@ One judge child's settled verdict, surfaced to the write-only `merge`. `down` ju
 
 > `readonly` **judge**: [`PanelJudge`](#paneljudge)
 
-Defined in: [runtime/personify/wave-types.ts:234](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L234)
+Defined in: [runtime/personify/wave-types.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L235)
 
 ##### verdict?
 
 > `readonly` `optional` **verdict?**: `DefaultVerdict`
 
-Defined in: [runtime/personify/wave-types.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L235)
+Defined in: [runtime/personify/wave-types.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L236)
 
 ##### output?
 
 > `readonly` `optional` **output?**: `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:237](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L237)
+Defined in: [runtime/personify/wave-types.ts:238](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L238)
 
 The judge child's raw output — what it was asked to assess, for a merge that quotes it.
 
@@ -3225,7 +3225,7 @@ The judge child's raw output — what it was asked to assess, for a merge that q
 
 > `readonly` **down**: `boolean`
 
-Defined in: [runtime/personify/wave-types.ts:239](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L239)
+Defined in: [runtime/personify/wave-types.ts:240](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L240)
 
 True when the judge child went `down` (no usable verdict — kept out of the merge denominator).
 
@@ -3233,7 +3233,7 @@ True when the judge child went `down` (no usable verdict — kept out of the mer
 
 ### VerifySpec
 
-Defined in: [runtime/personify/wave-types.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L256)
+Defined in: [runtime/personify/wave-types.ts:257](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L257)
 
 `verify({ implement, verifier })` — the 2-node sequential gate: an IMPLEMENT child produces a
 candidate, then a SEPARATE VERIFIER child's verdict GATES shippability. A `valid` verifier
@@ -3265,7 +3265,7 @@ shape under different personas; the gate rubric is the verifier persona's, not t
 
 > `readonly` `optional` **implementLabel?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:264](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L264)
+Defined in: [runtime/personify/wave-types.ts:265](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L265)
 
 Implement / verifier child labels (default `implement` / `verify` in the impl).
 
@@ -3273,7 +3273,7 @@ Implement / verifier child labels (default `implement` / `verify` in the impl).
 
 > `readonly` `optional` **verifierLabel?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:265](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L265)
+Defined in: [runtime/personify/wave-types.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L266)
 
 #### Methods
 
@@ -3281,7 +3281,7 @@ Defined in: [runtime/personify/wave-types.ts:265](https://github.com/tangle-netw
 
 > **implement**(`rootTask`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:258](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L258)
+Defined in: [runtime/personify/wave-types.ts:259](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L259)
 
 Build the implement child's task from the root task.
 
@@ -3303,7 +3303,7 @@ Build the implement child's task from the root task.
 
 > **verifier**(`candidate`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:260](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L260)
+Defined in: [runtime/personify/wave-types.ts:261](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L261)
 
 Build the verifier child's task from the implement child's settled candidate.
 
@@ -3325,7 +3325,7 @@ Build the verifier child's task from the implement child's settled candidate.
 
 > **collect**(`candidate`, `verdict`): [`Outcome`](#outcome-1)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:262](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L262)
+Defined in: [runtime/personify/wave-types.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L263)
 
 Project the gated (verifier-`valid`) candidate into the terminal deliverable.
 
@@ -3347,7 +3347,7 @@ Project the gated (verifier-`valid`) candidate into the terminal deliverable.
 
 ### WidenSpec
 
-Defined in: [runtime/personify/wave-types.ts:286](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L286)
+Defined in: [runtime/personify/wave-types.ts:287](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L287)
 
 `widen({ gate })` (G5) — the STREAMING spawn-on-completion driver. Unlike the static-fanout
 combinators above, the widener REACTS to each `scope.next()`: as each child settles it consults
@@ -3377,7 +3377,7 @@ mechanism ahead of the gate).
 
 > `readonly` **seeds**: readonly `Seed`[]
 
-Defined in: [runtime/personify/wave-types.ts:289](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L289)
+Defined in: [runtime/personify/wave-types.ts:290](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L290)
 
 The initial children to spawn before any widening — the seed lineages the gate widens from.
  One child task per seed; bounded by the conserved pool's fail-closed admission.
@@ -3386,7 +3386,7 @@ The initial children to spawn before any widening — the seed lineages the gate
 
 > `readonly` **gate**: [`ScopeWidenGate`](#scopewidengate)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:296](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L296)
+Defined in: [runtime/personify/wave-types.ts:297](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L297)
 
 The progressive-widening gate. Consulted on EVERY settled child with the round's
 trace-derived `findings`; returns a widen decision (spawn one more toward a lineage) or a
@@ -3398,7 +3398,7 @@ stop. DEFAULTS to flat via `flatWidenGate` — never widens, so the firewall sta
 
 > **seedTask**(`seed`, `index`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:290](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L290)
+Defined in: [runtime/personify/wave-types.ts:291](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L291)
 
 ###### Parameters
 
@@ -3422,7 +3422,7 @@ Defined in: [runtime/personify/wave-types.ts:290](https://github.com/tangle-netw
 
 > **widenTask**(`toward`, `ctx`): `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:298](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L298)
+Defined in: [runtime/personify/wave-types.ts:299](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L299)
 
 Build the widened child's task from the lineage the gate chose to extend.
 
@@ -3444,7 +3444,7 @@ Build the widened child's task from the lineage the gate chose to extend.
 
 > **synthesize**(`gathered`, `ctx`): [`Outcome`](#outcome-1)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:301](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L301)
+Defined in: [runtime/personify/wave-types.ts:302](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L302)
 
 Synthesize the terminal deliverable from every settled lineage (selector≠judge: the
  single-sourced selector over the gathered children, never a re-judge).
@@ -3467,7 +3467,7 @@ readonly [`Settled`](#settled-2)\<[`Outcome`](#outcome-1)\<`D`\>\>[]
 
 ### ScopeWidenGate
 
-Defined in: [runtime/personify/wave-types.ts:310](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L310)
+Defined in: [runtime/personify/wave-types.ts:311](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L311)
 
 The runtime widening gate (the reactive analogue of the keystone's `WidenGate`, lifted to read
 trace FINDINGS instead of a raw verdict). `decide` is consulted per settled child; it MUST
@@ -3486,7 +3486,7 @@ explicitly argued (the documented off-by-default escape hatch). Flat default nev
 
 > `readonly` `optional` **judgeExempt?**: `boolean`
 
-Defined in: [runtime/personify/wave-types.ts:318](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L318)
+Defined in: [runtime/personify/wave-types.ts:319](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L319)
 
 When true, `decide` may read `settled.verdict` directly — collides with the steer firewall,
  so it must be argued per cell, never defaulted on (mirrors the keystone `WidenGate`).
@@ -3497,7 +3497,7 @@ When true, `decide` may read `settled.verdict` directly — collides with the st
 
 > **decide**(`settled`, `findings`, `budget`): [`WidenDecision`](#widendecision)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:311](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L311)
+Defined in: [runtime/personify/wave-types.ts:312](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L312)
 
 ###### Parameters
 
@@ -3521,7 +3521,7 @@ readonly `AnalystFinding`[]
 
 ### WidenLineage
 
-Defined in: [runtime/personify/wave-types.ts:329](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L329)
+Defined in: [runtime/personify/wave-types.ts:330](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L330)
 
 A lineage the gate may widen toward — the settled child that looked promising + the findings
  that justified it (the trace-derived provenance the firewall requires).
@@ -3538,7 +3538,7 @@ A lineage the gate may widen toward — the settled child that looked promising
 
 > `readonly` **settled**: `object`
 
-Defined in: [runtime/personify/wave-types.ts:330](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L330)
+Defined in: [runtime/personify/wave-types.ts:331](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L331)
 
 ###### kind
 
@@ -3572,13 +3572,13 @@ Defined in: [runtime/personify/wave-types.ts:330](https://github.com/tangle-netw
 
 > `readonly` **findings**: readonly `AnalystFinding`[]
 
-Defined in: [runtime/personify/wave-types.ts:331](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L331)
+Defined in: [runtime/personify/wave-types.ts:332](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L332)
 
 ***
 
 ### ScopeAnalyst
 
-Defined in: [runtime/personify/wave-types.ts:358](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L358)
+Defined in: [runtime/personify/wave-types.ts:359](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L359)
 
 The reactive analyst seam — the PORT of the round-synchronous driver's `analyze` hook
 (dynamic.ts) onto the reactive `Scope`. The old driver wired the analyst at round
@@ -3603,7 +3603,7 @@ raw `verdict`. Fail loud — a throwing or non-array analyst aborts (no silent e
 
 > **analyze**(`input`): `Promise`\<readonly `AnalystFinding`[]\>
 
-Defined in: [runtime/personify/wave-types.ts:365](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L365)
+Defined in: [runtime/personify/wave-types.ts:366](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L366)
 
 Turn the children settled so far into trace-derived findings. `settledSoFar` is the cursor-
 ordered settlement list a combinator has drained (the reactive analogue of the old driver's
@@ -3624,7 +3624,7 @@ returning — a judge-derived finding is rejected, not filtered.
 
 ### ScopeAnalyzeInput
 
-Defined in: [runtime/personify/wave-types.ts:369](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L369)
+Defined in: [runtime/personify/wave-types.ts:370](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L370)
 
 Input to a `ScopeAnalyst.analyze` — the root task framing + the children settled so far.
 
@@ -3640,7 +3640,7 @@ Input to a `ScopeAnalyst.analyze` — the root task framing + the children settl
 
 > `readonly` **task**: `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:371](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L371)
+Defined in: [runtime/personify/wave-types.ts:372](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L372)
 
 Opaque root-task framing (whatever the combinator was invoked with).
 
@@ -3648,7 +3648,7 @@ Opaque root-task framing (whatever the combinator was invoked with).
 
 > `readonly` **settledSoFar**: readonly [`Settled`](#settled-2)\<[`Outcome`](#outcome-1)\<`D`\>\>[]
 
-Defined in: [runtime/personify/wave-types.ts:373](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L373)
+Defined in: [runtime/personify/wave-types.ts:374](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L374)
 
 The children this combinator has drained off `scope.next()`, in cursor order.
 
@@ -3656,7 +3656,7 @@ The children this combinator has drained off `scope.next()`, in cursor order.
 
 > `readonly` **nodeId**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:375](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L375)
+Defined in: [runtime/personify/wave-types.ts:376](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L376)
 
 This combinator's scope id (the trace-correlation root for the analyst).
 
@@ -3664,7 +3664,7 @@ This combinator's scope id (the trace-correlation root for the analyst).
 
 ### SteerContext
 
-Defined in: [runtime/personify/wave-types.ts:386](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L386)
+Defined in: [runtime/personify/wave-types.ts:387](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L387)
 
 How a combinator's `act` consumes findings to steer — the SINGLE firewalled steer surface a
 reactive combinator reads. `loopUntil.until`, `widen` gate, and any future steer all funnel
@@ -3685,19 +3685,19 @@ explicitly NOT for steering — reading it to steer is the coupling the architec
 
 > `readonly` **findings**: readonly `AnalystFinding`[]
 
-Defined in: [runtime/personify/wave-types.ts:387](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L387)
+Defined in: [runtime/personify/wave-types.ts:388](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L388)
 
 ##### settledSoFar
 
 > `readonly` **settledSoFar**: readonly [`Settled`](#settled-2)\<[`Outcome`](#outcome-1)\<`D`\>\>[]
 
-Defined in: [runtime/personify/wave-types.ts:388](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L388)
+Defined in: [runtime/personify/wave-types.ts:389](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L389)
 
 ##### lastValidScore?
 
 > `readonly` `optional` **lastValidScore?**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:391](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L391)
+Defined in: [runtime/personify/wave-types.ts:392](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L392)
 
 Observability-only: the best valid score seen so far. Rendering/trace use ONLY — steering
  off this re-introduces selector=judge. Marked so a reviewer catches a misuse.
@@ -3706,7 +3706,7 @@ Observability-only: the best valid score seen so far. Rendering/trace use ONLY 
 
 ### CorpusRecord
 
-Defined in: [runtime/personify/wave-types.ts:414](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L414)
+Defined in: [runtime/personify/wave-types.ts:415](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L415)
 
 One accreted fact in the cross-run corpus — the learning-flywheel's durable unit. DISTINCT from
 a `SpawnEvent` (a per-run decision record): a `CorpusRecord` is a fact a run LEARNED that a
@@ -3720,13 +3720,13 @@ relevant, high-confidence subset.
 
 > `readonly` **schemaVersion**: `"1.0.0"`
 
-Defined in: [runtime/personify/wave-types.ts:415](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L415)
+Defined in: [runtime/personify/wave-types.ts:416](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L416)
 
 ##### id
 
 > `readonly` **id**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:417](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L417)
+Defined in: [runtime/personify/wave-types.ts:418](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L418)
 
 Stable id over identity-defining fields (claim + tags) so a re-learned fact dedups.
 
@@ -3734,7 +3734,7 @@ Stable id over identity-defining fields (claim + tags) so a re-learned fact dedu
 
 > `readonly` **runId**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:419](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L419)
+Defined in: [runtime/personify/wave-types.ts:420](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L420)
 
 The run that produced this fact (the journal `runId`/`root`) — provenance back to the trace.
 
@@ -3742,13 +3742,13 @@ The run that produced this fact (the journal `runId`/`root`) — provenance back
 
 > `readonly` **producedAt**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:420](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L420)
+Defined in: [runtime/personify/wave-types.ts:421](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L421)
 
 ##### area
 
 > `readonly` **area**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:422](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L422)
+Defined in: [runtime/personify/wave-types.ts:423](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L423)
 
 Coarse classification the query/render filters on (free-form, mirrors `AnalystFinding.area`).
 
@@ -3756,7 +3756,7 @@ Coarse classification the query/render filters on (free-form, mirrors `AnalystFi
 
 > `readonly` **claim**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:424](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L424)
+Defined in: [runtime/personify/wave-types.ts:425](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L425)
 
 The accreted fact — the instruction-shaped statement the next run reads back.
 
@@ -3764,7 +3764,7 @@ The accreted fact — the instruction-shaped statement the next run reads back.
 
 > `readonly` `optional` **rationale?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:426](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L426)
+Defined in: [runtime/personify/wave-types.ts:427](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L427)
 
 Optional supporting detail the renderer may include under the claim.
 
@@ -3772,7 +3772,7 @@ Optional supporting detail the renderer may include under the claim.
 
 > `readonly` **tags**: readonly `string`[]
 
-Defined in: [runtime/personify/wave-types.ts:428](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L428)
+Defined in: [runtime/personify/wave-types.ts:429](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L429)
 
 Free-form tags for `query` filtering (domain, persona, surface).
 
@@ -3780,7 +3780,7 @@ Free-form tags for `query` filtering (domain, persona, surface).
 
 > `readonly` **confidence**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:430](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L430)
+Defined in: [runtime/personify/wave-types.ts:431](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L431)
 
 0..1 — the producing run's confidence in this fact (the render threshold reads it).
 
@@ -3788,7 +3788,7 @@ Defined in: [runtime/personify/wave-types.ts:430](https://github.com/tangle-netw
 
 > `readonly` `optional` **evidence?**: readonly `object`[]
 
-Defined in: [runtime/personify/wave-types.ts:432](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L432)
+Defined in: [runtime/personify/wave-types.ts:433](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L433)
 
 Optional provenance back into the run that learned it (a finding id / outRef / span).
 
@@ -3796,7 +3796,7 @@ Optional provenance back into the run that learned it (a finding id / outRef / s
 
 ### CorpusFilter
 
-Defined in: [runtime/personify/wave-types.ts:436](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L436)
+Defined in: [runtime/personify/wave-types.ts:437](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L437)
 
 A corpus query filter — every field is an AND-narrowing; an omitted field does not constrain.
 
@@ -3806,13 +3806,13 @@ A corpus query filter — every field is an AND-narrowing; an omitted field does
 
 > `readonly` `optional` **area?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:437](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L437)
+Defined in: [runtime/personify/wave-types.ts:438](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L438)
 
 ##### tags?
 
 > `readonly` `optional` **tags?**: readonly `string`[]
 
-Defined in: [runtime/personify/wave-types.ts:439](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L439)
+Defined in: [runtime/personify/wave-types.ts:440](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L440)
 
 Match records carrying ALL of these tags.
 
@@ -3820,7 +3820,7 @@ Match records carrying ALL of these tags.
 
 > `readonly` `optional` **minConfidence?**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:441](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L441)
+Defined in: [runtime/personify/wave-types.ts:442](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L442)
 
 Minimum confidence a record must clear to be returned (the render gate).
 
@@ -3828,7 +3828,7 @@ Minimum confidence a record must clear to be returned (the render gate).
 
 > `readonly` `optional` **runId?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:443](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L443)
+Defined in: [runtime/personify/wave-types.ts:444](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L444)
 
 Only records from this run (rare — usually a cross-run read).
 
@@ -3836,7 +3836,7 @@ Only records from this run (rare — usually a cross-run read).
 
 > `readonly` `optional` **limit?**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:445](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L445)
+Defined in: [runtime/personify/wave-types.ts:446](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L446)
 
 Cap the result count (most-confident first in the impl).
 
@@ -3844,7 +3844,7 @@ Cap the result count (most-confident first in the impl).
 
 ### Corpus
 
-Defined in: [runtime/personify/wave-types.ts:458](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L458)
+Defined in: [runtime/personify/wave-types.ts:459](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L459)
 
 The durable cross-run corpus — the learning-flywheel store. DISTINCT from `SpawnJournal`
 (per-run decisions, replay) and `ResultBlobStore` (per-run payloads): `Corpus` holds accreted
@@ -3861,7 +3861,7 @@ Fail-loud, typed-outcome boundary: `append` is idempotent on an identical record
 
 > **append**(`record`): `Promise`\<\{ `succeeded`: `true`; \} \| \{ `succeeded`: `false`; `error`: `string`; \}\>
 
-Defined in: [runtime/personify/wave-types.ts:461](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L461)
+Defined in: [runtime/personify/wave-types.ts:462](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L462)
 
 Append one accreted fact. Idempotent on an identical record; returns a typed outcome —
  inspect `succeeded` before treating it as durable (no silent write-through on conflict).
@@ -3880,7 +3880,7 @@ Append one accreted fact. Idempotent on an identical record; returns a typed out
 
 > **query**(`filter`): `Promise`\<readonly [`CorpusRecord`](#corpusrecord)[]\>
 
-Defined in: [runtime/personify/wave-types.ts:464](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L464)
+Defined in: [runtime/personify/wave-types.ts:465](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L465)
 
 Query accreted facts by filter — most-confident first. Returns the matching records (an
  empty array when none match is a valid result, NOT an error).
@@ -3899,7 +3899,7 @@ Query accreted facts by filter — most-confident first. Returns the matching re
 
 ### RenderCorpusToInstructionsOptions
 
-Defined in: [runtime/personify/wave-types.ts:478](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L478)
+Defined in: [runtime/personify/wave-types.ts:479](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L479)
 
 Project accreted corpus facts into an `AgentProfile`'s instruction seams — the learning-flywheel
 READ side. Reads the corpus through `filter`, renders the matching facts into instruction lines,
@@ -3917,19 +3917,19 @@ wants the single-blob `resources.instructions` form passes `target: 'resources'`
 
 > `readonly` **corpus**: [`Corpus`](#corpus-2)
 
-Defined in: [runtime/personify/wave-types.ts:479](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L479)
+Defined in: [runtime/personify/wave-types.ts:480](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L480)
 
 ##### filter
 
 > `readonly` **filter**: [`CorpusFilter`](#corpusfilter)
 
-Defined in: [runtime/personify/wave-types.ts:480](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L480)
+Defined in: [runtime/personify/wave-types.ts:481](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L481)
 
 ##### profile
 
 > `readonly` **profile**: `AgentProfile`
 
-Defined in: [runtime/personify/wave-types.ts:482](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L482)
+Defined in: [runtime/personify/wave-types.ts:483](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L483)
 
 The profile to project the facts into. The result is a fresh profile — the input is unchanged.
 
@@ -3937,7 +3937,7 @@ The profile to project the facts into. The result is a fresh profile — the inp
 
 > `readonly` `optional` **target?**: `"resources"` \| `"prompt"`
 
-Defined in: [runtime/personify/wave-types.ts:485](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L485)
+Defined in: [runtime/personify/wave-types.ts:486](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L486)
 
 Where the rendered facts land: appended to `prompt.instructions[]` (default) or folded into
  the single-blob `resources.instructions` string.
@@ -3946,7 +3946,7 @@ Where the rendered facts land: appended to `prompt.instructions[]` (default) or
 
 > `readonly` `optional` **maxLines?**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:487](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L487)
+Defined in: [runtime/personify/wave-types.ts:488](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L488)
 
 Optional cap on rendered lines (most-confident first), independent of the query `limit`.
 
@@ -3954,7 +3954,7 @@ Optional cap on rendered lines (most-confident first), independent of the query
 
 ### TrajectoryNode
 
-Defined in: [runtime/personify/wave-types.ts:506](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L506)
+Defined in: [runtime/personify/wave-types.ts:507](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L507)
 
 One node in the reconstructed trajectory tree — a driver OR a leaf, with its OWN spend and the
 spend ROLLED UP over its subtree. Reconstructed from the `SpawnJournal` (structure + per-node
@@ -3967,37 +3967,37 @@ shape: `parent`/`children` are the actual spawn edges the run took, not a planne
 
 > `readonly` **id**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:507](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L507)
+Defined in: [runtime/personify/wave-types.ts:508](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L508)
 
 ##### parent?
 
 > `readonly` `optional` **parent?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:508](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L508)
+Defined in: [runtime/personify/wave-types.ts:509](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L509)
 
 ##### children
 
 > `readonly` **children**: readonly `string`[]
 
-Defined in: [runtime/personify/wave-types.ts:509](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L509)
+Defined in: [runtime/personify/wave-types.ts:510](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L510)
 
 ##### label
 
 > `readonly` **label**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:510](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L510)
+Defined in: [runtime/personify/wave-types.ts:511](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L511)
 
 ##### runtime
 
 > `readonly` **runtime**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:511](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L511)
+Defined in: [runtime/personify/wave-types.ts:512](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L512)
 
 ##### status
 
 > `readonly` **status**: `"failed"` \| `"cancelled"` \| `"pending"` \| `"done"`
 
-Defined in: [runtime/personify/wave-types.ts:513](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L513)
+Defined in: [runtime/personify/wave-types.ts:514](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L514)
 
 Terminal status the journal recorded for this node.
 
@@ -4005,7 +4005,7 @@ Terminal status the journal recorded for this node.
 
 > `readonly` **ownSpend**: [`Spend`](#spend)
 
-Defined in: [runtime/personify/wave-types.ts:515](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L515)
+Defined in: [runtime/personify/wave-types.ts:516](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L516)
 
 This node's OWN conserved spend (from its `settled` event).
 
@@ -4013,7 +4013,7 @@ This node's OWN conserved spend (from its `settled` event).
 
 > `readonly` **rolledUpSpend**: [`Spend`](#spend)
 
-Defined in: [runtime/personify/wave-types.ts:518](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L518)
+Defined in: [runtime/personify/wave-types.ts:519](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L519)
 
 This node's spend PLUS every descendant's — the rolled-up subtree cost. The cost a parent
  "really" consumed inclusive of its children's fanout (the equal-k-on-cost basis).
@@ -4022,7 +4022,7 @@ This node's spend PLUS every descendant's — the rolled-up subtree cost. The co
 
 > `readonly` `optional` **verdict?**: `DefaultVerdict`
 
-Defined in: [runtime/personify/wave-types.ts:520](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L520)
+Defined in: [runtime/personify/wave-types.ts:521](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L521)
 
 The node's verdict, when its settlement carried one (observability — NOT a steer input).
 
@@ -4030,7 +4030,7 @@ The node's verdict, when its settlement carried one (observability — NOT a ste
 
 > `readonly` `optional` **output?**: `unknown`
 
-Defined in: [runtime/personify/wave-types.ts:522](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L522)
+Defined in: [runtime/personify/wave-types.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L523)
 
 The rehydrated output artifact, when `withOutputs` was requested + the blob resolved.
 
@@ -4038,13 +4038,13 @@ The rehydrated output artifact, when `withOutputs` was requested + the blob reso
 
 > `readonly` `optional` **outRef?**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L523)
+Defined in: [runtime/personify/wave-types.ts:524](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L524)
 
 ***
 
 ### TrajectoryReport
 
-Defined in: [runtime/personify/wave-types.ts:528](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L528)
+Defined in: [runtime/personify/wave-types.ts:529](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L529)
 
 The whole reconstructed trajectory — the realized tree + its root-rolled-up total. The
  per-node + rolled-up `Spend` is the evidence both the trace viewer and `equalKOnCost` read.
@@ -4055,13 +4055,13 @@ The whole reconstructed trajectory — the realized tree + its root-rolled-up to
 
 > `readonly` **root**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:529](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L529)
+Defined in: [runtime/personify/wave-types.ts:530](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L530)
 
 ##### nodes
 
 > `readonly` **nodes**: readonly [`TrajectoryNode`](#trajectorynode)[]
 
-Defined in: [runtime/personify/wave-types.ts:531](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L531)
+Defined in: [runtime/personify/wave-types.ts:532](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L532)
 
 Every node, in cursor/spawn order — the realized tree (`parent`/`children` are the real edges).
 
@@ -4069,7 +4069,7 @@ Every node, in cursor/spawn order — the realized tree (`parent`/`children` are
 
 > `readonly` **total**: [`Spend`](#spend)
 
-Defined in: [runtime/personify/wave-types.ts:533](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L533)
+Defined in: [runtime/personify/wave-types.ts:534](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L534)
 
 The root's rolled-up spend — the whole run's conserved total (tokens + usd + iterations + ms).
 
@@ -4077,7 +4077,7 @@ The root's rolled-up spend — the whole run's conserved total (tokens + usd + i
 
 > `readonly` **statusCounts**: `Readonly`\<`Record`\<[`TrajectoryNode`](#trajectorynode)\[`"status"`\], `number`\>\>
 
-Defined in: [runtime/personify/wave-types.ts:535](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L535)
+Defined in: [runtime/personify/wave-types.ts:536](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L536)
 
 Count of nodes by terminal status — a quick "how did the tree end" readout.
 
@@ -4085,7 +4085,7 @@ Count of nodes by terminal status — a quick "how did the tree end" readout.
 
 ### TrajectoryReportOptions
 
-Defined in: [runtime/personify/wave-types.ts:545](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L545)
+Defined in: [runtime/personify/wave-types.ts:546](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L546)
 
 `trajectoryReport(journal, blobs, root, { withOutputs? })` — reconstruct the whole tree with
 per-node + rolled-up `Spend`. Reads the journal for structure + spend and (when `withOutputs`)
@@ -4099,7 +4099,7 @@ impl lives in `trajectory.ts`.
 
 > `readonly` `optional` **withOutputs?**: `boolean`
 
-Defined in: [runtime/personify/wave-types.ts:547](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L547)
+Defined in: [runtime/personify/wave-types.ts:548](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L548)
 
 Rehydrate each `done` node's `output` from the blob store. Off by default (cost-only report).
 
@@ -4107,7 +4107,7 @@ Rehydrate each `done` node's `output` from the blob store. Off by default (cost-
 
 ### EqualKArm
 
-Defined in: [runtime/personify/wave-types.ts:566](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L566)
+Defined in: [runtime/personify/wave-types.ts:567](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L567)
 
 One arm of an equal-k comparison — a labeled trajectory (a `TrajectoryReport` is one arm's whole
 run). The arm's conserved COST is `report.total` (tokens + usd), which the sandbox executor
@@ -4122,19 +4122,19 @@ iteration count.
 
 > `readonly` **label**: `string`
 
-Defined in: [runtime/personify/wave-types.ts:567](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L567)
+Defined in: [runtime/personify/wave-types.ts:568](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L568)
 
 ##### report
 
 > `readonly` **report**: [`TrajectoryReport`](#trajectoryreport-3)
 
-Defined in: [runtime/personify/wave-types.ts:568](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L568)
+Defined in: [runtime/personify/wave-types.ts:569](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L569)
 
 ***
 
 ### EqualKVerdict
 
-Defined in: [runtime/personify/wave-types.ts:577](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L577)
+Defined in: [runtime/personify/wave-types.ts:578](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L578)
 
 The equal-k-on-cost verdict: whether every arm spent within `tolerance` of the others on the
 CONSERVED cost channels (tokens + usd), so a downstream metric comparison is "at equal k". Per-
@@ -4147,13 +4147,13 @@ NOT comparable at equal compute — a confound to report, not a result to publis
 
 > `readonly` **withinTolerance**: `boolean`
 
-Defined in: [runtime/personify/wave-types.ts:578](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L578)
+Defined in: [runtime/personify/wave-types.ts:579](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L579)
 
 ##### arms
 
 > `readonly` **arms**: readonly `object`[]
 
-Defined in: [runtime/personify/wave-types.ts:580](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L580)
+Defined in: [runtime/personify/wave-types.ts:581](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L581)
 
 Per-arm conserved cost (the basis: tokens total + usd).
 
@@ -4161,7 +4161,7 @@ Per-arm conserved cost (the basis: tokens total + usd).
 
 > `readonly` **spread**: `object`
 
-Defined in: [runtime/personify/wave-types.ts:587](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L587)
+Defined in: [runtime/personify/wave-types.ts:588](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L588)
 
 The realized spread on each channel (max − min across arms), for the report.
 
@@ -4177,7 +4177,7 @@ The realized spread on each channel (max − min across arms), for the report.
 
 > `readonly` **tolerance**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:589](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L589)
+Defined in: [runtime/personify/wave-types.ts:590](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L590)
 
 The fractional tolerance the check used (spread / median ≤ tolerance per channel).
 
@@ -4185,7 +4185,7 @@ The fractional tolerance the check used (spread / median ≤ tolerance per chann
 
 ### EqualKOnCostOptions
 
-Defined in: [runtime/personify/wave-types.ts:599](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L599)
+Defined in: [runtime/personify/wave-types.ts:600](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L600)
 
 `equalKOnCost(arms, { tolerance? })` — assert arms are comparable at EQUAL conserved COST
 (tokens + usd), NOT raw iteration count. The conserved-pool guarantees `Σk` equal by
@@ -4199,7 +4199,7 @@ impl lives in `trajectory.ts`. Pure over the reports — no I/O.
 
 > `readonly` `optional` **tolerance?**: `number`
 
-Defined in: [runtime/personify/wave-types.ts:602](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L602)
+Defined in: [runtime/personify/wave-types.ts:603](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L603)
 
 Max fractional spread (spread/median) per channel for arms to count as equal-k. Default in
  the impl (e.g. 0.05). A tighter tolerance = a stricter equal-compute claim.
@@ -4628,7 +4628,7 @@ Derived from usage via `estimateCost` when the model is priced; else undefined.
 
 ### RouterToolCall
 
-Defined in: [runtime/router-client.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L166)
+Defined in: [runtime/router-client.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L167)
 
 A tool-call the model emitted (provider-neutral; mirrors the runtime's ToolCallRequest).
 
@@ -4638,19 +4638,19 @@ A tool-call the model emitted (provider-neutral; mirrors the runtime's ToolCallR
 
 > **id**: `string`
 
-Defined in: [runtime/router-client.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L167)
+Defined in: [runtime/router-client.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L168)
 
 ##### name
 
 > **name**: `string`
 
-Defined in: [runtime/router-client.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L168)
+Defined in: [runtime/router-client.ts:169](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L169)
 
 ##### arguments
 
 > **arguments**: `string`
 
-Defined in: [runtime/router-client.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L170)
+Defined in: [runtime/router-client.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L171)
 
 Raw JSON arguments string as emitted by the model.
 
@@ -4658,7 +4658,7 @@ Raw JSON arguments string as emitted by the model.
 
 ### RouterChatToolsResult
 
-Defined in: [runtime/router-client.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L173)
+Defined in: [runtime/router-client.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L174)
 
 #### Properties
 
@@ -4666,19 +4666,19 @@ Defined in: [runtime/router-client.ts:173](https://github.com/tangle-network/age
 
 > **content**: `string` \| `null`
 
-Defined in: [runtime/router-client.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L174)
+Defined in: [runtime/router-client.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L175)
 
 ##### toolCalls
 
 > **toolCalls**: [`RouterToolCall`](#routertoolcall)[]
 
-Defined in: [runtime/router-client.ts:175](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L175)
+Defined in: [runtime/router-client.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L176)
 
 ##### usage?
 
 > `optional` **usage?**: `object`
 
-Defined in: [runtime/router-client.ts:176](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L176)
+Defined in: [runtime/router-client.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L177)
 
 ###### input
 
@@ -4692,13 +4692,13 @@ Defined in: [runtime/router-client.ts:176](https://github.com/tangle-network/age
 
 > `optional` **costUsd?**: `number`
 
-Defined in: [runtime/router-client.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L177)
+Defined in: [runtime/router-client.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L178)
 
 ***
 
 ### ToolSpec
 
-Defined in: [runtime/router-client.ts:253](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L253)
+Defined in: [runtime/router-client.ts:254](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L254)
 
 #### Properties
 
@@ -4706,13 +4706,13 @@ Defined in: [runtime/router-client.ts:253](https://github.com/tangle-network/age
 
 > **type**: `"function"`
 
-Defined in: [runtime/router-client.ts:254](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L254)
+Defined in: [runtime/router-client.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L255)
 
 ##### function
 
 > **function**: `object`
 
-Defined in: [runtime/router-client.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L255)
+Defined in: [runtime/router-client.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L256)
 
 ###### name
 
@@ -4730,7 +4730,7 @@ Defined in: [runtime/router-client.ts:255](https://github.com/tangle-network/age
 
 ### RouterToolLoopResult
 
-Defined in: [runtime/router-client.ts:258](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L258)
+Defined in: [runtime/router-client.ts:259](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L259)
 
 #### Properties
 
@@ -4738,7 +4738,7 @@ Defined in: [runtime/router-client.ts:258](https://github.com/tangle-network/age
 
 > **final**: `string`
 
-Defined in: [runtime/router-client.ts:260](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L260)
+Defined in: [runtime/router-client.ts:261](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L261)
 
 The model's final assistant text (the turn where it stopped calling tools, or the budget turn).
 
@@ -4746,7 +4746,7 @@ The model's final assistant text (the turn where it stopped calling tools, or th
 
 > **turns**: `number`
 
-Defined in: [runtime/router-client.ts:262](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L262)
+Defined in: [runtime/router-client.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L263)
 
 Inference turns spent (≤ maxTurns) — the equal-budget unit vs random@k.
 
@@ -4754,13 +4754,13 @@ Inference turns spent (≤ maxTurns) — the equal-budget unit vs random@k.
 
 > **toolCalls**: `number`
 
-Defined in: [runtime/router-client.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L263)
+Defined in: [runtime/router-client.ts:264](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L264)
 
 ##### toolTrace
 
 > **toolTrace**: `object`[]
 
-Defined in: [runtime/router-client.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L266)
+Defined in: [runtime/router-client.ts:267](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L267)
 
 The behavior trace: each tool call + its result, in order. What a trace-analyst
  steerer reads (behavior, never the verdict) to diagnose + redirect the next shot.
@@ -4781,7 +4781,7 @@ The behavior trace: each tool call + its result, in order. What a trace-analyst
 
 > **usage**: `object`
 
-Defined in: [runtime/router-client.ts:267](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L267)
+Defined in: [runtime/router-client.ts:268](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L268)
 
 ###### input
 
@@ -4795,7 +4795,7 @@ Defined in: [runtime/router-client.ts:267](https://github.com/tangle-network/age
 
 > **messages**: `Record`\<`string`, `unknown`\>[]
 
-Defined in: [runtime/router-client.ts:270](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L270)
+Defined in: [runtime/router-client.ts:271](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L271)
 
 The full conversation after the loop (seed + every assistant/tool turn). Lets a caller
  CARRY the messages into the next shot (depth continuation) and read the trajectory.
@@ -5065,7 +5065,9 @@ Defined in: [runtime/run-benchmark.ts:92](https://github.com/tangle-network/agen
 
 ### BenchmarkReport
 
-Defined in: [runtime/run-benchmark.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L95)
+Defined in: [runtime/run-benchmark.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L96)
+
+Benchmark output: per-strategy means plus the full per-task × per-strategy losses table an optimizer mines.
 
 #### Properties
 
@@ -5073,19 +5075,19 @@ Defined in: [runtime/run-benchmark.ts:95](https://github.com/tangle-network/agen
 
 > **n**: `number`
 
-Defined in: [runtime/run-benchmark.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L96)
+Defined in: [runtime/run-benchmark.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L97)
 
 ##### excluded
 
 > **excluded**: `number`
 
-Defined in: [runtime/run-benchmark.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L97)
+Defined in: [runtime/run-benchmark.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L98)
 
 ##### perStrategy
 
 > **perStrategy**: `Record`\<`string`, [`BenchmarkStrategySummary`](#benchmarkstrategysummary)\>
 
-Defined in: [runtime/run-benchmark.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L99)
+Defined in: [runtime/run-benchmark.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L100)
 
 Per-strategy means (keyed by strategy.name).
 
@@ -5093,7 +5095,7 @@ Per-strategy means (keyed by strategy.name).
 
 > **perTask**: [`BenchmarkTaskRow`](#benchmarktaskrow)[]
 
-Defined in: [runtime/run-benchmark.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L102)
+Defined in: [runtime/run-benchmark.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L103)
 
 The full per-task × per-strategy table — the LOSSES an optimizer (GEPA, a
  strategy-author, an operator) consumes. Includes errored tasks with the reason.
@@ -5102,7 +5104,7 @@ The full per-task × per-strategy table — the LOSSES an optimizer (GEPA, a
 
 > **pareto**: `string`[]
 
-Defined in: [runtime/run-benchmark.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L105)
+Defined in: [runtime/run-benchmark.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L106)
 
 The non-dominated strategies on (score ↑, $/task ↓) — collapse-last, per the canon:
  a strategy that ties on score at half the cost WINS and a scalar would hide it.
@@ -5111,7 +5113,7 @@ The non-dominated strategies on (score ↑, $/task ↓) — collapse-last, per t
 
 > `optional` **refineVsSample?**: [`BenchmarkLift`](#benchmarklift)
 
-Defined in: [runtime/run-benchmark.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L107)
+Defined in: [runtime/run-benchmark.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L108)
 
 The headline when both `refine` and `sample` ran: paired-bootstrap lift of refine over sample.
 
@@ -5119,7 +5121,7 @@ The headline when both `refine` and `sample` ran: paired-bootstrap lift of refin
 
 ### SandboxCapabilities
 
-Defined in: [runtime/sandbox-capabilities.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L26)
+Defined in: [runtime/sandbox-capabilities.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L27)
 
 **`Experimental`**
 
@@ -5134,7 +5136,7 @@ universal SDK feature that needs no probe.
 
 > **canFork**: `boolean`
 
-Defined in: [runtime/sandbox-capabilities.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L32)
+Defined in: [runtime/sandbox-capabilities.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L33)
 
 **`Experimental`**
 
@@ -5146,7 +5148,7 @@ result, no shared context prefix.
 
 ### CriuCapableClient
 
-Defined in: [runtime/sandbox-capabilities.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L73)
+Defined in: [runtime/sandbox-capabilities.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L74)
 
 **`Experimental`**
 
@@ -5160,7 +5162,7 @@ read without importing sandbox-backend specifics.
 
 > `optional` **criuStatus?**: () => `Promise`\<\{ `available`: `boolean`; `criuVersion?`: `string`; `reason?`: `string`; \}\>
 
-Defined in: [runtime/sandbox-capabilities.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L74)
+Defined in: [runtime/sandbox-capabilities.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L75)
 
 **`Experimental`**
 
@@ -5172,7 +5174,7 @@ Defined in: [runtime/sandbox-capabilities.ts:74](https://github.com/tangle-netwo
 
 ### SandboxLineageHandle
 
-Defined in: [runtime/sandbox-lineage.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L113)
+Defined in: [runtime/sandbox-lineage.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L114)
 
 **`Experimental`**
 
@@ -5186,7 +5188,7 @@ the kernel beyond `box` (for placement/teardown) and `sessionId` (trace).
 
 > **box**: `SandboxInstance`
 
-Defined in: [runtime/sandbox-lineage.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L115)
+Defined in: [runtime/sandbox-lineage.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L116)
 
 **`Experimental`**
 
@@ -5196,7 +5198,7 @@ The owned, running sandbox this handle drives.
 
 > **sessionId**: `string`
 
-Defined in: [runtime/sandbox-lineage.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L122)
+Defined in: [runtime/sandbox-lineage.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L123)
 
 **`Experimental`**
 
@@ -5209,7 +5211,7 @@ the shared context comes from the checkpoint, not a shared session id.
 
 ### SandboxLineage
 
-Defined in: [runtime/sandbox-lineage.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L131)
+Defined in: [runtime/sandbox-lineage.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L132)
 
 **`Experimental`**
 
@@ -5222,7 +5224,7 @@ capability-gated lifecycle moves. Construct via `createSandboxLineage`.
 
 > **start**(`spec`, `prompt`, `signal`): `Promise`\<\{ `handle`: [`SandboxLineageHandle`](#sandboxlineagehandle); `events`: `AsyncIterable`\<`SandboxEvent`\>; \}\>
 
-Defined in: [runtime/sandbox-lineage.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L136)
+Defined in: [runtime/sandbox-lineage.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L137)
 
 **`Experimental`**
 
@@ -5251,7 +5253,7 @@ the live `streamPrompt` iterable for the first turn (caller drains it).
 
 > **continue**(`handle`, `prompt`, `signal`): `Promise`\<`AsyncIterable`\<`SandboxEvent`, `any`, `any`\>\>
 
-Defined in: [runtime/sandbox-lineage.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L148)
+Defined in: [runtime/sandbox-lineage.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L149)
 
 **`Experimental`**
 
@@ -5283,7 +5285,7 @@ of a contextless turn the caller mistakes for a real continuation.
 
 > **fork**(`parent`, `prompts`, `specs`, `signal`): `Promise`\<`object`[]\>
 
-Defined in: [runtime/sandbox-lineage.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L164)
+Defined in: [runtime/sandbox-lineage.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L165)
 
 **`Experimental`**
 
@@ -5323,7 +5325,7 @@ streams `prompts[i]`. Child-box creation is bounded by `maxConcurrency`.
 
 > **prune**(`keep`): `Promise`\<`void`\>
 
-Defined in: [runtime/sandbox-lineage.ts:177](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L177)
+Defined in: [runtime/sandbox-lineage.ts:178](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L178)
 
 **`Experimental`**
 
@@ -5347,7 +5349,7 @@ Best-effort, bounded, parallel — a failed delete never throws.
 
 > **teardown**(): `Promise`\<`void`\>
 
-Defined in: [runtime/sandbox-lineage.ts:179](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L179)
+Defined in: [runtime/sandbox-lineage.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L180)
 
 **`Experimental`**
 
@@ -5361,7 +5363,7 @@ Destroy every box this lineage owns. Best-effort, bounded, parallel.
 
 ### CheckpointCapableBox
 
-Defined in: [runtime/sandbox-lineage.ts:383](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L383)
+Defined in: [runtime/sandbox-lineage.ts:384](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L384)
 
 **`Experimental`**
 
@@ -5376,7 +5378,7 @@ without importing sandbox-backend specifics.
 
 > `optional` **checkpoint?**: (`options?`) => `Promise`\<\{ `checkpointId`: `string`; \}\>
 
-Defined in: [runtime/sandbox-lineage.ts:384](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L384)
+Defined in: [runtime/sandbox-lineage.ts:385](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L385)
 
 **`Experimental`**
 
@@ -5400,7 +5402,7 @@ Defined in: [runtime/sandbox-lineage.ts:384](https://github.com/tangle-network/a
 
 ### ForkCapableBox
 
-Defined in: [runtime/sandbox-lineage.ts:390](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L390)
+Defined in: [runtime/sandbox-lineage.ts:391](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L391)
 
 **`Experimental`**
 
@@ -5412,7 +5414,7 @@ Loop-side widening of the box's optional fork method.
 
 > `optional` **fork?**: (`checkpointId`, `options?`) => `Promise`\<`SandboxInstance`\>
 
-Defined in: [runtime/sandbox-lineage.ts:391](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L391)
+Defined in: [runtime/sandbox-lineage.ts:392](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L392)
 
 **`Experimental`**
 
@@ -5436,7 +5438,7 @@ Defined in: [runtime/sandbox-lineage.ts:391](https://github.com/tangle-network/a
 
 ### SessionCapableBox
 
-Defined in: [runtime/sandbox-lineage.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L401)
+Defined in: [runtime/sandbox-lineage.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L402)
 
 **`Experimental`**
 
@@ -5451,7 +5453,7 @@ fakes. `status()` resolves `null` when the id is unknown to the sandbox.
 
 > `optional` **session?**: (`id`) => `object`
 
-Defined in: [runtime/sandbox-lineage.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L402)
+Defined in: [runtime/sandbox-lineage.ts:403](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L403)
 
 **`Experimental`**
 
@@ -5477,7 +5479,7 @@ Defined in: [runtime/sandbox-lineage.ts:402](https://github.com/tangle-network/a
 
 ### TurnResult
 
-Defined in: [runtime/sandbox-run.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L60)
+Defined in: [runtime/sandbox-run.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L62)
 
 **`Experimental`**
 
@@ -5497,7 +5499,7 @@ nothing" from a transport/FS fault.
 
 > **out**: `Out`
 
-Defined in: [runtime/sandbox-run.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L61)
+Defined in: [runtime/sandbox-run.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L63)
 
 **`Experimental`**
 
@@ -5505,7 +5507,7 @@ Defined in: [runtime/sandbox-run.ts:61](https://github.com/tangle-network/agent-
 
 > **events**: `SandboxEvent`[]
 
-Defined in: [runtime/sandbox-run.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L62)
+Defined in: [runtime/sandbox-run.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L64)
 
 **`Experimental`**
 
@@ -5513,7 +5515,7 @@ Defined in: [runtime/sandbox-run.ts:62](https://github.com/tangle-network/agent-
 
 > `optional` **readError?**: `string`
 
-Defined in: [runtime/sandbox-run.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L63)
+Defined in: [runtime/sandbox-run.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L65)
 
 **`Experimental`**
 
@@ -5521,7 +5523,7 @@ Defined in: [runtime/sandbox-run.ts:63](https://github.com/tangle-network/agent-
 
 ### SandboxRun
 
-Defined in: [runtime/sandbox-run.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L91)
+Defined in: [runtime/sandbox-run.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L94)
 
 **`Experimental`**
 
@@ -5540,7 +5542,7 @@ A live run over ONE persistent artifact (box + session). Close it
 
 > `readonly` **box**: `SandboxInstance`
 
-Defined in: [runtime/sandbox-run.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L92)
+Defined in: [runtime/sandbox-run.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L95)
 
 **`Experimental`**
 
@@ -5548,7 +5550,7 @@ Defined in: [runtime/sandbox-run.ts:92](https://github.com/tangle-network/agent-
 
 > `readonly` **sessionId**: `string`
 
-Defined in: [runtime/sandbox-run.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L93)
+Defined in: [runtime/sandbox-run.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L96)
 
 **`Experimental`**
 
@@ -5558,7 +5560,7 @@ Defined in: [runtime/sandbox-run.ts:93](https://github.com/tangle-network/agent-
 
 > **start**(`prompt`): `Promise`\<[`TurnResult`](#turnresult)\<`Out`\>\>
 
-Defined in: [runtime/sandbox-run.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L95)
+Defined in: [runtime/sandbox-run.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L98)
 
 **`Experimental`**
 
@@ -5578,7 +5580,7 @@ First turn over the fresh box (mints the session). Throws if already started.
 
 > **resume**(`prompt`): `Promise`\<[`TurnResult`](#turnresult)\<`Out`\>\>
 
-Defined in: [runtime/sandbox-run.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L97)
+Defined in: [runtime/sandbox-run.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L100)
 
 **`Experimental`**
 
@@ -5598,7 +5600,7 @@ Continue THE SAME session over THE SAME artifact — a resumed turn/rollout.
 
 > **close**(): `Promise`\<`void`\>
 
-Defined in: [runtime/sandbox-run.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L98)
+Defined in: [runtime/sandbox-run.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L101)
 
 **`Experimental`**
 
@@ -5610,7 +5612,7 @@ Defined in: [runtime/sandbox-run.ts:98](https://github.com/tangle-network/agent-
 
 ### OpenSandboxRunOptions
 
-Defined in: [runtime/sandbox-run.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L102)
+Defined in: [runtime/sandbox-run.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L105)
 
 **`Experimental`**
 
@@ -5620,7 +5622,7 @@ Defined in: [runtime/sandbox-run.ts:102](https://github.com/tangle-network/agent
 
 > **agentRun**: [`AgentRunSpec`](#agentrunspec)\<`string`\>
 
-Defined in: [runtime/sandbox-run.ts:104](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L104)
+Defined in: [runtime/sandbox-run.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L107)
 
 **`Experimental`**
 
@@ -5630,7 +5632,7 @@ Profile + sandbox env/overrides. `sandboxOverrides.backend.type` is the harness.
 
 > **signal**: `AbortSignal`
 
-Defined in: [runtime/sandbox-run.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L105)
+Defined in: [runtime/sandbox-run.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L108)
 
 **`Experimental`**
 
@@ -5638,7 +5640,7 @@ Defined in: [runtime/sandbox-run.ts:105](https://github.com/tangle-network/agent
 
 > `optional` **hooks?**: [`RuntimeHooks`](index.md#runtimehooks)
 
-Defined in: [runtime/sandbox-run.ts:107](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L107)
+Defined in: [runtime/sandbox-run.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L110)
 
 **`Experimental`**
 
@@ -5648,7 +5650,7 @@ Optional execution-scoped observers. Hook failures never fail the run.
 
 > `optional` **runId?**: `string`
 
-Defined in: [runtime/sandbox-run.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L109)
+Defined in: [runtime/sandbox-run.ts:112](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L112)
 
 **`Experimental`**
 
@@ -5658,7 +5660,7 @@ Stable run id for trace joins. Defaults to a short runtime-minted id.
 
 > `optional` **scenarioId?**: `string`
 
-Defined in: [runtime/sandbox-run.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L111)
+Defined in: [runtime/sandbox-run.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L114)
 
 **`Experimental`**
 
@@ -5668,7 +5670,7 @@ Optional benchmark/scenario id carried into emitted hook events.
 
 > `optional` **now?**: () => `number`
 
-Defined in: [runtime/sandbox-run.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L113)
+Defined in: [runtime/sandbox-run.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L116)
 
 **`Experimental`**
 
@@ -5682,7 +5684,7 @@ Test seam for deterministic hook timestamps. Defaults to `Date.now`.
 
 > `optional` **maxConcurrency?**: `number`
 
-Defined in: [runtime/sandbox-run.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L115)
+Defined in: [runtime/sandbox-run.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L118)
 
 **`Experimental`**
 
@@ -5692,7 +5694,7 @@ Bounds box-creation bursts inside lineage fanout. Default from lineage.
 
 > `optional` **readRetryDelayMs?**: `number`
 
-Defined in: [runtime/sandbox-run.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L118)
+Defined in: [runtime/sandbox-run.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L121)
 
 **`Experimental`**
 
@@ -5703,7 +5705,7 @@ Base backoff (ms) for retrying a transient artifact `fs.read` failure; the i-th
 
 ### NaiveDriverOptions
 
-Defined in: [runtime/steering-drivers.ts:81](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L81)
+Defined in: [runtime/steering-drivers.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L82)
 
 Options for [naiveDriver](#naivedriver).
 
@@ -5719,7 +5721,7 @@ Options for [naiveDriver](#naivedriver).
 
 > **continuation**: `string`
 
-Defined in: [runtime/steering-drivers.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L88)
+Defined in: [runtime/steering-drivers.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L89)
 
 The fixed continuation issued every round after shot 0. The same string is
 sent whether the prior shot passed inspection or not — the naive driver
@@ -5730,7 +5732,7 @@ supplies none.
 
 > **applyContinuation**: [`ApplyContinuation`](#applycontinuation)\<`Task`\>
 
-Defined in: [runtime/steering-drivers.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L90)
+Defined in: [runtime/steering-drivers.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L91)
 
 Folds `continuation` into the caller's Task shape for the next shot.
 
@@ -5738,7 +5740,7 @@ Folds `continuation` into the caller's Task shape for the next shot.
 
 > **maxIterations**: `number`
 
-Defined in: [runtime/steering-drivers.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L92)
+Defined in: [runtime/steering-drivers.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L93)
 
 Hard shot cap. The loop stops refining once history reaches this length.
 
@@ -5746,7 +5748,7 @@ Hard shot cap. The loop stops refining once history reaches this length.
 
 > `optional` **name?**: `string`
 
-Defined in: [runtime/steering-drivers.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L94)
+Defined in: [runtime/steering-drivers.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L95)
 
 Trace-event identifier. Default `'naive'`.
 
@@ -5754,7 +5756,7 @@ Trace-event identifier. Default `'naive'`.
 
 ### DumbDriverOptions
 
-Defined in: [runtime/steering-drivers.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L135)
+Defined in: [runtime/steering-drivers.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L136)
 
 Options for [dumbDriver](#dumbdriver).
 
@@ -5770,7 +5772,7 @@ Options for [dumbDriver](#dumbdriver).
 
 > **onPass**: `string`
 
-Defined in: [runtime/steering-drivers.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L142)
+Defined in: [runtime/steering-drivers.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L143)
 
 Continuation issued when the prior shot's verdict is valid. In a
 stop-on-pass loop this is rarely reached (a valid shot ends the loop), but
@@ -5781,7 +5783,7 @@ confirmation/keep-going string.
 
 > **onFail**: `string`
 
-Defined in: [runtime/steering-drivers.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L144)
+Defined in: [runtime/steering-drivers.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L145)
 
 Continuation issued when the prior shot's verdict is NOT valid.
 
@@ -5789,7 +5791,7 @@ Continuation issued when the prior shot's verdict is NOT valid.
 
 > **applyContinuation**: [`ApplyContinuation`](#applycontinuation)\<`Task`\>
 
-Defined in: [runtime/steering-drivers.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L146)
+Defined in: [runtime/steering-drivers.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L147)
 
 Folds the chosen continuation into the caller's Task shape.
 
@@ -5797,7 +5799,7 @@ Folds the chosen continuation into the caller's Task shape.
 
 > **maxIterations**: `number`
 
-Defined in: [runtime/steering-drivers.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L148)
+Defined in: [runtime/steering-drivers.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L149)
 
 Hard shot cap. The loop stops refining once history reaches this length.
 
@@ -5805,7 +5807,7 @@ Hard shot cap. The loop stops refining once history reaches this length.
 
 > `optional` **name?**: `string`
 
-Defined in: [runtime/steering-drivers.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L150)
+Defined in: [runtime/steering-drivers.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L151)
 
 Trace-event identifier. Default `'dumb'`.
 
@@ -7038,7 +7040,7 @@ Defined in: [runtime/strategy.ts:703](https://github.com/tangle-network/agent-ru
 
 ### ShotPersona
 
-Defined in: [runtime/strategy.ts:731](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L731)
+Defined in: [runtime/strategy.ts:733](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L733)
 
 A role for one shot — multi-agent loops (researcher + engineer, a panel of k
  researchers) give each shot its own system prompt and optionally its own model.
@@ -7049,7 +7051,7 @@ A role for one shot — multi-agent loops (researcher + engineer, a panel of k
 
 > `optional` **systemPrompt?**: `string`
 
-Defined in: [runtime/strategy.ts:734](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L734)
+Defined in: [runtime/strategy.ts:736](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L736)
 
 Replaces the task's systemPrompt for a FRESH shot; on a carried conversation it is
  injected as a hand-off message (the transcript's earlier roles stay intact).
@@ -7058,7 +7060,7 @@ Replaces the task's systemPrompt for a FRESH shot; on a carried conversation it
 
 > `optional` **model?**: `string`
 
-Defined in: [runtime/strategy.ts:736](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L736)
+Defined in: [runtime/strategy.ts:738](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L738)
 
 Per-shot model override (e.g. a stronger model for the engineer shot).
 
@@ -7066,7 +7068,7 @@ Per-shot model override (e.g. a stronger model for the engineer shot).
 
 ### ShotSpec
 
-Defined in: [runtime/strategy.ts:739](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L739)
+Defined in: [runtime/strategy.ts:741](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L741)
 
 #### Properties
 
@@ -7074,7 +7076,7 @@ Defined in: [runtime/strategy.ts:739](https://github.com/tangle-network/agent-ru
 
 > `optional` **handle?**: [`ArtifactHandle`](#artifacthandle)
 
-Defined in: [runtime/strategy.ts:741](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L741)
+Defined in: [runtime/strategy.ts:743](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L743)
 
 present ⇒ continue this artifact (depth); absent ⇒ the shot opens a fresh one (sample/restart).
 
@@ -7082,25 +7084,25 @@ present ⇒ continue this artifact (depth); absent ⇒ the shot opens a fresh on
 
 > `optional` **messages?**: `Msg`[]
 
-Defined in: [runtime/strategy.ts:742](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L742)
+Defined in: [runtime/strategy.ts:744](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L744)
 
 ##### steer?
 
 > `optional` **steer?**: `string`
 
-Defined in: [runtime/strategy.ts:743](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L743)
+Defined in: [runtime/strategy.ts:745](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L745)
 
 ##### persona?
 
 > `optional` **persona?**: [`ShotPersona`](#shotpersona)
 
-Defined in: [runtime/strategy.ts:744](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L744)
+Defined in: [runtime/strategy.ts:746](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L746)
 
 ##### tools?
 
 > `optional` **tools?**: `string`[]
 
-Defined in: [runtime/strategy.ts:747](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L747)
+Defined in: [runtime/strategy.ts:749](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L749)
 
 Restrict THIS shot to a subset of the domain's tools (by name) — focus a shot on
  the relevant capabilities. Restriction-only; unknown names throw. Omitted ⇒ all.
@@ -7109,7 +7111,7 @@ Restrict THIS shot to a subset of the domain's tools (by name) — focus a shot
 
 ### StrategyResult
 
-Defined in: [runtime/strategy.ts:749](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L749)
+Defined in: [runtime/strategy.ts:751](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L751)
 
 #### Properties
 
@@ -7117,37 +7119,37 @@ Defined in: [runtime/strategy.ts:749](https://github.com/tangle-network/agent-ru
 
 > **score**: `number`
 
-Defined in: [runtime/strategy.ts:750](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L750)
+Defined in: [runtime/strategy.ts:752](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L752)
 
 ##### resolved
 
 > **resolved**: `boolean`
 
-Defined in: [runtime/strategy.ts:751](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L751)
+Defined in: [runtime/strategy.ts:753](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L753)
 
 ##### completions
 
 > **completions**: `number`
 
-Defined in: [runtime/strategy.ts:752](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L752)
+Defined in: [runtime/strategy.ts:754](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L754)
 
 ##### progression
 
 > **progression**: `number`[]
 
-Defined in: [runtime/strategy.ts:753](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L753)
+Defined in: [runtime/strategy.ts:755](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L755)
 
 ##### shots
 
 > **shots**: `number`
 
-Defined in: [runtime/strategy.ts:754](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L754)
+Defined in: [runtime/strategy.ts:756](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L756)
 
 ***
 
 ### StrategyCtx
 
-Defined in: [runtime/strategy.ts:766](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L766)
+Defined in: [runtime/strategy.ts:768](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L768)
 
 What a strategy body composes with: the artifact lifecycle, the budget, and the two steps.
 
@@ -7157,7 +7159,7 @@ What a strategy body composes with: the artifact lifecycle, the budget, and the
 
 > `readonly` **surface**: `StrategyArtifacts`
 
-Defined in: [runtime/strategy.ts:768](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L768)
+Defined in: [runtime/strategy.ts:770](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L770)
 
 Open/close artifacts the body manages itself (e.g. one persistent handle for depth).
 
@@ -7165,25 +7167,25 @@ Open/close artifacts the body manages itself (e.g. one persistent handle for dep
 
 > `readonly` **task**: [`AgenticTask`](#agentictask)
 
-Defined in: [runtime/strategy.ts:769](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L769)
+Defined in: [runtime/strategy.ts:771](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L771)
 
 ##### opts
 
 > `readonly` **opts**: [`AgenticOptions`](#agenticoptions)
 
-Defined in: [runtime/strategy.ts:770](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L770)
+Defined in: [runtime/strategy.ts:772](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L772)
 
 ##### budget
 
 > `readonly` **budget**: `number`
 
-Defined in: [runtime/strategy.ts:771](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L771)
+Defined in: [runtime/strategy.ts:773](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L773)
 
 ##### scope
 
 > `readonly` **scope**: [`Scope`](#scope-1)\<[`Outcome`](#outcome-1)\<`unknown`\>\>
 
-Defined in: [runtime/strategy.ts:772](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L772)
+Defined in: [runtime/strategy.ts:774](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L774)
 
 #### Methods
 
@@ -7191,7 +7193,7 @@ Defined in: [runtime/strategy.ts:772](https://github.com/tangle-network/agent-ru
 
 > **shot**(`spec?`): `Promise`\<`ShotResult` \| `null`\>
 
-Defined in: [runtime/strategy.ts:774](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L774)
+Defined in: [runtime/strategy.ts:776](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L776)
 
 Run ONE worker shot; its harness-scored result, or null if it went down.
 
@@ -7209,7 +7211,7 @@ Run ONE worker shot; its harness-scored result, or null if it went down.
 
 > **critique**(`messages`): `Promise`\<`string` \| `null`\>
 
-Defined in: [runtime/strategy.ts:776](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L776)
+Defined in: [runtime/strategy.ts:778](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L778)
 
 The firewalled critic reads the trajectory → a steer string, or null on COMPLETE/down.
 
@@ -7227,7 +7229,7 @@ The firewalled critic reads the trajectory → a steer string, or null on COMPLE
 
 > **consult**(`messages`, `instruction`): `Promise`\<`string` \| `null`\>
 
-Defined in: [runtime/strategy.ts:781](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L781)
+Defined in: [runtime/strategy.ts:783](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L783)
 
 The RAW analyst channel: the firewalled critic answers `instruction` over the
  trajectory verbatim — no findings extraction, so verdict-shaped formats
@@ -7252,7 +7254,7 @@ The RAW analyst channel: the firewalled critic answers `instruction` over the
 
 > **listTools**(`handle`): `Promise`\<`object`[]\>
 
-Defined in: [runtime/strategy.ts:785](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L785)
+Defined in: [runtime/strategy.ts:787](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L787)
 
 The tools THIS artifact's task actually offers (names + descriptions only — never
  the implementations). Tool sets vary per task on heterogeneous domains; a strategy
@@ -7272,7 +7274,7 @@ The tools THIS artifact's task actually offers (names + descriptions only — ne
 
 ### RunAgenticOptions
 
-Defined in: [runtime/strategy.ts:1014](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1014)
+Defined in: [runtime/strategy.ts:1016](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1016)
 
 #### Extends
 
@@ -7427,19 +7429,19 @@ Tags written onto learned facts (and used by the caller's priming query).
 
 > **surface**: [`AgenticSurface`](#agenticsurface)
 
-Defined in: [runtime/strategy.ts:1015](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1015)
+Defined in: [runtime/strategy.ts:1017](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1017)
 
 ##### task
 
 > **task**: [`AgenticTask`](#agentictask)
 
-Defined in: [runtime/strategy.ts:1016](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1016)
+Defined in: [runtime/strategy.ts:1018](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1018)
 
 ##### hooks?
 
 > `optional` **hooks?**: [`RuntimeHooks`](index.md#runtimehooks)
 
-Defined in: [runtime/strategy.ts:1019](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1019)
+Defined in: [runtime/strategy.ts:1021](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1021)
 
 Lifecycle observability — every spawn/settle (shots, analysts) streams here live.
  The seam online watchdogs/route-auditors subscribe to.
@@ -7448,7 +7450,7 @@ Lifecycle observability — every spawn/settle (shots, analysts) streams here li
 
 > `optional` **strategy?**: [`Strategy`](#strategy-3)
 
-Defined in: [runtime/strategy.ts:1021](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1021)
+Defined in: [runtime/strategy.ts:1023](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1023)
 
 A Strategy (the open way) — author/pass your own. Overrides `mode` when present.
 
@@ -7456,7 +7458,7 @@ A Strategy (the open way) — author/pass your own. Overrides `mode` when presen
 
 > `optional` **mode?**: `"depth"` \| `"breadth"`
 
-Defined in: [runtime/strategy.ts:1023](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1023)
+Defined in: [runtime/strategy.ts:1025](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1025)
 
 Built-in shorthand: 'depth'→refine, 'breadth'→sample. Default 'depth'.
 
@@ -7464,7 +7466,7 @@ Built-in shorthand: 'depth'→refine, 'breadth'→sample. Default 'depth'.
 
 > **budget**: `number`
 
-Defined in: [runtime/strategy.ts:1025](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1025)
+Defined in: [runtime/strategy.ts:1027](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1027)
 
 budget: refine→max shots; sample→rollout width.
 
@@ -7472,7 +7474,7 @@ budget: refine→max shots; sample→rollout width.
 
 > `optional` **rootBudget?**: [`Budget`](#budget-12)
 
-Defined in: [runtime/strategy.ts:1026](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1026)
+Defined in: [runtime/strategy.ts:1028](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1028)
 
 ***
 
@@ -7691,7 +7693,7 @@ Total conserved-pool iterations = the driver + worker LLM rounds the run actuall
 
 ### AuthoredProfile
 
-Defined in: [runtime/supervise/authoring.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L24)
+Defined in: [runtime/supervise/authoring.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L25)
 
 What the supervisor AUTHORS per sub-task — a worker recipe (a partial `AgentProfile`).
 
@@ -7701,13 +7703,13 @@ What the supervisor AUTHORS per sub-task — a worker recipe (a partial `AgentPr
 
 > **name**: `string`
 
-Defined in: [runtime/supervise/authoring.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L25)
+Defined in: [runtime/supervise/authoring.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L26)
 
 ##### systemPrompt
 
 > **systemPrompt**: `string`
 
-Defined in: [runtime/supervise/authoring.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L27)
+Defined in: [runtime/supervise/authoring.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L28)
 
 The rich, task-specific instructions the supervisor wrote for THIS worker.
 
@@ -7715,7 +7717,7 @@ The rich, task-specific instructions the supervisor wrote for THIS worker.
 
 > `optional` **model?**: `string`
 
-Defined in: [runtime/supervise/authoring.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L29)
+Defined in: [runtime/supervise/authoring.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L30)
 
 The model the supervisor chose for this sub-task (falls back to the run default).
 
@@ -7723,7 +7725,7 @@ The model the supervisor chose for this sub-task (falls back to the run default)
 
 ### ProfileRichnessThresholds
 
-Defined in: [runtime/supervise/authoring.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L131)
+Defined in: [runtime/supervise/authoring.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L132)
 
 Thresholds below which a system prompt is treated as a thin stub. Tunable per call.
 
@@ -7733,7 +7735,7 @@ Thresholds below which a system prompt is treated as a thin stub. Tunable per ca
 
 > `readonly` **minSystemPromptChars**: `number`
 
-Defined in: [runtime/supervise/authoring.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L133)
+Defined in: [runtime/supervise/authoring.ts:134](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L134)
 
 A prompt shorter than this many characters is thin (default 600).
 
@@ -7741,7 +7743,7 @@ A prompt shorter than this many characters is thin (default 600).
 
 > `readonly` **minSystemPromptLines**: `number`
 
-Defined in: [runtime/supervise/authoring.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L135)
+Defined in: [runtime/supervise/authoring.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L136)
 
 A prompt with fewer than this many non-blank lines is thin (default 6).
 
@@ -7749,7 +7751,7 @@ A prompt with fewer than this many non-blank lines is thin (default 6).
 
 ### ProfileRichness
 
-Defined in: [runtime/supervise/authoring.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L144)
+Defined in: [runtime/supervise/authoring.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L145)
 
 Per-field verdict on one authored profile — the raw material the bench renders + scores.
 
@@ -7759,13 +7761,13 @@ Per-field verdict on one authored profile — the raw material the bench renders
 
 > `readonly` **name**: `string`
 
-Defined in: [runtime/supervise/authoring.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L145)
+Defined in: [runtime/supervise/authoring.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L146)
 
 ##### systemPrompt
 
 > `readonly` **systemPrompt**: `string`
 
-Defined in: [runtime/supervise/authoring.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L148)
+Defined in: [runtime/supervise/authoring.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L149)
 
 The resolved system prompt (canonical `prompt.systemPrompt`, the sandbox `prompt.system`
  convention, or a bare-string prompt — whichever the author used).
@@ -7774,55 +7776,55 @@ The resolved system prompt (canonical `prompt.systemPrompt`, the sandbox `prompt
 
 > `readonly` **systemPromptChars**: `number`
 
-Defined in: [runtime/supervise/authoring.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L149)
+Defined in: [runtime/supervise/authoring.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L150)
 
 ##### systemPromptLines
 
 > `readonly` **systemPromptLines**: `number`
 
-Defined in: [runtime/supervise/authoring.ts:150](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L150)
+Defined in: [runtime/supervise/authoring.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L151)
 
 ##### sentenceCount
 
 > `readonly` **sentenceCount**: `number`
 
-Defined in: [runtime/supervise/authoring.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L151)
+Defined in: [runtime/supervise/authoring.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L152)
 
 ##### hasDescription
 
 > `readonly` **hasDescription**: `boolean`
 
-Defined in: [runtime/supervise/authoring.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L152)
+Defined in: [runtime/supervise/authoring.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L153)
 
 ##### hasTools
 
 > `readonly` **hasTools**: `boolean`
 
-Defined in: [runtime/supervise/authoring.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L153)
+Defined in: [runtime/supervise/authoring.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L154)
 
 ##### hasSkills
 
 > `readonly` **hasSkills**: `boolean`
 
-Defined in: [runtime/supervise/authoring.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L154)
+Defined in: [runtime/supervise/authoring.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L155)
 
 ##### hasMcp
 
 > `readonly` **hasMcp**: `boolean`
 
-Defined in: [runtime/supervise/authoring.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L155)
+Defined in: [runtime/supervise/authoring.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L156)
 
 ##### hasSubagents
 
 > `readonly` **hasSubagents**: `boolean`
 
-Defined in: [runtime/supervise/authoring.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L156)
+Defined in: [runtime/supervise/authoring.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L157)
 
 ##### richness
 
 > `readonly` **richness**: `number`
 
-Defined in: [runtime/supervise/authoring.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L158)
+Defined in: [runtime/supervise/authoring.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L159)
 
 0..1 — fraction of richness signals present (prompt-depth + the four levers).
 
@@ -7830,7 +7832,7 @@ Defined in: [runtime/supervise/authoring.ts:158](https://github.com/tangle-netwo
 
 > `readonly` **thin**: `boolean`
 
-Defined in: [runtime/supervise/authoring.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L160)
+Defined in: [runtime/supervise/authoring.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L161)
 
 True when the supervisor authored a stub instead of a real profile.
 
@@ -7838,7 +7840,7 @@ True when the supervisor authored a stub instead of a real profile.
 
 > `readonly` **reasons**: `string`[]
 
-Defined in: [runtime/supervise/authoring.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L162)
+Defined in: [runtime/supervise/authoring.ts:163](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L163)
 
 The specific reasons it is thin (empty when rich) — used in the finding's action.
 
@@ -7846,7 +7848,7 @@ The specific reasons it is thin (empty when rich) — used in the finding's acti
 
 ### ReservationTicket
 
-Defined in: [runtime/supervise/budget.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L29)
+Defined in: [runtime/supervise/budget.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L30)
 
 Opaque, single-use reservation handle returned by `reserve` and consumed by
  `reconcile`. Carries the reserved ceilings so reconciliation needs no lookup.
@@ -7857,13 +7859,13 @@ Opaque, single-use reservation handle returned by `reserve` and consumed by
 
 > `readonly` **id**: `number`
 
-Defined in: [runtime/supervise/budget.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L30)
+Defined in: [runtime/supervise/budget.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L31)
 
 ##### reserved
 
 > `readonly` **reserved**: `object`
 
-Defined in: [runtime/supervise/budget.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L31)
+Defined in: [runtime/supervise/budget.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L32)
 
 ###### tokens
 
@@ -7881,7 +7883,7 @@ Defined in: [runtime/supervise/budget.ts:31](https://github.com/tangle-network/a
 
 ### BudgetPool
 
-Defined in: [runtime/supervise/budget.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L51)
+Defined in: [runtime/supervise/budget.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L52)
 
 #### Methods
 
@@ -7889,7 +7891,7 @@ Defined in: [runtime/supervise/budget.ts:51](https://github.com/tangle-network/a
 
 > **reserve**(`b`): \{ `ok`: `true`; `ticket`: [`ReservationTicket`](#reservationticket); \} \| \{ `ok`: `false`; `reason`: `"budget-exhausted"`; \}
 
-Defined in: [runtime/supervise/budget.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L57)
+Defined in: [runtime/supervise/budget.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L58)
 
 Atomically reserve a child's full ceiling from the free balance. Fails closed
 ({ ok: false }) when the pool can't cover tokens, usd, or iterations — the
@@ -7909,7 +7911,7 @@ caller inspects `ok` before `ticket`.
 
 > **reconcile**(`ticket`, `spent`): `void`
 
-Defined in: [runtime/supervise/budget.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L65)
+Defined in: [runtime/supervise/budget.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L66)
 
 Release a reservation: commit the actual `spent`, refund the unspent remainder
 to the free pool. Throws on an unknown or already-reconciled ticket (fail loud —
@@ -7933,7 +7935,7 @@ a double refund would silently break conservation).
 
 > **spendFrom**(`events`): `Promise`\<[`Spend`](#spend)\>
 
-Defined in: [runtime/supervise/budget.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L69)
+Defined in: [runtime/supervise/budget.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L70)
 
 Fold a normalized `UsageEvent` stream (or array) into a `Spend`. Tokens via
  `addTokenUsage`, usd on its own channel, iterations from `'iteration'` events.
@@ -7953,7 +7955,7 @@ Fold a normalized `UsageEvent` stream (or array) into a `Spend`. Tokens via
 
 > **readout**(): [`BudgetReadout`](#budgetreadout)
 
-Defined in: [runtime/supervise/budget.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L71)
+Defined in: [runtime/supervise/budget.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L72)
 
 The current readout, reflecting all outstanding reservations.
 
@@ -7965,7 +7967,7 @@ The current readout, reflecting all outstanding reservations.
 
 > **observe**(`spend`): `void`
 
-Defined in: [runtime/supervise/budget.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L82)
+Defined in: [runtime/supervise/budget.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L83)
 
 Record OBSERVED spend that did NOT go through reserve/reconcile — the driver's OWN inference
 (its chat turns), which is real compute but not a spawned child. A direct `free → committed`
@@ -7990,7 +7992,7 @@ only makes the live `readout()` reflect driver inference for the in-loop guard.
 
 > **assertNoOpenTickets**(): `void`
 
-Defined in: [runtime/supervise/budget.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L86)
+Defined in: [runtime/supervise/budget.ts:87](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L87)
 
 Fail loud if any reservation is still open — the conserved-pool leak detector. Called at the
  supervisor's join barrier: once every child has settled, no ticket may remain (a leaked
@@ -8004,7 +8006,7 @@ Fail loud if any reservation is still open — the conserved-pool leak detector.
 
 ### DeliverableSpec
 
-Defined in: [runtime/supervise/completion-gate.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L31)
+Defined in: [runtime/supervise/completion-gate.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L32)
 
 The deployable completion oracle passed to [gateOnDeliverable](#gateondeliverable): a `check` that
 decides DELIVERED (settles `valid` ⟺ it resolves true) plus an optional `describe` of
@@ -8023,7 +8025,7 @@ model judging itself.
 
 > **check**: (`out`) => `boolean` \| `Promise`\<`boolean`\>
 
-Defined in: [runtime/supervise/completion-gate.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L33)
+Defined in: [runtime/supervise/completion-gate.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L34)
 
 The deployable check that decides DELIVERED. `settled.valid ⟺ this resolves true`.
 
@@ -8041,7 +8043,7 @@ The deployable check that decides DELIVERED. `settled.valid ⟺ this resolves tr
 
 > `optional` **describe?**: `string`
 
-Defined in: [runtime/supervise/completion-gate.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L35)
+Defined in: [runtime/supervise/completion-gate.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L36)
 
 What the spawn was supposed to produce — surfaced in traces/reports.
 
@@ -8049,7 +8051,7 @@ What the spawn was supposed to produce — surfaced in traces/reports.
 
 ### DriverAgentOptions
 
-Defined in: [runtime/supervise/coordination-driver.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L46)
+Defined in: [runtime/supervise/coordination-driver.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L47)
 
 #### Properties
 
@@ -8057,13 +8059,13 @@ Defined in: [runtime/supervise/coordination-driver.ts:46](https://github.com/tan
 
 > `readonly` **name**: `string`
 
-Defined in: [runtime/supervise/coordination-driver.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L47)
+Defined in: [runtime/supervise/coordination-driver.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L48)
 
 ##### brain
 
 > `readonly` **brain**: [`ToolLoopChat`](#toolloopchat)
 
-Defined in: [runtime/supervise/coordination-driver.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L51)
+Defined in: [runtime/supervise/coordination-driver.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L52)
 
 The driver-LLM seam — ONE inference turn over the conversation + the coordination tool specs
  (the canonical `ToolLoopChat`): a scripted mock offline, the router's tool-calling in
@@ -8073,7 +8075,7 @@ The driver-LLM seam — ONE inference turn over the conversation + the coordinat
 
 > `readonly` **blobs**: [`ResultBlobStore`](#resultblobstore)
 
-Defined in: [runtime/supervise/coordination-driver.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L53)
+Defined in: [runtime/supervise/coordination-driver.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L54)
 
 Shared blob store — `observe_agent` reads settled outputs through it.
 
@@ -8081,7 +8083,7 @@ Shared blob store — `observe_agent` reads settled outputs through it.
 
 > `readonly` **makeWorkerAgent**: [`MakeWorkerAgent`](#makeworkeragent)
 
-Defined in: [runtime/supervise/coordination-driver.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L55)
+Defined in: [runtime/supervise/coordination-driver.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L56)
 
 Resolve a spawned `profile` to a worker LEAF or a driver child (the recursion seam).
 
@@ -8089,7 +8091,7 @@ Resolve a spawned `profile` to a worker LEAF or a driver child (the recursion se
 
 > `readonly` **perWorker**: [`Budget`](#budget-12)
 
-Defined in: [runtime/supervise/coordination-driver.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L57)
+Defined in: [runtime/supervise/coordination-driver.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L58)
 
 Per-child budget reserved from the conserved pool on each spawn.
 
@@ -8097,7 +8099,7 @@ Per-child budget reserved from the conserved pool on each spawn.
 
 > `readonly` `optional` **maxLiveWorkers?**: `number`
 
-Defined in: [runtime/supervise/coordination-driver.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L60)
+Defined in: [runtime/supervise/coordination-driver.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L61)
 
 Hard cap on simultaneously-LIVE workers — `spawn_agent` fails closed once this many are in
  flight (a concurrency fence on top of the conserved-pool fence). Omit/`<= 0` = no cap.
@@ -8106,7 +8108,7 @@ Hard cap on simultaneously-LIVE workers — `spawn_agent` fails closed once this
 
 > `readonly` `optional` **analysts?**: [`AnalystRegistry`](#analystregistry)
 
-Defined in: [runtime/supervise/coordination-driver.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L63)
+Defined in: [runtime/supervise/coordination-driver.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L64)
 
 The analyst lenses available to the driver. Required for `analyzeOnSettle` (and `run_analyst`).
  Unset → no analyst feed (status quo: the driver gets settled outputs, no findings).
@@ -8115,7 +8117,7 @@ The analyst lenses available to the driver. Required for `analyzeOnSettle` (and
 
 > `readonly` `optional` **analyzeOnSettle?**: readonly `string`[]
 
-Defined in: [runtime/supervise/coordination-driver.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L67)
+Defined in: [runtime/supervise/coordination-driver.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L68)
 
 Analyst kind ids run AUTOMATICALLY when a worker settles `done` — each result re-enters as a
  `finding` the driver pulls and composes its next steer from. The UP-leg of the self-improving
@@ -8125,7 +8127,7 @@ Analyst kind ids run AUTOMATICALLY when a worker settles `done` — each result
 
 > `readonly` **systemPrompt**: `string` \| ((`task`) => `string`)
 
-Defined in: [runtime/supervise/coordination-driver.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L70)
+Defined in: [runtime/supervise/coordination-driver.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L71)
 
 The driver's stance — a string, or built from the task (the worker-driver prompt /
  the generator). INJECTED so the prompt is a pluggable, optimizable role.
@@ -8134,7 +8136,7 @@ The driver's stance — a string, or built from the task (the worker-driver prom
 
 > `readonly` `optional` **extraTools?**: readonly `object`[]
 
-Defined in: [runtime/supervise/coordination-driver.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L75)
+Defined in: [runtime/supervise/coordination-driver.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L76)
 
 WORK tools the driver may call DIRECTLY (alongside the coordination verbs) — so the driver is
  not a pure manager but a full agent that can ACT (do simple work itself) OR SPAWN (delegate).
@@ -8145,7 +8147,7 @@ WORK tools the driver may call DIRECTLY (alongside the coordination verbs) — s
 
 > `readonly` `optional` **executeExtraTool?**: (`name`, `args`) => `Promise`\<`string` \| `null` \| `undefined`\>
 
-Defined in: [runtime/supervise/coordination-driver.ts:82](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L82)
+Defined in: [runtime/supervise/coordination-driver.ts:83](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L83)
 
 Runs an `extraTools` call. Returns a string result, or null/undefined to signal "not handled"
  so the call falls through to the coordination dispatch. Required iff `extraTools` is set.
@@ -8168,7 +8170,7 @@ Runs an `extraTools` call. Returns a string result, or null/undefined to signal
 
 > `readonly` `optional` **maxTurns?**: `number`
 
-Defined in: [runtime/supervise/coordination-driver.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L90)
+Defined in: [runtime/supervise/coordination-driver.ts:91](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L91)
 
 Max driver turns before the loop force-finalizes on the best settled child. Default 16.
  `0` lifts the turn-COUNT cap: the loop is bounded instead by the conserved budget pool,
@@ -8179,7 +8181,7 @@ Max driver turns before the loop force-finalizes on the best settled child. Defa
 
 > `readonly` `optional` **now?**: () => `number`
 
-Defined in: [runtime/supervise/coordination-driver.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L93)
+Defined in: [runtime/supervise/coordination-driver.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L94)
 
 Injected clock for the in-loop absolute-deadline guard — keeps the deadline check
  deterministic in tests. Defaults to `Date.now`.
@@ -8192,7 +8194,7 @@ Injected clock for the in-loop absolute-deadline guard — keeps the deadline ch
 
 > `readonly` `optional` **compaction?**: [`ToolLoopCompactionOptions`](#toolloopcompactionoptions)
 
-Defined in: [runtime/supervise/coordination-driver.ts:102](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L102)
+Defined in: [runtime/supervise/coordination-driver.ts:103](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L103)
 
 Give the driver brain a chapter-lifecycle on its OWN context window. The LLM-brain front doors
  lose to a dumb-Ralph respawn because the brain re-bills its whole coordination transcript every
@@ -8207,7 +8209,7 @@ Give the driver brain a chapter-lifecycle on its OWN context window. The LLM-bra
 
 ### CoordinationMcpHandle
 
-Defined in: [runtime/supervise/coordination-mcp.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L33)
+Defined in: [runtime/supervise/coordination-mcp.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L34)
 
 #### Properties
 
@@ -8215,7 +8217,7 @@ Defined in: [runtime/supervise/coordination-mcp.ts:33](https://github.com/tangle
 
 > `readonly` **url**: `string`
 
-Defined in: [runtime/supervise/coordination-mcp.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L35)
+Defined in: [runtime/supervise/coordination-mcp.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L36)
 
 The URL an in-box harness mounts as `mcp.mcpServers.coordination.url`.
 
@@ -8223,13 +8225,13 @@ The URL an in-box harness mounts as `mcp.mcpServers.coordination.url`.
 
 > `readonly` **port**: `number`
 
-Defined in: [runtime/supervise/coordination-mcp.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L36)
+Defined in: [runtime/supervise/coordination-mcp.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L37)
 
 ##### drainResolved
 
 > **drainResolved**: () => `Promise`\<`number`\>
 
-Defined in: [runtime/supervise/coordination-mcp.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L41)
+Defined in: [runtime/supervise/coordination-mcp.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L42)
 
 Post-loop drain of already-settled, unpulled children into the ledger — call before reading
  `settled()` for a finalize, so a delivered child the harness never awaited is not lost.
@@ -8249,7 +8251,7 @@ nobody is left to read a finding, and analysts spend real compute). Returns the
 
 > **history**: () => readonly [`BusRecord`](#busrecord)\<[`CoordinationEvent`](#coordinationevent)\>[]
 
-Defined in: [runtime/supervise/coordination-mcp.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L44)
+Defined in: [runtime/supervise/coordination-mcp.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L45)
 
 The full ordered bus-event log — observability audit + replay trail.
 
@@ -8265,7 +8267,7 @@ readonly [`BusRecord`](#busrecord)\<[`CoordinationEvent`](#coordinationevent)\>[
 
 > **stats**: () => [`BusStats`](#busstats)
 
-Defined in: [runtime/supervise/coordination-mcp.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L46)
+Defined in: [runtime/supervise/coordination-mcp.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L47)
 
 Bus throughput counters for live dashboards.
 
@@ -8279,7 +8281,7 @@ Bus throughput counters (published / pulled / by-kind) for live dashboards.
 
 > **raiseFinding**: (`finding`) => `Promise`\<`void`\>
 
-Defined in: [runtime/supervise/coordination-mcp.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L48)
+Defined in: [runtime/supervise/coordination-mcp.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L49)
 
 Raise a `finding` on the bus from an online detector watching a worker's live pipe.
 
@@ -8303,7 +8305,7 @@ Raise a `finding` on the bus from outside the settle hook — the seam an ONLINE
 
 > **settled**(): readonly `object`[]
 
-Defined in: [runtime/supervise/coordination-mcp.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L38)
+Defined in: [runtime/supervise/coordination-mcp.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L39)
 
 The coordination tools' settled-worker ledger (for the driver's finalize).
 
@@ -8315,7 +8317,7 @@ readonly `object`[]
 
 > **isStopped**(): `boolean`
 
-Defined in: [runtime/supervise/coordination-mcp.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L42)
+Defined in: [runtime/supervise/coordination-mcp.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L43)
 
 ###### Returns
 
@@ -8325,7 +8327,7 @@ Defined in: [runtime/supervise/coordination-mcp.ts:42](https://github.com/tangle
 
 > **close**(): `Promise`\<`void`\>
 
-Defined in: [runtime/supervise/coordination-mcp.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L49)
+Defined in: [runtime/supervise/coordination-mcp.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L50)
 
 ###### Returns
 
@@ -8335,7 +8337,7 @@ Defined in: [runtime/supervise/coordination-mcp.ts:49](https://github.com/tangle
 
 ### DelegateOptions
 
-Defined in: [runtime/supervise/delegate.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L38)
+Defined in: [runtime/supervise/delegate.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L39)
 
 Inputs to [delegate](#delegate). The intent is the first positional arg; everything here is optional
  with sensible defaults, so the common call is `delegate(intent, { backend, router })`.
@@ -8352,7 +8354,7 @@ Inputs to [delegate](#delegate). The intent is the first positional arg; everyth
 
 > `readonly` `optional` **deliverable?**: [`DeliverableSpec`](#deliverablespec)\<`Out`\>
 
-Defined in: [runtime/supervise/delegate.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L42)
+Defined in: [runtime/supervise/delegate.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L43)
 
 The completion oracle (settled ⟺ delivered) the authored workers settle against. Strongly
  recommended — without it the supervisor trusts a worker's self-report. For a code intent,
@@ -8362,7 +8364,7 @@ The completion oracle (settled ⟺ delivered) the authored workers settle agains
 
 > `readonly` `optional` **backend?**: [`ExecutorConfig`](#executorconfig)
 
-Defined in: [runtime/supervise/delegate.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L46)
+Defined in: [runtime/supervise/delegate.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L47)
 
 WHERE the authored workers run — the worker-execution backend (`router-tools` / `sandbox` /
  `cli-worktree` / …). The supervisor authors the worker PROFILE; this is the substrate it runs
@@ -8372,7 +8374,7 @@ WHERE the authored workers run — the worker-execution backend (`router-tools`
 
 > `readonly` `optional` **budget?**: [`Budget`](#budget-12)
 
-Defined in: [runtime/supervise/delegate.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L48)
+Defined in: [runtime/supervise/delegate.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L49)
 
 The conserved compute pool for the whole delegation. Defaults to [defaultDelegateBudget](#defaultdelegatebudget).
 
@@ -8380,7 +8382,7 @@ The conserved compute pool for the whole delegation. Defaults to [defaultDelegat
 
 > `readonly` `optional` **model?**: `string`
 
-Defined in: [runtime/supervise/delegate.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L51)
+Defined in: [runtime/supervise/delegate.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L52)
 
 The model the supervisor BRAIN runs on (the router model). The brain must tool-call
  (`spawn_agent` / `await_event`), so a delegator model, not a hidden-reasoning model.
@@ -8389,7 +8391,7 @@ The model the supervisor BRAIN runs on (the router model). The brain must tool-c
 
 > `readonly` `optional` **router?**: [`RouterConfig`](#routerconfig)
 
-Defined in: [runtime/supervise/delegate.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L55)
+Defined in: [runtime/supervise/delegate.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L56)
 
 The supervisor brain's router substrate. REQUIRED for the default router-brained supervisor
  (the brain is resolved from this), unless a test injects `brain` directly. `model` overrides
@@ -8399,7 +8401,7 @@ The supervisor brain's router substrate. REQUIRED for the default router-brained
 
 > `readonly` `optional` **brain?**: [`ToolLoopChat`](#toolloopchat)
 
-Defined in: [runtime/supervise/delegate.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L57)
+Defined in: [runtime/supervise/delegate.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L58)
 
 Inject the supervisor brain directly (tests / advanced) instead of resolving it from `router`.
 
@@ -8407,7 +8409,7 @@ Inject the supervisor brain directly (tests / advanced) instead of resolving it
 
 > `readonly` `optional` **supervisor?**: `Partial`\<`Pick`\<[`SupervisorProfile`](#supervisorprofile), `"name"` \| `"systemPrompt"`\>\>
 
-Defined in: [runtime/supervise/delegate.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L60)
+Defined in: [runtime/supervise/delegate.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L61)
 
 Override the default authoring-supervisor profile (name / extra system-prompt stance). The
  default already carries the authoring skill; override only to add a goal or rename.
@@ -8416,7 +8418,7 @@ Override the default authoring-supervisor profile (name / extra system-prompt st
 
 > `readonly` `optional` **allowedModels?**: readonly `string`[]
 
-Defined in: [runtime/supervise/delegate.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L62)
+Defined in: [runtime/supervise/delegate.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L63)
 
 Restrict the run to this subset of models (forwarded to `supervise()`).
 
@@ -8424,13 +8426,13 @@ Restrict the run to this subset of models (forwarded to `supervise()`).
 
 > `readonly` `optional` **runId?**: `string`
 
-Defined in: [runtime/supervise/delegate.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L63)
+Defined in: [runtime/supervise/delegate.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L64)
 
 ***
 
 ### WatchTraceOptions
 
-Defined in: [runtime/supervise/detector-monitor.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L22)
+Defined in: [runtime/supervise/detector-monitor.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L23)
 
 #### Properties
 
@@ -8438,7 +8440,7 @@ Defined in: [runtime/supervise/detector-monitor.ts:22](https://github.com/tangle
 
 > `readonly` `optional` **detectors?**: readonly `StreamingDetector`[]
 
-Defined in: [runtime/supervise/detector-monitor.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L24)
+Defined in: [runtime/supervise/detector-monitor.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L25)
 
 The detectors to run online. Defaults to a stuck-loop + error-streak panel.
 
@@ -8446,7 +8448,7 @@ The detectors to run online. Defaults to a stuck-loop + error-streak panel.
 
 > `readonly` `optional` **onSignal?**: (`signal`, `span`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime/supervise/detector-monitor.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L26)
+Defined in: [runtime/supervise/detector-monitor.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L27)
 
 Fired for each signal a detector raises — the seam that raises a `finding` on the bus.
 
@@ -8468,7 +8470,7 @@ Fired for each signal a detector raises — the seam that raises a `finding` on
 
 ### BusEvent
 
-Defined in: [runtime/supervise/event-bus.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L26)
+Defined in: [runtime/supervise/event-bus.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L27)
 
 Every bus event is a discriminated union member keyed by `type`.
 
@@ -8478,13 +8480,13 @@ Every bus event is a discriminated union member keyed by `type`.
 
 > `readonly` **type**: `string`
 
-Defined in: [runtime/supervise/event-bus.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L27)
+Defined in: [runtime/supervise/event-bus.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L28)
 
 ***
 
 ### BusRecord
 
-Defined in: [runtime/supervise/event-bus.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L32)
+Defined in: [runtime/supervise/event-bus.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L33)
 
 A published event stamped for ordering and observability. `seq` is the monotonic publish index;
  `priority` drives pull order (higher = bumped ahead); `at` is the wall-clock publish time (ms).
@@ -8501,31 +8503,31 @@ A published event stamped for ordering and observability. `seq` is the monotonic
 
 > `readonly` **seq**: `number`
 
-Defined in: [runtime/supervise/event-bus.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L33)
+Defined in: [runtime/supervise/event-bus.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L34)
 
 ##### at
 
 > `readonly` **at**: `number`
 
-Defined in: [runtime/supervise/event-bus.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L34)
+Defined in: [runtime/supervise/event-bus.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L35)
 
 ##### priority
 
 > `readonly` **priority**: `number`
 
-Defined in: [runtime/supervise/event-bus.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L35)
+Defined in: [runtime/supervise/event-bus.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L36)
 
 ##### event
 
 > `readonly` **event**: `E`
 
-Defined in: [runtime/supervise/event-bus.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L36)
+Defined in: [runtime/supervise/event-bus.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L37)
 
 ***
 
 ### PublishOptions
 
-Defined in: [runtime/supervise/event-bus.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L39)
+Defined in: [runtime/supervise/event-bus.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L40)
 
 #### Properties
 
@@ -8533,7 +8535,7 @@ Defined in: [runtime/supervise/event-bus.ts:39](https://github.com/tangle-networ
 
 > `readonly` `optional` **priority?**: `number`
 
-Defined in: [runtime/supervise/event-bus.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L42)
+Defined in: [runtime/supervise/event-bus.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L43)
 
 Higher = pulled ahead of lower-priority queued events (default 0). A blocking question sets
  this so it bumps to the front of the driver's inbox.
@@ -8542,7 +8544,7 @@ Higher = pulled ahead of lower-priority queued events (default 0). A blocking qu
 
 > `readonly` `optional` **queue?**: `boolean`
 
-Defined in: [runtime/supervise/event-bus.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L46)
+Defined in: [runtime/supervise/event-bus.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L47)
 
 Whether the event enters the pull queue (default true). Set `false` for record-only events —
  the parent→child down-leg (steer / answer / resume): they belong in `history()` and reach
@@ -8552,7 +8554,7 @@ Whether the event enters the pull queue (default true). Set `false` for record-o
 
 ### BusStats
 
-Defined in: [runtime/supervise/event-bus.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L49)
+Defined in: [runtime/supervise/event-bus.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L50)
 
 #### Properties
 
@@ -8560,19 +8562,19 @@ Defined in: [runtime/supervise/event-bus.ts:49](https://github.com/tangle-networ
 
 > `readonly` **published**: `number`
 
-Defined in: [runtime/supervise/event-bus.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L50)
+Defined in: [runtime/supervise/event-bus.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L51)
 
 ##### pulled
 
 > `readonly` **pulled**: `number`
 
-Defined in: [runtime/supervise/event-bus.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L51)
+Defined in: [runtime/supervise/event-bus.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L52)
 
 ##### byKind
 
 > `readonly` **byKind**: `Readonly`\<`Record`\<`string`, `number`\>\>
 
-Defined in: [runtime/supervise/event-bus.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L53)
+Defined in: [runtime/supervise/event-bus.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L54)
 
 Count published per event `type`.
 
@@ -8580,7 +8582,7 @@ Count published per event `type`.
 
 ### EventBus
 
-Defined in: [runtime/supervise/event-bus.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L56)
+Defined in: [runtime/supervise/event-bus.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L57)
 
 #### Type Parameters
 
@@ -8594,7 +8596,7 @@ Defined in: [runtime/supervise/event-bus.ts:56](https://github.com/tangle-networ
 
 > **publish**(`event`, `opts?`): `Promise`\<[`BusRecord`](#busrecord)\<`E`\>\>
 
-Defined in: [runtime/supervise/event-bus.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L59)
+Defined in: [runtime/supervise/event-bus.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L60)
 
 Stamp + queue the event, then deliver the stamped record to every subscriber in order.
  Returns the stamped record.
@@ -8617,7 +8619,7 @@ Stamp + queue the event, then deliver the stamped record to every subscriber in
 
 > **pull**(`kinds?`): `E` \| `undefined`
 
-Defined in: [runtime/supervise/event-bus.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L62)
+Defined in: [runtime/supervise/event-bus.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L63)
 
 Remove and return the highest-priority QUEUED event whose type is in `kinds` (any if omitted),
  ties broken FIFO by `seq`; `undefined` when nothing matches.
@@ -8636,7 +8638,7 @@ readonly `E`\[`"type"`\][]
 
 > **subscribe**(`handler`): () => `void`
 
-Defined in: [runtime/supervise/event-bus.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L65)
+Defined in: [runtime/supervise/event-bus.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L66)
 
 Register a pass-through handler; it receives the stamped record of every event published after
  registration. Returns an unsubscribe fn.
@@ -8655,7 +8657,7 @@ Register a pass-through handler; it receives the stamped record of every event p
 
 > **pending**(`kinds?`): `number`
 
-Defined in: [runtime/supervise/event-bus.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L67)
+Defined in: [runtime/supervise/event-bus.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L68)
 
 Count of queued, not-yet-pulled events (filtered by `kinds` when given).
 
@@ -8673,7 +8675,7 @@ readonly `E`\[`"type"`\][]
 
 > **history**(): readonly [`BusRecord`](#busrecord)\<`E`\>[]
 
-Defined in: [runtime/supervise/event-bus.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L69)
+Defined in: [runtime/supervise/event-bus.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L70)
 
 The full ordered log of every event ever published (the audit/replay trail).
 
@@ -8685,7 +8687,7 @@ readonly [`BusRecord`](#busrecord)\<`E`\>[]
 
 > **stats**(): [`BusStats`](#busstats)
 
-Defined in: [runtime/supervise/event-bus.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L71)
+Defined in: [runtime/supervise/event-bus.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L72)
 
 Throughput counters for observability dashboards.
 
@@ -8697,7 +8699,7 @@ Throughput counters for observability dashboards.
 
 ### InboxMessage
 
-Defined in: [runtime/supervise/inbox.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L18)
+Defined in: [runtime/supervise/inbox.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L19)
 
 **`Experimental`**
 
@@ -8720,7 +8722,7 @@ and the worker's agent loop drains them at two points (Drew's two delivery modes
 
 > `readonly` **kind**: `"steer"` \| `"answer"`
 
-Defined in: [runtime/supervise/inbox.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L19)
+Defined in: [runtime/supervise/inbox.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L20)
 
 **`Experimental`**
 
@@ -8728,7 +8730,7 @@ Defined in: [runtime/supervise/inbox.ts:19](https://github.com/tangle-network/ag
 
 > `readonly` **text**: `string`
 
-Defined in: [runtime/supervise/inbox.ts:20](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L20)
+Defined in: [runtime/supervise/inbox.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L21)
 
 **`Experimental`**
 
@@ -8736,7 +8738,7 @@ Defined in: [runtime/supervise/inbox.ts:20](https://github.com/tangle-network/ag
 
 > `readonly` **interrupt**: `boolean`
 
-Defined in: [runtime/supervise/inbox.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L22)
+Defined in: [runtime/supervise/inbox.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L23)
 
 **`Experimental`**
 
@@ -8746,7 +8748,7 @@ Forceful messages abort the in-flight turn; queued ones wait for the boundary fl
 
 > `readonly` `optional` **questionId?**: `string`
 
-Defined in: [runtime/supervise/inbox.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L24)
+Defined in: [runtime/supervise/inbox.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L25)
 
 **`Experimental`**
 
@@ -8756,7 +8758,7 @@ Present for an `answer` — the question id it resolves.
 
 ### Inbox
 
-Defined in: [runtime/supervise/inbox.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L27)
+Defined in: [runtime/supervise/inbox.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L28)
 
 #### Methods
 
@@ -8764,7 +8766,7 @@ Defined in: [runtime/supervise/inbox.ts:27](https://github.com/tangle-network/ag
 
 > **deliver**(`msg`): `void`
 
-Defined in: [runtime/supervise/inbox.ts:29](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L29)
+Defined in: [runtime/supervise/inbox.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L30)
 
 The `Executor.deliver` implementation — accept a raw down-message from `Scope.send`.
 
@@ -8782,7 +8784,7 @@ The `Executor.deliver` implementation — accept a raw down-message from `Scope.
 
 > **drain**(): [`InboxMessage`](#inboxmessage)[]
 
-Defined in: [runtime/supervise/inbox.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L31)
+Defined in: [runtime/supervise/inbox.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L32)
 
 Remove and return all pending messages (the flush).
 
@@ -8794,7 +8796,7 @@ Remove and return all pending messages (the flush).
 
 > **pending**(): `number`
 
-Defined in: [runtime/supervise/inbox.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L32)
+Defined in: [runtime/supervise/inbox.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L33)
 
 ###### Returns
 
@@ -8804,7 +8806,7 @@ Defined in: [runtime/supervise/inbox.ts:32](https://github.com/tangle-network/ag
 
 > **freshInterrupt**(): `AbortSignal`
 
-Defined in: [runtime/supervise/inbox.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L35)
+Defined in: [runtime/supervise/inbox.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L36)
 
 Open a fresh per-turn interrupt signal; a later forceful `deliver` aborts it. The loop links
  this into the signal it passes to its inference call, then re-plans when it fires.
@@ -8817,7 +8819,7 @@ Open a fresh per-turn interrupt signal; a later forceful `deliver` aborts it. Th
 
 > **fold**(`messages`): `string`
 
-Defined in: [runtime/supervise/inbox.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L37)
+Defined in: [runtime/supervise/inbox.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L38)
 
 Render drained messages as ONE operator turn to fold into the worker's conversation.
 
@@ -8835,7 +8837,7 @@ readonly [`InboxMessage`](#inboxmessage)[]
 
 ### PatchDeliverableOptions
 
-Defined in: [runtime/supervise/patch-deliverable.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L27)
+Defined in: [runtime/supervise/patch-deliverable.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L28)
 
 **`Experimental`**
 
@@ -8853,7 +8855,7 @@ Defined in: [runtime/supervise/patch-deliverable.ts:27](https://github.com/tangl
 
 > `optional` **maxDiffLines?**: `number`
 
-Defined in: [runtime/supervise/patch-checks.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L38)
+Defined in: [runtime/supervise/patch-checks.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L39)
 
 **`Experimental`**
 
@@ -8867,7 +8869,7 @@ Default 400. Hard cap; gate fails when exceeded.
 
 > `optional` **forbiddenPaths?**: `string`[]
 
-Defined in: [runtime/supervise/patch-checks.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L40)
+Defined in: [runtime/supervise/patch-checks.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L41)
 
 **`Experimental`**
 
@@ -8881,7 +8883,7 @@ Literal path prefixes the patch must not touch.
 
 > `optional` **require?**: readonly (`"tests"` \| `"typecheck"`)[]
 
-Defined in: [runtime/supervise/patch-deliverable.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L34)
+Defined in: [runtime/supervise/patch-deliverable.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L35)
 
 **`Experimental`**
 
@@ -8894,7 +8896,7 @@ that command). Default `[]` — gate on no-op / secret / forbidden / diff-size o
 
 ### InMemoryRunContextOptions
 
-Defined in: [runtime/supervise/run-context.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L32)
+Defined in: [runtime/supervise/run-context.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L33)
 
 Options for the in-memory run context.
 
@@ -8904,7 +8906,7 @@ Options for the in-memory run context.
 
 > `readonly` `optional` **withDriver?**: `boolean`
 
-Defined in: [runtime/supervise/run-context.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L39)
+Defined in: [runtime/supervise/run-context.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L40)
 
 Wrap the executor registry with `withDriverExecutor` so a spawned child marked
 `role: 'driver'` resolves to the recursive driver-executor (agents driving agents
@@ -8915,7 +8917,7 @@ leaf workers. Default `false`.
 
 ### InMemoryRunContext
 
-Defined in: [runtime/supervise/run-context.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L46)
+Defined in: [runtime/supervise/run-context.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L47)
 
 The bundle of stores a supervised run needs, shaped to spread into `SupervisorOpts`.
 The fields are exactly `SupervisorOpts`' `journal` / `blobs` / `executors`.
@@ -8926,25 +8928,25 @@ The fields are exactly `SupervisorOpts`' `journal` / `blobs` / `executors`.
 
 > `readonly` **journal**: `SpawnJournal`
 
-Defined in: [runtime/supervise/run-context.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L47)
+Defined in: [runtime/supervise/run-context.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L48)
 
 ##### blobs
 
 > `readonly` **blobs**: [`ResultBlobStore`](#resultblobstore)
 
-Defined in: [runtime/supervise/run-context.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L48)
+Defined in: [runtime/supervise/run-context.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L49)
 
 ##### executors
 
 > `readonly` **executors**: [`ExecutorRegistry`](#executorregistry)
 
-Defined in: [runtime/supervise/run-context.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L49)
+Defined in: [runtime/supervise/run-context.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L50)
 
 ***
 
 ### ProviderSeam
 
-Defined in: [runtime/supervise/runtime.ts:196](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L196)
+Defined in: [runtime/supervise/runtime.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L197)
 
 Generic environment provider executor config. External packages implement
  `AgentEnvironmentProvider`; this built-in wrapper lets `createExecutor`
@@ -9034,13 +9036,13 @@ Defined in: [runtime/environment-provider.ts:273](https://github.com/tangle-netw
 
 > **provider**: `string` \| `AgentEnvironmentProvider`
 
-Defined in: [runtime/supervise/runtime.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L197)
+Defined in: [runtime/supervise/runtime.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L198)
 
 ##### registry?
 
 > `optional` **registry?**: [`AgentEnvironmentProviderRegistry`](runtime/environment-provider.md#agentenvironmentproviderregistry)
 
-Defined in: [runtime/supervise/runtime.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L198)
+Defined in: [runtime/supervise/runtime.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L199)
 
 ***
 
@@ -9409,7 +9411,7 @@ Give the supervisor brain a chapter-lifecycle on its OWN context window (router
 
 ### TraceSource
 
-Defined in: [runtime/supervise/trace-source.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L37)
+Defined in: [runtime/supervise/trace-source.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L38)
 
 #### Methods
 
@@ -9417,7 +9419,7 @@ Defined in: [runtime/supervise/trace-source.ts:37](https://github.com/tangle-net
 
 > **onSpan**(`handler`): () => `void`
 
-Defined in: [runtime/supervise/trace-source.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L40)
+Defined in: [runtime/supervise/trace-source.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L41)
 
 Subscribe to tool spans as they are produced (ONLINE). Returns an unsubscribe. A source that
  only exposes its trace at the end registers nothing and returns a no-op.
@@ -9436,7 +9438,7 @@ Subscribe to tool spans as they are produced (ONLINE). Returns an unsubscribe. A
 
 > **collect**(): `Promise`\<`ToolSpan`[]\>
 
-Defined in: [runtime/supervise/trace-source.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L42)
+Defined in: [runtime/supervise/trace-source.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L43)
 
 The full set of tool spans for the run (SETTLE / batch). Always available.
 
@@ -9448,7 +9450,7 @@ The full set of tool spans for the run (SETTLE / batch). Always available.
 
 ### SessionTraceBox
 
-Defined in: [runtime/supervise/trace-source.ts:278](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L278)
+Defined in: [runtime/supervise/trace-source.ts:279](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L279)
 
 The minimal box surface this needs: list a session's messages (incl. mid-turn partials).
 
@@ -9458,7 +9460,7 @@ The minimal box surface this needs: list a session's messages (incl. mid-turn pa
 
 > **messages**(`opts`): `Promise`\<readonly `SessionMessageLike`[]\>
 
-Defined in: [runtime/supervise/trace-source.ts:279](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L279)
+Defined in: [runtime/supervise/trace-source.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L280)
 
 ###### Parameters
 
@@ -9476,7 +9478,7 @@ Defined in: [runtime/supervise/trace-source.ts:279](https://github.com/tangle-ne
 
 ### TrajectoryAnalysis
 
-Defined in: [runtime/supervise/trajectory-recorder.ts:15](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L15)
+Defined in: [runtime/supervise/trajectory-recorder.ts:16](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L16)
 
 #### Properties
 
@@ -9484,7 +9486,7 @@ Defined in: [runtime/supervise/trajectory-recorder.ts:15](https://github.com/tan
 
 > `readonly` **trajectory**: `Trajectory`
 
-Defined in: [runtime/supervise/trajectory-recorder.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L18)
+Defined in: [runtime/supervise/trajectory-recorder.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L19)
 
 Structured run summary (tool-call count, step order). Steps carry a single timestamp, so per-span
  duration is 0; loop/waste detection keys on call PATTERNS + cross-span windows, not durations.
@@ -9493,7 +9495,7 @@ Structured run summary (tool-call count, step order). Steps carry a single times
 
 > `readonly` **stuckLoop**: `StuckLoopReport`
 
-Defined in: [runtime/supervise/trajectory-recorder.ts:21](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L21)
+Defined in: [runtime/supervise/trajectory-recorder.ts:22](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L22)
 
 Full-run repeated-call view (total occurrences + window) — catches a loop the online consecutive
  detector interleaves past.
@@ -9502,7 +9504,7 @@ Full-run repeated-call view (total occurrences + window) — catches a loop the
 
 > `readonly` **toolWaste**: `ToolWasteReport`
 
-Defined in: [runtime/supervise/trajectory-recorder.ts:23](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L23)
+Defined in: [runtime/supervise/trajectory-recorder.ts:24](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L24)
 
 Wasted-vs-total tool-call ratio for the run.
 
@@ -9510,7 +9512,7 @@ Wasted-vs-total tool-call ratio for the run.
 
 ### Agent
 
-Defined in: [runtime/supervise/types.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L49)
+Defined in: [runtime/supervise/types.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L50)
 
 One self-similar atom. A leaf is an `Agent` that never calls `scope.spawn`; a driver
 is an `Agent` whose `act` spawns children and reacts to them via `scope.next()`. An
@@ -9537,7 +9539,7 @@ unordered collection. `scope.next()` delivers strictly in recorded `seq` order.
 
 > `readonly` **name**: `string`
 
-Defined in: [runtime/supervise/types.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L50)
+Defined in: [runtime/supervise/types.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L51)
 
 #### Methods
 
@@ -9545,7 +9547,7 @@ Defined in: [runtime/supervise/types.ts:50](https://github.com/tangle-network/ag
 
 > **act**(`task`, `scope`): `Promise`\<`Out`\>
 
-Defined in: [runtime/supervise/types.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L51)
+Defined in: [runtime/supervise/types.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L52)
 
 ###### Parameters
 
@@ -9565,7 +9567,7 @@ Defined in: [runtime/supervise/types.ts:51](https://github.com/tangle-network/ag
 
 ### Executor
 
-Defined in: [runtime/supervise/types.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L70)
+Defined in: [runtime/supervise/types.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L71)
 
 The leaf runtime — ONE open interface, not a closed union. `execute` returns a
 `Promise<ExecutorResult>` for one-shot executors OR an `AsyncIterable<UsageEvent>` for
@@ -9592,7 +9594,7 @@ own agent (mastra/agno/raw HTTP/anything) is first-class by implementing this in
 
 > `readonly` **runtime**: [`Runtime`](#runtime-3)
 
-Defined in: [runtime/supervise/types.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L72)
+Defined in: [runtime/supervise/types.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L73)
 
 Stable runtime tag for traces + the equal-k exemption check.
 
@@ -9600,7 +9602,7 @@ Stable runtime tag for traces + the equal-k exemption check.
 
 > `readonly` `optional` **budgetExempt?**: `boolean`
 
-Defined in: [runtime/supervise/types.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L78)
+Defined in: [runtime/supervise/types.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L79)
 
 When true, this executor's spend is NOT metered against the conserved pool and its
 iterations are excluded from the equal-k assertion (a `cli` subprocess without
@@ -9612,7 +9614,7 @@ token accounting). Fail-loud everywhere else: a metered executor MUST report usa
 
 > **execute**(`task`, `signal`): `AsyncIterable`\<[`UsageEvent`](#usageevent), `any`, `any`\> \| `Promise`\<[`ExecutorResult`](#executorresult)\<`Out`\>\>
 
-Defined in: [runtime/supervise/types.ts:84](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L84)
+Defined in: [runtime/supervise/types.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L85)
 
 One-shot → resolves a `ExecutorResult`; streaming → yields incremental `UsageEvent`s and
 the terminal artifact is read from `resultArtifact()` after the stream drains.
@@ -9636,7 +9638,7 @@ the terminal artifact is read from `resultArtifact()` after the stream drains.
 
 > `optional` **deliver**(`msg`): `void`
 
-Defined in: [runtime/supervise/types.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L95)
+Defined in: [runtime/supervise/types.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L96)
 
 Optional inbox: receive an out-of-band message from the driver mid-run (the `send`/`steer_agent`
 verb). A streaming executor drains pending messages between turns and folds them into the next
@@ -9658,7 +9660,7 @@ executor's to ignore.
 
 > **teardown**(`grace`): `Promise`\<\{ `destroyed`: `boolean`; \}\>
 
-Defined in: [runtime/supervise/types.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L100)
+Defined in: [runtime/supervise/types.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L101)
 
 Tear the executor's resources down. `grace` mirrors the OTP shutdown spec
 (`'brutalKill'` = immediate, a number = ms grace, `'infinity'` = await clean exit).
@@ -9677,7 +9679,7 @@ Tear the executor's resources down. `grace` mirrors the OTP shutdown spec
 
 > **resultArtifact**(): `object`
 
-Defined in: [runtime/supervise/types.ts:105](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L105)
+Defined in: [runtime/supervise/types.ts:106](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L106)
 
 The replay source (B1): the content-addressed `outRef` + the materialized output the
 driver branched on, its verdict, and the conserved spend. Read once, after settle.
@@ -9706,7 +9708,7 @@ driver branched on, its verdict, and the conserved spend. Read once, after settl
 
 > `optional` **metered**(): [`Spend`](#spend) \| `undefined`
 
-Defined in: [runtime/supervise/types.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L114)
+Defined in: [runtime/supervise/types.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L115)
 
 A driver-executor's OWN-inference subtree total (rolled up from its nested tree's `metered`
 events) — the parent scope journals it as a `metered` event for this node on settle, on BOTH
@@ -9723,7 +9725,7 @@ executors omit it (returns `undefined`).
 
 ### ExecutorResult
 
-Defined in: [runtime/supervise/types.ts:118](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L118)
+Defined in: [runtime/supervise/types.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L119)
 
 Terminal artifact of a one-shot `Executor.execute`.
 
@@ -9739,31 +9741,31 @@ Terminal artifact of a one-shot `Executor.execute`.
 
 > **outRef**: `string`
 
-Defined in: [runtime/supervise/types.ts:119](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L119)
+Defined in: [runtime/supervise/types.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L120)
 
 ##### out
 
 > **out**: `Out`
 
-Defined in: [runtime/supervise/types.ts:120](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L120)
+Defined in: [runtime/supervise/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L121)
 
 ##### verdict?
 
 > `optional` **verdict?**: `DefaultVerdict`
 
-Defined in: [runtime/supervise/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L121)
+Defined in: [runtime/supervise/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L122)
 
 ##### spent
 
 > **spent**: [`Spend`](#spend)
 
-Defined in: [runtime/supervise/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L122)
+Defined in: [runtime/supervise/types.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L123)
 
 ***
 
 ### AgentSpec
 
-Defined in: [runtime/supervise/types.ts:152](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L152)
+Defined in: [runtime/supervise/types.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L153)
 
 `AgentProfile` does NOT carry a `harness`/backend field — `harness` lives on the
 sandbox SDK's `BackendConfig`, not the portable profile. So an agent is mapped to its
@@ -9781,13 +9783,13 @@ Fail loud on an unresolvable spec (no executor and an unknown harness).
 
 > `readonly` **profile**: `AgentProfile`
 
-Defined in: [runtime/supervise/types.ts:153](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L153)
+Defined in: [runtime/supervise/types.ts:154](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L154)
 
 ##### harness
 
 > `readonly` **harness**: `BackendType` \| `null`
 
-Defined in: [runtime/supervise/types.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L155)
+Defined in: [runtime/supervise/types.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L156)
 
 `null` selects router/inline; a `BackendType` selects the sandboxed harness.
 
@@ -9795,7 +9797,7 @@ Defined in: [runtime/supervise/types.ts:155](https://github.com/tangle-network/a
 
 > `readonly` `optional` **executor?**: [`Executor`](#executor)\<`unknown`\>
 
-Defined in: [runtime/supervise/types.ts:157](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L157)
+Defined in: [runtime/supervise/types.ts:158](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L158)
 
 Bring-your-own executor: when set, overrides harness-based resolution entirely.
 
@@ -9803,7 +9805,7 @@ Bring-your-own executor: when set, overrides harness-based resolution entirely.
 
 ### ExecutorContext
 
-Defined in: [runtime/supervise/types.ts:170](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L170)
+Defined in: [runtime/supervise/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L171)
 
 Construction context handed to a `ExecutorFactory` — the seams a built-in needs
  (sandbox client for the sandbox executor, router config for router/inline) without
@@ -9815,13 +9817,13 @@ Construction context handed to a `ExecutorFactory` — the seams a built-in need
 
 > `readonly` **signal**: `AbortSignal`
 
-Defined in: [runtime/supervise/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L171)
+Defined in: [runtime/supervise/types.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L172)
 
 ##### seams
 
 > `readonly` **seams**: `Readonly`\<`Record`\<`string`, `unknown`\>\>
 
-Defined in: [runtime/supervise/types.ts:173](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L173)
+Defined in: [runtime/supervise/types.ts:174](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L174)
 
 Opaque seams the registry threads through; a built-in narrows what it needs.
 
@@ -9829,7 +9831,7 @@ Opaque seams the registry threads through; a built-in narrows what it needs.
 
 ### ExecutorRegistry
 
-Defined in: [runtime/supervise/types.ts:182](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L182)
+Defined in: [runtime/supervise/types.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L183)
 
 The OPEN resolver: maps an `AgentSpec` to a `ExecutorFactory`. The default
 registry resolves the three built-ins AND accepts a BYO `executor`/factory; callers
@@ -9842,7 +9844,7 @@ point, mirroring the open `Executor` interface.
 
 > **register**\<`Out`\>(`runtime`, `factory`): `void`
 
-Defined in: [runtime/supervise/types.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L184)
+Defined in: [runtime/supervise/types.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L185)
 
 Register a factory for a named runtime. Throws on a duplicate name (fail loud).
 
@@ -9870,7 +9872,7 @@ Register a factory for a named runtime. Throws on a duplicate name (fail loud).
 
 > **resolve**\<`Out`\>(`spec`): \{ `succeeded`: `true`; `value`: [`ExecutorFactory`](#executorfactory)\<`Out`\>; \} \| \{ `succeeded`: `false`; `error`: `string`; \}
 
-Defined in: [runtime/supervise/types.ts:191](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L191)
+Defined in: [runtime/supervise/types.ts:192](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L192)
 
 Resolve a spec to a factory. Precedence: a BYO `spec.executor` → a trivial factory
 returning it; else `harness === null` → the `'router'` factory; else a registered
@@ -9897,7 +9899,7 @@ inspects `succeeded` before `value` (no silent fallback).
 
 ### Budget
 
-Defined in: [runtime/supervise/types.ts:199](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L199)
+Defined in: [runtime/supervise/types.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L200)
 
 A budget envelope on a spawn or the root. All ceilings; the pool reserves against them.
 
@@ -9907,31 +9909,31 @@ A budget envelope on a spawn or the root. All ceilings; the pool reserves agains
 
 > `readonly` **maxIterations**: `number`
 
-Defined in: [runtime/supervise/types.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L200)
+Defined in: [runtime/supervise/types.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L201)
 
 ##### maxTokens
 
 > `readonly` **maxTokens**: `number`
 
-Defined in: [runtime/supervise/types.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L201)
+Defined in: [runtime/supervise/types.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L202)
 
 ##### maxUsd?
 
 > `readonly` `optional` **maxUsd?**: `number`
 
-Defined in: [runtime/supervise/types.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L202)
+Defined in: [runtime/supervise/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L203)
 
 ##### deadlineMs?
 
 > `readonly` `optional` **deadlineMs?**: `number`
 
-Defined in: [runtime/supervise/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L203)
+Defined in: [runtime/supervise/types.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L204)
 
 ***
 
 ### Spend
 
-Defined in: [runtime/supervise/types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L208)
+Defined in: [runtime/supervise/types.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L209)
 
 Conserved spend, reconciled from the normalized `UsageEvent` stream. Tokens and usd
  are separate channels (never folded).
@@ -9942,31 +9944,31 @@ Conserved spend, reconciled from the normalized `UsageEvent` stream. Tokens and
 
 > **iterations**: `number`
 
-Defined in: [runtime/supervise/types.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L209)
+Defined in: [runtime/supervise/types.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L210)
 
 ##### tokens
 
 > **tokens**: [`LoopTokenUsage`](#looptokenusage)
 
-Defined in: [runtime/supervise/types.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L210)
+Defined in: [runtime/supervise/types.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L211)
 
 ##### usd
 
 > **usd**: `number`
 
-Defined in: [runtime/supervise/types.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L211)
+Defined in: [runtime/supervise/types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L212)
 
 ##### ms
 
 > **ms**: `number`
 
-Defined in: [runtime/supervise/types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L212)
+Defined in: [runtime/supervise/types.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L213)
 
 ***
 
 ### Scope
 
-Defined in: [runtime/supervise/types.ts:283](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L283)
+Defined in: [runtime/supervise/types.ts:284](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L284)
 
 The budget-conserving reactive scope an `Agent.act` runs inside. `spawn` reserves
 budget atomically from the shared pool and fails closed when the pool cannot cover it.
@@ -9985,7 +9987,7 @@ not the replay log.
 
 > `readonly` **signal**: `AbortSignal`
 
-Defined in: [runtime/supervise/types.ts:317](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L317)
+Defined in: [runtime/supervise/types.ts:318](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L318)
 
 This scope's abort signal — aborted when the run is cancelled, a breaker trips, the pool
  is exhausted, or a parent scope cascades. A long-running driver `act` over this scope reads
@@ -9996,7 +9998,7 @@ This scope's abort signal — aborted when the run is cancelled, a breaker trips
 
 > `readonly` **view**: [`TreeView`](#treeview)
 
-Defined in: [runtime/supervise/types.ts:331](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L331)
+Defined in: [runtime/supervise/types.ts:332](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L332)
 
 The live tree — reads the in-memory nursery, not the journal.
 
@@ -10004,7 +10006,7 @@ The live tree — reads the in-memory nursery, not the journal.
 
 > `readonly` **budget**: `Readonly`\<\{ `tokensLeft`: `number`; `usdLeft`: `number`; `usdCapped`: `boolean`; `deadlineMs`: `number`; `reservedTokens`: `number`; \}\>
 
-Defined in: [runtime/supervise/types.ts:333](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L333)
+Defined in: [runtime/supervise/types.ts:334](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L334)
 
 Conserved-pool readouts (post-reservation).
 
@@ -10014,7 +10016,7 @@ Conserved-pool readouts (post-reservation).
 
 > **spawn**\<`C`\>(`agent`, `task`, `opts`): \{ `ok`: `true`; `handle`: `Handle`\<`C`\>; \} \| \{ `ok`: `false`; `reason`: `"budget-exhausted"` \| `"depth-exceeded"`; \}
 
-Defined in: [runtime/supervise/types.ts:289](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L289)
+Defined in: [runtime/supervise/types.ts:290](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L290)
 
 Spawn a child. Reserves `opts.budget` from the conserved pool atomically; refunds the
 unspent remainder on settle. Returns a typed outcome — fail-closed on an exhausted
@@ -10048,7 +10050,7 @@ pool or an exceeded depth ceiling (the caller inspects `ok` before `handle`).
 
 > **next**(): `Promise`\<[`Settled`](#settled-2)\<`Out`\> \| `null`\>
 
-Defined in: [runtime/supervise/types.ts:296](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L296)
+Defined in: [runtime/supervise/types.ts:297](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L297)
 
 ray.wait n=1 over this scope's in-memory live set; resolves as each child settles;
  `null` when the live set is empty.
@@ -10061,7 +10063,7 @@ ray.wait n=1 over this scope's in-memory live set; resolves as each child settle
 
 > **nextResolved**(): `Promise`\<[`Settled`](#settled-2)\<`Out`\> \| `null`\>
 
-Defined in: [runtime/supervise/types.ts:303](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L303)
+Defined in: [runtime/supervise/types.ts:304](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L304)
 
 Non-blocking twin of `next()`: deliver an ALREADY-settled, undelivered child, or `null`
 when none is ready — never awaits a live child. The driver's post-loop drain reads this so
@@ -10076,7 +10078,7 @@ the finalize ledger instead of being silently lost.
 
 > **send**(`nodeId`, `msg`): `boolean`
 
-Defined in: [runtime/supervise/types.ts:312](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L312)
+Defined in: [runtime/supervise/types.ts:313](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L313)
 
 Steer a RUNNING child out-of-band — deliver a message to its executor's inbox (the driver's
 `send` verb: next-instruction, interrupt, or resume). Returns `true` if the message was
@@ -10103,7 +10105,7 @@ is a direct call; the sandbox/Agent-Bus transports surface the SAME verb as an M
 
 > **meter**(`spend`, `detail?`): `Promise`\<`void`\>
 
-Defined in: [runtime/supervise/types.ts:329](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L329)
+Defined in: [runtime/supervise/types.ts:330](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L330)
 
 Meter the driver's OWN compute against the conserved pool — its inference turns, which are
 real tokens/usd but not a spawned child (no reserve/reconcile). A direct `free → committed`
@@ -10133,7 +10135,7 @@ metered event is cost-critical, so it lands before the join-barrier roll-up).
 
 ### TreeView
 
-Defined in: [runtime/supervise/types.ts:358](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L358)
+Defined in: [runtime/supervise/types.ts:359](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L359)
 
 The live tree — what `scope.view` / `RootHandle.view()` materialize for a viewer.
 
@@ -10143,19 +10145,19 @@ The live tree — what `scope.view` / `RootHandle.view()` materialize for a view
 
 > `readonly` **root**: `string`
 
-Defined in: [runtime/supervise/types.ts:359](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L359)
+Defined in: [runtime/supervise/types.ts:360](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L360)
 
 ##### nodes
 
 > `readonly` **nodes**: readonly `NodeSnapshot`[]
 
-Defined in: [runtime/supervise/types.ts:360](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L360)
+Defined in: [runtime/supervise/types.ts:361](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L361)
 
 ##### inFlight
 
 > `readonly` **inFlight**: `number`
 
-Defined in: [runtime/supervise/types.ts:362](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L362)
+Defined in: [runtime/supervise/types.ts:363](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L363)
 
 Count of nodes in `running` or `acquiring` — the "what's in flow?" answer.
 
@@ -10163,7 +10165,7 @@ Count of nodes in `running` or `acquiring` — the "what's in flow?" answer.
 
 ### ResultBlobStore
 
-Defined in: [runtime/supervise/types.ts:422](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L422)
+Defined in: [runtime/supervise/types.ts:423](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L423)
 
 Content-addressed result blobs (the `outRef` → artifact map) backing the replay
  invariant. Split from the journal so the journal stays small (decisions) and the
@@ -10175,7 +10177,7 @@ Content-addressed result blobs (the `outRef` → artifact map) backing the repla
 
 > **put**(`outRef`, `artifact`): `Promise`\<`void`\>
 
-Defined in: [runtime/supervise/types.ts:423](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L423)
+Defined in: [runtime/supervise/types.ts:424](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L424)
 
 ###### Parameters
 
@@ -10195,7 +10197,7 @@ Defined in: [runtime/supervise/types.ts:423](https://github.com/tangle-network/a
 
 > **get**(`outRef`): `Promise`\<`unknown`\>
 
-Defined in: [runtime/supervise/types.ts:424](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L424)
+Defined in: [runtime/supervise/types.ts:425](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L425)
 
 ###### Parameters
 
@@ -10211,7 +10213,7 @@ Defined in: [runtime/supervise/types.ts:424](https://github.com/tangle-network/a
 
 ### Supervisor
 
-Defined in: [runtime/supervise/types.ts:434](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L434)
+Defined in: [runtime/supervise/types.ts:435](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L435)
 
 Owns the conserved pool, the spawn log, the abort cascade, the OTP intensity breaker,
 and the root handle. `run` executes the root `Agent` to completion; `attach` wires a
@@ -10233,7 +10235,7 @@ live `RootHandle` (the Q2 substrate the chat/pi-viz client later consumes).
 
 > **run**(`root`, `task`, `opts`): `Promise`\<[`SupervisedResult`](#supervisedresult)\<`Out`\>\>
 
-Defined in: [runtime/supervise/types.ts:435](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L435)
+Defined in: [runtime/supervise/types.ts:436](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L436)
 
 ###### Parameters
 
@@ -10257,7 +10259,7 @@ Defined in: [runtime/supervise/types.ts:435](https://github.com/tangle-network/a
 
 > **attach**(`h`): `void`
 
-Defined in: [runtime/supervise/types.ts:436](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L436)
+Defined in: [runtime/supervise/types.ts:437](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L437)
 
 ###### Parameters
 
@@ -10273,7 +10275,7 @@ Defined in: [runtime/supervise/types.ts:436](https://github.com/tangle-network/a
 
 ### SupervisorOpts
 
-Defined in: [runtime/supervise/types.ts:439](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L439)
+Defined in: [runtime/supervise/types.ts:440](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L440)
 
 #### Properties
 
@@ -10281,7 +10283,7 @@ Defined in: [runtime/supervise/types.ts:439](https://github.com/tangle-network/a
 
 > `readonly` **budget**: [`Budget`](#budget-12)
 
-Defined in: [runtime/supervise/types.ts:441](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L441)
+Defined in: [runtime/supervise/types.ts:442](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L442)
 
 The root conserved-pool ceiling (tokens + usd + iterations + deadline).
 
@@ -10289,7 +10291,7 @@ The root conserved-pool ceiling (tokens + usd + iterations + deadline).
 
 > `readonly` **runId**: `string`
 
-Defined in: [runtime/supervise/types.ts:443](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L443)
+Defined in: [runtime/supervise/types.ts:444](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L444)
 
 Trace-correlation root + the journal/blob root key.
 
@@ -10297,7 +10299,7 @@ Trace-correlation root + the journal/blob root key.
 
 > `readonly` **journal**: `SpawnJournal`
 
-Defined in: [runtime/supervise/types.ts:445](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L445)
+Defined in: [runtime/supervise/types.ts:446](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L446)
 
 Event source — defaults to the in-memory journal in the impl; pass JSONL/FS for durability.
 
@@ -10305,7 +10307,7 @@ Event source — defaults to the in-memory journal in the impl; pass JSONL/FS fo
 
 > `readonly` **blobs**: [`ResultBlobStore`](#resultblobstore)
 
-Defined in: [runtime/supervise/types.ts:447](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L447)
+Defined in: [runtime/supervise/types.ts:448](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L448)
 
 Result payload store backing `outRef` rehydration.
 
@@ -10313,7 +10315,7 @@ Result payload store backing `outRef` rehydration.
 
 > `readonly` **executors**: [`ExecutorRegistry`](#executorregistry)
 
-Defined in: [runtime/supervise/types.ts:449](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L449)
+Defined in: [runtime/supervise/types.ts:450](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L450)
 
 Executor resolution — the open registry mapping `AgentSpec` → `Executor`.
 
@@ -10321,7 +10323,7 @@ Executor resolution — the open registry mapping `AgentSpec` → `Executor`.
 
 > `readonly` `optional` **maxDepth?**: `number`
 
-Defined in: [runtime/supervise/types.ts:451](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L451)
+Defined in: [runtime/supervise/types.ts:452](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L452)
 
 Runtime recursion-depth ceiling (paired with the conserved pool per R3).
 
@@ -10329,7 +10331,7 @@ Runtime recursion-depth ceiling (paired with the conserved pool per R3).
 
 > `readonly` `optional` **maxRestarts?**: `number`
 
-Defined in: [runtime/supervise/types.ts:456](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L456)
+Defined in: [runtime/supervise/types.ts:457](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L457)
 
 OTP intensity breaker: more than `maxRestarts` child restarts within `withinMs`
 trips the supervisor to `no-winner` rather than restarting forever.
@@ -10338,13 +10340,13 @@ trips the supervisor to `no-winner` rather than restarting forever.
 
 > `readonly` `optional` **withinMs?**: `number`
 
-Defined in: [runtime/supervise/types.ts:457](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L457)
+Defined in: [runtime/supervise/types.ts:458](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L458)
 
 ##### now?
 
 > `readonly` `optional` **now?**: () => `number`
 
-Defined in: [runtime/supervise/types.ts:458](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L458)
+Defined in: [runtime/supervise/types.ts:459](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L459)
 
 ###### Returns
 
@@ -10354,13 +10356,13 @@ Defined in: [runtime/supervise/types.ts:458](https://github.com/tangle-network/a
 
 > `readonly` `optional` **signal?**: `AbortSignal`
 
-Defined in: [runtime/supervise/types.ts:459](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L459)
+Defined in: [runtime/supervise/types.ts:460](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L460)
 
 ##### hooks?
 
 > `readonly` `optional` **hooks?**: [`RuntimeHooks`](index.md#runtimehooks)
 
-Defined in: [runtime/supervise/types.ts:462](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L462)
+Defined in: [runtime/supervise/types.ts:463](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L463)
 
 Lifecycle stream sink, threaded into the root `Scope` so every `spawn`/settle emits on the
  same `agent.spawn`/`agent.child` stream `runLoop` feeds — one observable recursive tree.
@@ -10369,7 +10371,7 @@ Lifecycle stream sink, threaded into the root `Scope` so every `spawn`/settle em
 
 ### WidenGate
 
-Defined in: [runtime/supervise/types.ts:518](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L518)
+Defined in: [runtime/supervise/types.ts:519](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L519)
 
 The progressive-widening gate (MCTS-PW). Decides whether a settled child is
 `promising` enough to spawn another under the remaining pool. DEFAULTS TO FLAT
@@ -10390,7 +10392,7 @@ an explicit, argued `judgeExempt: true` (the documented escape hatch, off by def
 
 > `readonly` `optional` **judgeExempt?**: `boolean`
 
-Defined in: [runtime/supervise/types.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L523)
+Defined in: [runtime/supervise/types.ts:524](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L524)
 
 When true, widening may read `verdict` directly (collides with the steer firewall —
  must be explicitly argued per cell, never defaulted on).
@@ -10401,7 +10403,7 @@ When true, widening may read `verdict` directly (collides with the steer firewal
 
 > **shouldWiden**(`settled`, `budget`): `boolean`
 
-Defined in: [runtime/supervise/types.ts:520](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L520)
+Defined in: [runtime/supervise/types.ts:521](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L521)
 
 Default impl returns false for every settlement (flat — never widens).
 
@@ -10423,7 +10425,7 @@ Default impl returns false for every settlement (flat — never widens).
 
 ### WorktreeCliExecutorOptions
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L46)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L47)
 
 **`Experimental`**
 
@@ -10433,7 +10435,7 @@ Defined in: [runtime/supervise/worktree-cli-executor.ts:46](https://github.com/t
 
 > **repoRoot**: `string`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L48)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L49)
 
 **`Experimental`**
 
@@ -10443,7 +10445,7 @@ Absolute path to the git checkout the worktree is cut from.
 
 > **profile**: `AgentProfile`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L50)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L51)
 
 **`Experimental`**
 
@@ -10453,7 +10455,7 @@ The SUPERVISOR-AUTHORED profile (the §1.5 payload: systemPrompt + model).
 
 > **harness**: [`LocalHarness`](mcp.md#localharness)
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L52)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L53)
 
 **`Experimental`**
 
@@ -10463,7 +10465,7 @@ Which local harness CLI drives this leaf (`claude` | `codex` | `opencode`).
 
 > **taskPrompt**: `string`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L54)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L55)
 
 **`Experimental`**
 
@@ -10473,7 +10475,7 @@ The per-task instruction handed to the harness (composed under the system prompt
 
 > `optional` **runId?**: `string`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L56)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L57)
 
 **`Experimental`**
 
@@ -10483,7 +10485,7 @@ Unique id for the worktree path + branch. Defaults to a fresh UUID.
 
 > `optional` **baseRef?**: `string`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L58)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L59)
 
 **`Experimental`**
 
@@ -10493,7 +10495,7 @@ Override the base ref the worktree is cut from (default `HEAD`).
 
 > `optional` **harnessTimeoutMs?**: `number`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L60)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L61)
 
 **`Experimental`**
 
@@ -10503,7 +10505,7 @@ Wall-clock cap per harness subprocess (ms). Default 5 min (the `runLocalHarness`
 
 > `optional` **testCmd?**: `string`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L65)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L66)
 
 **`Experimental`**
 
@@ -10514,7 +10516,7 @@ Its exit code becomes `artifact.checks.tests.passed`. Omit to skip (no signal de
 
 > `optional` **typecheckCmd?**: `string`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L67)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L68)
 
 **`Experimental`**
 
@@ -10524,7 +10526,7 @@ Shell command run in the live worktree to derive the typecheck-PASS signal (e.g.
 
 > `optional` **checkTimeoutMs?**: `number`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L69)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L70)
 
 **`Experimental`**
 
@@ -10534,7 +10536,7 @@ Wall-clock cap per verification command (ms). Default = `harnessTimeoutMs` or 5
 
 > `optional` **checkOutputCap?**: `number`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L71)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L72)
 
 **`Experimental`**
 
@@ -10544,7 +10546,7 @@ Cap on each check's captured output. Default 16k.
 
 > `optional` **runGit?**: [`GitRunner`](mcp.md#gitrunner)
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L73)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L74)
 
 **`Experimental`**
 
@@ -10554,7 +10556,7 @@ Test seam — inject a git runner so unit tests drive the worktree helpers witho
 
 > `optional` **runHarness?**: (`options`) => `Promise`\<[`LocalHarnessResult`](mcp.md#localharnessresult)\>
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L75)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L76)
 
 **`Experimental`**
 
@@ -10592,7 +10594,7 @@ Does NOT throw when:
 
 > `optional` **runCommand?**: `WorktreeCheckRunner`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L78)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L79)
 
 **`Experimental`**
 
@@ -10603,7 +10605,7 @@ Test seam — inject the verification-command runner so unit tests script test/t
 
 > `optional` **budgetExempt?**: `boolean`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L85)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L86)
 
 **`Experimental`**
 
@@ -10616,7 +10618,7 @@ token/usd usage worth metering — the executor would then debit the (real) spen
 
 ### AuthoredHarness
 
-Defined in: [runtime/supervise/worktree-fanout.ts:30](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L30)
+Defined in: [runtime/supervise/worktree-fanout.ts:31](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L31)
 
 **`Experimental`**
 
@@ -10629,7 +10631,7 @@ One authored harness profile in a worktree fanout: the §1.5 profile + which loc
 
 > **name**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L32)
+Defined in: [runtime/supervise/worktree-fanout.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L33)
 
 **`Experimental`**
 
@@ -10639,7 +10641,7 @@ A short label for the worktree branch + trace node.
 
 > **profile**: `AgentProfile`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L34)
+Defined in: [runtime/supervise/worktree-fanout.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L35)
 
 **`Experimental`**
 
@@ -10649,7 +10651,7 @@ The supervisor-authored `AgentProfile` (systemPrompt + model reach the harness v
 
 > **harness**: `"opencode"` \| `"codex"` \| `"claude"`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:36](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L36)
+Defined in: [runtime/supervise/worktree-fanout.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L37)
 
 **`Experimental`**
 
@@ -10659,7 +10661,7 @@ Which local harness CLI drives this leaf.
 
 > `optional` **runId?**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L38)
+Defined in: [runtime/supervise/worktree-fanout.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L39)
 
 **`Experimental`**
 
@@ -10669,7 +10671,7 @@ Per-harness model/runId/baseRef overrides flow through the profile + these.
 
 > `optional` **baseRef?**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L39)
+Defined in: [runtime/supervise/worktree-fanout.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L40)
 
 **`Experimental`**
 
@@ -10677,7 +10679,7 @@ Defined in: [runtime/supervise/worktree-fanout.ts:39](https://github.com/tangle-
 
 ### WorktreeFanoutOptions
 
-Defined in: [runtime/supervise/worktree-fanout.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L43)
+Defined in: [runtime/supervise/worktree-fanout.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L44)
 
 **`Experimental`**
 
@@ -10691,7 +10693,7 @@ Defined in: [runtime/supervise/worktree-fanout.ts:43](https://github.com/tangle-
 
 > `optional` **maxDiffLines?**: `number`
 
-Defined in: [runtime/supervise/patch-checks.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L38)
+Defined in: [runtime/supervise/patch-checks.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L39)
 
 **`Experimental`**
 
@@ -10705,7 +10707,7 @@ Default 400. Hard cap; gate fails when exceeded.
 
 > `optional` **forbiddenPaths?**: `string`[]
 
-Defined in: [runtime/supervise/patch-checks.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L40)
+Defined in: [runtime/supervise/patch-checks.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-checks.ts#L41)
 
 **`Experimental`**
 
@@ -10719,7 +10721,7 @@ Literal path prefixes the patch must not touch.
 
 > `optional` **require?**: readonly (`"tests"` \| `"typecheck"`)[]
 
-Defined in: [runtime/supervise/patch-deliverable.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L34)
+Defined in: [runtime/supervise/patch-deliverable.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L35)
 
 **`Experimental`**
 
@@ -10736,7 +10738,7 @@ that command). Default `[]` — gate on no-op / secret / forbidden / diff-size o
 
 > **repoRoot**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L45)
+Defined in: [runtime/supervise/worktree-fanout.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L46)
 
 **`Experimental`**
 
@@ -10746,7 +10748,7 @@ Absolute path to the git checkout each worktree is cut from.
 
 > **taskPrompt**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L47)
+Defined in: [runtime/supervise/worktree-fanout.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L48)
 
 **`Experimental`**
 
@@ -10756,7 +10758,7 @@ The per-task instruction handed to every harness (composed under each profile's
 
 > **harnesses**: readonly [`AuthoredHarness`](#authoredharness)[]
 
-Defined in: [runtime/supervise/worktree-fanout.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L49)
+Defined in: [runtime/supervise/worktree-fanout.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L50)
 
 **`Experimental`**
 
@@ -10766,7 +10768,7 @@ The authored harness profiles — one fanout item (and one worktree-CLI leaf) ea
 
 > `optional` **deliverable?**: [`DeliverableSpec`](#deliverablespec)\<`WorktreeHarnessResult`\>
 
-Defined in: [runtime/supervise/worktree-fanout.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L55)
+Defined in: [runtime/supervise/worktree-fanout.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L56)
 
 **`Experimental`**
 
@@ -10778,7 +10780,7 @@ no-op/secret/forbidden/diff-size + required test/typecheck gate). Pass any
 
 > `optional` **testCmd?**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L57)
+Defined in: [runtime/supervise/worktree-fanout.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L58)
 
 **`Experimental`**
 
@@ -10788,7 +10790,7 @@ Shell command run in each worktree to derive the tests-PASS signal.
 
 > `optional` **typecheckCmd?**: `string`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L59)
+Defined in: [runtime/supervise/worktree-fanout.ts:60](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L60)
 
 **`Experimental`**
 
@@ -10798,7 +10800,7 @@ Shell command run in each worktree to derive the typecheck-PASS signal.
 
 > `optional` **harnessTimeoutMs?**: `number`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:61](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L61)
+Defined in: [runtime/supervise/worktree-fanout.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L62)
 
 **`Experimental`**
 
@@ -10808,7 +10810,7 @@ Wall-clock cap per harness subprocess (ms).
 
 > `optional` **winnerStrategy?**: [`WinnerStrategy`](#winnerstrategy)
 
-Defined in: [runtime/supervise/worktree-fanout.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L63)
+Defined in: [runtime/supervise/worktree-fanout.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L64)
 
 **`Experimental`**
 
@@ -10818,7 +10820,7 @@ Winner-selection strategy. Default `highest-score`.
 
 > `optional` **runGit?**: [`GitRunner`](mcp.md#gitrunner)
 
-Defined in: [runtime/supervise/worktree-fanout.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L66)
+Defined in: [runtime/supervise/worktree-fanout.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L67)
 
 **`Experimental`**
 
@@ -10829,7 +10831,7 @@ Test seams forwarded to every worktree-CLI leaf (inject git/harness/command runn
 
 > `optional` **runHarness?**: (`options`) => `Promise`\<[`LocalHarnessResult`](mcp.md#localharnessresult)\>
 
-Defined in: [runtime/supervise/worktree-fanout.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L67)
+Defined in: [runtime/supervise/worktree-fanout.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L68)
 
 **`Experimental`**
 
@@ -10865,7 +10867,7 @@ Does NOT throw when:
 
 > `optional` **runCommand?**: `WorktreeCheckRunner`
 
-Defined in: [runtime/supervise/worktree-fanout.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L68)
+Defined in: [runtime/supervise/worktree-fanout.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L69)
 
 **`Experimental`**
 
@@ -10973,7 +10975,7 @@ Notified each time a compaction fires — for observability/metering.
 
 ### ValidationCtx
 
-Defined in: [runtime/types.ts:32](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L32)
+Defined in: [runtime/types.ts:33](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L33)
 
 **`Experimental`**
 
@@ -10983,7 +10985,7 @@ Defined in: [runtime/types.ts:32](https://github.com/tangle-network/agent-runtim
 
 > **iteration**: `number`
 
-Defined in: [runtime/types.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L34)
+Defined in: [runtime/types.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L35)
 
 **`Experimental`**
 
@@ -10993,7 +10995,7 @@ Iteration index this output came from (0-based).
 
 > `optional` **box?**: `SandboxInstance`
 
-Defined in: [runtime/types.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L40)
+Defined in: [runtime/types.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L41)
 
 **`Experimental`**
 
@@ -11005,7 +11007,7 @@ to bypass the loop kernel with raw Sandbox SDK orchestration.
 
 > **signal**: `AbortSignal`
 
-Defined in: [runtime/types.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L42)
+Defined in: [runtime/types.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L43)
 
 **`Experimental`**
 
@@ -11015,7 +11017,7 @@ Cooperative cancellation channel.
 
 > `optional` **traceEmitter?**: [`LoopTraceEmitter`](#looptraceemitter)
 
-Defined in: [runtime/types.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L48)
+Defined in: [runtime/types.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L49)
 
 **`Experimental`**
 
@@ -11027,7 +11029,7 @@ The kernel passes `ctx.traceEmitter` from `ExecCtx` when available.
 
 ### Validator
 
-Defined in: [runtime/types.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L52)
+Defined in: [runtime/types.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L53)
 
 **`Experimental`**
 
@@ -11047,7 +11049,7 @@ Defined in: [runtime/types.ts:52](https://github.com/tangle-network/agent-runtim
 
 > **validate**(`output`, `ctx`): `Promise`\<`Verdict`\>
 
-Defined in: [runtime/types.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L53)
+Defined in: [runtime/types.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L54)
 
 **`Experimental`**
 
@@ -11069,7 +11071,7 @@ Defined in: [runtime/types.ts:53](https://github.com/tangle-network/agent-runtim
 
 ### AgentRunSpec
 
-Defined in: [runtime/types.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L67)
+Defined in: [runtime/types.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L68)
 
 **`Experimental`**
 
@@ -11093,7 +11095,7 @@ through them when the driver plans N tasks.
 
 > **profile**: `AgentProfile`
 
-Defined in: [runtime/types.ts:69](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L69)
+Defined in: [runtime/types.ts:70](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L70)
 
 **`Experimental`**
 
@@ -11103,7 +11105,7 @@ Sandbox SDK profile — what kind of agent runs the task.
 
 > **taskToPrompt**: (`task`) => `string`
 
-Defined in: [runtime/types.ts:71](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L71)
+Defined in: [runtime/types.ts:72](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L72)
 
 **`Experimental`**
 
@@ -11123,7 +11125,7 @@ Task → prompt formatter. Pure and deterministic.
 
 > `optional` **prepareBox?**: (`box`, `ctx`) => `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime/types.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L85)
+Defined in: [runtime/types.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L86)
 
 **`Experimental`**
 
@@ -11163,7 +11165,7 @@ meaning to the entries; not calling it simply leaves the manifest empty.
 
 > `optional` **name?**: `string`
 
-Defined in: [runtime/types.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L93)
+Defined in: [runtime/types.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L94)
 
 **`Experimental`**
 
@@ -11174,7 +11176,7 @@ selector tiebreak. Falls back to `profile.name ?? 'agent'`.
 
 > `optional` **sandboxOverrides?**: `Partial`\<`Omit`\<`CreateSandboxOptions`, `"backend"`\>\> & `object`
 
-Defined in: [runtime/types.ts:99](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L99)
+Defined in: [runtime/types.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L100)
 
 **`Experimental`**
 
@@ -11192,7 +11194,7 @@ kernel and cannot be overridden here — use `profile` itself for that.
 
 ### OutputAdapter
 
-Defined in: [runtime/types.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L113)
+Defined in: [runtime/types.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L114)
 
 **`Experimental`**
 
@@ -11214,7 +11216,7 @@ persisted streams during tests / replays.
 
 > **parse**(`events`): `Output`
 
-Defined in: [runtime/types.ts:114](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L114)
+Defined in: [runtime/types.ts:115](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L115)
 
 **`Experimental`**
 
@@ -11232,7 +11234,7 @@ Defined in: [runtime/types.ts:114](https://github.com/tangle-network/agent-runti
 
 ### LoopTokenUsage
 
-Defined in: [runtime/types.ts:121](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L121)
+Defined in: [runtime/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L122)
 
 LLM token usage. Structurally matches agent-eval's `RunTokenUsage` /
  `CampaignTokenUsage` ({ input, output }) so a loop result maps straight
@@ -11245,19 +11247,19 @@ LLM token usage. Structurally matches agent-eval's `RunTokenUsage` /
 
 > **input**: `number`
 
-Defined in: [runtime/types.ts:122](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L122)
+Defined in: [runtime/types.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L123)
 
 ##### output
 
 > **output**: `number`
 
-Defined in: [runtime/types.ts:123](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L123)
+Defined in: [runtime/types.ts:124](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L124)
 
 ***
 
 ### MountManifestEntry
 
-Defined in: [runtime/types.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L137)
+Defined in: [runtime/types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L138)
 
 **`Experimental`**
 
@@ -11275,7 +11277,7 @@ auditable after the fact ("what exactly was this agent given?").
 
 > **path**: `string`
 
-Defined in: [runtime/types.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L139)
+Defined in: [runtime/types.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L140)
 
 **`Experimental`**
 
@@ -11285,7 +11287,7 @@ Destination path inside the box where the resource was placed.
 
 > **sha256**: `string`
 
-Defined in: [runtime/types.ts:142](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L142)
+Defined in: [runtime/types.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L143)
 
 **`Experimental`**
 
@@ -11296,7 +11298,7 @@ Hex SHA-256 of the mounted bytes. The caller computes it from the bytes
 
 > **bytes**: `number`
 
-Defined in: [runtime/types.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L144)
+Defined in: [runtime/types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L145)
 
 **`Experimental`**
 
@@ -11306,7 +11308,7 @@ Size of the mounted resource in bytes.
 
 > **source**: `string`
 
-Defined in: [runtime/types.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L147)
+Defined in: [runtime/types.ts:148](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L148)
 
 **`Experimental`**
 
@@ -11317,7 +11319,7 @@ Free-form origin of the resource (e.g. a repo ref, a corpus id, a local
 
 ### SelectionReceipt
 
-Defined in: [runtime/types.ts:159](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L159)
+Defined in: [runtime/types.ts:160](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L160)
 
 **`Experimental`**
 
@@ -11333,7 +11335,7 @@ per scored candidate at finalize so a run answers "why did THIS one win?".
 
 > **candidateIndex**: `number`
 
-Defined in: [runtime/types.ts:161](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L161)
+Defined in: [runtime/types.ts:162](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L162)
 
 **`Experimental`**
 
@@ -11343,7 +11345,7 @@ Iteration index this receipt is about.
 
 > **selected**: `boolean`
 
-Defined in: [runtime/types.ts:163](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L163)
+Defined in: [runtime/types.ts:164](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L164)
 
 **`Experimental`**
 
@@ -11353,7 +11355,7 @@ True for the iteration the selector chose as winner; false otherwise.
 
 > `optional` **score?**: `number`
 
-Defined in: [runtime/types.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L165)
+Defined in: [runtime/types.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L166)
 
 **`Experimental`**
 
@@ -11363,7 +11365,7 @@ The candidate's verdict score, when it has one.
 
 > `optional` **reason?**: `string`
 
-Defined in: [runtime/types.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L167)
+Defined in: [runtime/types.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L168)
 
 **`Experimental`**
 
@@ -11373,7 +11375,7 @@ Why this candidate was (or was not) selected, when the selector states it.
 
 > **selector**: `"driver"` \| `"caller"` \| `"default"`
 
-Defined in: [runtime/types.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L171)
+Defined in: [runtime/types.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L172)
 
 **`Experimental`**
 
@@ -11385,7 +11387,7 @@ Identity of the selector that produced this receipt — `'caller'` (an
 
 ### RunProvenance
 
-Defined in: [runtime/types.ts:183](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L183)
+Defined in: [runtime/types.ts:184](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L184)
 
 **`Experimental`**
 
@@ -11401,7 +11403,7 @@ candidate to select.
 
 > **mounts**: [`MountManifestEntry`](#mountmanifestentry)[]
 
-Defined in: [runtime/types.ts:185](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L185)
+Defined in: [runtime/types.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L186)
 
 **`Experimental`**
 
@@ -11411,7 +11413,7 @@ Every resource recorded via `prepareBox`'s `recordMount`, in record order.
 
 > **selectionReceipts**: [`SelectionReceipt`](#selectionreceipt)[]
 
-Defined in: [runtime/types.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L187)
+Defined in: [runtime/types.ts:188](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L188)
 
 **`Experimental`**
 
@@ -11421,7 +11423,7 @@ One receipt per scored candidate at finalize, in iteration order.
 
 ### Iteration
 
-Defined in: [runtime/types.ts:200](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L200)
+Defined in: [runtime/types.ts:201](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L201)
 
 **`Experimental`**
 
@@ -11441,7 +11443,7 @@ Defined in: [runtime/types.ts:200](https://github.com/tangle-network/agent-runti
 
 > **index**: `number`
 
-Defined in: [runtime/types.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L202)
+Defined in: [runtime/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L203)
 
 **`Experimental`**
 
@@ -11451,7 +11453,7 @@ Defined in: [runtime/types.ts:202](https://github.com/tangle-network/agent-runti
 
 > **task**: `Task`
 
-Defined in: [runtime/types.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L203)
+Defined in: [runtime/types.ts:204](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L204)
 
 **`Experimental`**
 
@@ -11459,7 +11461,7 @@ Defined in: [runtime/types.ts:203](https://github.com/tangle-network/agent-runti
 
 > **agentRunName**: `string`
 
-Defined in: [runtime/types.ts:205](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L205)
+Defined in: [runtime/types.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L206)
 
 **`Experimental`**
 
@@ -11469,7 +11471,7 @@ Stable name of the `AgentRunSpec` that produced this iteration.
 
 > `optional` **output?**: `Output`
 
-Defined in: [runtime/types.ts:206](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L206)
+Defined in: [runtime/types.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L207)
 
 **`Experimental`**
 
@@ -11477,7 +11479,7 @@ Defined in: [runtime/types.ts:206](https://github.com/tangle-network/agent-runti
 
 > `optional` **verdict?**: `DefaultVerdict`
 
-Defined in: [runtime/types.ts:207](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L207)
+Defined in: [runtime/types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L208)
 
 **`Experimental`**
 
@@ -11485,7 +11487,7 @@ Defined in: [runtime/types.ts:207](https://github.com/tangle-network/agent-runti
 
 > `optional` **error?**: `Error`
 
-Defined in: [runtime/types.ts:208](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L208)
+Defined in: [runtime/types.ts:209](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L209)
 
 **`Experimental`**
 
@@ -11493,7 +11495,7 @@ Defined in: [runtime/types.ts:208](https://github.com/tangle-network/agent-runti
 
 > **events**: `SandboxEvent`[]
 
-Defined in: [runtime/types.ts:210](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L210)
+Defined in: [runtime/types.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L211)
 
 **`Experimental`**
 
@@ -11503,7 +11505,7 @@ Raw sandbox event stream collected for this iteration.
 
 > **startedAt**: `number`
 
-Defined in: [runtime/types.ts:211](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L211)
+Defined in: [runtime/types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L212)
 
 **`Experimental`**
 
@@ -11511,7 +11513,7 @@ Defined in: [runtime/types.ts:211](https://github.com/tangle-network/agent-runti
 
 > **endedAt**: `number`
 
-Defined in: [runtime/types.ts:212](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L212)
+Defined in: [runtime/types.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L213)
 
 **`Experimental`**
 
@@ -11519,7 +11521,7 @@ Defined in: [runtime/types.ts:212](https://github.com/tangle-network/agent-runti
 
 > **costUsd**: `number`
 
-Defined in: [runtime/types.ts:213](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L213)
+Defined in: [runtime/types.ts:214](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L214)
 
 **`Experimental`**
 
@@ -11527,7 +11529,7 @@ Defined in: [runtime/types.ts:213](https://github.com/tangle-network/agent-runti
 
 > **tokenUsage**: [`LoopTokenUsage`](#looptokenusage)
 
-Defined in: [runtime/types.ts:215](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L215)
+Defined in: [runtime/types.ts:216](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L216)
 
 **`Experimental`**
 
@@ -11537,7 +11539,7 @@ Summed LLM token usage across every `llm_call` event in this iteration.
 
 ### Driver
 
-Defined in: [runtime/types.ts:219](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L219)
+Defined in: [runtime/types.ts:220](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L220)
 
 **`Experimental`**
 
@@ -11561,7 +11563,7 @@ Defined in: [runtime/types.ts:219](https://github.com/tangle-network/agent-runti
 
 > `readonly` `optional` **name?**: `string`
 
-Defined in: [runtime/types.ts:223](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L223)
+Defined in: [runtime/types.ts:224](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L224)
 
 **`Experimental`**
 
@@ -11573,7 +11575,7 @@ Stable identifier surfaced in trace events. Default `'driver'`.
 
 > **plan**(`task`, `history`): `Promise`\<`Task`[]\>
 
-Defined in: [runtime/types.ts:228](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L228)
+Defined in: [runtime/types.ts:229](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L229)
 
 **`Experimental`**
 
@@ -11598,7 +11600,7 @@ readonly [`Iteration`](#iteration-1)\<`Task`, `Output`\>[]
 
 > **decide**(`history`): `Decision` \| `Promise`\<`Decision`\>
 
-Defined in: [runtime/types.ts:235](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L235)
+Defined in: [runtime/types.ts:236](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L236)
 
 **`Experimental`**
 
@@ -11621,7 +11623,7 @@ readonly [`Iteration`](#iteration-1)\<`Task`, `Output`\>[]
 
 > `optional` **describePlan**(): [`LoopPlanDescription`](#loopplandescription) \| `undefined`
 
-Defined in: [runtime/types.ts:245](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L245)
+Defined in: [runtime/types.ts:246](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L246)
 
 **`Experimental`**
 
@@ -11641,7 +11643,7 @@ own topology returns its chosen move's kind + rationale here.
 
 > `optional` **selectWinner**(`history`): [`LoopWinner`](#loopwinner)\<`Task`, `Output`\> \| `undefined`
 
-Defined in: [runtime/types.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L255)
+Defined in: [runtime/types.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L256)
 
 **`Experimental`**
 
@@ -11666,7 +11668,7 @@ readonly [`Iteration`](#iteration-1)\<`Task`, `Output`\>[]
 
 ### LoopPlanDescription
 
-Defined in: [runtime/types.ts:261](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L261)
+Defined in: [runtime/types.ts:262](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L262)
 
 **`Experimental`**
 
@@ -11678,7 +11680,7 @@ Driver-supplied description of the just-planned move.
 
 > **kind**: `string`
 
-Defined in: [runtime/types.ts:263](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L263)
+Defined in: [runtime/types.ts:264](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L264)
 
 **`Experimental`**
 
@@ -11688,7 +11690,7 @@ Topology move this round — e.g. `'refine' | 'fanout' | 'verify' | 'stop'`.
 
 > `optional` **rationale?**: `string`
 
-Defined in: [runtime/types.ts:265](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L265)
+Defined in: [runtime/types.ts:266](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L266)
 
 **`Experimental`**
 
@@ -11698,7 +11700,7 @@ Why the driver chose this move (the agent's rationale), when available.
 
 > `optional` **parentIndex?**: `number`
 
-Defined in: [runtime/types.ts:272](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L272)
+Defined in: [runtime/types.ts:273](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L273)
 
 **`Experimental`**
 
@@ -11711,7 +11713,7 @@ Omit to keep the inferred (best-valid / latest) branch point.
 
 ### LoopWinner
 
-Defined in: [runtime/types.ts:276](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L276)
+Defined in: [runtime/types.ts:277](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L277)
 
 **`Experimental`**
 
@@ -11731,7 +11733,7 @@ Defined in: [runtime/types.ts:276](https://github.com/tangle-network/agent-runti
 
 > **task**: `Task`
 
-Defined in: [runtime/types.ts:277](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L277)
+Defined in: [runtime/types.ts:278](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L278)
 
 **`Experimental`**
 
@@ -11739,7 +11741,7 @@ Defined in: [runtime/types.ts:277](https://github.com/tangle-network/agent-runti
 
 > **output**: `Output`
 
-Defined in: [runtime/types.ts:278](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L278)
+Defined in: [runtime/types.ts:279](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L279)
 
 **`Experimental`**
 
@@ -11747,7 +11749,7 @@ Defined in: [runtime/types.ts:278](https://github.com/tangle-network/agent-runti
 
 > `optional` **verdict?**: `DefaultVerdict`
 
-Defined in: [runtime/types.ts:279](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L279)
+Defined in: [runtime/types.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L280)
 
 **`Experimental`**
 
@@ -11755,7 +11757,7 @@ Defined in: [runtime/types.ts:279](https://github.com/tangle-network/agent-runti
 
 > **iterationIndex**: `number`
 
-Defined in: [runtime/types.ts:280](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L280)
+Defined in: [runtime/types.ts:281](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L281)
 
 **`Experimental`**
 
@@ -11763,7 +11765,7 @@ Defined in: [runtime/types.ts:280](https://github.com/tangle-network/agent-runti
 
 > **agentRunName**: `string`
 
-Defined in: [runtime/types.ts:281](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L281)
+Defined in: [runtime/types.ts:282](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L282)
 
 **`Experimental`**
 
@@ -11771,7 +11773,7 @@ Defined in: [runtime/types.ts:281](https://github.com/tangle-network/agent-runti
 
 ### LoopResult
 
-Defined in: [runtime/types.ts:285](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L285)
+Defined in: [runtime/types.ts:286](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L286)
 
 **`Experimental`**
 
@@ -11795,7 +11797,7 @@ Defined in: [runtime/types.ts:285](https://github.com/tangle-network/agent-runti
 
 > **decision**: `Decision`
 
-Defined in: [runtime/types.ts:286](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L286)
+Defined in: [runtime/types.ts:287](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L287)
 
 **`Experimental`**
 
@@ -11803,7 +11805,7 @@ Defined in: [runtime/types.ts:286](https://github.com/tangle-network/agent-runti
 
 > **iterations**: [`Iteration`](#iteration-1)\<`Task`, `Output`\>[]
 
-Defined in: [runtime/types.ts:287](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L287)
+Defined in: [runtime/types.ts:288](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L288)
 
 **`Experimental`**
 
@@ -11811,7 +11813,7 @@ Defined in: [runtime/types.ts:287](https://github.com/tangle-network/agent-runti
 
 > `optional` **winner?**: [`LoopWinner`](#loopwinner)\<`Task`, `Output`\>
 
-Defined in: [runtime/types.ts:288](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L288)
+Defined in: [runtime/types.ts:289](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L289)
 
 **`Experimental`**
 
@@ -11819,7 +11821,7 @@ Defined in: [runtime/types.ts:288](https://github.com/tangle-network/agent-runti
 
 > **durationMs**: `number`
 
-Defined in: [runtime/types.ts:289](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L289)
+Defined in: [runtime/types.ts:290](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L290)
 
 **`Experimental`**
 
@@ -11827,7 +11829,7 @@ Defined in: [runtime/types.ts:289](https://github.com/tangle-network/agent-runti
 
 > **costUsd**: `number`
 
-Defined in: [runtime/types.ts:291](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L291)
+Defined in: [runtime/types.ts:292](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L292)
 
 **`Experimental`**
 
@@ -11837,7 +11839,7 @@ Sum of every iteration's `costUsd`.
 
 > **tokenUsage**: [`LoopTokenUsage`](#looptokenusage)
 
-Defined in: [runtime/types.ts:295](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L295)
+Defined in: [runtime/types.ts:296](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L296)
 
 **`Experimental`**
 
@@ -11849,7 +11851,7 @@ Sum of every iteration's token usage. Forward to
 
 > **provenance**: [`RunProvenance`](#runprovenance)
 
-Defined in: [runtime/types.ts:299](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L299)
+Defined in: [runtime/types.ts:300](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L300)
 
 **`Experimental`**
 
@@ -11861,7 +11863,7 @@ Domain-free run provenance for auditability: the mount manifest recorded
 
 ### SandboxClient
 
-Defined in: [runtime/types.ts:315](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L315)
+Defined in: [runtime/types.ts:316](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L316)
 
 **`Experimental`**
 
@@ -11881,7 +11883,7 @@ the kernel falls back to `{ placement: 'sibling', sandboxId: box.id }`.
 
 > **create**(`options?`): `Promise`\<`SandboxInstance`\>
 
-Defined in: [runtime/types.ts:316](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L316)
+Defined in: [runtime/types.ts:317](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L317)
 
 **`Experimental`**
 
@@ -11899,7 +11901,7 @@ Defined in: [runtime/types.ts:316](https://github.com/tangle-network/agent-runti
 
 > `optional` **describePlacement**(`box`): [`LoopSandboxPlacement`](#loopsandboxplacement)
 
-Defined in: [runtime/types.ts:317](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L317)
+Defined in: [runtime/types.ts:318](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L318)
 
 **`Experimental`**
 
@@ -11917,7 +11919,7 @@ Defined in: [runtime/types.ts:317](https://github.com/tangle-network/agent-runti
 
 > `optional` **criuStatus**(): `Promise`\<\{ `available`: `boolean`; `criuVersion?`: `string`; `reason?`: `string`; \}\>
 
-Defined in: [runtime/types.ts:328](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L328)
+Defined in: [runtime/types.ts:329](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L329)
 
 **`Experimental`**
 
@@ -11937,7 +11939,7 @@ The raw `Sandbox` SDK class satisfies it; the loop's test fakes omit it
 
 ### LoopLineageOptions
 
-Defined in: [runtime/types.ts:352](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L352)
+Defined in: [runtime/types.ts:353](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L353)
 
 **`Experimental`**
 
@@ -11965,7 +11967,7 @@ are copy-on-write, but each is still a live box until loop end).
 
 > `optional` **sessionContinuity?**: `boolean`
 
-Defined in: [runtime/types.ts:367](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L367)
+Defined in: [runtime/types.ts:368](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L368)
 
 **`Experimental`**
 
@@ -11986,7 +11988,7 @@ proves the session EXISTS server-side, not that prior turns replay into it.
 
 > `optional` **forkFanout?**: `boolean`
 
-Defined in: [runtime/types.ts:382](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L382)
+Defined in: [runtime/types.ts:383](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L383)
 
 **`Experimental`**
 
@@ -12007,7 +12009,7 @@ different-per-branch profiles use the unforked fanout path.
 
 > `optional` **streaming?**: `"sse"` \| `"poll"`
 
-Defined in: [runtime/types.ts:394](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L394)
+Defined in: [runtime/types.ts:395](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L395)
 
 **`Experimental`**
 
@@ -12025,7 +12027,7 @@ idle-drop. Applies to the default fresh-box path too, not only when
 
 ### LoopSandboxPlacement
 
-Defined in: [runtime/types.ts:398](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L398)
+Defined in: [runtime/types.ts:399](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L399)
 
 **`Experimental`**
 
@@ -12039,7 +12041,7 @@ Defined in: [runtime/types.ts:398](https://github.com/tangle-network/agent-runti
 
 > **kind**: `"sibling"` \| `"fleet"`
 
-Defined in: [runtime/types.ts:399](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L399)
+Defined in: [runtime/types.ts:400](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L400)
 
 **`Experimental`**
 
@@ -12047,7 +12049,7 @@ Defined in: [runtime/types.ts:399](https://github.com/tangle-network/agent-runti
 
 > `optional` **sandboxId?**: `string`
 
-Defined in: [runtime/types.ts:400](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L400)
+Defined in: [runtime/types.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L401)
 
 **`Experimental`**
 
@@ -12055,7 +12057,7 @@ Defined in: [runtime/types.ts:400](https://github.com/tangle-network/agent-runti
 
 > `optional` **fleetId?**: `string`
 
-Defined in: [runtime/types.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L401)
+Defined in: [runtime/types.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L402)
 
 **`Experimental`**
 
@@ -12063,7 +12065,7 @@ Defined in: [runtime/types.ts:401](https://github.com/tangle-network/agent-runti
 
 > `optional` **machineId?**: `string`
 
-Defined in: [runtime/types.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L402)
+Defined in: [runtime/types.ts:403](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L403)
 
 **`Experimental`**
 
@@ -12071,7 +12073,7 @@ Defined in: [runtime/types.ts:402](https://github.com/tangle-network/agent-runti
 
 ### LoopTraceEmitter
 
-Defined in: [runtime/types.ts:406](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L406)
+Defined in: [runtime/types.ts:407](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L407)
 
 **`Experimental`**
 
@@ -12081,7 +12083,7 @@ Defined in: [runtime/types.ts:406](https://github.com/tangle-network/agent-runti
 
 > **emit**(`event`): `void` \| `Promise`\<`void`\>
 
-Defined in: [runtime/types.ts:407](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L407)
+Defined in: [runtime/types.ts:408](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L408)
 
 **`Experimental`**
 
@@ -12099,7 +12101,7 @@ Defined in: [runtime/types.ts:407](https://github.com/tangle-network/agent-runti
 
 ### LoopStartedPayload
 
-Defined in: [runtime/types.ts:442](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L442)
+Defined in: [runtime/types.ts:443](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L443)
 
 **`Experimental`**
 
@@ -12109,7 +12111,7 @@ Defined in: [runtime/types.ts:442](https://github.com/tangle-network/agent-runti
 
 > **driver**: `string`
 
-Defined in: [runtime/types.ts:443](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L443)
+Defined in: [runtime/types.ts:444](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L444)
 
 **`Experimental`**
 
@@ -12117,7 +12119,7 @@ Defined in: [runtime/types.ts:443](https://github.com/tangle-network/agent-runti
 
 > **agentRunNames**: `string`[]
 
-Defined in: [runtime/types.ts:444](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L444)
+Defined in: [runtime/types.ts:445](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L445)
 
 **`Experimental`**
 
@@ -12125,7 +12127,7 @@ Defined in: [runtime/types.ts:444](https://github.com/tangle-network/agent-runti
 
 > **maxIterations**: `number`
 
-Defined in: [runtime/types.ts:445](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L445)
+Defined in: [runtime/types.ts:446](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L446)
 
 **`Experimental`**
 
@@ -12133,7 +12135,7 @@ Defined in: [runtime/types.ts:445](https://github.com/tangle-network/agent-runti
 
 > **maxConcurrency**: `number`
 
-Defined in: [runtime/types.ts:446](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L446)
+Defined in: [runtime/types.ts:447](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L447)
 
 **`Experimental`**
 
@@ -12141,7 +12143,7 @@ Defined in: [runtime/types.ts:446](https://github.com/tangle-network/agent-runti
 
 ### LoopPlanPayload
 
-Defined in: [runtime/types.ts:457](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L457)
+Defined in: [runtime/types.ts:458](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L458)
 
 **`Experimental`**
 
@@ -12156,7 +12158,7 @@ provided, else inferred from `plannedCount` (0→stop, 1→refine, N→fanout).
 
 > **roundIndex**: `number`
 
-Defined in: [runtime/types.ts:459](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L459)
+Defined in: [runtime/types.ts:460](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L460)
 
 **`Experimental`**
 
@@ -12166,7 +12168,7 @@ Defined in: [runtime/types.ts:459](https://github.com/tangle-network/agent-runti
 
 > **plannedCount**: `number`
 
-Defined in: [runtime/types.ts:461](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L461)
+Defined in: [runtime/types.ts:462](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L462)
 
 **`Experimental`**
 
@@ -12176,7 +12178,7 @@ Tasks the driver issued this round.
 
 > **moveKind**: `string`
 
-Defined in: [runtime/types.ts:463](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L463)
+Defined in: [runtime/types.ts:464](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L464)
 
 **`Experimental`**
 
@@ -12186,7 +12188,7 @@ Topology move — `'refine' | 'fanout' | 'verify' | 'stop'` etc.
 
 > `optional` **rationale?**: `string`
 
-Defined in: [runtime/types.ts:465](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L465)
+Defined in: [runtime/types.ts:466](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L466)
 
 **`Experimental`**
 
@@ -12196,7 +12198,7 @@ Driver rationale for the move, when available.
 
 > `optional` **parentIndex?**: `number`
 
-Defined in: [runtime/types.ts:471](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L471)
+Defined in: [runtime/types.ts:472](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L472)
 
 **`Experimental`**
 
@@ -12208,7 +12210,7 @@ latest) iteration so far — unless a driver later declares it explicitly.
 
 > **childIndices**: `number`[]
 
-Defined in: [runtime/types.ts:473](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L473)
+Defined in: [runtime/types.ts:474](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L474)
 
 **`Experimental`**
 
@@ -12218,7 +12220,7 @@ Iteration indices this round dispatched (the edge targets).
 
 ### LoopIterationStartedPayload
 
-Defined in: [runtime/types.ts:477](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L477)
+Defined in: [runtime/types.ts:478](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L478)
 
 **`Experimental`**
 
@@ -12228,7 +12230,7 @@ Defined in: [runtime/types.ts:477](https://github.com/tangle-network/agent-runti
 
 > **iterationIndex**: `number`
 
-Defined in: [runtime/types.ts:478](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L478)
+Defined in: [runtime/types.ts:479](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L479)
 
 **`Experimental`**
 
@@ -12236,7 +12238,7 @@ Defined in: [runtime/types.ts:478](https://github.com/tangle-network/agent-runti
 
 > **agentRunName**: `string`
 
-Defined in: [runtime/types.ts:479](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L479)
+Defined in: [runtime/types.ts:480](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L480)
 
 **`Experimental`**
 
@@ -12244,7 +12246,7 @@ Defined in: [runtime/types.ts:479](https://github.com/tangle-network/agent-runti
 
 > **taskHash**: `string`
 
-Defined in: [runtime/types.ts:480](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L480)
+Defined in: [runtime/types.ts:481](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L481)
 
 **`Experimental`**
 
@@ -12252,7 +12254,7 @@ Defined in: [runtime/types.ts:480](https://github.com/tangle-network/agent-runti
 
 > `optional` **groupId?**: `number`
 
-Defined in: [runtime/types.ts:482](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L482)
+Defined in: [runtime/types.ts:483](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L483)
 
 **`Experimental`**
 
@@ -12262,7 +12264,7 @@ Plan round (== `LoopPlanPayload.roundIndex`) this iteration belongs to.
 
 > `optional` **parentIndex?**: `number`
 
-Defined in: [runtime/types.ts:484](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L484)
+Defined in: [runtime/types.ts:485](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L485)
 
 **`Experimental`**
 
@@ -12272,7 +12274,7 @@ Iteration this one was planned from; `undefined` ⇒ root.
 
 ### LoopIterationDispatchPayload
 
-Defined in: [runtime/types.ts:495](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L495)
+Defined in: [runtime/types.ts:496](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L496)
 
 **`Experimental`**
 
@@ -12287,7 +12289,7 @@ they write lands on it directly.
 
 > **iterationIndex**: `number`
 
-Defined in: [runtime/types.ts:496](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L496)
+Defined in: [runtime/types.ts:497](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L497)
 
 **`Experimental`**
 
@@ -12295,7 +12297,7 @@ Defined in: [runtime/types.ts:496](https://github.com/tangle-network/agent-runti
 
 > **agentRunName**: `string`
 
-Defined in: [runtime/types.ts:497](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L497)
+Defined in: [runtime/types.ts:498](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L498)
 
 **`Experimental`**
 
@@ -12303,7 +12305,7 @@ Defined in: [runtime/types.ts:497](https://github.com/tangle-network/agent-runti
 
 > **placement**: `"sibling"` \| `"fleet"`
 
-Defined in: [runtime/types.ts:498](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L498)
+Defined in: [runtime/types.ts:499](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L499)
 
 **`Experimental`**
 
@@ -12311,7 +12313,7 @@ Defined in: [runtime/types.ts:498](https://github.com/tangle-network/agent-runti
 
 > `optional` **sandboxId?**: `string`
 
-Defined in: [runtime/types.ts:500](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L500)
+Defined in: [runtime/types.ts:501](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L501)
 
 **`Experimental`**
 
@@ -12321,7 +12323,7 @@ Set on every placement. Lets analyst loops correlate per-iteration logs.
 
 > `optional` **fleetId?**: `string`
 
-Defined in: [runtime/types.ts:502](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L502)
+Defined in: [runtime/types.ts:503](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L503)
 
 **`Experimental`**
 
@@ -12331,7 +12333,7 @@ Set only when `placement === 'fleet'`.
 
 > `optional` **machineId?**: `string`
 
-Defined in: [runtime/types.ts:504](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L504)
+Defined in: [runtime/types.ts:505](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L505)
 
 **`Experimental`**
 
@@ -12341,7 +12343,7 @@ Set only when `placement === 'fleet'`.
 
 > `optional` **groupId?**: `number`
 
-Defined in: [runtime/types.ts:506](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L506)
+Defined in: [runtime/types.ts:507](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L507)
 
 **`Experimental`**
 
@@ -12351,7 +12353,7 @@ Plan round this iteration belongs to.
 
 > `optional` **parentIndex?**: `number`
 
-Defined in: [runtime/types.ts:508](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L508)
+Defined in: [runtime/types.ts:509](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L509)
 
 **`Experimental`**
 
@@ -12361,7 +12363,7 @@ Iteration this one was planned from; `undefined` ⇒ root.
 
 ### LoopIterationEndedPayload
 
-Defined in: [runtime/types.ts:512](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L512)
+Defined in: [runtime/types.ts:513](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L513)
 
 **`Experimental`**
 
@@ -12371,7 +12373,7 @@ Defined in: [runtime/types.ts:512](https://github.com/tangle-network/agent-runti
 
 > **iterationIndex**: `number`
 
-Defined in: [runtime/types.ts:513](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L513)
+Defined in: [runtime/types.ts:514](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L514)
 
 **`Experimental`**
 
@@ -12379,7 +12381,7 @@ Defined in: [runtime/types.ts:513](https://github.com/tangle-network/agent-runti
 
 > **agentRunName**: `string`
 
-Defined in: [runtime/types.ts:514](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L514)
+Defined in: [runtime/types.ts:515](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L515)
 
 **`Experimental`**
 
@@ -12387,7 +12389,7 @@ Defined in: [runtime/types.ts:514](https://github.com/tangle-network/agent-runti
 
 > `optional` **outputHash?**: `string`
 
-Defined in: [runtime/types.ts:515](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L515)
+Defined in: [runtime/types.ts:516](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L516)
 
 **`Experimental`**
 
@@ -12395,7 +12397,7 @@ Defined in: [runtime/types.ts:515](https://github.com/tangle-network/agent-runti
 
 > `optional` **verdict?**: `DefaultVerdict`
 
-Defined in: [runtime/types.ts:516](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L516)
+Defined in: [runtime/types.ts:517](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L517)
 
 **`Experimental`**
 
@@ -12403,7 +12405,7 @@ Defined in: [runtime/types.ts:516](https://github.com/tangle-network/agent-runti
 
 > `optional` **error?**: `string`
 
-Defined in: [runtime/types.ts:517](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L517)
+Defined in: [runtime/types.ts:518](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L518)
 
 **`Experimental`**
 
@@ -12411,7 +12413,7 @@ Defined in: [runtime/types.ts:517](https://github.com/tangle-network/agent-runti
 
 > **costUsd**: `number`
 
-Defined in: [runtime/types.ts:518](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L518)
+Defined in: [runtime/types.ts:519](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L519)
 
 **`Experimental`**
 
@@ -12419,7 +12421,7 @@ Defined in: [runtime/types.ts:518](https://github.com/tangle-network/agent-runti
 
 > **durationMs**: `number`
 
-Defined in: [runtime/types.ts:519](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L519)
+Defined in: [runtime/types.ts:520](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L520)
 
 **`Experimental`**
 
@@ -12427,7 +12429,7 @@ Defined in: [runtime/types.ts:519](https://github.com/tangle-network/agent-runti
 
 > `optional` **tokenUsage?**: [`LoopTokenUsage`](#looptokenusage)
 
-Defined in: [runtime/types.ts:522](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L522)
+Defined in: [runtime/types.ts:523](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L523)
 
 **`Experimental`**
 
@@ -12438,7 +12440,7 @@ Summed LLM token usage for this iteration — maps to gen_ai.usage.* on the
 
 > `optional` **groupId?**: `number`
 
-Defined in: [runtime/types.ts:524](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L524)
+Defined in: [runtime/types.ts:525](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L525)
 
 **`Experimental`**
 
@@ -12448,7 +12450,7 @@ Plan round this iteration belongs to.
 
 > `optional` **parentIndex?**: `number`
 
-Defined in: [runtime/types.ts:526](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L526)
+Defined in: [runtime/types.ts:527](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L527)
 
 **`Experimental`**
 
@@ -12458,7 +12460,7 @@ Iteration this one was planned from; `undefined` ⇒ root.
 
 > `optional` **outputPreview?**: `string`
 
-Defined in: [runtime/types.ts:529](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L529)
+Defined in: [runtime/types.ts:530](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L530)
 
 **`Experimental`**
 
@@ -12469,7 +12471,7 @@ Truncated string preview of the parsed output — for a viewer's drawer.
 
 ### LoopDecisionPayload
 
-Defined in: [runtime/types.ts:533](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L533)
+Defined in: [runtime/types.ts:534](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L534)
 
 **`Experimental`**
 
@@ -12479,7 +12481,7 @@ Defined in: [runtime/types.ts:533](https://github.com/tangle-network/agent-runti
 
 > **decision**: `string`
 
-Defined in: [runtime/types.ts:534](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L534)
+Defined in: [runtime/types.ts:535](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L535)
 
 **`Experimental`**
 
@@ -12487,7 +12489,7 @@ Defined in: [runtime/types.ts:534](https://github.com/tangle-network/agent-runti
 
 > **historyLength**: `number`
 
-Defined in: [runtime/types.ts:535](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L535)
+Defined in: [runtime/types.ts:536](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L536)
 
 **`Experimental`**
 
@@ -12495,7 +12497,7 @@ Defined in: [runtime/types.ts:535](https://github.com/tangle-network/agent-runti
 
 ### LoopEndedPayload
 
-Defined in: [runtime/types.ts:539](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L539)
+Defined in: [runtime/types.ts:540](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L540)
 
 **`Experimental`**
 
@@ -12505,7 +12507,7 @@ Defined in: [runtime/types.ts:539](https://github.com/tangle-network/agent-runti
 
 > `optional` **winnerIterationIndex?**: `number`
 
-Defined in: [runtime/types.ts:540](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L540)
+Defined in: [runtime/types.ts:541](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L541)
 
 **`Experimental`**
 
@@ -12513,7 +12515,7 @@ Defined in: [runtime/types.ts:540](https://github.com/tangle-network/agent-runti
 
 > **totalCostUsd**: `number`
 
-Defined in: [runtime/types.ts:541](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L541)
+Defined in: [runtime/types.ts:542](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L542)
 
 **`Experimental`**
 
@@ -12521,7 +12523,7 @@ Defined in: [runtime/types.ts:541](https://github.com/tangle-network/agent-runti
 
 > **durationMs**: `number`
 
-Defined in: [runtime/types.ts:542](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L542)
+Defined in: [runtime/types.ts:543](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L543)
 
 **`Experimental`**
 
@@ -12529,7 +12531,7 @@ Defined in: [runtime/types.ts:542](https://github.com/tangle-network/agent-runti
 
 > **iterations**: `number`
 
-Defined in: [runtime/types.ts:543](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L543)
+Defined in: [runtime/types.ts:544](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L544)
 
 **`Experimental`**
 
@@ -12537,7 +12539,7 @@ Defined in: [runtime/types.ts:543](https://github.com/tangle-network/agent-runti
 
 ### LoopTeardownFailedPayload
 
-Defined in: [runtime/types.ts:549](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L549)
+Defined in: [runtime/types.ts:550](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L550)
 
 **`Experimental`**
 
@@ -12551,7 +12553,7 @@ Emitted when a box's `delete()` throws or times out during teardown — the
 
 > `optional` **sandboxId?**: `string`
 
-Defined in: [runtime/types.ts:550](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L550)
+Defined in: [runtime/types.ts:551](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L551)
 
 **`Experimental`**
 
@@ -12559,7 +12561,7 @@ Defined in: [runtime/types.ts:550](https://github.com/tangle-network/agent-runti
 
 > **reason**: `string`
 
-Defined in: [runtime/types.ts:552](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L552)
+Defined in: [runtime/types.ts:553](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L553)
 
 **`Experimental`**
 
@@ -12569,17 +12571,19 @@ Defined in: [runtime/types.ts:552](https://github.com/tangle-network/agent-runti
 
 ### ExecCtx
 
-Defined in: [runtime/types.ts:556](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L556)
+Defined in: [runtime/types.ts:561](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L561)
 
 **`Experimental`**
 
+Execution context for `runLoop`: the sandbox client the kernel creates boxes through, plus optional runtime hooks.
+
 #### Properties
 
 ##### sandboxClient
 
 > **sandboxClient**: [`SandboxClient`](#sandboxclient-3)
 
-Defined in: [runtime/types.ts:558](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L558)
+Defined in: [runtime/types.ts:563](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L563)
 
 **`Experimental`**
 
@@ -12589,7 +12593,7 @@ Sandbox SDK client — the kernel calls `.create()` per iteration.
 
 > `optional` **hooks?**: [`RuntimeHooks`](index.md#runtimehooks)
 
-Defined in: [runtime/types.ts:560](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L560)
+Defined in: [runtime/types.ts:565](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L565)
 
 **`Experimental`**
 
@@ -12599,7 +12603,7 @@ Optional runtime hooks. Execution-scoped; never part of `AgentProfile`.
 
 > `optional` **traceEmitter?**: [`LoopTraceEmitter`](#looptraceemitter)
 
-Defined in: [runtime/types.ts:562](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L562)
+Defined in: [runtime/types.ts:567](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L567)
 
 **`Experimental`**
 
@@ -12609,7 +12613,7 @@ Optional trace emitter. When set, the kernel emits `loop.*` events.
 
 > `optional` **onSandboxEvent?**: (`event`, `meta`) => `void` \| `PromiseLike`\<`void`\>
 
-Defined in: [runtime/types.ts:580](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L580)
+Defined in: [runtime/types.ts:585](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L585)
 
 **`Experimental`**
 
@@ -12651,7 +12655,7 @@ on that.
 
 > `optional` **runHandle?**: [`RuntimeRunHandle`](index.md#runtimerunhandle)
 
-Defined in: [runtime/types.ts:589](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L589)
+Defined in: [runtime/types.ts:594](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L594)
 
 **`Experimental`**
 
@@ -12663,7 +12667,7 @@ the kernel infers from a sandbox event stream is forwarded via
 
 > `optional` **signal?**: `AbortSignal`
 
-Defined in: [runtime/types.ts:591](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L591)
+Defined in: [runtime/types.ts:596](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L596)
 
 **`Experimental`**
 
@@ -12673,7 +12677,7 @@ Cooperative cancellation signal.
 
 > `optional` **traceId?**: `string`
 
-Defined in: [runtime/types.ts:597](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L597)
+Defined in: [runtime/types.ts:602](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L602)
 
 **`Experimental`**
 
@@ -12685,7 +12689,7 @@ inherited from TRACE_ID env var in MCP subprocess mode.
 
 > `optional` **parentSpanId?**: `string`
 
-Defined in: [runtime/types.ts:602](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L602)
+Defined in: [runtime/types.ts:607](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L607)
 
 **`Experimental`**
 
@@ -13020,7 +13024,7 @@ Defined in: [runtime/workspace.ts:15](https://github.com/tangle-network/agent-ru
 
 ### GitWorkspaceOptions
 
-Defined in: [runtime/workspace.ts:39](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L39)
+Defined in: [runtime/workspace.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L40)
 
 #### Properties
 
@@ -13028,31 +13032,31 @@ Defined in: [runtime/workspace.ts:39](https://github.com/tangle-network/agent-ru
 
 > `readonly` **ref**: `string`
 
-Defined in: [runtime/workspace.ts:40](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L40)
+Defined in: [runtime/workspace.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L41)
 
 ##### shell?
 
 > `readonly` `optional` **shell?**: [`Shell`](#shell)
 
-Defined in: [runtime/workspace.ts:41](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L41)
+Defined in: [runtime/workspace.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L42)
 
 ##### branch?
 
 > `readonly` `optional` **branch?**: `string`
 
-Defined in: [runtime/workspace.ts:42](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L42)
+Defined in: [runtime/workspace.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L43)
 
 ##### noHooks?
 
 > `readonly` `optional` **noHooks?**: `boolean`
 
-Defined in: [runtime/workspace.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L43)
+Defined in: [runtime/workspace.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L44)
 
 ***
 
 ### WorkspaceRun
 
-Defined in: [runtime/workspace.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L135)
+Defined in: [runtime/workspace.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L137)
 
 #### Type Parameters
 
@@ -13066,19 +13070,19 @@ Defined in: [runtime/workspace.ts:135](https://github.com/tangle-network/agent-r
 
 > `readonly` **valid**: `boolean`
 
-Defined in: [runtime/workspace.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L136)
+Defined in: [runtime/workspace.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L138)
 
 ##### value
 
 > `readonly` **value**: `T`
 
-Defined in: [runtime/workspace.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L137)
+Defined in: [runtime/workspace.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L139)
 
 ##### commit?
 
 > `readonly` `optional` **commit?**: [`WorkspaceCommit`](#workspacecommit)
 
-Defined in: [runtime/workspace.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L139)
+Defined in: [runtime/workspace.ts:141](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L141)
 
 Present when a commit was attempted (valid, or `commitOnInvalid`).
 
@@ -13088,7 +13092,7 @@ Present when a commit was attempted (valid, or `commitOnInvalid`).
 
 > **CoordinationEvent** = \{ `type`: `"question"`; `question`: [`QuestionRecord`](mcp.md#questionrecord); \} \| \{ `type`: `"settled"`; `worker`: [`SettledWorker`](mcp.md#settledworker); \} \| \{ `type`: `"finding"`; `finding`: `AnalystFindingEvent`; \} \| \{ `type`: `"steer"`; `down`: `DownMessageEvent`; \} \| \{ `type`: `"answer"`; `down`: `DownMessageEvent`; `questionId`: `string`; \}
 
-Defined in: [mcp/tools/coordination.ts:85](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L85)
+Defined in: [mcp/tools/coordination.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L86)
 
 Every message on the one typed pipe. UP (child→parent): question / settled / finding — queued for
  the driver to `pull`. DOWN (parent→child): steer / answer — record-only (history + subscribers),
@@ -13100,7 +13104,7 @@ Every message on the one typed pipe. UP (child→parent): question / settled / f
 
 > **MakeWorkerAgent** = (`profile`) => [`Agent`](#agent)\<`unknown`, `unknown`\>
 
-Defined in: [mcp/tools/coordination.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L92)
+Defined in: [mcp/tools/coordination.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/mcp/tools/coordination.ts#L93)
 
 #### Parameters
 
@@ -13169,7 +13173,7 @@ runLoop options minus the `ctx` (loopDispatch builds the ctx).
 
 > **Outcome**\<`D`\> = \{ `kind`: `"done"`; `deliverable`: `D`; \} \| \{ `kind`: `"blocked"`; `blockers`: `string`[]; \}
 
-Defined in: [runtime/personify/types.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L54)
+Defined in: [runtime/personify/types.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L55)
 
 The terminal contract Drew wants: a loop returns a FINISHED deliverable, or the concrete
 list of blockers that stopped it — never a half-done best-effort coercion. A `blocked`
@@ -13191,7 +13195,7 @@ keystone's typed `SupervisedResult<Outcome<D>>` carries it end to end with no co
 
 > **DefinePersona** = \<`D`\>(`input`) => [`Persona`](#persona)\<`D`\>
 
-Defined in: [runtime/personify/types.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L143)
+Defined in: [runtime/personify/types.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L144)
 
 Builds a frozen `Persona`, failing loud on the executors-supplied invariant (neither a
  registry nor seams = an unresolvable persona). Pure — no I/O, no engine.
@@ -13218,7 +13222,7 @@ Builds a frozen `Persona`, failing loud on the executors-supplied invariant (nei
 
 > **LoopShape**\<`Task`, `D`\> = (`ctx`) => [`Agent`](#agent)\<`Task`, [`Outcome`](#outcome-1)\<`D`\>\>
 
-Defined in: [runtime/personify/types.ts:192](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L192)
+Defined in: [runtime/personify/types.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L193)
 
 A reusable act-body factory. Given the persona's content + seams (`ShapeContext`), it
 returns the root `Agent<Task, Outcome<D>>` whose `act` decomposes the task, fans out
@@ -13252,7 +13256,7 @@ synthesizes the terminal `Outcome<D>`. The shape is STRUCTURE; the persona is CO
 
 > **RunPersonified** = \<`Task`, `D`\>(`options`) => `Promise`\<[`SupervisedResult`](#supervisedresult)\<[`Outcome`](#outcome-1)\<`D`\>\>\>
 
-Defined in: [runtime/personify/types.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L255)
+Defined in: [runtime/personify/types.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/types.ts#L256)
 
 The composed run signature.
 
@@ -13282,7 +13286,7 @@ The composed run signature.
 
 > **CombinatorShape**\<`Task`, `D`\> = [`LoopShape`](#loopshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L64)
+Defined in: [runtime/personify/wave-types.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L65)
 
 A combinator is just a `LoopShape`: a factory `(ShapeContext) => Agent` whose `Agent.act`
 runs the combinator's structure over the `Scope` (spawn children, drain `next()`, select via
@@ -13307,7 +13311,7 @@ the persona carries the domain.
 
 > **Pipeline** = \<`Task`, `D`\>(`stages`) => [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L89)
+Defined in: [runtime/personify/wave-types.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L90)
 
 `pipeline(stages)` — build the sequential combinator from an ordered stage list. The first
  stage's `StepIn` is the root `Task`; the last stage's `StepOut` is the deliverable `D`.
@@ -13338,7 +13342,7 @@ Defined in: [runtime/personify/wave-types.ts:89](https://github.com/tangle-netwo
 
 > **FanoutWinnerSelector**\<`D`\> = (`iterations`) => \{ `output?`: [`Outcome`](#outcome-1)\<`D`\>; \} \| `undefined`
 
-Defined in: [runtime/personify/wave-types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L138)
+Defined in: [runtime/personify/wave-types.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L139)
 
 A winner-selection strategy: argmax/sort over the gathered child iterations (each output is the
  child's `Outcome<D>`), returning the chosen iteration or `undefined` when none qualifies.
@@ -13365,7 +13369,7 @@ A winner-selection strategy: argmax/sort over the gathered child iterations (eac
 
 > **WinnerStrategy** = `"highest-score"` \| `"smallest-artifact"` \| `"first-valid"`
 
-Defined in: [runtime/personify/wave-types.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L144)
+Defined in: [runtime/personify/wave-types.ts:145](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L145)
 
 Built-in valid-only winner strategies for `selectValidWinner` (selector≠judge): best gated-valid
  score, the smallest delivered artifact (via a `sizeOf` extractor), or the earliest valid.
@@ -13376,7 +13380,7 @@ Built-in valid-only winner strategies for `selectValidWinner` (selector≠judge)
 
 > **Fanout** = \<`Task`, `Item`, `D`\>(`items`, `opts`) => [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:155](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L155)
+Defined in: [runtime/personify/wave-types.ts:156](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L156)
 
 `fanout(items, opts)` — build the fanout combinator over a static item list.
 
@@ -13414,7 +13418,7 @@ Defined in: [runtime/personify/wave-types.ts:155](https://github.com/tangle-netw
 
 > **LoopUntil** = \<`Task`, `State`, `D`\>(`seed`, `spec`) => [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:193](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L193)
+Defined in: [runtime/personify/wave-types.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L194)
 
 `loopUntil(spec)` — build the iterative-deepening combinator. `seed` is the initial state.
 
@@ -13452,7 +13456,7 @@ Defined in: [runtime/personify/wave-types.ts:193](https://github.com/tangle-netw
 
 > **Panel** = \<`Task`, `Artifact`, `D`\>(`spec`) => [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:243](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L243)
+Defined in: [runtime/personify/wave-types.ts:244](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L244)
 
 `panel(spec)` — build the M-judge write-only-merge combinator.
 
@@ -13486,7 +13490,7 @@ Defined in: [runtime/personify/wave-types.ts:243](https://github.com/tangle-netw
 
 > **Verify** = \<`Task`, `Candidate`, `D`\>(`spec`) => [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:269](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L269)
+Defined in: [runtime/personify/wave-types.ts:270](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L270)
 
 `verify(spec)` — build the 2-node implement→verifier-gate combinator.
 
@@ -13520,7 +13524,7 @@ Defined in: [runtime/personify/wave-types.ts:269](https://github.com/tangle-netw
 
 > **WidenDecision**\<`D`\> = \{ `kind`: `"widen"`; `toward`: [`WidenLineage`](#widenlineage)\<`D`\>; \} \| \{ `kind`: `"stop"`; `rationale?`: `string`; \}
 
-Defined in: [runtime/personify/wave-types.ts:323](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L323)
+Defined in: [runtime/personify/wave-types.ts:324](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L324)
 
 A widening decision: extend one lineage by one child, or stop widening. `flatWidenGate`
  always returns `{ kind: 'stop' }`.
@@ -13537,7 +13541,7 @@ A widening decision: extend one lineage by one child, or stop widening. `flatWid
 
 > **Widen** = \<`Task`, `Seed`, `D`\>(`spec`) => [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/wave-types.ts:335](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L335)
+Defined in: [runtime/personify/wave-types.ts:336](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L336)
 
 `widen(spec)` — build the streaming progressive-widening combinator.
 
@@ -13571,7 +13575,7 @@ Defined in: [runtime/personify/wave-types.ts:335](https://github.com/tangle-netw
 
 > **FlatWidenGate** = \<`D`\>() => [`ScopeWidenGate`](#scopewidengate)\<`D`\>
 
-Defined in: [runtime/personify/wave-types.ts:340](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L340)
+Defined in: [runtime/personify/wave-types.ts:341](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L341)
 
 The flat default `ScopeWidenGate` factory contract — never widens, keeping the R2 firewall
  conflict dormant. Exported so a gate run can pass it explicitly and a test can assert the
@@ -13593,7 +13597,7 @@ The flat default `ScopeWidenGate` factory contract — never widens, keeping the
 
 > **AssertTraceDerivedFindings** = (`findings`) => `void`
 
-Defined in: [runtime/personify/wave-types.ts:401](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L401)
+Defined in: [runtime/personify/wave-types.ts:402](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L402)
 
 The firewall assertion contract, re-stated for the reactive seam (PORT of
 `assertTraceDerivedFindings`). A PROVENANCE check, not a content check: span/event/artifact/
@@ -13617,7 +13621,7 @@ judge/verdict/score scheme is rejected. Fail loud — a tainted finding aborts.
 
 > **RenderCorpusToInstructions** = (`opts`) => `Promise`\<`AgentProfile`\>
 
-Defined in: [runtime/personify/wave-types.ts:492](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L492)
+Defined in: [runtime/personify/wave-types.ts:493](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L493)
 
 `renderCorpusToInstructions(opts)` — the flywheel read-back projection. Async (queries the
  durable corpus); returns a fresh `AgentProfile` with the accreted facts merged in.
@@ -13638,7 +13642,7 @@ Defined in: [runtime/personify/wave-types.ts:492](https://github.com/tangle-netw
 
 > **TrajectoryReportFn** = (`journal`, `blobs`, `root`, `options?`) => `Promise`\<[`TrajectoryReport`](#trajectoryreport-3)\>
 
-Defined in: [runtime/personify/wave-types.ts:551](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L551)
+Defined in: [runtime/personify/wave-types.ts:552](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L552)
 
 `trajectoryReport(...)` — the tree+cost reconstructor. Async (reads journal + optionally blobs).
 
@@ -13670,7 +13674,7 @@ Defined in: [runtime/personify/wave-types.ts:551](https://github.com/tangle-netw
 
 > **EqualKOnCost** = (`arms`, `options?`) => [`EqualKVerdict`](#equalkverdict)
 
-Defined in: [runtime/personify/wave-types.ts:606](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L606)
+Defined in: [runtime/personify/wave-types.ts:607](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/wave-types.ts#L607)
 
 `equalKOnCost(arms, opts)` — the cross-arm equal-compute check on conserved cost.
 
@@ -13705,7 +13709,7 @@ A checkable task domain — implement these 5 hooks and the suite does the rest.
 
 > **Deliverable**\<`Out`\> = \{ `kind`: `"events"`; `fromEvents`: (`events`) => `Out`; \} \| \{ `kind`: `"artifact"`; `path`: `string`; `fromArtifact`: (`raw`, `events`) => `Out`; \}
 
-Defined in: [runtime/sandbox-run.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L50)
+Defined in: [runtime/sandbox-run.ts:51](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L51)
 
 **`Experimental`**
 
@@ -13727,7 +13731,7 @@ How a typed deliverable `Out` is materialized from a finished turn.
 
 > **SteeringDecision** = `"refine"` \| `"pick-winner"` \| `"fail"`
 
-Defined in: [runtime/steering-drivers.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L54)
+Defined in: [runtime/steering-drivers.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L55)
 
 Terminal-or-continue decision shared by all three steering drivers. The
 non-terminal `'refine'` keeps the loop running another shot; the terminal
@@ -13741,7 +13745,7 @@ for another round). Identical to the reference refine driver's decision set.
 
 > **ApplyContinuation**\<`Task`\> = (`task`, `continuation`) => `Task`
 
-Defined in: [runtime/steering-drivers.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L63)
+Defined in: [runtime/steering-drivers.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L64)
 
 Fold a steering string into the caller's Task shape, producing the Task for
 the next shot. The substrate never assumes how a Task carries its prompt, so
@@ -13783,7 +13787,7 @@ Defined in: [runtime/strategy-evolution.ts:55](https://github.com/tangle-network
 
 > **BudgetReadout** = `Readonly`\<\{ `tokensLeft`: `number`; `usdLeft`: `number`; `usdCapped`: `boolean`; `deadlineMs`: `number`; `reservedTokens`: `number`; \}\>
 
-Defined in: [runtime/supervise/budget.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L43)
+Defined in: [runtime/supervise/budget.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L44)
 
 Post-reservation pool readout — the shape `Scope.budget` exposes. `tokensLeft`,
  `usdLeft`, and `reservedTokens` reflect committed-but-unsettled reservations;
@@ -13797,7 +13801,7 @@ Post-reservation pool readout — the shape `Scope.budget` exposes. `tokensLeft`
 
 > **ExecutorConfig** = `object` & `RouterSeam` \| `object` & `RouterToolsSeam` \| `object` & `BridgeSeam` \| `object` & `CliSeam` \| `object` & `CliWorktreeSeam` \| `object` & [`ProviderSeam`](#providerseam) \| `object` & `SandboxSeam`
 
-Defined in: [runtime/supervise/runtime.ts:1500](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1500)
+Defined in: [runtime/supervise/runtime.ts:1501](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1501)
 
 Config for [createExecutor](#createexecutor): the backend is DATA — the cost dial a profile,
 an experiment config, or a replay journal can name — not an import choice. Each
@@ -13846,7 +13850,7 @@ How to run a sandboxed harness as the DRIVER, with the coordination verbs mounte
 
 > **UsageEvent** = \{ `kind`: `"tokens"`; `input`: `number`; `output`: `number`; \} \| \{ `kind`: `"cost"`; `usd`: `number`; \} \| \{ `kind`: `"iteration"`; \}
 
-Defined in: [runtime/supervise/types.ts:130](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L130)
+Defined in: [runtime/supervise/types.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L131)
 
 Normalized usage event — the single channel every executor reports through, so the
 conserved pool meters all runtimes identically. `tokens` carries `LoopTokenUsage`'s
@@ -13858,7 +13862,7 @@ conserved pool meters all runtimes identically. `tokens` carries `LoopTokenUsage
 
 > **Runtime** = `"router"` \| `"inline"` \| `"sandbox"` \| `"cli"` \| `string` & `object`
 
-Defined in: [runtime/supervise/types.ts:137](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L137)
+Defined in: [runtime/supervise/types.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L138)
 
 The runtime tag of a `Executor` impl. Open by intent: custom runtimes use their own string name.
 External executors can register additional runtime strings without widening this type.
@@ -13869,7 +13873,7 @@ External executors can register additional runtime strings without widening this
 
 > **ExecutorFactory**\<`Out`\> = (`spec`, `ctx`) => [`Executor`](#executor)\<`Out`\>
 
-Defined in: [runtime/supervise/types.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L165)
+Defined in: [runtime/supervise/types.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L166)
 
 Builds a fresh `Executor` for one spawn from the resolved spec. Per-spawn (not
 shared) so each child owns its own box/abort/teardown lifecycle. A BYO factory lets a
@@ -13901,7 +13905,7 @@ user supply construction args without pre-instantiating.
 
 > **Settled**\<`Out`\> = \{ `kind`: `"done"`; `handle`: `Handle`\<`Out`\>; `out`: `Out`; `outRef`: `string`; `verdict?`: `DefaultVerdict`; `spent`: [`Spend`](#spend); `seq`: `number`; \} \| \{ `kind`: `"down"`; `handle`: `Handle`\<`Out`\>; `reason`: `string`; `infra`: `boolean`; `restartCount`: `number`; `seq`: `number`; \}
 
-Defined in: [runtime/supervise/types.ts:255](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L255)
+Defined in: [runtime/supervise/types.ts:256](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L256)
 
 A settled child, delivered by `scope.next()`. `seq` is the monotonic cursor order
 `next()` yielded this settlement (B2) — NOT wall-clock — and replay delivers strictly
@@ -13957,7 +13961,7 @@ True = infrastructure failure (excluded from merge `n` / equal-k), not a bad res
 
 > **SupervisedResult**\<`Out`\> = \{ `kind`: `"winner"`; `out`: `Out`; `outRef`: `string`; `verdict?`: `DefaultVerdict`; `tree`: [`TreeView`](#treeview); `spentTotal`: [`Spend`](#spend); `spentBreakdown?`: \{ `driverInference`: [`Spend`](#spend); `childWork`: [`Spend`](#spend); \}; \} \| \{ `kind`: `"no-winner"`; `reason`: `"all-children-down"` \| `"budget-exhausted"` \| `"aborted"`; `tree`: [`TreeView`](#treeview); `downCount`: `number`; `spentTotal`: [`Spend`](#spend); \}
 
-Defined in: [runtime/supervise/types.ts:466](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L466)
+Defined in: [runtime/supervise/types.ts:467](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/types.ts#L467)
 
 Typed terminal result (M2) — a no-winner is NEVER coerced to a best-effort output.
 
@@ -14049,7 +14053,7 @@ The conserved spend incurred before the run failed — real cost is paid even wh
 
 > **WorktreePatchArtifact** = `WorktreeHarnessResult`
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L43)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L44)
 
 Terminal artifact of one worktree-CLI run — the canonical worktree-harness result (the captured
  diff + the harness's run record + the derived checks).
@@ -14102,7 +14106,7 @@ Public supervisor-facing compaction config: same knobs as the primitive, but `di
 
 > **MountRecorder** = (`entry`) => `void`
 
-Defined in: [runtime/types.ts:197](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L197)
+Defined in: [runtime/types.ts:198](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L198)
 
 **`Experimental`**
 
@@ -14126,7 +14130,7 @@ declares what it mounted without the kernel having to inspect box contents.
 
 > **LoopTraceEvent** = \{ `kind`: `"loop.started"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopStartedPayload`](#loopstartedpayload); \} \| \{ `kind`: `"loop.plan"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopPlanPayload`](#loopplanpayload); \} \| \{ `kind`: `"loop.iteration.started"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopIterationStartedPayload`](#loopiterationstartedpayload); \} \| \{ `kind`: `"loop.iteration.dispatch"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopIterationDispatchPayload`](#loopiterationdispatchpayload); \} \| \{ `kind`: `"loop.iteration.ended"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopIterationEndedPayload`](#loopiterationendedpayload); \} \| \{ `kind`: `"loop.decision"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopDecisionPayload`](#loopdecisionpayload); \} \| \{ `kind`: `"loop.ended"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopEndedPayload`](#loopendedpayload); \} \| \{ `kind`: `"loop.teardown.failed"`; `runId`: `string`; `timestamp`: `number`; `payload`: [`LoopTeardownFailedPayload`](#loopteardownfailedpayload); \}
 
-Defined in: [runtime/types.ts:411](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L411)
+Defined in: [runtime/types.ts:412](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/types.ts#L412)
 
 **`Experimental`**
 
@@ -14186,7 +14190,7 @@ The default observer instruction — exported so an optimizer can seed its popul
 
 > `const` **assertTraceDerivedFindings**: [`AssertTraceDerivedFindings`](#asserttracederivedfindings-1)
 
-Defined in: [runtime/personify/analyst.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L46)
+Defined in: [runtime/personify/analyst.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L47)
 
 ***
 
@@ -14194,7 +14198,7 @@ Defined in: [runtime/personify/analyst.ts:46](https://github.com/tangle-network/
 
 > `const` **builtinShapes**: [`ShapeRegistry`](#shaperegistry)
 
-Defined in: [runtime/personify/registry.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/registry.ts#L49)
+Defined in: [runtime/personify/registry.ts:50](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/registry.ts#L50)
 
 The default registry `runPersonified` resolves a shape name against. Empty by construction —
  a caller registers its own composed shapes; the engine ships no domain shape.
@@ -14215,7 +14219,9 @@ The compressed consumable a skill carries: everything an author needs to emit a
 
 > `const` **sample**: [`Strategy`](#strategy-3)
 
-Defined in: [runtime/strategy.ts:711](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L711)
+Defined in: [runtime/strategy.ts:712](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L712)
+
+Built-in `Strategy`: K independent attempts, keep the best-verifying (best-of-N / resample).
 
 ***
 
@@ -14223,7 +14229,9 @@ Defined in: [runtime/strategy.ts:711](https://github.com/tangle-network/agent-ru
 
 > `const` **refine**: [`Strategy`](#strategy-3)
 
-Defined in: [runtime/strategy.ts:715](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L715)
+Defined in: [runtime/strategy.ts:717](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L717)
+
+Built-in `Strategy`: attempt → `observe()` reads the trace → steer the next attempt → repeat (deepen one lineage).
 
 ***
 
@@ -14231,7 +14239,7 @@ Defined in: [runtime/strategy.ts:715](https://github.com/tangle-network/agent-ru
 
 > `const` **adaptiveRefine**: [`Strategy`](#strategy-3)
 
-Defined in: [runtime/strategy.ts:915](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L915)
+Defined in: [runtime/strategy.ts:917](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L917)
 
 A NEW strategy, authored from the steps (~20 lines): refine, but when a steered shot
  fails to improve the score it ABANDONS that line and restarts fresh (branch-when-stuck)
@@ -14245,7 +14253,7 @@ A NEW strategy, authored from the steps (~20 lines): refine, but when a steered
 
 > `const` **sampleThenRefine**: [`Strategy`](#strategy-3)
 
-Defined in: [runtime/strategy.ts:958](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L958)
+Defined in: [runtime/strategy.ts:960](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L960)
 
 The explore-then-exploit MIX: spend ⌈budget/2⌉ on independent samples (kept open),
  then refine the best-verifying line with the remaining budget. Sample's basin escape +
@@ -14257,7 +14265,7 @@ The explore-then-exploit MIX: spend ⌈budget/2⌉ on independent samples (kept
 
 > `const` **defaultProfileRichnessThresholds**: [`ProfileRichnessThresholds`](#profilerichnessthresholds)
 
-Defined in: [runtime/supervise/authoring.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L138)
+Defined in: [runtime/supervise/authoring.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L139)
 
 ***
 
@@ -14265,7 +14273,7 @@ Defined in: [runtime/supervise/authoring.ts:138](https://github.com/tangle-netwo
 
 > `const` **defaultDelegateBudget**: [`Budget`](#budget-12)
 
-Defined in: [runtime/supervise/delegate.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L34)
+Defined in: [runtime/supervise/delegate.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L35)
 
 The conserved pool a `delegate()` call applies when the caller does not pass its own `budget`.
  A modest token ceiling + a small iteration ceiling — generous enough for a few-worker decompose,
@@ -14277,7 +14285,7 @@ The conserved pool a `delegate()` call applies when the caller does not pass its
 
 > `const` **cliWorktreeExecutor**: [`ExecutorFactory`](#executorfactory)\<`unknown`\>
 
-Defined in: [runtime/supervise/runtime.ts:1464](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1464)
+Defined in: [runtime/supervise/runtime.ts:1465](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1465)
 
 The leaf `createWorktreeCliExecutor` as a backend-as-data factory: a supervisor-authored
 `AgentProfile` driving claude / codex / opencode on its own worktree. `budgetExempt` like
@@ -14289,7 +14297,7 @@ the other CLI leaves; the authored systemPrompt + model reach the harness via §
 
 > **contentAddress**(`artifact`): `string`
 
-Defined in: [durable/spawn-journal.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L48)
+Defined in: [durable/spawn-journal.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/durable/spawn-journal.ts#L49)
 
 Mint the content-addressed `outRef` for a result artifact: `sha256:<hex>` over a
 stable JSON encoding. Producers call this to derive the `outRef` they journal and
@@ -14368,7 +14376,9 @@ One row per (strategy, satisficing target): the shareable time-to-satisfactory t
 
 > **auditIntent**(`input`, `opts`): `Promise`\<[`IntentAudit`](#intentaudit)\>
 
-Defined in: [runtime/audit-intent.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/audit-intent.ts#L108)
+Defined in: [runtime/audit-intent.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/audit-intent.ts#L109)
+
+The route-rigor analyst: compare declared vs revealed vs user intent over a trajectory and return aligned / drifting / diverged with evidence and one recommended intervention.
 
 #### Parameters
 
@@ -14529,7 +14539,9 @@ Render a self-contained HTML leaderboard page (the hosted surface): the SVG char
 
 > **completionAuthorizes**(`v`, `policy?`): `boolean`
 
-Defined in: [runtime/completion.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L62)
+Defined in: [runtime/completion.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L64)
+
+Decide whether a `CompletionVerdict` may end the node under the policy: authority scales with the verdict's determinism, and probabilistic verdicts must clear `minConfidence`.
 
 #### Parameters
 
@@ -14551,7 +14563,7 @@ Defined in: [runtime/completion.ts:62](https://github.com/tangle-network/agent-r
 
 > **stopSentinel**(`seed`): `string`
 
-Defined in: [runtime/completion.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L73)
+Defined in: [runtime/completion.ts:75](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L75)
 
 A unique, attributable stop sentinel for a node (ralph-loop style). Deterministic from the
 seed (no Math.random — reproducible + attributable to the node); the agent is instructed to
@@ -14573,7 +14585,7 @@ emit it VERBATIM when it judges itself done. Unguessable enough that content nev
 
 > **sentinelCompletion**\<`Task`\>(`sentinel`, `opts?`): [`CompletionAnalyst`](#completionanalyst)\<`Task`, `string`\>
 
-Defined in: [runtime/completion.ts:86](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L86)
+Defined in: [runtime/completion.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L88)
 
 Completion for a sandbox-agent node: done iff the latest output carries the node's stop
 sentinel. PROBABILISTIC (the agent's own self-judgment) — the driver validates it.
@@ -14606,7 +14618,7 @@ sentinel. PROBABILISTIC (the agent's own self-judgment) — the driver validates
 
 > **deterministicCompletion**\<`Task`, `Output`\>(`check`): [`CompletionAnalyst`](#completionanalyst)\<`Task`, `Output`\>
 
-Defined in: [runtime/completion.ts:111](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L111)
+Defined in: [runtime/completion.ts:113](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/completion.ts#L113)
 
 Completion for a DETERMINISTIC check (build/test/lint/citation/proof): done iff the check
 passes. Ground truth — the driver ends directly, no validation. The check reads the output
@@ -14638,7 +14650,9 @@ passes. Ground truth — the driver ends directly, no validation. The check read
 
 > **harvestCorpus**(`opts`): `Promise`\<[`HarvestReport`](#harvestreport)\>
 
-Defined in: [runtime/harvest-corpus.ts:62](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/harvest-corpus.ts#L62)
+Defined in: [runtime/harvest-corpus.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/harvest-corpus.ts#L63)
+
+Batch the firewalled `observe()` analyst over completed runs and accrete the trace-derived facts into the durable corpus — the production-traces→corpus write side of the flywheel.
 
 #### Parameters
 
@@ -14791,7 +14805,9 @@ reports usage automatically.
 
 > **createMcpEnvironment**(`opts`): [`AgenticSurface`](#agenticsurface)
 
-Defined in: [runtime/mcp-environment.ts:94](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/mcp-environment.ts#L94)
+Defined in: [runtime/mcp-environment.ts:95](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/mcp-environment.ts#L95)
+
+Wrap any MCP server as an `Environment`: `tools/list` becomes `AgenticTool[]` with provider-safe schemas; the domain supplies only the artifact lifecycle hooks.
 
 #### Parameters
 
@@ -14809,7 +14825,9 @@ Defined in: [runtime/mcp-environment.ts:94](https://github.com/tangle-network/ag
 
 > **observe**(`input`, `opts`): `Promise`\<[`Observation`](#observation)\>
 
-Defined in: [runtime/observe.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/observe.ts#L139)
+Defined in: [runtime/observe.ts:140](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/observe.ts#L140)
+
+The third-person trace analyst: read a worker's trace and produce steer findings for the next attempt plus durable `learned` facts for the cross-run corpus.
 
 #### Parameters
 
@@ -14831,7 +14849,7 @@ Defined in: [runtime/observe.ts:139](https://github.com/tangle-network/agent-run
 
 > **renderReport**(`findings`): `string`
 
-Defined in: [runtime/observe.ts:226](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/observe.ts#L226)
+Defined in: [runtime/observe.ts:227](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/observe.ts#L227)
 
 Operator-facing report, split by who should act. The agent block is the
  steer; the operator block is the advice.
@@ -14852,7 +14870,7 @@ readonly `AnalystFinding`[]
 
 > **createScopeAnalyst**\<`D`\>(`scope`, `options`): [`ScopeAnalyst`](#scopeanalyst)\<`D`\>
 
-Defined in: [runtime/personify/analyst.ts:96](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L96)
+Defined in: [runtime/personify/analyst.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L97)
 
 Build a `ScopeAnalyst` that spawns the analyst agent through `Scope.spawn` (so its compute is
 metered by the conserved pool), drains its single settlement, and enforces the trace-derived
@@ -14892,7 +14910,7 @@ Fail loud (no silent empty findings):
 
 > **registryScopeAnalyst**\<`D`\>(`registry`, `buildInputs`): [`ScopeAnalyst`](#scopeanalyst)\<`D`\>
 
-Defined in: [runtime/personify/analyst.ts:202](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L202)
+Defined in: [runtime/personify/analyst.ts:203](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L203)
 
 A `ScopeAnalyst` backed by an `AnalystRegistry` — the panel-of-analysts seam. The registry merges
 N analyst KINDS into one `AnalystRunResult.findings`; `analyze` runs it over the caller-projected
@@ -14931,7 +14949,7 @@ over with a fabricated input here.
 
 > **buildSteerContext**\<`D`\>(`findings`, `settledSoFar`): [`SteerContext`](#steercontext)\<`D`\>
 
-Defined in: [runtime/personify/analyst.ts:230](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L230)
+Defined in: [runtime/personify/analyst.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/analyst.ts#L231)
 
 Build the `SteerContext` a combinator reads to steer (its `loopUntil.until`, `widen` gate, any
 future steer). One place enforces the firewall: `findings` is asserted trace-derived before it is
@@ -14969,7 +14987,7 @@ readonly [`Settled`](#settled-2)\<[`Outcome`](#outcome-1)\<`D`\>\>[]
 
 > **selectValidWinner**\<`D`\>(`opts?`): [`FanoutWinnerSelector`](#fanoutwinnerselector)\<`D`\>
 
-Defined in: [runtime/personify/combinators.ts:58](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L58)
+Defined in: [runtime/personify/combinators.ts:59](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L59)
 
 The single content-free valid-only winner selector. Among the gated-VALID children only
 (`verdict.valid === true`), pick by `strategy` — best score / smallest delivered artifact /
@@ -15007,7 +15025,7 @@ the selection logic previously copied per role.
 
 > **pipeline**\<`Task`, `D`\>(`stages`): [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/combinators.ts:100](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L100)
+Defined in: [runtime/personify/combinators.ts:101](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L101)
 
 `pipeline(stages)` — run the stages in order, feeding each stage's `done` deliverable into the
 next stage's task. The first stage that ends `blocked` (a child that went down, a child the
@@ -15041,7 +15059,7 @@ readonly [`PipelineStage`](#pipelinestage)\<`Task`, `unknown`, `unknown`\>[]
 
 > **fanout**\<`Task`, `Item`, `D`\>(`items`, `opts`): [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/combinators.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L138)
+Defined in: [runtime/personify/combinators.ts:139](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L139)
 
 `fanout(items, opts)` — spawn one child per item in a single round (bounded by the conserved
 pool's fail-closed admission), drain via `scope.next()`, then either synthesize over the
@@ -15083,7 +15101,7 @@ readonly `Item`[]
 
 > **loopUntil**\<`Task`, `State`, `D`\>(`seed`, `spec`): [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/combinators.ts:221](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L221)
+Defined in: [runtime/personify/combinators.ts:222](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L222)
 
 `loopUntil(seed, spec)` — one `step` child per round; `fold` accumulates each settlement into
 the running state; `until` (reading the round's trace findings, NOT a fresh raw verdict) is
@@ -15129,7 +15147,7 @@ argument is the empty array — never a fabricated finding (fail-loud honesty ov
 
 > **panel**\<`Task`, `Artifact`, `D`\>(`spec`): [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/combinators.ts:273](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L273)
+Defined in: [runtime/personify/combinators.ts:274](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L274)
 
 `panel(spec)` — spawn the M judge children over the SAME artifact, drain their settlements,
 and fold them into a panel verdict via the pure WRITE-ONLY `merge` (a judge's output never
@@ -15167,7 +15185,7 @@ concrete blocker before `merge` is consulted.
 
 > **verify**\<`Task`, `Candidate`, `D`\>(`spec`): [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/combinators.ts:333](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L333)
+Defined in: [runtime/personify/combinators.ts:334](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L334)
 
 `verify(spec)` — an IMPLEMENT child produces a candidate, then a SEPARATE VERIFIER child grades
 it; only a `valid` verifier verdict ships. Any other outcome (implement down, verifier down,
@@ -15204,7 +15222,7 @@ never a coerced "done". The implement child does not grade itself.
 
 > **widen**\<`Task`, `Seed`, `D`\>(`spec`): [`CombinatorShape`](#combinatorshape)\<`Task`, `D`\>
 
-Defined in: [runtime/personify/combinators.ts:387](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L387)
+Defined in: [runtime/personify/combinators.ts:388](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L388)
 
 `widen(spec)` — the streaming spawn-on-completion driver. Spawns the seed lineages, then REACTS
 to each `scope.next()`: on every settled child it consults `spec.gate.decide` and, when the gate
@@ -15252,7 +15270,7 @@ a scope whose siblings are quiesced, or read findings without the shared-cursor
 
 > **flatWidenGate**\<`D`\>(): [`ScopeWidenGate`](#scopewidengate)\<`D`\>
 
-Defined in: [runtime/personify/combinators.ts:450](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L450)
+Defined in: [runtime/personify/combinators.ts:451](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/combinators.ts#L451)
 
 The flat default `ScopeWidenGate` — never widens, keeping the R2 selector≠judge collision
 dormant. A gate run passes this explicitly; a test asserts the default is flat.
@@ -15273,7 +15291,7 @@ dormant. A gate run passes this explicitly; a test asserts the default is flat.
 
 > **renderCorpusToInstructions**(`opts`): `Promise`\<`AgentProfile`\>
 
-Defined in: [runtime/personify/corpus.ts:301](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L301)
+Defined in: [runtime/personify/corpus.ts:302](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/corpus.ts#L302)
 
 The learning-flywheel READ side. Queries the corpus through `filter`, renders the matching facts
 (most-confident first, capped by `maxLines`) into instruction lines, and returns a FRESH
@@ -15302,7 +15320,7 @@ An empty query result returns a fresh COPY of the profile with no instruction ch
 
 > **definePersona**\<`D`\>(`input`): [`Persona`](#persona)\<`D`\>
 
-Defined in: [runtime/personify/persona.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/persona.ts#L56)
+Defined in: [runtime/personify/persona.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/persona.ts#L57)
 
 Build a frozen `Persona`. Fails loud on the executors-supplied invariant: a persona with
 neither a pre-built registry nor a seam bag cannot resolve its built-in runtimes, so it is
@@ -15330,7 +15348,7 @@ unrunnable — refuse it at definition time, not at the first spawn. Pure; no I/
 
 > **runPersonified**\<`Task`, `D`\>(`options`): `Promise`\<[`SupervisedResult`](#supervisedresult)\<[`Outcome`](#outcome-1)\<`D`\>\>\>
 
-Defined in: [runtime/personify/persona.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/persona.ts#L131)
+Defined in: [runtime/personify/persona.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/persona.ts#L132)
 
 Compose the persona + chosen shape onto a fresh keystone `Supervisor`. Resolves the shape
 (a factory verbatim, or a registered name through `builtinShapes`), applies it to a
@@ -15364,7 +15382,7 @@ default-shape fallback.
 
 > **createShapeRegistry**(): [`ShapeRegistry`](#shaperegistry)
 
-Defined in: [runtime/personify/registry.ts:25](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/registry.ts#L25)
+Defined in: [runtime/personify/registry.ts:26](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/registry.ts#L26)
 
 Build a fresh open `ShapeRegistry`. A factory is stored type-erased and re-cast on resolve — the
 caller asserts the `<Task, D>` it expects, exactly as the executor registry stores its factories.
@@ -15379,7 +15397,7 @@ caller asserts the `<Task, D>` it expects, exactly as the executor registry stor
 
 > **registerShape**\<`Task`, `D`\>(`name`, `factory`): `void`
 
-Defined in: [runtime/personify/registry.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/registry.ts#L53)
+Defined in: [runtime/personify/registry.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/registry.ts#L54)
 
 Register a composed shape on the default `builtinShapes` registry — the one-call extension
  point a caller invokes so its shape is resolvable by name with zero edits to the engine.
@@ -15414,7 +15432,7 @@ Register a composed shape on the default `builtinShapes` registry — the one-ca
 
 > **trajectoryReport**(`journal`, `blobs`, `root`, `options?`): `Promise`\<[`TrajectoryReport`](#trajectoryreport-3)\>
 
-Defined in: [runtime/personify/trajectory.ts:52](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/trajectory.ts#L52)
+Defined in: [runtime/personify/trajectory.ts:53](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/trajectory.ts#L53)
 
 Reconstruct the whole spawn tree for `root` with per-node + rolled-up `Spend`. Reads the
 journal for structure + spend and, when `withOutputs`, the blob store for each `done`
@@ -15450,7 +15468,7 @@ store cannot rehydrate (a silent gap would mis-cost or mis-evidence the tree).
 
 > **equalKOnCost**(`arms`, `options?`): [`EqualKVerdict`](#equalkverdict)
 
-Defined in: [runtime/personify/trajectory.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/trajectory.ts#L143)
+Defined in: [runtime/personify/trajectory.ts:144](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/personify/trajectory.ts#L144)
 
 Assert the arms are comparable at EQUAL conserved COST (tokens + usd), NOT raw iteration
 count. Compares each arm's root-rolled-up `total` on the two conserved channels: an arm is
@@ -15478,7 +15496,9 @@ readonly [`EqualKArm`](#equalkarm)[]
 
 > **promotionGate**(`opts`): [`PromotionVerdict`](#promotionverdict)
 
-Defined in: [runtime/promotion-gate.ts:63](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/promotion-gate.ts#L63)
+Defined in: [runtime/promotion-gate.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/promotion-gate.ts#L64)
+
+Statistical promotion decision over a holdout benchmark: a seeded paired bootstrap (`heldoutSignificance`) whose CI lower bound must clear `deltaThreshold`.
 
 #### Parameters
 
@@ -15562,7 +15582,9 @@ that `resolveBenchClient` builds on — reuse this instead of hand-rolling the
 
 > **routerChatWithUsage**(`cfg`, `messages`, `opts?`): `Promise`\<[`RouterChatResult`](#routerchatresult)\>
 
-Defined in: [runtime/router-client.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L48)
+Defined in: [runtime/router-client.ts:49](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L49)
+
+One OpenAI-compatible chat completion through the Tangle router, returning text + REAL token usage (`undefined` when the provider omits it — never a fabricated 0).
 
 #### Parameters
 
@@ -15609,7 +15631,7 @@ the reasoning/content split in `parseChatResult`.
 
 > **routerChatWithTools**(`cfg`, `messages`, `tools`, `opts?`): `Promise`\<[`RouterChatToolsResult`](#routerchattoolsresult)\>
 
-Defined in: [runtime/router-client.ts:186](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L186)
+Defined in: [runtime/router-client.ts:187](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L187)
 
 A router completion WITH tool-calling — the operator driver's LLM seam. Passes OpenAI-shape
 `messages` (system/user/assistant-with-tool_calls/tool roles) + function `tools`, and returns the
@@ -15658,7 +15680,7 @@ readonly `object`[]
 
 > **routerToolLoop**(`cfg`, `system`, `user`, `tools`, `execute`, `opts?`): `Promise`\<[`RouterToolLoopResult`](#routertoolloopresult)\>
 
-Defined in: [runtime/router-client.ts:284](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L284)
+Defined in: [runtime/router-client.ts:285](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L285)
 
 The tool-using router backend: a real agentic loop OVER the Tangle router (which
 supports tool-calling), off-box — no sandbox. Each turn is one router completion
@@ -15727,7 +15749,7 @@ Seed the loop with an existing conversation (depth continuation) instead of
 
 > **routerBrain**(`cfg`, `opts?`): [`ToolLoopChat`](#toolloopchat)
 
-Defined in: [runtime/router-client.ts:326](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L326)
+Defined in: [runtime/router-client.ts:327](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/router-client.ts#L327)
 
 The router as a supervisor BRAIN: the canonical `ToolLoopChat` seam backed by the router's
 tool-calling. The driver's spawn/observe/steer/await/stop turns become real router tool-calls.
@@ -15756,7 +15778,7 @@ The turnkey production brain — tests script a mock `ToolLoopChat`; production
 
 > **runBenchmark**(`cfg`): `Promise`\<[`BenchmarkReport`](#benchmarkreport)\>
 
-Defined in: [runtime/run-benchmark.ts:132](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L132)
+Defined in: [runtime/run-benchmark.ts:133](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L133)
 
 Run the requested strategies over the tasks, scored by the Environment's own check.
  Resilient: a task whose rollouts fail (transient infra) is excluded from the stats but
@@ -15778,7 +15800,7 @@ Run the requested strategies over the tasks, scored by the Environment's own che
 
 > **printBenchmarkReport**(`report`): `void`
 
-Defined in: [runtime/run-benchmark.ts:231](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L231)
+Defined in: [runtime/run-benchmark.ts:232](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-benchmark.ts#L232)
 
 Pretty-print a report — the "free optimization" verdict, with the cost vector.
 
@@ -15798,10 +15820,12 @@ Pretty-print a report — the "free optimization" verdict, with the cost vector.
 
 > **runLoop**\<`Task`, `Output`, `Decision`\>(`options`): `Promise`\<[`LoopResult`](#loopresult)\<`Task`, `Output`, `Decision`\>\>
 
-Defined in: [runtime/run-loop.ts:138](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-loop.ts#L138)
+Defined in: [runtime/run-loop.ts:143](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-loop.ts#L143)
 
 **`Experimental`**
 
+The round-synchronous loop kernel: each round `driver.plan()` fans N tasks to sandboxes (bounded concurrency), parses + validates each output, and folds results through `driver.decide`.
+
 #### Type Parameters
 
 ##### Task
@@ -15832,7 +15856,7 @@ Defined in: [runtime/run-loop.ts:138](https://github.com/tangle-network/agent-ru
 
 > **defaultSelectWinner**\<`Task`, `Output`\>(`iterations`): [`LoopWinner`](#loopwinner)\<`Task`, `Output`\> \| `undefined`
 
-Defined in: [runtime/run-loop.ts:1126](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-loop.ts#L1126)
+Defined in: [runtime/run-loop.ts:1131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/run-loop.ts#L1131)
 
 The kernel's winner argmax — best-valid-score, ties broken by earliest index,
 falling back to the best-scoring non-errored output when none is valid. Exported
@@ -15866,10 +15890,12 @@ a forked copy).
 
 > **acquireSandbox**(`client`, `options`, `acquire?`): `Promise`\<`SandboxInstance`\>
 
-Defined in: [runtime/sandbox-acquire.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-acquire.ts#L68)
+Defined in: [runtime/sandbox-acquire.ts:73](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-acquire.ts#L73)
 
 **`Experimental`**
 
+Cold-start-resilient sandbox acquisition: create by name, observe readiness from the sandbox's own status (not the create call), and re-attach after gateway timeouts.
+
 #### Parameters
 
 ##### client
@@ -15894,7 +15920,7 @@ Defined in: [runtime/sandbox-acquire.ts:68](https://github.com/tangle-network/ag
 
 > **probeSandboxCapabilities**(`client`): `Promise`\<[`SandboxCapabilities`](#sandboxcapabilities)\>
 
-Defined in: [runtime/sandbox-capabilities.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L45)
+Defined in: [runtime/sandbox-capabilities.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-capabilities.ts#L46)
 
 **`Experimental`**
 
@@ -16040,7 +16066,7 @@ The opencode backend emits incremental text as
 
 > **createSandboxLineage**(`client`, `capabilities`, `options?`): [`SandboxLineage`](#sandboxlineage)
 
-Defined in: [runtime/sandbox-lineage.ts:189](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L189)
+Defined in: [runtime/sandbox-lineage.ts:190](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-lineage.ts#L190)
 
 **`Experimental`**
 
@@ -16086,7 +16112,7 @@ Run provenance recorder forwarded to every `prepareBox` the lineage runs
 
 > **openSandboxRun**\<`Out`\>(`client`, `options`, `deliverable`): `Promise`\<[`SandboxRun`](#sandboxrun)\<`Out`\>\>
 
-Defined in: [runtime/sandbox-run.ts:127](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L127)
+Defined in: [runtime/sandbox-run.ts:131](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/sandbox-run.ts#L131)
 
 **`Experimental`**
 
@@ -16124,7 +16150,7 @@ kimi-code all flow through this one entrypoint with identical env/auth wiring.
 
 > **naiveDriver**\<`Task`, `Output`\>(`options`): [`Driver`](#driver-1)\<`Task`, `Output`, [`SteeringDecision`](#steeringdecision)\>
 
-Defined in: [runtime/steering-drivers.ts:108](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L108)
+Defined in: [runtime/steering-drivers.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L109)
 
 `naiveDriver` — the no-signal steering control.
 
@@ -16162,7 +16188,7 @@ attributable to the grader's findings.
 
 > **dumbDriver**\<`Task`, `Output`\>(`options`): [`Driver`](#driver-1)\<`Task`, `Output`, [`SteeringDecision`](#steeringdecision)\>
 
-Defined in: [runtime/steering-drivers.ts:167](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L167)
+Defined in: [runtime/steering-drivers.ts:168](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/steering-drivers.ts#L168)
 
 `dumbDriver` — the pass/fail-only steering control.
 
@@ -16346,7 +16372,9 @@ Search-side champion selection over a tournament report.
 
 > **runStrategyEvolution**(`cfg`): `Promise`\<[`EvolutionReport`](#evolutionreport)\>
 
-Defined in: [runtime/strategy-evolution.ts:364](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy-evolution.ts#L364)
+Defined in: [runtime/strategy-evolution.ts:365](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy-evolution.ts#L365)
+
+Multi-generation strategy search: author candidates from tournament losses, play them against the incumbent at equal budget, promote via `promotionGate` on an untouched holdout slice.
 
 #### Parameters
 
@@ -16432,7 +16460,7 @@ BREADTH: K independent rollouts (each own artifact), verifier picks the best.
 
 > **defineStrategy**(`name`, `run`): [`Strategy`](#strategy-3)
 
-Defined in: [runtime/strategy.ts:789](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L789)
+Defined in: [runtime/strategy.ts:791](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L791)
 
 Author a Strategy from the composable steps — the open, compact way.
 
@@ -16456,7 +16484,7 @@ Author a Strategy from the composable steps — the open, compact way.
 
 > **runAgentic**(`opts`): `Promise`\<[`AgenticRunResult`](#agenticrunresult)\>
 
-Defined in: [runtime/strategy.ts:1030](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1030)
+Defined in: [runtime/strategy.ts:1032](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/strategy.ts#L1032)
 
 Run a Strategy through the keystone Supervisor — `Agent.act` over a conserved-budget Scope.
 
@@ -16522,7 +16550,7 @@ Drive a team of agents (spawned + steered by `profile`) to solve a graded `Agent
 
 > **asAuthoredProfile**(`raw`): [`AuthoredProfile`](#authoredprofile) \| `null`
 
-Defined in: [runtime/supervise/authoring.ts:34](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L34)
+Defined in: [runtime/supervise/authoring.ts:35](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L35)
 
 Narrow an untyped `spawn_agent` profile argument to an `AuthoredProfile`, or null if the
  supervisor failed to author one (empty/placeholder profile — a skill violation worth catching).
@@ -16543,7 +16571,7 @@ Narrow an untyped `spawn_agent` profile argument to an `AuthoredProfile`, or nul
 
 > **supervisorInstructions**(`opts?`): `string`
 
-Defined in: [runtime/supervise/authoring.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L46)
+Defined in: [runtime/supervise/authoring.ts:47](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L47)
 
 The supervisor SKILL — the how-to the supervisor reads (its system prompt). THE optimizable
  surface: editing this changes how the supervisor designs every agent it spawns.
@@ -16566,7 +16594,7 @@ The supervisor SKILL — the how-to the supervisor reads (its system prompt). TH
 
 > **authoredWorker**(`profile`, `opts`): [`Agent`](#agent)\<`unknown`, `unknown`\>
 
-Defined in: [runtime/supervise/authoring.ts:66](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L66)
+Defined in: [runtime/supervise/authoring.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L67)
 
 Build a worker AGENT from a profile the supervisor authored: the authored `systemPrompt` +
  `model` shape the worker's one model call; the deliverable gates settlement (valid ⟺ delivered).
@@ -16605,7 +16633,7 @@ Build a worker AGENT from a profile the supervisor authored: the authored `syste
 
 > **assessAuthoredProfile**(`profile`, `opts?`): [`ProfileRichness`](#profilerichness)
 
-Defined in: [runtime/supervise/authoring.ts:180](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L180)
+Defined in: [runtime/supervise/authoring.ts:181](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L181)
 
 OBSERVE one authored `AgentProfile` and score its richness (no judge verdict is read). The task
  context (`needsMcp`) lets a domain say "this work needs a data/tool MCP" so a missing MCP counts.
@@ -16636,7 +16664,7 @@ OBSERVE one authored `AgentProfile` and score its richness (no judge verdict is
 
 > **profileRichnessFinding**(`richness`, `opts?`): `AnalystFinding`
 
-Defined in: [runtime/supervise/authoring.ts:243](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L243)
+Defined in: [runtime/supervise/authoring.ts:244](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/authoring.ts#L244)
 
 Turn a [ProfileRichness](#profilerichness) verdict into a bus-routable `AnalystFinding` (area `profile-quality`).
  Severity scales with thinness; the recommended action names the MISSING lever so the supervisor can
@@ -16668,7 +16696,7 @@ Turn a [ProfileRichness](#profilerichness) verdict into a bus-routable `AnalystF
 
 > **spendFromUsageEvents**(`events`): [`Spend`](#spend)
 
-Defined in: [runtime/supervise/budget.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L92)
+Defined in: [runtime/supervise/budget.ts:93](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L93)
 
 Fold a normalized `UsageEvent` array into a `Spend`. Tokens and usd are separate
  channels; iterations come from `'iteration'` events. Pure; `ms` stays zero (the
@@ -16690,7 +16718,7 @@ Fold a normalized `UsageEvent` array into a `Spend`. Tokens and usd are separate
 
 > **createBudgetPool**(`root`, `now?`): [`BudgetPool`](#budgetpool)
 
-Defined in: [runtime/supervise/budget.ts:135](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L135)
+Defined in: [runtime/supervise/budget.ts:136](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/budget.ts#L136)
 
 Create a conserved reservation pool from a root `Budget`. `now()` is injected so the
 deadline readout is deterministic; defaults to `Date.now` for non-test callers. The
@@ -16717,7 +16745,7 @@ readout's `deadlineMs` is a stable wall-clock instant, not a shrinking remainder
 
 > **gateOnDeliverable**\<`Out`\>(`inner`, `deliverable`): [`Executor`](#executor)\<`Out`\>
 
-Defined in: [runtime/supervise/completion-gate.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L44)
+Defined in: [runtime/supervise/completion-gate.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/completion-gate.ts#L45)
 
 Wrap an `Executor` so its settlement `valid` reflects the deliverable check, not the
 inner verdict. Handles both `execute` shapes (one-shot `Promise<ExecutorResult>` and
@@ -16750,7 +16778,7 @@ executor has produced its output. The inner `score` is preserved; only `valid` i
 
 > **driverAgent**(`opts`): [`Agent`](#agent)\<`unknown`, `unknown`\>
 
-Defined in: [runtime/supervise/coordination-driver.ts:165](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L165)
+Defined in: [runtime/supervise/coordination-driver.ts:166](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L166)
 
 Build the intelligent recursive driver. Its `act` is the LLM tool-loop; spawn it as a
 `driverChild` (`driver-executor.ts`) to run it inside a nested scope, recursively.
@@ -16771,7 +16799,7 @@ Build the intelligent recursive driver. Its `act` is the LLM tool-loop; spawn it
 
 > **finalizeBestDelivered**(`settled`, `blobs`): `Promise`\<`unknown`\>
 
-Defined in: [runtime/supervise/coordination-driver.ts:377](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L377)
+Defined in: [runtime/supervise/coordination-driver.ts:378](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-driver.ts#L378)
 
 Keep-best finalize under the completion-oracle: return the highest-scoring DELIVERED child's
  output (settled `done` AND `valid` — its deliverable check passed). Returns undefined when no
@@ -16800,7 +16828,7 @@ readonly `object`[]
 
 > **serveCoordinationMcp**(`opts`): `Promise`\<[`CoordinationMcpHandle`](#coordinationmcphandle)\>
 
-Defined in: [runtime/supervise/coordination-mcp.ts:54](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L54)
+Defined in: [runtime/supervise/coordination-mcp.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/coordination-mcp.ts#L55)
 
 Stand up the coordination MCP over a live scope. The HOST address is `127.0.0.1` (the bridge runs
  opencode locally, same host); pass `host` to bind elsewhere when the harness is remote.
@@ -16872,7 +16900,7 @@ Pass-through subscriber for every bus event (settled / question / finding).
 
 > **delegate**\<`Out`\>(`intent`, `opts?`): `Promise`\<[`SupervisedResult`](#supervisedresult)\<`Out`\>\>
 
-Defined in: [runtime/supervise/delegate.ts:88](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L88)
+Defined in: [runtime/supervise/delegate.ts:89](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/delegate.ts#L89)
 
 Delegate an INTENT to a default authoring supervisor and return its `SupervisedResult` unchanged.
 
@@ -16906,7 +16934,7 @@ authored worker's delivered output; a `no-winner` result names why (never a fabr
 
 > **defaultToolDetectors**(): `StreamingDetector`[]
 
-Defined in: [runtime/supervise/detector-monitor.ts:37](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L37)
+Defined in: [runtime/supervise/detector-monitor.ts:38](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L38)
 
 The default online panel for a tool-call pipe: a worker repeating the same call, or hammering
  consecutive errors. (No-progress needs a domain progress-probe, so it is opt-in, not default.)
@@ -16927,7 +16955,7 @@ The default online panel for a tool-call pipe: a worker repeating the same call,
 
 > **watchTrace**(`source`, `opts?`): () => `void`
 
-Defined in: [runtime/supervise/detector-monitor.ts:43](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L43)
+Defined in: [runtime/supervise/detector-monitor.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/detector-monitor.ts#L44)
 
 Subscribe to a `TraceSource` and run the streaming detectors over its live spans. Returns an
  unsubscribe. A defensive `argHash` failure (circular args) never throws out of the side-channel.
@@ -16952,7 +16980,9 @@ Subscribe to a `TraceSource` and run the streaming detectors over its live spans
 
 > **createEventBus**\<`E`\>(`now?`): [`EventBus`](#eventbus)\<`E`\>
 
-Defined in: [runtime/supervise/event-bus.ts:74](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L74)
+Defined in: [runtime/supervise/event-bus.ts:76](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/event-bus.ts#L76)
+
+Create the child→parent coordination bus: one typed pipe for settled outputs, questions, and analyst findings, with a priority-ordered pull queue and a pass-through subscribe lane.
 
 #### Type Parameters
 
@@ -16976,7 +17006,9 @@ Defined in: [runtime/supervise/event-bus.ts:74](https://github.com/tangle-networ
 
 > **createInbox**(): [`Inbox`](#inbox)
 
-Defined in: [runtime/supervise/inbox.ts:55](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L55)
+Defined in: [runtime/supervise/inbox.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/inbox.ts#L57)
+
+Create the worker-side inbox for the down-leg: the driver's `steer_agent` / `answer_question` messages queue here and the worker's loop drains them at step boundaries and before settle.
 
 #### Returns
 
@@ -17014,7 +17046,7 @@ readonly `string`[] \| `undefined`
 
 > **patchDelivered**(`options?`): [`DeliverableSpec`](#deliverablespec)\<`WorktreeHarnessResult`\>
 
-Defined in: [runtime/supervise/patch-deliverable.ts:44](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L44)
+Defined in: [runtime/supervise/patch-deliverable.ts:45](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/patch-deliverable.ts#L45)
 
 **`Experimental`**
 
@@ -17038,7 +17070,7 @@ whether the patch is DELIVERED (the `valid` conjunction).
 
 > **createInMemoryRunContext**(`opts?`): [`InMemoryRunContext`](#inmemoryruncontext)
 
-Defined in: [runtime/supervise/run-context.ts:56](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L56)
+Defined in: [runtime/supervise/run-context.ts:57](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/run-context.ts#L57)
 
 Build a fresh in-memory run context. Every call returns NEW stores (no shared global
 state between runs), so two runs never cross-contaminate their journals/blobs.
@@ -17059,7 +17091,7 @@ state between runs), so two runs never cross-contaminate their journals/blobs.
 
 > **createExecutor**(`config`): [`ExecutorFactory`](#executorfactory)\<`unknown`\>
 
-Defined in: [runtime/supervise/runtime.ts:1517](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1517)
+Defined in: [runtime/supervise/runtime.ts:1518](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1518)
 
 The single built-in executor factory. Picks a leaf backend by data (`config.backend`),
 injects the matching seam, and delegates to that backend's built-in implementation.
@@ -17084,7 +17116,7 @@ per-vendor adapter or a closed `inline|sandbox|cli` switch — those bypass the
 
 > **createExecutorRegistry**(): [`ExecutorRegistry`](#executorregistry)
 
-Defined in: [runtime/supervise/runtime.ts:1563](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1563)
+Defined in: [runtime/supervise/runtime.ts:1564](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/runtime.ts#L1564)
 
 The open resolver/registry. Pre-registers the three built-ins under their
 runtime tags (`'router'`, `'sandbox'`, `'cli'`) and accepts `register(name,
@@ -17106,7 +17138,9 @@ harness-derived runtime (`'sandbox'` for any `BackendType`); else fail loud.
 
 > **createScope**\<`Out`\>(`args`): [`Scope`](#scope-1)\<`Out`\>
 
-Defined in: [runtime/supervise/scope.ts:192](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/scope.ts#L192)
+Defined in: [runtime/supervise/scope.ts:194](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/scope.ts#L194)
+
+Create the reactive `Scope` a driver's `Agent.act` runs inside: spawn children on an atomically reserved conserved budget, settle via the `next()` cursor, journal for replay.
 
 #### Type Parameters
 
@@ -17130,7 +17164,7 @@ Defined in: [runtime/supervise/scope.ts:192](https://github.com/tangle-network/a
 
 > **settledToIteration**\<`Out`\>(`settled`): [`Iteration`](#iteration-1)\<`unknown`, `Out`\>
 
-Defined in: [runtime/supervise/scope.ts:677](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/scope.ts#L677)
+Defined in: [runtime/supervise/scope.ts:679](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/scope.ts#L679)
 
 The step-8 merge-boundary adapter (M4): rehydrate a `Settled.done` into the kernel's
 `Iteration` shape so `defaultSelectWinner` stays single-sourced — the supervisor selects
@@ -17190,7 +17224,9 @@ Build the worker seam from a backend (WHERE workers run) + an optional completio
 
 > **supervise**(`profile`, `task`, `opts`): `Promise`\<[`SupervisedResult`](#supervisedresult)\<`unknown`\>\>
 
-Defined in: [runtime/supervise/supervise.ts:116](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/supervise.ts#L116)
+Defined in: [runtime/supervise/supervise.ts:117](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/supervise.ts#L117)
+
+One-call supervisor: build + run a supervisor from its profile with sensible defaults; the raw `supervisorAgent` + `createSupervisor().run` seams stay available for power use.
 
 #### Parameters
 
@@ -17216,7 +17252,9 @@ Defined in: [runtime/supervise/supervise.ts:116](https://github.com/tangle-netwo
 
 > **supervisorAgent**(`profile`, `deps`): [`Agent`](#agent)\<`unknown`, `unknown`\>
 
-Defined in: [runtime/supervise/supervisor-agent.ts:109](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/supervisor-agent.ts#L109)
+Defined in: [runtime/supervise/supervisor-agent.ts:110](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/supervisor-agent.ts#L110)
+
+Build a supervisor `Agent` from its profile: the brain resolves from `profile.harness` (backend-as-data), the same resolution rule as every worker.
 
 #### Parameters
 
@@ -17238,7 +17276,7 @@ Defined in: [runtime/supervise/supervisor-agent.ts:109](https://github.com/tangl
 
 > **createSupervisor**\<`Task`, `Out`\>(): [`Supervisor`](#supervisor-1)\<`Task`, `Out`\>
 
-Defined in: [runtime/supervise/supervisor.ts:64](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/supervisor.ts#L64)
+Defined in: [runtime/supervise/supervisor.ts:65](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/supervisor.ts#L65)
 
 #### Type Parameters
 
@@ -17260,7 +17298,7 @@ Defined in: [runtime/supervise/supervisor.ts:64](https://github.com/tangle-netwo
 
 > **decodeToolPart**(`part`, `harness?`): `ToolStepInput` \| `undefined`
 
-Defined in: [runtime/supervise/trace-source.ts:146](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L146)
+Defined in: [runtime/supervise/trace-source.ts:147](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L147)
 
 Decode a part with a specific harness's adapter when known, else try every registered adapter
  (the composite — robust to mixed/unknown streams). Never throws.
@@ -17285,7 +17323,7 @@ Decode a part with a specific harness's adapter when known, else try every regis
 
 > **createPushTraceSource**(`opts?`): `object`
 
-Defined in: [runtime/supervise/trace-source.ts:171](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L171)
+Defined in: [runtime/supervise/trace-source.ts:172](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L172)
 
 A push source for OWNED tool loops (router-tools / cli-bridge tool dispatch): the loop calls
  `record(step)` for each tool call; it becomes a span, fan-out to live subscribers + buffered for
@@ -17331,7 +17369,7 @@ A push source for OWNED tool loops (router-tools / cli-bridge tool dispatch): th
 
 > **sandboxSessionTraceSource**(`box`, `sessionId`, `opts?`): [`TraceSource`](#tracesource)
 
-Defined in: [runtime/supervise/trace-source.ts:286](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L286)
+Defined in: [runtime/supervise/trace-source.ts:287](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trace-source.ts#L287)
 
 The SANDBOX / fleet trace source: read a box session's message parts and decode the harness's tool
  calls into spans. `collect` (settle) is the solid path — `box.messages({sessionId})` → parts → spans;
@@ -17378,7 +17416,7 @@ The box's harness (e.g. 'opencode', 'claude-code') → selects its decoder adapt
 
 > **analyzeTrace**(`source`, `runId?`): `Promise`\<[`TrajectoryAnalysis`](#trajectoryanalysis)\>
 
-Defined in: [runtime/supervise/trajectory-recorder.ts:27](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L27)
+Defined in: [runtime/supervise/trajectory-recorder.ts:28](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/trajectory-recorder.ts#L28)
 
 Collect the source's spans and run the agent-eval batch analyzers over them under one `runId`.
 
@@ -17402,7 +17440,7 @@ Collect the source's spans and run the agent-eval batch analyzers over them unde
 
 > **createWorktreeCliExecutor**(`options`): [`Executor`](#executor)\<`WorktreeHarnessResult`\>
 
-Defined in: [runtime/supervise/worktree-cli-executor.ts:97](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L97)
+Defined in: [runtime/supervise/worktree-cli-executor.ts:98](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-cli-executor.ts#L98)
 
 **`Experimental`**
 
@@ -17428,7 +17466,7 @@ before `execute()` resolves throws.
 
 > **worktreeFanout**\<`Task`\>(`options`): [`CombinatorShape`](#combinatorshape)\<`Task`, `WorktreeHarnessResult`\>
 
-Defined in: [runtime/supervise/worktree-fanout.ts:78](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L78)
+Defined in: [runtime/supervise/worktree-fanout.ts:79](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/supervise/worktree-fanout.ts#L79)
 
 **`Experimental`**
 
@@ -17458,7 +17496,9 @@ the shared valid-only `selectValidWinner` (never a judge).
 
 > **createVerifierEnvironment**(`opts`): [`AgenticSurface`](#agenticsurface)
 
-Defined in: [runtime/verifier-environment.ts:67](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/verifier-environment.ts#L67)
+Defined in: [runtime/verifier-environment.ts:68](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/verifier-environment.ts#L68)
+
+Any checkable task as an `Environment`, no tool surface required: the artifact is the worker's answer and the domain is one deployable `check` over it.
 
 #### Parameters
 
@@ -17488,7 +17528,9 @@ Defined in: [runtime/waterfall.ts:58](https://github.com/tangle-network/agent-ru
 
 > **localShell**(): [`Shell`](#shell)
 
-Defined in: [runtime/workspace.ts:18](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L18)
+Defined in: [runtime/workspace.ts:19](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L19)
+
+Host-process `Shell`: run a command via `execFile`, resolving `{ stdout, stderr, code }` (never throws on non-zero exit).
 
 #### Returns
 
@@ -17500,7 +17542,9 @@ Defined in: [runtime/workspace.ts:18](https://github.com/tangle-network/agent-ru
 
 > **gitWorkspace**(`opts`): [`Workspace`](#workspace)
 
-Defined in: [runtime/workspace.ts:46](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L46)
+Defined in: [runtime/workspace.ts:48](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L48)
+
+A `Workspace` over a git checkout: materialize an isolated worktree at `ref`, commit produced changes (conflict-aware), and read `head` — hooks disabled, identity pinned.
 
 #### Parameters
 
@@ -17518,7 +17562,7 @@ Defined in: [runtime/workspace.ts:46](https://github.com/tangle-network/agent-ru
 
 > **jjWorkspace**(`opts`): [`Workspace`](#workspace)
 
-Defined in: [runtime/workspace.ts:90](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L90)
+Defined in: [runtime/workspace.ts:92](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L92)
 
 A jj-backed `Workspace` (Jujutsu, colocated with git for the durable remote).
  Same port, same `Shell` — a drop-in for `gitWorkspace`. jj suits agent loops:
@@ -17541,7 +17585,7 @@ A jj-backed `Workspace` (Jujutsu, colocated with git for the durable remote).
 
 > **runInWorkspace**\<`T`\>(`ws`, `body`, `opts?`): `Promise`\<[`WorkspaceRun`](#workspacerun)\<`T`\>\>
 
-Defined in: [runtime/workspace.ts:149](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L149)
+Defined in: [runtime/workspace.ts:151](https://github.com/tangle-network/agent-runtime/blob/main/src/runtime/workspace.ts#L151)
 
 Run a worker `body` inside a FRESH clone of a shared `Workspace`, then commit its work back
 so the next worker (or the supervisor) builds on it. This is the seam that turns isolated
diff --git a/scripts/gen-primitive-catalog.mjs b/scripts/gen-primitive-catalog.mjs
index a5f5fc2f..261fb575 100644
--- a/scripts/gen-primitive-catalog.mjs
+++ b/scripts/gen-primitive-catalog.mjs
@@ -28,6 +28,21 @@
 // Wired into `pnpm run docs:api` (runs after TypeDoc) and gated by
 // scripts/check-docs-freshness.mjs (regenerates + diffs — a new live export absent from
 // the committed catalog is a RED BUILD). Never hand-edit docs/api/primitive-catalog.md.
+//
+// Row policy — every VISIBLE table row must be informative:
+//   - Documented entries (any kind) get a table row.
+//   - Undocumented interface/type entries collapse into one per-section
+//     "Undocumented supporting types" paragraph (names stay backticked, so they remain
+//     greppable and the freshness gate still proves their existence).
+//   - Undocumented function/class/const entries keep a visible blank row AND are counted
+//     against `maxUndocumentedCallables` below — a RATCHET: the ceiling is the current
+//     count, so new callables must ship with a TSDoc summary and the number only falls.
+//     After backfilling summaries, lower the constant to the new count.
+//
+// TSDoc position rule the extractor imposes: the summary line goes BEFORE any block tag.
+// A doc block whose first content line is `@experimental`/`@stable` reads as ALL tag
+// content to the TS compiler — getDocumentationComment returns empty and the catalog row
+// renders blank. Tags go at the END of the block.
 
 import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { createRequire } from 'node:module'
@@ -249,6 +264,16 @@ const extracted = extractModules(allModules.map((m) => m.specifier))
 const bySpecifier = new Map()
 for (let i = 0; i < allModules.length; i++) bySpecifier.set(allModules[i].specifier, extracted[i])
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Ratchet: undocumented callables may only DECREASE. Undocumented interface/type
+// entries collapse out of the table (see renderSection), but a blank function/class/
+// const row is a reach-for primitive with no summary — visible shame, capped here.
+// The ceiling is the exact current count; when a backfill lowers the real number,
+// lower the constant to match. Exceeding it (a new undocumented callable) exits 1.
+
+const maxUndocumentedCallables = 108
+const ratchetKinds = new Set(['function', 'class', 'const'])
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Render.
 
@@ -265,6 +290,10 @@ function entriesFor(mod) {
 function renderSection(mod, importLabel) {
   const entries = entriesFor(mod)
   if (!entries.length) return ''
+  // Undocumented interface/type entries collapse into a compact paragraph below the
+  // table; everything else (documented entries + undocumented callables) stays a row.
+  const collapsed = entries.filter((e) => !e.summary && (e.kind === 'interface' || e.kind === 'type'))
+  const rows = entries.filter((e) => !collapsed.includes(e))
   const lines = [
     `### ${mod.label}`,
     '',
@@ -273,11 +302,19 @@ function renderSection(mod, importLabel) {
     '| Symbol | Kind | Summary |',
     '|---|---|---|',
   ]
-  for (const e of entries) {
+  for (const e of rows) {
     lines.push(
       `| \`${e.name}\` | ${e.kind} | ${e.summary || '_(no summary — add a TSDoc line at the declaration)_'} |`,
     )
   }
+  if (collapsed.length) {
+    lines.push('')
+    lines.push(
+      `**Undocumented supporting types** (add a TSDoc line at the declaration to earn a table row): ${collapsed
+        .map((e) => `\`${e.name}\``)
+        .join(', ')}.`,
+    )
+  }
   lines.push('')
   return lines.join('\n')
 }
@@ -285,6 +322,22 @@ function renderSection(mod, importLabel) {
 const importLabelOf = (basePackage, subpath) =>
   subpath === '.' ? basePackage : `${basePackage}/${subpath.replace(/^\.\//, '')}`
 
+const undocumentedCallables = []
+for (const mod of allModules) {
+  for (const e of entriesFor(mod)) {
+    if (!e.summary && ratchetKinds.has(e.kind)) undocumentedCallables.push(`${e.name} (${e.kind}, ${mod.specifier})`)
+  }
+}
+if (undocumentedCallables.length > maxUndocumentedCallables) {
+  console.error(
+    `primitive-catalog: ${undocumentedCallables.length} undocumented function/class/const exports exceed the ` +
+      `ratchet ceiling of ${maxUndocumentedCallables}. Add a TSDoc summary line at each new declaration ` +
+      '(summary BEFORE any @tag — a tag-first block reads as blank). Undocumented callables:\n  ' +
+      undocumentedCallables.join('\n  '),
+  )
+  process.exit(1)
+}
+
 const out = []
 out.push('<!--')
 out.push('  GENERATED — do not edit. Run `pnpm run docs:api` to regenerate.')
@@ -345,5 +398,6 @@ const total =
 console.error(
   `primitive-catalog: wrote docs/api/primitive-catalog.md — ${ownModules.length} own subpaths + ` +
     `${substrateModules.length} substrate surfaces, ${total} catalogued symbols ` +
-    `(agent-runtime@${pkg.version}, agent-eval@${substrateVersion}).`,
+    `(agent-runtime@${pkg.version}, agent-eval@${substrateVersion}); ` +
+    `${undocumentedCallables.length}/${maxUndocumentedCallables} undocumented callables (ratchet).`,
 )
diff --git a/src/agent/improvement-adapter.ts b/src/agent/improvement-adapter.ts
index 7b64b1db..00285dff 100644
--- a/src/agent/improvement-adapter.ts
+++ b/src/agent/improvement-adapter.ts
@@ -126,6 +126,7 @@ const DEFAULT_CREATE_KINDS: ReadonlyArray<FindingSubject['kind']> = [
   'new-tool',
 ]
 
+/** The substrate-default `ImprovementAdapter`: resolve each finding's subject to a real surface path, LLM-draft a unified-diff patch, then auto-apply or open a PR. */
 export function createSurfaceImprovementAdapter(
   opts: CreateSurfaceImprovementAdapterOpts,
 ): ImprovementAdapter<SurfaceImprovementEdit> {
diff --git a/src/agent/surfaces.ts b/src/agent/surfaces.ts
index 38c10bc4..6b1b07e4 100644
--- a/src/agent/surfaces.ts
+++ b/src/agent/surfaces.ts
@@ -194,6 +194,7 @@ export interface SurfaceValidationIssue {
   reason: 'missing' | 'not-directory' | 'not-file'
 }
 
+/** Validate an `AgentSurfaces` map on disk — missing paths fail loud at `defineAgent` time instead of silently skipping self-improvement edits. */
 export function validateSurfaces(
   surfaces: AgentSurfaces,
   repoRoot: string,
diff --git a/src/analyst-loop/iterations-to-trace-store.ts b/src/analyst-loop/iterations-to-trace-store.ts
index 53b486aa..42fb56aa 100644
--- a/src/analyst-loop/iterations-to-trace-store.ts
+++ b/src/analyst-loop/iterations-to-trace-store.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The read seam that closes the autonomous loop: project a round's `Iteration[]`
  * (each carrying its raw `SandboxEvent[]`) into an in-memory `TraceAnalysisStore`, the
@@ -12,6 +11,8 @@
  * steers on. Projection is best-effort over the FLAT SandboxEvent shape (no per-event
  * lineage yet — that's the richer-trace gap); it never fabricates — an errored iteration
  * surfaces a real ERROR span carrying the real message.
+ *
+ * @experimental
  */
 
 import {
diff --git a/src/audit/index.ts b/src/audit/index.ts
index 0e3f0c5e..c4f5600e 100644
--- a/src/audit/index.ts
+++ b/src/audit/index.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `agent-runtime/src/audit` — pure I/O helpers for UI-audit workspaces.
  *
@@ -8,6 +7,8 @@
  * can persist a workspace, regardless of whether the findings came from
  * the in-process auditor client, a sandbox-SDK harness, or a hand-curated
  * import.
+ *
+ * @experimental
  */
 
 export type {
diff --git a/src/audit/issue-writer.ts b/src/audit/issue-writer.ts
index b9be2b21..834bd32c 100644
--- a/src/audit/issue-writer.ts
+++ b/src/audit/issue-writer.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * UI-audit issue writer — pure I/O. Takes a workspace dir + `UiFinding[]`
  * and emits:
@@ -14,6 +13,8 @@
  * The writer is deterministic, idempotent for `appendFindings()`, and
  * never invokes an LLM. It assigns the next monotonic id to a finding the
  * caller did not pre-id.
+ *
+ * @experimental
  */
 
 import { promises as fs } from 'node:fs'
diff --git a/src/backends.ts b/src/backends.ts
index 1ab8b413..1a5aeeec 100644
--- a/src/backends.ts
+++ b/src/backends.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Backend factories for `runAgentTaskStream`. Three shapes ship in core:
  *
@@ -10,6 +9,8 @@
  * Adapters stay thin: domain repos own auth, model selection, and the concrete
  * tool surface. The factories handle session creation, stream normalization,
  * and graceful end-of-stream signalling.
+ *
+ * @stable
  */
 
 import { BackendTransportError } from './errors'
@@ -170,7 +171,6 @@ function sleep(ms: number, signal?: AbortSignal): Promise<void> {
 }
 
 /**
- * @stable
  *
  * OpenAI-compat streaming backend. Routes `runAgentTaskStream` through any
  * `POST /chat/completions` endpoint that speaks OpenAI's SSE protocol —
@@ -202,6 +202,8 @@ function sleep(ms: number, signal?: AbortSignal): Promise<void> {
  * `final.error` onto their `RunRecord.error` — silently treating an empty
  * `finalText` as "agent produced nothing" hides credit exhaustion, auth
  * failure, and upstream outages.
+ *
+ * @stable
  */
 export function createOpenAICompatibleBackend<
   TInput extends AgentBackendInput = AgentBackendInput,
diff --git a/src/conversation/call-policy.ts b/src/conversation/call-policy.ts
index ea8e887d..409a7c75 100644
--- a/src/conversation/call-policy.ts
+++ b/src/conversation/call-policy.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Per-call resilience policy for participant backends: deadline, retry with
  * backoff, and a circuit breaker. Each policy is applied *around* a single
@@ -11,6 +10,8 @@
  * leaking sockets. Retries replay the same logical turn (same `turnId`) so
  * any caching gateway can dedupe. Circuit breakers are *per participant*: A's
  * failures don't open B's breaker.
+ *
+ * @stable
  */
 
 /** Pure judgment of whether an error is worth retrying. Defaults: TimeoutError, AbortError, fetch-level network errors. */
diff --git a/src/conversation/conversation-backend.ts b/src/conversation/conversation-backend.ts
index 0e201c33..068263d4 100644
--- a/src/conversation/conversation-backend.ts
+++ b/src/conversation/conversation-backend.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Wrap a `Conversation` so it satisfies `AgentExecutionBackend`. The result is
  * an addressable "single agent" whose internal behavior is an N-party
@@ -11,6 +10,8 @@
  * callers see one `text_delta` per inner turn (the turn's full text), tagged
  * with `[speaker] ` prefix so the outer transcript stays attributable. The
  * conversation's `conversation_end` halt reason rides on a `final` event.
+ *
+ * @stable
  */
 
 import { newRuntimeSession, nowIso } from '../sessions'
diff --git a/src/conversation/define-conversation.ts b/src/conversation/define-conversation.ts
index 1abd8358..a5e1fec6 100644
--- a/src/conversation/define-conversation.ts
+++ b/src/conversation/define-conversation.ts
@@ -1,10 +1,11 @@
 /**
- * @stable
  *
  * Declarative constructor for a multi-agent `Conversation`. Validates inputs
  * fail-loud at definition time (duplicate participant names, alternate order
  * with ≠2 participants, non-positive `maxTurns`) so misconfiguration is caught
  * before `runConversation` is called and not buried inside a streaming run.
+ *
+ * @stable
  */
 
 import { ValidationError } from '../errors'
diff --git a/src/conversation/headers.ts b/src/conversation/headers.ts
index f2e31e8c..27d8ce26 100644
--- a/src/conversation/headers.ts
+++ b/src/conversation/headers.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Cross-gateway forwarding headers — the wire-level contract that makes
  * agent-to-agent communication composable across organizational boundaries.
@@ -13,6 +12,8 @@
  * rules so both sides agree.
  *
  * Full protocol: `docs/agent-bus-protocol.md`.
+ *
+ * @stable
  */
 
 /** Standard names — lowercased so Headers maps interop on every runtime. */
diff --git a/src/conversation/journal-sql.ts b/src/conversation/journal-sql.ts
index 217d85f8..85323e0d 100644
--- a/src/conversation/journal-sql.ts
+++ b/src/conversation/journal-sql.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Durable conversation journal backed by any SQL store. Adapter-agnostic by
  * design: callers wire a `SqlAdapter` against their driver of choice (D1,
@@ -33,6 +32,8 @@
  *   }
  *   const journal = new SqlConversationJournal(pg)
  *   await journal.migrate()
+ *
+ * @stable
  */
 
 import type { ConversationJournal, ConversationJournalEntry } from './journal'
diff --git a/src/conversation/journal.ts b/src/conversation/journal.ts
index 2f2a551b..3d1cd73f 100644
--- a/src/conversation/journal.ts
+++ b/src/conversation/journal.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Durable conversation transcript — survives a driver process crash mid-run.
  * The runner journals every committed turn before yielding `turn_end`, so a
@@ -12,6 +11,8 @@
  * is ~30 lines. The in-memory adapter is the default for tests and scratch.
  * The file adapter (JSONL on disk) is the default-durable choice when no
  * upstream store is wired.
+ *
+ * @stable
  */
 
 import type { ConversationTurn, HaltReason } from './types'
diff --git a/src/conversation/run-conversation.ts b/src/conversation/run-conversation.ts
index 3891da61..b0bd82d5 100644
--- a/src/conversation/run-conversation.ts
+++ b/src/conversation/run-conversation.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Conversation orchestrator. Drives N participants in turn through their own
  * `AgentExecutionBackend`s, aggregating per-turn text + usage, enforcing
@@ -27,6 +26,8 @@
  * Credit cap is enforced *between turns*, not mid-stream: a turn that
  * overshoots the cap completes, the cap then halts the conversation before
  * the next turn.
+ *
+ * @stable
  */
 
 import type { KnowledgeReadinessReport } from '@tangle-network/agent-eval'
@@ -79,6 +80,7 @@ export async function runConversation(
   return result
 }
 
+/** Streaming conversation orchestrator: drives N participants in turn through their own backends, enforcing `maxTurns` / `maxCreditsCents` / `haltOn`, yielding per-event stream markers. */
 export async function* runConversationStream(
   conversation: Conversation,
   options: RunConversationOptions,
diff --git a/src/conversation/turn-id.ts b/src/conversation/turn-id.ts
index 54360d9b..46434e4a 100644
--- a/src/conversation/turn-id.ts
+++ b/src/conversation/turn-id.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Deterministic turn identifier. Stable across retries of the same logical
  * turn so backends (and any caching gateway in between) can dedupe on it.
@@ -9,6 +8,8 @@
  * Shape: `${runId}.t${index}.${speakerSlug}` — readable in logs, sortable by
  * turn index, attributable to a speaker. Slugify keeps the speaker portion
  * URL-safe so it can ride in HTTP headers without escaping.
+ *
+ * @stable
  */
 
 export function turnId(runId: string, index: number, speaker: string): string {
diff --git a/src/conversation/types.ts b/src/conversation/types.ts
index f3e7015a..5cd3d526 100644
--- a/src/conversation/types.ts
+++ b/src/conversation/types.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Public types for multi-agent conversations. A `Conversation` is two-or-more
  * participants taking turns through their own `AgentExecutionBackend`s, driven
@@ -9,6 +8,8 @@
  * in-process iterable, local cli-bridge, sandbox, router, or a remote
  * agent-gateway — so the same `runConversation` call drives same-machine,
  * same-cloud, and cross-cloud orchestration without code change.
+ *
+ * @stable
  */
 
 import type { AgentExecutionBackend } from '../types'
diff --git a/src/durable/spawn-journal.ts b/src/durable/spawn-journal.ts
index ec78bbaf..475d7dc3 100644
--- a/src/durable/spawn-journal.ts
+++ b/src/durable/spawn-journal.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Event-sourced spawn journal for the recursive execution atom (build steps 3 + 7).
  *
@@ -17,6 +16,8 @@
  * each settlement — NOT wall-clock. `replaySpawnTree` sorts strictly by `seq` before
  * touching the blob store, so the order in which rehydration `get`s resolve can never
  * reorder the replayed `Settled[]`; the result is identical regardless of blob latency.
+ *
+ * @experimental
  */
 
 import { createHash } from 'node:crypto'
diff --git a/src/errors.ts b/src/errors.ts
index bc8c4f86..dd1e39b7 100644
--- a/src/errors.ts
+++ b/src/errors.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Error taxonomy for `@tangle-network/agent-runtime`.
  *
@@ -18,6 +17,8 @@
  * backend, backend transport errors) get fresh subclasses that still carry an
  * `AgentEvalErrorCode` so cross-package handlers can pattern-match without
  * importing the runtime.
+ *
+ * @stable
  */
 
 import { AgentEvalError } from '@tangle-network/agent-eval'
@@ -32,12 +33,13 @@ export {
 } from '@tangle-network/agent-eval'
 
 /**
- * @stable
  *
  * Caller asked to resume a session against a backend whose `kind` does not
  * match the session's recorded backend. This is a routing bug — the same
  * session id was reused across two different backend implementations — and
  * is not retryable without picking the right backend.
+ *
+ * @stable
  */
 export class SessionMismatchError extends AgentEvalError {
   readonly sessionBackend: string
@@ -55,12 +57,13 @@ export class SessionMismatchError extends AgentEvalError {
 }
 
 /**
- * @stable
  *
  * A backend transport call (HTTP, gRPC, sidecar IPC) failed with a non-success
  * status. Distinct from `JudgeError` (which is structural / unrecoverable)
  * because backend failures are sometimes retryable and consumers may want to
  * branch on the upstream status code.
+ *
+ * @stable
  */
 export class BackendTransportError extends AgentEvalError {
   readonly backend: string
@@ -86,10 +89,11 @@ export class BackendTransportError extends AgentEvalError {
 }
 
 /**
- * @stable
  *
  * A runtime-run lifecycle method was called in an order the state machine does
  * not allow: `persist()` before `complete()`, `complete()` twice, etc.
+ *
+ * @stable
  */
 export class RuntimeRunStateError extends AgentEvalError {
   constructor(message: string, options?: { cause?: unknown }) {
@@ -98,7 +102,6 @@ export class RuntimeRunStateError extends AgentEvalError {
 }
 
 /**
- * @stable
  *
  * The dynamic-loop planner returned an unusable topology move — the LLM emitted
  * no parseable envelope, an unknown `kind`, or a structurally-invalid move
@@ -107,6 +110,8 @@ export class RuntimeRunStateError extends AgentEvalError {
  * cannot drive the kernel. Carries `validation` so cross-package handlers can
  * pattern-match without importing the runtime. Fail loud — never substitute a
  * default move, or the loop silently runs a topology nobody chose.
+ *
+ * @stable
  */
 export class PlannerError extends AgentEvalError {
   constructor(message: string, options?: { cause?: unknown }) {
diff --git a/src/improvement/agentic-generator.ts b/src/improvement/agentic-generator.ts
index e1a15a75..96a78a8a 100644
--- a/src/improvement/agentic-generator.ts
+++ b/src/improvement/agentic-generator.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `agenticGenerator` — the full-agentic `CandidateGenerator`: the
  * `shots=N, sandbox=on` setting of the one `improvementDriver`. It runs a real
@@ -29,6 +28,8 @@
  * false`), never shipped — if you configured a verifier, a non-passing tree is
  * not a candidate. With no verifier the legacy behavior holds: first dirty shot
  * is the candidate.
+ *
+ * @experimental
  */
 
 import { spawnSync } from 'node:child_process'
@@ -68,6 +69,7 @@ export interface AgenticGeneratorOptions {
   isDirty?: (worktreePath: string) => boolean
 }
 
+/** Full-agentic `CandidateGenerator` (the `shots=N, sandbox=on` setting): run a real coding harness inside the candidate worktree so the agent makes the change in place. */
 export function agenticGenerator(opts: AgenticGeneratorOptions = {}): CandidateGenerator {
   const harness = opts.harness ?? 'claude'
   const buildPrompt = opts.buildPrompt ?? defaultBuildPrompt
diff --git a/src/improvement/improve.ts b/src/improvement/improve.ts
index 702119db..41401bda 100644
--- a/src/improvement/improve.ts
+++ b/src/improvement/improve.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `improve` — the ONE public, surface-pluggable RSI verb.
  *
@@ -22,6 +21,8 @@
  *
  * Everything else (`scenarios`, `judge`, `agent`, `budget`, `llm`) passes
  * straight through to `selfImprove`.
+ *
+ * @experimental
  */
 
 import { gepaProposer, skillOptProposer } from '@tangle-network/agent-eval/campaign'
diff --git a/src/improvement/improvement-driver.ts b/src/improvement/improvement-driver.ts
index 4df8e050..2f9699a3 100644
--- a/src/improvement/improvement-driver.ts
+++ b/src/improvement/improvement-driver.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `improvementDriver` — the ONE reflective/agentic improvement proposer for
  * agent-eval's improvement loop. It implements `SurfaceProposer` and owns
@@ -17,6 +16,8 @@
  * Both emit changes into a worktree the driver finalizes into a
  * `CodeSurface{ worktreeRef }` the loop measures on the holdout. See
  * agent-eval's `docs/design/self-improvement-engine.md`.
+ *
+ * @experimental
  */
 
 import type { AnalystFinding } from '@tangle-network/agent-eval'
@@ -57,6 +58,7 @@ export interface ImprovementDriverOptions {
   baseRef?: string
 }
 
+/** The one reflective/agentic improvement proposer (`SurfaceProposer`): owns the candidate worktree lifecycle and delegates HOW a change is produced to a pluggable `CandidateGenerator`. */
 export function improvementDriver(opts: ImprovementDriverOptions): SurfaceProposer<AnalystFinding> {
   const baseRef = opts.baseRef ?? 'main'
 
diff --git a/src/improvement/reflective-generator.ts b/src/improvement/reflective-generator.ts
index 8fc0bbed..b8d13a7c 100644
--- a/src/improvement/reflective-generator.ts
+++ b/src/improvement/reflective-generator.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `reflectiveGenerator` — the cheap, no-sandbox `CandidateGenerator`. It drafts
  * surface edits via the existing improvement adapter (`proposeFromFindings`,
@@ -10,6 +9,8 @@
  * This is the `shots=1, sandbox=off` setting of the one improvement driver.
  * The `agenticGenerator` (a multi-shot verify-in-session loop) is the
  * `shots=N` setting — both plug into the same `improvementDriver`.
+ *
+ * @experimental
  */
 
 import { spawnSync } from 'node:child_process'
@@ -21,6 +22,7 @@ export interface ReflectiveGeneratorOptions {
   improvementAdapter: ImprovementAdapter<SurfaceImprovementEdit>
 }
 
+/** Cheap no-sandbox `CandidateGenerator` (the `shots=1` setting): draft surface edits via the improvement adapter and apply them as one coherent candidate. */
 export function reflectiveGenerator(opts: ReflectiveGeneratorOptions): CandidateGenerator {
   return {
     kind: 'reflective',
diff --git a/src/intelligence/capability.ts b/src/intelligence/capability.ts
index 5b8becb8..6d5c61f1 100644
--- a/src/intelligence/capability.ts
+++ b/src/intelligence/capability.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The Capability-Delivery Manifest — the unified, future-proof structure for
  * delivering ONE certified unit of agent power = `{ interface, binding }`.
@@ -23,6 +22,8 @@
  * Layering: this depends DOWN on `@tangle-network/sandbox` (the SDK
  * `AgentProfileMcpServer` shape the mcp binding lowers to) and on the runtime's
  * own `ToolSpec`. It never imports agent-eval and never reaches upward.
+ *
+ * @experimental
  */
 
 import type { AgentProfileMcpServer } from '@tangle-network/agent-interface'
diff --git a/src/intelligence/delivery.ts b/src/intelligence/delivery.ts
index 3d761bfe..1ef3cc24 100644
--- a/src/intelligence/delivery.ts
+++ b/src/intelligence/delivery.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Tangle Intelligence — the DELIVERY half of the loop (pull-by-default).
  *
@@ -22,6 +21,8 @@
  *     async (input, applied) => myAgent(input, { systemPrompt: applied.composePrompt(BASE) }),
  *     { project: 'support-agent', target: 'support-agent' },
  *   )
+ *
+ * @experimental
  */
 
 import { createIntelligenceClient, type IntelligenceConfig } from './index'
diff --git a/src/intelligence/effort.ts b/src/intelligence/effort.ts
index 91b82373..2197f792 100644
--- a/src/intelligence/effort.ts
+++ b/src/intelligence/effort.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * EffortPolicy — pure data, no execution. Resolves a named tier into a flat
  * settings object the Intelligence wrapper reads to decide WHICH intelligence
@@ -12,6 +11,8 @@
  * fanout:1, loops:false, intelligenceBudgetUsd:0). At OFF the wrapper runs the
  * agent as pure passthrough and only intelligence-class usage can prove to be
  * zero — there is nothing to spawn.
+ *
+ * @experimental
  */
 
 /** The named effort tiers, lowest to highest. `'off'` is the honest floor
diff --git a/src/intelligence/index.ts b/src/intelligence/index.ts
index 63d26357..26fbd2ad 100644
--- a/src/intelligence/index.ts
+++ b/src/intelligence/index.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Tangle Intelligence SDK — the Observe + Mode-0 product layer.
  *
@@ -20,6 +19,8 @@
  * is a LATER phase and is NOT built here. This wrapper only Observes and passes
  * through; there is no abort path, so the only fail-soft surface is the
  * telemetry export.
+ *
+ * @experimental
  */
 
 import {
diff --git a/src/intelligence/redact.ts b/src/intelligence/redact.ts
index f6e3ac96..44220b52 100644
--- a/src/intelligence/redact.ts
+++ b/src/intelligence/redact.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Redaction for Intelligence trace export. The trace carries the customer's
  * real input/output; before any of it leaves the process it passes through a
@@ -10,6 +9,8 @@
  * This is intentionally narrower than `src/sanitize.ts` (which redacts the
  * runtime's *event envelope* field-by-field): here the value is opaque
  * customer payload, so the scrub is value-shaped, not schema-shaped.
+ *
+ * @experimental
  */
 
 /** A redactor maps an arbitrary trace value to a safe-to-export value. Pure;
diff --git a/src/intelligence/resolver.ts b/src/intelligence/resolver.ts
index 79cd31a0..f1068b63 100644
--- a/src/intelligence/resolver.ts
+++ b/src/intelligence/resolver.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The capability resolver — the ONLY place that knows binding kinds. It lowers a
  * `CapabilityManifest` into a uniform `ResolvedSurface` consumed identically by
@@ -23,6 +22,8 @@
  * returns the base surface only; a per-capability resolve failure DROPS that
  * capability (never a half-wired tool); a post-resolve drift check drops any tool
  * whose live names diverge from the certified interface.
+ *
+ * @experimental
  */
 
 import type { AgentProfileMcpServer } from '@tangle-network/agent-interface'
diff --git a/src/loop-runner-bin.ts b/src/loop-runner-bin.ts
index d3d02c9e..41704416 100644
--- a/src/loop-runner-bin.ts
+++ b/src/loop-runner-bin.ts
@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 /**
- * @experimental
  *
  * `agent-runtime-loop` — the schedulable entrypoint for the configured
  * delegated loop-runner. A cron job / routine / Makefile target invokes:
@@ -12,6 +11,8 @@
  * export a `DelegatedLoopRegistry`, or a `() => DelegatedLoopRegistry | Promise<…>`.
  * The bin runs the selected mode, prints the `DelegatedLoopResult` as JSON, and
  * exits 0 on `ok`, 1 on a recorded failure, 2 on a usage/config error.
+ *
+ * @experimental
  */
 
 import {
@@ -39,11 +40,12 @@ export interface LoopRunnerCliResult {
 }
 
 /**
- * @experimental
  *
  * Pure CLI core (no process / argv / IO) so it's unit-testable: validate the
  * mode, load the registry, dispatch, map to an exit code (0 ok / 1 failed /
  * 2 usage). Exported for embedding in custom runners + tests.
+ *
+ * @experimental
  */
 export async function runLoopRunnerCli(args: LoopRunnerCliArgs): Promise<LoopRunnerCliResult> {
   if (!isDelegatedLoopMode(args.mode)) {
diff --git a/src/loop-runner.ts b/src/loop-runner.ts
index 24a59aaa..12dc2f03 100644
--- a/src/loop-runner.ts
+++ b/src/loop-runner.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `runDelegatedLoop` — the configured delegated loop-runner.
  *
@@ -18,6 +17,8 @@
  * mode routing, timing, fail-loud on an unregistered mode, and a uniform result
  * shape; each mode's engine is a pre-configured runner in the registry (build it
  * with the factories below, or inject your own / a stub).
+ *
+ * @experimental
  */
 
 import type { Scenario } from '@tangle-network/agent-eval/campaign'
@@ -79,12 +80,13 @@ export interface RunDelegatedLoopOptions {
 }
 
 /**
- * @experimental
  *
  * Dispatch a configured loop by mode. Fails loud (throws `ConfigError`) when no
  * runner is registered for the mode — a routine pointed at an unwired mode is a
  * config bug, not a silent no-op. A runner that throws is captured as
  * `{ ok: false }` so unattended runs record the failure rather than crash.
+ *
+ * @experimental
  */
 export async function runDelegatedLoop<T = unknown>(
   mode: DelegatedLoopMode,
@@ -144,7 +146,6 @@ export interface WorktreeLoopRunnerOptions {
 }
 
 /**
- * @experimental
  *
  * `code` mode on the GENERIC recursive path: author one `AgentProfile` per harness, run them as a
  * `worktreeFanout` (N `createWorktreeCliExecutor` leaves, each `gateOnDeliverable`) through
@@ -155,6 +156,8 @@ export interface WorktreeLoopRunnerOptions {
  * the winner is the shared valid-only selector (NOT `defaultSelectWinner`, whose non-valid fallback
  * would surface an ungated patch). Equal-k holds by the conserved budget pool. Returns the winning
  * patch artifact, or throws when no candidate is delivered (fail loud, never a vacuous done).
+ *
+ * @experimental
  */
 export function worktreeLoopRunner(
   options: WorktreeLoopRunnerOptions,
@@ -234,12 +237,14 @@ export interface ResearchLoopRunnerOptions {
 }
 
 /**
- * @experimental `research` mode — research-in-a-loop with valid-only KB growth.
+ * `research` mode — research-in-a-loop with valid-only KB growth.
  *
  * Each round: research → gate every candidate (fail-closed; passage MUST be in
  * the source) → accept the clean ones → re-research the vetoed ones next round,
  * up to `maxRounds`. Vetoed facts in the final round are RETURNED (escalate,
  * never silently dropped) so the caller audits vs retries.
+ *
+ * @experimental
  */
 export function researchLoopRunner(
   o: ResearchLoopRunnerOptions,
@@ -267,14 +272,22 @@ export function researchLoopRunner(
   }
 }
 
-/** @experimental `self-improve` mode — agent-eval's one-call closed loop (held-out gated). */
+/**
+ * `self-improve` mode — agent-eval's one-call closed improvement loop (held-out gated).
+ *
+ * @experimental
+ */
 export function selfImproveLoopRunner<TScenario extends Scenario, TArtifact>(
   options: SelfImproveOptions<TScenario, TArtifact>,
 ): DelegatedLoopRunner<SelfImproveResult<TScenario, TArtifact>> {
   return async () => selfImprove<TScenario, TArtifact>(options)
 }
 
-/** @experimental `audit` mode — analyst loop over captured trace/run data. */
+/**
+ * `audit` mode — analyst loop over captured trace/run data.
+ *
+ * @experimental
+ */
 export function auditLoopRunner<TProposal = unknown, TEdit = unknown>(
   options: RunAnalystLoopOpts,
 ): DelegatedLoopRunner<RunAnalystLoopResult<TProposal, TEdit>> {
diff --git a/src/mcp/bin-helpers.ts b/src/mcp/bin-helpers.ts
index 7e2d46b0..2b45019e 100644
--- a/src/mcp/bin-helpers.ts
+++ b/src/mcp/bin-helpers.ts
@@ -1,9 +1,10 @@
 /**
- * @experimental
  *
  * Helpers extracted from `bin.ts` so the env-detection + executor-selection
  * logic is unit-testable without spawning a subprocess. The bin imports from
  * here; tests import from here directly.
+ *
+ * @experimental
  */
 
 import type { SandboxClient } from '../runtime'
diff --git a/src/mcp/bin.ts b/src/mcp/bin.ts
index 08f3e650..ce682d8c 100644
--- a/src/mcp/bin.ts
+++ b/src/mcp/bin.ts
@@ -1,7 +1,6 @@
 #!/usr/bin/env node
 
 /**
- * @experimental
  *
  * `agent-runtime-mcp` — stdio MCP server entry point.
  *
@@ -36,6 +35,8 @@
  *   AGENT_RUNTIME_DELEGATION_RETAIN_TERMINAL
  *                                    optional — positive integer cap on retained
  *                                    terminal records. Unset = keep forever.
+ *
+ * @experimental
  */
 
 import type { SandboxClient } from '../runtime'
diff --git a/src/mcp/delegate-supervisor-provisioning.ts b/src/mcp/delegate-supervisor-provisioning.ts
index f9408021..4d254ee5 100644
--- a/src/mcp/delegate-supervisor-provisioning.ts
+++ b/src/mcp/delegate-supervisor-provisioning.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Resolve the `delegate` supervisor substrate (router brain + worker backend) from env, so the
  * `agent-runtime-mcp` bin can serve the ONE generic `delegate` verb by env, over the SAME stdio
@@ -12,6 +11,8 @@
  * repo's `resolveRouterBaseUrl` convention
  * (`TANGLE_ROUTER_URL` / `TANGLE_ROUTER_BASE_URL`), normalised to an OpenAI-compatible `/v1` endpoint,
  * keyed by `TANGLE_API_KEY`.
+ *
+ * @experimental
  */
 
 import type { BackendType } from '@tangle-network/sandbox'
diff --git a/src/mcp/delegates.ts b/src/mcp/delegates.ts
index 7a9df471..46fac4e9 100644
--- a/src/mcp/delegates.ts
+++ b/src/mcp/delegates.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `detachedSessionDelegate` — the sandbox-session coder delegate: a closure that drives `runLoop`
  * against a `SandboxClient` + a caller-supplied (or minimal model-only default) worker profile, to a
@@ -16,6 +15,8 @@
  * none is passed, a minimal model-only default profile is materialized in `./detached-coder` — no
  * hardcoded skills or tools. For NEW local-repo coding use `worktreeFanout` / `worktreeLoopRunner`
  * (author one `AgentProfile` per harness → `createWorktreeCliExecutor` leaves → `gateOnDeliverable`).
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
@@ -105,13 +106,14 @@ export interface CoderReview {
 }
 
 /**
- * @experimental
  *
  * Optional adversarial reviewer over a coder candidate that already passed
  * mechanical validation (tests/typecheck/forbidden/diff/no-op/secrets). Folded
  * from the ai-trading-blueprint delegation MCP: a candidate is only eligible to
  * win if the reviewer approves it. The reviewer is the consumer's seam — an LLM
  * judge, a `pnpm review` command, anything returning a `CoderReview`.
+ *
+ * @experimental
  */
 export type CoderReviewer = (
   output: CoderOutput,
diff --git a/src/mcp/delegation-store.ts b/src/mcp/delegation-store.ts
index eeab5b75..c30f5cd4 100644
--- a/src/mcp/delegation-store.ts
+++ b/src/mcp/delegation-store.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Persistence port for the MCP delegation queue.
  *
@@ -12,6 +11,8 @@
  * Records MUST be JSON-safe — `FileDelegationStore` round-trips them
  * through `JSON.stringify`/`JSON.parse`, so a `Date`, `Map`, or function
  * smuggled into `args`/`result` would corrupt the journal.
+ *
+ * @experimental
  */
 
 import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
diff --git a/src/mcp/delegation-trace.ts b/src/mcp/delegation-trace.ts
index cd3fe27b..c7247229 100644
--- a/src/mcp/delegation-trace.ts
+++ b/src/mcp/delegation-trace.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Compact loop-trace tee for the delegation journal.
  *
@@ -14,6 +13,8 @@
  * Payload discipline: a record's trace is hard-capped (spans + serialized
  * bytes). Past the cap the OLDEST spans are dropped and the record carries a
  * `traceTruncated: true` marker — truncation is never silent.
+ *
+ * @experimental
  */
 
 import { buildLoopSpanNodes } from '../otel-export'
diff --git a/src/mcp/detached-coder.ts b/src/mcp/detached-coder.ts
index 0025f8b8..cbc330d0 100644
--- a/src/mcp/detached-coder.ts
+++ b/src/mcp/detached-coder.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Sandbox-session coder decode layer. The sandbox-session delegate (`./delegates`) and the
  * cross-restart resume driver run the in-box harness over a `SandboxClient` and need to
@@ -14,6 +13,8 @@
  *      projected onto `CoderOutput`; and
  *   2. an LLM-emitted JSON block (`{ branch, patch, testResult, typecheckResult, diffStats }`),
  *      lifted onto `data.result` or scanned out of the assistant transcript (any harness shape).
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
diff --git a/src/mcp/detached-turn.ts b/src/mcp/detached-turn.ts
index 34f37801..673ba6f8 100644
--- a/src/mcp/detached-turn.ts
+++ b/src/mcp/detached-turn.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Detached delegation turns over the sandbox SDK's `driveTurn` primitive.
  *
@@ -31,6 +30,8 @@
  * under the `'detached-turn'` driver tag. Multi-variant fanout stays on the
  * streaming `runLoop` path — N concurrent sessions cannot be expressed as one
  * resume key, and winner selection needs every candidate.
+ *
+ * @experimental
  */
 
 import type { SandboxEvent } from '@tangle-network/sandbox'
diff --git a/src/mcp/executor.ts b/src/mcp/executor.ts
index c7ea6ff1..8e8a74c9 100644
--- a/src/mcp/executor.ts
+++ b/src/mcp/executor.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Delegation executors — the layer between MCP delegates and the sandbox
  * substrate. Each executor exposes a {@link SandboxClient} the kernel
@@ -16,6 +15,8 @@
  *   in the caller's existing fleet so worker diffs land directly on the
  *   caller's filesystem (the fleet's shared workspace). Selected when the
  *   parent sandbox passes `TANGLE_FLEET_ID` into the MCP server's env.
+ *
+ * @experimental
  */
 
 import type { CreateSandboxOptions, SandboxInstance } from '@tangle-network/sandbox'
diff --git a/src/mcp/feedback-store.ts b/src/mcp/feedback-store.ts
index 4cfa2b91..521caa0a 100644
--- a/src/mcp/feedback-store.ts
+++ b/src/mcp/feedback-store.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Feedback persistence surface for the MCP layer.
  *
@@ -12,6 +11,8 @@
  * Feedback events are append-only: every rating is a new event with a
  * fresh id, even when the same delegation is rated multiple times. The
  * caller decides how to roll up scores downstream.
+ *
+ * @experimental
  */
 
 import type { DelegateFeedbackArgs, DelegationFeedbackSnapshot } from './types'
diff --git a/src/mcp/in-process-executor.ts b/src/mcp/in-process-executor.ts
index 4ae8166a..66824369 100644
--- a/src/mcp/in-process-executor.ts
+++ b/src/mcp/in-process-executor.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * In-process delegation executor — when `agent-runtime-mcp` runs inside a sandbox whose image
  * carries the local coding-harness CLIs (claude / codex / opencode), delegations spawn the harness
@@ -14,6 +13,8 @@
  * patch artifact) on the `result` event. The sandbox-session decode layer
  * (`./detached-coder`) projects that artifact onto `CoderOutput`; the generic `Scope` path settles
  * the artifact directly. The §1.5 payload (systemPrompt + model) reaches the harness inside the core.
+ *
+ * @experimental
  */
 
 import { randomUUID } from 'node:crypto'
diff --git a/src/mcp/index.ts b/src/mcp/index.ts
index 6f22d2b5..90356a25 100644
--- a/src/mcp/index.ts
+++ b/src/mcp/index.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `@tangle-network/agent-runtime/mcp` — Stdio MCP server exposing the
  * delegation tools to sandbox coding-harness agents: the generic `delegate`
@@ -11,6 +10,8 @@
  * Mount the server inside a product agent's sandbox via
  * `agent-runtime-mcp` (the bin) or wire it into a custom Node entry
  * point with `createMcpServer({ ... })`.
+ *
+ * @experimental
  */
 
 export type { DetectExecutorArgs } from './bin-helpers'
diff --git a/src/mcp/kb-gate.ts b/src/mcp/kb-gate.ts
index 2f2b3407..f6bb76eb 100644
--- a/src/mcp/kb-gate.ts
+++ b/src/mcp/kb-gate.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `createKbGate` — the valid-only knowledge-base growth gate, distilled from
  * physim's KB-research subsystem. A research-in-a-loop delegate (or any KB
@@ -18,6 +17,8 @@
  * without importing it. The remediation policy (correct-on-veto vs
  * escalate-as-unverified) is the caller's — this returns the verdict; it never
  * drops a fact silently.
+ *
+ * @experimental
  */
 
 /** @experimental A fact proposed for the KB, with its grounding. */
@@ -128,11 +129,12 @@ function builtinJudges(minPassageChars: number, selfArtifactKinds: string[]): Fa
 }
 
 /**
- * @experimental
  *
  * Build a fail-closed KB gate. The returned function runs the built-in floor
  * (passage-non-empty → passage-present → value-in-passage → no-circular-citation)
  * then any consumer judges, returning on the first veto.
+ *
+ * @experimental
  */
 export function createKbGate(
   options: CreateKbGateOptions = {},
diff --git a/src/mcp/local-harness.ts b/src/mcp/local-harness.ts
index a25c28e4..51e6d6cf 100644
--- a/src/mcp/local-harness.ts
+++ b/src/mcp/local-harness.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Subprocess wrappers for the local coding-harness CLIs installed in the
  * sandbox image (claude-code, codex, opencode). Used by the in-process
@@ -14,6 +13,8 @@
  *   - capture stdout/stderr
  *   - support cancellation via AbortSignal
  *   - enforce a wall-clock timeout
+ *
+ * @experimental
  */
 
 import { type ChildProcess, spawn } from 'node:child_process'
diff --git a/src/mcp/openai-tools.ts b/src/mcp/openai-tools.ts
index da7374d9..a649f650 100644
--- a/src/mcp/openai-tools.ts
+++ b/src/mcp/openai-tools.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * OpenAI Chat Completions `tools[]` projection of the queue-bound agent-runtime
  * MCP delegation tools.
@@ -18,6 +17,8 @@
  * Tool name + description + JSON-schema are pulled from the canonical
  * `DELEGATE_*` constants exported by `./tools/*` so the projection cannot
  * drift from the server's own validators.
+ *
+ * @experimental
  */
 
 import type { OpenAIChatTool } from '../types'
@@ -53,11 +54,12 @@ function buildTool(
 }
 
 /**
- * @experimental
  *
  * Returns the queue-bound delegation tools projected into OpenAI Chat
  * Completions `tools[]` shape. The order is stable: `delegate_feedback`,
  * `delegation_status`, `delegation_history`.
+ *
+ * @experimental
  */
 export function mcpToolsForRuntimeMcp(): OpenAIChatTool[] {
   return [
@@ -80,12 +82,13 @@ export function mcpToolsForRuntimeMcp(): OpenAIChatTool[] {
 }
 
 /**
- * @experimental
  *
  * Subset filter — return only the projected tools whose `function.name`
  * appears in `names`. Useful for curated mounts (e.g. only the queue-bound
  * delegation tools, omitting `delegate_feedback`). Unknown names are
  * silently ignored; pass an empty array to get an empty result.
+ *
+ * @experimental
  */
 export function mcpToolsForRuntimeMcpSubset(names: ReadonlyArray<string>): OpenAIChatTool[] {
   const allowed = new Set(names)
diff --git a/src/mcp/server.ts b/src/mcp/server.ts
index 30cd314d..a020e05a 100644
--- a/src/mcp/server.ts
+++ b/src/mcp/server.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Stdio JSON-RPC MCP server exposing the delegation tools to sandbox
  * coding-harness agents (claude-code, codex, opencode, ...): the generic
@@ -17,6 +16,8 @@
  * one request; each response is one line. `tools/list` and `tools/call`
  * mirror the MCP 2024-11-05 spec; we do not pull in
  * `@modelcontextprotocol/sdk` to keep the dependency footprint zero.
+ *
+ * @experimental
  */
 
 import { createInterface, type Interface as ReadlineInterface } from 'node:readline'
@@ -146,7 +147,11 @@ const PROTOCOL_VERSION = '2024-11-05'
 const DEFAULT_SERVER_NAME = 'agent-runtime-mcp'
 const DEFAULT_SERVER_VERSION = '0.22.0'
 
-/** @experimental */
+/**
+ * Stdio JSON-RPC MCP server exposing the delegation tools (`delegate`, `delegate_feedback`, `delegation_status`, `delegation_history`, optional `delegate_ui_audit`) to sandbox coding-harness agents.
+ *
+ * @experimental
+ */
 export function createMcpServer(options: McpServerOptions = {}): McpServer {
   const queue =
     options.queue ??
diff --git a/src/mcp/task-queue.ts b/src/mcp/task-queue.ts
index 7c9420b0..8b22ebb2 100644
--- a/src/mcp/task-queue.ts
+++ b/src/mcp/task-queue.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * State machine for async MCP delegations:
  *
@@ -23,6 +22,8 @@
  * stay queryable, in-flight records either re-attach through the
  * `resumeDelegate` seam (when they carry a `detachedSessionRef`) or fail
  * loud with a driver-restart error so `delegation_status` tells the truth.
+ *
+ * @experimental
  */
 
 import { ValidationError } from '../errors'
diff --git a/src/mcp/tools/checks.ts b/src/mcp/tools/checks.ts
index a3195d8f..f22654dd 100644
--- a/src/mcp/tools/checks.ts
+++ b/src/mcp/tools/checks.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The trace-analyst KIND directory — the operator's lenses, as composable DATA.
  *
@@ -13,6 +12,8 @@
  * A kind here is a lightweight lens (`Check`); it is a deliberate SUBSET of agent-eval's full
  * `TraceAnalystKindSpec`, so a kind that needs the heavy agentic actor (sub-agent recursion, tools,
  * goldens) upgrades to `createTraceAnalystKind` without changing this directory's surface.
+ *
+ * @experimental
  */
 
 import {
diff --git a/src/mcp/tools/coordination.ts b/src/mcp/tools/coordination.ts
index c22d6d8e..32fb7c02 100644
--- a/src/mcp/tools/coordination.ts
+++ b/src/mcp/tools/coordination.ts
@@ -1,10 +1,11 @@
 /**
- * @experimental
  *
  * MCP binding for a live `Scope`. A sandbox driver gets the same small verbs
  * the in-process driver has: spawn, observe, await, steer, ask/answer, analyze,
  * and stop. Settled outputs remain Scope artifacts; product code can project
  * them into any UI/report envelope it needs.
+ *
+ * @experimental
  */
 
 import type {
diff --git a/src/mcp/tools/delegate-feedback.ts b/src/mcp/tools/delegate-feedback.ts
index 8d8855ef..41f7ebd5 100644
--- a/src/mcp/tools/delegate-feedback.ts
+++ b/src/mcp/tools/delegate-feedback.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `delegate_feedback` MCP tool — synchronous record of agent / user /
  * downstream-judge feedback on a delegation, artifact, or outcome.
@@ -8,6 +7,8 @@
  * When `refersTo.kind === 'delegation'`, the snapshot is also attached
  * to the matching queue record so `delegation_history` surfaces it
  * inline without a join.
+ *
+ * @experimental
  */
 
 import type { FeedbackStore } from '../feedback-store'
diff --git a/src/mcp/tools/delegate-ui-audit.ts b/src/mcp/tools/delegate-ui-audit.ts
index 06463ee2..ca6c8fef 100644
--- a/src/mcp/tools/delegate-ui-audit.ts
+++ b/src/mcp/tools/delegate-ui-audit.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `delegate_ui_audit` MCP tool — async kickoff for UI audit runs. Validates
  * the input, computes an idempotency key over the canonical fields, hands
@@ -13,6 +12,8 @@
  * remote browser). agent-runtime ships the in-process client under
  * `./profiles` so consumers who want the canonical setup can wire it
  * with a few lines.
+ *
+ * @experimental
  */
 
 import path from 'node:path'
diff --git a/src/mcp/tools/delegate.ts b/src/mcp/tools/delegate.ts
index 0f88c56e..0183fafd 100644
--- a/src/mcp/tools/delegate.ts
+++ b/src/mcp/tools/delegate.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `delegate` MCP tool — the ONE generic delegation verb, the agent-facing front door to
  * `delegate()` / `supervise()`. The agent hands it an INTENT (what it wants done); a default
@@ -13,6 +12,8 @@
  * The supervisor's substrate (its brain `router`, the worker `backend`, the completion `deliverable`)
  * is INJECTED at server construction — never an agent-supplied arg. The agent supplies only the
  * intent (+ an optional per-call `model` / `runId`).
+ *
+ * @experimental
  */
 
 import type { RouterConfig } from '../../runtime/router-client'
diff --git a/src/mcp/tools/delegation-history.ts b/src/mcp/tools/delegation-history.ts
index 778361c3..31efc343 100644
--- a/src/mcp/tools/delegation-history.ts
+++ b/src/mcp/tools/delegation-history.ts
@@ -1,9 +1,10 @@
 /**
- * @experimental
  *
  * `delegation_history` MCP tool — synchronous read of past delegations.
  * The agent uses this for self-introspection — "have I delegated this
  * kind of task before? did it work?" — and calibration.
+ *
+ * @experimental
  */
 
 import type {
diff --git a/src/mcp/tools/delegation-status.ts b/src/mcp/tools/delegation-status.ts
index dd334cc3..1112b3f2 100644
--- a/src/mcp/tools/delegation-status.ts
+++ b/src/mcp/tools/delegation-status.ts
@@ -1,8 +1,9 @@
 /**
- * @experimental
  *
  * `delegation_status` MCP tool — synchronous poll. Returns the current
  * state machine + optional progress + final result (when terminal).
+ *
+ * @experimental
  */
 
 import { NotFoundError } from '../../errors'
diff --git a/src/mcp/trace-propagation.ts b/src/mcp/trace-propagation.ts
index 847fcbe6..4de2630a 100644
--- a/src/mcp/trace-propagation.ts
+++ b/src/mcp/trace-propagation.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Trace context propagation for MCP subprocess.
  *
@@ -15,6 +14,8 @@
  *
  * When these env vars are absent, the MCP generates a fresh trace root —
  * the server operates standalone without trace joining.
+ *
+ * @experimental
  */
 
 import type { OtelExporter } from '../otel-export'
diff --git a/src/mcp/types.ts b/src/mcp/types.ts
index 737d91b1..1cc95f95 100644
--- a/src/mcp/types.ts
+++ b/src/mcp/types.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * MCP delegation tool surface — the typed inputs/outputs the product agent
  * sees over the wire. These types are the contract; the JSON schemas under
@@ -10,6 +9,8 @@
  * `completed` | `failed` | `cancelled`. `delegate_feedback` +
  * `delegation_history` are synchronous reads / writes against the local
  * task queue + feedback store.
+ *
+ * @experimental
  */
 
 import type { CoderTask } from '../profiles/coder'
diff --git a/src/mcp/worktree-harness.ts b/src/mcp/worktree-harness.ts
index e98e1f2e..a277d2f1 100644
--- a/src/mcp/worktree-harness.ts
+++ b/src/mcp/worktree-harness.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The ONE worktree-harness execution core. The physical act — run a supervisor-authored
  * `AgentProfile` on a local coding-harness CLI (claude / codex / opencode) against a fresh git
@@ -17,6 +16,8 @@
  * → the configured test/typecheck commands in the live worktree → return the result + a `cleanup`
  * the caller invokes at its own teardown point. A throw cleans up before propagating, so a failed
  * run never leaks a worktree.
+ *
+ * @experimental
  */
 
 import { spawn } from 'node:child_process'
diff --git a/src/mcp/worktree.ts b/src/mcp/worktree.ts
index 867ca184..0ebc2bbd 100644
--- a/src/mcp/worktree.ts
+++ b/src/mcp/worktree.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Git worktree helpers for the in-process delegation executor. Each
  * delegation runs in its own worktree so multiple parallel harness
@@ -13,6 +12,8 @@
  * (via a `runGit` helper). Stays narrow on purpose: no commits, no rebases.
  * Diff capture stages all changes (`git add -A`) into the ephemeral worktree's
  * index so created (untracked) files appear in the `--cached` diff.
+ *
+ * @experimental
  */
 
 import { spawn } from 'node:child_process'
diff --git a/src/model-resolution.ts b/src/model-resolution.ts
index dfc3bc9a..5fa1fb96 100644
--- a/src/model-resolution.ts
+++ b/src/model-resolution.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Chat-model resolution + catalog validation — the shared primitive every
  * product chat handler needs and was, until now, hand-rolling. Lifts the
@@ -12,6 +11,8 @@
  * sharing the catalog fetch, the malformed-id guard, and the fail-closed
  * admission rule. No React, no `process.env` assumption — `env` is an
  * explicit narrow record so this runs unchanged in Node and in Workers.
+ *
+ * @stable
  */
 
 /**
diff --git a/src/profiles/coder.ts b/src/profiles/coder.ts
index 8537d363..8975b578 100644
--- a/src/profiles/coder.ts
+++ b/src/profiles/coder.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `CoderTask` + `coderTaskToPrompt` — the per-task DATA + pure formatter for code-modification tasks
  * (§1.5: the system authors profiles; there is no hardcoded coder profile constant). A domain
@@ -7,6 +6,8 @@
  * (`createWorktreeCliExecutor`) or a fanout (`worktreeFanout`); "is it delivered" is a
  * `DeliverableSpec` (`patchDelivered`), not a bundled validator. This formatter renders a `CoderTask`
  * into the per-task instruction that profile receives.
+ *
+ * @experimental
  */
 
 const DEFAULT_MAX_DIFF_LINES = 400
diff --git a/src/profiles/index.ts b/src/profiles/index.ts
index 2058d1ac..362ee9e2 100644
--- a/src/profiles/index.ts
+++ b/src/profiles/index.ts
@@ -1,9 +1,10 @@
 /**
- * @experimental
  *
  * Authored `AgentProfile` presets (the §1.5 author-the-profile DATA) for common agent roles, each
  * with a pure task-to-prompt formatter. The substrate materializes a profile into a harness
  * invocation; "is it delivered" is a `DeliverableSpec`, not a bundled validator.
+ *
+ * @experimental
  */
 
 // The judge-agnostic UI-audit workspace I/O helpers (persist a `UiFinding[]` to a
diff --git a/src/profiles/ui-auditor/in-process-client.ts b/src/profiles/ui-auditor/in-process-client.ts
index 28f214da..3fd9c45e 100644
--- a/src/profiles/ui-auditor/in-process-client.ts
+++ b/src/profiles/ui-auditor/in-process-client.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `createInProcessUiAuditClient` — a `SandboxClient` that drives a
  * Playwright browser in-process and delegates finding identification to a
@@ -21,6 +20,8 @@
  * Concurrency: each iteration's prompt carries a self-describing task
  * envelope (see `prompt.ts`), so concurrent fanout iterations do not race
  * over per-client side state.
+ *
+ * @experimental
  */
 
 import type { CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox'
diff --git a/src/profiles/ui-auditor/index.ts b/src/profiles/ui-auditor/index.ts
index 94b93dce..94a2057a 100644
--- a/src/profiles/ui-auditor/index.ts
+++ b/src/profiles/ui-auditor/index.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `ui-auditor` profile — vision-driven UI audit iteration preset for
  * `runLoop`. See `profile.ts` for the entry point.
@@ -7,6 +6,8 @@
  * The in-process Playwright + judge client lives in `in-process-client.ts`
  * under the optional `./ui-auditor` subpath export so consumers that only
  * want the profile types do not pay the Playwright peer dep.
+ *
+ * @experimental
  */
 
 export type {
diff --git a/src/profiles/ui-auditor/judge.ts b/src/profiles/ui-auditor/judge.ts
index 999553a3..ef85cff2 100644
--- a/src/profiles/ui-auditor/judge.ts
+++ b/src/profiles/ui-auditor/judge.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * UI judge seam — consumer-supplied vision LLM hook the in-process
  * auditor client invokes to identify findings from captured screenshots.
@@ -21,6 +20,8 @@
  *   - Treat any exception thrown by the judge as the iteration's failure —
  *     do not swallow LLM errors. Per agent-runtime's fail-loud doctrine,
  *     surfacing the error to the kernel beats producing a silent zero.
+ *
+ * @experimental
  */
 
 import type { UiFinding, UiLens } from './substrate'
diff --git a/src/profiles/ui-auditor/lens-prompts.ts b/src/profiles/ui-auditor/lens-prompts.ts
index a0ba46ba..654e1cc2 100644
--- a/src/profiles/ui-auditor/lens-prompts.ts
+++ b/src/profiles/ui-auditor/lens-prompts.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Per-lens guidance the auditor inlines into its system prompt for an
  * iteration. Each entry is a self-contained brief — the same content the
@@ -9,6 +8,8 @@
  * Briefs are deliberately concrete: they enumerate the SIGNALS to look for
  * and the cross-lens distinctions to respect, so the judge files fewer
  * pile-on findings under generic labels.
+ *
+ * @experimental
  */
 
 import type { UiLens } from './substrate'
diff --git a/src/profiles/ui-auditor/output-adapter.ts b/src/profiles/ui-auditor/output-adapter.ts
index 4f484119..08a01e7c 100644
--- a/src/profiles/ui-auditor/output-adapter.ts
+++ b/src/profiles/ui-auditor/output-adapter.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Sandbox-event stream → UiAuditOutput decoder. The custom auditor
  * `SandboxClient` emits events of the form:
@@ -12,6 +11,8 @@
  *
  * Other event types are tolerated and ignored. The adapter is pure: it
  * folds an already-collected event array into a UiAuditOutput.
+ *
+ * @experimental
  */
 
 import type { SandboxEvent } from '@tangle-network/sandbox'
diff --git a/src/profiles/ui-auditor/profile.ts b/src/profiles/ui-auditor/profile.ts
index cad852e2..64119edd 100644
--- a/src/profiles/ui-auditor/profile.ts
+++ b/src/profiles/ui-auditor/profile.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `uiAuditorProfile` — preset for vision-driven UI audit iterations.
  *
@@ -8,6 +7,8 @@
  * vision-capable judge driving a browser. The loop kernel still iterates
  * `client.create() → box.streamPrompt() → box.delete()`; the client/box pair are provided by
  * `createInProcessUiAuditClient` (in `./in-process-client.ts`) or a consumer-supplied `SandboxClient`.
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
@@ -37,7 +38,11 @@ export interface UiAuditorProfileOptions {
   task?: UiAuditTask
 }
 
-/** @experimental */
+/**
+ * Preset `runLoop` bundle for vision-driven UI audits: returns the `AgentRunSpec`, output adapter, validator, and prompt formatter the loop kernel needs.
+ *
+ * @experimental
+ */
 export function uiAuditorProfile(options: UiAuditorProfileOptions = {}): {
   profile: AgentProfile
   taskToPrompt: (task: UiAuditTask) => string
diff --git a/src/profiles/ui-auditor/prompt.ts b/src/profiles/ui-auditor/prompt.ts
index 13a4b646..58334797 100644
--- a/src/profiles/ui-auditor/prompt.ts
+++ b/src/profiles/ui-auditor/prompt.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Prompt formatter for the auditor profile. `formatAuditorPrompt` produces
  * the user message handed to the iteration — describes the captures to be
@@ -14,6 +13,8 @@
  *
  * The formatter is pure and deterministic — re-run on the same task
  * produces the same prompt. Tests and trace replays rely on this.
+ *
+ * @experimental
  */
 
 import type { UiAuditTask } from './task'
diff --git a/src/profiles/ui-auditor/slugify.ts b/src/profiles/ui-auditor/slugify.ts
index 57bd9325..60bb3683 100644
--- a/src/profiles/ui-auditor/slugify.ts
+++ b/src/profiles/ui-auditor/slugify.ts
@@ -1,11 +1,12 @@
 /**
- * @experimental
  *
  * Shared slug helper used by both the in-process auditor client (for
  * screenshot filenames) and the issue writer (for issue Markdown
  * filenames). Lowercases, normalizes, strips non-alphanumeric, trims
  * dashes, caps at 80 chars. Throws when the result is empty so callers
  * never silently write to a name-less filename.
+ *
+ * @experimental
  */
 
 /** @experimental */
diff --git a/src/profiles/ui-auditor/substrate.ts b/src/profiles/ui-auditor/substrate.ts
index 2b25c1c7..cfcfba62 100644
--- a/src/profiles/ui-auditor/substrate.ts
+++ b/src/profiles/ui-auditor/substrate.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * UI audit finding shapes — the unit of evidence a contributor can act on.
  *
@@ -10,6 +9,8 @@
  *
  * The shapes are deliberately constraining — the validator + writer
  * hard-fail on missing screenshot evidence, missing lens, missing title.
+ *
+ * @experimental
  */
 
 /**
diff --git a/src/profiles/ui-auditor/task.ts b/src/profiles/ui-auditor/task.ts
index b046262b..a94da533 100644
--- a/src/profiles/ui-auditor/task.ts
+++ b/src/profiles/ui-auditor/task.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * UI auditor task + output shapes — what one iteration of the audit loop
  * does and what it returns.
@@ -8,6 +7,8 @@
  * decides which iterations to plan (lens-cycling, route-cycling,
  * refine-on-low-yield, etc.); the iteration itself captures screenshots
  * and asks a vision judge to identify findings under that lens.
+ *
+ * @experimental
  */
 
 import type { UiFinding, UiLens } from './substrate'
diff --git a/src/profiles/ui-auditor/validator.ts b/src/profiles/ui-auditor/validator.ts
index a6b2524b..f3b764a4 100644
--- a/src/profiles/ui-auditor/validator.ts
+++ b/src/profiles/ui-auditor/validator.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Auditor validator — scores a single iteration's findings for actionability
  * and gates the iteration result. The kernel uses `valid` + `score` for
@@ -24,6 +23,8 @@
  * An iteration with zero findings scores 0.5 by convention — neither a
  * confident pass nor a hard failure (the judge might just have nothing to
  * say on this lens). The driver decides what to do with it.
+ *
+ * @experimental
  */
 
 import type { DefaultVerdict } from '@tangle-network/agent-eval'
diff --git a/src/readiness.ts b/src/readiness.ts
index 1e1a4fef..8e7885a5 100644
--- a/src/readiness.ts
+++ b/src/readiness.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Pure readiness-decision helper. Maps a `KnowledgeReadinessReport` from
  * `@tangle-network/agent-eval` to a three-state branch (`ready` / `blocked` /
@@ -9,6 +8,8 @@
  * agent-eval; callers tightening or loosening this should keep it consistent
  * across all entry points for the same product so the UI / metrics agree on
  * what "caveat" means.
+ *
+ * @stable
  */
 
 import type { KnowledgeReadinessReport } from '@tangle-network/agent-eval'
@@ -18,7 +19,11 @@ import type { KnowledgeReadinessDecision } from './types'
 
 const DEFAULT_MINIMUM_READINESS_SCORE = 0.7
 
-/** @stable */
+/**
+ * Map a `KnowledgeReadinessReport` to a three-state branch (`ready` / `blocked` / `caveat`) the runtime, route handlers, and UI shells all switch on.
+ *
+ * @stable
+ */
 export function decideKnowledgeReadiness(
   report: KnowledgeReadinessReport,
   options: { minimumScore?: number } = {},
diff --git a/src/run.ts b/src/run.ts
index d736b69f..6d2413b2 100644
--- a/src/run.ts
+++ b/src/run.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * The two top-level entry points:
  *
@@ -10,6 +9,8 @@
  * Both gate the run on `KnowledgeReadinessReport` from `agent-eval`, emit the
  * same lifecycle event vocabulary (under different shapes — see `types.ts`),
  * and route session lifecycle through a pluggable `RuntimeSessionStore`.
+ *
+ * @stable
  */
 
 import {
@@ -79,7 +80,11 @@ import type {
   RuntimeStreamEvent,
 } from './types'
 
-/** @stable */
+/**
+ * Single-shot task lifecycle for adapter-driven tasks: readiness-gated, emits the runtime lifecycle event vocabulary, session-store pluggable.
+ *
+ * @stable
+ */
 export async function runAgentTask<
   TState,
   TAction,
@@ -193,7 +198,11 @@ export async function runAgentTask<
   }
 }
 
-/** @stable */
+/**
+ * Streaming task lifecycle: delegates execution to an `AgentExecutionBackend` (model API, sandbox, or custom iterable) and yields lifecycle events as they happen.
+ *
+ * @stable
+ */
 export async function* runAgentTaskStream<TInput extends AgentBackendInput = AgentBackendInput>(
   options: RunAgentTaskStreamOptions<TInput>,
 ): AsyncIterable<RuntimeStreamEvent> {
diff --git a/src/runtime-hooks.ts b/src/runtime-hooks.ts
index b0d5aca6..5a03eac3 100644
--- a/src/runtime-hooks.ts
+++ b/src/runtime-hooks.ts
@@ -1,9 +1,10 @@
 /**
- * @experimental
  *
  * Runtime hook contracts. Hooks are execution-scoped observers, not part of an
  * `AgentProfile`: profiles stay portable agent recipes; hooks attach to the
  * loop or product harness that is running the profile.
+ *
+ * @experimental
  */
 
 export type RuntimeHookPhase = 'before' | 'after' | 'error' | 'event'
diff --git a/src/runtime-run.ts b/src/runtime-run.ts
index 209f9cfd..d8732112 100644
--- a/src/runtime-run.ts
+++ b/src/runtime-run.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Production-run lifecycle: record what the agent did on behalf of a customer,
  * what it cost, and how it ended.
@@ -22,6 +21,8 @@
  *     KV store. The adapter receives a sanitized row shape; no telemetry
  *     payload bytes flow through it unless the consumer opts in via
  *     `RuntimeRunOptions.telemetryEvents`.
+ *
+ * @stable
  */
 
 import { RuntimeRunStateError, ValidationError } from './errors'
@@ -140,10 +141,11 @@ export interface RuntimeRunHandle {
 }
 
 /**
- * @stable
  *
  * Construct a runtime-run handle. The returned handle is mutable across its
  * lifetime; consumers should not share it across requests.
+ *
+ * @stable
  */
 export function startRuntimeRun(options: RuntimeRunOptions): RuntimeRunHandle {
   if (!options.workspaceId) {
diff --git a/src/runtime/audit-intent.ts b/src/runtime/audit-intent.ts
index 113cc876..cbf50299 100644
--- a/src/runtime/audit-intent.ts
+++ b/src/runtime/audit-intent.ts
@@ -105,6 +105,7 @@ const auditSchema = {
   },
 }
 
+/** The route-rigor analyst: compare declared vs revealed vs user intent over a trajectory and return aligned / drifting / diverged with evidence and one recommended intervention. */
 export async function auditIntent(
   input: AuditIntentInput,
   opts: AuditIntentOptions,
diff --git a/src/runtime/completion.ts b/src/runtime/completion.ts
index 8070b9d8..f725cdfb 100644
--- a/src/runtime/completion.ts
+++ b/src/runtime/completion.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Completion / satisfiability — the OTHER output of the pluggable analyst (the steer output
  * is `AnalystFinding[]` via the `analyze` hook; this is the "is it done?" output via the
@@ -20,6 +19,8 @@
  *     unguessable + attributable, so it can't be spuriously emitted or confused with content.
  *   - deterministic check (compile/test/citation/proof): `deterministicCompletion(check)` —
  *     a verifier over the output, never the judge verdict (selector ≠ judge holds).
+ *
+ * @experimental
  */
 
 import type { Iteration } from './types'
@@ -59,6 +60,7 @@ export interface CompletionPolicy {
   minConfidence?: number
 }
 
+/** Decide whether a `CompletionVerdict` may end the node under the policy: authority scales with the verdict's determinism, and probabilistic verdicts must clear `minConfidence`. */
 export function completionAuthorizes(v: CompletionVerdict, policy?: CompletionPolicy): boolean {
   if (!v?.done) return false
   if (v.determinism === 'deterministic') return true
diff --git a/src/runtime/harvest-corpus.ts b/src/runtime/harvest-corpus.ts
index bbc75a5c..add357e3 100644
--- a/src/runtime/harvest-corpus.ts
+++ b/src/runtime/harvest-corpus.ts
@@ -59,6 +59,7 @@ export interface HarvestReport {
   failures: HarvestFailure[]
 }
 
+/** Batch the firewalled `observe()` analyst over completed runs and accrete the trace-derived facts into the durable corpus — the production-traces→corpus write side of the flywheel. */
 export async function harvestCorpus(opts: HarvestCorpusOptions): Promise<HarvestReport> {
   const concurrency = Math.max(1, opts.concurrency ?? 4)
   const report: HarvestReport = { runsObserved: 0, findings: 0, learned: 0, failures: [] }
diff --git a/src/runtime/index.ts b/src/runtime/index.ts
index b49ca397..da18bc25 100644
--- a/src/runtime/index.ts
+++ b/src/runtime/index.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Driven-loop substrate. `runLoop` orchestrates around the sandbox SDK; it
  * does not invent its own notion of "what an agent is". Each iteration is
@@ -7,6 +6,8 @@
  * call. The driver owns topology; the validator owns scoring; the output
  * adapter owns event-stream decode; the kernel owns iteration accounting,
  * concurrency, abort, cost aggregation, and trace emission.
+ *
+ * @experimental
  */
 
 // The analyst-finding factory + id helper from the substrate, re-surfaced here so a host that builds
diff --git a/src/runtime/mcp-environment.ts b/src/runtime/mcp-environment.ts
index baa39037..8fa4928e 100644
--- a/src/runtime/mcp-environment.ts
+++ b/src/runtime/mcp-environment.ts
@@ -91,6 +91,7 @@ function sanitizeSchema(s: unknown): Record<string, unknown> {
   return { type: 'object', properties: {} }
 }
 
+/** Wrap any MCP server as an `Environment`: `tools/list` becomes `AgenticTool[]` with provider-safe schemas; the domain supplies only the artifact lifecycle hooks. */
 export function createMcpEnvironment(opts: McpEnvironmentOptions): Environment {
   const endpoints = new Map<string, McpEndpoint>()
   const maxChars = opts.maxResultChars ?? 1500
diff --git a/src/runtime/observe.ts b/src/runtime/observe.ts
index 9fb31a4f..c1dac709 100644
--- a/src/runtime/observe.ts
+++ b/src/runtime/observe.ts
@@ -136,6 +136,7 @@ const findingsSchema = {
   },
 } as const
 
+/** The third-person trace analyst: read a worker's trace and produce steer findings for the next attempt plus durable `learned` facts for the cross-run corpus. */
 export async function observe(input: ObserveInput, opts: ObserveOptions): Promise<Observation> {
   const traceSummary = summarizeTrace(input.trace, opts.maxTraceLines ?? 80)
   const res = await opts.chat.chat(
diff --git a/src/runtime/personify/analyst.ts b/src/runtime/personify/analyst.ts
index d8f2f677..4f3e7cdd 100644
--- a/src/runtime/personify/analyst.ts
+++ b/src/runtime/personify/analyst.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Analyst-on-scope (G1) — the analyze→findings→steer wire over the reactive `Scope`.
  *
@@ -16,6 +15,8 @@
  * drains its settlement, then enforces the firewall on the way out — a judge-derived finding
  * ABORTS, it is never filtered. Fail loud: a down analyst, a non-array result, or a tainted finding
  * throws; there is no silent empty-findings path that would let a combinator steer on nothing.
+ *
+ * @experimental
  */
 
 import type { AnalystFinding, AnalystRunInputs } from '@tangle-network/agent-eval'
diff --git a/src/runtime/personify/combinators.ts b/src/runtime/personify/combinators.ts
index 43da37a3..9188fc0a 100644
--- a/src/runtime/personify/combinators.ts
+++ b/src/runtime/personify/combinators.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The generic combinator library — the content-free act-bodies the wave's §1 contract froze.
  *
@@ -19,6 +18,8 @@
  * Two fail-loud invariants every combinator honors: a child the conserved pool cannot admit is a
  * CONCRETE blocker (never an eager over-fan, never a silent drop), and a `blocked` outcome always
  * names at least one blocker (a shape that cannot finish MUST say why — `blocked([])` throws).
+ *
+ * @experimental
  */
 
 import { ValidationError } from '../../errors'
diff --git a/src/runtime/personify/corpus.ts b/src/runtime/personify/corpus.ts
index f9f3db20..98f8f62b 100644
--- a/src/runtime/personify/corpus.ts
+++ b/src/runtime/personify/corpus.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The cross-run corpus (G2) — the learning-flywheel's durable accreted-fact store.
  *
@@ -14,6 +13,8 @@
  * the same `id`. Malformed records — a structurally-invalid `CorpusRecord` from disk or a caller —
  * fail loud (the validator throws), since a corpus that silently accepts garbage would poison
  * every downstream run that reads it back.
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
diff --git a/src/runtime/personify/persona.ts b/src/runtime/personify/persona.ts
index 7839234b..0137f59e 100644
--- a/src/runtime/personify/persona.ts
+++ b/src/runtime/personify/persona.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The personify layer impl — `definePersona` (the thin builder) + `runPersonified` (composes
  * the persona + chosen shape onto the keystone `Supervisor`), plus `createShapeContext`, the
@@ -16,6 +15,8 @@
  * that supplies raw `seams` is therefore wrapped here into a registry whose resolved factories
  * receive a ctx with the persona seams merged in — so a persona never has to pre-close its
  * factories by hand. A persona may instead supply a fully-built `registry` and skip the wrap.
+ *
+ * @experimental
  */
 
 import { InMemoryResultBlobStore, InMemorySpawnJournal } from '../../durable/spawn-journal'
diff --git a/src/runtime/personify/registry.ts b/src/runtime/personify/registry.ts
index 3ca9bab1..671c43f6 100644
--- a/src/runtime/personify/registry.ts
+++ b/src/runtime/personify/registry.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The loop-shape registry — the OPEN, content-free extension point for the personify layer.
  *
@@ -13,6 +12,8 @@
  * `verify`/`widen`) take spec arguments, so they are not bare zero-arg factories — a caller that
  * wants name-resolution registers its own COMPOSED shape (a combinator already applied to its
  * spec) on a registry instance. The registry carries SHAPE only; the domain lives on the persona.
+ *
+ * @experimental
  */
 
 import { ValidationError } from '../../errors'
diff --git a/src/runtime/personify/trajectory.ts b/src/runtime/personify/trajectory.ts
index 6de467eb..8525f60e 100644
--- a/src/runtime/personify/trajectory.ts
+++ b/src/runtime/personify/trajectory.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Trajectory trace + cost ledger — the post-hoc tree reconstructor (§4 of `wave-types`).
  *
@@ -20,6 +19,8 @@
  * CROSS-run analogue the pool cannot reach — proving equal compute before any win is claimed.
  *
  * Pure over the journal/blobs — no live agent calls; safe to run on a finished run's log.
+ *
+ * @experimental
  */
 
 import type {
diff --git a/src/runtime/personify/types.ts b/src/runtime/personify/types.ts
index 846b4d3c..6b1eccfa 100644
--- a/src/runtime/personify/types.ts
+++ b/src/runtime/personify/types.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The personify layer — the "act like X" knob on top of the recursive keystone.
  *
@@ -23,6 +22,8 @@
  * substrate `AgentProfile`/`BackendType`. It typechecks standalone — no impl, no engine.
  * Extensibility is structural: `Persona` carries an open `extensions` bag so a later
  * world-model / memory field is additive (a new optional key), never a breaking change.
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
diff --git a/src/runtime/personify/wave-types.ts b/src/runtime/personify/wave-types.ts
index 3042b09d..1139c35b 100644
--- a/src/runtime/personify/wave-types.ts
+++ b/src/runtime/personify/wave-types.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The RSI-wave type surface — the FROZEN contracts the wave's Core + Compose build to.
  *
@@ -30,6 +29,8 @@
  * Layering: imports ONLY keystone runtime types (`../supervise/types`), persona types
  * (`./types`), the substrate `AnalystFinding`/`AgentProfile`, and the durable-store interfaces.
  * Pure types/interfaces — this module typechecks standalone, owns no impl, invents no engine.
+ *
+ * @experimental
  */
 
 import type { AnalystFinding } from '@tangle-network/agent-eval'
diff --git a/src/runtime/promotion-gate.ts b/src/runtime/promotion-gate.ts
index 44861243..8e9b80ea 100644
--- a/src/runtime/promotion-gate.ts
+++ b/src/runtime/promotion-gate.ts
@@ -60,6 +60,7 @@ export interface PromotionVerdict {
   latency?: { mean: number; median: number; low: number; high: number }
 }
 
+/** Statistical promotion decision over a holdout benchmark: a seeded paired bootstrap (`heldoutSignificance`) whose CI lower bound must clear `deltaThreshold`. */
 export function promotionGate(opts: PromotionGateOptions): PromotionVerdict {
   const mode = opts.mode ?? 'superiority'
   if (opts.candidate === opts.incumbent) {
diff --git a/src/runtime/router-client.ts b/src/runtime/router-client.ts
index 3629be20..409219e1 100644
--- a/src/runtime/router-client.ts
+++ b/src/runtime/router-client.ts
@@ -45,6 +45,7 @@ export interface RouterChatResult {
   costUsd?: number
 }
 
+/** One OpenAI-compatible chat completion through the Tangle router, returning text + REAL token usage (`undefined` when the provider omits it — never a fabricated 0). */
 export async function routerChatWithUsage(
   cfg: RouterConfig,
   messages: Array<{ role: string; content: string }>,
diff --git a/src/runtime/run-benchmark.ts b/src/runtime/run-benchmark.ts
index b950783f..ac1c3dfa 100644
--- a/src/runtime/run-benchmark.ts
+++ b/src/runtime/run-benchmark.ts
@@ -92,6 +92,7 @@ export interface BenchmarkStrategySummary {
   ms: number
 }
 
+/** Benchmark output: per-strategy means plus the full per-task × per-strategy losses table an optimizer mines. */
 export interface BenchmarkReport {
   n: number
   excluded: number
diff --git a/src/runtime/run-loop.ts b/src/runtime/run-loop.ts
index c8aaeffa..9815d22f 100644
--- a/src/runtime/run-loop.ts
+++ b/src/runtime/run-loop.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `runLoop` — the topology-agnostic kernel built atop the sandbox SDK.
  *
@@ -21,6 +20,8 @@
  * emission. The kernel does NOT own: what the agent runs (sandbox SDK +
  * profile), how outputs are decoded (output adapter), how outputs are
  * scored (validator), or topology (driver).
+ *
+ * @experimental
  */
 
 import type { SandboxEvent, SandboxInstance } from '@tangle-network/sandbox'
@@ -134,7 +135,11 @@ export interface RunLoopOptions<Task, Output, Decision> {
   lineage?: LoopLineageOptions
 }
 
-/** @experimental */
+/**
+ * The round-synchronous loop kernel: each round `driver.plan()` fans N tasks to sandboxes (bounded concurrency), parses + validates each output, and folds results through `driver.decide`.
+ *
+ * @experimental
+ */
 export async function runLoop<Task, Output, Decision>(
   options: RunLoopOptions<Task, Output, Decision>,
 ): Promise<LoopResult<Task, Output, Decision>> {
diff --git a/src/runtime/sandbox-acquire.ts b/src/runtime/sandbox-acquire.ts
index b4d97e67..9190201a 100644
--- a/src/runtime/sandbox-acquire.ts
+++ b/src/runtime/sandbox-acquire.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `acquireSandbox` — cold-start-resilient sandbox acquisition. Eliminates the
  * "create timed out at the proxy" failure mode conceptually by DECOUPLING "the
@@ -23,6 +22,8 @@
  * but never reaches `running` (abort, terminal status, budget) is torn down
  * before the failure propagates, so an abort storm during cold start does not
  * leak live sandboxes.
+ *
+ * @experimental
  */
 
 import type { CreateSandboxOptions, SandboxInstance } from '@tangle-network/sandbox'
@@ -64,7 +65,11 @@ interface PollableClient extends SandboxClient {
   get?: (id: string) => Promise<SandboxInstance | null>
 }
 
-/** @experimental */
+/**
+ * Cold-start-resilient sandbox acquisition: create by name, observe readiness from the sandbox's own status (not the create call), and re-attach after gateway timeouts.
+ *
+ * @experimental
+ */
 export async function acquireSandbox(
   client: SandboxClient,
   options: CreateSandboxOptions,
diff --git a/src/runtime/sandbox-backend.ts b/src/runtime/sandbox-backend.ts
index 341d9178..ccf8bf9e 100644
--- a/src/runtime/sandbox-backend.ts
+++ b/src/runtime/sandbox-backend.ts
@@ -1,10 +1,11 @@
 /**
- * @experimental
  *
  * Backend-options assembly shared by the loop kernel's `createSandboxForSpec`
  * and the sandbox planner's box creation, so the worker box and the planner box
  * boot identically. Builds the options only — the acquire path (cold-start
  * recovery) lives in the kernel, the planner calls `client.create` directly.
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
diff --git a/src/runtime/sandbox-capabilities.ts b/src/runtime/sandbox-capabilities.ts
index b879f81f..4cc7c371 100644
--- a/src/runtime/sandbox-capabilities.ts
+++ b/src/runtime/sandbox-capabilities.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Capability probe for the loop kernel's backend-blind lineage seams. The
  * kernel must NEVER ask "is this Docker or Firecracker?"; it asks "can this
@@ -11,6 +10,8 @@
  * Invariant: a client with no `criuStatus` method (the loop's test fakes, the
  * raw SDK before it grew the probe) reports `canFork = false`. The seam is
  * fail-CLOSED — never assume forking works, only enable it on a positive probe.
+ *
+ * @experimental
  */
 
 import type { SandboxClient } from './types'
diff --git a/src/runtime/sandbox-lineage.ts b/src/runtime/sandbox-lineage.ts
index d4beef5e..f197f199 100644
--- a/src/runtime/sandbox-lineage.ts
+++ b/src/runtime/sandbox-lineage.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `SandboxLineage` — the backend-blind owner of box + session handles for a
  * single `runLoop` invocation. It exists so `run-loop.ts` never references a
@@ -30,6 +29,8 @@
  * in `run-loop.ts`; the lineage only hands back the live `streamPrompt` iterable
  * so the kernel keeps ownership of event collection, cost accounting, and trace
  * emission.
+ *
+ * @experimental
  */
 
 import type { CreateSandboxOptions, SandboxEvent, SandboxInstance } from '@tangle-network/sandbox'
diff --git a/src/runtime/sandbox-run.ts b/src/runtime/sandbox-run.ts
index e7ac9c22..5721e07c 100644
--- a/src/runtime/sandbox-run.ts
+++ b/src/runtime/sandbox-run.ts
@@ -40,22 +40,24 @@ import type { AgentRunSpec, SandboxClient } from './types'
 import { isAbortError, randomSuffix, sleep } from './util'
 
 /**
- * @experimental
  * How a typed deliverable `Out` is materialized from a finished turn.
  * - `events`   — pure parse over the event array (identical to `OutputAdapter`).
  * - `artifact` — read a file off the box AFTER the turn drains, then map it (+ the
  *                events). For diffs/codebases/documents that don't fit the chat
  *                stream. `path` relative ⇒ workspace root; absolute ⇒ container FS.
+ *
+ * @experimental
  */
 export type Deliverable<Out> =
   | { kind: 'events'; fromEvents: (events: SandboxEvent[]) => Out }
   | { kind: 'artifact'; path: string; fromArtifact: (raw: string, events: SandboxEvent[]) => Out }
 
 /**
- * @experimental
  * One finished turn over the artifact. A failed FS read is surfaced in `readError`
  * (never masked as an empty deliverable) so a caller distinguishes "agent produced
  * nothing" from a transport/FS fault.
+ *
+ * @experimental
  */
 export interface TurnResult<Out> {
   out: Out
@@ -64,7 +66,6 @@ export interface TurnResult<Out> {
 }
 
 /**
- * @experimental
  * Thrown when a turn is aborted/timed-out mid-settle. Carries the events drained
  * BEFORE the abort fired (and any in-progress `readError`) so an aborted run is
  * DIAGNOSABLE — the caller can tell never-started (`events: []`) from looped
@@ -72,6 +73,8 @@ export interface TurnResult<Out> {
  *
  * `name === 'AbortError'`, so existing `err.name === 'AbortError'` callers (the
  * loop kernel, scope, supervise runtime) keep matching it unchanged.
+ *
+ * @experimental
  */
 export class SandboxRunAbortError extends Error {
   override readonly name = 'AbortError'
@@ -119,10 +122,11 @@ export interface OpenSandboxRunOptions {
 }
 
 /**
- * @experimental
  * Open a sandbox run. Harness-agnostic: the harness lives in
  * `options.agentRun.sandboxOverrides.backend.type`, so opencode/codex/claude-code/
  * kimi-code all flow through this one entrypoint with identical env/auth wiring.
+ *
+ * @experimental
  */
 export async function openSandboxRun<Out>(
   client: SandboxClient,
diff --git a/src/runtime/steering-drivers.ts b/src/runtime/steering-drivers.ts
index 0550c288..2fa71c64 100644
--- a/src/runtime/steering-drivers.ts
+++ b/src/runtime/steering-drivers.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Leak-free steering drivers — the non-LLM controls for the driven loop.
  *
@@ -40,6 +39,8 @@
  * They consume nothing the loop kernel does not already give `plan()`/`decide()`
  * — `runLoop` requires no change. A benchmark picks a driver by name and the
  * kernel does the rest.
+ *
+ * @experimental
  */
 
 import type { Driver, Iteration } from './types'
diff --git a/src/runtime/strategy-evolution.ts b/src/runtime/strategy-evolution.ts
index bc1f045a..ae000929 100644
--- a/src/runtime/strategy-evolution.ts
+++ b/src/runtime/strategy-evolution.ts
@@ -361,6 +361,7 @@ function renameStrategy(orig: Strategy, unique: string): Strategy {
   }
 }
 
+/** Multi-generation strategy search: author candidates from tournament losses, play them against the incumbent at equal budget, promote via `promotionGate` on an untouched holdout slice. */
 export async function runStrategyEvolution(cfg: StrategyEvolutionConfig): Promise<EvolutionReport> {
   const budget = cfg.budget ?? 3
   const concurrency = cfg.concurrency ?? 3
diff --git a/src/runtime/strategy.ts b/src/runtime/strategy.ts
index 2ca50750..71813160 100644
--- a/src/runtime/strategy.ts
+++ b/src/runtime/strategy.ts
@@ -708,10 +708,12 @@ export interface Strategy {
   ): Agent<unknown, Outcome<unknown>>
 }
 
+/** Built-in `Strategy`: K independent attempts, keep the best-verifying (best-of-N / resample). */
 export const sample: Strategy = {
   name: 'sample',
   driver: (surface, task, opts, budget) => breadthStrategy(surface, task, opts, { width: budget }),
 }
+/** Built-in `Strategy`: attempt → `observe()` reads the trace → steer the next attempt → repeat (deepen one lineage). */
 export const refine: Strategy = {
   name: 'refine',
   driver: (surface, task, opts, budget) => depthStrategy(surface, task, opts, { maxShots: budget }),
diff --git a/src/runtime/supervise/authoring.ts b/src/runtime/supervise/authoring.ts
index 99072a08..d94b2a61 100644
--- a/src/runtime/supervise/authoring.ts
+++ b/src/runtime/supervise/authoring.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The supervisor's intelligence is AUTHORING the agents it spawns — not pressing buttons.
  *
@@ -11,6 +10,8 @@
  *
  * The skill is the single OPTIMIZABLE surface: edit it → the supervisor designs better agents.
  * That is the self-improvement lever (the prompt/skill lever), not the execution plumbing.
+ *
+ * @experimental
  */
 
 import { type AnalystFinding, computeFindingId, makeFinding } from '@tangle-network/agent-eval'
diff --git a/src/runtime/supervise/budget.ts b/src/runtime/supervise/budget.ts
index 1467b718..a842d938 100644
--- a/src/runtime/supervise/budget.ts
+++ b/src/runtime/supervise/budget.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The conserved budget reservation pool — the invariant the whole instrument
  * rests on (critique M5/B3). One root `Budget` becomes a conserved pool of three
@@ -17,6 +16,8 @@
  * Pure and deterministic: `now()` is injected, there is no I/O, and no wall-clock or
  * RNG read. A `reserve`/`reconcile` ticket is single-use (fail-loud on double or
  * unknown reconcile) so a child can never refund twice.
+ *
+ * @experimental
  */
 
 import { addTokenUsage, zeroTokenUsage } from '../util'
diff --git a/src/runtime/supervise/completion-gate.ts b/src/runtime/supervise/completion-gate.ts
index 7d668373..e435de81 100644
--- a/src/runtime/supervise/completion-gate.ts
+++ b/src/runtime/supervise/completion-gate.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The completion-oracle: **settled ⟺ DELIVERED.**
  *
@@ -18,6 +17,8 @@
  * The check is a DEPLOYABLE oracle — a test command, a state verifier, the commit0 judge —
  * read off the child's output, never the model judging itself. A throwing check is
  * fail-closed (not delivered), never a crash.
+ *
+ * @experimental
  */
 
 import type { DefaultVerdict, Executor, ExecutorResult, UsageEvent } from './types'
diff --git a/src/runtime/supervise/coordination-driver.ts b/src/runtime/supervise/coordination-driver.ts
index 2ca31d96..80bab9b9 100644
--- a/src/runtime/supervise/coordination-driver.ts
+++ b/src/runtime/supervise/coordination-driver.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `driverAgent` — the driver's BRAIN.
  *
@@ -23,6 +22,8 @@
  *    sandboxed harness drives the verbs as MCP tools. The same seam every tool-loop uses.
  *  - `systemPrompt` — the driver's stance (the agent-eval worker-driver prompt / the prompt
  *    generator). Injected, never hardcoded — the prompt is a pluggable role.
+ *
+ * @experimental
  */
 
 import { ValidationError } from '../../errors'
diff --git a/src/runtime/supervise/coordination-mcp.ts b/src/runtime/supervise/coordination-mcp.ts
index 0d1e890f..0c80a175 100644
--- a/src/runtime/supervise/coordination-mcp.ts
+++ b/src/runtime/supervise/coordination-mcp.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Serve the coordination verbs (spawn_agent / await_event / observe_agent / steer_agent / stop)
  * as a real HTTP MCP server over a LIVE `Scope`. This is the keystone that lets a coding-harness
@@ -16,6 +15,8 @@
  * Transport: JSON-RPC over HTTP POST (the MCP streamable-HTTP shape — `application/json` for a
  * single response). The server is created INSIDE an agent's `act(task, scope)` so it fronts that
  * agent's live scope; tear it down when the act returns.
+ *
+ * @experimental
  */
 
 import { createServer, type Server } from 'node:http'
diff --git a/src/runtime/supervise/delegate.ts b/src/runtime/supervise/delegate.ts
index 2c1650ba..f03a17d4 100644
--- a/src/runtime/supervise/delegate.ts
+++ b/src/runtime/supervise/delegate.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `delegate` — the one generic delegation verb. You hand it an INTENT (what you want done) and it
  * hands that intent to a default AUTHORING supervisor: a router-brained supervisor whose standing
@@ -16,6 +15,8 @@
  * caller on BOTH paths — a `winner` carries the delivered worker's spend, a `no-winner` carries the
  * spend incurred before it failed. That cost channel means a `delegate()` caller always learns what
  * the delegation actually spent.
+ *
+ * @experimental
  */
 
 import { ConfigError } from '../../errors'
diff --git a/src/runtime/supervise/detector-monitor.ts b/src/runtime/supervise/detector-monitor.ts
index 77587663..65c72441 100644
--- a/src/runtime/supervise/detector-monitor.ts
+++ b/src/runtime/supervise/detector-monitor.ts
@@ -1,11 +1,12 @@
 /**
- * @experimental
  *
  * The ONLINE analyst: watch a `TraceSource` and fold each tool span through agent-eval's published
  * streaming detector kernel (`repeatedActionDetector`/`errorStreakDetector` — the SAME kernel the
  * control loop folds), firing `onSignal` the moment a worker loops or error-storms. Substrate-
  * agnostic: it consumes spans from any source (owned router/bridge loop OR a sandbox box session),
  * never the raw tool seam. Detection logic + the failure taxonomy live in agent-eval; not reimplemented.
+ *
+ * @experimental
  */
 
 import {
diff --git a/src/runtime/supervise/driver-executor.ts b/src/runtime/supervise/driver-executor.ts
index 8b9bd812..43ee3c57 100644
--- a/src/runtime/supervise/driver-executor.ts
+++ b/src/runtime/supervise/driver-executor.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The recursive driver-executor — the seam that lets a SPAWNED child be a DRIVER, so
  * agents drive agents drive agents over the one keystone atom.
@@ -35,6 +34,8 @@
  * Layering: pure keystone composition. It reuses the scope's `NestedScopeSeam` + the shared
  * `SpawnJournal`; it builds NO new budget, journal, or selection logic. The recursion rides
  * the existing atom.
+ *
+ * @experimental
  */
 
 import { ValidationError } from '../../errors'
diff --git a/src/runtime/supervise/event-bus.ts b/src/runtime/supervise/event-bus.ts
index 26522496..5a7be78c 100644
--- a/src/runtime/supervise/event-bus.ts
+++ b/src/runtime/supervise/event-bus.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The child→parent message bus: the ONE pipe carrying every message a worker, sub-driver, or
  * analyst sends up to the driver — settled outputs, questions, and trace-analyst findings. It
@@ -20,6 +19,8 @@
  * the SAME publish/pull/subscribe surface backed by a durable mailbox on the parent's box (children
  * POST events with at-least-once retry; payloads are blob refs so the event stays small). Consumers
  * depend only on this interface, so distribution is a transport swap, never an architecture change.
+ *
+ * @experimental
  */
 
 /** Every bus event is a discriminated union member keyed by `type`. */
@@ -71,6 +72,7 @@ export interface EventBus<E extends BusEvent> {
   stats(): BusStats
 }
 
+/** Create the child→parent coordination bus: one typed pipe for settled outputs, questions, and analyst findings, with a priority-ordered pull queue and a pass-through subscribe lane. */
 export function createEventBus<E extends BusEvent>(now: () => number = Date.now): EventBus<E> {
   const queue: BusRecord<E>[] = []
   const log: BusRecord<E>[] = []
diff --git a/src/runtime/supervise/inbox.ts b/src/runtime/supervise/inbox.ts
index 6e32f30d..0de13105 100644
--- a/src/runtime/supervise/inbox.ts
+++ b/src/runtime/supervise/inbox.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The worker-side receive end of the down-leg: a per-worker inbox an executor exposes as
  * `Executor.deliver`. The driver's `steer_agent` / `answer_question` land here,
@@ -13,6 +12,8 @@
  *     of a wrong path mid-task instead of waiting for it to finish the step.
  *
  * `deliver` never throws — a malformed message is ignored, per the `Executor.deliver` contract.
+ *
+ * @experimental
  */
 
 export interface InboxMessage {
@@ -52,6 +53,7 @@ function parseDown(msg: unknown): InboxMessage | undefined {
   return undefined
 }
 
+/** Create the worker-side inbox for the down-leg: the driver's `steer_agent` / `answer_question` messages queue here and the worker's loop drains them at step boundaries and before settle. */
 export function createInbox(): Inbox {
   const pending: InboxMessage[] = []
   let live: AbortController | null = null
diff --git a/src/runtime/supervise/patch-checks.ts b/src/runtime/supervise/patch-checks.ts
index 4900f4d9..066be015 100644
--- a/src/runtime/supervise/patch-checks.ts
+++ b/src/runtime/supervise/patch-checks.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The mechanical patch gate — the SINGLE source of the no-op / always-on secret-path floor /
  * forbidden-path / diff-size / test / typecheck checks over a captured diff. No I/O: it scores a
@@ -8,6 +7,8 @@
  *
  * The always-on safety floors (no-op rejection + secret-path) are also exported standalone
  * (`isNonEmptyPatch` / `touchesSecretPath`) for reuse outside the full scorer.
+ *
+ * @experimental
  */
 
 import type { DefaultVerdict } from '../types'
@@ -82,7 +83,6 @@ export function touchesSecretPath(patch: string): string[] {
 }
 
 /**
- * @experimental
  *
  * The pure mechanical gate — the SINGLE source of the no-op / always-on secret-path floor /
  * diff-size / forbidden-path / test / typecheck checks. No I/O: it scores a patch + its
@@ -92,6 +92,8 @@ export function touchesSecretPath(patch: string): string[] {
  * `forbiddenPaths`), (3) forbidden-path, (4) diff-size cap, (5) tests, (6) typecheck.
  * Aggregate score: `0.5*tests + 0.3*typecheck + 0.2*(1 - diffLines/maxDiff)`; `valid` is the
  * conjunction of all six.
+ *
+ * @experimental
  */
 export function runCoderChecks(
   input: CoderCheckInput,
diff --git a/src/runtime/supervise/patch-deliverable.ts b/src/runtime/supervise/patch-deliverable.ts
index 6b22887c..b89d0c1a 100644
--- a/src/runtime/supervise/patch-deliverable.ts
+++ b/src/runtime/supervise/patch-deliverable.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `patchDelivered` — the mechanical patch gate as a generic `DeliverableSpec` over the worktree-CLI
  * artifact. It is one construction of a `DeliverableSpec` (a plain `check(artifact) => boolean`
@@ -17,6 +16,8 @@
  * (the executor's `testCmd`/`typecheckCmd` were omitted) the corresponding signal is treated as
  * passed UNLESS `require` lists it — so a gate that demands a tests-pass on an artifact that never
  * ran tests fails closed (the honest outcome) rather than passing on a missing signal.
+ *
+ * @experimental
  */
 
 import type { DeliverableSpec } from './completion-gate'
diff --git a/src/runtime/supervise/run-context.ts b/src/runtime/supervise/run-context.ts
index da604f30..d5b3f1d6 100644
--- a/src/runtime/supervise/run-context.ts
+++ b/src/runtime/supervise/run-context.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `createInMemoryRunContext` — the one-call bundle of the in-memory stores a
  * `createSupervisor().run(root, task, opts)` needs: a fresh `InMemorySpawnJournal`
@@ -21,6 +20,8 @@
  * The spread shape matches `SupervisorOpts` exactly, so the call site reads:
  *   const run = createInMemoryRunContext()
  *   await createSupervisor().run(root, task, { budget, runId, ...run })
+ *
+ * @experimental
  */
 
 import { InMemoryResultBlobStore, InMemorySpawnJournal } from '../../durable/spawn-journal'
diff --git a/src/runtime/supervise/runtime.ts b/src/runtime/supervise/runtime.ts
index 3020644b..d417cedd 100644
--- a/src/runtime/supervise/runtime.ts
+++ b/src/runtime/supervise/runtime.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The leaf runtime — the built-in `Executor` IMPLEMENTATIONS behind the ONE
  * open interface frozen in `./types`, plus the open resolver/registry that maps
@@ -21,6 +20,8 @@
  * Layering: `estimateCost`/`isModelPriced` are substrate primitives from
  * `@tangle-network/agent-eval`; `runLoop`/`acquireSandbox` are runtime kernels
  * from this package. No per-vendor adapters live here.
+ *
+ * @experimental
  */
 
 import { spawn } from 'node:child_process'
diff --git a/src/runtime/supervise/scope.ts b/src/runtime/supervise/scope.ts
index 5a1ad642..409dfe7c 100644
--- a/src/runtime/supervise/scope.ts
+++ b/src/runtime/supervise/scope.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The reactive `Scope` impl (KEYSTONE, build step 4 + the step-8 adapter).
  *
@@ -22,6 +21,8 @@
  * The settle path is the only writer of journal `settled` events; the spawn path the only
  * writer of `spawned` events. The result blob is `put` BEFORE the journal `settled` record
  * references its `outRef`, so a crash can never leave a journaled ref with no blob.
+ *
+ * @experimental
  */
 
 import { contentAddress } from '../../durable/spawn-journal'
@@ -189,6 +190,7 @@ function makeNestedScopeSeam(args: ScopeArgs, childNodeId: NodeId): NestedScopeS
   }
 }
 
+/** Create the reactive `Scope` a driver's `Agent.act` runs inside: spawn children on an atomically reserved conserved budget, settle via the `next()` cursor, journal for replay. */
 export function createScope<Out>(args: ScopeArgs): Scope<Out> {
   const children = new Map<NodeId, LiveChild>()
   // Two distinct monotonic counters in two namespaces:
diff --git a/src/runtime/supervise/supervise.ts b/src/runtime/supervise/supervise.ts
index 46fc8444..a991e364 100644
--- a/src/runtime/supervise/supervise.ts
+++ b/src/runtime/supervise/supervise.ts
@@ -113,6 +113,7 @@ function defaultPerWorker(budget: Budget): Budget {
   }
 }
 
+/** One-call supervisor: build + run a supervisor from its profile with sensible defaults; the raw `supervisorAgent` + `createSupervisor().run` seams stay available for power use. */
 export function supervise(profile: SupervisorProfile, task: unknown, opts: SuperviseOptions) {
   // Fail loud before any compute: every configured model must be in the allowed subset (no-op
   // when allowedModels is unset). The backend seam carries its own model on most backends.
diff --git a/src/runtime/supervise/supervisor-agent.ts b/src/runtime/supervise/supervisor-agent.ts
index 1d1cff9c..ec10cf0b 100644
--- a/src/runtime/supervise/supervisor-agent.ts
+++ b/src/runtime/supervise/supervisor-agent.ts
@@ -106,6 +106,7 @@ export interface SupervisorAgentDeps {
   readonly compaction?: ToolLoopCompactionOptions
 }
 
+/** Build a supervisor `Agent` from its profile: the brain resolves from `profile.harness` (backend-as-data), the same resolution rule as every worker. */
 export function supervisorAgent(
   profile: SupervisorProfile,
   deps: SupervisorAgentDeps,
diff --git a/src/runtime/supervise/supervisor.ts b/src/runtime/supervise/supervisor.ts
index a58facba..d5715146 100644
--- a/src/runtime/supervise/supervisor.ts
+++ b/src/runtime/supervise/supervisor.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The `Supervisor` impl (KEYSTONE, build step 5).
  *
@@ -31,6 +30,8 @@
  * winner `Out`. The supervisor content-addresses that `Out` for its replay `outRef`, reads
  * `spentTotal` off the journal (`settled` child work + `metered` driver inference), and wraps
  * it as a typed `winner` — it does not re-rank children behind the driver's back.
+ *
+ * @experimental
  */
 
 import { contentAddress } from '../../durable/spawn-journal'
diff --git a/src/runtime/supervise/trace-source.ts b/src/runtime/supervise/trace-source.ts
index 742043c3..a6aa4ec9 100644
--- a/src/runtime/supervise/trace-source.ts
+++ b/src/runtime/supervise/trace-source.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `TraceSource` — the ONE substrate-agnostic source of a worker's tool-call trace. The online
  * detectors and the settle-time analyzers consume agent-eval `ToolSpan`s from here, regardless of
@@ -15,6 +14,8 @@
  *
  * This module imports NO substrate SDK — it decodes generic message parts / OpenAI tool-call shapes.
  * The sandbox wiring (`sandboxSessionTraceSource`) is the thin adapter that feeds box session parts in.
+ *
+ * @experimental
  */
 
 import type { ToolSpan } from '@tangle-network/agent-eval'
diff --git a/src/runtime/supervise/trajectory-recorder.ts b/src/runtime/supervise/trajectory-recorder.ts
index 65dc479c..47840af0 100644
--- a/src/runtime/supervise/trajectory-recorder.ts
+++ b/src/runtime/supervise/trajectory-recorder.ts
@@ -1,11 +1,12 @@
 /**
- * @experimental
  *
  * The SETTLE-time analyst: when a worker finishes, collect its tool spans from a `TraceSource` and run
  * agent-eval's PUBLISHED batch analyzers over them — `buildTrajectory` (structured run summary),
  * `stuckLoopView` (full-run repeated-call view, complementing the online consecutive detector), and
  * `toolWasteView`. Substrate-agnostic: the spans come from any source (an owned loop's buffer OR a
  * sandbox box session). No analysis reimplemented — this is the thin bridge into agent-eval's analyzers.
+ *
+ * @experimental
  */
 
 import { buildTrajectory, InMemoryTraceStore } from '@tangle-network/agent-eval'
diff --git a/src/runtime/supervise/types.ts b/src/runtime/supervise/types.ts
index de727059..040ff7ee 100644
--- a/src/runtime/supervise/types.ts
+++ b/src/runtime/supervise/types.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Recursive execution atom — the FROZEN type surface (the keystone contract).
  *
@@ -22,6 +21,8 @@
  * Layering: substrate types (`DefaultVerdict`) come from `@tangle-network/agent-eval`;
  * runtime-shaped types (everything else) live here. Pure types/interfaces only — this
  * module typechecks standalone and is imported by every keystone impl.
+ *
+ * @experimental
  */
 
 import type { DefaultVerdict } from '@tangle-network/agent-eval'
diff --git a/src/runtime/supervise/worktree-cli-executor.ts b/src/runtime/supervise/worktree-cli-executor.ts
index 9da9778b..d13d7a39 100644
--- a/src/runtime/supervise/worktree-cli-executor.ts
+++ b/src/runtime/supervise/worktree-cli-executor.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * The worktree-CLI leaf executor — a supervisor-authored `AgentProfile` driving a local
  * coding-harness CLI (claude / codex / opencode) on its OWN git worktree, surfaced as the open
@@ -19,6 +18,8 @@
  * explicit, documented `budgetExempt` option rather than a buried hardcode: set it `false` ONLY for
  * a harness that genuinely surfaces real token/usd usage to meter into the pool — otherwise the
  * executor would meter a fabricated zero, which the no-silent-zeros rule forbids.
+ *
+ * @experimental
  */
 
 import { randomUUID } from 'node:crypto'
diff --git a/src/runtime/supervise/worktree-fanout.ts b/src/runtime/supervise/worktree-fanout.ts
index 725e38df..e58a3e7c 100644
--- a/src/runtime/supervise/worktree-fanout.ts
+++ b/src/runtime/supervise/worktree-fanout.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * `worktreeFanout` — the GENERIC coding combinator: a `fanout` of N supervisor-authored harness
  * profiles, each on its OWN worktree-CLI leaf, each `gateOnDeliverable(deliverable)`, winner via the
@@ -11,6 +10,8 @@
  * worktree-CLI executor + the injected deliverable + the diff-size selector) into the generic
  * combinator's `itemSpec`/`selectWinner` seams. Nothing here re-implements selection, gating, or
  * fanout — it composes the existing primitives.
+ *
+ * @experimental
  */
 
 import type { AgentProfile } from '@tangle-network/agent-interface'
diff --git a/src/runtime/types.ts b/src/runtime/types.ts
index bf7d47b8..15d90073 100644
--- a/src/runtime/types.ts
+++ b/src/runtime/types.ts
@@ -1,5 +1,4 @@
 /**
- * @experimental
  *
  * Driven-loop substrate — type surface.
  *
@@ -9,6 +8,8 @@
  * accounting, concurrency, abort propagation, cost aggregation, and trace
  * emission; the driver owns topology (plan + decide); the validator owns
  * output scoring; the output adapter owns event-stream → typed-output decode.
+ *
+ * @experimental
  */
 
 import type { DefaultVerdict } from '@tangle-network/agent-eval'
@@ -552,7 +553,11 @@ export interface LoopTeardownFailedPayload {
   reason: string
 }
 
-/** @experimental */
+/**
+ * Execution context for `runLoop`: the sandbox client the kernel creates boxes through, plus optional runtime hooks.
+ *
+ * @experimental
+ */
 export interface ExecCtx {
   /** Sandbox SDK client — the kernel calls `.create()` per iteration. */
   sandboxClient: SandboxClient
diff --git a/src/runtime/util.ts b/src/runtime/util.ts
index a9c869bd..08c0ac29 100644
--- a/src/runtime/util.ts
+++ b/src/runtime/util.ts
@@ -1,8 +1,9 @@
 /**
- * @experimental
  *
  * Internal loop-kernel utilities shared across the kernel, drivers, and the
  * sandbox-acquire layer. Not part of the public barrel surface.
+ *
+ * @experimental
  */
 
 import type { SandboxInstance } from '@tangle-network/sandbox'
diff --git a/src/runtime/verifier-environment.ts b/src/runtime/verifier-environment.ts
index 3c73d5fa..1a5b955f 100644
--- a/src/runtime/verifier-environment.ts
+++ b/src/runtime/verifier-environment.ts
@@ -64,6 +64,7 @@ const submitTool: AgenticTool = {
   },
 }
 
+/** Any checkable task as an `Environment`, no tool surface required: the artifact is the worker's answer and the domain is one deployable `check` over it. */
 export function createVerifierEnvironment(opts: VerifierEnvironmentOptions): Environment {
   if (opts.extraTools?.length && !opts.callExtra) {
     throw new Error(`${opts.name}: extraTools requires callExtra`)
diff --git a/src/runtime/workspace.ts b/src/runtime/workspace.ts
index 569aa66a..57111a99 100644
--- a/src/runtime/workspace.ts
+++ b/src/runtime/workspace.ts
@@ -15,6 +15,7 @@ export interface Workspace {
   head(): Promise<string>
 }
 
+/** Host-process `Shell`: run a command via `execFile`, resolving `{ stdout, stderr, code }` (never throws on non-zero exit). */
 export function localShell(): Shell {
   return async (args, cwd) => {
     const { execFile } = await import('node:child_process')
@@ -43,6 +44,7 @@ export interface GitWorkspaceOptions {
   readonly noHooks?: boolean
 }
 
+/** A `Workspace` over a git checkout: materialize an isolated worktree at `ref`, commit produced changes (conflict-aware), and read `head` — hooks disabled, identity pinned. */
 export function gitWorkspace(opts: GitWorkspaceOptions): Workspace {
   const shell = opts.shell ?? localShell()
   const branch = opts.branch ?? 'main'
diff --git a/src/sanitize.ts b/src/sanitize.ts
index 6adeadce..05d20149 100644
--- a/src/sanitize.ts
+++ b/src/sanitize.ts
@@ -1,10 +1,11 @@
 /**
- * @stable
  *
  * Sanitization for runtime telemetry. The rule: nothing user-controlled leaks
  * unless the caller opts in with a `RuntimeTelemetryOptions` flag. This is the
  * envelope that ends up in `agent_run.metadata.runtimeEvents` on every
  * consumer, so the default must be safe.
+ *
+ * @stable
  */
 
 import type {
@@ -545,7 +546,6 @@ export function createRuntimeEventCollector<
 }
 
 /**
- * @stable
  *
  * Streaming-event counterpart of `createRuntimeEventCollector`. Pass each
  * event yielded by `runAgentTaskStream` through `onEvent` and read the
@@ -553,6 +553,8 @@ export function createRuntimeEventCollector<
  * flags apply. Kept distinct from `createRuntimeEventCollector` because the
  * stream and non-stream event shapes overlap on `type` literals — dispatching
  * on `type` alone would misroute events.
+ *
+ * @stable
  */
 export function createRuntimeStreamEventCollector(
   options: RuntimeTelemetryOptions = {},
diff --git a/src/sessions.ts b/src/sessions.ts
index 403e3b63..8f43e2a8 100644
--- a/src/sessions.ts
+++ b/src/sessions.ts
@@ -1,10 +1,11 @@
 /**
- * @stable
  *
  * Session helpers + an in-memory `RuntimeSessionStore` implementation suitable
  * for tests, scratch processes, and per-request scratch storage in serverless
  * runtimes. Durable stores (D1, postgres, Durable Objects) implement the same
  * interface from `./types`.
+ *
+ * @stable
  */
 
 import type { RuntimeSession, RuntimeSessionStore, RuntimeStreamEvent } from './types'
diff --git a/src/sse.ts b/src/sse.ts
index 98276f3d..8ede945a 100644
--- a/src/sse.ts
+++ b/src/sse.ts
@@ -1,5 +1,4 @@
 /**
- * @stable
  *
  * Server-Sent Events serialization for runtime telemetry streams.
  *
@@ -7,6 +6,8 @@
  * a space (browsers terminate fields on newline), and multi-line `data`
  * payloads are split into one `data:` line per source line so JSON.stringify
  * output transports cleanly.
+ *
+ * @stable
  */
 
 import type { KnowledgeReadinessReport } from '@tangle-network/agent-eval'
diff --git a/src/types.ts b/src/types.ts
index cff1ae85..7d767cea 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -1,11 +1,12 @@
 /**
- * @stable
  *
  * Core task, session, adapter, and stream-event types for the runtime.
  *
  * This module owns the public shape of every cross-cutting record (`TaskSpec`,
  * `RuntimeSession`, `RuntimeStreamEvent`). Everything else in the runtime
  * imports from here so type-level changes ripple in one place.
+ *
+ * @stable
  */
 
 import type {
@@ -193,7 +194,6 @@ export type AgentRuntimeEventSink<
 > = (event: AgentRuntimeEvent<TState, TAction, TActionResult, TEval>) => Promise<void> | void
 
 /**
- * @stable
  *
  * Typed transport / backend failure detail. Carried on `backend_error` and
  * `final` events when the backend's stream throws or the upstream HTTP call
@@ -206,6 +206,8 @@ export type AgentRuntimeEventSink<
  * misconfigured proxy never bloats event payloads or logs. Consumers needing
  * the full body should inspect the underlying `BackendTransportError.body`
  * via a custom `mapEvent` or backend wrapper.
+ *
+ * @stable
  */
 export interface BackendErrorDetail {
   /**
@@ -222,7 +224,6 @@ export interface BackendErrorDetail {
 }
 
 /**
- * @stable
  *
  * OpenAI Chat Completions tool descriptor. The shape mirrors the
  * `/v1/chat/completions` `tools[]` parameter so callers can pass tool
@@ -235,6 +236,8 @@ export interface BackendErrorDetail {
  * MCP `tools/list` at config time and project the result into this shape. The
  * runtime intentionally does NOT depend on `@modelcontextprotocol/sdk` —
  * keeping the backend transport thin lets domain repos own MCP plumbing.
+ *
+ * @stable
  */
 export interface OpenAIChatTool {
   type: 'function'
@@ -246,12 +249,13 @@ export interface OpenAIChatTool {
 }
 
 /**
- * @stable
  *
  * `tool_choice` parameter for OpenAI-compat chat. Same shape as the OpenAI
  * spec: `'auto'` (default — model decides), `'none'` (disable tool calling
  * for this turn), `'required'` (force a tool call), or a specific function
  * pin `{ type: 'function', function: { name } }`.
+ *
+ * @stable
  */
 export type OpenAIChatToolChoice =
   | 'auto'
@@ -260,11 +264,12 @@ export type OpenAIChatToolChoice =
   | { type: 'function'; function: { name: string } }
 
 /**
- * @stable
  *
  * `response_format` parameter for OpenAI-compatible chat endpoints. Use
  * `json_object` when the caller needs syntactically valid JSON, or
  * `json_schema` when the upstream provider supports schema-constrained JSON.
+ *
+ * @stable
  */
 export type OpenAIChatResponseFormat =
   | { type: 'text' }