@brainpilot/backend-core 0.0.1

package/dist/docker-orchestrator.js

@@ -0,0 +1,159 @@
+const defaultDockerLoader = async () => {
+    const mod = await import("dockerode");
+    return { default: mod.default };
+};
+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));
+/** True when a dockerode error signals the image is not present locally. */
+function isNoSuchImage(err) {
+    const e = err;
+    return e?.statusCode === 404 || /no such image/i.test(e?.message ?? "");
+}
+export class DockerOrchestrator {
+    docker;
+    dockerLoader;
+    image;
+    containerPort;
+    hostPort;
+    host;
+    containerDataDir;
+    healthProbe;
+    healthTimeoutMs;
+    sleep;
+    dataDir;
+    env;
+    container = null;
+    constructor(options = {}) {
+        this.docker = options.docker ?? null;
+        this.dockerLoader = options.dockerLoader ?? defaultDockerLoader;
+        this.image = options.image ?? "brainpilot-sandbox:latest";
+        this.containerPort = options.containerPort ?? 8081;
+        this.hostPort = options.hostPort ?? this.containerPort;
+        this.host = options.host ?? "127.0.0.1";
+        this.containerDataDir = options.containerDataDir ?? "/root/.bp-root";
+        this.dataDir = options.dataDir;
+        this.env = options.env ?? {};
+        this.healthProbe = options.healthProbe ?? defaultHealthProbe;
+        this.healthTimeoutMs = options.healthTimeoutMs ?? 30_000;
+        this.sleep = options.sleep ?? sleepDefault;
+    }
+    /** Resolve a dockerode-like instance, loading dockerode lazily on first use. */
+    async getDocker() {
+        if (this.docker)
+            return this.docker;
+        let loaded;
+        try {
+            loaded = await this.dockerLoader();
+        }
+        catch {
+            throw new Error("Docker/dynamic mode requires 'dockerode'. Install it (npm i dockerode) " +
+                "or use the local/static orchestrator.");
+        }
+        this.docker = new loaded.default();
+        return this.docker;
+    }
+    get baseUrl() {
+        return `http://${this.host}:${this.hostPort}`;
+    }
+    async ensureRuntime(opts) {
+        if (opts?.dataDir)
+            this.dataDir = opts.dataDir;
+        if (opts?.env)
+            this.env = { ...this.env, ...opts.env };
+        if (this.container && (await this.health())) {
+            return { baseUrl: this.baseUrl };
+        }
+        const portKey = `${this.containerPort}/tcp`;
+        const envList = Object.entries({
+            BP_DATA_DIR: this.containerDataDir,
+            PORT: String(this.containerPort),
+            AGENT_RUNTIME_PORT: String(this.containerPort),
+            ...this.env,
+        }).map(([k, v]) => `${k}=${v}`);
+        const createSpec = {
+            Image: this.image,
+            Env: envList,
+            ExposedPorts: { [portKey]: {} },
+            HostConfig: {
+                PortBindings: { [portKey]: [{ HostPort: String(this.hostPort) }] },
+                ...(this.dataDir
+                    ? { Binds: [`${this.dataDir}:${this.containerDataDir}:rw`] }
+                    : {}),
+            },
+        };
+        // `docker run` auto-pulls a missing image; dockerode's createContainer does
+        // NOT — it 404s. Mirror the CLI: on "no such image", pull then retry once.
+        const docker = await this.getDocker();
+        let container;
+        try {
+            container = await docker.createContainer(createSpec);
+        }
+        catch (err) {
+            if (isNoSuchImage(err) && typeof docker.pull === "function") {
+                await this.pullImage(docker);
+                container = await docker.createContainer(createSpec);
+            }
+            else {
+                throw err;
+            }
+        }
+        await container.start();
+        this.container = container;
+        await this.waitForHealth();
+        return { baseUrl: this.baseUrl };
+    }
+    /** Pull `this.image`, resolving once the pull stream finishes. */
+    pullImage(docker) {
+        return new Promise((resolve, reject) => {
+            docker.pull(this.image, (err, stream) => {
+                if (err || !stream)
+                    return reject(err ?? new Error(`failed to pull ${this.image}`));
+                docker.modem.followProgress(stream, (done) => done ? reject(done) : resolve());
+            });
+        });
+    }
+    async health() {
+        if (!this.container)
+            return false;
+        return this.healthProbe(this.baseUrl);
+    }
+    async stopRuntime() {
+        const container = this.container;
+        this.container = null;
+        if (!container)
+            return;
+        try {
+            await container.stop({ t: 5 });
+        }
+        catch {
+            /* already stopped */
+        }
+        try {
+            await container.remove({ force: true });
+        }
+        catch {
+            /* already gone */
+        }
+    }
+    async waitForHealth() {
+        const deadline = Date.now() + this.healthTimeoutMs;
+        for (;;) {
+            if (await this.healthProbe(this.baseUrl))
+                return;
+            if (Date.now() >= deadline) {
+                throw new Error(`docker runtime did not become healthy at ${this.baseUrl} within ` +
+                    `${this.healthTimeoutMs}ms`);
+            }
+            await this.sleep(250);
+        }
+    }
+}
+//# sourceMappingURL=docker-orchestrator.js.map

