npm - @morlay/dsh-subagent - Versions diffs - 0.0.8 → 0.0.10 - Mend

@morlay/dsh-subagent 0.0.8 → 0.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.mts +9 -9
package/package.json +1 -1
package/src/continuation-messages.ts +68 -59
package/src/index.ts +262 -189
package/src/manager.ts +886 -716

package/src/manager.ts CHANGED Viewed

@@ -6,103 +6,148 @@
  * @module @deepseek-ai/dsh-subagent/manager
  */
-import { randomUUID } from 'node:crypto'
-import { isAbsolute, resolve } from 'node:path'
-import type {} from '@deepseek-ai/dsh-working-directory'
-import type { Context } from '@deepseek-ai/cordis'
-import type { Agent, AgentOptions, CreateAgentOptions } from '@deepseek-ai/dsh-agent'
-import { brandString } from '@deepseek-ai/dsh-brand'
-import { ReasoningEffortId, contentHasImage, createUserMessage, errorChain } from '@deepseek-ai/dsh-llm'
-import type { ContentBlock, MessageId, MessageSource } from '@deepseek-ai/dsh-llm'
-import { SessionLogOffset } from '@deepseek-ai/dsh-session'
-import type { SessionId, SessionEvent, UserMessage } from '@deepseek-ai/dsh-session'
-import type { SessionPersistence } from '@deepseek-ai/dsh-session-persistence'
-import type { SessionObservation, SessionQueryEngine } from '@deepseek-ai/dsh-session-query'
-import type { ObjectJsonSchema } from '@deepseek-ai/dsh-tools'
+import { randomUUID } from "node:crypto";
+import { isAbsolute, resolve } from "node:path";
+import type {} from "@deepseek-ai/dsh-working-directory";
+import type { Context } from "@deepseek-ai/cordis";
+import type { Agent, AgentOptions, CreateAgentOptions } from "@deepseek-ai/dsh-agent";
+import { brandString } from "@deepseek-ai/dsh-brand";
 import {
-  appendDelegatedPolicyOverrides, applyChildComposition, captureDelegatedPolicyOverrides,
-  childSessionMeta, resolveChildAgentOptions, resolveChildDepth,
-} from './vendor/dsh-subagent/child-agent.ts'
-import type { ChildComposition, DelegatedPolicyOverrides } from './vendor/dsh-subagent/child-agent.ts'
-import { createAgentMessage, localizedReturnGuidance, withContinuableReturnGuidance, createSettlementMessage } from './continuation-messages.ts'
+  ReasoningEffortId,
+  contentHasImage,
+  createUserMessage,
+  errorChain,
+} from "@deepseek-ai/dsh-llm";
+import type { ContentBlock, MessageId, MessageSource } from "@deepseek-ai/dsh-llm";
+import { SessionLogOffset } from "@deepseek-ai/dsh-session";
+import type { SessionId, SessionEvent, UserMessage } from "@deepseek-ai/dsh-session";
+import type { SessionPersistence } from "@deepseek-ai/dsh-session-persistence";
+import type { SessionObservation, SessionQueryEngine } from "@deepseek-ai/dsh-session-query";
+import type { ObjectJsonSchema } from "@deepseek-ai/dsh-tools";
+import {
+  appendDelegatedPolicyOverrides,
+  applyChildComposition,
+  captureDelegatedPolicyOverrides,
+  childSessionMeta,
+  resolveChildAgentOptions,
+  resolveChildDepth,
+} from "./vendor/dsh-subagent/child-agent.ts";
+import type {
+  ChildComposition,
+  DelegatedPolicyOverrides,
+} from "./vendor/dsh-subagent/child-agent.ts";
+import {
+  createAgentMessage,
+  localizedReturnGuidance,
+  withContinuableReturnGuidance,
+  createSettlementMessage,
+} from "./continuation-messages.ts";
 // 会话不在本部署名单里时用上游那一份（英文）：文案跟着 preset 走，不是整进程只有一份。
-import { withContinuableReturnGuidance as upstreamWithContinuableReturnGuidance } from './vendor/dsh-subagent/continuation-messages.ts'
-import { assertSubagentMaxDepth } from './vendor/dsh-subagent/depth.ts'
-import { foldSubagentDescriptor, snapshotSubagentDescriptor } from './vendor/dsh-subagent/descriptor.ts'
-import type { SubagentDescriptorData } from './vendor/dsh-subagent/descriptor.ts'
-import { establishCatalogChild, establishExternalCatalogChild } from './vendor/dsh-subagent/catalog.ts'
-import { SubagentError } from './vendor/dsh-subagent/error.ts'
-import { isAdjacentAgentSendMessageTool } from './vendor/dsh-subagent/internal.ts'
-import type { ActivationObserver } from './vendor/dsh-subagent/lifecycle.ts'
+import { withContinuableReturnGuidance as upstreamWithContinuableReturnGuidance } from "./vendor/dsh-subagent/continuation-messages.ts";
+import { assertSubagentMaxDepth } from "./vendor/dsh-subagent/depth.ts";
+import {
+  foldSubagentDescriptor,
+  snapshotSubagentDescriptor,
+} from "./vendor/dsh-subagent/descriptor.ts";
+import type { SubagentDescriptorData } from "./vendor/dsh-subagent/descriptor.ts";
+import {
+  establishCatalogChild,
+  establishExternalCatalogChild,
+} from "./vendor/dsh-subagent/catalog.ts";
+import { SubagentError } from "./vendor/dsh-subagent/error.ts";
+import { isAdjacentAgentSendMessageTool } from "./vendor/dsh-subagent/internal.ts";
+import type { ActivationObserver } from "./vendor/dsh-subagent/lifecycle.ts";
 import type {
-  ContinuableCreateRequest, ContinuableCreateSpec, SubagentInterruptAuthority,
-  SubagentActivationSpec, SubagentActivation, SubagentStartRequest, SubagentRun,
-  SubagentSendMessageOptions, SubagentResult, ResolvedSubagentStartRequest,
-} from './vendor/dsh-subagent/types.ts'
-import { attachStructuredRuntime } from './vendor/dsh-subagent/structured.ts'
-import type { StructuredAttachment } from './vendor/dsh-subagent/structured.ts'
-import type { SubagentDelivery } from './vendor/dsh-subagent/control-types.ts'
-import { ActivationPool, ChildLock, activationAgent, captureLocalResult, observeLocalFailure, requireLocalActivation } from './vendor/dsh-subagent/activation.ts'
-import type { Activation, ActivationResource, LocalActivation } from './vendor/dsh-subagent/activation.ts'
+  ContinuableCreateRequest,
+  ContinuableCreateSpec,
+  SubagentInterruptAuthority,
+  SubagentActivationSpec,
+  SubagentActivation,
+  SubagentStartRequest,
+  SubagentRun,
+  SubagentSendMessageOptions,
+  SubagentResult,
+  ResolvedSubagentStartRequest,
+} from "./vendor/dsh-subagent/types.ts";
+import { attachStructuredRuntime } from "./vendor/dsh-subagent/structured.ts";
+import type { StructuredAttachment } from "./vendor/dsh-subagent/structured.ts";
+import type { SubagentDelivery } from "./vendor/dsh-subagent/control-types.ts";
+import {
+  ActivationPool,
+  ChildLock,
+  activationAgent,
+  captureLocalResult,
+  observeLocalFailure,
+  requireLocalActivation,
+} from "./vendor/dsh-subagent/activation.ts";
+import type {
+  Activation,
+  ActivationResource,
+  LocalActivation,
+} from "./vendor/dsh-subagent/activation.ts";
 /** Inputs shared by model steering and human prompt delivery. */
 type ChildDeliveryOptions =
   | {
-    readonly delivery: 'steer'
-    /**
-     * A provided host source is preserved on the user message; omission attributes
-     * an adjacent-Agent message to the parent.
-     */
-    readonly source?: MessageSource
-    readonly signal: AbortSignal
-  }
-  | { readonly delivery: 'queue'; readonly source: MessageSource; readonly signal: AbortSignal }
+      readonly delivery: "steer";
+      /**
+       * A provided host source is preserved on the user message; omission attributes
+       * an adjacent-Agent message to the parent.
+       */
+      readonly source?: MessageSource;
+      readonly signal: AbortSignal;
+    }
+  | { readonly delivery: "queue"; readonly source: MessageSource; readonly signal: AbortSignal };
 /** Package-private hooks supplied by the owning service. */
 interface SubagentHost {
-  startExternal(name: string, request: ResolvedSubagentStartRequest): Promise<SubagentRun>
+  startExternal(name: string, request: ResolvedSubagentStartRequest): Promise<SubagentRun>;
   /** Resolve one provider's detached continuable-creation contribution. */
-  prepareContinuable(name: string, request: ContinuableCreateRequest): Promise<ContinuableCreateSpec>
+  prepareContinuable(
+    name: string,
+    request: ContinuableCreateRequest,
+  ): Promise<ContinuableCreateSpec>;
   /** Build the lifecycle observer for one Activation residency epoch. */
-  observeActivation(provider: string, childId: SessionId, parent: Agent): ActivationObserver
+  observeActivation(provider: string, childId: SessionId, parent: Agent): ActivationObserver;
 }
 /** Inputs shared by fresh and resumed Activation materialization. */
 interface MaterializeBase {
-  childId: SessionId
-  provider: string
-  parent: Agent
-  signal: AbortSignal
-  delivery?: 'parent' | 'caller' | undefined
+  childId: SessionId;
+  provider: string;
+  parent: Agent;
+  signal: AbortSignal;
+  delivery?: "parent" | "caller" | undefined;
 }
 /** Creation inputs for a local residency or one external backend execution. */
-type MaterializeInputs = MaterializeBase & (
-  | {
-    kind: 'local'
-    /**
-     * Creation inputs; absent for a cold resume, which loads the persisted
-     * session — including the delegation policy events a fresh creation seeded,
-     * so a resume never re-captures the parent's policy.
-     */
-    create?: {
-      /** Absolute initial directory captured before provider preparation. */
-      cwd: string
-      seed: readonly SessionEvent[] | undefined
-      meta: NonNullable<CreateAgentOptions['meta']>
-      /** Exact parent-log prefix length inside {@link seed}. */
-      inheritedEventCount: SessionLogOffset
-      /** Policy captured at delegation: the parent's sandbox override plus the approval pin. */
-      delegatedPolicies: DelegatedPolicyOverrides
-      /** Child-owned composition record appended after the inherited marker. */
-      descriptor: SubagentDescriptorData
-    }
-    agentOptions: AgentOptions
-    composition: ChildComposition
-    outputSchema?: ObjectJsonSchema | undefined
-  }
-  | { kind: 'external'; start: (signal: AbortSignal) => Promise<SubagentRun> }
-)
+type MaterializeInputs = MaterializeBase &
+  (
+    | {
+        kind: "local";
+        /**
+         * Creation inputs; absent for a cold resume, which loads the persisted
+         * session — including the delegation policy events a fresh creation seeded,
+         * so a resume never re-captures the parent's policy.
+         */
+        create?: {
+          /** Absolute initial directory captured before provider preparation. */
+          cwd: string;
+          seed: readonly SessionEvent[] | undefined;
+          meta: NonNullable<CreateAgentOptions["meta"]>;
+          /** Exact parent-log prefix length inside {@link seed}. */
+          inheritedEventCount: SessionLogOffset;
+          /** Policy captured at delegation: the parent's sandbox override plus the approval pin. */
+          delegatedPolicies: DelegatedPolicyOverrides;
+          /** Child-owned composition record appended after the inherited marker. */
+          descriptor: SubagentDescriptorData;
+        };
+        agentOptions: AgentOptions;
+        composition: ChildComposition;
+        outputSchema?: ObjectJsonSchema | undefined;
+      }
+    | { kind: "external"; start: (signal: AbortSignal) => Promise<SubagentRun> }
+  );
 /**
  * One admitted materialization and the exact live ancestry observed at its
@@ -110,44 +155,42 @@ type MaterializeInputs = MaterializeBase & (
  * keep waiting even if an intermediate Agent leaves the registry meanwhile.
  */
 interface Materialization {
-  readonly lineage: readonly Agent[]
-  readonly settled: Promise<void>
-  readonly controller: AbortController
+  readonly lineage: readonly Agent[];
+  readonly settled: Promise<void>;
+  readonly controller: AbortController;
 }
 /** Residency state observed by the natural-settlement watcher. */
