@narumitw/pi-subagents 2.0.1 → 2.0.2

package/README.md

@@ -12,6 +12,7 @@ One ordinary async worker requires named non-overlapping main-agent work that st
 
 ## ✨ Features
 
+- Loads a generated split TypeScript runtime through Pi's Jiti loader while preserving first-use execution, UI, inspection, and transport chunks.
 - Keeps all delegation methods as the compatibility default while recommending async-only for a smaller responsive surface.
 - Adds `subagent_inspect` for bounded metadata without child launch, mailbox-content access, acknowledgement, or mutation.
 - Adds `subagent_consult` for one synchronous ephemeral child constrained to built-in `read`, `grep`, `find`, and `ls` tools (or a narrower agent allow-list).
@@ -53,12 +54,16 @@ Try without installing permanently:
 pi -e npm:@narumitw/pi-subagents
 ```
 
-Try this package locally from the repository root:
+Build and try this package locally from the repository root:
 
 ```bash
-pi -e ./packages/pi-subagents
+just try subagents
 ```
 
+The published package declares `dist/index.ts`, and `just try` runs its build before loading the package directory.
+For an explicit local flow, run `npm --workspace @narumitw/pi-subagents run build` before `pi -e ./packages/pi-subagents`.
+An unbuilt checkout intentionally has no declared generated entrypoint.
+
 ## 🚀 Quick start
 
 For normal async-first use, run `/subagents`, choose **Change delegation**, select **Async only · Recommended**, confirm the exact tool changes, and reload.
@@ -592,7 +597,7 @@ Simple and immediate critical-path work should stay in the main agent.
 The bounded persisted completion outbox provides ordered at-least-once delivery across process restart without replaying the child turn. A top-level completion targets `/root`; a nested completion enters the direct retained parent's mailbox and is not duplicated into the root transcript. If the direct parent cannot own delivery, routing walks toward the nearest live retained ancestor and uses `/root` only as the final fallback. An idle parent remains asleep, and inspection exposes its unread and pending-completion counts until a later turn consumes the envelope. When state must be reduced to its storage bound, persistence drops roots without pending completions first and trims old history rather than discarding an outbox-owned root. A completion is acknowledged only after the intended recipient context observes its exact `completionId`; an injection that returns synchronously but never reaches context remains pending for retry. If the process exits after context assembly but before acknowledgement is persisted, the same ID can be delivered again and consumers must deduplicate it. Auto-resume applies only to `/root`; nested delivery never silently starts the parent. Transient terminal-persistence failures retry with bounded exponential backoff and keep the run pending; shutdown cancels retry waits and reports a final persistence failure instead of silently resolving unsaved work.
 
 The default `subprocess` transport preserves compatibility: each turn starts a fresh isolated `pi --mode json -p --no-session` child and receives sanitized, bounded history.
-Pi registers every Subagents tool and command during startup, but loads blocking execution, manager UI, inspection work, and the selected detached transport implementation only on first use.
+Pi loads one generated split TypeScript runtime and registers every Subagents tool and command during startup, but loads blocking execution, manager UI, inspection work, and the selected detached transport implementation only on first use.
 Session restoration, pending completion delivery, settings validation, and cleanup ownership remain eager.
 A failed first-use code load is reported normally and can be retried.
 Set `transport` to `in-process` to retain one public Pi SDK `AgentSession` per stateful `agentId`, avoiding repeated process startup while preserving native child history in memory.
@@ -1062,9 +1067,13 @@ Downgrading is safe: older extension versions ignore this separate state directo
 
 ```txt
 packages/pi-subagents/
+├── dist/                         # Generated split TypeScript runtime loaded through Pi's Jiti loader
+├── scripts/
+│   └── build-runtime.mjs         # Deterministic bundler and eager-boundary validator
 ├── src/
-│   ├── index.ts                  # Pi package entrypoint
-│   ├── subagents.ts              # Lightweight extension composition and blocking registration
+│   ├── index.ts                  # Thin authoritative source entrypoint
+│   ├── subagents-extension.ts    # Lightweight extension composition and blocking registration
+│   ├── subagents.ts              # Backward-compatible public utility exports
 │   ├── cached-module-loader.ts   # Retryable first-use code-module cache
 │   ├── inspect-registration.ts   # Lightweight inspection tool registration
 │   ├── inspect.ts                # First-use side-effect-free metadata inspection
@@ -1074,7 +1083,9 @@ packages/pi-subagents/
 │   ├── cwd-policy.ts             # Canonical target and saved-trust resolution
 │   ├── prompt-resources.ts       # Core-selected SYSTEM and APPEND_SYSTEM resources
 │   ├── safe-text.ts              # Shared byte/line/path sanitization
-│   ├── stateful.ts               # Detached lifecycle registration and dispatch
+│   ├── stateful-registration.ts  # Detached lifecycle registration and dispatch
+│   ├── stateful.ts               # Backward-compatible detached utility exports
+│   ├── settings-reader.ts        # Side-effect-free startup settings reads and inspection
 │   ├── create-stateful-transport.ts # First-turn selected transport loader
 │   ├── rpc-transport.ts          # Persistent strict-JSONL Pi RPC child transport
 │   ├── rpc-timeout-finalization.ts # RPC abort-settle-summary recovery