package/dist/docker-orchestrator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @brainpilot/backend-core — host-side lightweight backend (Hono) that serves
+ * the web SPA and byte-proxies to the Runtime (修正4), plus the Orchestrator
+ * abstraction (Docker / Local). See TS_PI_REFACTOR_DESIGN §10, §11, §11A.
+ */
+export declare const BACKEND_NAME = "@brainpilot/backend-core";
+export { createApp } from "./app.js";
+export type { CreateAppOptions } from "./app.js";
+export { startServer } from "./server.js";
+export type { StartServerOptions, RunningServer } from "./server.js";
+export { createOrchestrator } from "./create-orchestrator.js";
+export type { CreateOrchestratorOptions } from "./create-orchestrator.js";
+export { runtimeArtifactPaths } from "./runtime-paths.js";
+export type { RuntimeArtifactPaths } from "./runtime-paths.js";
+export { resolveOrchestratorMode, } from "./orchestrator.js";
+export type { Orchestrator, OrchestratorMode, RuntimeHandle, EnsureRuntimeOptions, } from "./orchestrator.js";
+export { LocalProcessOrchestrator, resolveRuntimeServerPath, } from "./local-orchestrator.js";
+export type { LocalOrchestratorOptions, SpawnFn, SpawnedProcess, } from "./local-orchestrator.js";
+export { DockerOrchestrator } from "./docker-orchestrator.js";
+export type { DockerOrchestratorOptions } from "./docker-orchestrator.js";
+export { StaticRuntimeOrchestrator } from "./static-orchestrator.js";
+export type { StaticOrchestratorOptions } from "./static-orchestrator.js";
+export { RuntimeClient, buildPath } from "./runtime-client.js";
+export type { RuntimeClientOptions, ForwardOptions } from "./runtime-client.js";
+export { resolveProvider, readLocalSettings, writeLocalSettings, parseDotenv, configPaths, } from "./config.js";
+export type { ResolvedProvider, LocalSettings, ConfigPaths, ResolveProviderOptions, } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EACL,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,wBAAwB,EACxB,OAAO,EACP,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,sBAAsB,GACvB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @brainpilot/backend-core — host-side lightweight backend (Hono) that serves
+ * the web SPA and byte-proxies to the Runtime (修正4), plus the Orchestrator
+ * abstraction (Docker / Local). See TS_PI_REFACTOR_DESIGN §10, §11, §11A.
+ */
+export const BACKEND_NAME = "@brainpilot/backend-core";
+export { createApp } from "./app.js";
+export { startServer } from "./server.js";
+export { createOrchestrator } from "./create-orchestrator.js";
+export { runtimeArtifactPaths } from "./runtime-paths.js";
+export { resolveOrchestratorMode, } from "./orchestrator.js";
+export { LocalProcessOrchestrator, resolveRuntimeServerPath, } from "./local-orchestrator.js";
+export { DockerOrchestrator } from "./docker-orchestrator.js";
+export { StaticRuntimeOrchestrator } from "./static-orchestrator.js";
+export { RuntimeClient, buildPath } from "./runtime-client.js";
+export { resolveProvider, readLocalSettings, writeLocalSettings, parseDotenv, configPaths, } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/local-orchestrator.d.ts