-type SettlementState = 'closed' | 'retry' | 'wait' | 'ready'
+type SettlementState = "closed" | "retry" | "wait" | "ready";
 /** Result of the final child-lock settlement decision. */
-type SettlementAttempt =
-  | Exclude<SettlementState, 'ready'>
-  | { readonly done: Promise<void> }
+type SettlementAttempt = Exclude<SettlementState, "ready"> | { readonly done: Promise<void> };
 /** Render only the safe outer message from execution or teardown failures. */
 function failureMessage(error: unknown): string {
-  return error instanceof Error ? error.message : 'unknown teardown failure'
+  return error instanceof Error ? error.message : "unknown teardown failure";
 }
 /** Own subagent requests and the resources of every live activation. */
 export class SubagentManager {
   /** Child session id → its live Activation. Process-local, never durable. */
-  private readonly resident = new Map<SessionId, Activation>()
+  private readonly resident = new Map<SessionId, Activation>();
   /** Root identities retain their pool across child settlement without retaining dead roots. */
-  private readonly rootPools = new WeakMap<Agent, ActivationPool>()
+  private readonly rootPools = new WeakMap<Agent, ActivationPool>();
   /** Materializations admitted before drain, tracked through publication or rollback. */
-  private readonly materializations = new Set<Materialization>()
+  private readonly materializations = new Set<Materialization>();
   /** Per-child serializer shared by delivery, release, and disposal. */
-  private readonly locks = new ChildLock()
+  private readonly locks = new ChildLock();
   /** Structural Cordis owner of every Activation handle. */
-  private readonly ownerCtx: Context
+  private readonly ownerCtx: Context;
   /**
    * Exact roots whose host teardown has begun, with the live lineage members
    * observed under each root. Entries remain until that exact root leaves the
    * Agent registry, closing admission throughout its host's teardown without
    * poisoning a later same-id replacement.
    */
-  private readonly closingScopes = new Map<Agent, Set<Agent>>()
-  private draining = false
+  private readonly closingScopes = new Map<Agent, Set<Agent>>();
+  private draining = false;
   /**
    * Build one manager inside the service's Agent-injected context.
@@ -167,15 +210,18 @@ export class SubagentManager {
     // the drain before releasing the scope; a cleanup effect on the same scope
     // as the Agent handles would let structural handle disposal bypass
     // child-first ordering.
-    const scope = ctx.plugin(function activationOwner() {})
-    this.ownerCtx = scope.ctx
-    ctx.on('agent/disposed', ({ agent }) => {
-      this.closingScopes.delete(agent)
-    })
-    ctx.effect(function* (this: SubagentManager) {
-      yield scope.dispose
-      yield () => this.drain()
-    }.bind(this), 'subagents.manager()')
+    const scope = ctx.plugin(function activationOwner() {});
+    this.ownerCtx = scope.ctx;
+    ctx.on("agent/disposed", ({ agent }) => {
+      this.closingScopes.delete(agent);
+    });
+    ctx.effect(
+      function* (this: SubagentManager) {
+        yield scope.dispose;
+        yield () => this.drain();
+      }.bind(this),
+      "subagents.manager()",
+    );
   }
   /**
@@ -183,50 +229,44 @@ export class SubagentManager {
    * @param targetSessionId - the durable child session id to interrupt.
    * @param authority - the human parent address or exact live ancestor Agent.
    */
-  interrupt(
-    targetSessionId: SessionId,
-    authority: SubagentInterruptAuthority,
-  ): void {
-    if (authority.kind === 'ancestor') {
-      const caller = authority.agent
+  interrupt(targetSessionId: SessionId, authority: SubagentInterruptAuthority): void {
+    if (authority.kind === "ancestor") {
+      const caller = authority.agent;
       if (this.ctx.agents.get(caller.id) !== caller) {
         throw new SubagentError(
           `interrupting "${targetSessionId}" requires the exact live ancestor agent`,
-          'UNAUTHORIZED',
-        )
+          "UNAUTHORIZED",
+        );
       }
       if (caller.id === targetSessionId) {
-        throw new SubagentError(
-          `agent "${caller.id}" cannot interrupt itself`,
-          'UNAUTHORIZED',
-        )
+        throw new SubagentError(`agent "${caller.id}" cannot interrupt itself`, "UNAUTHORIZED");
       }
     }
-    const activation = this.resident.get(targetSessionId)
-    if (activation === undefined) return
-    if (authority.kind === 'user') {
+    const activation = this.resident.get(targetSessionId);
+    if (activation === undefined) return;
+    if (authority.kind === "user") {
       if (activation.parent.id !== authority.parentSessionId) {
         throw new SubagentError(
           `subagent "${targetSessionId}" belongs to another parent session`,
-          'UNAUTHORIZED',
-        )
+          "UNAUTHORIZED",
+        );
       }
     } else if (!activation.ancestry.has(authority.agent)) {
       throw new SubagentError(
         `subagent "${targetSessionId}" is not a live descendant of agent "${authority.agent.id}"`,
-        'UNAUTHORIZED',
-      )
+        "UNAUTHORIZED",
+      );
     }
     // Disposal already stopped the target with a whole-Activation teardown;
     // a second cancel would be a redundant signal on a closing handle.
-    if (activation.closing !== undefined) return
-    const kind = authority.kind === 'user' ? 'user' : 'parent'
-    if (activation.kind === 'local') {
-      activation.handle.agent.cancel({ kind }, { keepInbox: true })
+    if (activation.closing !== undefined) return;
+    const kind = authority.kind === "user" ? "user" : "parent";
+    if (activation.kind === "local") {
+      activation.handle.agent.cancel({ kind }, { keepInbox: true });
     } else {
-      activation.controller.abort({ kind })
+      activation.controller.abort({ kind });
       // The settlement observer reports teardown failures.
-      void this.dispose(activation).catch(() => undefined)
+      void this.dispose(activation).catch(() => undefined);
     }
   }
@@ -236,15 +276,17 @@ export class SubagentManager {
    * child-first.
    */
   async drain(): Promise<void> {
-    this.draining = true
-    for (const pending of this.materializations) pending.controller.abort()
-    await Promise.all([...this.materializations].map(materialization => materialization.settled))
-    const owned = new Set<SessionId>()
+    this.draining = true;
+    for (const pending of this.materializations) pending.controller.abort();
+    await Promise.all([...this.materializations].map((materialization) => materialization.settled));
+    const owned = new Set<SessionId>();
     for (const activation of this.resident.values()) {
-      for (const child of activation.ownedChildren) owned.add(child)
+      for (const child of activation.ownedChildren) owned.add(child);
     }
-    const roots = [...this.resident.values()].filter(activation => !owned.has(activation.childId))
-    await this.disposeRoots(roots, 'activation(s)')
+    const roots = [...this.resident.values()].filter(
+      (activation) => !owned.has(activation.childId),
+    );
+    await this.disposeRoots(roots, "activation(s)");
   }
   /**
@@ -253,42 +295,62 @@ export class SubagentManager {
    * @returns whether work was joined and the host must recheck parent completion.
    */
   async waitForChildren(parent: Agent): Promise<boolean> {
-    let observed = false
+    let observed = false;
     while (true) {
-      const pending = [...this.materializations].filter(item => item.lineage.includes(parent))
-      const children = [...this.resident.values()].filter(item => activationAgent(item) !== parent && item.ancestry.has(parent))
-      observed ||= children.some(item => item.kind === 'local' && item.handle.agent.status !== 'idle')
-      await Promise.all(children.flatMap(item => item.kind === 'local' ? [item.handle.agent.whenIdle()] : []))
-      const waits: Promise<unknown>[] = pending.map(item => item.settled)
+      const pending = [...this.materializations].filter((item) => item.lineage.includes(parent));
+      const children = [...this.resident.values()].filter(
+        (item) => activationAgent(item) !== parent && item.ancestry.has(parent),
+      );
+      observed ||= children.some(
+        (item) => item.kind === "local" && item.handle.agent.status !== "idle",
+      );
+      await Promise.all(
+        children.flatMap((item) => (item.kind === "local" ? [item.handle.agent.whenIdle()] : [])),
+      );
+      const waits: Promise<unknown>[] = pending.map((item) => item.settled);
       for (const item of children) {
-        if (item.kind === 'external' || item.closing !== undefined) {
-          waits.push(item.result.promise.catch(() => undefined))
-          continue
+        if (item.kind === "external" || item.closing !== undefined) {
+          waits.push(item.result.promise.catch(() => undefined));
+          continue;
         }
-        if (item.handle.agent.status !== 'idle') {
-          waits.push(item.handle.agent.whenIdle())
-          continue
+        if (item.handle.agent.status !== "idle") {
+          waits.push(item.handle.agent.whenIdle());
+          continue;
         }
         if (item.ownedChildren.size > 0) {
           // Published descendants are observed separately; preparation holds
           // keep the owner pending until publication or rollback wakes it.
-          if ([...item.ownedChildren].some(id => !this.resident.has(id))) waits.push(item.poke.promise)
-          continue
+          if ([...item.ownedChildren].some((id) => !this.resident.has(id)))
+            waits.push(item.poke.promise);
+          continue;
         }
-        const inbox = item.handle.agent.inbox
-        if (item.failureAt === undefined && (inbox.nextTurn.length > 0 || inbox.nextStep.length > 0)) continue
-        waits.push(Promise.race([item.result.promise.catch(() => undefined), item.poke.promise]))
+        const inbox = item.handle.agent.inbox;
+        if (
+          item.failureAt === undefined &&
+          (inbox.nextTurn.length > 0 || inbox.nextStep.length > 0)
+        )
+          continue;
+        waits.push(Promise.race([item.result.promise.catch(() => undefined), item.poke.promise]));
       }
       if (waits.length > 0) {
-        observed = true
-        await Promise.all(waits)
-        continue
+        observed = true;
+        await Promise.all(waits);
+        continue;
       }
       // A descendant can be published while whenIdle follows another child.
-      if ([...this.materializations].some(item => item.lineage.includes(parent) && !pending.includes(item))
-        || [...this.resident.values()].some(item => activationAgent(item) !== parent
-          && item.ancestry.has(parent) && !children.includes(item))) continue
-      return observed
+      if (
+        [...this.materializations].some(
+          (item) => item.lineage.includes(parent) && !pending.includes(item),
+        ) ||
+        [...this.resident.values()].some(
+          (item) =>
+            activationAgent(item) !== parent &&
+            item.ancestry.has(parent) &&
+            !children.includes(item),
+        )
+      )
+        continue;
+      return observed;
     }
   }
@@ -297,50 +359,49 @@ export class SubagentManager {
    * @param parents - exact live roots whose managed descendants must stop.
    */
   async drainDescendants(parents: readonly Agent[]): Promise<void> {
-    const roots = new Set(parents.filter(parent => this.ctx.agents.get(parent.id) === parent))
-    if (roots.size === 0) return
+    const roots = new Set(parents.filter((parent) => this.ctx.agents.get(parent.id) === parent));
+    if (roots.size === 0) return;
     for (const root of roots) {
-      this.closingMembers(root).add(root)
+      this.closingMembers(root).add(root);
     }
-    const targets: Activation[] = []
+    const targets: Activation[] = [];
     for (const activation of this.resident.values()) {
-      const child = activationAgent(activation)
-      const lineage = this.liveLineage(child ?? activation.parent)
-      const owners = [...roots].filter(root => child !== root
-        && activation.ancestry.has(root))
-      if (owners.length === 0) continue
-      targets.push(activation)
+      const child = activationAgent(activation);
+      const lineage = this.liveLineage(child ?? activation.parent);
+      const owners = [...roots].filter((root) => child !== root && activation.ancestry.has(root));
+      if (owners.length === 0) continue;
+      targets.push(activation);
       for (const owner of owners) {
-        const members = this.closingMembers(owner)
-        if (child !== undefined) members.add(child)
-        for (const agent of lineage) members.add(agent)
+        const members = this.closingMembers(owner);
+        if (child !== undefined) members.add(child);
+        for (const agent of lineage) members.add(agent);
       }
     }
     const materializations = [...this.materializations].filter((materialization) => {
-      const owners = [...roots].filter(root => materialization.lineage.includes(root))
+      const owners = [...roots].filter((root) => materialization.lineage.includes(root));
       for (const owner of owners) {
-        const members = this.closingMembers(owner)
-        for (const agent of materialization.lineage) members.add(agent)
+        const members = this.closingMembers(owner);
+        for (const agent of materialization.lineage) members.add(agent);
       }
-      if (owners.length > 0) materialization.controller.abort()
-      return owners.length > 0
-    })
+      if (owners.length > 0) materialization.controller.abort();
+      return owners.length > 0;
+    });
-    const ownedTargets = new Set<SessionId>()
+    const ownedTargets = new Set<SessionId>();
     for (const activation of targets) {
-      for (const child of activation.ownedChildren) ownedTargets.add(child)
+      for (const child of activation.ownedChildren) ownedTargets.add(child);
     }
-    const targetRoots = targets.filter(activation => !ownedTargets.has(activation.childId))
+    const targetRoots = targets.filter((activation) => !ownedTargets.has(activation.childId));
     for (const activation of targets) {
-      const disposal = this.dispose(activation)
-      void disposal.catch(() => undefined)
+      const disposal = this.dispose(activation);
+      void disposal.catch(() => undefined);
     }
-    await Promise.all(materializations.map(materialization => materialization.settled))
-    await this.disposeRoots(targetRoots, 'scoped activation(s)')
+    await Promise.all(materializations.map((materialization) => materialization.settled));
+    await this.disposeRoots(targetRoots, "scoped activation(s)");
   }
   /**
@@ -350,26 +411,29 @@ export class SubagentManager {
    */
   async drainChildren(parent: Agent, childIds: readonly SessionId[]): Promise<void> {
     if (this.ctx.agents.get(parent.id) !== parent) {
-      throw new SubagentError('selected child teardown requires the exact live parent agent', 'UNAUTHORIZED')
+      throw new SubagentError(
+        "selected child teardown requires the exact live parent agent",
+        "UNAUTHORIZED",
+      );
     }
-    const targets: Activation[] = []
+    const targets: Activation[] = [];
     for (const childId of new Set(childIds)) {
-      const activation = this.resident.get(childId)
-      if (activation === undefined) continue
+      const activation = this.resident.get(childId);
+      if (activation === undefined) continue;
       if (activation.parent.id !== parent.id || !activation.ancestry.has(parent)) {
         throw new SubagentError(
           `subagent "${childId}" is not a direct child of agent "${parent.id}"`,
-          'UNAUTHORIZED',
-        )
+          "UNAUTHORIZED",
+        );
       }
-      targets.push(activation)
+      targets.push(activation);
     }
     for (const activation of targets) {
-      const disposal = this.dispose(activation)
-      void disposal.catch(() => undefined)
+      const disposal = this.dispose(activation);
+      void disposal.catch(() => undefined);
     }
-    await this.disposeRoots(targets, 'selected activation(s)')
+    await this.disposeRoots(targets, "selected activation(s)");
   }
   /**
@@ -379,73 +443,81 @@ export class SubagentManager {
    * @param spec - provider, delegation request, and caller cancellation.
    * @returns the durable child id and accepted initial prompt message id.
    */
-  async startLocal(spec: SubagentActivationSpec): Promise<SubagentActivation & { messageId: MessageId }> {
-    const request = spec.request
-    const parent = request.parent
-    this.assertAdmitting(parent)
-    const persistence = spec.delivery === 'caller' ? this.ctx.get('sessionPersistence') : this.requirePersistence()
-    assertSubagentMaxDepth(request.maxDepth)
-    const childId = spec.childId ?? brandString<SessionId>(randomUUID())
-    this.assertChildIdAvailable(childId)
-    const childDepth = resolveChildDepth(parent, request.maxDepth)
+  async startLocal(
+    spec: SubagentActivationSpec,
+  ): Promise<SubagentActivation & { messageId: MessageId }> {
+    const request = spec.request;
+    const parent = request.parent;
+    this.assertAdmitting(parent);
+    const persistence =
+      spec.delivery === "caller" ? this.ctx.get("sessionPersistence") : this.requirePersistence();
+    assertSubagentMaxDepth(request.maxDepth);
+    const childId = spec.childId ?? brandString<SessionId>(randomUUID());
+    this.assertChildIdAvailable(childId);
+    const childDepth = resolveChildDepth(parent, request.maxDepth);
     // Snapshot before any await: invalid descriptor JSON rejects the call
     // before a child exists, and the detached value is what reaches the log.
-    const agentOptions = resolveChildAgentOptions(parent, request.agentOptions, childDepth)
-    const agentProvider = agentOptions.provider
-    const agentModel = agentOptions.model
-    const agentReasoningEffort = agentOptions.reasoningEffort
+    const agentOptions = resolveChildAgentOptions(parent, request.agentOptions, childDepth);
+    const agentProvider = agentOptions.provider;
+    const agentModel = agentOptions.model;
+    const agentReasoningEffort = agentOptions.reasoningEffort;
     const descriptor = snapshotSubagentDescriptor({
-      mode: 'continuable',
+      mode: "continuable",
       provider: spec.provider,
       label: spec.label,
-      ...agentProvider !== undefined ? { agentProvider } : {},
-      ...agentModel !== undefined ? { agentModel } : {},
-      ...agentReasoningEffort !== undefined ? { agentReasoningEffort } : {},
-    })
+      ...(agentProvider !== undefined ? { agentProvider } : {}),
+      ...(agentModel !== undefined ? { agentModel } : {}),
+      ...(agentReasoningEffort !== undefined ? { agentReasoningEffort } : {}),
+    });
     // Capture before the first await: a later parent switch belongs to the
     // parent's future, not to this child.
-    const delegatedPolicies = captureDelegatedPolicyOverrides(parent)
+    const delegatedPolicies = captureDelegatedPolicyOverrides(parent);
     // An idle continuation-managed parent must not settle while a caller is
     // still creating its child. A turn-scoped delegation does not need this,
     // but the service is also callable outside a turn.
-    const releaseHold = this.holdOwnership(parent, childId)
+    const releaseHold = this.holdOwnership(parent, childId);
     try {
-      const cwd = await this.resolveDirectory(request, spec.signal)
+      const cwd = await this.resolveDirectory(request, spec.signal);
       const prepared = await this.host.prepareContinuable(spec.provider, {
         sessionId: childId,
         cwd,
         parent,
         signal: spec.signal,
-      })
-      spec.signal.throwIfAborted()
-      this.assertAdmitting(parent)
+      });
+      spec.signal.throwIfAborted();
+      this.assertAdmitting(parent);
-      const inheritedEventCount = SessionLogOffset(prepared.seed?.length ?? 0)
-      const seed = prepared.seed
-      let established!: Activation
+      const inheritedEventCount = SessionLogOffset(prepared.seed?.length ?? 0);
+      const seed = prepared.seed;
+      let established!: Activation;
       const messageId = await this.locks.run(childId, async () => {
-        spec.signal.throwIfAborted()
-        this.assertAdmitting(parent)
-        this.assertChildIdAvailable(childId)
+        spec.signal.throwIfAborted();
+        this.assertAdmitting(parent);
+        this.assertChildIdAvailable(childId);
         if (spec.childId !== undefined) {
-          const persisted = await persistence?.stat(childId, { signal: spec.signal })
-          spec.signal.throwIfAborted()
-          this.assertAdmitting(parent)
-          this.assertChildIdAvailable(childId)
+          const persisted = await persistence?.stat(childId, { signal: spec.signal });
+          spec.signal.throwIfAborted();
+          this.assertAdmitting(parent);
+          this.assertChildIdAvailable(childId);
           if (persisted !== undefined) {
-            throw new SubagentError(`subagent "${childId}" already exists`, 'DUPLICATE_CHILD')
+            throw new SubagentError(`subagent "${childId}" already exists`, "DUPLICATE_CHILD");
           }
         }
         const activation = await this.materialize({
-          kind: 'local',
+          kind: "local",
           childId,
           provider: spec.provider,
           parent,
           create: {
             cwd,
             seed,
-            meta: childSessionMeta(parent, childDepth, prepared.seed !== undefined, request.agentPreset),
+            meta: childSessionMeta(
+              parent,
+              childDepth,
+              prepared.seed !== undefined,
+              request.agentPreset,
+            ),
             inheritedEventCount,
             delegatedPolicies,
             descriptor,
@@ -455,26 +527,27 @@ export class SubagentManager {
           signal: spec.signal,
           delivery: spec.delivery,
           outputSchema: spec.request.outputSchema,
-        })
-        established = activation
-        const child = requireLocalActivation(activation).handle.agent
-        const childHeader = child.session.header
+        });
+        established = activation;
+        const child = requireLocalActivation(activation).handle.agent;
+        const childHeader = child.session.header;
         return await this.submitMaterialized(
           activation,
-          spec.delivery !== 'caller' && isAdjacentAgentSendMessageTool(this.ctx.get('tools')?.get('send_message', child))
+          spec.delivery !== "caller" &&
+            isAdjacentAgentSendMessageTool(this.ctx.get("tools")?.get("send_message", child))
             ? this.continuableReturnGuidance(parent, request.prompt)
             : request.prompt,
-          { source: { kind: 'user' }, signal: spec.signal, delivery: 'queue' },
+          { source: { kind: "user" }, signal: spec.signal, delivery: "queue" },
           parent,
           () => {
-            establishCatalogChild(parent.session, childHeader, descriptor)
+            establishCatalogChild(parent.session, childHeader, descriptor);
           },
-        )
-      })
-      return { ...this.receipt(established), childId, messageId }
+        );
+      });
+      return { ...this.receipt(established), childId, messageId };
     } catch (error: unknown) {
-      releaseHold()
-      throw error
+      releaseHold();
+      throw error;
     }
   }
