@brainpilot/backend-core 0.0.1

package/dist/app.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hono app — the host-side lightweight backend (§10, §11A).
+ *
+ * Responsibilities:
+ *  - REST routes the SPA needs → forwarded to the runtime via RuntimeClient
+ *    (byte passthrough, 修正4: no parsing, no state).
+ *  - SSE route → byte-pipes the runtime's event stream to the client.
+ *  - Local config routes (settings/providers) → read/write on-disk config
+ *    (NOT proxied; backend owns this, §11A.2).
+ *  - Static serving of the web build (@brainpilot/web dist) with SPA fallback.
+ *  - Health endpoint.
+ *
+ * The app is mounted under `/api` for the proxied/local routes (the SPA calls
+ * `API_BASE = "/api"`), with static assets served at the root.
+ */
+import { Hono } from "hono";
+import type { Orchestrator } from "./orchestrator.js";
+export interface CreateAppOptions {
+    orchestrator: Orchestrator;
+    /** Data dir for local config routes. Default `./brainpilot`. */
+    dataDir?: string;
+    /** Web build dir to serve. Default `$BP_WEB_ROOT` or `packages/web/dist`. */
+    webRoot?: string;
+    /** Injectable fetch for the runtime client (tests). */
+    fetchFn?: typeof fetch;
+    /** Disable static serving (tests that only exercise the API). */
+    serveWeb?: boolean;
+    env?: Record<string, string | undefined>;
+}
+export declare function createApp(options: CreateAppOptions): Hono;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOtD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAWD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CA4IzD"}

package/dist/app.js

