@brainpilot/runtime 0.0.4 → 0.0.6

package/dist/extensions/agent-status.js

@@ -0,0 +1,103 @@
+/**
+ * agent-status — a Pi-native extension that injects a fresh team-status block
+ * at the top of EVERY turn for the agent it is registered on (#97).
+ *
+ * Why an extension / the `context` hook (not the system prompt):
+ *  - The per-role persona is injected via `appendSystemPrompt`, which Pi
+ *    evaluates ONCE at session creation. A team-status snapshot put there would
+ *    be frozen at "session start" and go stale immediately.
+ *  - Pi's `context` hook fires before EACH LLM call (every turn within a run)
+ *    and lets an extension non-destructively rewrite the `messages` array that
+ *    is sent to the model. That rewrite is per-turn EPHEMERAL — it is applied to
+ *    a local copy and is NOT persisted to the session history (events.jsonl).
+ *    So a status block injected here is recomputed and current on every turn,
+ *    and never accumulates stale snapshots on disk.
+ *
+ * Mechanism (Pi SDK, verified against the docs corpus):
+ *  - Registered per-AgentSession via DefaultResourceLoader.extensionFactories,
+ *    same as trace-reminder. Closure state is naturally per-agent.
+ *  - `context` handler receives `{ messages }` (a safe-to-mutate copy) and may
+ *    return `{ messages }` to replace what the model sees this turn.
+ *  - Because the host appends a NEW block each turn, we first STRIP any block we
+ *    injected on a previous turn (identified by the `<agent_status>` opener) so
+ *    the model only ever sees the latest snapshot, not a pile of old ones.
+ *
+ * Only the real factory loads this — the mock has no Pi event loop, so the
+ * behavioural injection is verified in real mode. The pure block renderer
+ * (`renderAgentStatusBlock`) and the strip/inject logic are unit-tested here via
+ * a fake `pi`.
+ */
+/** Opening tag — also the marker used to recognise a block we injected before. */
+const TAG_OPEN = "<agent_status>";
+const TAG_CLOSE = "</agent_status>";
+/**
+ * Build the team-status block as a natural-language list (#97, option B). The
+ * wording is self-explanatory so the model needs no schema knowledge: each line
+ * names an agent, its status, and how many messages are still waiting unread in
+ * its inbox. Returns "" when there is nothing to report (caller skips injection).
+ *
+ * `lines` should already be filtered by the caller (trace agent excluded,
+ * stopped agents excluded). Order is preserved.
+ */
+export function renderAgentStatusBlock(lines) {
+    if (lines.length === 0)
+        return "";
+    const body = lines
+        .map((l) => {
+        const n = l.unread;
+        const msg = `${n} unread message${n === 1 ? "" : "s"}`;
+        return `- ${l.name}: ${l.status}, ${msg}`;
+    })
+        .join("\n");
+    return (`${TAG_OPEN}\n` +
+        `Current agents (status, and how many messages are still waiting unread in each inbox):\n` +
+        `${body}\n` +
+        `${TAG_CLOSE}`);
+}
+/**
+ * Collect the status lines for a team snapshot from the live agents (#97).
+ * Includes every agent — INCLUDING the principal, so it sees its own backlog —
+ * except the trace agent (an internal recorder) and any stopped agent
+ * (destroyed; irrelevant to coordination). `unreadOf` returns the number of
+ * messages still queued unread in that agent's inbox. Order follows iteration.
+ */
+export function collectAgentStatusLines(agents, unreadOf) {
+    const lines = [];
+    for (const a of agents) {
+        if (a.role === "trace")
+            continue;
+        if (a.status === "stopped")
+            continue;
+        lines.push({ name: a.name, status: a.status, unread: unreadOf(a.name) });
+    }
+    return lines;
+}
+/** True for a `user` message whose text is a status block we injected earlier. */
+function isStatusMessage(m) {
+    return (m.role === "user" &&
+        m.content.some((c) => c.type === "text" && (c.text ?? "").startsWith(TAG_OPEN)));
+}
+/**
+ * Build the extension factory for one agent. The returned function is what Pi
+ * calls with the per-session `ExtensionAPI`.
+ */
+export function makeAgentStatusExt(deps) {
+    return (pi) => {
+        pi.on("context", (e) => {
+            const block = deps.renderStatus();
+            // Strip any block we injected on a previous turn so only the latest
+            // snapshot survives (the context copy is ephemeral — this never touches
+            // persisted history).
+            const stripped = e.messages.filter((m) => !isStatusMessage(m));
+            const removedSome = stripped.length !== e.messages.length;
+            if (!block) {
+                // Nothing to report this turn. Only return a rewrite if we actually
+                // removed a stale block; otherwise leave the messages untouched.
+                return removedSome ? { messages: stripped } : undefined;
+            }
+            stripped.push({ role: "user", content: [{ type: "text", text: block }] });
+            return { messages: stripped };
+        });
+    };
+}
+//# sourceMappingURL=agent-status.js.map