@@ -490,10 +563,10 @@ export class SubagentManager {
    * @returns task blocks followed by the guidance this session asked for.
    */
   private continuableReturnGuidance(parent: Agent, prompt: ContentBlock[]): ContentBlock[] {
-    const composed = this.ctx.get('agentPresets')?.composedPreset(parent.ctx)
+    const composed = this.ctx.get("agentPresets")?.composedPreset(parent.ctx);
     return localizedReturnGuidance(composed, this.localizedGuidancePresets())
       ? withContinuableReturnGuidance(parent.id, prompt)
-      : upstreamWithContinuableReturnGuidance(parent.id, prompt)
+      : upstreamWithContinuableReturnGuidance(parent.id, prompt);
   }
   /**
@@ -502,53 +575,66 @@ export class SubagentManager {
    * @returns the accepted activation and its result/disposal capabilities.
    */
   async startExternal(spec: SubagentActivationSpec): Promise<SubagentActivation> {
-    const parent = spec.request.parent
-    this.assertAdmitting(parent)
-    const pendingId = brandString<SessionId>(randomUUID())
-    const releaseHold = this.holdOwnership(parent, pendingId)
-    let activation: Activation | undefined
+    const parent = spec.request.parent;
+    this.assertAdmitting(parent);
+    const pendingId = brandString<SessionId>(randomUUID());
+    const releaseHold = this.holdOwnership(parent, pendingId);
+    let activation: Activation | undefined;
     try {
-      const cwd = await this.resolveDirectory(spec.request, spec.signal)
+      const cwd = await this.resolveDirectory(spec.request, spec.signal);
       activation = await this.materialize({
-        kind: 'external',
+        kind: "external",
         childId: pendingId,
         provider: spec.provider,
         parent,
         signal: spec.signal,
         delivery: spec.delivery,
-        start: signal => this.host.startExternal(spec.provider, {
-          ...spec.request, cwd, label: spec.label, signal,
-        }),
-      })
-      this.assertAdmitting(parent)
-      this.assertLiveParent(parent, activation.childId)
-      spec.signal.throwIfAborted()
-      if (spec.delivery === 'parent') {
-        establishExternalCatalogChild(parent.session, activation.childId, spec.label)
+        start: (signal) =>
+          this.host.startExternal(spec.provider, {
+            ...spec.request,
+            cwd,
+            label: spec.label,
+            signal,
+          }),
+      });
+      this.assertAdmitting(parent);
+      this.assertLiveParent(parent, activation.childId);
+      spec.signal.throwIfAborted();
+      if (spec.delivery === "parent") {
+        establishExternalCatalogChild(parent.session, activation.childId, spec.label);
       }
-      this.announce(activation)
-      return this.receipt(activation)
+      this.announce(activation);
+      return this.receipt(activation);
     } catch (error: unknown) {
       if (activation !== undefined) {
         try {
-          await this.dispose(activation)
+          await this.dispose(activation);
         } catch (cleanupError: unknown) {
-          this.ctx.logger.warn(`subagent "${activation.childId}" admission rollback failed: ${failureMessage(cleanupError)}`)
+          this.ctx.logger.warn(
+            `subagent "${activation.childId}" admission rollback failed: ${failureMessage(cleanupError)}`,
+          );
         }
       }
-      throw error
+      throw error;
     } finally {
-      releaseHold()
+      releaseHold();
     }
   }
   /** Capture the explicit or inherited directory while the parent still owns startup. */
