@geminixiang/mikan 1.0.0-beta.2 → 1.0.0-beta.20

package/dist/sandbox/gondolin.js

@@ -0,0 +1,425 @@
+import { createHash } from "node:crypto";
+import { readFileSync, statSync } from "node:fs";
+import * as log from "../log.js";
+import { SandboxError } from "./errors.js";
+import { gondolinInventory } from "./gondolin-inventory.js";
+import { GondolinRuntimeGoneError, GondolinRuntimeInterruptedError, gondolinWorkers, } from "./gondolin-worker-client.js";
+import { gondolinFleet } from "./gondolin-fleet.js";
+import { gondolinGateway } from "./gondolin-gateway.js";
+import { createMountedRuntimePathContext } from "./path-context.js";
+import { withRuntimeBootstrap } from "./container.js";
+import { execReadFile, execWriteFile } from "./utils.js";
+const MINIMUM_NODE_VERSION = [23, 6, 0];
+const MIKAN_IMAGE = "mikan-sandbox:latest";
+const sessions = new Map();
+const transitions = new Map();
+let activeShutdowns = 0;
+let shutdownGeneration = 0;
+class GondolinResourceManager {
+    constructor() {
+        this.boostedKeys = new Set();
+        this.overrideLimits = new Map();
+    }
+    configure(defaultLimits, boostLimits) {
+        this.defaultLimits = defaultLimits;
+        this.boostLimits = boostLimits;
+        this.boostedKeys.clear();
+        this.overrideLimits.clear();
+    }
+    async boost(key) {
+        if (this.boostLimits?.cpus || this.boostLimits?.memory) {
+            this.overrideLimits.delete(key);
+            this.boostedKeys.add(key);
+        }
+        return this.getLimitStatus(key);
+    }
+    async setLimits(key, limits) {
+        this.boostedKeys.delete(key);
+        this.overrideLimits.set(key, { ...this.defaultLimits, ...limits });
+        return this.getLimitStatus(key);
+    }
+    getLimitStatus(key) {
+        return { limits: this.effectiveLimits(key), boosted: this.boostedKeys.has(key) };
+    }
+    getDefaultLimits() {
+        return this.defaultLimits;
+    }
+    getBoostLimits() {
+        return this.boostLimits;
+    }
+    clear(key) {
+        this.boostedKeys.delete(key);
+        this.overrideLimits.delete(key);
+    }
+    effectiveLimits(key) {
+        const override = this.overrideLimits.get(key);
+        if (override)
+            return override;
+        if (!this.boostedKeys.has(key))
+            return this.defaultLimits;
+        return { ...this.defaultLimits, ...this.boostLimits };
+    }
+}
+export const gondolinResources = new GondolinResourceManager();
+function parseGondolinSandboxArg(value) {
+    if (!value.startsWith("gondolin:"))
+        return undefined;
+    const profile = value.slice("gondolin:".length);
+    if (!profile) {
+        throw new SandboxError("Error: gondolin sandbox requires a profile (e.g., gondolin:default)");
+    }
+    if (profile !== "default" && profile !== "remote") {
+        throw new SandboxError(`Error: unsupported gondolin profile '${profile}'. Use 'gondolin:default' or 'gondolin:remote'`);
+    }
+    return { type: "gondolin", profile };
+}
+function assertSupportedNodeVersion() {
+    const [major = 0, minor = 0] = process.versions.node.split(".").map(Number);
+    if (major < MINIMUM_NODE_VERSION[0] || (major === MINIMUM_NODE_VERSION[0] && minor < 6)) {
+        throw new SandboxError(`Error: gondolin:default requires Node.js >=23.6.0 (current: ${process.versions.node}). Other sandbox modes remain available on Node.js >=22.19.0.`);
+    }
+}
+async function validateGondolinSandbox(config) {
+    if (config?.profile === "remote") {
+        // The remote transports are configured from settings later in startup, so
+        // "is a worker source configured?" is checked there (assertRemoteConfigured),
+        // not here where nothing has been wired yet.
+        console.log("  Gondolin microVM enabled. Profile: remote");
+        return;
+    }
+    assertSupportedNodeVersion();
+    console.log("  Gondolin microVM enabled. Profile: default");
+}
+/**
+ * Fail fast when `gondolin:remote` is selected but no worker source is
+ * configured. Call after the fleet and gateway have been configured.
+ */
+export function assertRemoteConfigured() {
+    if (!gondolinFleet.isConfigured() && !gondolinGateway.isConfigured()) {
+        throw new SandboxError("Error: gondolin:remote requires sandbox.gondolin.remote settings (workers[]/url, or gateway for dial-home workers)");
+    }
+    // Without a workspaceRoot, mount sources cannot be translated to the worker's
+    // filesystem and every runtime is rejected with "escapes the workspace root".
+    const missing = gondolinFleet.workersMissingWorkspaceRoot();
+    if (missing.length > 0) {
+        throw new SandboxError(`Error: gondolin:remote worker(s) [${missing.join(", ")}] have no workspaceRoot; ` +
+            `set sandbox.gondolin.remote.workspaceRoot (or gateway.workspaceRoot) to the worker-side shared workspace path`);
+    }
+}
+function transportFor(config) {
+    return config.profile === "remote" ? gondolinFleet : gondolinWorkers;
+}
+async function resolveDesiredRuntime(config) {
+    let image;
+    let imageIdentity;
+    if (config.profile === "remote") {
+        // image assets live on the worker host; the selector is the identity
+        image = gondolinFleet.imageSelector() ?? config.image ?? MIKAN_IMAGE;
+        imageIdentity = image;
+    }
+    else {
+        const selector = config.image ?? MIKAN_IMAGE;
+        const { ensureImageSelector } = (await import("@earendil-works/gondolin"));
+        const resolvedImage = await ensureImageSelector(selector);
+        image = resolvedImage.assetDir;
+        imageIdentity = resolvedImage.buildId ?? resolvedImage.assetDir;
+    }
+    const mounts = (config.mounts ?? [{ source: config.workspacePath ?? process.cwd(), target: "/workspace" }]).toSorted((left, right) => left.target.localeCompare(right.target));
+    return {
+        image,
+        imageIdentity,
+        mounts,
+        credentialIdentity: credentialIdentity(mounts),
+        limits: config.resourceKey
+            ? gondolinResources.getLimitStatus(config.resourceKey).limits
+            : undefined,
+    };
+}
+/**
+ * Content hashes of credential file mounts (files projected outside
+ * /workspace). Rotating a credential on the host changes the fingerprint, so
+ * the next command recreates the runtime with a fresh projection instead of
+ * serving the stale copy for the rest of the VM's life. Workspace files are
+ * excluded: the guest writes them back, which would drift the runtime it runs
+ * in.
+ */
+function credentialIdentity(mounts) {
+    const identity = {};
+    for (const mount of mounts) {
+        if (mount.target.startsWith("/workspace/") || mount.target === "/workspace")
+            continue;
+        try {
+            if (!statSync(mount.source).isFile())
+                continue;
+            identity[mount.target] = createHash("sha256")
+                .update(readFileSync(mount.source))
+                .digest("hex");
+        }
+        catch {
+            // missing source: the worker skips it too, so it has no runtime identity
+        }
+    }
+    return identity;
+}
+function runtimeFingerprint(desired) {
+    return createHash("sha256")
+        .update(JSON.stringify({
+        image: desired.imageIdentity,
+        mounts: desired.mounts,
+        credentials: desired.credentialIdentity,
+        limits: desired.limits,
+    }))
+        .digest("hex");
+}
+function gondolinCpuCount(cpus) {
+    if (cpus === undefined)
+        return undefined;
+    const parsed = Number(cpus);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new SandboxError(`Error: invalid Gondolin CPU limit '${cpus}'`);
+    }
+    // ponytail: Gondolin exposes whole vCPUs; add host cgroup quotas if fractional enforcement matters.
+    return Math.ceil(parsed);
+}
+function createSession(key, config, desired, fingerprint) {
+    const transport = transportFor(config);
+    let session;
+    const runtime = transport
+        .ensure(key, {
+        image: desired.image,
+        mounts: desired.mounts,
+        cpus: desired.limits?.cpus,
+        vmCpus: gondolinCpuCount(desired.limits?.cpus),
+        memory: desired.limits?.memory,
+        fingerprint,
+        workspacePath: config.workspacePath,
+    })
+        .catch((error) => {
+        if (sessions.get(key) === session)
+            sessions.delete(key);
+        throw error;
+    });
+    session = {
+        runtime,
+        transport,
+        fingerprint,
+        resourceKey: config.resourceKey,
+        activeOperations: 0,
+        lastUsed: Date.now(),
+        idleWaiters: [],
+    };
+    return session;
+}
+async function acquireSession(key, config, generation = shutdownGeneration) {
+    if (activeShutdowns > 0 || generation !== shutdownGeneration) {
+        throw new SandboxError("Error: Gondolin runtime is shutting down");
+    }
+    const pending = transitions.get(key);
+    if (pending) {
+        await pending;
+        return acquireSession(key, config, generation);
+    }
+    const desired = await resolveDesiredRuntime(config);
+    if (activeShutdowns > 0 || generation !== shutdownGeneration) {
+        throw new SandboxError("Error: Gondolin runtime is shutting down");
+    }
+    const concurrentTransition = transitions.get(key);
+    if (concurrentTransition) {
+        await concurrentTransition;
+        return acquireSession(key, config, generation);
+    }
+    const fingerprint = runtimeFingerprint(desired);
+    const existing = sessions.get(key);
+    if (existing?.fingerprint === fingerprint) {
+        existing.activeOperations += 1;
+        return existing;
+    }
+    const transition = replaceSession(key, config, desired, fingerprint, existing);
+    transitions.set(key, transition);
+    try {
+        await transition;
+    }
+    finally {
+        if (transitions.get(key) === transition)
+            transitions.delete(key);
+    }
+    return acquireSession(key, config, generation);
+}
+async function replaceSession(key, config, desired, fingerprint, existing) {
+    if (existing) {
+        await closeSession(key, existing, {
+            waitForActiveOperations: true,
+            resetResources: false,
+            throwOnError: true,
+        });
+    }
+    const replacement = createSession(key, config, desired, fingerprint);
+    sessions.set(key, replacement);
+    await replacement.runtime;
+}
+function discardDeadSession(key, session) {
+    if (sessions.get(key) !== session)
+        return;
+    sessions.delete(key);
+    log.logWarning(`Gondolin runtime for '${key}' died; the session will be recreated`);
+}
+async function withRuntime(key, config, operation) {
+    for (let attempt = 0;; attempt += 1) {
+        const session = await acquireSession(key, config);
+        let handle;
+        try {
+            handle = await session.runtime;
+            return await operation(handle);
+        }
+        catch (error) {
+            const gone = error instanceof GondolinRuntimeGoneError;
+            const interrupted = error instanceof GondolinRuntimeInterruptedError;
+            if (gone || (interrupted && handle && !(await session.transport.isRuntimeAlive(handle)))) {
+                discardDeadSession(key, session);
+            }
+            // Nothing reached a gone runtime, so recreating and retrying is safe;
+            // an interrupted command may have side effects and must surface.
+            if (gone && attempt === 0)
+                continue;
+            if (gone || interrupted) {
+                throw new SandboxError(`Error: Gondolin runtime for '${key}' died (${error.message}); it is recreated on the next command`);
+            }
+            throw error;
+        }
+        finally {
+            session.activeOperations -= 1;
+            session.lastUsed = Date.now();
+            if (session.activeOperations === 0) {
+                for (const resolve of session.idleWaiters.splice(0))
+                    resolve();
+            }
+        }
+    }
+}
+function waitForIdle(session) {
+    if (session.activeOperations === 0)
+        return Promise.resolve();
+    return new Promise((resolve) => session.idleWaiters.push(resolve));
+}
+async function closeSession(key, session, options = {}) {
+    if (sessions.get(key) !== session)
+        return;
+    sessions.delete(key);
+    try {
+        if (options.waitForActiveOperations)
+            await waitForIdle(session);
+        const handle = await session.runtime;
+        if (options.stopRuntime !== false)
+            await session.transport.stop(handle);
+        if (options.resetResources !== false &&
+            session.resourceKey &&
+            !Array.from(sessions.values()).some(({ resourceKey }) => resourceKey === session.resourceKey)) {
+            gondolinResources.clear(session.resourceKey);
+        }
+    }
+    catch (error) {
+        session.fingerprint = "";
+        // Re-track for a retried close, unless a replacement already claimed the
+        // key — then the failed runtime stays for the reconcile paths and
+        // clobbering the replacement would leak it too.
+        if (!sessions.has(key))
+            sessions.set(key, session);
+        if (options.throwOnError)
+            throw error;
+        log.logWarning(`Failed to close Gondolin session '${key}'`, error instanceof Error ? error.message : String(error));
+    }
+}
+export async function stopIdleGondolinVms(maxIdleMs, now = Date.now()) {
+    const idle = Array.from(sessions.entries()).filter(([key, session]) => !transitions.has(key) &&
+        session.activeOperations === 0 &&
+        now - session.lastUsed >= maxIdleMs);
+    await Promise.all(idle.map(([key, session]) => {
+        // Register the close as a transition so a concurrent acquire waits for
+        // it instead of racing the shared session slot.
+        const transition = closeSession(key, session).finally(() => {
+            if (transitions.get(key) === transition)
+                transitions.delete(key);
+        });
+        transitions.set(key, transition);
+        return transition;
+    }));
+}
+/**
+ * Stop workers surviving from a previous mikan that no conversation has
+ * adopted — without this, a runtime whose conversation went quiet before the
+ * restart would idle forever (its worker only self-stops when every mikan is
+ * gone, and the in-memory idle sweep only tracks acquired sessions).
+ */
+export async function sweepUnadoptedGondolinWorkers() {
+    for (const record of gondolinInventory.listWorkerRecords()) {
+        if (sessions.has(record.instanceId) || transitions.has(record.instanceId))
+            continue;
+        log.logInfo(`Stopping unadopted Gondolin worker ${record.ownerPid} (instance '${record.instanceId}')`);
+        await gondolinWorkers.stop({ workerPid: record.ownerPid, sessionId: record.sessionId });
+    }
+}
+/**
+ * Forget every session without stopping the workers: runtimes deliberately
+ * outlive the mikan process so the next one adopts them instead of paying a
+ * VM boot per conversation on every deploy.
+ */
+export async function disconnectAllGondolinRuntimes() {
+    shutdownGeneration += 1;
+    activeShutdowns += 1;
+    try {
+        await Promise.allSettled(transitions.values());
+        const current = Array.from(sessions.entries());
+        await Promise.all(current.map(([key, session]) => closeSession(key, session, { waitForActiveOperations: true, stopRuntime: false })));
+    }
+    finally {
+        activeShutdowns -= 1;
+    }
+}
+function executionSignal(options) {
+    const signals = [options?.signal];
+    if (options?.timeout && options.timeout > 0) {
+        signals.push(AbortSignal.timeout(options.timeout * 1000));
+    }
+    const active = signals.filter((signal) => signal !== undefined);
+    return active.length > 0 ? AbortSignal.any(active) : undefined;
+}
+export class GondolinExecutor {
+    constructor(config, env) {
+        this.config = config;
+        this.env = env;
+        // remote runtimes never load gondolin in this process, so the mikan host
+        // may stay on the supported Node floor
+        if (config.profile !== "remote")
+            assertSupportedNodeVersion();
+        this.workspacePath = config.workspacePath ?? process.cwd();
+        this.instanceId = config.instanceId ?? this.workspacePath;
+    }
+    async exec(command, options) {
+        return withRuntime(this.instanceId, this.config, (handle) => transportFor(this.config).exec(handle, withRuntimeBootstrap(command, this.env), {
+            env: this.env,
+            signal: executionSignal(options),
+        }));
+    }
+    async readFile(path) {
+        return execReadFile(this, path);
+    }
+    async writeFile(path, content) {
+        return execWriteFile(this, path, content);
+    }
+    getWorkspacePath() {
+        return "/workspace";
+    }
+    getPathContext(hostWorkspaceRoot) {
+        return createMountedRuntimePathContext(hostWorkspaceRoot, "/workspace");
+    }
+    getSandboxConfig() {
+        return this.config;
+    }
+}
+export const gondolinSandboxAdapter = {
+    type: "gondolin",
+    parse: parseGondolinSandboxArg,
+    validate: validateGondolinSandbox,
+    createExecutor: (config, env) => new GondolinExecutor(config, env),
+};
+//# sourceMappingURL=gondolin.js.map