package/dist/extensions/agent-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-status.js","sourceRoot":"","sources":["../../src/extensions/agent-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAWH,kFAAkF;AAClF,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AAClC,MAAM,SAAS,GAAG,iBAAiB,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAiC;IACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACnB,MAAM,GAAG,GAAG,GAAG,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;IAC5C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,CACL,GAAG,QAAQ,IAAI;QACf,0FAA0F;QAC1F,GAAG,IAAI,IAAI;QACX,GAAG,SAAS,EAAE,CACf,CAAC;AACJ,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAiC,EACjC,QAAkC;IAElC,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,SAAS;QACjC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAyBD,kFAAkF;AAClF,SAAS,eAAe,CAAC,CAAmB;IAC1C,OAAO,CACL,CAAC,CAAC,IAAI,KAAK,MAAM;QACjB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAChF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAClC,oEAAoE;YACpE,wEAAwE;YACxE,sBAAsB;YACtB,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/D,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;YAE1D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,oEAAoE;gBACpE,iEAAiE;gBACjE,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAC1E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/extensions/trace-reminder.d.ts

@@ -0,0 +1,94 @@
+/**
+ * trace-reminder — the one Pi-native extension (replaces #79 captureMilestone).
+ *
+ * Philosophy (vs. #79): the host no longer writes trace nodes on the agent's
+ * behalf. Instead we REMIND the agent at the right moment and let it decide:
+ *  - 意图一 (work leaves a trace): if a run ended without record_trace, nudge.
+ *    Applies to BOTH principal and expert (every non-trace role), not just PI.
+ *  - 意图二 (expert results flow back): if an expert run produced work but never
+ *    send_message'd the principal, nudge; if it still won't, the host writes a
+ *    fallback note into the principal's mailbox so the PI never dead-waits.
+ *  - 意图三 (PI keeps to delegation): if the principal does substantive work
+ *    directly without delegating, append a soft reminder to the tool result.
+ *  - 意图四 (resource awareness): on a tool error, append a soft hint that the
+ *    knowledge tools / record_trace exist. (Static identity lives in personas.)
+ *
+ * 意图一 and 意图二 are ORTHOGONAL checks (B): an expert can owe both a trace
+ * and a reply. They limit independently (A — separate counters), but when BOTH
+ * lapse at the same run end they collapse into ONE merged reminder rather than
+ * two separate followUps (fewer round-trips).
+ *
+ * Mechanism (Pi SDK v0.79, verified against installed d.ts + real provider):
+ *  - Registered per-AgentSession via DefaultResourceLoader.extensionFactories.
+ *    Closure state is therefore naturally isolated per agent.
+ *  - One prompt() == one agent loop (agent_start…agent_end) spanning MANY turns.
+ *    "Did the work" flags are RUN-scoped (reset on agent_start, accumulated
+ *    across turns) — resetting them on turn_start was the false-report bug.
+ *  - `agent_end` / `turn_*` are pure notifications (no return value, cannot
+ *    block). The ONLY "force continue" lever is `pi.sendUserMessage(text,
+ *    {deliverAs:"followUp"})` inside `agent_end`: it releases the current stop
+ *    and starts a NEW agent loop (a fresh agent_start) — which is why the
+ *    anti-loop counters must NOT reset on agent_start.
+ *  - `tool_result` MAY return `{content}` to rewrite the result text — used for
+ *    the soft reminders (意图三/四).
+ */
+import type { AgentRole } from "../types.js";
+/** Minimal structural surface of Pi's ExtensionAPI we depend on. */
+interface PiExtensionApi {
+    on(event: "agent_start", handler: () => void): void;
+    on(event: "tool_execution_start", handler: (e: {
+        toolName: string;
+        args?: unknown;
+    }) => void): void;
+    on(event: "tool_execution_end", handler: (e: {
+        toolName: string;
+        isError: boolean;
+    }) => void): void;
+    on(event: "tool_result", handler: (e: {
+        toolName: string;
+        isError: boolean;
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+    }) => {
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    } | void): void;
+    on(event: "agent_end", handler: (e: AgentEndLike) => void): void;
+    sendUserMessage(content: string, options?: {
+        deliverAs?: "steer" | "followUp";
+    }): void;
+}
+/**
+ * Structural slice of Pi's `AgentEndEvent` we read: the run's message list, used
+ * only to detect whether the run ENDED IN AN ERROR (last assistant message's
+ * `stopReason`). A provider failure (401, retry exhausted, mid-stream error) is
+ * encoded by Pi as a final AssistantMessage with `stopReason: "error" |
+ * "aborted"` — it does NOT throw. When that's the case the host owns recovery
+ * (#97 self-retry / escalation), so this extension must NOT also nudge/followUp.
+ */
+interface AgentEndLike {
+    messages?: Array<{
+        role?: string;
+        stopReason?: string;
+    }>;
+}
+export interface TraceReminderDeps {
+    role: AgentRole;
+    name: string;
+    /**
+     * 意图二 fallback: invoked when an expert was reminded once and STILL did not
+     * report back. The host writes a note into the principal's mailbox.
+     */
+    onUnreplied: (agentName: string) => void;
+}
+/**
+ * Build the extension factory for one agent. The returned function is what Pi
+ * calls with the per-session `ExtensionAPI`.
+ */
+export declare function makeTraceReminderExt(deps: TraceReminderDeps): (pi: PiExtensionApi) => void;
+export {};
+//# sourceMappingURL=trace-reminder.d.ts.map