-  private async resolveDirectory(request: Pick<SubagentStartRequest, 'parent' | 'cwd'>, signal: AbortSignal): Promise<string> {
-    const cwd = request.cwd !== undefined && isAbsolute(request.cwd)
-      ? request.cwd
-      : resolve(await this.ctx.workingDirectory.ensure(request.parent, signal), request.cwd ?? '.')
-    signal.throwIfAborted()
-    return cwd
+  private async resolveDirectory(
+    request: Pick<SubagentStartRequest, "parent" | "cwd">,
+    signal: AbortSignal,
+  ): Promise<string> {
+    const cwd =
+      request.cwd !== undefined && isAbsolute(request.cwd)
+        ? request.cwd
+        : resolve(
+            await this.ctx.workingDirectory.ensure(request.parent, signal),
+            request.cwd ?? ".",
+          );
+    signal.throwIfAborted();
+    return cwd;
   }
   /**
@@ -569,29 +655,31 @@ export class SubagentManager {
   ): Promise<MessageId> {
     if (this.ctx.agents.get(sender.id) !== sender) {
       throw new SubagentError(
-        'message delivery requires the exact live sender agent',
-        'UNAUTHORIZED',
-      )
+        "message delivery requires the exact live sender agent",
+        "UNAUTHORIZED",
+      );
     }
-    this.assertAdmitting(sender)
-    const senderActivation = this.resident.get(sender.id)
-    if (senderActivation !== undefined
-      && senderActivation.kind === 'local'
-      && senderActivation.handle.agent === sender
-      && senderActivation.parent.id === targetId) {
-      options.signal.throwIfAborted()
-      return this.sendToParent(senderActivation, sender, content)
+    this.assertAdmitting(sender);
+    const senderActivation = this.resident.get(sender.id);
+    if (
+      senderActivation !== undefined &&
+      senderActivation.kind === "local" &&
+      senderActivation.handle.agent === sender &&
+      senderActivation.parent.id === targetId
+    ) {
+      options.signal.throwIfAborted();
+      return this.sendToParent(senderActivation, sender, content);
     }
     if (sender.session.header.parentSession === targetId) {
       throw new SubagentError(
         `agent "${sender.id}" is not a resident continuable child and cannot send to parent "${targetId}"`,
-        'UNAUTHORIZED',
-      )
+        "UNAUTHORIZED",
+      );
     }
     return this.deliverToChild(sender, targetId, content, {
       signal: options.signal,
-      delivery: 'steer',
-    })
+      delivery: "steer",
+    });
   }
   /**
@@ -610,7 +698,7 @@ export class SubagentManager {
     source: MessageSource,
     signal: AbortSignal,
   ): Promise<MessageId> {
-    return this.deliverToChild(parent, childId, content, { source, signal, delivery: 'queue' })
+    return this.deliverToChild(parent, childId, content, { source, signal, delivery: "queue" });
   }
   /**
@@ -629,23 +717,26 @@ export class SubagentManager {
     source: MessageSource,
     signal: AbortSignal,
   ): Promise<MessageId> {
-    return this.deliverToChild(parent, childId, content, { source, signal, delivery: 'steer' })
+    return this.deliverToChild(parent, childId, content, { source, signal, delivery: "steer" });
   }
   /** Admit local input synchronously before any teardown can begin. */
   private deliver(activation: Activation, message: UserMessage, delivery: SubagentDelivery): void {
     if (activation.closing !== undefined) {
       throw new SubagentError(
-        'subagent activation is being disposed; the message was not accepted',
-        'ACTIVATION_CLOSING',
-      )
+        "subagent activation is being disposed; the message was not accepted",
+        "ACTIVATION_CLOSING",
+      );
     }
-    const local = requireLocalActivation(activation)
+    const local = requireLocalActivation(activation);
     if (local.structured?.acceptsInput() === false) {
-      throw new SubagentError('subagent is submitting or has submitted its structured result; the message was not accepted', 'INPUT_CLOSED')
+      throw new SubagentError(
+        "subagent is submitting or has submitted its structured result; the message was not accepted",
+        "INPUT_CLOSED",
+      );
     }
-    if (delivery === 'steer') local.handle.agent.steer(message)
-    else local.handle.agent.followup(message)
+    if (delivery === "steer") local.handle.agent.steer(message);
+    else local.handle.agent.followup(message);
   }
   /**
@@ -653,8 +744,12 @@ export class SubagentManager {
    * @param childId - proposed durable child session id.
    */
   private assertChildIdAvailable(childId: SessionId): void {
-    if (this.resident.has(childId) || this.ctx.agents.get(childId) !== undefined || this.ctx.get('sessions')?.get(childId) !== undefined) {
-      throw new SubagentError(`subagent "${childId}" already exists`, 'DUPLICATE_CHILD')
+    if (
+      this.resident.has(childId) ||
+      this.ctx.agents.get(childId) !== undefined ||
+      this.ctx.get("sessions")?.get(childId) !== undefined
+    ) {
+      throw new SubagentError(`subagent "${childId}" already exists`, "DUPLICATE_CHILD");
     }
   }
@@ -669,25 +764,26 @@ export class SubagentManager {
    * @returns the failure-path releaser; a no-op when nothing was added.
    */
   private holdOwnership(parent: Agent, childId: SessionId): () => void {
-    const parentActivation = this.resident.get(parent.id)
-    if (parentActivation === undefined || activationAgent(parentActivation) !== parent) return () => {}
+    const parentActivation = this.resident.get(parent.id);
+    if (parentActivation === undefined || activationAgent(parentActivation) !== parent)
+      return () => {};
     if (parentActivation.closing !== undefined) {
       throw new SubagentError(
         `subagent parent "${parent.id}" is being disposed; the child was not established`,
-        'ACTIVATION_CLOSING',
-      )
+        "ACTIVATION_CLOSING",
+      );
     }
-    if (parentActivation.ownedChildren.has(childId)) return () => {}
-    parentActivation.ownedChildren.add(childId)
+    if (parentActivation.ownedChildren.has(childId)) return () => {};
+    parentActivation.ownedChildren.add(childId);
     return () => {
-      const live = this.resident.get(childId)
+      const live = this.resident.get(childId);
       /* v8 ignore next 4 -- reaching this arm needs another delivery to establish the child
        * between this operation's failure and its releaser running, which no test can schedule
        * deterministically: the ownership edge then belongs to that live Activation, so the
        * conservative keep leaves it for finishDisposal's releaseOwnership. */
-      if (live !== undefined && live.closing === undefined) return
-      if (parentActivation.ownedChildren.delete(childId)) this.wake(parentActivation)
-    }
+      if (live !== undefined && live.closing === undefined) return;
+      if (parentActivation.ownedChildren.delete(childId)) this.wake(parentActivation);
+    };
   }
   /**
@@ -697,17 +793,17 @@ export class SubagentManager {
    * @param delivery - receiving inbox destination.
    */
   private sendWaking(parent: Agent, message: UserMessage, delivery: SubagentDelivery): void {
-    const parentActivation = this.resident.get(parent.id)
+    const parentActivation = this.resident.get(parent.id);
     if (parentActivation !== undefined && activationAgent(parentActivation) === parent) {
       try {
-        this.deliver(parentActivation, message, delivery)
+        this.deliver(parentActivation, message, delivery);
       } finally {
-        this.wake(parentActivation)
+        this.wake(parentActivation);
       }
-      return
+      return;
     }
-    if (delivery === 'steer') parent.steer(message)
-    else parent.followup(message)
+    if (delivery === "steer") parent.steer(message);
+    else parent.followup(message);
   }
   /**
@@ -715,14 +811,14 @@ export class SubagentManager {
    * @param agent - exact live Agent whose lineage determines admission.
    */
   private assertAdmitting(agent: Agent): void {
-    const closing = this.closingTeardownFor(agent)
-    if (closing === undefined) return
+    const closing = this.closingTeardownFor(agent);
+    if (closing === undefined) return;
     throw new SubagentError(
-      closing === 'manager'
-        ? 'subagents are draining; the operation was not admitted'
+      closing === "manager"
+        ? "subagents are draining; the operation was not admitted"
         : `subagents below parent "${closing.id}" are draining; the operation was not admitted`,
-      'DRAINING',
-    )
+      "DRAINING",
+    );
   }
   /**
@@ -736,9 +832,12 @@ export class SubagentManager {
     childId: SessionId,
     parentSession: SessionId | undefined,
   ): void {
-    this.assertLiveParent(parent, childId)
+    this.assertLiveParent(parent, childId);
     if (parentSession !== parent.id) {
-      throw new SubagentError(`subagent "${childId}" belongs to another parent session`, 'UNAUTHORIZED')
+      throw new SubagentError(
+        `subagent "${childId}" belongs to another parent session`,
+        "UNAUTHORIZED",
+      );
     }
   }
@@ -747,8 +846,8 @@ export class SubagentManager {
     if (this.ctx.agents.get(parent.id) !== parent) {
       throw new SubagentError(
         `subagent "${childId}" delivery requires the exact live parent agent`,
-        'UNAUTHORIZED',
-      )
+        "UNAUTHORIZED",
+      );
     }
   }
@@ -758,29 +857,35 @@ export class SubagentManager {
    * @returns the published process-local Activation.
    */
   private materialize(inputs: MaterializeInputs): Promise<Activation> {
-    this.assertAdmitting(inputs.parent)
-    inputs.signal.throwIfAborted()
-    const lineage = this.liveLineage(inputs.parent)
-    const pool = this.resident.get(inputs.parent.id)?.pool ?? this.rootPool(inputs.parent)
-    const releaseSlot = pool.reserve(this.maxActiveSubagents())
-    const settled = Promise.withResolvers<void>()
-    const controller = new AbortController()
+    this.assertAdmitting(inputs.parent);
+    inputs.signal.throwIfAborted();
+    const lineage = this.liveLineage(inputs.parent);
+    const pool = this.resident.get(inputs.parent.id)?.pool ?? this.rootPool(inputs.parent);
+    const releaseSlot = pool.reserve(this.maxActiveSubagents());
+    const settled = Promise.withResolvers<void>();
+    const controller = new AbortController();
     const materialization: Materialization = {
       lineage,
       settled: settled.promise,
       controller,
-    }
-    this.materializations.add(materialization)
+    };
+    this.materializations.add(materialization);
     return this.materializeTracked(
-      { ...inputs, signal: AbortSignal.any([inputs.signal, controller.signal]) }, lineage, pool, releaseSlot,
-    ).catch((error: unknown) => {
-      releaseSlot()
-      if (error instanceof Error && error.name === 'AbortError') this.assertAdmitting(inputs.parent)
-      throw error
-    }).finally(() => {
-      this.materializations.delete(materialization)
-      settled.resolve()
-    })
+      { ...inputs, signal: AbortSignal.any([inputs.signal, controller.signal]) },
+      lineage,
+      pool,
+      releaseSlot,
+    )
+      .catch((error: unknown) => {
+        releaseSlot();
+        if (error instanceof Error && error.name === "AbortError")
+          this.assertAdmitting(inputs.parent);
+        throw error;
+      })
+      .finally(() => {
+        this.materializations.delete(materialization);
+        settled.resolve();
+      });
   }
   /**
@@ -789,83 +894,85 @@ export class SubagentManager {
    * @returns the shared close transaction.
    */
   private dispose(activation: Activation): Promise<void> {
-    return this.close(activation, () => this.finishDisposal(activation, true))
+    return this.close(activation, () => this.finishDisposal(activation, true));
   }
   /** Close admission synchronously and share one release, including startup rollback. */
   private close(activation: Activation, release: () => Promise<void>): Promise<void> {
-    if (activation.closing !== undefined) return activation.closing
-    const completion = Promise.withResolvers<void>()
-    activation.closing = completion.promise
-    void release().then(completion.resolve, completion.reject)
-    return completion.promise
+    if (activation.closing !== undefined) return activation.closing;
+    const completion = Promise.withResolvers<void>();
+    activation.closing = completion.promise;
+    void release().then(completion.resolve, completion.reject);
+    return completion.promise;
   }
   /** Dispose independent roots and report every branch failure after all settle. */
   private async disposeRoots(
     roots: readonly Activation[],
-    failureSubject: 'activation(s)' | 'scoped activation(s)' | 'selected activation(s)',
+    failureSubject: "activation(s)" | "scoped activation(s)" | "selected activation(s)",
   ): Promise<void> {
-    const failures = await Promise.all(roots.map(async (activation) => {
-      try {
-        await this.dispose(activation)
-        return undefined
-      } catch (error: unknown) {
-        return error
-      }
-    }))
-    const reasons = failures.filter(failure => failure !== undefined)
+    const failures = await Promise.all(
+      roots.map(async (activation) => {
+        try {
+          await this.dispose(activation);
+          return undefined;
+        } catch (error: unknown) {
+          return error;
+        }
+      }),
+    );
+    const reasons = failures.filter((failure) => failure !== undefined);
     if (reasons.length > 0) {
       throw new SubagentError(
-        `subagent teardown failed for ${reasons.length} ${failureSubject}: `
-        + reasons.map(reason => failureMessage(reason)).join('; '),
-        'ACTIVATION_TEARDOWN_FAILED',
-      )
+        `subagent teardown failed for ${reasons.length} ${failureSubject}: ` +
+          reasons.map((reason) => failureMessage(reason)).join("; "),
+        "ACTIVATION_TEARDOWN_FAILED",
+      );
     }
   }
   /** Return the retained member set for one exact scoped-teardown root. */
   private closingMembers(root: Agent): Set<Agent> {
-    const existing = this.closingScopes.get(root)
-    if (existing !== undefined) return existing
-    const members = new Set<Agent>()
-    this.closingScopes.set(root, members)
-    return members
+    const existing = this.closingScopes.get(root);
+    if (existing !== undefined) return existing;
+    const members = new Set<Agent>();
+    this.closingScopes.set(root, members);
+    return members;
   }
   /** Return the exact currently resolvable ancestry from `agent` upward. */
   private liveLineage(agent: Agent): Agent[] {
-    const lineage = [agent]
-    const seen = new Set<SessionId>([agent.id])
-    let parentSession = agent.session.header.parentSession
+    const lineage = [agent];
+    const seen = new Set<SessionId>([agent.id]);
+    let parentSession = agent.session.header.parentSession;
     while (parentSession !== undefined) {
-      const parent = this.ctx.agents.get(parentSession)
-      if (parent === undefined || seen.has(parent.id)) break
-      lineage.push(parent)
-      seen.add(parent.id)
-      parentSession = parent.session.header.parentSession
+      const parent = this.ctx.agents.get(parentSession);
+      if (parent === undefined || seen.has(parent.id)) break;
+      lineage.push(parent);
+      seen.add(parent.id);
+      parentSession = parent.session.header.parentSession;
     }
-    return lineage
+    return lineage;
   }
   /** Return the teardown that closed continuable admission for this agent's lineage. */
