@brainpilot/backend-core 0.0.1

package/dist/runtime-client.d.ts

@@ -0,0 +1,54 @@
+/**
+ * RuntimeClient — thin typed HTTP client over `RUNTIME_ROUTES`
+ * (TS_PI_REFACTOR_DESIGN §15.4). Two responsibilities:
+ *
+ *  1. REST forwarding — build the runtime URL from a route name + params and
+ *     forward method/headers/body. Per 修正4, the backend is a byte-level
+ *     passthrough: we do NOT re-validate runtime responses, we return them as
+ *     they are. Protocol schemas only TYPE the calls.
+ *
+ *  2. SSE passthrough — open the runtime's event stream and hand back the raw
+ *     `Response` whose `body` is a byte `ReadableStream`. The caller pipes
+ *     those bytes straight to the browser without parsing (no state held).
+ */
+import { type RuntimeRouteName } from "@brainpilot/protocol";
+export interface RuntimeClientOptions {
+    /** Runtime base URL, e.g. http://127.0.0.1:8081. No trailing slash. */
+    baseUrl: string;
+    /** Injectable fetch (for tests). Defaults to global fetch. */
+    fetchFn?: typeof fetch;
+}
+/** Fill `:param` placeholders in a route path template. */
+export declare function buildPath(template: string, params?: Record<string, string>): string;
+export interface ForwardOptions {
+    params?: Record<string, string>;
+    /** Raw, already-serialized request body to forward. */
+    body?: string | null;
+    headers?: Record<string, string>;
+    /** Query string to append (without leading `?`). */
+    query?: string;
+    signal?: AbortSignal;
+}
+export declare class RuntimeClient {
+    private readonly baseUrl;
+    private readonly fetchFn;
+    constructor(options: RuntimeClientOptions);
+    /** Resolve a route name to a concrete URL. */
+    urlFor(route: RuntimeRouteName, params?: Record<string, string>, query?: string): string;
+    /**
+     * Forward a REST call to the runtime and return the raw `Response`. The body
+     * is NOT parsed or validated here (修正4); callers stream/relay it as-is.
+     */
+    forward(route: RuntimeRouteName, opts?: ForwardOptions): Promise<Response>;
+    /**
+     * Open the runtime SSE stream for a session. Returns the raw `Response`;
+     * `response.body` is a byte `ReadableStream` the caller pipes to the client.
+     * Defaults to the canonical `/sse/:id` route (§15.4).
+     */
+    openSse(sessionId: string, opts?: {
+        route?: RuntimeRouteName;
+        query?: string;
+        signal?: AbortSignal;
+    }): Promise<Response>;
+}
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../src/runtime-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,MAAM,CAQR;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,OAAO,EAAE,oBAAoB;IAKzC,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAMxF;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWpF;;;;OAIG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,gBAAgB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAO,GAC5E,OAAO,CAAC,QAAQ,CAAC;CASrB"}

package/dist/runtime-client.js

@@ -0,0 +1,67 @@
+/**
+ * RuntimeClient — thin typed HTTP client over `RUNTIME_ROUTES`
+ * (TS_PI_REFACTOR_DESIGN §15.4). Two responsibilities:
+ *
+ *  1. REST forwarding — build the runtime URL from a route name + params and
+ *     forward method/headers/body. Per 修正4, the backend is a byte-level
+ *     passthrough: we do NOT re-validate runtime responses, we return them as
+ *     they are. Protocol schemas only TYPE the calls.
+ *
+ *  2. SSE passthrough — open the runtime's event stream and hand back the raw
+ *     `Response` whose `body` is a byte `ReadableStream`. The caller pipes
+ *     those bytes straight to the browser without parsing (no state held).
+ */
+import { RUNTIME_ROUTES } from "@brainpilot/protocol";
+/** Fill `:param` placeholders in a route path template. */
+export function buildPath(template, params = {}) {
+    return template.replace(/:([A-Za-z0-9_]+)/g, (_m, key) => {
+        const value = params[key];
+        if (value === undefined) {
+            throw new Error(`missing path param ":${key}" for "${template}"`);
+        }
+        return encodeURIComponent(value);
+    });
+}
+export class RuntimeClient {
+    baseUrl;
+    fetchFn;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.fetchFn = options.fetchFn ?? fetch;
+    }
+    /** Resolve a route name to a concrete URL. */
+    urlFor(route, params, query) {
+        const def = RUNTIME_ROUTES[route];
+        const path = buildPath(def.path, params);
+        return `${this.baseUrl}${path}${query ? `?${query}` : ""}`;
+    }
+    /**
+     * Forward a REST call to the runtime and return the raw `Response`. The body
+     * is NOT parsed or validated here (修正4); callers stream/relay it as-is.
+     */
+    async forward(route, opts = {}) {
+        const def = RUNTIME_ROUTES[route];
+        const url = this.urlFor(route, opts.params, opts.query);
+        return this.fetchFn(url, {
+            method: def.method,
+            headers: opts.headers,
+            body: opts.body ?? undefined,
+            signal: opts.signal,
+        });
+    }
+    /**
+     * Open the runtime SSE stream for a session. Returns the raw `Response`;
+     * `response.body` is a byte `ReadableStream` the caller pipes to the client.
+     * Defaults to the canonical `/sse/:id` route (§15.4).
+     */
+    async openSse(sessionId, opts = {}) {
+        const route = opts.route ?? "sessionEvents";
+        const url = this.urlFor(route, { id: sessionId, sessionId }, opts.query);
+        return this.fetchFn(url, {
+            method: "GET",
+            headers: { accept: "text/event-stream" },
+            signal: opts.signal,
+        });
+    }
+}
+//# sourceMappingURL=runtime-client.js.map