package/dist/sandbox/gondolin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gondolin.js","sourceRoot":"","sources":["../../src/sandbox/gondolin.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { readFileSync, statSync } from \"node:fs\";\nimport * as log from \"../log.js\";\nimport type { ResourceLimits, SandboxLimitStatus, SandboxResourceController } from \"../types.js\";\nimport { SandboxError } from \"./errors.js\";\nimport { gondolinInventory } from \"./gondolin-inventory.js\";\nimport {\n  GondolinRuntimeGoneError,\n  GondolinRuntimeInterruptedError,\n  gondolinWorkers,\n  type GondolinRuntimeHandle,\n  type GondolinRuntimeTransport,\n} from \"./gondolin-worker-client.js\";\nimport { gondolinFleet } from \"./gondolin-fleet.js\";\nimport { gondolinGateway } from \"./gondolin-gateway.js\";\nimport { createMountedRuntimePathContext } from \"./path-context.js\";\nimport { withRuntimeBootstrap } from \"./container.js\";\nimport { execReadFile, execWriteFile } from \"./utils.js\";\nimport type {\n  ExecOptions,\n  ExecResult,\n  Executor,\n  GondolinSandboxConfig,\n  RuntimePathContext,\n  SandboxAdapter,\n} from \"./types.js\";\n\ntype GondolinModule = typeof import(\"@earendil-works/gondolin\");\n\ninterface GondolinSession {\n  runtime: Promise<GondolinRuntimeHandle>;\n  transport: GondolinRuntimeTransport;\n  fingerprint: string;\n  resourceKey?: string;\n  activeOperations: number;\n  lastUsed: number;\n  idleWaiters: Array<() => void>;\n}\n\ninterface GondolinDesiredRuntime {\n  image: string;\n  imageIdentity: string;\n  mounts: Array<{ source: string; target: string }>;\n  /** Content identity of projected credential files (rotation → drift). */\n  credentialIdentity: Record<string, string>;\n  limits?: ResourceLimits;\n}\n\nconst MINIMUM_NODE_VERSION = [23, 6, 0] as const;\nconst MIKAN_IMAGE = \"mikan-sandbox:latest\";\nconst sessions = new Map<string, GondolinSession>();\nconst transitions = new Map<string, Promise<void>>();\nlet activeShutdowns = 0;\nlet shutdownGeneration = 0;\n\nclass GondolinResourceManager implements SandboxResourceController {\n  private defaultLimits?: ResourceLimits;\n  private boostLimits?: ResourceLimits;\n  private readonly boostedKeys = new Set<string>();\n  private readonly overrideLimits = new Map<string, ResourceLimits>();\n\n  configure(defaultLimits?: ResourceLimits, boostLimits?: ResourceLimits): void {\n    this.defaultLimits = defaultLimits;\n    this.boostLimits = boostLimits;\n    this.boostedKeys.clear();\n    this.overrideLimits.clear();\n  }\n\n  async boost(key: string): Promise<SandboxLimitStatus> {\n    if (this.boostLimits?.cpus || this.boostLimits?.memory) {\n      this.overrideLimits.delete(key);\n      this.boostedKeys.add(key);\n    }\n    return this.getLimitStatus(key);\n  }\n\n  async setLimits(key: string, limits: ResourceLimits): Promise<SandboxLimitStatus> {\n    this.boostedKeys.delete(key);\n    this.overrideLimits.set(key, { ...this.defaultLimits, ...limits });\n    return this.getLimitStatus(key);\n  }\n\n  getLimitStatus(key: string): SandboxLimitStatus {\n    return { limits: this.effectiveLimits(key), boosted: this.boostedKeys.has(key) };\n  }\n\n  getDefaultLimits(): ResourceLimits | undefined {\n    return this.defaultLimits;\n  }\n\n  getBoostLimits(): ResourceLimits | undefined {\n    return this.boostLimits;\n  }\n\n  clear(key: string): void {\n    this.boostedKeys.delete(key);\n    this.overrideLimits.delete(key);\n  }\n\n  private effectiveLimits(key: string): ResourceLimits | undefined {\n    const override = this.overrideLimits.get(key);\n    if (override) return override;\n    if (!this.boostedKeys.has(key)) return this.defaultLimits;\n    return { ...this.defaultLimits, ...this.boostLimits };\n  }\n}\n\nexport const gondolinResources = new GondolinResourceManager();\n\nfunction parseGondolinSandboxArg(value: string): GondolinSandboxConfig | undefined {\n  if (!value.startsWith(\"gondolin:\")) return undefined;\n\n  const profile = value.slice(\"gondolin:\".length);\n  if (!profile) {\n    throw new SandboxError(\"Error: gondolin sandbox requires a profile (e.g., gondolin:default)\");\n  }\n  if (profile !== \"default\" && profile !== \"remote\") {\n    throw new SandboxError(\n      `Error: unsupported gondolin profile '${profile}'. Use 'gondolin:default' or 'gondolin:remote'`,\n    );\n  }\n  return { type: \"gondolin\", profile };\n}\n\nfunction assertSupportedNodeVersion(): void {\n  const [major = 0, minor = 0] = process.versions.node.split(\".\").map(Number);\n  if (major < MINIMUM_NODE_VERSION[0] || (major === MINIMUM_NODE_VERSION[0] && minor < 6)) {\n    throw new SandboxError(\n      `Error: gondolin:default requires Node.js >=23.6.0 (current: ${process.versions.node}). Other sandbox modes remain available on Node.js >=22.19.0.`,\n    );\n  }\n}\n\nasync function validateGondolinSandbox(config?: GondolinSandboxConfig): Promise<void> {\n  if (config?.profile === \"remote\") {\n    // The remote transports are configured from settings later in startup, so\n    // \"is a worker source configured?\" is checked there (assertRemoteConfigured),\n    // not here where nothing has been wired yet.\n    console.log(\"  Gondolin microVM enabled. Profile: remote\");\n    return;\n  }\n  assertSupportedNodeVersion();\n  console.log(\"  Gondolin microVM enabled. Profile: default\");\n}\n\n/**\n * Fail fast when `gondolin:remote` is selected but no worker source is\n * configured. Call after the fleet and gateway have been configured.\n */\nexport function assertRemoteConfigured(): void {\n  if (!gondolinFleet.isConfigured() && !gondolinGateway.isConfigured()) {\n    throw new SandboxError(\n      \"Error: gondolin:remote requires sandbox.gondolin.remote settings (workers[]/url, or gateway for dial-home workers)\",\n    );\n  }\n  // Without a workspaceRoot, mount sources cannot be translated to the worker's\n  // filesystem and every runtime is rejected with \"escapes the workspace root\".\n  const missing = gondolinFleet.workersMissingWorkspaceRoot();\n  if (missing.length > 0) {\n    throw new SandboxError(\n      `Error: gondolin:remote worker(s) [${missing.join(\", \")}] have no workspaceRoot; ` +\n        `set sandbox.gondolin.remote.workspaceRoot (or gateway.workspaceRoot) to the worker-side shared workspace path`,\n    );\n  }\n}\n\nfunction transportFor(config: GondolinSandboxConfig): GondolinRuntimeTransport {\n  return config.profile === \"remote\" ? gondolinFleet : gondolinWorkers;\n}\n\nasync function resolveDesiredRuntime(\n  config: GondolinSandboxConfig,\n): Promise<GondolinDesiredRuntime> {\n  let image: string;\n  let imageIdentity: string;\n  if (config.profile === \"remote\") {\n    // image assets live on the worker host; the selector is the identity\n    image = gondolinFleet.imageSelector() ?? config.image ?? MIKAN_IMAGE;\n    imageIdentity = image;\n  } else {\n    const selector = config.image ?? MIKAN_IMAGE;\n    const { ensureImageSelector } = (await import(\"@earendil-works/gondolin\")) as GondolinModule;\n    const resolvedImage = await ensureImageSelector(selector);\n    image = resolvedImage.assetDir;\n    imageIdentity = resolvedImage.buildId ?? resolvedImage.assetDir;\n  }\n  const mounts = (\n    config.mounts ?? [{ source: config.workspacePath ?? process.cwd(), target: \"/workspace\" }]\n  ).toSorted((left, right) => left.target.localeCompare(right.target));\n  return {\n    image,\n    imageIdentity,\n    mounts,\n    credentialIdentity: credentialIdentity(mounts),\n    limits: config.resourceKey\n      ? gondolinResources.getLimitStatus(config.resourceKey).limits\n      : undefined,\n  };\n}\n\n/**\n * Content hashes of credential file mounts (files projected outside\n * /workspace). Rotating a credential on the host changes the fingerprint, so\n * the next command recreates the runtime with a fresh projection instead of\n * serving the stale copy for the rest of the VM's life. Workspace files are\n * excluded: the guest writes them back, which would drift the runtime it runs\n * in.\n */\nfunction credentialIdentity(\n  mounts: Array<{ source: string; target: string }>,\n): Record<string, string> {\n  const identity: Record<string, string> = {};\n  for (const mount of mounts) {\n    if (mount.target.startsWith(\"/workspace/\") || mount.target === \"/workspace\") continue;\n    try {\n      if (!statSync(mount.source).isFile()) continue;\n      identity[mount.target] = createHash(\"sha256\")\n        .update(readFileSync(mount.source))\n        .digest(\"hex\");\n    } catch {\n      // missing source: the worker skips it too, so it has no runtime identity\n    }\n  }\n  return identity;\n}\n\nfunction runtimeFingerprint(desired: GondolinDesiredRuntime): string {\n  return createHash(\"sha256\")\n    .update(\n      JSON.stringify({\n        image: desired.imageIdentity,\n        mounts: desired.mounts,\n        credentials: desired.credentialIdentity,\n        limits: desired.limits,\n      }),\n    )\n    .digest(\"hex\");\n}\n\nfunction gondolinCpuCount(cpus: string | undefined): number | undefined {\n  if (cpus === undefined) return undefined;\n  const parsed = Number(cpus);\n  if (!Number.isFinite(parsed) || parsed <= 0) {\n    throw new SandboxError(`Error: invalid Gondolin CPU limit '${cpus}'`);\n  }\n  // ponytail: Gondolin exposes whole vCPUs; add host cgroup quotas if fractional enforcement matters.\n  return Math.ceil(parsed);\n}\n\nfunction createSession(\n  key: string,\n  config: GondolinSandboxConfig,\n  desired: GondolinDesiredRuntime,\n  fingerprint: string,\n): GondolinSession {\n  const transport = transportFor(config);\n  let session: GondolinSession;\n  const runtime = transport\n    .ensure(key, {\n      image: desired.image,\n      mounts: desired.mounts,\n      cpus: desired.limits?.cpus,\n      vmCpus: gondolinCpuCount(desired.limits?.cpus),\n      memory: desired.limits?.memory,\n      fingerprint,\n      workspacePath: config.workspacePath,\n    })\n    .catch((error) => {\n      if (sessions.get(key) === session) sessions.delete(key);\n      throw error;\n    });\n  session = {\n    runtime,\n    transport,\n    fingerprint,\n    resourceKey: config.resourceKey,\n    activeOperations: 0,\n    lastUsed: Date.now(),\n    idleWaiters: [],\n  };\n  return session;\n}\n\nasync function acquireSession(\n  key: string,\n  config: GondolinSandboxConfig,\n  generation = shutdownGeneration,\n): Promise<GondolinSession> {\n  if (activeShutdowns > 0 || generation !== shutdownGeneration) {\n    throw new SandboxError(\"Error: Gondolin runtime is shutting down\");\n  }\n\n  const pending = transitions.get(key);\n  if (pending) {\n    await pending;\n    return acquireSession(key, config, generation);\n  }\n\n  const desired = await resolveDesiredRuntime(config);\n  if (activeShutdowns > 0 || generation !== shutdownGeneration) {\n    throw new SandboxError(\"Error: Gondolin runtime is shutting down\");\n  }\n  const concurrentTransition = transitions.get(key);\n  if (concurrentTransition) {\n    await concurrentTransition;\n    return acquireSession(key, config, generation);\n  }\n\n  const fingerprint = runtimeFingerprint(desired);\n  const existing = sessions.get(key);\n  if (existing?.fingerprint === fingerprint) {\n    existing.activeOperations += 1;\n    return existing;\n  }\n\n  const transition = replaceSession(key, config, desired, fingerprint, existing);\n  transitions.set(key, transition);\n  try {\n    await transition;\n  } finally {\n    if (transitions.get(key) === transition) transitions.delete(key);\n  }\n  return acquireSession(key, config, generation);\n}\n\nasync function replaceSession(\n  key: string,\n  config: GondolinSandboxConfig,\n  desired: GondolinDesiredRuntime,\n  fingerprint: string,\n  existing: GondolinSession | undefined,\n): Promise<void> {\n  if (existing) {\n    await closeSession(key, existing, {\n      waitForActiveOperations: true,\n      resetResources: false,\n      throwOnError: true,\n    });\n  }\n  const replacement = createSession(key, config, desired, fingerprint);\n  sessions.set(key, replacement);\n  await replacement.runtime;\n}\n\nfunction discardDeadSession(key: string, session: GondolinSession): void {\n  if (sessions.get(key) !== session) return;\n  sessions.delete(key);\n  log.logWarning(`Gondolin runtime for '${key}' died; the session will be recreated`);\n}\n\nasync function withRuntime<T>(\n  key: string,\n  config: GondolinSandboxConfig,\n  operation: (handle: GondolinRuntimeHandle) => Promise<T>,\n): Promise<T> {\n  for (let attempt = 0; ; attempt += 1) {\n    const session = await acquireSession(key, config);\n    let handle: GondolinRuntimeHandle | undefined;\n    try {\n      handle = await session.runtime;\n      return await operation(handle);\n    } catch (error) {\n      const gone = error instanceof GondolinRuntimeGoneError;\n      const interrupted = error instanceof GondolinRuntimeInterruptedError;\n      if (gone || (interrupted && handle && !(await session.transport.isRuntimeAlive(handle)))) {\n        discardDeadSession(key, session);\n      }\n      // Nothing reached a gone runtime, so recreating and retrying is safe;\n      // an interrupted command may have side effects and must surface.\n      if (gone && attempt === 0) continue;\n      if (gone || interrupted) {\n        throw new SandboxError(\n          `Error: Gondolin runtime for '${key}' died (${(error as Error).message}); it is recreated on the next command`,\n        );\n      }\n      throw error;\n    } finally {\n      session.activeOperations -= 1;\n      session.lastUsed = Date.now();\n      if (session.activeOperations === 0) {\n        for (const resolve of session.idleWaiters.splice(0)) resolve();\n      }\n    }\n  }\n}\n\nfunction waitForIdle(session: GondolinSession): Promise<void> {\n  if (session.activeOperations === 0) return Promise.resolve();\n  return new Promise((resolve) => session.idleWaiters.push(resolve));\n}\n\nasync function closeSession(\n  key: string,\n  session: GondolinSession,\n  options: {\n    waitForActiveOperations?: boolean;\n    resetResources?: boolean;\n    throwOnError?: boolean;\n    stopRuntime?: boolean;\n  } = {},\n): Promise<void> {\n  if (sessions.get(key) !== session) return;\n  sessions.delete(key);\n  try {\n    if (options.waitForActiveOperations) await waitForIdle(session);\n    const handle = await session.runtime;\n    if (options.stopRuntime !== false) await session.transport.stop(handle);\n    if (\n      options.resetResources !== false &&\n      session.resourceKey &&\n      !Array.from(sessions.values()).some(({ resourceKey }) => resourceKey === session.resourceKey)\n    ) {\n      gondolinResources.clear(session.resourceKey);\n    }\n  } catch (error) {\n    session.fingerprint = \"\";\n    // Re-track for a retried close, unless a replacement already claimed the\n    // key — then the failed runtime stays for the reconcile paths and\n    // clobbering the replacement would leak it too.\n    if (!sessions.has(key)) sessions.set(key, session);\n    if (options.throwOnError) throw error;\n    log.logWarning(\n      `Failed to close Gondolin session '${key}'`,\n      error instanceof Error ? error.message : String(error),\n    );\n  }\n}\n\nexport async function stopIdleGondolinVms(maxIdleMs: number, now = Date.now()): Promise<void> {\n  const idle = Array.from(sessions.entries()).filter(\n    ([key, session]) =>\n      !transitions.has(key) &&\n      session.activeOperations === 0 &&\n      now - session.lastUsed >= maxIdleMs,\n  );\n  await Promise.all(\n    idle.map(([key, session]) => {\n      // Register the close as a transition so a concurrent acquire waits for\n      // it instead of racing the shared session slot.\n      const transition = closeSession(key, session).finally(() => {\n        if (transitions.get(key) === transition) transitions.delete(key);\n      });\n      transitions.set(key, transition);\n      return transition;\n    }),\n  );\n}\n\n/**\n * Stop workers surviving from a previous mikan that no conversation has\n * adopted — without this, a runtime whose conversation went quiet before the\n * restart would idle forever (its worker only self-stops when every mikan is\n * gone, and the in-memory idle sweep only tracks acquired sessions).\n */\nexport async function sweepUnadoptedGondolinWorkers(): Promise<void> {\n  for (const record of gondolinInventory.listWorkerRecords()) {\n    if (sessions.has(record.instanceId) || transitions.has(record.instanceId)) continue;\n    log.logInfo(\n      `Stopping unadopted Gondolin worker ${record.ownerPid} (instance '${record.instanceId}')`,\n    );\n    await gondolinWorkers.stop({ workerPid: record.ownerPid, sessionId: record.sessionId });\n  }\n}\n\n/**\n * Forget every session without stopping the workers: runtimes deliberately\n * outlive the mikan process so the next one adopts them instead of paying a\n * VM boot per conversation on every deploy.\n */\nexport async function disconnectAllGondolinRuntimes(): Promise<void> {\n  shutdownGeneration += 1;\n  activeShutdowns += 1;\n  try {\n    await Promise.allSettled(transitions.values());\n    const current = Array.from(sessions.entries());\n    await Promise.all(\n      current.map(([key, session]) =>\n        closeSession(key, session, { waitForActiveOperations: true, stopRuntime: false }),\n      ),\n    );\n  } finally {\n    activeShutdowns -= 1;\n  }\n}\n\nfunction executionSignal(options?: ExecOptions): AbortSignal | undefined {\n  const signals = [options?.signal];\n  if (options?.timeout && options.timeout > 0) {\n    signals.push(AbortSignal.timeout(options.timeout * 1000));\n  }\n  const active = signals.filter((signal): signal is AbortSignal => signal !== undefined);\n  return active.length > 0 ? AbortSignal.any(active) : undefined;\n}\n\nexport class GondolinExecutor implements Executor {\n  private readonly workspacePath: string;\n  private readonly instanceId: string;\n\n  constructor(\n    private readonly config: GondolinSandboxConfig,\n    private readonly env?: Record<string, string>,\n  ) {\n    // remote runtimes never load gondolin in this process, so the mikan host\n    // may stay on the supported Node floor\n    if (config.profile !== \"remote\") assertSupportedNodeVersion();\n    this.workspacePath = config.workspacePath ?? process.cwd();\n    this.instanceId = config.instanceId ?? this.workspacePath;\n  }\n\n  async exec(command: string, options?: ExecOptions): Promise<ExecResult> {\n    return withRuntime(this.instanceId, this.config, (handle) =>\n      transportFor(this.config).exec(handle, withRuntimeBootstrap(command, this.env), {\n        env: this.env,\n        signal: executionSignal(options),\n      }),\n    );\n  }\n\n  async readFile(path: string): Promise<string> {\n    return execReadFile(this, path);\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    return execWriteFile(this, path, content);\n  }\n\n  getWorkspacePath(): string {\n    return \"/workspace\";\n  }\n\n  getPathContext(hostWorkspaceRoot: string): RuntimePathContext {\n    return createMountedRuntimePathContext(hostWorkspaceRoot, \"/workspace\");\n  }\n\n  getSandboxConfig(): GondolinSandboxConfig {\n    return this.config;\n  }\n}\n\nexport const gondolinSandboxAdapter: SandboxAdapter<GondolinSandboxConfig> = {\n  type: \"gondolin\",\n  parse: parseGondolinSandboxArg,\n  validate: validateGondolinSandbox,\n  createExecutor: (config, env) => new GondolinExecutor(config, env),\n};\n"]}