-  private closingTeardownFor(agent: Agent): Agent | 'manager' | undefined {
-    if (this.draining) return 'manager'
-    const lineage = this.liveLineage(agent)
+  private closingTeardownFor(agent: Agent): Agent | "manager" | undefined {
+    if (this.draining) return "manager";
+    const lineage = this.liveLineage(agent);
     for (const [root, members] of this.closingScopes) {
-      if (members.has(agent) || lineage.includes(root)) return root
+      if (members.has(agent) || lineage.includes(root)) return root;
     }
-    return undefined
+    return undefined;
   }
   /** Resolve a root's pool once; descendants inherit their resident parent's pool directly. */
   private rootPool(parent: Agent): ActivationPool {
-    let pool = this.rootPools.get(parent)
+    let pool = this.rootPools.get(parent);
     if (pool === undefined) {
-      pool = new ActivationPool()
-      this.rootPools.set(parent, pool)
+      pool = new ActivationPool();
+      this.rootPools.set(parent, pool);
     }
-    return pool
+    return pool;
   }
   /** Perform one tracked materialization through publication or rollback. */
@@ -875,76 +982,95 @@ export class SubagentManager {
     pool: ActivationPool,
     releaseSlot: () => void,
   ): Promise<Activation> {
-    const { provider, parent } = inputs
-    let childId = inputs.childId
-    inputs.signal.throwIfAborted()
-    let resource: ActivationResource
-    if (inputs.kind === 'external') {
-      const controller = new AbortController()
-      const cancelStartup = (): void => { controller.abort(inputs.signal.reason) }
-      inputs.signal.addEventListener('abort', cancelStartup, { once: true })
+    const { provider, parent } = inputs;
+    let childId = inputs.childId;
+    inputs.signal.throwIfAborted();
+    let resource: ActivationResource;
+    if (inputs.kind === "external") {
+      const controller = new AbortController();
+      const cancelStartup = (): void => {
+        controller.abort(inputs.signal.reason);
+      };
+      inputs.signal.addEventListener("abort", cancelStartup, { once: true });
       try {
-        const run = await inputs.start(controller.signal)
-        resource = { kind: 'external', run, controller }
-        void run.result.catch(() => undefined)
-        childId = run.id
-        try { this.assertChildIdAvailable(childId) } catch (error: unknown) {
-          await run.dispose()
-          throw error
+        const run = await inputs.start(controller.signal);
+        resource = { kind: "external", run, controller };
+        void run.result.catch(() => undefined);
+        childId = run.id;
+        try {
+          this.assertChildIdAvailable(childId);
+        } catch (error: unknown) {
+          await run.dispose();
+          throw error;
         }
       } finally {
-        inputs.signal.removeEventListener('abort', cancelStartup)
+        inputs.signal.removeEventListener("abort", cancelStartup);
       }
     } else {
-      const { create } = inputs
-      let structured: StructuredAttachment | undefined
+      const { create } = inputs;
+      let structured: StructuredAttachment | undefined;
       const setup = async (childCtx: Context, child: Agent): Promise<void> => {
         // Only fresh creation appends the descriptor and delegated policy after
         // the inherited marker; a cold resume replays those persisted events.
         if (inputs.composition.agentPreset !== undefined) {
-          await applyChildComposition(childCtx, parent, inputs.composition)
+          await applyChildComposition(childCtx, parent, inputs.composition);
         }
         if (create !== undefined) {
           if (inputs.composition.agentPreset !== undefined) {
-            child.session.append('agent-preset/selected', { agentPreset: inputs.composition.agentPreset })
+            child.session.append("agent-preset/selected", {
+              agentPreset: inputs.composition.agentPreset,
+            });
           }
-          child.session.append('subagent/descriptor', create.descriptor)
-          appendDelegatedPolicyOverrides(child.session, create.delegatedPolicies)
-          const workingDirectory = childCtx.get('workingDirectory')
-          if (workingDirectory === undefined) throw new Error('local subagents require the working-directory service')
-          await workingDirectory.set(child, create.cwd, inputs.signal)
+          child.session.append("subagent/descriptor", create.descriptor);
+          appendDelegatedPolicyOverrides(child.session, create.delegatedPolicies);
+          const workingDirectory = childCtx.get("workingDirectory");
+          if (workingDirectory === undefined)
+            throw new Error("local subagents require the working-directory service");
+          await workingDirectory.set(child, create.cwd, inputs.signal);
         }
-        if (inputs.composition.agentPreset === undefined) await applyChildComposition(childCtx, parent, inputs.composition)
+        if (inputs.composition.agentPreset === undefined)
+          await applyChildComposition(childCtx, parent, inputs.composition);
         if (inputs.outputSchema !== undefined) {
-          structured = attachStructuredRuntime(childCtx, inputs.outputSchema, () =>
-            this.resident.get(childId)?.ownedChildren.size === 0
-            && child.inbox.nextStep.length === 0
-            && child.inbox.nextTurn.length === 0,
-          )
+          structured = attachStructuredRuntime(
+            childCtx,
+            inputs.outputSchema,
+            () =>
+              this.resident.get(childId)?.ownedChildren.size === 0 &&
+              child.inbox.nextStep.length === 0 &&
+              child.inbox.nextTurn.length === 0,
+          );
         }
-      }
-      const handle = create === undefined
-        ? await this.ownerCtx.agents.resume({
-          resumeSessionId: childId,
-          parentAgent: parent,
-          agentOptions: inputs.agentOptions,
-          signal: inputs.signal,
-          setup,
-        })
-        : await this.ownerCtx.agents.create({
-          sessionId: childId,
-          parentAgent: parent,
-          meta: create.meta,
-          ...(create.seed === undefined ? {} : { seed: create.seed }),
-          inheritedEventCount: create.inheritedEventCount,
-          agentOptions: inputs.agentOptions,
-          signal: inputs.signal,
-          setup,
-        })
-      resource = { kind: 'local', handle, outputStart: handle.agent.session.seq, structured, failureAt: undefined, poke: Promise.withResolvers<void>() }
+      };
+      const handle =
+        create === undefined
+          ? await this.ownerCtx.agents.resume({
+              resumeSessionId: childId,
+              parentAgent: parent,
+              agentOptions: inputs.agentOptions,
+              signal: inputs.signal,
+              setup,
+            })
+          : await this.ownerCtx.agents.create({
+              sessionId: childId,
+              parentAgent: parent,
+              meta: create.meta,
+              ...(create.seed === undefined ? {} : { seed: create.seed }),
+              inheritedEventCount: create.inheritedEventCount,
+              agentOptions: inputs.agentOptions,
+              signal: inputs.signal,
+              setup,
+            });
+      resource = {
+        kind: "local",
+        handle,
+        outputStart: handle.agent.session.seq,
+        structured,
+        failureAt: undefined,
+        poke: Promise.withResolvers<void>(),
+      };
     }
-    const observer = this.host.observeActivation(provider, childId, parent)
+    const observer = this.host.observeActivation(provider, childId, parent);
     const activation: Activation = {
       pool,
@@ -952,36 +1078,41 @@ export class SubagentManager {
       childId,
       ...resource,
       parent,
-      delivery: inputs.delivery ?? 'parent',
+      delivery: inputs.delivery ?? "parent",
       result: Promise.withResolvers<SubagentResult>(),
       closing: undefined,
-      ancestry: new WeakSet(resource.kind === 'external' ? parentLineage : [resource.handle.agent, ...parentLineage]),
+      ancestry: new WeakSet(
+        resource.kind === "external" ? parentLineage : [resource.handle.agent, ...parentLineage],
+      ),
       ownedChildren: new Set(),
       observer,
       announced: false,
-    }
-    void activation.result.promise.catch(() => undefined)
-    this.resident.set(childId, activation)
+    };
+    void activation.result.promise.catch(() => undefined);
+    this.resident.set(childId, activation);
     try {
-      this.assertAdmitting(parent)
-      inputs.signal.throwIfAborted()
-      if (this.ctx.agents.get(parent.id) !== parent) throw new SubagentError('subagent parent is no longer live', 'UNAUTHORIZED')
-      this.acquireOwnership(parent, childId)
-      const wakeSettlement = (): void => { this.wake(activation) }
-      if (activation.kind === 'local') {
-        observeLocalFailure(activation, wakeSettlement)
-        activation.handle.agent.ctx.on('agent/inbox/inserted', wakeSettlement)
-        activation.handle.agent.ctx.on('agent/inbox/claimed', wakeSettlement)
-        activation.handle.agent.ctx.on('agent/inbox/discarded', wakeSettlement)
+      this.assertAdmitting(parent);
+      inputs.signal.throwIfAborted();
+      if (this.ctx.agents.get(parent.id) !== parent)
+        throw new SubagentError("subagent parent is no longer live", "UNAUTHORIZED");
+      this.acquireOwnership(parent, childId);
+      const wakeSettlement = (): void => {
+        this.wake(activation);
+      };
+      if (activation.kind === "local") {
+        observeLocalFailure(activation, wakeSettlement);
+        activation.handle.agent.ctx.on("agent/inbox/inserted", wakeSettlement);
+        activation.handle.agent.ctx.on("agent/inbox/claimed", wakeSettlement);
+        activation.handle.agent.ctx.on("agent/inbox/discarded", wakeSettlement);
       }
-      observer.start(activationAgent(activation))
+      observer.start(activationAgent(activation));
     } catch (error: unknown) {
       /* v8 ignore next -- rollback failure must not mask the admission failure
        * that prevented this operation from returning an accepted message id. */
-      await this.rollbackUnpublished(activation, error).catch(() => undefined)
-      throw error
+      await this.rollbackUnpublished(activation, error).catch(() => undefined);
+      throw error;
     }
-    return activation
+    return activation;
   }
   /**
@@ -989,13 +1120,16 @@ export class SubagentManager {
    * @param activation - accepted activation to observe.
    */
   private announce(activation: Activation): void {
-    if (activation.announced) return
-    activation.announced = true
-    if (activation.kind === 'local') {
-      this.watchLocalSettlement(activation)
+    if (activation.announced) return;
+    activation.announced = true;
+    if (activation.kind === "local") {
+      this.watchLocalSettlement(activation);
     } else {
-      const finish = (): Promise<void> => this.close(activation, () => this.finishDisposal(activation, false))
-      void activation.run.result.then(finish, finish).catch((error: unknown) => { this.reportTeardownFailure(activation, error) })
+      const finish = (): Promise<void> =>
+        this.close(activation, () => this.finishDisposal(activation, false));
+      void activation.run.result.then(finish, finish).catch((error: unknown) => {
+        this.reportTeardownFailure(activation, error);
+      });
     }
   }
@@ -1003,100 +1137,104 @@ export class SubagentManager {
   private rollbackUnpublished(activation: Activation, error: unknown): Promise<void> {
     return this.close(activation, async () => {
       try {
-        await (activation.kind === 'local' ? activation.handle.dispose() : activation.run.dispose())
+        await (activation.kind === "local"
+          ? activation.handle.dispose()
+          : activation.run.dispose());
       } finally {
-        this.resident.delete(activation.childId)
-        activation.releaseSlot()
-        this.releaseOwnership(activation.childId)
-        activation.result.reject(error)
+        this.resident.delete(activation.childId);
+        activation.releaseSlot();
+        this.releaseOwnership(activation.childId);
+        activation.result.reject(error);
       }
-    })
+    });
   }
   /** Register the child in a continuation-managed parent's owned set. */
   private acquireOwnership(parent: Agent, childId: SessionId): void {
-    const parentActivation = this.resident.get(parent.id)
-    if (parentActivation === undefined) return
+    const parentActivation = this.resident.get(parent.id);
+    if (parentActivation === undefined) return;
     if (parentActivation.closing !== undefined) {
       throw new SubagentError(
         `subagent parent "${parent.id}" is being disposed; the child was not established`,
-        'ACTIVATION_CLOSING',
-      )
+        "ACTIVATION_CLOSING",
+      );
     }
-    parentActivation.ownedChildren.add(childId)
-    this.wake(parentActivation)
+    parentActivation.ownedChildren.add(childId);
+    this.wake(parentActivation);
   }
   /** Remove one child from its live owner's set and let that owner re-check settlement. */
   private releaseOwnership(childId: SessionId): void {
     for (const candidate of this.resident.values()) {
-      if (candidate.ownedChildren.delete(childId)) this.wake(candidate)
+      if (candidate.ownedChildren.delete(childId)) this.wake(candidate);
     }
   }
   /** Let a settlement watcher re-check residency after relevant state changes. */
   private wake(activation: Activation): void {
-    if (activation.kind === 'external') return
-    activation.poke.resolve()
-    activation.poke = Promise.withResolvers<void>()
+    if (activation.kind === "external") return;
+    activation.poke.resolve();
+    activation.poke = Promise.withResolvers<void>();
   }
   /** Follow one Activation to natural settlement. */
   private watchLocalSettlement(activation: LocalActivation): void {
     void (async () => {
       while (true) {
-        const idleObservation = activation.poke
-        await activation.handle.agent.whenIdle()
-        if (activation.closing !== undefined) return
-        const readiness = await this.locks.run(activation.childId, () => Promise.resolve(
-          this.settlementState(activation, idleObservation),
-        ))
-        if (readiness === 'closed') return
-        if (readiness === 'retry') continue
-        if (readiness === 'wait') {
-          await idleObservation.promise
-          continue
+        const idleObservation = activation.poke;
+        await activation.handle.agent.whenIdle();
+        if (activation.closing !== undefined) return;
+        const readiness = await this.locks.run(activation.childId, () =>
+          Promise.resolve(this.settlementState(activation, idleObservation)),
+        );
+        if (readiness === "closed") return;
+        if (readiness === "retry") continue;
+        if (readiness === "wait") {
+          await idleObservation.promise;
+          continue;
         }
-        const finalSeq = activation.handle.agent.session.seq
-        await this.flushFinalState(activation)
+        const finalSeq = activation.handle.agent.session.seq;
+        await this.flushFinalState(activation);
         const attempt = await this.locks.run<SettlementAttempt>(activation.childId, () => {
-          const state = this.settlementState(activation, idleObservation)
-          if (state !== 'ready') return Promise.resolve(state)
+          const state = this.settlementState(activation, idleObservation);
+          if (state !== "ready") return Promise.resolve(state);
           if (activation.handle.agent.session.seq !== finalSeq) {
-            return Promise.resolve('retry')
+            return Promise.resolve("retry");
           }
-          let done!: Promise<void>
+          let done!: Promise<void>;
           try {
             void activation.handle.agent.runMaintenance(() => {
-              done = this.close(activation, () => this.finishDisposal(activation, false))
-              return Promise.resolve()
-            })
+              done = this.close(activation, () => this.finishDisposal(activation, false));
+              return Promise.resolve();
+            });
             // oxlint-disable-next-line eslint/no-unused-vars -- 逐行保留上游文件：绑定本就不用
           } catch (_error: unknown) {
             // Another activity already owns the Agent's idle phase.
-            return Promise.resolve('retry')
+            return Promise.resolve("retry");
           }
-          return Promise.resolve({ done })
-        })
+          return Promise.resolve({ done });
+        });
-        if (typeof attempt === 'string') {
-          if (attempt === 'closed') return
-          continue
+        if (typeof attempt === "string") {
+          if (attempt === "closed") return;
+          continue;
         }
         try {
-          await attempt.done
+          await attempt.done;
         } catch (error: unknown) {
-          this.reportTeardownFailure(activation, error)
+          this.reportTeardownFailure(activation, error);
         }
-        return
+        return;
       }
-    })()
+    })();
   }
   /** Report disposal failure once after the natural settlement observer finishes. */
   private reportTeardownFailure(activation: Activation, error: unknown): void {
-    this.ctx.logger.warn(`subagent "${activation.childId}" activation teardown failed: ${failureMessage(error)}`)
+    this.ctx.logger.warn(
+      `subagent "${activation.childId}" activation teardown failed: ${failureMessage(error)}`,
+    );
   }
   /** Check pending input and owned children before closing admission. */