@@ -0,0 +1,197 @@
+/**
+ * Hono app — the host-side lightweight backend (§10, §11A).
+ *
+ * Responsibilities:
+ *  - REST routes the SPA needs → forwarded to the runtime via RuntimeClient
+ *    (byte passthrough, 修正4: no parsing, no state).
+ *  - SSE route → byte-pipes the runtime's event stream to the client.
+ *  - Local config routes (settings/providers) → read/write on-disk config
+ *    (NOT proxied; backend owns this, §11A.2).
+ *  - Static serving of the web build (@brainpilot/web dist) with SPA fallback.
+ *  - Health endpoint.
+ *
+ * The app is mounted under `/api` for the proxied/local routes (the SPA calls
+ * `API_BASE = "/api"`), with static assets served at the root.
+ */
+import { Hono } from "hono";
+import { serveStatic } from "@hono/node-server/serve-static";
+import { RuntimeClient } from "./runtime-client.js";
+import { readLocalSettings, writeLocalSettings, resolveProvider, } from "./config.js";
+/** Headers that must not be copied verbatim onto an SSE passthrough. */
+const HOP_BY_HOP = new Set([
+    "connection",
+    "keep-alive",
+    "transfer-encoding",
+    "content-encoding",
+    "content-length",
+]);
+export function createApp(options) {
+    const dataDir = options.dataDir ?? process.env.BP_DATA_DIR ?? "./brainpilot";
+    const webRoot = options.webRoot ?? process.env.BP_WEB_ROOT ?? "packages/web/dist";
+    const orchestrator = options.orchestrator;
+    const env = options.env;
+    // Lazily-created runtime client, bound to the ensured runtime's baseUrl.
+    let client = null;
+    async function getClient() {
+        const handle = await orchestrator.ensureRuntime();
+        if (!client || client._baseUrl !== handle.baseUrl) {
+            client = new RuntimeClient({ baseUrl: handle.baseUrl, fetchFn: options.fetchFn });
+            client._baseUrl = handle.baseUrl;
+        }
+        return client;
+    }
+    const app = new Hono();
+    const api = new Hono();
+    // ---- Health (backend-local; does not require runtime) ----------------
+    api.get("/health", (c) => c.json({ status: "ok" }));
+    api.get("/version", (c) => c.json({ name: "@brainpilot/backend-core", version: "0.1.0" }));
+    // ---- Sessions (proxied to runtime) -----------------------------------
+    api.get("/sessions", forward("listSessions"));
+    api.post("/sessions", forward("createSession", { withBody: true }));
+    api.get("/sessions/:id", forward("getSession", { idParam: "id" }));
+    api.put("/sessions/:id", forwardRename());
+    api.delete("/sessions/:id", forward("deleteSession", { idParam: "id" }));
+    api.get("/sessions/:id/state", forward("getSessionState", { idParam: "id" }));
+    api.post("/sessions/:id/messages", forward("sendMessage", { idParam: "id", withBody: true }));
+    api.post("/sessions/:id/interrupt", forward("interrupt", { idParam: "id", withBody: true }));
+    api.get("/sessions/:id/agents", forward("listAgents", { idParam: "id" }));
+    api.post("/sessions/:id/evict", forward("evictSession", { idParam: "id", withBody: true }));
+    // ---- SSE byte passthrough (修正4) ------------------------------------
+    // Canonical protocol path `/sse/:id` (RUNTIME_ROUTES.sessionEvents) plus the
+    // SPA's `/sessions/:id/sse` and the `/sessions/:id/events` alias.
+    api.get("/sse/:id", sseHandler);
+    api.get("/sessions/:id/sse", sseHandler);
+    api.get("/sessions/:id/events", sseHandler);
+    // ---- Local config routes (NOT proxied; §11A.2) -----------------------
+    api.get("/settings", async (c) => {
+        const settings = await readLocalSettings({ dataDir, env });
+        return c.json(settings);
+    });
+    api.put("/settings", async (c) => {
+        const body = await safeJson(c);
+        await writeLocalSettings(dataDir, {
+            model: typeof body.model === "string" ? body.model : undefined,
+            apiKey: typeof body.api_key === "string" ? body.api_key : (typeof body.apiKey === "string" ? body.apiKey : undefined),
+            baseUrl: typeof body.base_url === "string" ? body.base_url : (typeof body.baseUrl === "string" ? body.baseUrl : undefined),
+        });
+        return c.json(await readLocalSettings({ dataDir, env }));
+    });
+    // Provider profiles: single-user open-source mode exposes the resolved
+    // provider as one active profile (sourced from the §11A.2 priority chain).
+    api.get("/provider/profiles", async (c) => {
+        const resolved = await resolveProvider({ dataDir, env });
+        return c.json(resolved.apiKey ? [providerProfile(resolved)] : []);
+    });
+    api.get("/provider/profiles/active", async (c) => {
+        const resolved = await resolveProvider({ dataDir, env });
+        return c.json(resolved.apiKey ? providerProfile(resolved) : null);
+    });
+    // Mount the API under /api (the SPA's API_BASE).
+    app.route("/api", api);
+    // ---- Static web serving with SPA fallback ----------------------------
+    if (options.serveWeb !== false) {
+        app.use("/*", serveStatic({ root: webRoot }));
+        // SPA fallback: any unmatched GET that isn't /api returns index.html.
+        app.get("/*", serveStatic({ path: `${webRoot}/index.html` }));
+    }
+    return app;
+    // ---------------- helpers ----------------
+    function forward(route, opts = {}) {
+        return async (c) => {
+            const rc = await getClient();
+            const params = {};
+            if (opts.idParam)
+                params.id = c.req.param(opts.idParam) ?? "";
+            const body = opts.withBody ? await c.req.text() : undefined;
+            const headers = {};
+            const ct = c.req.header("content-type");
+            if (ct)
+                headers["content-type"] = ct;
+            const upstream = await rc.forward(route, {
+                params,
+                body: body && body.length > 0 ? body : undefined,
+                headers,
+            });
+            return relay(c, upstream);
+        };
+    }
+    // The SPA's PUT /sessions/:id (rename) has no dedicated runtime route in
+    // §15.4; forward it to the runtime's getSession path with PUT semantics via
+    // a raw forward so the runtime can handle/ignore it. We reuse sendMessage's
+    // session path shape but keep method PUT by hitting getSession's path.
+    function forwardRename() {
+        return async (c) => {
+            const rc = await getClient();
+            const id = c.req.param("id") ?? "";
+            const body = await c.req.text();
+            // getSession route path is `/sessions/:id`; issue a PUT against it.
+            const url = rc.urlFor("getSession", { id });
+            const upstream = await (options.fetchFn ?? fetch)(url, {
+                method: "PUT",
+                headers: { "content-type": c.req.header("content-type") ?? "application/json" },
+                body: body && body.length > 0 ? body : undefined,
+            });
+            return relay(c, upstream);
+        };
+    }
+    async function sseHandler(c) {
+        const rc = await getClient();
+        const id = c.req.param("id") ?? "";
+        const upstream = await rc.openSse(id, {
+            query: c.req.query("token") ? `token=${encodeURIComponent(c.req.query("token"))}` : undefined,
+        });
+        // 修正4: do not parse the stream — relay the byte body untouched.
+        const headers = new Headers();
+        upstream.headers.forEach((value, key) => {
+            if (!HOP_BY_HOP.has(key.toLowerCase()))
+                headers.set(key, value);
+        });
+        if (!headers.has("content-type"))
+            headers.set("content-type", "text/event-stream");
+        headers.set("cache-control", "no-cache");
+        headers.set("connection", "keep-alive");
+        return new Response(upstream.body, { status: upstream.status, headers });
+    }
+}
+/** Relay a runtime Response to the client, preserving status + safe headers. */
+function relay(c, upstream) {
+    const headers = new Headers();
+    upstream.headers.forEach((value, key) => {
+        if (!HOP_BY_HOP.has(key.toLowerCase()))
+            headers.set(key, value);
+    });
+    return new Response(upstream.body, { status: upstream.status, headers });
+}
+async function safeJson(c) {
+    try {
+        const v = await c.req.json();
+        return v && typeof v === "object" ? v : {};
+    }
+    catch {
+        return {};
+    }
+}
+function providerProfile(resolved) {
+    const now = Date.now();
+    const masked = resolved.apiKey
+        ? resolved.apiKey.length <= 8
+            ? "****"
+            : `${resolved.apiKey.slice(0, 4)}…${resolved.apiKey.slice(-4)}`
+        : "";
+    return {
+        id: "local",
+        name: "Local",
+        base_url: resolved.baseUrl ?? "",
+        models: resolved.model ? [resolved.model] : [],
+        icon: "circle",
+        icon_color: "#111111",
+        notes: "",
+        is_active: true,
+        api_key_masked: masked,
+        created_at: now,
+        updated_at: now,
+        health_status: "unknown",
+        model_health: [],
+    };
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,46 @@
+export interface ResolvedProvider {
+    /** API key, if any layer supplied one. */
+    apiKey?: string;
+    /** Base URL override, if any. */
+    baseUrl?: string;
+    /** Model id, if any. */
+    model?: string;
+    /** Which layer the apiKey came from (for diagnostics). */
+    source?: "env" | "bp_template" | "config" | "dotenv";
+}
+export interface ConfigPaths {
+    dataDir: string;
+    bpTemplateSettings: string;
+    brainpilotConfig: string;
+    dotenv: string;
+}
+export declare function configPaths(dataDir: string): ConfigPaths;
+/** Minimal .env parser (KEY=VALUE per line, `#` comments, optional quotes). */
+export declare function parseDotenv(file: string): Promise<Record<string, string>>;
+export interface ResolveProviderOptions {
+    dataDir: string;
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Resolve the effective provider config by walking the priority chain. The
+ * apiKey's `source` reflects the FIRST layer that supplied it; baseUrl/model
+ * are likewise taken from the highest layer that supplies each.
+ */
+export declare function resolveProvider(options: ResolveProviderOptions): Promise<ResolvedProvider>;
+/** Masked, frontend-facing settings (never leak the raw key). */
+export interface LocalSettings {
+    model: string;
+    apiKey: string;
+    baseUrl: string;
+}
+export declare function readLocalSettings(options: ResolveProviderOptions): Promise<LocalSettings>;
+/**
+ * Persist a settings patch to `bp_template/settings.json` (the user-editable
+ * template layer). Merges with existing content.
+ */
+export declare function writeLocalSettings(dataDir: string, patch: Partial<{
+    model: string;
+    apiKey: string;
+    baseUrl: string;
+}>): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,CAAC,EAAE,KAAK,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAOxD;AAYD,+EAA+E;AAC/E,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwB/E;AAmBD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAiD3B;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACjE,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/config.js

@@ -0,0 +1,161 @@
+/**
+ * Local config resolution — backend-LOCAL settings/provider routes (§11A.2).
+ * These are NOT proxied to the runtime; the backend owns the on-disk config
+ * tree under the data dir (`./brainpilot/` by default).
+ *
+ * Provider/key priority (§11A.2 要点 2), highest first:
+ *   1. real environment variables (ANTHROPIC_API_KEY, etc.)
+ *   2. bp_template/settings.json
+ *   3. brainpilot.config.json
+ *   4. .env  (lowest — fallback)
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+export function configPaths(dataDir) {
+    return {
+        dataDir,
+        bpTemplateSettings: path.join(dataDir, "bp_template", "settings.json"),
+        brainpilotConfig: path.join(dataDir, "brainpilot.config.json"),
+        dotenv: path.join(dataDir, ".env"),
+    };
+}
+async function readJsonSafe(file) {
+    try {
+        const text = await fs.readFile(file, "utf8");
+        const parsed = JSON.parse(text);
+        return parsed && typeof parsed === "object" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Minimal .env parser (KEY=VALUE per line, `#` comments, optional quotes). */
+export async function parseDotenv(file) {
+    let text;
+    try {
+        text = await fs.readFile(file, "utf8");
+    }
+    catch {
+        return {};
+    }
+    const out = {};
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        const eq = line.indexOf("=");
+        if (eq < 0)
+            continue;
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (key)
+            out[key] = value;
+    }
+    return out;
+}
+function pickString(obj, ...keys) {
+    if (!obj)
+        return undefined;
+    for (const k of keys) {
+        const v = obj[k];
+        if (typeof v === "string" && v.length > 0)
+            return v;
+    }
+    // Nested `provider` object support (settings.json may nest).
+    const provider = obj.provider;
+    if (provider && typeof provider === "object") {
+        for (const k of keys) {
+            const v = provider[k];
+            if (typeof v === "string" && v.length > 0)
+                return v;
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve the effective provider config by walking the priority chain. The
+ * apiKey's `source` reflects the FIRST layer that supplied it; baseUrl/model
+ * are likewise taken from the highest layer that supplies each.
+ */
+export async function resolveProvider(options) {
+    const env = options.env ?? process.env;
+    const paths = configPaths(options.dataDir);
+    const templateSettings = await readJsonSafe(paths.bpTemplateSettings);
+    const config = await readJsonSafe(paths.brainpilotConfig);
+    const dotenv = await parseDotenv(paths.dotenv);
+    // Layer values, highest priority first.
+    const envKey = env.ANTHROPIC_API_KEY || env.BP_API_KEY || env.OPENAI_API_KEY || undefined;
+    const templateKey = pickString(templateSettings, "apiKey", "api_key");
+    const configKey = pickString(config, "apiKey", "api_key");
+    const dotenvKey = dotenv.ANTHROPIC_API_KEY || dotenv.BP_API_KEY || dotenv.OPENAI_API_KEY || undefined;
+    let apiKey;
+    let source;
+    if (envKey) {
+        apiKey = envKey;
+        source = "env";
+    }
+    else if (templateKey) {
+        apiKey = templateKey;
+        source = "bp_template";
+    }
+    else if (configKey) {
+        apiKey = configKey;
+        source = "config";
+    }
+    else if (dotenvKey) {
+        apiKey = dotenvKey;
+        source = "dotenv";
+    }
+    const baseUrl = env.ANTHROPIC_BASE_URL ||
+        env.BP_BASE_URL ||
+        pickString(templateSettings, "baseUrl", "base_url") ||
+        pickString(config, "baseUrl", "base_url") ||
+        dotenv.ANTHROPIC_BASE_URL ||
+        dotenv.BP_BASE_URL ||
+        undefined;
+    const model = env.BP_MODEL ||
+        pickString(templateSettings, "model") ||
+        pickString(config, "model") ||
+        dotenv.BP_MODEL ||
+        undefined;
+    return { apiKey, baseUrl, model, source };
+}
+function maskKey(key) {
+    if (!key)
+        return "";
+    if (key.length <= 8)
+        return "****";
+    return `${key.slice(0, 4)}…${key.slice(-4)}`;
+}
+export async function readLocalSettings(options) {
+    const resolved = await resolveProvider(options);
+    return {
+        model: resolved.model ?? "",
+        apiKey: maskKey(resolved.apiKey),
+        baseUrl: resolved.baseUrl ?? "",
+    };
+}
+/**
+ * Persist a settings patch to `bp_template/settings.json` (the user-editable
+ * template layer). Merges with existing content.
+ */
+export async function writeLocalSettings(dataDir, patch) {
+    const file = configPaths(dataDir).bpTemplateSettings;
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const existing = (await readJsonSafe(file)) ?? {};
+    const next = { ...existing };
+    if (patch.model !== undefined)
+        next.model = patch.model;
+    if (patch.apiKey !== undefined)
+        next.apiKey = patch.apiKey;
+    if (patch.baseUrl !== undefined)
+        next.baseUrl = patch.baseUrl;
+    const tmp = `${file}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(next, null, 2), "utf8");
+    await fs.rename(tmp, file); // atomic write (§16.4 fix)
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/create-orchestrator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * createOrchestrator — factory picking Local / Static / Docker based on env/options.
+ */
+import { type Orchestrator, type OrchestratorMode } from "./orchestrator.js";
+import { type LocalOrchestratorOptions } from "./local-orchestrator.js";
+import { type StaticOrchestratorOptions } from "./static-orchestrator.js";
+import { type DockerOrchestratorOptions } from "./docker-orchestrator.js";
+export interface CreateOrchestratorOptions {
+    /** Force a mode; otherwise resolved from env (BP_ORCHESTRATOR / BP_RUNTIME_URL / BP_MODE). */
+    mode?: OrchestratorMode;
+    local?: LocalOrchestratorOptions;
+    static?: Partial<StaticOrchestratorOptions>;
+    docker?: DockerOrchestratorOptions;
+    env?: Record<string, string | undefined>;
+}
+export declare function createOrchestrator(options?: CreateOrchestratorOptions): Orchestrator;
+//# sourceMappingURL=create-orchestrator.d.ts.map

package/dist/create-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-orchestrator.d.ts","sourceRoot":"","sources":["../src/create-orchestrator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,yBAAyB;IACxC,8FAA8F;IAC9F,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,yBAAyB,CAAC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,YAAY,CA4Bd"}

package/dist/create-orchestrator.js

@@ -0,0 +1,35 @@
+/**
+ * createOrchestrator — factory picking Local / Static / Docker based on env/options.
+ */
+import { resolveOrchestratorMode, } from "./orchestrator.js";
+import { LocalProcessOrchestrator, } from "./local-orchestrator.js";
+import { StaticRuntimeOrchestrator, } from "./static-orchestrator.js";
+import { DockerOrchestrator, } from "./docker-orchestrator.js";
+import { runtimeArtifactPaths } from "./runtime-paths.js";
+export function createOrchestrator(options = {}) {
+    const env = options.env ?? process.env;
+    const mode = options.mode ?? resolveOrchestratorMode(env);
+    if (mode === "docker") {
+        return new DockerOrchestrator(options.docker);
+    }
+    if (mode === "static") {
+        const baseUrl = options.static?.baseUrl ?? env.BP_RUNTIME_URL ?? "";
+        return new StaticRuntimeOrchestrator({ ...options.static, baseUrl });
+    }
+    // Default a fatal handler so an exhausted crash-loop is at least surfaced
+    // (§11A.5 / §7 L4) instead of the runtime silently disappearing.
+    // Derive log/pid paths from BP_DATA_DIR so logs/status/down can observe the runtime child.
+    const dataDir = options.local?.dataDir ?? env.BP_DATA_DIR ?? "./brainpilot";
+    const artifacts = runtimeArtifactPaths(dataDir);
+    const local = {
+        onFatal: (err) => {
+            // eslint-disable-next-line no-console
+            console.error("[orchestrator] runtime fatal:", err.message);
+        },
+        runtimeLogFile: artifacts.runtimeLog,
+        runtimePidFile: artifacts.runtimePid,
+        ...options.local,
+    };
+    return new LocalProcessOrchestrator(local);
+}
+//# sourceMappingURL=create-orchestrator.js.map

package/dist/create-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-orchestrator.js","sourceRoot":"","sources":["../src/create-orchestrator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,uBAAuB,GAGxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,wBAAwB,GAEzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,yBAAyB,GAE1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,GAEnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAW1D,MAAM,UAAU,kBAAkB,CAChC,UAAqC,EAAE;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE1D,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QACpE,OAAO,IAAI,yBAAyB,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,0EAA0E;IAC1E,iEAAiE;IACjE,2FAA2F;IAC3F,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC,WAAW,IAAI,cAAc,CAAC;IAC5E,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAA6B;QACtC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAC9D,CAAC;QACD,cAAc,EAAE,SAAS,CAAC,UAAU;QACpC,cAAc,EAAE,SAAS,CAAC,UAAU;QACpC,GAAG,OAAO,CAAC,KAAK;KACjB,CAAC;IACF,OAAO,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/docker-orchestrator.d.ts

@@ -0,0 +1,75 @@
+/**
+ * DockerOrchestrator — `docker run` the `brainpilot-sandbox` image over the mapped host port.
+ * dockerode is loaded lazily via dynamic import (免 Docker install never pulls dockerode + gRPC/protobuf); the public API uses the local DockerLike, not dockerode types.
+ */
+import type { EnsureRuntimeOptions, Orchestrator, RuntimeHandle } from "./orchestrator.js";
+/** Minimal container surface we use from dockerode. */
+export interface DockerContainerLike {
+    start(): Promise<unknown>;
+    stop(opts?: {
+        t?: number;
+    }): Promise<unknown>;
+    remove(opts?: {
+        force?: boolean;
+    }): Promise<unknown>;
+}
+/** Minimal dockerode surface we use. */
+export interface DockerLike {
+    createContainer(spec: unknown): Promise<DockerContainerLike>;
+    pull(image: string, cb: (err: Error | null, stream: NodeJS.ReadableStream | undefined) => void): void;
+    modem: {
+        followProgress(stream: NodeJS.ReadableStream, onFinished: (err: Error | null) => void): void;
+    };
+}
+/** Lazily import dockerode and return its default constructor. */
+export type DockerLoader = () => Promise<{
+    default: new () => DockerLike;
+}>;
+export interface DockerOrchestratorOptions {
+    /** Image to run. Default `brainpilot-sandbox:latest`. */
+    image?: string;
+    /** Container-internal runtime port. Default 8081. */
+    containerPort?: number;
+    /** Host port to map to. Default = containerPort. */
+    hostPort?: number;
+    host?: string;
+    /** Host data dir bind-mounted to the container's BP_DATA_DIR. */
+    dataDir?: string;
+    /** Container path BP_DATA_DIR points at. Default `/root/.bp-root`. */
+    containerDataDir?: string;
+    /** Injectable dockerode-like instance (for tests / advanced callers). */
+    docker?: DockerLike;
+    /** Injectable lazy loader (for tests). Defaults to dynamic import("dockerode"). */
+    dockerLoader?: DockerLoader;
+    /** Extra env passed to the container. */
+    env?: Record<string, string>;
+    healthProbe?: (baseUrl: string) => Promise<boolean>;
+    healthTimeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare class DockerOrchestrator implements Orchestrator {
+    private docker;
+    private readonly dockerLoader;
+    private readonly image;
+    private readonly containerPort;
+    private readonly hostPort;
+    private readonly host;
+    private readonly containerDataDir;
+    private readonly healthProbe;
+    private readonly healthTimeoutMs;
+    private readonly sleep;
+    private dataDir?;
+    private env;
+    private container;
+    constructor(options?: DockerOrchestratorOptions);
+    /** Resolve a dockerode-like instance, loading dockerode lazily on first use. */
+    private getDocker;
+    get baseUrl(): string;
+    ensureRuntime(opts?: EnsureRuntimeOptions): Promise<RuntimeHandle>;
+    /** Pull `this.image`, resolving once the pull stream finishes. */
+    private pullImage;
+    health(): Promise<boolean>;
+    stopRuntime(): Promise<void>;
+    private waitForHealth;
+}
+//# sourceMappingURL=docker-orchestrator.d.ts.map

package/dist/docker-orchestrator.d.ts.map

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