package/dist/sandbox/host.d.ts

@@ -1,6 +1,8 @@
 import type { ExecOptions, ExecResult, Executor, HostSandboxConfig, RuntimePathContext, SandboxAdapter } from "./types.js";
 export declare class HostExecutor implements Executor {
     exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
     getWorkspacePath(hostPath: string): string;
     getPathContext(hostWorkspaceRoot: string): RuntimePathContext;
     getSandboxConfig(): HostSandboxConfig;

package/dist/sandbox/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/sandbox/host.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAWpB,qBAAa,YAAa,YAAW,QAAQ;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuEtE;IAED,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzC;IAED,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,kBAAkB,CAE5D;IAED,gBAAgB,IAAI,iBAAiB,CAEpC;CACF;AAED,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,iBAAiB,CAIhE,CAAC"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/sandbox/host.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAWpB,qBAAa,YAAa,YAAW,QAAQ;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuEtE;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5C;IAEK,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5D;IAED,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzC;IAED,cAAc,CAAC,iBAAiB,EAAE,MAAM,GAAG,kBAAkB,CAE5D;IAED,gBAAgB,IAAI,iBAAiB,CAEpC;CACF;AAED,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,iBAAiB,CAIhE,CAAC"}

package/dist/sandbox/host.js

@@ -1,4 +1,6 @@
 import { spawn } from "child_process";
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { dirname } from "path";
 import { killProcessTree } from "./utils.js";
 import { createMountedRuntimePathContext } from "./path-context.js";
 function parseHostSandboxArg(value) {
@@ -67,6 +69,15 @@ export class HostExecutor {
             });
         });
     }