@@ -1104,138 +1242,154 @@ export class SubagentManager {
     activation: LocalActivation,
     observation: PromiseWithResolvers<void>,
   ): SettlementState {
-    if (activation.closing !== undefined) return 'closed'
-    if (activation.poke !== observation) return 'retry'
-    const inbox = activation.handle.agent.inbox
-    if (activation.ownedChildren.size > 0) return 'wait'
-    if (activation.failureAt === undefined && (inbox.nextTurn.length > 0 || inbox.nextStep.length > 0)) return 'wait'
-    return 'ready'
+    if (activation.closing !== undefined) return "closed";
+    if (activation.poke !== observation) return "retry";
+    const inbox = activation.handle.agent.inbox;
+    if (activation.ownedChildren.size > 0) return "wait";
+    if (
+      activation.failureAt === undefined &&
+      (inbox.nextTurn.length > 0 || inbox.nextStep.length > 0)
+    )
+      return "wait";
+    return "ready";
   }
   /** Propagate stop synchronously and await descendant startup rollback before release. */
   private async finishDisposal(activation: Activation, stop: boolean): Promise<void> {
-    this.wake(activation)
-    const { childId } = activation
-    const failures: SubagentError[] = []
-    let result: SubagentResult = { output: [], stopReason: 'error' }
-    let resultFailure: { error: unknown } | undefined
-    let externalDisposal: Promise<void> | undefined
-    const child = activationAgent(activation)
-    const detail = (error: unknown): string => child === undefined
-      ? failureMessage(error)
-      : errorChain(error)
+    this.wake(activation);
+    const { childId } = activation;
+    const failures: SubagentError[] = [];
+    let result: SubagentResult = { output: [], stopReason: "error" };
+    let resultFailure: { error: unknown } | undefined;
+    let externalDisposal: Promise<void> | undefined;
+    const child = activationAgent(activation);
+    const detail = (error: unknown): string =>
+      child === undefined ? failureMessage(error) : errorChain(error);
     try {
-      if (activation.kind === 'external') {
+      if (activation.kind === "external") {
         if (stop) {
-          activation.controller.abort({ kind: 'parent' })
+          activation.controller.abort({ kind: "parent" });
           // Some backends settle their result only when disposal begins.
-          externalDisposal = Promise.resolve().then(() => activation.run.dispose())
-          void externalDisposal.catch(() => undefined)
+          externalDisposal = Promise.resolve().then(() => activation.run.dispose());
+          void externalDisposal.catch(() => undefined);
         }
-        result = await activation.run.result
+        result = await activation.run.result;
       } else {
         if (stop) {
-          activation.handle.agent.cancel({ kind: 'parent' })
-          const idle = activation.handle.agent.whenIdle()
+          activation.handle.agent.cancel({ kind: "parent" });
+          const idle = activation.handle.agent.whenIdle();
           const children = [...activation.ownedChildren]
-            .map(child => this.resident.get(child))
-            .filter((child): child is Activation => child !== undefined)
-          const pending = [...this.materializations].filter(item => item.lineage.includes(activation.handle.agent))
-          const childDisposals = children.map(child => this.dispose(child))
-          for (const item of pending) item.controller.abort()
-          childDisposals.push(...pending.map(item => item.settled))
-          const childFailures = await Promise.all(childDisposals.map(async (disposal) => {
-            try {
-              await disposal
-              return undefined
-            } catch (error: unknown) {
-              return error
-            }
-          }))
-          const reasons = childFailures.filter(reason => reason !== undefined)
+            .map((child) => this.resident.get(child))
+            .filter((child): child is Activation => child !== undefined);
+          const pending = [...this.materializations].filter((item) =>
+            item.lineage.includes(activation.handle.agent),
+          );
+          const childDisposals = children.map((child) => this.dispose(child));
+          for (const item of pending) item.controller.abort();
+          childDisposals.push(...pending.map((item) => item.settled));
+          const childFailures = await Promise.all(
+            childDisposals.map(async (disposal) => {
+              try {
+                await disposal;
+                return undefined;
+              } catch (error: unknown) {
+                return error;
+              }
+            }),
+          );
+          const reasons = childFailures.filter((reason) => reason !== undefined);
           if (reasons.length > 0) {
-            failures.push(new SubagentError(
-              `subagent "${childId}" child teardown failed: ${reasons.map(reason => failureMessage(reason)).join('; ')}`,
-              'ACTIVATION_TEARDOWN_FAILED',
-            ))
+            failures.push(
+              new SubagentError(
+                `subagent "${childId}" child teardown failed: ${reasons.map((reason) => failureMessage(reason)).join("; ")}`,
+                "ACTIVATION_TEARDOWN_FAILED",
+              ),
+            );
           }
-          await idle
-          await this.flushFinalState(activation)
+          await idle;
+          await this.flushFinalState(activation);
         }
-        result = captureLocalResult(activation)
+        result = captureLocalResult(activation);
       }
     } catch (error: unknown) {
-      resultFailure = { error }
-      failures.push(new SubagentError(
-        `subagent "${childId}" activation teardown failed: ${detail(error)}`,
-        'ACTIVATION_TEARDOWN_FAILED',
-        { cause: error },
-      ))
+      resultFailure = { error };
+      failures.push(
+        new SubagentError(
+          `subagent "${childId}" activation teardown failed: ${detail(error)}`,
+          "ACTIVATION_TEARDOWN_FAILED",
+          { cause: error },
+        ),
+      );
     }
     try {
-      if (activation.kind === 'local') await activation.handle.dispose()
-      else await (externalDisposal ?? activation.run.dispose())
+      if (activation.kind === "local") await activation.handle.dispose();
+      else await (externalDisposal ?? activation.run.dispose());
     } catch (error: unknown) {
-      failures.push(new SubagentError(
-        `subagent "${childId}" activation handle disposal failed: ${detail(error)}`,
-        'ACTIVATION_TEARDOWN_FAILED',
-        { cause: error },
-      ))
+      failures.push(
+        new SubagentError(
+          `subagent "${childId}" activation handle disposal failed: ${detail(error)}`,
+          "ACTIVATION_TEARDOWN_FAILED",
+          { cause: error },
+        ),
+      );
     }
-    let failure: SubagentError | undefined
+    let failure: SubagentError | undefined;
     if (failures.length === 1) {
-      failure = failures[0]
+      failure = failures[0];
     } else if (failures.length > 1) {
       failure = new SubagentError(
-        `subagent "${childId}" activation teardown failed at ${failures.length} boundaries: `
-        + failures.map(item => detail(item)).join('; '),
-        'ACTIVATION_TEARDOWN_FAILED',
+        `subagent "${childId}" activation teardown failed at ${failures.length} boundaries: ` +
+          failures.map((item) => detail(item)).join("; "),
+        "ACTIVATION_TEARDOWN_FAILED",
         { cause: new AggregateError(failures) },
-      )
+      );
     }
-    this.resident.delete(childId)
-    activation.releaseSlot()
-    const terminal: SubagentResult = failure === undefined ? result : { output: [], stopReason: 'error' }
-    this.notifySettlement(activation, result)
-    this.releaseOwnership(childId)
-    activation.observer.settle(terminal)
-    if (resultFailure === undefined) activation.result.resolve(result)
-    else activation.result.reject(resultFailure.error)
-    if (failure !== undefined) throw failure
+    this.resident.delete(childId);
+    activation.releaseSlot();
+    const terminal: SubagentResult =
+      failure === undefined ? result : { output: [], stopReason: "error" };
+    this.notifySettlement(activation, result);
+    this.releaseOwnership(childId);
+    activation.observer.settle(terminal);
+    if (resultFailure === undefined) activation.result.resolve(result);
+    else activation.result.reject(resultFailure.error);
+    if (failure !== undefined) throw failure;
   }
   /** Deliver the captured execution result to the durable direct parent after cleanup. */
   private notifySettlement(activation: Activation, terminal: SubagentResult): void {
-    if (!activation.announced || activation.delivery === 'caller') return
+    if (!activation.announced || activation.delivery === "caller") return;
     try {
-      const parent = this.ctx.agents.get(activation.parent.id)
-      if (parent !== activation.parent) return
+      const parent = this.ctx.agents.get(activation.parent.id);
+      if (parent !== activation.parent) return;
       const message = createSettlementMessage(
-        activation.childId, terminal, activationAgent(activation) !== undefined,
-      )
+        activation.childId,
+        terminal,
+        activationAgent(activation) !== undefined,
+      );
       if (this.closingTeardownFor(parent) !== undefined) {
-        parent.inject(message)
-        return
+        parent.inject(message);
+        return;
       }
-      this.sendWaking(parent, message, parent.status === 'idle' ? 'queue' : 'steer')
+      this.sendWaking(parent, message, parent.status === "idle" ? "queue" : "steer");
     } catch (error: unknown) {
       this.ctx.logger.warn(
-        `subagent "${activation.childId}" settlement notice was not delivered to its parent: `
-        + errorChain(error),
-      )
+        `subagent "${activation.childId}" settlement notice was not delivered to its parent: ` +
+          errorChain(error),
+      );
     }
   }
   /** Request a best-effort final session flush before closing natural-settlement admission. */
   private async flushFinalState(activation: LocalActivation): Promise<void> {
     try {
-      await activation.handle.agent.ctx.sessions.flush(activation.handle.agent.session)
+      await activation.handle.agent.ctx.sessions.flush(activation.handle.agent.session);
     } catch (error: unknown) {
       this.ctx.logger.warn(
-        `subagent "${activation.childId}" best-effort final session flush failed; `
-        + `the persisted state may be unavailable or stale on resume: ${errorChain(error)}`,
-      )
+        `subagent "${activation.childId}" best-effort final session flush failed; ` +
+          `the persisted state may be unavailable or stale on resume: ${errorChain(error)}`,
+      );
     }
   }
