@brainpilot/runtime 0.0.5 → 0.0.6

package/README.md

@@ -0,0 +1,61 @@
+# @brainpilot/runtime
+
+The orchestration runtime for **BrainPilot** — the open-source, single-user
+multi-agent platform built on TypeScript + the [Pi SDK](https://pi.dev). This
+package owns the agent lifecycle and is the **state authority**: a Principal
+agent coordinating specialist agents over a file-based mailbox, exposed as a
+Hono + SSE server.
+
+It is consumed by `@brainpilot/backend-core` (which proxies to it as a stateless
+byte-passthrough) and, in hosted deployments, by the platform layer.
+
+## What lives here
+
+- `SessionManager` — session lifecycle, agent registry, **state authority**
+  (`status = idle | running | error | stopped`), `metrics()`.
+- `MasAgent` — per-agent wrapper over a Pi `AgentSession`; emits AG-UI events.
+- System tools + access control, the external-MCP bridge, Graph-of-Trace.
+- The Hono server (`./server`) with the SSE event stream.
+
+All wire types come from `@brainpilot/protocol` (the zod SSOT).
+
+## Liveness contract (R-3)
+
+The runtime imposes **no fixed wall-clock cap on a single agent turn.** A
+multi-hour research run is never killed by a timer. Liveness is
+**activity-based, not duration-based.**
+
+**Guarantees:**
+
+1. **No per-turn / per-prompt hard timeout.** There is no `120s`-style cap; the
+   TS runtime has no turn cap at all. (The only `timeout` in this package is the
+   provider connectivity **probe**, unrelated to agent turns.)
+2. **A turn ends only on a real terminal condition** — the agent finishes the
+   run, the run errors, or it is **explicitly aborted** via
+   `SessionManager.interrupt(sessionId, agentName?)` (user stop) or
+   `SessionManager.evictSession(sessionId)` (idle reclaim / shutdown). The
+   runtime never aborts a turn on a timer of its own.
+3. **No inactivity timeout either.** Silence is not treated as death.
+
+**Liveness signal** — `SessionManager.metrics()` (served at `GET /metrics`) is
+the authority a hosting layer should use:
+
+| field | meaning |
+|-------|---------|
+| `runningAgents` | count of agents currently in `status === "running"` |
+| `lastActivityAt` | ISO timestamp, advanced on **every** emitted event / state change (prompt accepted, status transition, run finished, …) |
+
+**"Still alive" = `runningAgents > 0`, or a recently-advanced `lastActivityAt`.**
+An idle reaper must key off these — never off elapsed wall-clock since the
+prompt started. As long as a long-running agent keeps `runningAgents > 0` (or
+keeps advancing `lastActivityAt`), it must not be reaped.
+
+**Bash / tool calls** run inside the Pi SDK. The runtime adds no bash tool of
+its own and configures no Pi turn/tool timeout. A separately configurable
+per-tool timeout (e.g. a ~30min bash default) would belong at the Pi-SDK tool
+layer and would not change the turn-liveness contract above.
+
+**Validate end-to-end:** start a session, issue a prompt that runs longer than
+any historical timeout, and poll `GET /metrics` — the run stays alive
+(`runningAgents > 0`, `lastActivityAt` advancing) until the agent itself
+completes, with no runtime-initiated abort.

package/dist/agent-error.d.ts

@@ -0,0 +1,51 @@
+/**
+ * agent-error.ts — normalize raw agent/SDK error messages before they reach
+ * the user-facing event stream and events.jsonl (issues #45, #97).
+ *
+ * Three jobs:
+ *  1. Recognize the "no provider / no API key" case and replace the raw Pi SDK
+ *     guidance (which points at `/login` and absolute node_modules doc paths)
+ *     with a product-level message that points at BrainPilot's own Settings →
+ *     Providers flow.
+ *  2. Recognize a provider HTTP error (e.g. `401 {"error":{...}}`) and split it
+ *     into a concise, localized headline (`message`) and the full raw blob
+ *     (`details`), so the chat bubble shows a short line and tucks the provider
+ *     internals / request id behind an expandable section instead of dumping
+ *     escaped JSON into the primary transcript (#97).
+ *  3. Redact local filesystem leakage (absolute node_modules paths, `/login`
+ *     hints) from any other error, so we never persist or display internal
+ *     install paths.
+ *
+ * Language follows the existing runtime system_message convention (Chinese) for
+ * the BrainPilot-authored shell; the provider's own error text is preserved
+ * verbatim (we don't translate third-party messages — that loses fidelity).
+ */
+/** Normalized error: a short headline plus optional expandable raw detail. */
+export interface NormalizedAgentError {
+    /** Concise, user-facing headline (chat bubble body). */
+    message: string;
+    /** Full raw error for the expandable "details" section, when worth keeping. */
+    details?: string;
+}
+/**
+ * #97 error path — coarse recoverability class for an agent/provider error.
+ *  - `retryable`: transient (rate limit, 5xx, timeout, network reset). Re-running
+ *    the same prompt may succeed, so the delivery loop self-retries the expert.
+ *  - `fatal`: re-running is pointless (auth/401/403, missing key/provider,
+ *    permission denied). Escalate to the principal immediately, no retry.
+ */
+export type AgentErrorKind = "retryable" | "fatal";
+/**
+ * Classify a raw agent/SDK error string for the delivery-loop error path (#97).
+ * Defaults to `retryable` for the unknown case so a transient failure we didn't
+ * pattern-match still gets the benefit of a retry before escalation.
+ */
+export declare function classifyAgentError(raw: string): AgentErrorKind;
+/**
+ * Normalize a raw agent error message for user display + persistence.
+ * - No-provider/no-key errors → a product-level Settings → Providers message.
+ * - Provider HTTP errors (`401 {...}`) → concise headline + raw blob in details.
+ * - Everything else → the original message with local paths / `/login` redacted.
+ */
+export declare function normalizeAgentError(raw: string): NormalizedAgentError;
+//# sourceMappingURL=agent-error.d.ts.map

package/dist/agent-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-error.d.ts","sourceRoot":"","sources":["../src/agent-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,CAAC;AAiBnD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAK9D;AAuGD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAMrE"}

package/dist/agent-error.js

@@ -0,0 +1,163 @@
+/**
+ * agent-error.ts — normalize raw agent/SDK error messages before they reach
+ * the user-facing event stream and events.jsonl (issues #45, #97).
+ *
+ * Three jobs:
+ *  1. Recognize the "no provider / no API key" case and replace the raw Pi SDK
+ *     guidance (which points at `/login` and absolute node_modules doc paths)
+ *     with a product-level message that points at BrainPilot's own Settings →
+ *     Providers flow.
+ *  2. Recognize a provider HTTP error (e.g. `401 {"error":{...}}`) and split it
+ *     into a concise, localized headline (`message`) and the full raw blob
+ *     (`details`), so the chat bubble shows a short line and tucks the provider
+ *     internals / request id behind an expandable section instead of dumping
+ *     escaped JSON into the primary transcript (#97).
+ *  3. Redact local filesystem leakage (absolute node_modules paths, `/login`
+ *     hints) from any other error, so we never persist or display internal
+ *     install paths.
+ *
+ * Language follows the existing runtime system_message convention (Chinese) for
+ * the BrainPilot-authored shell; the provider's own error text is preserved
+ * verbatim (we don't translate third-party messages — that loses fidelity).
+ */
+/**
+ * Auth / configuration failures where a retry cannot help: a wrong or missing
+ * key, a forbidden/unauthorized response, or no provider configured. Matched
+ * BEFORE the retryable set so a "401 ... rate limit ..." blob is fatal.
+ */
+const FATAL_RE = /\b(401|403)\b|invalid api key|no api key|api key (?:found|for)|no provider|unauthor|forbidden|authentication|permission denied/i;
+/**
+ * Transient failures worth a retry: explicit 408/429/5xx status codes, timeouts,
+ * overload, and the common Node socket/network error codes.
+ */
+const RETRYABLE_RE = /\b(408|429|5\d{2})\b|timeout|timed out|temporar|overloaded|rate.?limit|econnreset|etimedout|enotfound|econnrefused|network|fetch failed|socket hang up|connection/i;
+/**
+ * Classify a raw agent/SDK error string for the delivery-loop error path (#97).
+ * Defaults to `retryable` for the unknown case so a transient failure we didn't
+ * pattern-match still gets the benefit of a retry before escalation.
+ */
+export function classifyAgentError(raw) {
+    if (!raw)
+        return "retryable";
+    if (FATAL_RE.test(raw))
+        return "fatal";
+    if (RETRYABLE_RE.test(raw))
+        return "retryable";
+    return "retryable";
+}
+/** Product-level recovery message for a missing provider/key. */
+const NO_PROVIDER_MESSAGE = "未配置任何 provider。请打开 设置 → Providers 添加一个 provider。";
+/** Heuristics for the "no key / no provider configured" class of error. */
+function isNoProviderError(raw) {
+    return /no api key|no provider|api key found|api key for the selected model/i.test(raw);
+}
+/**
+ * Detect a provider HTTP error and build a concise headline + raw details.
+ *
+ * Real shape (observed in #97):
+ *   `401 {"error":{"message":"invalid api key (request id: ...)", ...}}`
+ * i.e. a leading HTTP status code followed by a JSON body. We extract the
+ * status code and, when possible, the provider's own `error.message`, and keep
+ * the entire original blob as `details` so the request id stays available
+ * behind the expandable section.
+ *
+ * Returns undefined when the string doesn't look like a provider HTTP error,
+ * so the caller falls through to plain redaction.
+ */
+function parseProviderError(raw) {
+    // Observed shape is always `<status> {json}` — require BOTH a 4xx/5xx code
+    // and a JSON body, so a plain message that happens to contain a 3-digit
+    // number ("retry in 500ms") is NOT misclassified as a provider error.
+    if (!raw.includes("{"))
+        return undefined;
+    const m = raw.match(/\b(4\d{2}|5\d{2})\b/);
+    if (!m)
+        return undefined;
+    const status = m[1];
+    let providerMsg = extractProviderMessage(raw);
+    // Guard against echoing the whole blob back as the "message" — if the
+    // extracted text still looks like a JSON dump, drop it and keep only the code.
+    if (providerMsg && /[{}]/.test(providerMsg))
+        providerMsg = undefined;
+    const headline = providerMsg
+        ? `provider 拒绝请求 (${status}): ${providerMsg}`
+        : `provider 拒绝请求 (HTTP ${status})。详情见下方展开。`;
+    return { message: headline, details: raw.trim() };
+}
+/**
+ * Best-effort pull of the provider's own human-readable message out of an
+ * error blob. Tries to JSON.parse a `{...}` substring and read common shapes
+ * (`error.message`, `message`, `error` as string); falls back to undefined.
+ */
+function extractProviderMessage(raw) {
+    const start = raw.indexOf("{");
+    const end = raw.lastIndexOf("}");
+    if (start === -1 || end === -1 || end <= start)
+        return undefined;
+    try {
+        const obj = JSON.parse(raw.slice(start, end + 1));
+        const msg = pickMessage(obj);
+        return msg?.trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function pickMessage(obj) {
+    if (!obj || typeof obj !== "object")
+        return undefined;
+    const o = obj;
+    if (typeof o.message === "string")
+        return o.message;
+    const err = o.error;
+    if (typeof err === "string")
+        return err;
+    if (err && typeof err === "object") {
+        const e = err;
+        if (typeof e.message === "string")
+            return e.message;
+    }
+    return undefined;
+}
+/**
+ * Strip local-path / `/login` leakage from an arbitrary error string while
+ * keeping its semantic content. Best-effort — drops lines that are purely an
+ * absolute node_modules doc path or a `/login` hint, and scrubs any inline
+ * absolute path that reaches into node_modules.
+ */
+function redact(raw) {
+    return raw
+        .split("\n")
+        .filter((line) => {
+        const t = line.trim();
+        if (/use \/login/i.test(t))
+            return false;
+        // A line that is just an absolute path into node_modules (doc pointer).
+        if (/^\/?\S*node_modules\/\S+$/.test(t))
+            return false;
+        return true;
+    })
+        .map((line) => 
+    // Scrub any remaining inline absolute node_modules path.
+    line.replace(/\/\S*node_modules\/\S+/g, "").trimEnd())
+        .join("\n")
+        .replace(/\n{2,}/g, "\n")
+        .trim();
+}
+/**
+ * Normalize a raw agent error message for user display + persistence.
+ * - No-provider/no-key errors → a product-level Settings → Providers message.
+ * - Provider HTTP errors (`401 {...}`) → concise headline + raw blob in details.
+ * - Everything else → the original message with local paths / `/login` redacted.
+ */
+export function normalizeAgentError(raw) {
+    if (!raw)
+        return { message: raw };
+    if (isNoProviderError(raw))
+        return { message: NO_PROVIDER_MESSAGE };
+    const provider = parseProviderError(raw);
+    if (provider)
+        return provider;
+    return { message: redact(raw) };
+}
+//# sourceMappingURL=agent-error.js.map

package/dist/agent-error.js.map

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

package/dist/agent-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-factory.d.ts","sourceRoot":"","sources":["../src/agent-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAA2C,MAAM,YAAY,CAAC;AAI/F,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAEzF;AAED,eAAO,MAAM,gBAAgB,EAAE,mBAE9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,mBAkD9B,CAAC;AAEF,wBAAgB,aAAa,IAAI,mBAAmB,CAEnD"}
+{"version":3,"file":"agent-factory.d.ts","sourceRoot":"","sources":["../src/agent-factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAA2C,MAAM,YAAY,CAAC;AAM/F,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAEzF;AAED,eAAO,MAAM,gBAAgB,EAAE,mBAE9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,mBA8E9B,CAAC;AAEF,wBAAgB,aAAa,IAAI,mBAAmB,CAEnD"}

package/dist/agent-factory.js

@@ -1,5 +1,7 @@
 import { MockAgentSession } from "./mock-agent.js";
 import { resolveGatewayModel, resolveSessionModel } from "./pi-provider.js";
+import { makeTraceReminderExt } from "./extensions/trace-reminder.js";
+import { makeAgentStatusExt } from "./extensions/agent-status.js";
 export function isMockMode(env = process.env) {
     return env.BP_MOCK === "1" || env.BP_MOCK === "true";
 }
@@ -30,17 +32,45 @@ export const realAgentFactory = async (params) => {
     // Skills: Pi's DefaultResourceLoader otherwise auto-discovers skills from the
     // HOST machine's global dirs (~/.pi/agent/skills, ~/.agents/skills), which
     // makes agent behaviour depend on whoever runs the runtime — not reproducible.
-    // We set `noSkills: true` to drop that implicit discovery and load skills ONLY
-    // from BrainPilot's own app-controlled dirs (`bp_template/skills/` shared +
-    // `.bp/<sid>/skills/` per-session, passed as `skillPaths`). `additionalSkillPaths`
-    // bypasses Pi's project-trust gate, so this works in our non-interactive runtime.
-    // Custom loaders are NOT auto-reloaded by the SDK, so we must reload() before use.
+    // We set `noSkills: true` to drop that implicit discovery, then load ONLY our
+    // controlled skill dir(s) via `additionalSkillPaths` (honored even with
+    // noSkills, verified against Pi v0.79 source). Pi's native skill pipeline
+    // already does progressive disclosure: each skill's name+description goes into
+    // the system prompt and the body is read on demand. The built-in skill content
+    // (@brainpilot/skills) is materialized into `<dataRoot>/bp_template/skills`,
+    // which the SessionManager passes here as `params.skillPaths`.
+    // Context files: for the SAME reproducibility reason we set `noContextFiles: true`.
+    // Pi would otherwise walk cwd→root collecting every AGENTS.md / CLAUDE.md and
+    // inject them as project context. Agents run with cwd under the host repo, so
+    // they'd absorb whatever AGENTS.md/CLAUDE.md happen to sit in the ancestry —
+    // e.g. the legacy "MAS Platform Phase 1" doc — and mis-identify themselves.
+    // Agent identity must come ONLY from the per-role persona below.
+    // Pi-native hooks: register the trace-reminder extension per AgentSession (its
+    // closure state is naturally per-agent). Only the real factory loads it — the
+    // mock factory has no Pi event loop, so behavioural hooks are verified in real
+    // mode (design §7 / T2).
+    const traceReminder = makeTraceReminderExt({
+        role: params.role,
+        name: params.agentName,
+        onUnreplied: params.onUnreplied ?? (() => { }),
+    });
+    // #97: inject a fresh team-status block at the top of every turn, but only for
+    // the agent the host supplied a renderer for (the principal). The `context`
+    // hook recomputes per turn and the rewrite is ephemeral (never persisted).
+    const extensionFactories = [traceReminder];
+    if (params.renderAgentStatus) {
+        extensionFactories.push(makeAgentStatusExt({ renderStatus: params.renderAgentStatus }));
+    }
     const resourceLoader = new DefaultResourceLoader({
         cwd: params.cwd,
         agentDir,
         noSkills: true,
-        additionalSkillPaths: params.skillPaths,
+        noContextFiles: true,
+        ...(params.skillPaths && params.skillPaths.length > 0
+            ? { additionalSkillPaths: params.skillPaths }
+            : {}),
         appendSystemPrompt: params.systemPrompt ? [params.systemPrompt] : [],
+        extensionFactories,
     });
     await resourceLoader.reload();
     const { session } = await createAgentSession({

package/dist/agent-factory.js.map

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

package/dist/events.d.ts

@@ -14,6 +14,17 @@ export declare const ev: {
     textMessageStart(ctx: Ctx, messageId: string, role?: string): AgUiEvent;
     textMessageContent(ctx: Ctx, messageId: string, delta: string): AgUiEvent;
     textMessageEnd(ctx: Ctx, messageId: string): AgUiEvent;
+    /**
+     * Atomic text message (issue #42). CHUNK is the AG-UI shorthand for the
+     * START→CONTENT→END triad; the client transformer/reducer expands it. We use
+     * it with role:"user" to persist + replay the user's own prompt as a bubble
+     * in the event stream. AG-UI's canonical carrier for user input is
+     * `RunAgentInput.messages`/`MESSAGES_SNAPSHOT`, but BrainPilot's whole
+     * history/replay path is the events.jsonl stream, and the spec explicitly
+     * permits a single role:"user" CHUNK to echo a user bubble into the output
+     * stream — which is exactly this case.
+     */
+    textMessageChunk(ctx: Ctx, messageId: string, delta: string, role?: string): AgUiEvent;
     reasoningMessageStart(ctx: Ctx, messageId: string): AgUiEvent;
     reasoningMessageContent(ctx: Ctx, messageId: string, delta: string): AgUiEvent;
     reasoningMessageEnd(ctx: Ctx, messageId: string): AgUiEvent;
@@ -30,6 +41,13 @@ export declare const ev: {
             consecutiveCount: number;
         };
     }): AgUiEvent;
+    userInputRequest(ctx: Ctx, req: {
+        request_id: string;
+        agent: string;
+        question: string;
+        options?: string[];
+        allow_free_text?: boolean;
+    }): AgUiEvent;
     systemMessage(sessionId: string, level: "info" | "warning" | "error" | "fatal", message: string, opts?: {
         agent?: string;
         details?: string;

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMtD,UAAU,GAAG;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AACD,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,eAAO,MAAM,EAAE;oBACG,GAAG,gBAAgB,MAAM,GAAG,SAAS;qBAGpC,GAAG,WAAW,OAAO,GAAG,SAAS;kBAGpC,GAAG,WAAW,MAAM,kBAA2B,SAAS;0BAGhD,GAAG,aAAa,MAAM,kBAAuB,SAAS;4BAGpD,GAAG,aAAa,MAAM,SAAS,MAAM,GAAG,SAAS;wBAGrD,GAAG,aAAa,MAAM,GAAG,SAAS;+BAG3B,GAAG,aAAa,MAAM,GAAG,SAAS;iCAGhC,GAAG,aAAa,MAAM,SAAS,MAAM,GAAG,SAAS;6BAGrD,GAAG,aAAa,MAAM,GAAG,SAAS;uBAGxC,GAAG,cAAc,MAAM,YAAY,MAAM,oBAAoB,MAAM,GAAG,SAAS;sBAShF,GAAG,cAAc,MAAM,SAAS,MAAM,GAAG,SAAS;qBAGnD,GAAG,cAAc,MAAM,GAAG,SAAS;wBAGhC,GAAG,cAAc,MAAM,WAAW,MAAM,iCAA+B,MAAM,GAAG,SAAS;2BAWtG,GAAG,QACF,MAAM,UACJ,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,UACxC;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,SAAS,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9E,GACA,SAAS;6BAoBC,MAAM,SACV,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,WACpC,MAAM,SACR;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACjE,SAAS;gBAYA,GAAG,QAAQ,MAAM,SAAS,OAAO,GAAG,SAAS;CAG1D,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAMtD,UAAU,GAAG;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgBD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AACD,wBAAgB,QAAQ,IAAI,MAAM,CAEjC;AAED,eAAO,MAAM,EAAE;oBACG,GAAG,gBAAgB,MAAM,GAAG,SAAS;qBAGpC,GAAG,WAAW,OAAO,GAAG,SAAS;kBAGpC,GAAG,WAAW,MAAM,kBAA2B,SAAS;0BAGhD,GAAG,aAAa,MAAM,kBAAuB,SAAS;4BAGpD,GAAG,aAAa,MAAM,SAAS,MAAM,GAAG,SAAS;wBAGrD,GAAG,aAAa,MAAM,GAAG,SAAS;IAGtD;;;;;;;;;OASG;0BACmB,GAAG,aAAa,MAAM,SAAS,MAAM,kBAAuB,SAAS;+BAGhE,GAAG,aAAa,MAAM,GAAG,SAAS;iCAGhC,GAAG,aAAa,MAAM,SAAS,MAAM,GAAG,SAAS;6BAGrD,GAAG,aAAa,MAAM,GAAG,SAAS;uBAGxC,GAAG,cAAc,MAAM,YAAY,MAAM,oBAAoB,MAAM,GAAG,SAAS;sBAShF,GAAG,cAAc,MAAM,SAAS,MAAM,GAAG,SAAS;qBAGnD,GAAG,cAAc,MAAM,GAAG,SAAS;wBAGhC,GAAG,cAAc,MAAM,WAAW,MAAM,iCAA+B,MAAM,GAAG,SAAS;2BAWtG,GAAG,QACF,MAAM,UACJ,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,UACxC;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;QAChC,SAAS,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9E,GACA,SAAS;0BAoBL,GAAG,OACH;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1G,SAAS;6BAYC,MAAM,SACV,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,WACpC,MAAM,SACR;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACjE,SAAS;gBAYA,GAAG,QAAQ,MAAM,SAAS,OAAO,GAAG,SAAS;CAG1D,CAAC"}

package/dist/events.js

@@ -46,6 +46,19 @@ export const ev = {
     textMessageEnd(ctx, messageId) {
         return { type: "TEXT_MESSAGE_END", ...envelope(ctx), message_id: messageId };
     },
+    /**
+     * Atomic text message (issue #42). CHUNK is the AG-UI shorthand for the
+     * START→CONTENT→END triad; the client transformer/reducer expands it. We use
+     * it with role:"user" to persist + replay the user's own prompt as a bubble
+     * in the event stream. AG-UI's canonical carrier for user input is
+     * `RunAgentInput.messages`/`MESSAGES_SNAPSHOT`, but BrainPilot's whole
+     * history/replay path is the events.jsonl stream, and the spec explicitly
+     * permits a single role:"user" CHUNK to echo a user bubble into the output
+     * stream — which is exactly this case.
+     */
+    textMessageChunk(ctx, messageId, delta, role = "assistant") {
+        return { type: "TEXT_MESSAGE_CHUNK", ...envelope(ctx), message_id: messageId, role, delta };
+    },
     reasoningMessageStart(ctx, messageId) {
         return { type: "REASONING_MESSAGE_START", ...envelope(ctx), message_id: messageId };
     },
@@ -100,6 +113,17 @@ export const ev = {
         }
         return e;
     },
+    userInputRequest(ctx, req) {
+        return {
+            type: "user_input_request",
+            ...envelope(ctx),
+            request_id: req.request_id,
+            agent: req.agent,
+            question: req.question,
+            options: req.options,
+            allow_free_text: req.allow_free_text,
+        };
+    },
     systemMessage(sessionId, level, message, opts) {
         return {
             type: "system_message",

package/dist/events.js.map

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

package/dist/extensions/agent-status.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 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`.
+ */
+/** One agent's live state, as seen by the status block. */
+export interface AgentStatusLine {
+    name: string;
+    /** Authoritative status: idle | running | error | stopped. */
+    status: string;
+    /** Inbound messages still queued unread in this agent's inbox. */
+    unread: number;
+}
+/**
+ * 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 declare function renderAgentStatusBlock(lines: readonly AgentStatusLine[]): string;
+/** Minimal structural surface of an agent the collector reads. */
+export interface StatusAgentLike {
+    name: string;
+    role: string;
+    status: string;
+}
+/**
+ * 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 declare function collectAgentStatusLines(agents: Iterable<StatusAgentLike>, unreadOf: (name: string) => number): AgentStatusLine[];
+/** Minimal structural surface of Pi's ExtensionAPI we depend on. */
+interface PiContextMessage {
+    role: string;
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+    timestamp?: number;
+}
+interface PiExtensionApi {
+    on(event: "context", handler: (e: {
+        messages: PiContextMessage[];
+    }) => {
+        messages: PiContextMessage[];
+    } | void): void;
+}
+export interface AgentStatusDeps {
+    /**
+     * Compute the current status block. Called once per turn. Returns "" when
+     * there is nothing to inject (the handler then only strips any stale block).
+     */
+    renderStatus: () => string;
+}
+/**
+ * Build the extension factory for one agent. The returned function is what Pi
+ * calls with the per-session `ExtensionAPI`.
+ */
+export declare function makeAgentStatusExt(deps: AgentStatusDeps): (pi: PiExtensionApi) => void;
+export {};
+//# sourceMappingURL=agent-status.d.ts.map

package/dist/extensions/agent-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-status.d.ts","sourceRoot":"","sources":["../../src/extensions/agent-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAehF;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,CAAC,eAAe,CAAC,EACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACjC,eAAe,EAAE,CAQnB;AAED,oEAAoE;AACpE,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,UAAU,cAAc;IACtB,EAAE,CACA,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,CAAC,CAAC,EAAE;QACX,QAAQ,EAAE,gBAAgB,EAAE,CAAC;KAC9B,KAAK;QAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAA;KAAE,GAAG,IAAI,GAC5C,IAAI,CAAC;CACT;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAUD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAoBtF"}