@brainpilot/runtime 0.0.1

package/dist/mock-agent.js

@@ -0,0 +1,123 @@
+const TOOL_RE = /\[\[tool:([a-zA-Z_]+)\s*(\{.*?\})?\]\]/;
+export class MockAgentSession {
+    cfg;
+    sessionId;
+    listeners = new Set();
+    toolMap;
+    aborted = false;
+    disposed = false;
+    constructor(cfg) {
+        this.cfg = cfg;
+        this.sessionId = cfg.sessionId;
+        this.toolMap = new Map(cfg.systemTools.map((t) => [t.name, t]));
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(e) {
+        for (const l of this.listeners) {
+            try {
+                l(e);
+            }
+            catch {
+                /* isolate */
+            }
+        }
+    }
+    async prompt(text) {
+        if (this.disposed)
+            return;
+        this.aborted = false;
+        this.emit({ type: "agent_start" });
+        this.emit({ type: "turn_start" });
+        if (text.includes("[[error]]")) {
+            this.emit({
+                type: "auto_retry_start",
+                attempt: 1,
+                maxAttempts: 3,
+                delayMs: 0,
+                errorMessage: "mock API error",
+            });
+            this.emit({ type: "auto_retry_end", success: false, attempt: 1, finalError: "mock API error" });
+            this.emit({ type: "agent_end", messages: [], willRetry: false });
+            return;
+        }
+        // Stream a short assistant message.
+        const msg = { role: "assistant", content: [] };
+        this.emit({ type: "message_start", message: { ...msg } });
+        const script = this.cfg.scriptText ?? `mock reply from ${this.cfg.agentName}`;
+        for (const chunk of script.match(/.{1,8}/g) ?? [script]) {
+            if (this.aborted)
+                break;
+            this.emit({
+                type: "message_update",
+                message: { ...msg },
+                assistantMessageEvent: { type: "text_delta", delta: chunk },
+            });
+        }
+        this.emit({
+            type: "message_end",
+            message: { role: "assistant", content: [{ type: "text", text: script }] },
+        });
+        // Optional tool invocation driven by the prompt.
+        const m = TOOL_RE.exec(text);
+        if (m && !this.aborted) {
+            const toolName = m[1];
+            const args = m[2] ? safeJson(m[2]) : {};
+            const tool = this.toolMap.get(toolName);
+            const toolCallId = `tc_${toolName}_${Date.now()}`;
+            this.emit({ type: "tool_execution_start", toolCallId, toolName, args });
+            if (tool) {
+                try {
+                    const res = await tool.execute(args);
+                    const textOut = res.content.map((c) => c.text).join("");
+                    this.emit({
+                        type: "tool_execution_end",
+                        toolCallId,
+                        toolName,
+                        result: textOut,
+                        isError: res.isError ?? false,
+                    });
+                }
+                catch (err) {
+                    this.emit({
+                        type: "tool_execution_end",
+                        toolCallId,
+                        toolName,
+                        result: String(err.message),
+                        isError: true,
+                    });
+                }
+            }
+            else {
+                // Tool not available to this agent (access-controlled away).
+                this.emit({
+                    type: "tool_execution_end",
+                    toolCallId,
+                    toolName,
+                    result: `tool ${toolName} not available`,
+                    isError: true,
+                });
+            }
+        }
+        this.emit({ type: "turn_end" });
+        this.emit({ type: "agent_end", messages: [], willRetry: false });
+    }
+    async abort() {
+        this.aborted = true;
+    }
+    dispose() {
+        this.disposed = true;
+        this.listeners.clear();
+    }
+}
+function safeJson(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=mock-agent.js.map

package/dist/mock-agent.js.map

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

package/dist/pi-provider.d.ts

@@ -0,0 +1,25 @@
+/** The synthetic provider id under which the auto-generated gateway lives. */
+export declare const GATEWAY_PROVIDER = "bp-gateway";
+/** Minimal structural surface of the Pi SDK bits this module needs. */
+export interface PiProviderSdk {
+    AuthStorage: {
+        create(path: string): unknown;
+    };
+    ModelRegistry: {
+        create(authStorage: unknown, modelsJsonPath?: string): {
+            refresh(): void;
+            getError(): string | undefined;
+            find(provider: string, modelId: string): unknown;
+        };
+    };
+}
+export interface ResolvedProvider {
+    model?: unknown;
+    modelRegistry?: unknown;
+}
+/**
+ * Resolve a custom model from env, or return `{}` when none is configured.
+ * `agentDir` is Pi's global config dir (getAgentDir()).
+ */
+export declare function resolveGatewayModel(sdk: PiProviderSdk, agentDir: string): ResolvedProvider;
+//# sourceMappingURL=pi-provider.d.ts.map

package/dist/pi-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-provider.d.ts","sourceRoot":"","sources":["../src/pi-provider.ts"],"names":[],"mappings":"AAyBA,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAM7C,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC/C,aAAa,EAAE;QACb,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG;YACrD,OAAO,IAAI,IAAI,CAAC;YAChB,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;YAC/B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;SAClD,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAUD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAmD1F"}

package/dist/pi-provider.js

@@ -0,0 +1,132 @@
+/**
+ * pi-provider.ts — resolve a custom LLM provider for the Pi SDK from env.
+ *
+ * Pi does NOT honour `ANTHROPIC_BASE_URL` / `ANTHROPIC_MODEL` (it only reads
+ * `ANTHROPIC_API_KEY`, and otherwise hits the built-in Anthropic endpoint with
+ * a built-in model). To target a third-party model we register it as a custom
+ * Pi provider via a `models.json` + ModelRegistry and select its model.
+ *
+ * Three configuration tiers (simplest first):
+ *
+ *   1. Nothing set                         → Pi uses its built-in endpoint.
+ *   2. ANTHROPIC_BASE_URL + ANTHROPIC_MODEL → we auto-generate a one-provider
+ *      `bp-gateway-models.json` for an Anthropic-compatible gateway. Optional
+ *      ANTHROPIC_CONTEXT_WINDOW / ANTHROPIC_MAX_TOKENS tune the model limits.
+ *   3. BP_MODELS_JSON + ANTHROPIC_MODEL     → advanced: use the user's own
+ *      hand-written models.json verbatim (multi-provider, custom headers,
+ *      `compat` flags, openai-compatible APIs, …). BP_MODEL_PROVIDER picks the
+ *      provider (defaults to the file's first provider key).
+ *
+ * Returns the resolved `{ model, modelRegistry }` to pass to
+ * `createAgentSession`, or `{}` when nothing custom is configured.
+ */
+import { mkdirSync, writeFileSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** The synthetic provider id under which the auto-generated gateway lives. */
+export const GATEWAY_PROVIDER = "bp-gateway";
+/** Defaults applied to an auto-generated gateway model when env is unset. */
+const DEFAULT_CONTEXT_WINDOW = 200_000;
+const DEFAULT_MAX_TOKENS = 8_192;
+/** Parse a positive integer env var, or `undefined` if unset/invalid. */
+function intEnv(name) {
+    const raw = process.env[name]?.trim();
+    if (!raw)
+        return undefined;
+    const n = Number(raw);
+    return Number.isInteger(n) && n > 0 ? n : undefined;
+}
+/**
+ * Resolve a custom model from env, or return `{}` when none is configured.
+ * `agentDir` is Pi's global config dir (getAgentDir()).
+ */
+export function resolveGatewayModel(sdk, agentDir) {
+    const modelId = process.env.ANTHROPIC_MODEL?.trim();
+    // Tier 3 — advanced: user supplies their own models.json verbatim.
+    const customPath = process.env.BP_MODELS_JSON?.trim();
+    if (customPath) {
+        // A custom file is meaningless without knowing which model to select.
+        if (!modelId)
+            return {};
+        const provider = resolveCustomProvider(customPath);
+        return select(sdk, agentDir, customPath, provider, modelId);
+    }
+    // Tier 2 — simple gateway: auto-generate a one-provider models.json.
+    const baseUrl = process.env.ANTHROPIC_BASE_URL?.trim();
+    // Tier 1 — neither set → let Pi use its built-in providers/models.
+    if (!baseUrl || !modelId)
+        return {};
+    mkdirSync(agentDir, { recursive: true });
+    const modelsJsonPath = join(agentDir, "bp-gateway-models.json");
+    const desired = JSON.stringify({
+        providers: {
+            [GATEWAY_PROVIDER]: {
+                baseUrl,
+                api: "anthropic-messages",
+                // Resolved at request time from the same env the gateway key lives in.
+                apiKey: "$ANTHROPIC_API_KEY",
+                models: [
+                    {
+                        id: modelId,
+                        input: ["text"],
+                        contextWindow: intEnv("ANTHROPIC_CONTEXT_WINDOW") ?? DEFAULT_CONTEXT_WINDOW,
+                        maxTokens: intEnv("ANTHROPIC_MAX_TOKENS") ?? DEFAULT_MAX_TOKENS,
+                    },
+                ],
+            },
+        },
+    }, null, 2);
+    // Write idempotently (avoid churn when many agents start).
+    let current;
+    try {
+        current = readFileSync(modelsJsonPath, "utf8");
+    }
+    catch {
+        /* not written yet */
+    }
+    if (current !== desired)
+        writeFileSync(modelsJsonPath, desired);
+    return select(sdk, agentDir, modelsJsonPath, GATEWAY_PROVIDER, modelId);
+}
+/**
+ * Pick the provider for a user-supplied models.json: explicit BP_MODEL_PROVIDER,
+ * else the file's first provider key. Throws if the file is unreadable/empty.
+ */
+function resolveCustomProvider(modelsJsonPath) {
+    const explicit = process.env.BP_MODEL_PROVIDER?.trim();
+    if (explicit)
+        return explicit;
+    let raw;
+    try {
+        raw = readFileSync(modelsJsonPath, "utf8");
+    }
+    catch (e) {
+        throw new Error(`BP_MODELS_JSON unreadable (${modelsJsonPath}): ${e.message}`);
+    }
+    let providers;
+    try {
+        providers = JSON.parse(raw).providers;
+    }
+    catch (e) {
+        throw new Error(`BP_MODELS_JSON is not valid JSON (${modelsJsonPath}): ${e.message}`);
+    }
+    const first = providers && Object.keys(providers)[0];
+    if (!first) {
+        throw new Error(`BP_MODELS_JSON has no "providers" (${modelsJsonPath}); set BP_MODEL_PROVIDER`);
+    }
+    return first;
+}
+/** Load the registry against `modelsJsonPath` and resolve `provider/modelId`. */
+function select(sdk, agentDir, modelsJsonPath, provider, modelId) {
+    const authStorage = sdk.AuthStorage.create(join(agentDir, "auth.json"));
+    const modelRegistry = sdk.ModelRegistry.create(authStorage, modelsJsonPath);
+    modelRegistry.refresh();
+    const err = modelRegistry.getError();
+    if (err)
+        throw new Error(`Pi models.json load error (${modelsJsonPath}): ${err}`);
+    const model = modelRegistry.find(provider, modelId);
+    if (!model) {
+        throw new Error(`model not found in ${modelsJsonPath}: ${provider}/${modelId}`);
+    }
+    return { model, modelRegistry };
+}
+//# sourceMappingURL=pi-provider.js.map

package/dist/pi-provider.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,30 @@
+/**
+ * HTTP server (§15.4 / RUNTIME_ROUTES) — implements every Runtime route on top
+ * of the SessionManager. Uses hono + @hono/node-server. The SSE endpoint
+ * streams AG-UI events for a session.
+ *
+ * Routes (from `@brainpilot/protocol` RUNTIME_ROUTES):
+ *   GET  /health, GET /metrics
+ *   POST /sessions, GET /sessions, GET /sessions/:id, DELETE /sessions/:id
+ *   GET  /sessions/:id/state, POST /sessions/:id/messages
+ *   GET  /sse/:id  (+ alias GET /sessions/:id/events)
+ *   POST /sessions/:id/interrupt, GET /sessions/:id/agents, POST /sessions/:id/evict
+ */
+import { Hono } from "hono";
+import { SessionManager, type SessionManagerOptions } from "./session-manager.js";
+export declare function createServer(opts?: SessionManagerOptions & {
+    manager?: SessionManager;
+}): {
+    app: Hono;
+    manager: SessionManager;
+};
+export interface StartServerOptions extends SessionManagerOptions {
+    port?: number;
+    manager?: SessionManager;
+}
+export declare function startServer(opts?: StartServerOptions): {
+    manager: SessionManager;
+    port: number;
+    close: () => Promise<void>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElF,wBAAgB,YAAY,CAAC,IAAI,GAAE,qBAAqB,GAAG;IAAE,OAAO,CAAC,EAAE,cAAc,CAAA;CAAO,GAAG;IAC7F,GAAG,EAAE,IAAI,CAAC;IACV,OAAO,EAAE,cAAc,CAAC;CACzB,CA+FA;AAUD,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG;IAC1D,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CA+BA"}

package/dist/server.js

@@ -0,0 +1,149 @@
+/**
+ * HTTP server (§15.4 / RUNTIME_ROUTES) — implements every Runtime route on top
+ * of the SessionManager. Uses hono + @hono/node-server. The SSE endpoint
+ * streams AG-UI events for a session.
+ *
+ * Routes (from `@brainpilot/protocol` RUNTIME_ROUTES):
+ *   GET  /health, GET /metrics
+ *   POST /sessions, GET /sessions, GET /sessions/:id, DELETE /sessions/:id
+ *   GET  /sessions/:id/state, POST /sessions/:id/messages
+ *   GET  /sse/:id  (+ alias GET /sessions/:id/events)
+ *   POST /sessions/:id/interrupt, GET /sessions/:id/agents, POST /sessions/:id/evict
+ */
+import { Hono } from "hono";
+import { serve } from "@hono/node-server";
+import { stream } from "hono/streaming";
+import { CreateSessionRequestSchema, SendMessageRequestSchema, InterruptRequestSchema, } from "@brainpilot/protocol";
+import { SessionManager } from "./session-manager.js";
+export function createServer(opts = {}) {
+    const manager = opts.manager ?? new SessionManager(opts);
+    const app = new Hono();
+    app.get("/health", (c) => c.json({ status: "ok" }));
+    app.get("/metrics", (c) => c.json(manager.metrics()));
+    app.post("/sessions", async (c) => {
+        const body = await safeBody(c);
+        const parsed = CreateSessionRequestSchema.safeParse(body);
+        const input = parsed.success ? parsed.data : {};
+        const session = await manager.createSession(input);
+        return c.json({ id: session.id, session }, 201);
+    });
+    app.get("/sessions", (c) => c.json({ sessions: manager.listSessions() }));
+    app.get("/sessions/:id", (c) => {
+        const s = manager.getSession(c.req.param("id"));
+        return s ? c.json(s) : c.json({ error: "not found" }, 404);
+    });
+    app.delete("/sessions/:id", async (c) => {
+        const id = c.req.param("id");
+        const deleted = await manager.deleteSession(id);
+        return c.json({ id, deleted }, deleted ? 200 : 404);
+    });
+    app.get("/sessions/:id/state", (c) => {
+        const state = manager.getSessionState(c.req.param("id"));
+        return state ? c.json(state) : c.json({ error: "not found" }, 404);
+    });
+    app.post("/sessions/:id/messages", async (c) => {
+        const id = c.req.param("id");
+        const body = await safeBody(c);
+        const parsed = SendMessageRequestSchema.safeParse(body);
+        if (!parsed.success)
+            return c.json({ error: "invalid body" }, 400);
+        if (!manager.getSession(id))
+            return c.json({ error: "not found" }, 404);
+        const res = await manager.sendMessage(id, parsed.data.content, parsed.data.agent ?? "principal");
+        return c.json(res);
+    });
+    app.post("/sessions/:id/interrupt", async (c) => {
+        const id = c.req.param("id");
+        const body = await safeBody(c);
+        const parsed = InterruptRequestSchema.safeParse(body);
+        const agent = parsed.success ? parsed.data.agent : undefined;
+        const interrupted = await manager.interrupt(id, agent);
+        return c.json({ interrupted });
+    });
+    app.get("/sessions/:id/agents", (c) => c.json({ agents: manager.listAgents(c.req.param("id")) }));
+    app.post("/sessions/:id/evict", async (c) => {
+        const res = await manager.evictSession(c.req.param("id"));
+        return c.json(res, res.evicted ? 200 : 404);
+    });
+    const sseHandler = (id, c) => {
+        if (!manager.getSession(id))
+            return c.json({ error: "not found" }, 404);
+        c.header("Content-Type", "text/event-stream");
+        c.header("Cache-Control", "no-cache");
+        c.header("Connection", "keep-alive");
+        return stream(c, async (s) => {
+            let closed = false;
+            const send = (event) => {
+                if (closed)
+                    return;
+                void s.write(`data: ${JSON.stringify(event)}\n\n`);
+            };
+            // Replay buffered events, then live-subscribe.
+            for (const e of manager.recentEvents(id))
+                send(e);
+            const unsub = manager.subscribe(id, send);
+            s.onAbort(() => {
+                closed = true;
+                unsub?.();
+            });
+            // Keep the stream open until the client disconnects.
+            await new Promise((resolve) => {
+                const iv = setInterval(() => {
+                    if (closed) {
+                        clearInterval(iv);
+                        resolve();
+                    }
+                    else {
+                        void s.write(": ping\n\n");
+                    }
+                }, 15000);
+            });
+        });
+    };
+    app.get("/sse/:id", (c) => sseHandler(c.req.param("id"), c));
+    app.get("/sessions/:id/events", (c) => sseHandler(c.req.param("id"), c));
+    return { app, manager };
+}
+async function safeBody(c) {
+    try {
+        return await c.req.json();
+    }
+    catch {
+        return {};
+    }
+}
+export function startServer(opts = {}) {
+    const { app, manager } = createServer(opts);
+    const port = opts.port ??
+        (process.env.PORT ? Number(process.env.PORT) : undefined) ??
+        (process.env.BP_RUNTIME_PORT ? Number(process.env.BP_RUNTIME_PORT) : undefined) ??
+        8081;
+    const server = serve({ fetch: app.fetch, port });
+    // §7 L4 global safety net.
+    const onFatal = async (err) => {
+        try {
+            await manager.emergencySaveAll();
+        }
+        catch {
+            /* best effort */
+        }
+        // eslint-disable-next-line no-console
+        console.error("[runtime] fatal:", err);
+    };
+    process.on("uncaughtException", (err) => void onFatal(err));
+    process.on("unhandledRejection", (reason) => void onFatal(reason));
+    return {
+        manager,
+        port,
+        close: () => new Promise((resolve) => {
+            server.close(() => resolve());
+        }),
+    };
+}
+// Allow `node dist/server.js` to boot directly.
+if (process.argv[1] && import.meta.url === `file://${process.argv[1]}`) {
+    const { port } = startServer();
+    // eslint-disable-next-line no-console
+    console.log(`[runtime] listening on :${port} (mock=${process.env.BP_MOCK ?? "0"})`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session-manager.d.ts

@@ -0,0 +1,82 @@
+import type { AgUiEvent, AgentStatus, Session } from "@brainpilot/protocol";
+import { MasAgent } from "./mas-agent.js";
+import { McpBridge } from "./mcp-bridge.js";
+import type { AgentSessionFactory, EventListener } from "./types.js";
+export interface SessionManagerOptions {
+    /** Data root (default: BP_DATA_DIR or cwd/.bp-data). */
+    dataRoot?: string;
+    /** Override the agent session factory (default: env-selected). */
+    agentFactory?: AgentSessionFactory;
+    /** Persist events.jsonl / mailbox / trace.json (default true). */
+    persist?: boolean;
+    /** Override the external MCP bridge (default: real stdio bridge). Tests inject a fake. */
+    mcpBridge?: McpBridge;
+}
+export declare class SessionManager {
+    private readonly sessions;
+    private readonly dataRoot;
+    private readonly agentFactory;
+    private readonly persist;
+    private lastActivityAt;
+    private mcpBridge;
+    private mcpTools;
+    private mcpLoaded;
+    constructor(opts?: SessionManagerOptions);
+    /**
+     * Load external MCP tools once. No-op in mock mode (BP_MOCK=1) and when no
+     * `mcp_servers.json` is present, so the default path stays zero-overhead.
+     */
+    private ensureMcpTools;
+    private bpDir;
+    private workspaceDir;
+    private historyPath;
+    createSession(input?: {
+        id?: string;
+        title?: string;
+    }): Promise<Session>;
+    getSession(id: string): Session | undefined;
+    listSessions(): Session[];
+    deleteSession(id: string): Promise<boolean>;
+    /** Evict idle session: stop agents + drop from memory, KEEP disk (§修正2). */
+    evictSession(id: string): Promise<{
+        evicted: boolean;
+        agentsKilled: number;
+    }>;
+    /** Send a user message to an agent (default principal). §7 L3 isolated. */
+    sendMessage(sessionId: string, content: string, agentName?: string): Promise<{
+        accepted: boolean;
+        runId?: string;
+    }>;
+    /** Interrupt a session (or a specific agent). */
+    interrupt(sessionId: string, agentName?: string): Promise<boolean>;
+    /** Ensure an agent exists (create or resurrect). */
+    ensureAgent(sessionId: string, name: string): Promise<MasAgent>;
+    destroyAgent(sessionId: string, name: string): Promise<void>;
+    /** §10 polling fallback: list agents with authoritative status. */
+    listAgents(sessionId: string): AgentStatus[];
+    getSessionState(sessionId: string): {
+        runState: {
+            active: boolean;
+            runId: string | null;
+        };
+        agents: AgentStatus[];
+        lastActivityTs: string;
+    } | undefined;
+    metrics(): {
+        activeSessions: number;
+        runningAgents: number;
+        lastActivityAt: string | null;
+        memRss: number;
+    };
+    subscribe(sessionId: string, listener: EventListener): (() => void) | undefined;
+    recentEvents(sessionId: string): AgUiEvent[];
+    /** §7: flush all persisted state before exit. */
+    emergencySaveAll(): Promise<void>;
+    private touch;
+    private toSession;
+    private writeMeta;
+    private loadTrace;
+    /** Restore session list from disk (§10 策略A: agents start idle, lazily revived). */
+    restoreFromDisk(): Promise<string[]>;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

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