@@ -0,0 +1,74 @@
+import type { EnsureRuntimeOptions, Orchestrator, RuntimeHandle } from "./orchestrator.js";
+/** Minimal shape we need from a spawned process — eases stubbing in tests. */
+export interface SpawnedProcess {
+    readonly pid?: number;
+    on(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): unknown;
+    on(event: "error", listener: (err: Error) => void): unknown;
+    kill(signal?: NodeJS.Signals): boolean;
+}
+export type SpawnFn = (command: string, args: readonly string[], options: {
+    env: NodeJS.ProcessEnv;
+    stdio?: unknown;
+}) => SpawnedProcess;
+export interface LocalOrchestratorOptions {
+    /** BP_DATA_DIR for the runtime (§11A.2). Default `./brainpilot`. */
+    dataDir?: string;
+    /** Runtime port. Default 8081 (backend 9001 + 1, stride-2 §16). */
+    port?: number;
+    host?: string;
+    /** Override `process.execPath` (node binary). */
+    execPath?: string;
+    /** Override the resolved runtime server entry path. */
+    runtimeServerPath?: string;
+    /** Injectable spawn (for tests). Defaults to node:child_process.spawn. */
+    spawnFn?: SpawnFn;
+    /** Max restarts within the sliding window before giving up. Default 5. */
+    maxRestarts?: number;
+    /** Sliding-window length in ms for counting restarts. Default 60_000. */
+    restartWindowMs?: number;
+    /** Base backoff in ms (exponential). Default 200. */
+    backoffBaseMs?: number;
+    /** Injectable health probe (for tests). Defaults to fetch GET /health. */
+    healthProbe?: (baseUrl: string) => Promise<boolean>;
+    /** Health wait timeout in ms when ensuring readiness. Default 30_000. */
+    healthTimeoutMs?: number;
+    /** Called when the restart budget is exhausted (§11A.5 fatal). */
+    onFatal?: (err: Error) => void;
+    /** Sleep impl (for tests). */
+    sleep?: (ms: number) => Promise<void>;
+    /** If set, the runtime child's stdout/stderr are appended to this file
+     *  (replaces stdio:"inherit"). If unset, inherit is kept (zero behavior change). */
+    runtimeLogFile?: string;
+    /** If set, the runtime child's pid is written here; removed on clean exit / stopRuntime. */
+    runtimePidFile?: string;
+}
+/** Resolve `@brainpilot/runtime/server` to an absolute path WITHOUT importing it. */
+export declare function resolveRuntimeServerPath(): string;
+export declare class LocalProcessOrchestrator implements Orchestrator {
+    private readonly opts;
+    private child;
+    private handle;
+    private restartTimestamps;
+    /** Set when stopRuntime() is invoked — suppresses auto-restart. */
+    private stopping;
+    private gaveUp;
+    private lastEnv;
+    constructor(options?: LocalOrchestratorOptions);
+    get baseUrl(): string;
+    /** Build the exact argv used to spawn the runtime. Exposed for testing. */
+    buildArgv(): {
+        command: string;
+        args: string[];
+    };
+    /** Build the env injected into the runtime child. Exposed for testing. */
+    buildEnv(extra?: Record<string, string>): NodeJS.ProcessEnv;
+    ensureRuntime(opts?: EnsureRuntimeOptions): Promise<RuntimeHandle>;
+    health(): Promise<boolean>;
+    stopRuntime(): Promise<void>;
+    private spawnChild;
+    private writePidFile;
+    private removePidFile;
+    private handleExit;
+    private waitForHealth;
+}
+//# sourceMappingURL=local-orchestrator.d.ts.map

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

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

package/dist/local-orchestrator.js