@@ -1245,7 +1399,7 @@ export class SubagentManager {
       childId: activation.childId,
       result: activation.result.promise,
       dispose: () => this.dispose(activation),
-    }
+    };
   }
   /** Route one parent-originated delivery through residency and cold resume. */
@@ -1255,13 +1409,13 @@ export class SubagentManager {
     content: ContentBlock[],
     options: ChildDeliveryOptions,
   ): Promise<MessageId> {
-    this.assertAdmitting(parent)
-    const releaseHold = this.holdOwnership(parent, childId)
+    this.assertAdmitting(parent);
+    const releaseHold = this.holdOwnership(parent, childId);
     try {
-      return await this.deliverFollowup(parent, childId, content, options)
+      return await this.deliverFollowup(parent, childId, content, options);
     } catch (error: unknown) {
-      releaseHold()
-      throw error
+      releaseHold();
+      throw error;
     }
   }
@@ -1274,73 +1428,72 @@ export class SubagentManager {
   ): Promise<MessageId> {
     while (true) {
       const live = await this.locks.run(childId, async () => {
-        const activation = this.resident.get(childId)
-        if (activation === undefined) return this.coldResume(parent, childId, content, options)
-        requireLocalActivation(activation)
-        const disposal = activation.closing
+        const activation = this.resident.get(childId);
+        if (activation === undefined) return this.coldResume(parent, childId, content, options);
+        requireLocalActivation(activation);
+        const disposal = activation.closing;
         /* v8 ignore next 3 -- the send-versus-dispose cutoff needs a delivery to
          * observe the transaction inside the same critical section that opened it. */
         if (disposal !== undefined) {
-          return disposal.then(() => undefined, () => undefined)
+          return disposal.then(
+            () => undefined,
+            () => undefined,
+          );
         }
         if (contentHasImage(content)) {
-          await this.assertImageCapable(requireLocalActivation(activation).handle.agent, options.signal)
+          await this.assertImageCapable(
+            requireLocalActivation(activation).handle.agent,
+            options.signal,
+          );
           if (activation.closing !== undefined) {
-            await Promise.allSettled([activation.closing])
-            return undefined
+            await Promise.allSettled([activation.closing]);
+            return undefined;
           }
         }
-        const messageId = this.submitAdmitted(activation, content, options, parent)
-        this.announce(activation)
-        return messageId
-      })
+        const messageId = this.submitAdmitted(activation, content, options, parent);
+        this.announce(activation);
+        return messageId;
+      });
       /* v8 ignore start -- only a delivery that lost the disposal cutoff retries. */
-      if (live !== undefined) return live
-      this.assertAdmitting(parent)
-      options.signal.throwIfAborted()
+      if (live !== undefined) return live;
+      this.assertAdmitting(parent);
+      options.signal.throwIfAborted();
       /* v8 ignore stop */
     }
   }
   /** Deliver one resident continuable child's message to its live direct parent. */