+    async readFile(path) {
+        return readFile(path, "utf-8");
+    }
+    async writeFile(path, content) {
+        await mkdir(dirname(path), { recursive: true });
+        const stage = `${path}.mikan-stage`;
+        await writeFile(stage, content, "utf-8");
+        await rename(stage, path);
+    }
     getWorkspacePath(hostPath) {
         return hostPath;
     }

package/dist/sandbox/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/sandbox/host.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"child_process\";\nimport type {\n  ExecOptions,\n  ExecResult,\n  Executor,\n  HostSandboxConfig,\n  RuntimePathContext,\n  SandboxAdapter,\n} from \"./types.js\";\nimport { killProcessTree } from \"./utils.js\";\nimport { createMountedRuntimePathContext } from \"./path-context.js\";\n\nfunction parseHostSandboxArg(value: string): HostSandboxConfig | undefined {\n  if (value === \"host\") {\n    return { type: \"host\" };\n  }\n  return undefined;\n}\n\nexport class HostExecutor implements Executor {\n  async exec(command: string, options?: ExecOptions): Promise<ExecResult> {\n    return new Promise((resolve, reject) => {\n      const shell = process.platform === \"win32\" ? \"cmd\" : \"sh\";\n      const shellArgs = process.platform === \"win32\" ? [\"/c\"] : [\"-c\"];\n\n      const child = spawn(shell, [...shellArgs, command], {\n        detached: true,\n        stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      });\n\n      let stdout = \"\";\n      let stderr = \"\";\n      let timedOut = false;\n\n      const timeoutHandle =\n        options?.timeout && options.timeout > 0\n          ? setTimeout(() => {\n              timedOut = true;\n              killProcessTree(child.pid!);\n            }, options.timeout * 1000)\n          : undefined;\n\n      const onAbort = () => {\n        if (child.pid) killProcessTree(child.pid);\n      };\n\n      if (options?.signal) {\n        if (options.signal.aborted) {\n          onAbort();\n        } else {\n          options.signal.addEventListener(\"abort\", onAbort, { once: true });\n        }\n      }\n\n      child.stdout?.on(\"data\", (data) => {\n        stdout += data.toString();\n        if (stdout.length > 10 * 1024 * 1024) {\n          stdout = stdout.slice(0, 10 * 1024 * 1024);\n        }\n      });\n\n      child.stderr?.on(\"data\", (data) => {\n        stderr += data.toString();\n        if (stderr.length > 10 * 1024 * 1024) {\n          stderr = stderr.slice(0, 10 * 1024 * 1024);\n        }\n      });\n\n      child.on(\"close\", (code) => {\n        if (timeoutHandle) clearTimeout(timeoutHandle);\n        if (options?.signal) {\n          options.signal.removeEventListener(\"abort\", onAbort);\n        }\n\n        if (options?.signal?.aborted) {\n          reject(new Error(`${stdout}\\n${stderr}\\nCommand aborted`.trim()));\n          return;\n        }\n\n        if (timedOut) {\n          reject(\n            new Error(\n              `${stdout}\\n${stderr}\\nCommand timed out after ${options?.timeout} seconds`.trim(),\n            ),\n          );\n          return;\n        }\n\n        resolve({ stdout, stderr, code: code ?? 0 });\n      });\n    });\n  }\n\n  getWorkspacePath(hostPath: string): string {\n    return hostPath;\n  }\n\n  getPathContext(hostWorkspaceRoot: string): RuntimePathContext {\n    return createMountedRuntimePathContext(hostWorkspaceRoot, hostWorkspaceRoot);\n  }\n\n  getSandboxConfig(): HostSandboxConfig {\n    return { type: \"host\" };\n  }\n}\n\nexport const hostSandboxAdapter: SandboxAdapter<HostSandboxConfig> = {\n  type: \"host\",\n  parse: parseHostSandboxArg,\n  createExecutor: () => new HostExecutor(),\n};\n"]}
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/sandbox/host.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"child_process\";\nimport { mkdir, readFile, rename, writeFile } from \"fs/promises\";\nimport { dirname } from \"path\";\nimport type {\n  ExecOptions,\n  ExecResult,\n  Executor,\n  HostSandboxConfig,\n  RuntimePathContext,\n  SandboxAdapter,\n} from \"./types.js\";\nimport { killProcessTree } from \"./utils.js\";\nimport { createMountedRuntimePathContext } from \"./path-context.js\";\n\nfunction parseHostSandboxArg(value: string): HostSandboxConfig | undefined {\n  if (value === \"host\") {\n    return { type: \"host\" };\n  }\n  return undefined;\n}\n\nexport class HostExecutor implements Executor {\n  async exec(command: string, options?: ExecOptions): Promise<ExecResult> {\n    return new Promise((resolve, reject) => {\n      const shell = process.platform === \"win32\" ? \"cmd\" : \"sh\";\n      const shellArgs = process.platform === \"win32\" ? [\"/c\"] : [\"-c\"];\n\n      const child = spawn(shell, [...shellArgs, command], {\n        detached: true,\n        stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      });\n\n      let stdout = \"\";\n      let stderr = \"\";\n      let timedOut = false;\n\n      const timeoutHandle =\n        options?.timeout && options.timeout > 0\n          ? setTimeout(() => {\n              timedOut = true;\n              killProcessTree(child.pid!);\n            }, options.timeout * 1000)\n          : undefined;\n\n      const onAbort = () => {\n        if (child.pid) killProcessTree(child.pid);\n      };\n\n      if (options?.signal) {\n        if (options.signal.aborted) {\n          onAbort();\n        } else {\n          options.signal.addEventListener(\"abort\", onAbort, { once: true });\n        }\n      }\n\n      child.stdout?.on(\"data\", (data) => {\n        stdout += data.toString();\n        if (stdout.length > 10 * 1024 * 1024) {\n          stdout = stdout.slice(0, 10 * 1024 * 1024);\n        }\n      });\n\n      child.stderr?.on(\"data\", (data) => {\n        stderr += data.toString();\n        if (stderr.length > 10 * 1024 * 1024) {\n          stderr = stderr.slice(0, 10 * 1024 * 1024);\n        }\n      });\n\n      child.on(\"close\", (code) => {\n        if (timeoutHandle) clearTimeout(timeoutHandle);\n        if (options?.signal) {\n          options.signal.removeEventListener(\"abort\", onAbort);\n        }\n\n        if (options?.signal?.aborted) {\n          reject(new Error(`${stdout}\\n${stderr}\\nCommand aborted`.trim()));\n          return;\n        }\n\n        if (timedOut) {\n          reject(\n            new Error(\n              `${stdout}\\n${stderr}\\nCommand timed out after ${options?.timeout} seconds`.trim(),\n            ),\n          );\n          return;\n        }\n\n        resolve({ stdout, stderr, code: code ?? 0 });\n      });\n    });\n  }\n\n  async readFile(path: string): Promise<string> {\n    return readFile(path, \"utf-8\");\n  }\n\n  async writeFile(path: string, content: string): Promise<void> {\n    await mkdir(dirname(path), { recursive: true });\n    const stage = `${path}.mikan-stage`;\n    await writeFile(stage, content, \"utf-8\");\n    await rename(stage, path);\n  }\n\n  getWorkspacePath(hostPath: string): string {\n    return hostPath;\n  }\n\n  getPathContext(hostWorkspaceRoot: string): RuntimePathContext {\n    return createMountedRuntimePathContext(hostWorkspaceRoot, hostWorkspaceRoot);\n  }\n\n  getSandboxConfig(): HostSandboxConfig {\n    return { type: \"host\" };\n  }\n}\n\nexport const hostSandboxAdapter: SandboxAdapter<HostSandboxConfig> = {\n  type: \"host\",\n  parse: parseHostSandboxArg,\n  createExecutor: () => new HostExecutor(),\n};\n"]}