package/dist/runtime-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.js","sourceRoot":"","sources":["../src/runtime-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,cAAc,EAAyB,MAAM,sBAAsB,CAAC;AAS7E,2DAA2D;AAC3D,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,SAAiC,EAAE;IAEnC,OAAO,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,EAAE,EAAE,GAAW,EAAE,EAAE;QAC/D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,UAAU,QAAQ,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAYD,MAAM,OAAO,aAAa;IACP,OAAO,CAAS;IAChB,OAAO,CAAe;IAEvC,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,MAAM,CAAC,KAAuB,EAAE,MAA+B,EAAE,KAAc;QAC7E,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,KAAuB,EAAE,OAAuB,EAAE;QAC9D,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,OAA2E,EAAE;QAE7E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,eAAe,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE;YACxC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/runtime-paths.d.ts

@@ -0,0 +1,8 @@
+export interface RuntimeArtifactPaths {
+    /** Where the runtime child's stdout/stderr is appended. */
+    runtimeLog: string;
+    /** Where the runtime child's pid is written. */
+    runtimePid: string;
+}
+export declare function runtimeArtifactPaths(dataDir: string): RuntimeArtifactPaths;
+//# sourceMappingURL=runtime-paths.d.ts.map

package/dist/runtime-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.d.ts","sourceRoot":"","sources":["../src/runtime-paths.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAM1E"}

package/dist/runtime-paths.js

@@ -0,0 +1,10 @@
+// Mirrors cli/paths.ts dataPaths(); inlined here to avoid a cli→backend-core import cycle.
+import { join } from "node:path";
+export function runtimeArtifactPaths(dataDir) {
+    const runtimeDir = join(dataDir, ".runtime");
+    return {
+        runtimeLog: join(runtimeDir, "logs", "runtime.log"),
+        runtimePid: join(runtimeDir, "runtime.pid"),
+    };
+}
+//# sourceMappingURL=runtime-paths.js.map

package/dist/runtime-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.js","sourceRoot":"","sources":["../src/runtime-paths.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7C,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC;QACnD,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+/**
+ * server.ts — boots the Hono app via @hono/node-server (§11A.3 / §11A.4 step 4).
+ * Exported via the package's `./server` entry. The orchestrator's runtime is
+ * started lazily on the first request that needs it; graceful shutdown stops it.
+ */
+import { type ServerType } from "@hono/node-server";
+import { type CreateAppOptions } from "./app.js";
+import type { Orchestrator } from "./orchestrator.js";
+export interface StartServerOptions extends Partial<CreateAppOptions> {
+    /** Backend port. Default 9001 (§11A.5 决策 D). */
+    port?: number;
+    hostname?: string;
+    /** Provide a pre-built orchestrator; otherwise one is created from env. */
+    orchestrator?: Orchestrator;
+    /** Eagerly ensure the runtime at boot (default false — lazy on first use). */
+    eager?: boolean;
+}
+export interface RunningServer {
+    server: ServerType;
+    orchestrator: Orchestrator;
+    port: number;
+    stop: () => Promise<void>;
+}
+export declare function startServer(options?: StartServerOptions): Promise<RunningServer>;
+//# 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;;;;GAIG;AACH,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,kBAAmB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IACnE,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAC/B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,aAAa,CAAC,CAqCxB"}

