@brainpilot/runtime 0.0.1

package/dist/mas-agent.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MasAgent — wraps one Pi (or mock) AgentSession.
+ *
+ * Responsibilities:
+ *  - Own the agent's authoritative `status` (idle/running/error/stopped) — §10.
+ *  - Translate Pi events → AG-UI events (§6) onto the session EventBus.
+ *  - Per-agent error isolation (§7 L2): a thrown prompt never escapes; it is
+ *    converted to RUN_ERROR + system_message and the agent goes to `error`.
+ *  - Map Pi `auto_retry_start/end` → agent_status_update + system_message;
+ *    suppress internal events (turn_*, compaction_*).
+ *  - Event-driven hooks (§8): track reply/trace/delegate per turn.
+ */
+import type { AgUiEvent, AgentState } from "@brainpilot/protocol";
+import type { EventBus } from "./event-bus.js";
+import type { AgentRole, IAgentSession } from "./types.js";
+export type AgentStatus = "idle" | "running" | "error" | "stopped";
+export interface MasAgentOpts {
+    sessionId: string;
+    name: string;
+    role: AgentRole;
+    session: IAgentSession;
+    bus: EventBus;
+    onStatusChange?: (name: string, status: AgentStatus) => void;
+}
+export declare class MasAgent {
+    private readonly opts;
+    readonly name: string;
+    readonly role: AgentRole;
+    private readonly sessionId;
+    private readonly session;
+    private readonly bus;
+    private readonly unsubscribe;
+    private _status;
+    private currentRunId;
+    private currentMessageId;
+    private inReasoning;
+    private activeToolExecutions;
+    private lastError;
+    private trackers;
+    constructor(opts: MasAgentOpts);
+    get status(): AgentStatus;
+    /** §10 authoritative state snapshot. */
+    state(): AgentState;
+    private setStatus;
+    /**
+     * Send a prompt and stream events. Error-isolated (§7 L2): never throws.
+     */
+    prompt(text: string): Promise<void>;
+    abort(): Promise<void>;
+    stop(): void;
+    private recordError;
+    private resetTrackers;
+    /** Translate one Pi event into zero or more AG-UI events (§6). */
+    private onPiEvent;
+    private onAssistantDelta;
+    private onToolResult;
+    /** Expose tracker state (for hook tests). */
+    getTrackers(): {
+        replied: boolean;
+        traced: boolean;
+        delegated: boolean;
+    };
+}
+export type { AgUiEvent };
+//# sourceMappingURL=mas-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mas-agent.d.ts","sourceRoot":"","sources":["../src/mas-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAGd,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,QAAQ,CAAC;IACd,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC9D;AAED,qBAAa,QAAQ;IAkBP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAjBjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,SAAS,CAA0B;IAG3C,OAAO,CAAC,QAAQ,CAAuD;gBAE1C,IAAI,EAAE,YAAY;IAS/C,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,wCAAwC;IACxC,KAAK,IAAI,UAAU;IAQnB,OAAO,CAAC,SAAS;IAajB;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B,IAAI,IAAI,IAAI;IAMZ,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,aAAa;IAIrB,kEAAkE;IAClE,OAAO,CAAC,SAAS;IAuGjB,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,YAAY;IAOpB,6CAA6C;IAC7C,WAAW,IAAI;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAGzE;AAYD,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/mas-agent.js