package/dist/extensions/trace-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-reminder.d.ts","sourceRoot":"","sources":["../../src/extensions/trace-reminder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,oEAAoE;AACpE,UAAU,cAAc;IACtB,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACpD,EAAE,CAAC,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACpG,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACpG,EAAE,CACA,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,CAAC,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACjD,KAAK;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI,GAC9D,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI,CAAC;IACjE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;CACxF;AAED;;;;;;;GAOG;AACH,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D;AAeD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AA2BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAyH1F"}

package/dist/extensions/trace-reminder.js

@@ -0,0 +1,153 @@
+/** True when the run's last assistant message ended in an error/abort. */
+function endedInError(e) {
+    const msgs = e.messages;
+    if (!Array.isArray(msgs))
+        return false;
+    for (let i = msgs.length - 1; i >= 0; i--) {
+        const m = msgs[i];
+        if (m?.role === "assistant") {
+            return m.stopReason === "error" || m.stopReason === "aborted";
+        }
+    }
+    return false;
+}
+/**
+ * Management/coordination tools that are legitimate for a principal to call
+ * directly — they don't count as "doing the work itself" (意图三 exemption).
+ */
+const MGMT_TOOLS = new Set([
+    "create_agent",
+    "destroy_agent",
+    "record_trace",
+    "send_message",
+    "ask_user",
+    "get_trace_graph",
+]);
+const TRACE_REMINDER = "你本轮做了实质工作但尚未调用 record_trace。如果这步值得留痕，请调用 record_trace 记录后再结束。";
+const EXPERT_REPLY_REMINDER = "你尚未通过 send_message(to=\"principal\", ...) 把结果回交给 Principal。请回交结果，否则 Principal 收不到你的产出。";
+const MERGED_REMINDER = "你本轮尚未回交结果，也未记录关键决策。结束前请：" +
+    "① 用 send_message(to=\"principal\", ...) 回交结果；" +
+    "② 用 record_trace 记录关键决策。";
+const DELEGATE_REMINDER = "[提醒：作为 Principal，实质工作应委派给专家，而不是自己埋头执行。]";
+const TOOL_FAILURE_REMINDER = "[提醒：该工具调用失败。可用 record_trace 记录这次失败，或借助知识库/检索工具寻找替代方案。]";
+/**
+ * Build the extension factory for one agent. The returned function is what Pi
+ * calls with the per-session `ExtensionAPI`.
+ */
+export function makeTraceReminderExt(deps) {
+    return (pi) => {
+        // Per-RUN flags — reset on agent_start (NOT turn_start). A single prompt()
+        // is one agent loop (agent_start…agent_end) spanning MANY turns, and a model
+        // naturally calls a tool in one turn then writes its closing sentence in the
+        // NEXT (tool-less) turn. Resetting on turn_start wiped the earlier turn's
+        // success, so agent_end only ever saw the last turn and falsely reported the
+        // work as undone. Keyed to the run, these accumulate across all its turns.
+        let traced = false;
+        let replied = false;
+        let delegated = false;
+        let delegateRemindCount = 0;
+        // ⚠️ Cross-run-CHAIN counters — MUST NOT reset on agent_start/turn_start nor
+        // at the top of agent_end. sendUserMessage(followUp) starts a NEW agent loop
+        // (verified: a followUp fires a fresh agent_start) whose end re-enters
+        // agent_end; if these were cleared we would re-remind forever. They are reset
+        // ONLY at the terminal exits below (dimension satisfied, or already reminded
+        // once → fallback/let-go). Decoupled per dimension (A) so a trace reminder
+        // and a reply reminder limit independently.
+        let traceRemindCount = 0;
+        let replyRemindCount = 0;
+        pi.on("agent_start", () => {
+            traced = false;
+            replied = false;
+            delegated = false;
+            delegateRemindCount = 0;
+        });
+        // tool_execution_start: nothing required for accounting (we key off
+        // tool_execution_end which carries success/failure). Kept as a no-op anchor
+        // so the wiring is obvious if richer arg capture is needed later.
+        pi.on("tool_execution_end", (e) => {
+            if (e.isError)
+                return; // only successful calls count toward "did the work"
+            const t = e.toolName;
+            if (t === "record_trace" || t.startsWith("create_trace"))
+                traced = true;
+            if (t === "send_message")
+                replied = true;
+            if (t === "create_agent")
+                delegated = true;
+        });
+        pi.on("tool_result", (e) => {
+            // 意图四 (failure hint) takes precedence; 意图三 (over-step) can stack.
+            let suffix = "";
+            if (e.isError) {
+                suffix += `\n${TOOL_FAILURE_REMINDER}`;
+            }
+            if (deps.role === "principal" &&
+                !delegated &&
+                !MGMT_TOOLS.has(e.toolName) &&
+                delegateRemindCount < 1) {
+                delegateRemindCount++;
+                suffix += `\n${DELEGATE_REMINDER}`;
+            }
+            if (!suffix)
+                return; // no rewrite — leave the result untouched
+            // Rewrite by appending to the existing text content; the tool still ran.
+            const text = e.content.map((c) => (c.type === "text" ? c.text ?? "" : "")).join("");
+            return { content: [{ type: "text", text: `${text}${suffix}` }] };
+        });
+        pi.on("agent_end", (e) => {
+            if (deps.role === "trace")
+                return; // the recorder itself — never nudge.
+            // #97: if THIS run ended in an error (provider 401 / retry exhausted /
+            // mid-stream failure), bail entirely. A followUp here would just re-hit the
+            // broken provider, and onUnreplied would mislabel an error as silence. The
+            // host's delivery-loop error path owns recovery (self-retry / escalation).
+            if (endedInError(e))
+                return;
+            // Two ORTHOGONAL checks (B). Both can be true for one expert (it produced
+            // work worth tracing AND owes the principal a reply).
+            //  - 留痕 (trace): every non-trace role is nudged unconditionally when it
+            //    ends a run without a record_trace.
+            //  - 回交 (reply): only an expert has a principal to report back to.
+            const needTrace = !traced;
+            const needReply = deps.role !== "principal" && !replied;
+            // A satisfied dimension resets its own counter (so a later real lapse is
+            // nudged afresh).
+            if (!needTrace)
+                traceRemindCount = 0;
+            if (!needReply)
+                replyRemindCount = 0;
+            const canTrace = needTrace && traceRemindCount < 1;
+            const canReply = needReply && replyRemindCount < 1;
+            // Both lapsed and both still nudge-able → ONE merged reminder, not two.
+            if (canTrace && canReply) {
+                traceRemindCount++;
+                replyRemindCount++;
+                pi.sendUserMessage(MERGED_REMINDER, { deliverAs: "followUp" });
+                return;
+            }
+            if (canReply) {
+                replyRemindCount++;
+                pi.sendUserMessage(EXPERT_REPLY_REMINDER, { deliverAs: "followUp" });
+                return;
+            }
+            if (canTrace) {
+                traceRemindCount++;
+                pi.sendUserMessage(TRACE_REMINDER, { deliverAs: "followUp" });
+                return;
+            }
+            // Nothing left to nudge (each lapsed dimension was already reminded once).
+            // Terminal handling per dimension:
+            //  - reply has a host fallback so the principal never dead-waits;
+            //  - trace has none (PI/expert self-decides) — just let it go.
+            // ⚠️ counters reset only here (the already-reminded terminal exit).
+            if (needReply) {
+                deps.onUnreplied(deps.name);
+                replyRemindCount = 0;
+            }
+            if (needTrace) {
+                traceRemindCount = 0;
+            }
+        });
+    };
+}
+//# sourceMappingURL=trace-reminder.js.map