package/dist/server.js

@@ -0,0 +1,54 @@
+/**
+ * server.ts — boots the Hono app via @hono/node-server (§11A.3 / §11A.4 step 4).
+ * Exported via the package's `./server` entry. The orchestrator's runtime is
+ * started lazily on the first request that needs it; graceful shutdown stops it.
+ */
+import { serve } from "@hono/node-server";
+import { createApp } from "./app.js";
+import { createOrchestrator } from "./create-orchestrator.js";
+export async function startServer(options = {}) {
+    const port = options.port ?? Number(process.env.PORT ?? 9001);
+    // 127.0.0.1 is the safe default for local/CLI use; containers set BP_HOST=0.0.0.0
+    // so the published port (DNAT'd to the container IP) can reach the server.
+    const hostname = options.hostname ?? process.env.BP_HOST ?? "127.0.0.1";
+    const orchestrator = options.orchestrator ?? createOrchestrator();
+    const app = createApp({
+        orchestrator,
+        dataDir: options.dataDir,
+        webRoot: options.webRoot,
+        fetchFn: options.fetchFn,
+        serveWeb: options.serveWeb,
+        env: options.env,
+    });
+    if (options.eager) {
+        await orchestrator.ensureRuntime();
+    }
+    const server = serve({ fetch: app.fetch, port, hostname });
+    const stop = async () => {
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+        });
+        await orchestrator.stopRuntime();
+    };
+    // Graceful shutdown on signals (best-effort; CLI/PM2 may also manage this).
+    const onSignal = () => {
+        void stop().finally(() => process.exit(0));
+    };
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+    return { server, orchestrator, port, stop };
+}
+// Allow `node dist/server.js` to boot directly.
+const isMain = typeof process.argv[1] === "string" &&
+    import.meta.url === `file://${process.argv[1]}`;
+if (isMain) {
+    startServer().then((s) => {
+        // eslint-disable-next-line no-console
+        console.log(`[backend-core] listening on port ${s.port}`);
+    }, (err) => {
+        // eslint-disable-next-line no-console
+        console.error("[backend-core] failed to start:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAmB,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAyB,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAoB9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAA8B,EAAE;IAEhC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IAC9D,kFAAkF;IAClF,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,WAAW,CAAC;IACxE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,kBAAkB,EAAE,CAAC;IAElE,MAAM,GAAG,GAAG,SAAS,CAAC;QACpB,YAAY;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,YAAY,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE3D,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,MAAM,YAAY,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC,CAAC;IAEF,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAElC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,gDAAgD;AAChD,MAAM,MAAM,GACV,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;IACnC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,IAAI,MAAM,EAAE,CAAC;IACX,WAAW,EAAE,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE;QACJ,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;QACN,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/static-orchestrator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * StaticRuntimeOrchestrator — static sandbox 模式 (docker-deploy spec §4.1).
+ *
+ * The runtime container is started by docker-compose, NOT by the backend. This
+ * orchestrator therefore creates nothing: it only health-probes a pre-provisioned
+ * `BP_RUNTIME_URL` and hands the backend that URL. `stopRuntime` is a no-op —
+ * compose owns the container lifecycle.
+ *
+ * Same `Orchestrator` surface as Local/Docker so app.ts / runtime-client are
+ * agnostic to deployment mode.
+ */
+import type { EnsureRuntimeOptions, Orchestrator, RuntimeHandle } from "./orchestrator.js";
+export interface StaticOrchestratorOptions {
+    /** Pre-provisioned runtime URL (BP_RUNTIME_URL). Trailing slash is stripped. */
+    baseUrl: string;
+    /** Injectable health probe (for tests). Defaults to fetch GET /health. */
+    healthProbe?: (baseUrl: string) => Promise<boolean>;
+    /** Max ms to wait for the runtime to become healthy. Default 30_000. */
+    healthTimeoutMs?: number;
+    /** Poll interval in ms. Default 250. */
+    pollMs?: number;
+    /** Injectable sleep (for tests). */
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare class StaticRuntimeOrchestrator implements Orchestrator {
+    private readonly url;
+    private readonly healthProbe;
+    private readonly healthTimeoutMs;
+    private readonly pollMs;
+    private readonly sleep;
+    constructor(options: StaticOrchestratorOptions);
+    get baseUrl(): string;
+    ensureRuntime(_opts?: EnsureRuntimeOptions): Promise<RuntimeHandle>;
+    health(): Promise<boolean>;
+    stopRuntime(): Promise<void>;
+}
+//# sourceMappingURL=static-orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-orchestrator.d.ts","sourceRoot":"","sources":["../src/static-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACd,MAAM,mBAAmB,CAAC;AAc3B,MAAM,WAAW,yBAAyB;IACxC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,qBAAa,yBAA0B,YAAW,YAAY;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAE1C,OAAO,EAAE,yBAAyB;IAW9C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAEK,aAAa,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAenE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}

package/dist/static-orchestrator.js

@@ -0,0 +1,50 @@
+async function defaultHealthProbe(baseUrl) {
+    try {
+        const res = await fetch(`${baseUrl}/health`);
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+const sleepDefault = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+export class StaticRuntimeOrchestrator {
+    url;
+    healthProbe;
+    healthTimeoutMs;
+    pollMs;
+    sleep;
+    constructor(options) {
+        if (!options.baseUrl || options.baseUrl.trim() === "") {
+            throw new Error("StaticRuntimeOrchestrator: baseUrl is required");
+        }
+        this.url = options.baseUrl.replace(/\/+$/, "");
+        this.healthProbe = options.healthProbe ?? defaultHealthProbe;
+        this.healthTimeoutMs = options.healthTimeoutMs ?? 30_000;
+        this.pollMs = options.pollMs ?? 250;
+        this.sleep = options.sleep ?? sleepDefault;
+    }
+    get baseUrl() {
+        return this.url;
+    }
+    async ensureRuntime(_opts) {
+        const deadline = Date.now() + this.healthTimeoutMs;
+        for (;;) {
+            if (await this.healthProbe(this.url))
+                return { baseUrl: this.url };
+            if (Date.now() >= deadline) {
+                throw new Error(`static runtime did not become healthy at ${this.url} within ` +
+                    `${this.healthTimeoutMs}ms — is the sandbox container up? ` +
+                    `(check \`docker compose logs sandbox\` and BP_RUNTIME_URL)`);
+            }
+            await this.sleep(this.pollMs);
+        }
+    }
+    async health() {
+        return this.healthProbe(this.url);
+    }
+    async stopRuntime() {
+        // No-op: the sandbox container is owned by docker-compose.
+    }
+}
+//# sourceMappingURL=static-orchestrator.js.map

package/dist/static-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-orchestrator.js","sourceRoot":"","sources":["../src/static-orchestrator.ts"],"names":[],"mappings":"AAiBA,KAAK,UAAU,kBAAkB,CAAC,OAAe;IAC/C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC;QAC7C,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAepD,MAAM,OAAO,yBAAyB;IACnB,GAAG,CAAS;IACZ,WAAW,CAAwC;IACnD,eAAe,CAAS;IACxB,MAAM,CAAS;IACf,KAAK,CAAgC;IAEtD,YAAY,OAAkC;QAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,kBAAkB,CAAC;QAC7D,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,MAAM,CAAC;QACzD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC7C,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAA4B;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC;QACnD,SAAS,CAAC;YACR,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YACnE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,4CAA4C,IAAI,CAAC,GAAG,UAAU;oBAC5D,GAAG,IAAI,CAAC,eAAe,oCAAoC;oBAC3D,4DAA4D,CAC/D,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,2DAA2D;IAC7D,CAAC;CACF"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@brainpilot/backend-core",
+  "version": "0.0.1",
+  "license": "Apache-2.0",
+  "type": "module",
+  "description": "BrainPilot Backend — Hono REST+SSE proxy, serve web, Orchestrator abstraction (Docker/Local)",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeuroAIHub/BrainPilot.git",
+    "directory": "packages/backend-core"
+  },
+  "publishConfig": { "access": "public" },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b",
+    "test": "vitest run",
+    "start": "node ./dist/server.js"
+  },
+  "dependencies": {
+    "@brainpilot/protocol": "^0.0.1",
+    "@brainpilot/runtime": "^0.0.1",
+    "@hono/node-server": "^1.13.0",
+    "hono": "^4.6.0"
+  },
+  "devDependencies": {
+    "@types/dockerode": "^3.3.0"
+  }
+}