package/dist/sandbox/identity.d.ts

@@ -0,0 +1,21 @@
+import type { SandboxConfig } from "./types.js";
+/**
+ * Runtime actor identity: the one key that names a conversation's vault dir,
+ * docker container and network, and cloudflare sandbox suffix. Everything
+ * that needs such a name consumes actorKey(); nothing may re-derive or
+ * re-sanitize it — two sanitizers with divergent outputs used to make a
+ * container/vault mismatch a silent wrong-identity bug rather than an error.
+ */
+export declare function sanitizeIdentitySegment(value: string): string;
+/**
+ * The actor key for a sandbox config: per-conversation for managed sandboxes
+ * (image/gondolin/cloudflare/firecracker), the fixed container name for a shared
+ * container, and the platform user id on the host.
+ */
+export declare function actorKey(baseConfig: SandboxConfig, ids: {
+    userId: string;
+    conversationId: string;
+}): string;
+/** Scope a base cloudflare sandbox id to one actor key. */
+export declare function scopeCloudflareSandboxId(baseId: string, actorVaultKey: string): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/sandbox/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/sandbox/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,aAAa,EACzB,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAC9C,MAAM,CAaR;AAED,2DAA2D;AAC3D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEtF"}

package/dist/sandbox/identity.js

@@ -0,0 +1,36 @@
+/**
+ * Runtime actor identity: the one key that names a conversation's vault dir,
+ * docker container and network, and cloudflare sandbox suffix. Everything
+ * that needs such a name consumes actorKey(); nothing may re-derive or
+ * re-sanitize it — two sanitizers with divergent outputs used to make a
+ * container/vault mismatch a silent wrong-identity bug rather than an error.
+ */
+export function sanitizeIdentitySegment(value) {
+    const sanitized = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return sanitized || "unknown";
+}
+/**
+ * The actor key for a sandbox config: per-conversation for managed sandboxes
+ * (image/gondolin/cloudflare/firecracker), the fixed container name for a shared
+ * container, and the platform user id on the host.
+ */
+export function actorKey(baseConfig, ids) {
+    if (baseConfig.type === "container") {
+        return `container-${baseConfig.container}`;
+    }
+    if (baseConfig.type === "image" ||
+        baseConfig.type === "gondolin" ||
+        baseConfig.type === "cloudflare" ||
+        baseConfig.type === "firecracker") {
+        return sanitizeIdentitySegment(ids.conversationId);
+    }
+    return ids.userId;
+}
+/** Scope a base cloudflare sandbox id to one actor key. */
+export function scopeCloudflareSandboxId(baseId, actorVaultKey) {
+    return `${baseId}-${sanitizeIdentitySegment(actorVaultKey)}`;
+}
+//# sourceMappingURL=identity.js.map