@@ -0,0 +1,244 @@
+import { ev, newMessageId, newRunId } from "./events.js";
+export class MasAgent {
+    opts;
+    name;
+    role;
+    sessionId;
+    session;
+    bus;
+    unsubscribe;
+    _status = "idle";
+    currentRunId;
+    currentMessageId;
+    inReasoning = false;
+    activeToolExecutions = new Set();
+    lastError;
+    // §8 hook trackers (reset each turn).
+    trackers = { replied: false, traced: false, delegated: false };
+    constructor(opts) {
+        this.opts = opts;
+        this.name = opts.name;
+        this.role = opts.role;
+        this.sessionId = opts.sessionId;
+        this.session = opts.session;
+        this.bus = opts.bus;
+        this.unsubscribe = this.session.subscribe((e) => this.onPiEvent(e));
+    }
+    get status() {
+        return this._status;
+    }
+    /** §10 authoritative state snapshot. */
+    state() {
+        const s = { name: this.name, status: this._status };
+        if (this.currentRunId)
+            s.activeRunId = this.currentRunId;
+        if (this.activeToolExecutions.size)
+            s.activeToolExecutions = [...this.activeToolExecutions];
+        if (this.lastError)
+            s.lastError = this.lastError;
+        return s;
+    }
+    setStatus(status) {
+        if (this._status === status)
+            return;
+        this._status = status;
+        this.opts.onStatusChange?.(this.name, status);
+        this.bus.emit(ev.agentStatusUpdate({ sessionId: this.sessionId, runId: this.currentRunId }, this.name, status, {
+            activeRunId: this.currentRunId,
+            activeToolExecutions: [...this.activeToolExecutions],
+            lastError: this.lastError,
+        }));
+    }
+    /**
+     * Send a prompt and stream events. Error-isolated (§7 L2): never throws.
+     */
+    async prompt(text) {
+        this.currentRunId = newRunId();
+        this.resetTrackers();
+        this.setStatus("running");
+        this.bus.emit(ev.runStarted({ sessionId: this.sessionId, agentName: this.name, runId: this.currentRunId }));
+        try {
+            await this.session.prompt(text);
+            this.bus.emit(ev.runFinished({ sessionId: this.sessionId, agentName: this.name, runId: this.currentRunId }));
+            if (this._status !== "error")
+                this.setStatus("idle");
+        }
+        catch (err) {
+            const message = err?.message ?? String(err);
+            this.recordError(message, err?.stack);
+            this.bus.emit(ev.runError({ sessionId: this.sessionId, agentName: this.name, runId: this.currentRunId }, message));
+            this.setStatus("error");
+        }
+        finally {
+            this.currentRunId = undefined;
+            this.currentMessageId = undefined;
+        }
+    }
+    async abort() {
+        try {
+            await this.session.abort();
+        }
+        catch {
+            /* abort best-effort */
+        }
+        this.activeToolExecutions.clear();
+        this.setStatus("idle");
+    }
+    stop() {
+        this.unsubscribe();
+        this.session.dispose();
+        this.setStatus("stopped");
+    }
+    recordError(message, details) {
+        const prev = this.lastError?.consecutiveCount ?? 0;
+        this.lastError = { message, timestamp: new Date().toISOString(), consecutiveCount: prev + 1 };
+        this.bus.emit(ev.systemMessage(this.sessionId, "error", `⚠️ Agent ${this.name} 遇到错误: ${message}`, {
+            agent: this.name,
+            details,
+            recoverable: true,
+        }));
+    }
+    resetTrackers() {
+        this.trackers = { replied: false, traced: false, delegated: false };
+    }
+    /** Translate one Pi event into zero or more AG-UI events (§6). */
+    onPiEvent(e) {
+        const ctx = { sessionId: this.sessionId, agentName: this.name, runId: this.currentRunId };
+        switch (e.type) {
+            case "agent_start":
+            case "turn_end":
+            case "agent_end":
+            case "compaction_start":
+            case "compaction_end":
+            case "queue_update":
+                // Internal / suppressed (§6 table: turn_*, compaction_* not exposed).
+                return;
+            case "turn_start":
+                this.resetTrackers();
+                return;
+            case "message_start": {
+                const msg = e;
+                if (msg.message?.role === "assistant") {
+                    this.currentMessageId = newMessageId();
+                    this.inReasoning = false;
+                    this.bus.emit(ev.textMessageStart(ctx, this.currentMessageId));
+                }
+                return;
+            }
+            case "message_update": {
+                const upd = e;
+                this.onAssistantDelta(ctx, upd.assistantMessageEvent);
+                return;
+            }
+            case "message_end": {
+                if (this.currentMessageId) {
+                    if (this.inReasoning) {
+                        this.bus.emit(ev.reasoningMessageEnd(ctx, this.currentMessageId));
+                        this.inReasoning = false;
+                    }
+                    this.bus.emit(ev.textMessageEnd(ctx, this.currentMessageId));
+                    this.currentMessageId = undefined;
+                }
+                return;
+            }
+            case "tool_execution_start": {
+                const t = e;
+                this.activeToolExecutions.add(t.toolCallId);
+                this.bus.emit(ev.toolCallStart(ctx, t.toolCallId, t.toolName, this.currentMessageId));
+                const argsStr = safeStringify(t.args);
+                if (argsStr)
+                    this.bus.emit(ev.toolCallArgs(ctx, t.toolCallId, argsStr));
+                return;
+            }
+            case "tool_execution_end": {
+                const t = e;
+                this.activeToolExecutions.delete(t.toolCallId);
+                this.bus.emit(ev.toolCallEnd(ctx, t.toolCallId));
+                const resultStr = typeof t.result === "string" ? t.result : safeStringify(t.result);
+                this.bus.emit(ev.toolCallResult(ctx, t.toolCallId, resultStr, t.isError));
+                // §8 hooks: mark replied/traced/delegated from tool results.
+                this.onToolResult(t.toolName, t.isError);
+                // §7 L1: surface tool errors as system_message.
+                if (t.isError) {
+                    this.bus.emit(ev.systemMessage(this.sessionId, "warning", `❌ ${t.toolName} 执行失败`, {
+                        agent: this.name,
+                        details: resultStr,
+                        recoverable: true,
+                    }));
+                }
+                return;
+            }
+            case "auto_retry_start": {
+                const r = e;
+                this.bus.emit(ev.systemMessage(this.sessionId, "warning", `⏳ Agent ${this.name} 遇到 API 错误，正在自动重试 (${r.attempt}/${r.maxAttempts})，${r.delayMs / 1000}秒后重试...`, { agent: this.name, recoverable: true }));
+                return;
+            }
+            case "auto_retry_end": {
+                const r = e;
+                if (!r.success) {
+                    this.recordError(r.finalError ?? "retry exhausted");
+                    this.setStatus("error");
+                }
+                return;
+            }
+            default:
+                return; // unknown / future Pi events: ignore.
+        }
+    }
+    onAssistantDelta(ctx, amsg) {
+        if (!this.currentMessageId) {
+            this.currentMessageId = newMessageId();
+            this.bus.emit(ev.textMessageStart(ctx, this.currentMessageId));
+        }
+        const id = this.currentMessageId;
+        switch (amsg.type) {
+            case "text_delta":
+                this.bus.emit(ev.textMessageContent(ctx, id, String(amsg.delta ?? "")));
+                return;
+            case "reasoning_start":
+                this.inReasoning = true;
+                this.bus.emit(ev.reasoningMessageStart(ctx, id));
+                return;
+            case "reasoning_delta":
+                if (!this.inReasoning) {
+                    this.inReasoning = true;
+                    this.bus.emit(ev.reasoningMessageStart(ctx, id));
+                }
+                this.bus.emit(ev.reasoningMessageContent(ctx, id, String(amsg.delta ?? "")));
+                return;
+            case "reasoning_end":
+                this.bus.emit(ev.reasoningMessageEnd(ctx, id));
+                this.inReasoning = false;
+                return;
+            default:
+                return;
+        }
+    }
+    onToolResult(toolName, isError) {
+        if (isError)
+            return;
+        if (toolName === "send_message")
+            this.trackers.replied = true;
+        if (toolName === "record_trace" || toolName.startsWith("create_trace"))
+            this.trackers.traced = true;
+        if (toolName === "create_agent")
+            this.trackers.delegated = true;
+    }
+    /** Expose tracker state (for hook tests). */
+    getTrackers() {
+        return { ...this.trackers };
+    }
+}
+function safeStringify(v) {
+    if (v === undefined || v === null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=mas-agent.js.map

package/dist/mas-agent.js.map

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

package/dist/mcp-bridge.d.ts

@@ -0,0 +1,51 @@
+import type { SystemTool } from "./types.js";
+export interface McpServerSpec {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface McpServersConfig {
+    mcpServers: Record<string, McpServerSpec>;
+}
+/** Minimal subset of `@modelcontextprotocol/sdk` Client we depend on. */
+export interface McpClientLike {
+    listTools(): Promise<{
+        tools: McpToolDescriptor[];
+    }>;
+    callTool(args: {
+        name: string;
+        arguments: Record<string, unknown>;
+    }): Promise<McpCallResult>;
+    close(): Promise<void>;
+}
+export interface McpToolDescriptor {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface McpCallResult {
+    content?: unknown;
+    isError?: boolean;
+}
+export type McpConnectFn = (name: string, spec: McpServerSpec) => Promise<McpClientLike>;
+/**
+ * Load `mcp_servers.json` from the data root. Looks under `bp_template/` first
+ * (the user-editable global template, §11A.2), then `.bp/`. Returns null when
+ * absent — MCP is entirely opt-in and adds zero overhead when unconfigured.
+ */
+export declare function loadMcpServersConfig(dataRoot: string): Promise<McpServersConfig | null>;
+/** Real connect: spawn a stdio MCP server and hand back a thin client. */
+export declare const defaultMcpConnect: McpConnectFn;
+export declare class McpBridge {
+    private readonly connect;
+    private clients;
+    private _tools;
+    constructor(connect?: McpConnectFn);
+    get tools(): SystemTool[];
+    /** Connect every server in the config and collect their tools. */
+    connectAll(cfg: McpServersConfig): Promise<SystemTool[]>;
+    private wrap;
+    /** Close every server connection (best-effort). */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=mcp-bridge.d.ts.map

package/dist/mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../src/mcp-bridge.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAC3C;AAED,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAEzF;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAa7F;AAED,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,EAAE,YAe/B,CAAC;AAEF,qBAAa,SAAS;IAIR,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAoB;gBAEL,OAAO,GAAE,YAAgC;IAEtE,IAAI,KAAK,IAAI,UAAU,EAAE,CAExB;IAED,kEAAkE;IAC5D,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe9D,OAAO,CAAC,IAAI;IAYZ,mDAAmD;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/mcp-bridge.js

@@ -0,0 +1,120 @@
+/**
+ * External MCP bridge (§9 decision 2).
+ *
+ * Pi 0.79 has NO built-in MCP — by design it pushes such workflows to custom
+ * tools (https://pi.dev/docs/latest/usage). So we bridge: read `mcp_servers.json`,
+ * connect each declared server with `@modelcontextprotocol/sdk`, `tools/list`,
+ * and expose every discovered MCP tool as a BrainPilot `SystemTool` (which the
+ * real agent factory then wraps with Pi's `defineTool`).
+ *
+ * Tools are namespaced `mcp__<server>__<tool>` to avoid cross-server collisions.
+ * A failing server is logged and skipped — it never aborts the others.
+ *
+ * Config shape (standard MCP/Claude format), stdio servers only:
+ *   { "mcpServers": { "fs": { "command": "npx", "args": ["-y", "..."], "env": {} } } }
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Load `mcp_servers.json` from the data root. Looks under `bp_template/` first
+ * (the user-editable global template, §11A.2), then `.bp/`. Returns null when
+ * absent — MCP is entirely opt-in and adds zero overhead when unconfigured.
+ */
+export async function loadMcpServersConfig(dataRoot) {
+    for (const rel of [join("bp_template", "mcp_servers.json"), join(".bp", "mcp_servers.json")]) {
+        try {
+            const raw = await readFile(join(dataRoot, rel), "utf8");
+            const cfg = JSON.parse(raw);
+            if (cfg && typeof cfg === "object" && "mcpServers" in cfg) {
+                return cfg;
+            }
+        }
+        catch {
+            /* not present / unreadable — try the next location */
+        }
+    }
+    return null;
+}
+/** Real connect: spawn a stdio MCP server and hand back a thin client. */
+export const defaultMcpConnect = async (name, spec) => {
+    const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
+    const { StdioClientTransport } = await import("@modelcontextprotocol/sdk/client/stdio.js");
+    const transport = new StdioClientTransport({
+        command: spec.command,
+        args: spec.args ?? [],
+        ...(spec.env ? { env: spec.env } : {}),
+    });
+    const client = new Client({ name: `brainpilot-${name}`, version: "0.1.0" });
+    await client.connect(transport);
+    return {
+        listTools: () => client.listTools(),
+        callTool: (a) => client.callTool(a),
+        close: () => client.close(),
+    };
+};
+export class McpBridge {
+    connect;
+    clients = [];
+    _tools = [];
+    constructor(connect = defaultMcpConnect) {
+        this.connect = connect;
+    }
+    get tools() {
+        return this._tools;
+    }
+    /** Connect every server in the config and collect their tools. */
+    async connectAll(cfg) {
+        for (const [name, spec] of Object.entries(cfg.mcpServers)) {
+            try {
+                const client = await this.connect(name, spec);
+                this.clients.push(client);
+                const { tools } = await client.listTools();
+                for (const t of tools)
+                    this._tools.push(this.wrap(name, client, t));
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console
+                console.error(`[mcp] server '${name}' failed to connect:`, err.message);
+            }
+        }
+        return this._tools;
+    }
+    wrap(server, client, t) {
+        return {
+            name: `mcp__${server}__${t.name}`,
+            description: t.description ?? `MCP tool '${t.name}' from server '${server}'`,
+            parameters: t.inputSchema ?? { type: "object", properties: {} },
+            execute: async (params) => {
+                const res = await client.callTool({ name: t.name, arguments: params });
+                return { content: normalizeContent(res.content), isError: res.isError === true };
+            },
+        };
+    }
+    /** Close every server connection (best-effort). */
+    async close() {
+        await Promise.all(this.clients.map((c) => c.close().catch(() => { })));
+        this.clients = [];
+        this._tools = [];
+    }
+}
+/** Map an MCP tool-call `content` payload into our text-content shape. */
+function normalizeContent(content) {
+    if (Array.isArray(content)) {
+        return content.map((item) => {
+            if (item && typeof item === "object" && item.type === "text") {
+                return { type: "text", text: String(item.text ?? "") };
+            }
+            return { type: "text", text: safe(item) };
+        });
+    }
+    return [{ type: "text", text: typeof content === "string" ? content : safe(content) }];
+}
+function safe(v) {
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/mcp-bridge.js.map

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

package/dist/mock-agent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Mock AgentSession (BP_MOCK=1). Deterministic, no API calls.
+ *
+ * Emits a scripted Pi event stream that exercises the SAME translator the real
+ * Pi session feeds (agent_start → message_start → message_update(text_delta)*
+ * → message_end → tool_execution_* (optional) → agent_end). This lets tests +
+ * CI cover the full orchestration path without burning quota.
+ *
+ * Prompt control protocol (so tests can drive behavior):
+ *   - default: streams a short scripted assistant reply.
+ *   - contains "[[tool:NAME {json}]]": invokes system tool NAME with parsed
+ *     args and emits tool_execution_start/end around it.
+ *   - contains "[[error]]": emits an agent-level failure (auto_retry then end).
+ */
+import type { IAgentSession, PiAgentEvent, SystemTool } from "./types.js";
+export interface MockSessionConfig {
+    sessionId: string;
+    agentName: string;
+    systemTools: SystemTool[];
+    /** Scripted assistant text (default: deterministic per agent). */
+    scriptText?: string;
+}
+export declare class MockAgentSession implements IAgentSession {
+    private readonly cfg;
+    readonly sessionId: string;
+    private readonly listeners;
+    private readonly toolMap;
+    private aborted;
+    private disposed;
+    constructor(cfg: MockSessionConfig);
+    subscribe(listener: (e: PiAgentEvent) => void): () => void;
+    private emit;
+    prompt(text: string): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=mock-agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock-agent.d.ts","sourceRoot":"","sources":["../src/mock-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,gBAAiB,YAAW,aAAa;IAOxC,OAAO,CAAC,QAAQ,CAAC,GAAG;IANhC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEI,GAAG,EAAE,iBAAiB;IAKnD,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAK1D,OAAO,CAAC,IAAI;IAUN,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgFnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,IAAI,IAAI;CAIhB"}