@@ -0,0 +1,225 @@
+/**
+ * LocalProcessOrchestrator — 免 Docker 本地直跑 (§11A.3 / §11A.5).
+ *
+ * Spawns the runtime as a child process:
+ *   spawn(process.execPath, [require.resolve('@brainpilot/runtime/server')],
+ *         { env: { BP_DATA_DIR, PORT, ... } })
+ *
+ * IMPORTANT: we never `import` runtime symbols — the resolved server path is
+ * just a string handed to a child process (per the package brief / 决策 E).
+ *
+ * Crash self-healing (§11A.5 决策 F): on abnormal exit, restart a bounded
+ * number of times within a sliding window with exponential backoff; past the
+ * threshold, give up and mark the runtime dead (caller surfaces a fatal event).
+ */
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { openSync, closeSync, writeFileSync, mkdirSync, rmSync } from "node:fs";
+import { dirname } from "node:path";
+/** Resolve `@brainpilot/runtime/server` to an absolute path WITHOUT importing it. */
+export function resolveRuntimeServerPath() {
+    const require = createRequire(import.meta.url);
+    return require.resolve("@brainpilot/runtime/server");
+}
+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 LocalProcessOrchestrator {
+    opts;
+    child = null;
+    handle = null;
+    restartTimestamps = [];
+    /** Set when stopRuntime() is invoked — suppresses auto-restart. */
+    stopping = false;
+    gaveUp = false;
+    lastEnv = {};
+    constructor(options = {}) {
+        this.opts = {
+            dataDir: options.dataDir ?? process.env.BP_DATA_DIR ?? "./brainpilot",
+            port: options.port ?? Number(process.env.AGENT_RUNTIME_PORT ?? 8081),
+            host: options.host ?? "127.0.0.1",
+            execPath: options.execPath ?? process.execPath,
+            runtimeServerPath: options.runtimeServerPath,
+            spawnFn: options.spawnFn ??
+                ((command, args, o) => spawn(command, args, {
+                    env: o.env,
+                    stdio: o.stdio ?? "inherit",
+                })),
+            maxRestarts: options.maxRestarts ?? 5,
+            restartWindowMs: options.restartWindowMs ?? 60_000,
+            backoffBaseMs: options.backoffBaseMs ?? 200,
+            healthProbe: options.healthProbe ?? defaultHealthProbe,
+            healthTimeoutMs: options.healthTimeoutMs ?? 30_000,
+            onFatal: options.onFatal,
+            sleep: options.sleep ?? sleepDefault,
+            runtimeLogFile: options.runtimeLogFile,
+            runtimePidFile: options.runtimePidFile,
+        };
+    }
+    get baseUrl() {
+        return `http://${this.opts.host}:${this.opts.port}`;
+    }
+    /** Build the exact argv used to spawn the runtime. Exposed for testing. */
+    buildArgv() {
+        const serverPath = this.opts.runtimeServerPath ?? resolveRuntimeServerPath();
+        return { command: this.opts.execPath, args: [serverPath] };
+    }
+    /** Build the env injected into the runtime child. Exposed for testing. */
+    buildEnv(extra) {
+        return {
+            ...process.env,
+            BP_DATA_DIR: this.opts.dataDir,
+            PORT: String(this.opts.port),
+            AGENT_RUNTIME_PORT: String(this.opts.port),
+            BP_MODE: process.env.BP_MODE ?? "single",
+            ...(extra ?? {}),
+        };
+    }
+    async ensureRuntime(opts) {
+        if (opts?.dataDir)
+            this.opts.dataDir = opts.dataDir;
+        if (opts?.port)
+            this.opts.port = opts.port;
+        this.gaveUp = false;
+        this.stopping = false;
+        if (this.child && this.handle && (await this.health())) {
+            return this.handle;
+        }
+        this.lastEnv = this.buildEnv(opts?.env);
+        this.spawnChild(this.lastEnv);
+        await this.waitForHealth();
+        this.handle = { baseUrl: this.baseUrl };
+        return this.handle;
+    }
+    async health() {
+        if (!this.child)
+            return false;
+        return this.opts.healthProbe(this.baseUrl);
+    }
+    async stopRuntime() {
+        this.stopping = true;
+        const child = this.child;
+        this.child = null;
+        this.handle = null;
+        this.removePidFile();
+        if (child) {
+            try {
+                child.kill("SIGTERM");
+            }
+            catch {
+                /* already gone */
+            }
+        }
+    }
+    spawnChild(env) {
+        const { command, args } = this.buildArgv();
+        let logFd;
+        let stdio;
+        if (this.opts.runtimeLogFile) {
+            try {
+                mkdirSync(dirname(this.opts.runtimeLogFile), { recursive: true });
+                logFd = openSync(this.opts.runtimeLogFile, "a");
+                stdio = ["ignore", logFd, logFd];
+            }
+            catch (err) {
+                // Never fail runtime startup over logging — fall back to inherit.
+                // eslint-disable-next-line no-console
+                console.warn(`[orchestrator] cannot open runtime log ${this.opts.runtimeLogFile}: ` +
+                    `${err.message}; falling back to inherit`);
+                logFd = undefined;
+                stdio = undefined;
+            }
+        }
+        const child = this.opts.spawnFn(command, args, stdio ? { env, stdio } : { env });
+        this.child = child;
+        this.writePidFile(child.pid);
+        child.on("error", (err) => this.handleExit(err instanceof Error ? err : new Error(String(err))));
+        child.on("exit", (code, signal) => {
+            if (logFd !== undefined) {
+                try {
+                    closeSync(logFd);
+                }
+                catch {
+                    /* already closed */
+                }
+            }
+            if (this.stopping)
+                return;
+            // Clean exit (code 0, not killed) is treated as intentional shutdown.
+            if (code === 0 && signal === null) {
+                this.child = null;
+                this.handle = null;
+                this.removePidFile();
+                return;
+            }
+            const err = new Error(`runtime exited (code=${String(code)} signal=${String(signal)})`);
+            void this.handleExit(err);
+        });
+    }
+    writePidFile(pid) {
+        if (!this.opts.runtimePidFile || pid === undefined)
+            return;
+        try {
+            mkdirSync(dirname(this.opts.runtimePidFile), { recursive: true });
+            writeFileSync(this.opts.runtimePidFile, String(pid));
+        }
+        catch (err) {
+            // eslint-disable-next-line no-console
+            console.warn(`[orchestrator] cannot write runtime pid file ${this.opts.runtimePidFile}: ` +
+                `${err.message}`);
+        }
+    }
+    removePidFile() {
+        if (!this.opts.runtimePidFile)
+            return;
+        try {
+            rmSync(this.opts.runtimePidFile, { force: true });
+        }
+        catch {
+            /* nothing to remove */
+        }
+    }
+    async handleExit(err) {
+        if (this.stopping || this.gaveUp)
+            return;
+        const now = Date.now();
+        this.restartTimestamps = this.restartTimestamps.filter((ts) => now - ts < this.opts.restartWindowMs);
+        if (this.restartTimestamps.length >= this.opts.maxRestarts) {
+            this.gaveUp = true;
+            this.child = null;
+            this.handle = null;
+            const fatal = new Error(`runtime crashed ${this.restartTimestamps.length + 1} times within ` +
+                `${this.opts.restartWindowMs}ms; giving up. Last error: ${err.message}`);
+            this.opts.onFatal?.(fatal);
+            return;
+        }
+        const attempt = this.restartTimestamps.length;
+        this.restartTimestamps.push(now);
+        const backoff = this.opts.backoffBaseMs * Math.pow(2, attempt);
+        await this.opts.sleep(backoff);
+        if (this.stopping || this.gaveUp)
+            return;
+        this.spawnChild(this.lastEnv);
+    }
+    async waitForHealth() {
+        const deadline = Date.now() + this.opts.healthTimeoutMs;
+        // Poll until healthy or timeout. Spacing is small for local startup.
+        for (;;) {
+            if (await this.opts.healthProbe(this.baseUrl))
+                return;
+            if (Date.now() >= deadline) {
+                throw new Error(`runtime did not become healthy at ${this.baseUrl} within ` +
+                    `${this.opts.healthTimeoutMs}ms`);
+            }
+            await this.opts.sleep(200);
+        }
+    }
+}
+//# sourceMappingURL=local-orchestrator.js.map