@@ -1132,7 +1143,9 @@ packages/pi-subagents/
 └── package.json
 ```
 
-`index.ts` is the Pi entrypoint and forwards to `subagents.ts`; the other source modules are internal.
+`src/index.ts` is the authoritative thin entrypoint and forwards to `subagents-extension.ts`.
+The package build bundles that source graph into split `.ts` files under `dist` for Pi's Jiti loader.
+`subagents.ts` and `stateful.ts` preserve existing source-level utility imports without making those utility graphs part of Pi startup.
 Workflow settings remain backward compatible: older files without `blocking.enabled` receive the eight-tool default, and an absent `blocking.maxParallelTasks` keeps the previous eight-worker limit.
 Existing `stateful.enabled: false` files expose blocking delegation plus inspection/consultation.
 Older package releases ignore and preserve the optional `blocking.maxParallelTasks`, `consult`, and `cwdPolicy` fields.
@@ -1141,7 +1154,7 @@ The package exposes its Pi extension through `package.json`:
 ```json
 {
   "pi": {
-    "extensions": ["./src/index.ts"]
+    "extensions": ["./dist/index.ts"]
   }
 }
 ```

package/dist/chunks/auto-transport-SY2VHUFH.ts

@@ -0,0 +1,109 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  isWriteCapable
+} from "./chunk-O4VO6JUJ.js";
+import {
+  discoverAgents
+} from "./chunk-PSK43Y6A.js";
+import "./chunk-RSUXZD6S.js";
+import "./chunk-QBORTI4W.js";
+import "./chunk-7OBINKFM.js";
+import "./chunk-DPPVEQAM.js";
+import "./chunk-SWGQLFSD.js";
+import "./chunk-H3FP6DLR.js";
+
+// src/auto-transport.ts
+var BUILT_IN_TOOL_NAMES = /* @__PURE__ */ new Set(["read", "bash", "edit", "write", "grep", "find", "ls"]);
+var AutoTransport = class {
+  constructor(options) {
+    this.options = options;
+  }
+  options;
+  kind = "auto";
+  selections = /* @__PURE__ */ new Map();
+  async runTurn(agent, task, signal, onProgress) {
+    const selection = this.selections.get(agent.id) ?? this.select(agent);
+    this.selections.set(agent.id, selection);
+    const transport = this.transport(selection.kind);
+    const outcome = await transport.runTurn(
+      agent,
+      task,
+      signal,
+      (progress) => onProgress?.({ ...progress, selectionReason: selection.reason })
+    );
+    return {
+      ...outcome,
+      telemetry: outcome.telemetry ? { ...outcome.telemetry, selectionReason: selection.reason } : outcome.telemetry
+    };
+  }
+  async deliverMessage(agent, message) {
+    const selection = this.selections.get(agent.id);
+    if (!selection) return false;
+    return this.transport(selection.kind).deliverMessage?.(agent, message) ?? false;
+  }
+  async release(agent) {
+    const selection = this.selections.get(agent.id);
+    this.selections.delete(agent.id);
+    if (selection) await this.transport(selection.kind).release?.(agent);
+  }
+  async shutdown() {
+    this.selections.clear();
+    const transports = [this.options.subprocess, this.options.inProcess, this.options.rpc];
+    const results = await Promise.allSettled(transports.map((transport) => transport.shutdown?.()));
+    const failures = results.flatMap(
+      (result) => result.status === "rejected" ? [result.reason] : []
+    );
+    if (failures.length > 0) {
+      throw new AggregateError(
+        failures,
+        `Failed to shut down ${failures.length} auto transport(s)`
+      );
+    }
+  }
+  selectionFor(agentId) {
+    const selection = this.selections.get(agentId);
+    return selection ? { ...selection } : void 0;
+  }
+  select(agent) {
+    const settings = this.options.getSettings?.();
+    const config = discoverAgents(agent.cwd, agent.agentScope ?? "user", settings).agents.find(
+      (candidate) => candidate.name === agent.agent
+    );
+    if (!config) {
+      throw new Error(`Automatic transport cannot resolve subagent ${agent.agent}`);
+    }
+    const effectiveTools = agent.executionPlan?.effectiveTools ?? config.tools;
+    const unsupported = (effectiveTools ?? []).filter((tool) => !BUILT_IN_TOOL_NAMES.has(tool));
+    if (unsupported.length > 0) {
+      return {
+        kind: "subprocess",
+        reason: `extension/custom tools require subprocess: ${unsupported.join(", ")}`
+      };
+    }
+    if (isWriteCapable(effectiveTools)) {
+      return {
+        kind: "rpc",
+        reason: "write-capable built-in tools use a persistent isolated process"
+      };
+    }
+    return {
+      kind: "in-process",
+      reason: "read-only built-in tools use the lowest-overhead public SDK session"
+    };
+  }
+  transport(kind) {
+    switch (kind) {
+      case "subprocess":
+        return this.options.subprocess;
+      case "in-process":
+        return this.options.inProcess;
+      case "rpc":
+        return this.options.rpc;
+    }
+  }
+};
+export {
+  AutoTransport
+};
+//# sourceMappingURL=auto-transport-SY2VHUFH.ts.map

package/dist/chunks/auto-transport-SY2VHUFH.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/auto-transport.ts"],
+  "sourcesContent": ["import { discoverAgents } from \"./agents/discovery.js\";\nimport type { SubagentSettings } from \"./agents/types.js\";\nimport type { AgentMailboxMessage, ManagedAgent, TurnOutcome } from \"./registry.js\";\nimport { isWriteCapable } from \"./stateful-safety.js\";\nimport type { SubagentTransport } from \"./transport.js\";\nimport type {\n\tEffectiveSubagentTransportKind,\n\tTransportProgressCallback,\n} from \"./transport-types.js\";\n\nconst BUILT_IN_TOOL_NAMES = new Set([\"read\", \"bash\", \"edit\", \"write\", \"grep\", \"find\", \"ls\"]);\n\nexport interface AutoTransportOptions {\n\tsubprocess: SubagentTransport;\n\tinProcess: SubagentTransport;\n\trpc: SubagentTransport;\n\tgetSettings?: () => SubagentSettings | undefined;\n}\n\nexport interface AutoTransportSelection {\n\tkind: EffectiveSubagentTransportKind;\n\treason: string;\n}\n\nexport class AutoTransport implements SubagentTransport {\n\treadonly kind = \"auto\" as const;\n\tprivate readonly selections = new Map<string, AutoTransportSelection>();\n\n\tconstructor(private readonly options: AutoTransportOptions) {}\n\n\tasync runTurn(\n\t\tagent: ManagedAgent,\n\t\ttask: string,\n\t\tsignal: AbortSignal,\n\t\tonProgress?: TransportProgressCallback,\n\t): Promise<TurnOutcome> {\n\t\tconst selection = this.selections.get(agent.id) ?? this.select(agent);\n\t\tthis.selections.set(agent.id, selection);\n\t\tconst transport = this.transport(selection.kind);\n\t\tconst outcome = await transport.runTurn(agent, task, signal, (progress) =>\n\t\t\tonProgress?.({ ...progress, selectionReason: selection.reason }),\n\t\t);\n\t\treturn {\n\t\t\t...outcome,\n\t\t\ttelemetry: outcome.telemetry\n\t\t\t\t? { ...outcome.telemetry, selectionReason: selection.reason }\n\t\t\t\t: outcome.telemetry,\n\t\t};\n\t}\n\n\tasync deliverMessage(agent: ManagedAgent, message: AgentMailboxMessage): Promise<boolean> {\n\t\tconst selection = this.selections.get(agent.id);\n\t\tif (!selection) return false;\n\t\treturn this.transport(selection.kind).deliverMessage?.(agent, message) ?? false;\n\t}\n\n\tasync release(agent: ManagedAgent): Promise<void> {\n\t\tconst selection = this.selections.get(agent.id);\n\t\tthis.selections.delete(agent.id);\n\t\tif (selection) await this.transport(selection.kind).release?.(agent);\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tthis.selections.clear();\n\t\tconst transports = [this.options.subprocess, this.options.inProcess, this.options.rpc];\n\t\tconst results = await Promise.allSettled(transports.map((transport) => transport.shutdown?.()));\n\t\tconst failures = results.flatMap((result) =>\n\t\t\tresult.status === \"rejected\" ? [result.reason] : [],\n\t\t);\n\t\tif (failures.length > 0) {\n\t\t\tthrow new AggregateError(\n\t\t\t\tfailures,\n\t\t\t\t`Failed to shut down ${failures.length} auto transport(s)`,\n\t\t\t);\n\t\t}\n\t}\n\n\tselectionFor(agentId: string): AutoTransportSelection | undefined {\n\t\tconst selection = this.selections.get(agentId);\n\t\treturn selection ? { ...selection } : undefined;\n\t}\n\n\tprivate select(agent: ManagedAgent): AutoTransportSelection {\n\t\tconst settings = this.options.getSettings?.();\n\t\tconst config = discoverAgents(agent.cwd, agent.agentScope ?? \"user\", settings).agents.find(\n\t\t\t(candidate) => candidate.name === agent.agent,\n\t\t);\n\t\tif (!config) {\n\t\t\tthrow new Error(`Automatic transport cannot resolve subagent ${agent.agent}`);\n\t\t}\n\t\tconst effectiveTools = agent.executionPlan?.effectiveTools ?? config.tools;\n\t\tconst unsupported = (effectiveTools ?? []).filter((tool) => !BUILT_IN_TOOL_NAMES.has(tool));\n\t\tif (unsupported.length > 0) {\n\t\t\treturn {\n\t\t\t\tkind: \"subprocess\",\n\t\t\t\treason: `extension/custom tools require subprocess: ${unsupported.join(\", \")}`,\n\t\t\t};\n\t\t}\n\t\tif (isWriteCapable(effectiveTools)) {\n\t\t\treturn {\n\t\t\t\tkind: \"rpc\",\n\t\t\t\treason: \"write-capable built-in tools use a persistent isolated process\",\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tkind: \"in-process\",\n\t\t\treason: \"read-only built-in tools use the lowest-overhead public SDK session\",\n\t\t};\n\t}\n\n\tprivate transport(kind: EffectiveSubagentTransportKind): SubagentTransport {\n\t\tswitch (kind) {\n\t\t\tcase \"subprocess\":\n\t\t\t\treturn this.options.subprocess;\n\t\t\tcase \"in-process\":\n\t\t\t\treturn this.options.inProcess;\n\t\t\tcase \"rpc\":\n\t\t\t\treturn this.options.rpc;\n\t\t}\n\t}\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/capability-grant-CGEWOEKE.ts

@@ -0,0 +1,19 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  CAPABILITY_GRANT_VERSION,
+  isCapabilityGrant,
+  isCapabilityGrantActive,
+  issueCapabilityGrant,
+  revokeCapabilityGrant
+} from "./chunk-HKC4ES4B.js";
+import "./chunk-DSOOH73Y.js";
+import "./chunk-DPPVEQAM.js";
+export {
+  CAPABILITY_GRANT_VERSION,
+  isCapabilityGrant,
+  isCapabilityGrantActive,
+  issueCapabilityGrant,
+  revokeCapabilityGrant
+};
+//# sourceMappingURL=capability-grant-CGEWOEKE.ts.map

package/dist/chunks/capability-grant-CGEWOEKE.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/chunks/chunk-434NII74.ts

@@ -0,0 +1,282 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+import {
+  PI_SUBAGENTS_RPC_PROTOCOL
+} from "./chunk-C4L6P266.js";
+import {
+  SUBAGENT_COMPLETION_MESSAGE_TYPE
+} from "./chunk-QDVGH2X7.js";
+import {
+  safeTerminalText
+} from "./chunk-SWGQLFSD.js";
+import {
+  DEFAULT_MAX_CONTEXT_BYTES,
+  MAX_TOOL_MESSAGE_BYTES,
+  redactPrivateText,
+  truncateUtf8
+} from "./chunk-H3FP6DLR.js";
+
+// src/completion-delivery.ts
+var MAX_COMPLETION_ERROR_BYTES = 512;
+var MAX_COMPLETIONS_PER_MESSAGE = 16;
+var COMPLETION_BATCH_DELAY_MS = 10;
+var CompletionDeliveryBroker = class {
+  constructor(pi, ctx, delivery, options = {}) {
+    this.pi = pi;
+    this.ctx = ctx;
+    this.delivery = delivery;
+    this.options = options;
+  }
+  pi;
+  ctx;
+  delivery;
+  options;
+  pending = [];
+  knownCompletionIds = /* @__PURE__ */ new Set();
+  awaitingParentAck = [];
+  flushTimer;
+  wakeInFlight = false;
+  closed = false;
+  enqueue(completion) {
+    if (this.closed || this.knownCompletionIds.has(completion.completionId)) return;
+    this.knownCompletionIds.add(completion.completionId);
+    this.pending.push(completion);
+    this.scheduleFlush();
+  }
+  setDelivery(value) {
+    this.delivery = value;
+    this.scheduleFlush();
+  }
+  onParentTurnStart() {
+    this.wakeInFlight = false;
+    this.scheduleFlush();
+  }
+  onParentContext(messages) {
+    this.acknowledgeVisible(completionIdsFromContext(messages));
+    if (this.awaitingParentAck.length > 0) {
+      this.pending = [...this.awaitingParentAck.splice(0), ...this.pending];
+    }
+    this.scheduleFlush();
+  }
+  onParentSettled() {
+    this.wakeInFlight = false;
+    this.scheduleFlush();
+  }
+  flush() {
+    if (this.closed || this.pending.length === 0) return;
+    if (this.flushTimer) clearTimeout(this.flushTimer);
+    this.flushTimer = void 0;
+    if (this.delivery === "auto-resume" && !this.isRootIdle()) return;
+    const completions = this.pending.splice(0);
+    const batches = chunkCompletions(completions);
+    let canWake = this.shouldWakeRoot();
+    for (let index = 0; index < batches.length; index++) {
+      const triggerTurn = canWake && index === batches.length - 1;
+      const batch = batches[index];
+      const message = buildCompletionMessage(batch);
+      if (triggerTurn) this.wakeInFlight = true;
+      this.awaitingParentAck.push(...batch);
+      try {
+        this.pi.sendMessage(message, {
+          deliverAs: "steer",
+          ...triggerTurn ? { triggerTurn: true } : {}
+        });
+      } catch (primaryError) {
+        this.removeAwaiting(batch);
+        if (triggerTurn) this.wakeInFlight = false;
+        canWake = false;
+        this.awaitingParentAck.push(...batch);
+        try {
+          this.pi.sendMessage(message, { deliverAs: "nextTurn", triggerTurn: false });
+        } catch (fallbackError) {
+          this.removeAwaiting(batch);
+          this.pending = [...batches.slice(index).flat(), ...this.pending];
+          try {
+            this.options.onDeliveryError?.(
+              new AggregateError(
+                [primaryError, fallbackError],
+                "Detached subagent completion delivery failed"
+              )
+            );
+          } catch {
+          }
+          return;
+        }
+      }
+    }
+  }
+  close() {
+    this.closed = true;
+    if (this.flushTimer) clearTimeout(this.flushTimer);
+    this.flushTimer = void 0;
+    this.pending = [];
+    this.awaitingParentAck = [];
+    this.knownCompletionIds.clear();
+  }
+  scheduleFlush() {
+    if (this.closed || this.pending.length === 0 || this.flushTimer) return;
+    this.flushTimer = setTimeout(() => {
+      this.flushTimer = void 0;
+      this.flush();
+    }, COMPLETION_BATCH_DELAY_MS);
+  }
+  acknowledgeVisible(visibleIds) {
+    if (visibleIds.size === 0) return;
+    const completions = [...this.awaitingParentAck, ...this.pending].filter(
+      (completion) => visibleIds.has(completion.completionId)
+    );
+    if (completions.length === 0) return;
+    const acknowledgedIds = new Set(completions.map((completion) => completion.completionId));
+    this.awaitingParentAck = this.awaitingParentAck.filter(
+      (completion) => !acknowledgedIds.has(completion.completionId)
+    );
+    this.pending = this.pending.filter(
+      (completion) => !acknowledgedIds.has(completion.completionId)
+    );
+    for (const completion of completions) this.knownCompletionIds.delete(completion.completionId);
+    try {
+      this.options.onAcknowledged?.(completions, (this.options.now ?? Date.now)());
+    } catch {
+    }
+  }
+  removeAwaiting(completions) {
+    const removed = new Set(completions.map((completion) => completion.completionId));
+    this.awaitingParentAck = this.awaitingParentAck.filter(
+      (completion) => !removed.has(completion.completionId)
+    );
+  }
+  isRootIdle() {
+    try {
+      return this.ctx.isIdle();
+    } catch {
+      return false;
+    }
+  }
+  shouldWakeRoot() {
+    if (this.delivery !== "auto-resume" || this.wakeInFlight) return false;
+    try {
+      return !this.ctx.hasPendingMessages();
+    } catch {
+      return false;
+    }
+  }
+};
+function completionIdsFromContext(messages) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const message of messages) {
+    if (!message || typeof message !== "object" || Array.isArray(message)) continue;
+    const record = message;
+    if (record.role !== "custom" || record.customType !== SUBAGENT_COMPLETION_MESSAGE_TYPE)
+      continue;
+    const details = record.details;
+    if (!details || typeof details !== "object" || Array.isArray(details)) continue;
+    const metadata = details;
+    if (metadata.protocol === PI_SUBAGENTS_RPC_PROTOCOL && typeof metadata.completionId === "string") {
+      ids.add(metadata.completionId);
+    }
+    if (!Array.isArray(metadata.completions)) continue;
+    for (const completion of metadata.completions) {
+      if (!completion || typeof completion !== "object" || Array.isArray(completion)) continue;
+      const item = completion;
+      if (item.protocol === PI_SUBAGENTS_RPC_PROTOCOL && typeof item.completionId === "string") {
+        ids.add(item.completionId);
+      }
+    }
+  }
+  return ids;
+}
+function chunkCompletions(completions) {
+  const batches = [];
+  for (let index = 0; index < completions.length; index += MAX_COMPLETIONS_PER_MESSAGE) {
+    batches.push(completions.slice(index, index + MAX_COMPLETIONS_PER_MESSAGE));
+  }
+  return batches;
+}
+function buildCompletionMessage(completions) {
+  if (completions.length === 1) {
+    const completion = completions[0];
+    return {
+      customType: SUBAGENT_COMPLETION_MESSAGE_TYPE,
+      content: buildDetachedCompletionMessage(completion),
+      display: true,
+      details: completionMetadata(completion)
+    };
+  }
+  const content = truncateUtf8(
+    [
+      "Message Type: SUBAGENT_COMPLETION_BATCH",
+      `Protocol: ${PI_SUBAGENTS_RPC_PROTOCOL}`,
+      `Completion Count: ${completions.length}`,
+      ...completions.flatMap((completion, index) => [
+        "",
+        `--- Completion ${index + 1} of ${completions.length} ---`,
+        buildDetachedCompletionMessage(completion)
+      ])
+    ].join("\n"),
+    DEFAULT_MAX_CONTEXT_BYTES
+  ).text;
+  return {
+    customType: SUBAGENT_COMPLETION_MESSAGE_TYPE,
+    content,
+    display: true,
+    details: {
+      completionCount: completions.length,
+      completions: completions.map(completionMetadata)
+    }
+  };
+}
+function completionMetadata(completion) {
+  return {
+    protocol: PI_SUBAGENTS_RPC_PROTOCOL,
+    completionId: completion.completionId,
+    runId: completion.runId,
+    generation: completion.generation,
+    agentId: completion.agent.id,
+    ...completion.agent.taskPath ? { taskPath: completion.agent.taskPath } : {},
+    ...completion.recipientPath ? { recipientPath: completion.recipientPath } : {},
+    agent: completion.agent.agent,
+    task: sanitizeCompletionLine(completion.task, 256) || "(unknown task)",
+    state: completion.agent.state,
+    ...completion.agent.telemetry?.transport ? { transport: completion.agent.telemetry.transport } : {},
+    ...completion.agent.structuredResult ? { structuredResult: completion.agent.structuredResult } : {},
+    ...completion.agent.outcome ? { outcome: completion.agent.outcome } : {},
+    ...completion.agent.capabilityGrant ? { capabilityGrant: completion.agent.capabilityGrant } : {}
+  };
+}
+function buildDetachedCompletionMessage(completion) {
+  const task = sanitizeCompletionLine(completion.task, 256) || "(unknown task)";
+  const agentName = sanitizeCompletionLine(completion.agent.agent, 128) || "(unknown agent)";
+  const output = safeTerminalText(redactPrivateText(completion.output));
+  const error = completion.error ? truncateUtf8(
+    safeTerminalText(redactPrivateText(completion.error)),
+    MAX_COMPLETION_ERROR_BYTES
+  ).text : "";
+  return truncateUtf8(
+    [
+      "Message Type: SUBAGENT_COMPLETION",
+      `Protocol: ${PI_SUBAGENTS_RPC_PROTOCOL}`,
+      `Completion ID: ${completion.completionId}`,
+      `Run ID: ${completion.runId}`,
+      `Generation: ${completion.generation}`,
+      `Agent ID: ${completion.agent.id}`,
+      ...completion.agent.taskPath ? [`Agent Path: ${completion.agent.taskPath}`] : [],
+      ...completion.recipientPath ? [`Recipient Path: ${completion.recipientPath}`] : [],
+      `Agent: ${agentName}`,
+      `Task: ${task}`,
+      `State: ${completion.agent.state}`,
+      ...error.trim() ? ["Error:", error] : [],
+      "Payload:",
+      output.trim() ? output : "(no output)"
+    ].join("\n"),
+    MAX_TOOL_MESSAGE_BYTES
+  ).text;
+}
+function sanitizeCompletionLine(value, maxBytes) {
+  return truncateUtf8(redactPrivateText(value), maxBytes).text.replace(/[\u0000-\u001f\u007f]+/g, " ").replace(/\s+/g, " ").trim();
+}
+
+export {
+  CompletionDeliveryBroker,
+  buildDetachedCompletionMessage
+};
+//# sourceMappingURL=chunk-434NII74.ts.map