package/dist/sandbox/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/sandbox/identity.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,SAAS,GAAG,KAAK;SACpB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,UAAyB,EACzB,GAA+C;IAE/C,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO,aAAa,UAAU,CAAC,SAAS,EAAE,CAAC;IAC7C,CAAC;IACD,IACE,UAAU,CAAC,IAAI,KAAK,OAAO;QAC3B,UAAU,CAAC,IAAI,KAAK,UAAU;QAC9B,UAAU,CAAC,IAAI,KAAK,YAAY;QAChC,UAAU,CAAC,IAAI,KAAK,aAAa,EACjC,CAAC;QACD,OAAO,uBAAuB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,aAAqB;IAC5E,OAAO,GAAG,MAAM,IAAI,uBAAuB,CAAC,aAAa,CAAC,EAAE,CAAC;AAC/D,CAAC","sourcesContent":["import type { SandboxConfig } from \"./types.js\";\n\n/**\n * Runtime actor identity: the one key that names a conversation's vault dir,\n * docker container and network, and cloudflare sandbox suffix. Everything\n * that needs such a name consumes actorKey(); nothing may re-derive or\n * re-sanitize it — two sanitizers with divergent outputs used to make a\n * container/vault mismatch a silent wrong-identity bug rather than an error.\n */\nexport function sanitizeIdentitySegment(value: string): string {\n  const sanitized = value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n  return sanitized || \"unknown\";\n}\n\n/**\n * The actor key for a sandbox config: per-conversation for managed sandboxes\n * (image/gondolin/cloudflare/firecracker), the fixed container name for a shared\n * container, and the platform user id on the host.\n */\nexport function actorKey(\n  baseConfig: SandboxConfig,\n  ids: { userId: string; conversationId: string },\n): string {\n  if (baseConfig.type === \"container\") {\n    return `container-${baseConfig.container}`;\n  }\n  if (\n    baseConfig.type === \"image\" ||\n    baseConfig.type === \"gondolin\" ||\n    baseConfig.type === \"cloudflare\" ||\n    baseConfig.type === \"firecracker\"\n  ) {\n    return sanitizeIdentitySegment(ids.conversationId);\n  }\n  return ids.userId;\n}\n\n/** Scope a base cloudflare sandbox id to one actor key. */\nexport function scopeCloudflareSandboxId(baseId: string, actorVaultKey: string): string {\n  return `${baseId}-${sanitizeIdentitySegment(actorVaultKey)}`;\n}\n"]}