package/dist/local-orchestrator.js.map

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

package/dist/orchestrator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Orchestrator abstraction — "how to start the Runtime" (TS_PI_REFACTOR_DESIGN
+ * §11A.3). The backend never speaks runtime symbols; it only needs a handle to
+ * a running runtime reachable over localhost HTTP/SSE (§10, 修正4).
+ *
+ * Three implementations:
+ *   - DockerOrchestrator        — `docker run` the brainpilot-sandbox image
+ *   - StaticRuntimeOrchestrator — health-probe a pre-started sandbox (basic Docker compose)
+ *   - LocalProcessOrchestrator  — child_process.spawn the runtime entrypoint
+ *
+ * All expose the same surface so the Hono app and the runtime client are
+ * agnostic to deployment mode.
+ */
+/** A live runtime endpoint the backend can proxy to. */
+export interface RuntimeHandle {
+    /** Base URL of the runtime, e.g. `http://127.0.0.1:8081`. No trailing slash. */
+    readonly baseUrl: string;
+}
+export interface EnsureRuntimeOptions {
+    /** Host data dir injected as BP_DATA_DIR (§11A.2). */
+    readonly dataDir?: string;
+    /** Force a specific runtime port; otherwise the orchestrator picks one. */
+    readonly port?: number;
+    /** Extra env vars forwarded to the runtime process/container. */
+    readonly env?: Record<string, string>;
+}
+export interface Orchestrator {
+    /**
+     * Start a runtime (idempotent — repeated calls return the same handle while
+     * the runtime is healthy) and resolve once it is reachable.
+     */
+    ensureRuntime(opts?: EnsureRuntimeOptions): Promise<RuntimeHandle>;
+    /** Probe the runtime `GET /health` (§15.4). Returns false if not started. */
+    health(): Promise<boolean>;
+    /** Gracefully stop the runtime. Safe to call when not started. */
+    stopRuntime(): Promise<void>;
+}
+export type OrchestratorMode = "local" | "static" | "docker";
+/**
+ * Decide which orchestrator to use. Explicit `BP_ORCHESTRATOR` / `BP_MODE`
+ * wins; otherwise default to `local` (the免 Docker path, §11A) — Docker is
+ * opt-in because it requires a daemon.
+ *
+ * Precedence (highest → lowest):
+ *   1. `BP_ORCHESTRATOR` explicit override
+ *   2. `BP_RUNTIME_URL` set → `static` (connect a fixed pre-started runtime, static sandbox)
+ *   3. `BP_MODE=docker` legacy switch
+ *   4. `local` (default)
+ */
+export declare function resolveOrchestratorMode(env?: Record<string, string | undefined>): OrchestratorMode;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wDAAwD;AACxD,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,6EAA6E;IAC7E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,kEAAkE;IAClE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,gBAAgB,CAWlB"}