-  private sendToParent(
-    activation: Activation,
-    sender: Agent,
-    content: ContentBlock[],
-  ): MessageId {
+  private sendToParent(activation: Activation, sender: Agent, content: ContentBlock[]): MessageId {
     /* v8 ignore next 6 -- only synchronous re-entrant teardown can open this
      * transaction between exact-agent authorization and this no-await span. */
     if (activation.closing !== undefined) {
       throw new SubagentError(
         `subagent "${sender.id}" activation is being disposed; the message was not delivered`,
-        'ACTIVATION_CLOSING',
-      )
+        "ACTIVATION_CLOSING",
+      );
     }
-    const parent = this.ctx.agents.get(activation.parent.id)
+    const parent = this.ctx.agents.get(activation.parent.id);
     if (parent !== activation.parent) {
       throw new SubagentError(
-        'direct parent is not live; the message was not delivered',
-        'PARENT_UNAVAILABLE',
-      )
+        "direct parent is not live; the message was not delivered",
+        "PARENT_UNAVAILABLE",
+      );
     }
-    const message = createAgentMessage(sender, content)
-    this.sendAgentMessage(parent, message)
-    return message.id
+    const message = createAgentMessage(sender, content);
+    this.sendAgentMessage(parent, message);
+    return message.id;
   }
   /** Send one Agent message while translating only the target's own rejection. */
-  private sendAgentMessage(
-    parent: Agent,
-    message: ReturnType<typeof createUserMessage>,
-  ): void {
+  private sendAgentMessage(parent: Agent, message: ReturnType<typeof createUserMessage>): void {
     try {
-      this.sendWaking(parent, message, 'steer')
+      this.sendWaking(parent, message, "steer");
     } catch (error: unknown) {
       throw new SubagentError(
-        'direct parent is not live; the message was not delivered',
-        'PARENT_UNAVAILABLE',
+        "direct parent is not live; the message was not delivered",
+        "PARENT_UNAVAILABLE",
         { cause: error },
-      )
+      );
     }
   }
@@ -1354,55 +1507,68 @@ export class SubagentManager {
     content: ContentBlock[],
     options: ChildDeliveryOptions,
   ): Promise<MessageId> {
-    const query = this.requireSessionQuery()
-    let observation: SessionObservation
+    const query = this.requireSessionQuery();
+    let observation: SessionObservation;
     try {
       observation = await query.observeSession(childId, {
         signal: options.signal,
-      })
+      });
     } catch (error: unknown) {
-      options.signal.throwIfAborted()
-      throw new SubagentError(`subagent "${childId}" is unavailable`, 'NOT_RESUMABLE', { cause: error })
+      options.signal.throwIfAborted();
+      throw new SubagentError(`subagent "${childId}" is unavailable`, "NOT_RESUMABLE", {
+        cause: error,
+      });
     }
-    using source = observation
-    this.assertAdmitting(parent)
-    this.authorizeLineage(parent, childId, source.header.parentSession)
-    const ownEvents = source.events.slice(source.inheritedEventCount)
-    const descriptor = foldSubagentDescriptor(ownEvents)
-    if (descriptor === undefined || descriptor.mode !== 'continuable') {
+    using source = observation;
+    this.assertAdmitting(parent);
+    this.authorizeLineage(parent, childId, source.header.parentSession);
+    const ownEvents = source.events.slice(source.inheritedEventCount);
+    const descriptor = foldSubagentDescriptor(ownEvents);
+    if (descriptor === undefined || descriptor.mode !== "continuable") {
       throw new SubagentError(
         `subagent "${childId}" has no supported continuation state and cannot be resumed; choose a different target`,
-        'NOT_RESUMABLE',
-      )
+        "NOT_RESUMABLE",
+      );
     }
-    let activation: Activation
+    let activation: Activation;
     try {
-      const independentlySelected = hasIndependentPresetSelection(ownEvents)
-      const agentPreset = independentlySelected ? source.projections?.values.agentPreset : undefined
-      if (independentlySelected && typeof agentPreset !== 'string') {
-        throw new SubagentError(`subagent "${childId}" has no agent preset projection for restoration`, 'NOT_RESUMABLE')
+      const independentlySelected = hasIndependentPresetSelection(ownEvents);
+      const agentPreset = independentlySelected
+        ? source.projections?.values.agentPreset
+        : undefined;
+      if (independentlySelected && typeof agentPreset !== "string") {
+        throw new SubagentError(
+          `subagent "${childId}" has no agent preset projection for restoration`,
+          "NOT_RESUMABLE",
+        );
       }
       activation = await this.materialize({
-        kind: 'local',
+        kind: "local",
         childId,
         provider: descriptor.provider,
         parent,
         agentOptions: {
-          ...descriptor.agentProvider !== undefined ? { provider: descriptor.agentProvider } : {},
-          ...descriptor.agentModel !== undefined ? { model: descriptor.agentModel } : {},
-          ...descriptor.agentReasoningEffort !== undefined
+          ...(descriptor.agentProvider !== undefined ? { provider: descriptor.agentProvider } : {}),
+          ...(descriptor.agentModel !== undefined ? { model: descriptor.agentModel } : {}),
+          ...(descriptor.agentReasoningEffort !== undefined
             ? { reasoningEffort: ReasoningEffortId(descriptor.agentReasoningEffort) }
-            : {},
+            : {}),
+        },
+        composition: {
+          agentPreset: agentPreset ?? undefined,
+          persona: descriptor.persona,
+          toolFilter: descriptor.toolFilter,
         },
-        composition: { agentPreset: agentPreset ?? undefined, persona: descriptor.persona, toolFilter: descriptor.toolFilter },
         signal: options.signal,
-      })
+      });
     } catch (error: unknown) {
-      options.signal.throwIfAborted()
-      if (error instanceof SubagentError) throw error
-      throw new SubagentError(`subagent "${childId}" is unavailable`, 'NOT_RESUMABLE', { cause: error })
+      options.signal.throwIfAborted();
+      if (error instanceof SubagentError) throw error;
+      throw new SubagentError(`subagent "${childId}" is unavailable`, "NOT_RESUMABLE", {
+        cause: error,
+      });
     }
-    return await this.submitMaterialized(activation, content, options, parent)
+    return await this.submitMaterialized(activation, content, options, parent);
   }
   /** Admit a materialized child, commit its creation fact, and release it on failure. */
@@ -1415,24 +1581,30 @@ export class SubagentManager {
   ): Promise<MessageId> {
     try {
       if (contentHasImage(content)) {
-        await this.assertImageCapable(requireLocalActivation(activation).handle.agent, options.signal)
+        await this.assertImageCapable(
+          requireLocalActivation(activation).handle.agent,
+          options.signal,
+        );
         if (activation.closing !== undefined) {
-          throw new SubagentError(`subagent "${activation.childId}" is closing`, 'ACTIVATION_CLOSING')
+          throw new SubagentError(
+            `subagent "${activation.childId}" is closing`,
+            "ACTIVATION_CLOSING",
+          );
         }
       }
-      const messageId = this.submitAdmitted(activation, content, options, parent)
-      commit?.()
-      this.announce(activation)
-      return messageId
+      const messageId = this.submitAdmitted(activation, content, options, parent);
+      commit?.();
+      this.announce(activation);
+      return messageId;
     } catch (error: unknown) {
       try {
-        await this.dispose(activation)
+        await this.dispose(activation);
       } catch (cleanupError: unknown) {
         this.ctx.logger.warn(
           `subagent continuation: disposal after admission or catalog append failure also failed: ${String(cleanupError)}`,
-        )
+        );
       }
-      throw error
+      throw error;
     }
   }
@@ -1443,73 +1615,71 @@ export class SubagentManager {
     options: ChildDeliveryOptions,
     parent: Agent,
   ): MessageId {
-    const message = options.source === undefined
-      ? createAgentMessage(parent, content)
-      : createUserMessage({ content, source: options.source })
-    options.signal.throwIfAborted()
-    this.assertAdmitting(parent)
-    this.authorizeLineage(parent, activation.childId, activation.parent.id)
-    this.acquireOwnership(parent, activation.childId)
+    const message =
+      options.source === undefined
+        ? createAgentMessage(parent, content)
+        : createUserMessage({ content, source: options.source });
+    options.signal.throwIfAborted();
+    this.assertAdmitting(parent);
+    this.authorizeLineage(parent, activation.childId, activation.parent.id);
+    this.acquireOwnership(parent, activation.childId);
     try {
-      this.deliver(activation, message, options.delivery)
+      this.deliver(activation, message, options.delivery);
     } finally {
-      this.wake(activation)
+      this.wake(activation);
     }
-    return message.id
+    return message.id;
   }
   /** Refuse image content for a child whose fixed model accepts text only. */
-  private async assertImageCapable(
-    agent: Agent,
-    signal: AbortSignal,
-  ): Promise<void> {
-    const { provider, model } = agent.options
-    if (provider === undefined || model === undefined) return
-    const llm = this.ctx.get('llm')
+  private async assertImageCapable(agent: Agent, signal: AbortSignal): Promise<void> {
+    const { provider, model } = agent.options;
+    if (provider === undefined || model === undefined) return;
+    const llm = this.ctx.get("llm");
     /* v8 ignore next -- without an LLM registry, delivery defers to projection. */
-    if (llm === undefined) return
-    const info = await llm.resolveModelInfo(provider, model, signal)
-    if (info.inputModalities !== undefined && !info.inputModalities.includes('image')) {
+    if (llm === undefined) return;
+    const info = await llm.resolveModelInfo(provider, model, signal);
+    if (info.inputModalities !== undefined && !info.inputModalities.includes("image")) {
       throw new SubagentError(
         `Model "${model}" does not support image input.`,
-        'MODEL_DOES_NOT_SUPPORT_IMAGES',
-      )
+        "MODEL_DOES_NOT_SUPPORT_IMAGES",
+      );
     }
   }
   /** Resolve the persistence service continuable children require, or fail loud. */
   private requirePersistence(): SessionPersistence {
-    const persistence = this.ctx.get('sessionPersistence')
+    const persistence = this.ctx.get("sessionPersistence");
     if (persistence === undefined) {
       throw new SubagentError(
-        'continuable subagents require session persistence (load a dsh-session-persistence backend)',
-        'PERSISTENCE_UNAVAILABLE',
-      )
+        "continuable subagents require session persistence (load a dsh-session-persistence backend)",
+        "PERSISTENCE_UNAVAILABLE",
+      );
     }
-    return persistence
+    return persistence;
   }
   /** Resolve the Session query service used for cold child observations. */
   private requireSessionQuery(): SessionQueryEngine {
-    const query = this.ctx.get('sessionQuery')
+    const query = this.ctx.get("sessionQuery");
     if (query === undefined) {
       throw new SubagentError(
-        'continuable subagents require session query (load @deepseek-ai/dsh-session-query)',
-        'CONTINUATION_UNAVAILABLE',
-      )
+        "continuable subagents require session query (load @deepseek-ai/dsh-session-query)",
+        "CONTINUATION_UNAVAILABLE",
+      );
     }
-    return query
+    return query;
   }
 }
-export default SubagentManager
+export default SubagentManager;
 /** Creation-time selection precedes the own descriptor; historical forks can select after it. */
 function hasIndependentPresetSelection(events: readonly SessionEvent[]): boolean {
   for (const event of events) {
-    if (event.type === 'subagent/descriptor') return false
-    if (event.type === 'agent-preset/selected') return true
+    if (event.type === "subagent/descriptor") return false;
+    if (event.type === "agent-preset/selected") return true;
   }
   /* v8 ignore next -- coldResume rejects logs without a supported own descriptor before this lookup. */
-  return false
+  return false;
 }