package/dist/extensions/trace-reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-reminder.js","sourceRoot":"","sources":["../../src/extensions/trace-reminder.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -23,5 +23,7 @@ export { createServer, startServer } from "./server.js";
 export type { StartServerOptions } from "./server.js";
 export { McpBridge, loadMcpServersConfig, defaultMcpConnect } from "./mcp-bridge.js";
 export type { McpServersConfig, McpServerSpec, McpClientLike, McpConnectFn } from "./mcp-bridge.js";
+export { materializeSkills, resolveBundledSkillsDir } from "./materialize-skills.js";
+export type { MaterializeSkillsResult } from "./materialize-skills.js";
 export type { AgentRole, IAgentSession, AgentSessionFactory, PiAgentEvent, PiAssistantMessageEvent, SystemTool, SystemToolResult, EventListener, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrF,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpG,YAAY,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,wBAAwB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrF,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpG,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACrF,YAAY,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,YAAY,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -17,4 +17,5 @@ export { allSystemTools, systemToolsForRole, systemToolNamesForRole, builtinTool
 export { PERSONAS, BUILTIN_PERSONA_NAMES, personaFor, } from "./personas.js";
 export { createServer, startServer } from "./server.js";
 export { McpBridge, loadMcpServersConfig, defaultMcpConnect } from "./mcp-bridge.js";
+export { materializeSkills, resolveBundledSkillsDir } from "./materialize-skills.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EACL,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGrF,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/mailbox.d.ts

@@ -6,6 +6,23 @@ export interface MailboxMessage {
     msgType: MsgType;
     timestamp: number;
 }
+/** Per-agent inbox capacity (#76). A write past this is rejected. */
+export declare const MAX_INBOX = 20;
+/**
+ * Default batch limits for one delivery turn (#76). The loop drains at most
+ * `BATCH_MAX_MESSAGES`, and stops early once the accumulated content would
+ * exceed `BATCH_MAX_CHARS` — except the FIRST message is always taken even if it
+ * alone exceeds the budget (so an oversized message is delivered on its own
+ * rather than stranded forever).
+ */
+export declare const BATCH_MAX_MESSAGES = 3;
+export declare const BATCH_MAX_CHARS = 24000;
+/** Thrown by `write` when the target inbox is at capacity. */
+export declare class MailboxFullError extends Error {
+    readonly agent: string;
+    readonly limit: number;
+    constructor(agent: string, limit: number);
+}
 export declare class Mailbox {
     readonly sessionId: string;
     private readonly baseDir?;
@@ -13,12 +30,31 @@ export declare class Mailbox {
     private writeChain;
     constructor(sessionId: string, baseDir?: string | undefined);
     private inbox;
-    /** Write a message to `toAgent`'s inbox (in-memory + persisted). */
+    /**
+     * Write a message to `toAgent`'s inbox (in-memory + persisted). Throws
+     * `MailboxFullError` when the inbox is already at `MAX_INBOX` (#76 backpressure
+     * — keeps a runaway ping-pong from growing the inbox without bound).
+     */
     write(msg: Omit<MailboxMessage, "timestamp"> & {
         timestamp?: number;
     }): Promise<void>;
     /** Atomically drain `agent`'s inbox (returns messages, clears the box). */
     read(agent: string): Promise<MailboxMessage[]>;
+    /**
+     * Drain a bounded batch from the FRONT of `agent`'s inbox (#76). Takes up to
+     * `maxMessages`, stopping early once including the next message would push the
+     * accumulated content past `maxChars` — except the first message is always
+     * taken (an oversized message ships alone rather than stranding). Remaining
+     * messages stay queued in order for the next turn. FIFO preserved.
+     */
+    readBatch(agent: string, maxMessages?: number, maxChars?: number): Promise<MailboxMessage[]>;
+    /**
+     * Drain EVERY inbox (in-memory + persisted) so no queued message can re-wake
+     * an agent. Used by whole-session interrupt (#90 Stop): after aborting all
+     * agents we clear their mailboxes, otherwise the delivery loop would re-deliver
+     * pending messages and revive the agents the user just stopped.
+     */
+    clearAll(): Promise<void>;
     /** Non-destructive peek. */
     peek(agent: string): readonly MailboxMessage[];
     count(agent: string): number;

package/dist/mailbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../src/mailbox.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,OAAO,GACf,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,OAAO;IAKhB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAL3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,UAAU,CAAoC;gBAG3C,SAAS,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC,OAAO,CAAC,KAAK;IASb,oEAAoE;IAC9D,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3F,2EAA2E;IACrE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOpD,4BAA4B;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE;IAI9C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,OAAO,CAAC,SAAS;YAKH,OAAO;IAarB,4EAA4E;IACtE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../src/mailbox.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,OAAO,GACf,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,aAAa,GACb,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qEAAqE;AACrE,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,8DAA8D;AAC9D,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAArC,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,MAAM;CAI3D;AAED,qBAAa,OAAO;IAKhB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAL3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,UAAU,CAAoC;gBAG3C,SAAS,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,MAAM,YAAA;IAGnC,OAAO,CAAC,KAAK;IASb;;;;OAIG;IACG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3F,2EAA2E;IACrE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAOpD;;;;;;OAMG;IACG,SAAS,CACb,KAAK,EAAE,MAAM,EACb,WAAW,SAAqB,EAChC,QAAQ,SAAkB,GACzB,OAAO,CAAC,cAAc,EAAE,CAAC;IAkB5B;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAU/B,4BAA4B;IAC5B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,cAAc,EAAE;IAI9C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAI5B,OAAO,CAAC,SAAS;YAKH,OAAO;IAarB,4EAA4E;IACtE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/mailbox.js

@@ -7,9 +7,36 @@
  *
  * Delivery semantics (ported from legacy `mailbox.py`): reading an inbox
  * atomically drains it (avoids re-delivery). Writes append.
+ *
+ * Backpressure (#76): an inbox is capped at `MAX_INBOX` messages. A write past
+ * the cap throws `MailboxFullError` so the sending tool surfaces the failure to
+ * its agent (Pi signals tool failure by throwing) instead of letting a runaway
+ * agent↔agent ping-pong grow the inbox without bound.
  */
 import { mkdir, readFile, writeFile, readdir } from "node:fs/promises";
 import { join } from "node:path";
+/** Per-agent inbox capacity (#76). A write past this is rejected. */
+export const MAX_INBOX = 20;
+/**
+ * Default batch limits for one delivery turn (#76). The loop drains at most
+ * `BATCH_MAX_MESSAGES`, and stops early once the accumulated content would
+ * exceed `BATCH_MAX_CHARS` — except the FIRST message is always taken even if it
+ * alone exceeds the budget (so an oversized message is delivered on its own
+ * rather than stranded forever).
+ */
+export const BATCH_MAX_MESSAGES = 3;
+export const BATCH_MAX_CHARS = 24_000;
+/** Thrown by `write` when the target inbox is at capacity. */
+export class MailboxFullError extends Error {
+    agent;
+    limit;
+    constructor(agent, limit) {
+        super(`mailbox for "${agent}" is full (limit ${limit}); message rejected`);
+        this.agent = agent;
+        this.limit = limit;
+        this.name = "MailboxFullError";
+    }
+}
 export class Mailbox {
     sessionId;
     baseDir;
@@ -27,10 +54,17 @@ export class Mailbox {
         }
         return box;
     }
-    /** Write a message to `toAgent`'s inbox (in-memory + persisted). */
+    /**
+     * Write a message to `toAgent`'s inbox (in-memory + persisted). Throws
+     * `MailboxFullError` when the inbox is already at `MAX_INBOX` (#76 backpressure
+     * — keeps a runaway ping-pong from growing the inbox without bound).
+     */
     async write(msg) {
+        const box = this.inbox(msg.toAgent);
+        if (box.length >= MAX_INBOX)
+            throw new MailboxFullError(msg.toAgent, MAX_INBOX);
         const full = { ...msg, timestamp: msg.timestamp ?? Date.now() };
-        this.inbox(full.toAgent).push(full);
+        box.push(full);
         await this.persist(full.toAgent);
     }
     /** Atomically drain `agent`'s inbox (returns messages, clears the box). */
@@ -41,6 +75,49 @@ export class Mailbox {
             await this.persist(agent);
         return out;
     }
+    /**
+     * Drain a bounded batch from the FRONT of `agent`'s inbox (#76). Takes up to
+     * `maxMessages`, stopping early once including the next message would push the
+     * accumulated content past `maxChars` — except the first message is always
+     * taken (an oversized message ships alone rather than stranding). Remaining
+     * messages stay queued in order for the next turn. FIFO preserved.
+     */
+    async readBatch(agent, maxMessages = BATCH_MAX_MESSAGES, maxChars = BATCH_MAX_CHARS) {
+        const box = this.inbox(agent);
+        if (box.length === 0)
+            return [];
+        const take = [];
+        let chars = 0;
+        for (const m of box) {
+            if (take.length >= maxMessages)
+                break;
+            const next = chars + m.content.length;
+            // Always take the first; otherwise respect the char budget.
+            if (take.length > 0 && next > maxChars)
+                break;
+            take.push(m);
+            chars = next;
+        }
+        box.splice(0, take.length);
+        await this.persist(agent);
+        return take;
+    }
+    /**
+     * Drain EVERY inbox (in-memory + persisted) so no queued message can re-wake
+     * an agent. Used by whole-session interrupt (#90 Stop): after aborting all
+     * agents we clear their mailboxes, otherwise the delivery loop would re-deliver
+     * pending messages and revive the agents the user just stopped.
+     */
+    async clearAll() {
+        const agents = [...this.inboxes.keys()];
+        for (const agent of agents) {
+            const box = this.inbox(agent);
+            if (box.length === 0)
+                continue;
+            box.length = 0;
+            await this.persist(agent);
+        }
+    }
     /** Non-destructive peek. */
     peek(agent) {
         return [...this.inbox(agent)];

package/dist/mailbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../src/mailbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAiBjC,MAAM,OAAO,OAAO;IAKP;IACQ;IALF,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IACvD,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtD,YACW,SAAiB,EACT,OAAgB;QADxB,cAAS,GAAT,SAAS,CAAQ;QACT,YAAO,GAAP,OAAO,CAAS;IAChC,CAAC;IAEI,KAAK,CAAC,KAAa;QACzB,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,KAAK,CAAC,GAA+D;QACzE,MAAM,IAAI,GAAmB,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAChF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC,KAAa;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAClC,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAa;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU;aAC9B,IAAI,CAAC,KAAK,IAAI,EAAE;YACf,MAAM,KAAK,CAAC,IAAI,CAAC,OAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnB,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,KAAe,CAAC;QACpB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,qBAAqB;QAC/B,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACnC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;gBACjD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;oBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"mailbox.js","sourceRoot":"","sources":["../src/mailbox.ts"],"names":[],"mappings":"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"}