package/dist/orchestrator.js

@@ -0,0 +1,39 @@
+/**
+ * Orchestrator abstraction — "how to start the Runtime" (TS_PI_REFACTOR_DESIGN
+ * §11A.3). The backend never speaks runtime symbols; it only needs a handle to
+ * a running runtime reachable over localhost HTTP/SSE (§10, 修正4).
+ *
+ * Three implementations:
+ *   - DockerOrchestrator        — `docker run` the brainpilot-sandbox image
+ *   - StaticRuntimeOrchestrator — health-probe a pre-started sandbox (basic Docker compose)
+ *   - LocalProcessOrchestrator  — child_process.spawn the runtime entrypoint
+ *
+ * All expose the same surface so the Hono app and the runtime client are
+ * agnostic to deployment mode.
+ */
+/**
+ * Decide which orchestrator to use. Explicit `BP_ORCHESTRATOR` / `BP_MODE`
+ * wins; otherwise default to `local` (the免 Docker path, §11A) — Docker is
+ * opt-in because it requires a daemon.
+ *
+ * Precedence (highest → lowest):
+ *   1. `BP_ORCHESTRATOR` explicit override
+ *   2. `BP_RUNTIME_URL` set → `static` (connect a fixed pre-started runtime, static sandbox)
+ *   3. `BP_MODE=docker` legacy switch
+ *   4. `local` (default)
+ */
+export function resolveOrchestratorMode(env = process.env) {
+    // Explicit override always wins.
+    const explicit = (env.BP_ORCHESTRATOR ?? "").toLowerCase();
+    if (explicit === "docker" || explicit === "local" || explicit === "static") {
+        return explicit;
+    }
+    // A pre-provisioned runtime URL (static sandbox compose) selects `static`.
+    if ((env.BP_RUNTIME_URL ?? "").trim() !== "")
+        return "static";
+    // Dynamic per-user docker switch (downstream multi-user repo).
+    if ((env.BP_MODE ?? "").toLowerCase() === "docker")
+        return "docker";
+    return "local";
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAA0C,OAAO,CAAC,GAAG;IAErD,iCAAiC;IACjC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,QAA4B,CAAC;IACtC,CAAC;IACD,2EAA2E;IAC3E,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC9D,+DAA+D;IAC/D,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACpE,OAAO,OAAO,CAAC;AACjB,CAAC"}