package/dist/chunks/chunk-434NII74.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/completion-delivery.ts"],
+  "sourcesContent": ["import type { ExtensionAPI, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\nimport type { CompletionDelivery } from \"./agents/types.js\";\nimport { SUBAGENT_COMPLETION_MESSAGE_TYPE } from \"./completion-render.js\";\nimport { redactPrivateText } from \"./context.js\";\nimport { DEFAULT_MAX_CONTEXT_BYTES, MAX_TOOL_MESSAGE_BYTES, truncateUtf8 } from \"./limits.js\";\nimport type { AgentTurnCompletion, ManagedAgent } from \"./registry.js\";\nimport { safeTerminalText } from \"./safe-text.js\";\nimport { PI_SUBAGENTS_RPC_PROTOCOL } from \"./transport-types.js\";\n\nconst MAX_COMPLETION_ERROR_BYTES = 512;\nconst MAX_COMPLETIONS_PER_MESSAGE = 16;\nconst COMPLETION_BATCH_DELAY_MS = 10;\n\ninterface CompletionMetadata {\n\tprotocol: typeof PI_SUBAGENTS_RPC_PROTOCOL;\n\tcompletionId: string;\n\trunId: string;\n\tgeneration: number;\n\tagentId: string;\n\ttaskPath?: string;\n\trecipientPath?: string;\n\tagent: string;\n\ttask: string;\n\tstate: string;\n\ttransport?: string;\n\tstructuredResult?: ManagedAgent[\"structuredResult\"];\n\toutcome?: ManagedAgent[\"outcome\"];\n\tcapabilityGrant?: ManagedAgent[\"capabilityGrant\"];\n}\n\ninterface CompletionMessage {\n\tcustomType: typeof SUBAGENT_COMPLETION_MESSAGE_TYPE;\n\tcontent: string;\n\tdisplay: true;\n\tdetails:\n\t\t| CompletionMetadata\n\t\t| {\n\t\t\t\tcompletionCount: number;\n\t\t\t\tcompletions: CompletionMetadata[];\n\t\t  };\n}\n\ntype CompletionContext = Pick<ExtensionContext, \"hasPendingMessages\" | \"isIdle\">;\ntype CompletionPi = Pick<ExtensionAPI, \"sendMessage\">;\n\nexport interface CompletionDeliveryBrokerOptions {\n\tonDeliveryError?: (error: unknown) => void;\n\tonAcknowledged?: (completions: readonly AgentTurnCompletion[], acknowledgedAt: number) => void;\n\tnow?: () => number;\n}\n\n/** Owns bounded completion batching and at most one idle-root wake for one parent session. */\nexport class CompletionDeliveryBroker {\n\tprivate pending: AgentTurnCompletion[] = [];\n\tprivate readonly knownCompletionIds = new Set<string>();\n\tprivate awaitingParentAck: AgentTurnCompletion[] = [];\n\tprivate flushTimer?: NodeJS.Timeout;\n\tprivate wakeInFlight = false;\n\tprivate closed = false;\n\n\tconstructor(\n\t\tprivate readonly pi: CompletionPi,\n\t\tprivate readonly ctx: CompletionContext,\n\t\tprivate delivery: CompletionDelivery,\n\t\tprivate readonly options: CompletionDeliveryBrokerOptions = {},\n\t) {}\n\n\tenqueue(completion: AgentTurnCompletion): void {\n\t\tif (this.closed || this.knownCompletionIds.has(completion.completionId)) return;\n\t\tthis.knownCompletionIds.add(completion.completionId);\n\t\tthis.pending.push(completion);\n\t\tthis.scheduleFlush();\n\t}\n\n\tsetDelivery(value: CompletionDelivery): void {\n\t\tthis.delivery = value;\n\t\tthis.scheduleFlush();\n\t}\n\n\tonParentTurnStart(): void {\n\t\tthis.wakeInFlight = false;\n\t\tthis.scheduleFlush();\n\t}\n\n\tonParentContext(messages: readonly unknown[]): void {\n\t\tthis.acknowledgeVisible(completionIdsFromContext(messages));\n\t\tif (this.awaitingParentAck.length > 0) {\n\t\t\tthis.pending = [...this.awaitingParentAck.splice(0), ...this.pending];\n\t\t}\n\t\tthis.scheduleFlush();\n\t}\n\n\tonParentSettled(): void {\n\t\tthis.wakeInFlight = false;\n\t\tthis.scheduleFlush();\n\t}\n\n\tflush(): void {\n\t\tif (this.closed || this.pending.length === 0) return;\n\t\tif (this.flushTimer) clearTimeout(this.flushTimer);\n\t\tthis.flushTimer = undefined;\n\t\tif (this.delivery === \"auto-resume\" && !this.isRootIdle()) return;\n\n\t\tconst completions = this.pending.splice(0);\n\t\tconst batches = chunkCompletions(completions);\n\t\tlet canWake = this.shouldWakeRoot();\n\t\tfor (let index = 0; index < batches.length; index++) {\n\t\t\tconst triggerTurn = canWake && index === batches.length - 1;\n\t\t\tconst batch = batches[index];\n\t\t\tconst message = buildCompletionMessage(batch);\n\t\t\tif (triggerTurn) this.wakeInFlight = true;\n\t\t\tthis.awaitingParentAck.push(...batch);\n\t\t\ttry {\n\t\t\t\t// Pi treats explicit false as immediate insertion instead of queued steering while streaming.\n\t\t\t\tthis.pi.sendMessage(message, {\n\t\t\t\t\tdeliverAs: \"steer\",\n\t\t\t\t\t...(triggerTurn ? { triggerTurn: true } : {}),\n\t\t\t\t});\n\t\t\t} catch (primaryError) {\n\t\t\t\tthis.removeAwaiting(batch);\n\t\t\t\tif (triggerTurn) this.wakeInFlight = false;\n\t\t\t\tcanWake = false;\n\t\t\t\tthis.awaitingParentAck.push(...batch);\n\t\t\t\ttry {\n\t\t\t\t\tthis.pi.sendMessage(message, { deliverAs: \"nextTurn\", triggerTurn: false });\n\t\t\t\t} catch (fallbackError) {\n\t\t\t\t\tthis.removeAwaiting(batch);\n\t\t\t\t\tthis.pending = [...batches.slice(index).flat(), ...this.pending];\n\t\t\t\t\ttry {\n\t\t\t\t\t\tthis.options.onDeliveryError?.(\n\t\t\t\t\t\t\tnew AggregateError(\n\t\t\t\t\t\t\t\t[primaryError, fallbackError],\n\t\t\t\t\t\t\t\t\"Detached subagent completion delivery failed\",\n\t\t\t\t\t\t\t),\n\t\t\t\t\t\t);\n\t\t\t\t\t} catch {\n\t\t\t\t\t\t// Delivery retention must survive a failing observer.\n\t\t\t\t\t}\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tthis.closed = true;\n\t\tif (this.flushTimer) clearTimeout(this.flushTimer);\n\t\tthis.flushTimer = undefined;\n\t\tthis.pending = [];\n\t\tthis.awaitingParentAck = [];\n\t\tthis.knownCompletionIds.clear();\n\t}\n\n\tprivate scheduleFlush(): void {\n\t\tif (this.closed || this.pending.length === 0 || this.flushTimer) return;\n\t\tthis.flushTimer = setTimeout(() => {\n\t\t\tthis.flushTimer = undefined;\n\t\t\tthis.flush();\n\t\t}, COMPLETION_BATCH_DELAY_MS);\n\t}\n\n\tprivate acknowledgeVisible(visibleIds: ReadonlySet<string>): void {\n\t\tif (visibleIds.size === 0) return;\n\t\tconst completions = [...this.awaitingParentAck, ...this.pending].filter((completion) =>\n\t\t\tvisibleIds.has(completion.completionId),\n\t\t);\n\t\tif (completions.length === 0) return;\n\t\tconst acknowledgedIds = new Set(completions.map((completion) => completion.completionId));\n\t\tthis.awaitingParentAck = this.awaitingParentAck.filter(\n\t\t\t(completion) => !acknowledgedIds.has(completion.completionId),\n\t\t);\n\t\tthis.pending = this.pending.filter(\n\t\t\t(completion) => !acknowledgedIds.has(completion.completionId),\n\t\t);\n\t\tfor (const completion of completions) this.knownCompletionIds.delete(completion.completionId);\n\t\ttry {\n\t\t\tthis.options.onAcknowledged?.(completions, (this.options.now ?? Date.now)());\n\t\t} catch {\n\t\t\t// Context assembly already observed the message, so observer failures cannot retract it.\n\t\t}\n\t}\n\n\tprivate removeAwaiting(completions: readonly AgentTurnCompletion[]): void {\n\t\tconst removed = new Set(completions.map((completion) => completion.completionId));\n\t\tthis.awaitingParentAck = this.awaitingParentAck.filter(\n\t\t\t(completion) => !removed.has(completion.completionId),\n\t\t);\n\t}\n\n\tprivate isRootIdle(): boolean {\n\t\ttry {\n\t\t\treturn this.ctx.isIdle();\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tprivate shouldWakeRoot(): boolean {\n\t\tif (this.delivery !== \"auto-resume\" || this.wakeInFlight) return false;\n\t\ttry {\n\t\t\treturn !this.ctx.hasPendingMessages();\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n}\n\nfunction completionIdsFromContext(messages: readonly unknown[]): Set<string> {\n\tconst ids = new Set<string>();\n\tfor (const message of messages) {\n\t\tif (!message || typeof message !== \"object\" || Array.isArray(message)) continue;\n\t\tconst record = message as Record<string, unknown>;\n\t\tif (record.role !== \"custom\" || record.customType !== SUBAGENT_COMPLETION_MESSAGE_TYPE)\n\t\t\tcontinue;\n\t\tconst details = record.details;\n\t\tif (!details || typeof details !== \"object\" || Array.isArray(details)) continue;\n\t\tconst metadata = details as Record<string, unknown>;\n\t\tif (\n\t\t\tmetadata.protocol === PI_SUBAGENTS_RPC_PROTOCOL &&\n\t\t\ttypeof metadata.completionId === \"string\"\n\t\t) {\n\t\t\tids.add(metadata.completionId);\n\t\t}\n\t\tif (!Array.isArray(metadata.completions)) continue;\n\t\tfor (const completion of metadata.completions) {\n\t\t\tif (!completion || typeof completion !== \"object\" || Array.isArray(completion)) continue;\n\t\t\tconst item = completion as Record<string, unknown>;\n\t\t\tif (item.protocol === PI_SUBAGENTS_RPC_PROTOCOL && typeof item.completionId === \"string\") {\n\t\t\t\tids.add(item.completionId);\n\t\t\t}\n\t\t}\n\t}\n\treturn ids;\n}\n\nfunction chunkCompletions(completions: AgentTurnCompletion[]): AgentTurnCompletion[][] {\n\tconst batches: AgentTurnCompletion[][] = [];\n\tfor (let index = 0; index < completions.length; index += MAX_COMPLETIONS_PER_MESSAGE) {\n\t\tbatches.push(completions.slice(index, index + MAX_COMPLETIONS_PER_MESSAGE));\n\t}\n\treturn batches;\n}\n\nfunction buildCompletionMessage(completions: AgentTurnCompletion[]): CompletionMessage {\n\tif (completions.length === 1) {\n\t\tconst completion = completions[0];\n\t\treturn {\n\t\t\tcustomType: SUBAGENT_COMPLETION_MESSAGE_TYPE,\n\t\t\tcontent: buildDetachedCompletionMessage(completion),\n\t\t\tdisplay: true,\n\t\t\tdetails: completionMetadata(completion),\n\t\t};\n\t}\n\tconst content = truncateUtf8(\n\t\t[\n\t\t\t\"Message Type: SUBAGENT_COMPLETION_BATCH\",\n\t\t\t`Protocol: ${PI_SUBAGENTS_RPC_PROTOCOL}`,\n\t\t\t`Completion Count: ${completions.length}`,\n\t\t\t...completions.flatMap((completion, index) => [\n\t\t\t\t\"\",\n\t\t\t\t`--- Completion ${index + 1} of ${completions.length} ---`,\n\t\t\t\tbuildDetachedCompletionMessage(completion),\n\t\t\t]),\n\t\t].join(\"\\n\"),\n\t\tDEFAULT_MAX_CONTEXT_BYTES,\n\t).text;\n\treturn {\n\t\tcustomType: SUBAGENT_COMPLETION_MESSAGE_TYPE,\n\t\tcontent,\n\t\tdisplay: true,\n\t\tdetails: {\n\t\t\tcompletionCount: completions.length,\n\t\t\tcompletions: completions.map(completionMetadata),\n\t\t},\n\t};\n}\n\nfunction completionMetadata(completion: AgentTurnCompletion): CompletionMetadata {\n\treturn {\n\t\tprotocol: PI_SUBAGENTS_RPC_PROTOCOL,\n\t\tcompletionId: completion.completionId,\n\t\trunId: completion.runId,\n\t\tgeneration: completion.generation,\n\t\tagentId: completion.agent.id,\n\t\t...(completion.agent.taskPath ? { taskPath: completion.agent.taskPath } : {}),\n\t\t...(completion.recipientPath ? { recipientPath: completion.recipientPath } : {}),\n\t\tagent: completion.agent.agent,\n\t\ttask: sanitizeCompletionLine(completion.task, 256) || \"(unknown task)\",\n\t\tstate: completion.agent.state,\n\t\t...(completion.agent.telemetry?.transport\n\t\t\t? { transport: completion.agent.telemetry.transport }\n\t\t\t: {}),\n\t\t...(completion.agent.structuredResult\n\t\t\t? { structuredResult: completion.agent.structuredResult }\n\t\t\t: {}),\n\t\t...(completion.agent.outcome ? { outcome: completion.agent.outcome } : {}),\n\t\t...(completion.agent.capabilityGrant\n\t\t\t? { capabilityGrant: completion.agent.capabilityGrant }\n\t\t\t: {}),\n\t};\n}\n\nexport function buildDetachedCompletionMessage(completion: AgentTurnCompletion): string {\n\tconst task = sanitizeCompletionLine(completion.task, 256) || \"(unknown task)\";\n\tconst agentName = sanitizeCompletionLine(completion.agent.agent, 128) || \"(unknown agent)\";\n\tconst output = safeTerminalText(redactPrivateText(completion.output));\n\tconst error = completion.error\n\t\t? truncateUtf8(\n\t\t\t\tsafeTerminalText(redactPrivateText(completion.error)),\n\t\t\t\tMAX_COMPLETION_ERROR_BYTES,\n\t\t\t).text\n\t\t: \"\";\n\treturn truncateUtf8(\n\t\t[\n\t\t\t\"Message Type: SUBAGENT_COMPLETION\",\n\t\t\t`Protocol: ${PI_SUBAGENTS_RPC_PROTOCOL}`,\n\t\t\t`Completion ID: ${completion.completionId}`,\n\t\t\t`Run ID: ${completion.runId}`,\n\t\t\t`Generation: ${completion.generation}`,\n\t\t\t`Agent ID: ${completion.agent.id}`,\n\t\t\t...(completion.agent.taskPath ? [`Agent Path: ${completion.agent.taskPath}`] : []),\n\t\t\t...(completion.recipientPath ? [`Recipient Path: ${completion.recipientPath}`] : []),\n\t\t\t`Agent: ${agentName}`,\n\t\t\t`Task: ${task}`,\n\t\t\t`State: ${completion.agent.state}`,\n\t\t\t...(error.trim() ? [\"Error:\", error] : []),\n\t\t\t\"Payload:\",\n\t\t\toutput.trim() ? output : \"(no output)\",\n\t\t].join(\"\\n\"),\n\t\tMAX_TOOL_MESSAGE_BYTES,\n\t).text;\n}\n\nfunction sanitizeCompletionLine(value: string, maxBytes: number): string {\n\treturn (\n\t\ttruncateUtf8(redactPrivateText(value), maxBytes)\n\t\t\t// biome-ignore lint/suspicious/noControlCharactersInRegex: Strip untrusted terminal controls.\n\t\t\t.text.replace(/[\\u0000-\\u001f\\u007f]+/g, \" \")\n\t\t\t.replace(/\\s+/g, \" \")\n\t\t\t.trim()\n\t);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunks/chunk-47SK2QYC.ts

@@ -0,0 +1,56 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated JavaScript uses a .ts extension for Pi's Jiti loader.
+
+// src/outcome.ts
+var TRANSIENT_REASONS = /* @__PURE__ */ new Set(["transient-transport", "transient-tool"]);
+function classifyStructuredOutcome(status, reasonCode) {
+  if (TRANSIENT_REASONS.has(reasonCode ?? "") && status === "failed") {
+    return {
+      status,
+      ...reasonCode ? { reasonCode } : {},
+      recoveryActions: ["retry"],
+      retryable: true
+    };
+  }
+  const recoveryActions = recoveryFor(status, reasonCode);
+  return {
+    status,
+    ...reasonCode ? { reasonCode } : {},
+    recoveryActions,
+    retryable: false
+  };
+}
+function recoveryFor(status, reasonCode) {
+  if (reasonCode === "missing-dependency" || reasonCode === "missing-context") {
+    return ["supply-input"];
+  }
+  if (reasonCode === "ambiguous-task") return ["clarify"];
+  if (reasonCode === "capability-mismatch" || reasonCode === "authority-missing") {
+    return ["reroute"];
+  }
+  if (reasonCode === "dependency-superseded" || status === "stale") return ["revalidate"];
+  if (reasonCode === "verification-failed") return ["replan", "verify"];
+  if (reasonCode === "unsupported-guarantee") return ["stop"];
+  switch (status) {
+    case "completed":
+    case "partial":
+      return [];
+    case "needs-input":
+      return ["supply-input"];
+    case "blocked":
+      return ["clarify"];
+    case "abstained":
+      return ["reroute"];
+    case "contract-invalid":
+      return ["repair-contract"];
+    case "interrupted":
+      return ["stop"];
+    case "failed":
+      return ["stop"];
+  }
+}
+
+export {
+  classifyStructuredOutcome
+};
+//# sourceMappingURL=chunk-47SK2QYC.ts.map

package/dist/chunks/chunk-47SK2QYC.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/outcome.ts"],
+  "sourcesContent": ["import type { SubagentOutcomeStatus } from \"./result-contract.js\";\n\nexport interface ClassifiedSubagentOutcome {\n\tstatus: SubagentOutcomeStatus;\n\treasonCode?: string;\n\trecoveryActions: string[];\n\tretryable: boolean;\n}\n\nconst TRANSIENT_REASONS = new Set([\"transient-transport\", \"transient-tool\"]);\n\nexport function classifyStructuredOutcome(\n\tstatus: SubagentOutcomeStatus,\n\treasonCode?: string,\n): ClassifiedSubagentOutcome {\n\tif (TRANSIENT_REASONS.has(reasonCode ?? \"\") && status === \"failed\") {\n\t\treturn {\n\t\t\tstatus,\n\t\t\t...(reasonCode ? { reasonCode } : {}),\n\t\t\trecoveryActions: [\"retry\"],\n\t\t\tretryable: true,\n\t\t};\n\t}\n\tconst recoveryActions = recoveryFor(status, reasonCode);\n\treturn {\n\t\tstatus,\n\t\t...(reasonCode ? { reasonCode } : {}),\n\t\trecoveryActions,\n\t\tretryable: false,\n\t};\n}\n\nfunction recoveryFor(status: SubagentOutcomeStatus, reasonCode?: string): string[] {\n\tif (reasonCode === \"missing-dependency\" || reasonCode === \"missing-context\") {\n\t\treturn [\"supply-input\"];\n\t}\n\tif (reasonCode === \"ambiguous-task\") return [\"clarify\"];\n\tif (reasonCode === \"capability-mismatch\" || reasonCode === \"authority-missing\") {\n\t\treturn [\"reroute\"];\n\t}\n\tif (reasonCode === \"dependency-superseded\" || status === \"stale\") return [\"revalidate\"];\n\tif (reasonCode === \"verification-failed\") return [\"replan\", \"verify\"];\n\tif (reasonCode === \"unsupported-guarantee\") return [\"stop\"];\n\tswitch (status) {\n\t\tcase \"completed\":\n\t\tcase \"partial\":\n\t\t\treturn [];\n\t\tcase \"needs-input\":\n\t\t\treturn [\"supply-input\"];\n\t\tcase \"blocked\":\n\t\t\treturn [\"clarify\"];\n\t\tcase \"abstained\":\n\t\t\treturn [\"reroute\"];\n\t\tcase \"contract-invalid\":\n\t\t\treturn [\"repair-contract\"];\n\t\tcase \"interrupted\":\n\t\t\treturn [\"stop\"];\n\t\tcase \"failed\":\n\t\t\treturn [\"stop\"];\n\t}\n}\n"],
+  "mappings": ";;;;AASA,IAAM,oBAAoB,oBAAI,IAAI,CAAC,uBAAuB,gBAAgB,CAAC;AAEpE,SAAS,0BACf,QACA,YAC4B;AAC5B,MAAI,kBAAkB,IAAI,cAAc,EAAE,KAAK,WAAW,UAAU;AACnE,WAAO;AAAA,MACN;AAAA,MACA,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;AAAA,MACnC,iBAAiB,CAAC,OAAO;AAAA,MACzB,WAAW;AAAA,IACZ;AAAA,EACD;AACA,QAAM,kBAAkB,YAAY,QAAQ,UAAU;AACtD,SAAO;AAAA,IACN;AAAA,IACA,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;AAAA,IACnC;AAAA,IACA,WAAW;AAAA,EACZ;AACD;AAEA,SAAS,YAAY,QAA+B,YAA+B;AAClF,MAAI,eAAe,wBAAwB,eAAe,mBAAmB;AAC5E,WAAO,CAAC,cAAc;AAAA,EACvB;AACA,MAAI,eAAe,iBAAkB,QAAO,CAAC,SAAS;AACtD,MAAI,eAAe,yBAAyB,eAAe,qBAAqB;AAC/E,WAAO,CAAC,SAAS;AAAA,EAClB;AACA,MAAI,eAAe,2BAA2B,WAAW,QAAS,QAAO,CAAC,YAAY;AACtF,MAAI,eAAe,sBAAuB,QAAO,CAAC,UAAU,QAAQ;AACpE,MAAI,eAAe,wBAAyB,QAAO,CAAC,MAAM;AAC1D,UAAQ,QAAQ;AAAA,IACf,KAAK;AAAA,IACL,KAAK;AACJ,aAAO,CAAC;AAAA,IACT,KAAK;AACJ,aAAO,CAAC,cAAc;AAAA,IACvB,KAAK;AACJ,aAAO,CAAC,SAAS;AAAA,IAClB,KAAK;AACJ,aAAO,CAAC,SAAS;AAAA,IAClB,KAAK;AACJ,aAAO,CAAC,iBAAiB;AAAA,IAC1B,KAAK;AACJ,aAAO,CAAC,MAAM;AAAA,IACf,KAAK;AACJ,aAAO,CAAC,MAAM;AAAA,EAChB;AACD;",
+  "names": []
+}