@prismatic-io/lux 0.0.2-preview.4 → 0.0.2-preview.41

package/lib/cli/run-options.js

@@ -1,13 +1,14 @@
-import { InvalidArgumentError } from "commander";
-export const collectTags = (value, previous) => previous.concat(value
-    .split(",")
-    .map((tag) => tag.trim())
-    .filter(Boolean));
-export const collectValues = (value, previous) => [...previous, value];
+import { existsSync } from "node:fs";
+import { basename, extname, resolve } from "node:path";
+import { Errors } from "incur";
+import { selectCases } from "../orchestrator/index.js";
+import { planHarnessItems } from "./harness-plan.js";
 export const parseAnnotationAssertion = (value) => {
     const match = /^(.+)=(pass|fail)(?::(.+))?$/.exec(value);
-    if (!match?.[1] || !match[2]) {
-        throw new InvalidArgumentError("--assertion must use id=pass, id=fail, or id=pass:0.8 syntax");
+    if (!match?.[1]?.trim() || !match[2]) {
+        throw new Errors.ParseError({
+            message: "--assertion must use id=pass, id=fail, or id=pass:0.8 syntax",
+        });
     }
     const score = match[3] === undefined ? undefined : parseUnitInterval(match[3]);
     return [
@@ -18,18 +19,10 @@ export const parseAnnotationAssertion = (value) => {
         },
     ];
 };
-export const parsePositiveInt = (value) => {
-    // Number() rejects partial numbers such as "3abc" and "2.9".
+const parseUnitInterval = (value) => {
     const parsed = Number(value);
-    if (!Number.isInteger(parsed) || parsed < 1) {
-        throw new InvalidArgumentError("must be a positive integer");
-    }
-    return parsed;
-};
-export const parseUnitInterval = (value) => {
-    const parsed = Number(value);
-    if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
-        throw new InvalidArgumentError("must be a number between 0 and 1");
+    if (!value.trim() || !Number.isFinite(parsed) || parsed < 0 || parsed > 1) {
+        throw new Errors.ParseError({ message: "must be a number between 0 and 1" });
     }
     return parsed;
 };
@@ -55,4 +48,92 @@ export const resolveAnswererOverride = (options) => {
         return "claude-code";
     return undefined;
 };
+const caseIdOf = (casePath) => basename(casePath, extname(casePath));
+export const suiteTitle = (patterns, tags, explicit, loop, focus) => {
+    const parts = [...patterns, ...explicit.map((e) => e.id), ...tags.map((t) => `#${t}`)];
+    const filter = parts.length > 0 ? ` ${parts.join(" ")}` : "";
+    const focusParts = [focus.driver, focus.model, focus.effort].filter((part) => part !== undefined);
+    const focused = focusParts.length > 0 ? ` @${focusParts.join(":")}` : "";
+    const repeat = loop > 1 ? ` ×${loop}` : "";
+    return `run${filter}${focused}${repeat}`;
+};
+// A filter that names an existing `.ts` file runs that file directly — it may
+// sit outside the discovery root. Everything else is a substring pattern — but
+// a `.ts` filter that resolves to nothing is almost always a typo'd path, so
+// the silent downgrade to a pattern gets called out.
+export const partitionFilters = (filters, cwd) => {
+    const explicit = [];
+    const patterns = [];
+    for (const f of filters) {
+        const abs = resolve(cwd, f);
+        if (f.endsWith(".ts") && existsSync(abs)) {
+            explicit.push({ path: abs, id: caseIdOf(f) });
+        }
+        else {
+            if (f.endsWith(".ts")) {
+                process.stderr.write(`lux: ${abs} does not exist; treating "${f}" as a pattern\n`);
+            }
+            patterns.push(f);
+        }
+    }
+    return { explicit, patterns };
+};
+// The selected set — substring/tag matches plus explicitly named files — is
+// the same whether it is run, `--list`ed, or `--list-tags`ed. No filters at
+// all means "everything discovered"; any filter narrows.
+export const selectSuite = (cases, { explicit, patterns }, tags) => {
+    const hasFilter = explicit.length > 0 || patterns.length > 0 || tags.length > 0;
+    const byPath = new Map();
+    if (!hasFilter) {
+        for (const c of cases)
+            byPath.set(c.path, c);
+    }
+    else {
+        if (patterns.length > 0 || tags.length > 0) {
+            for (const c of selectCases(cases, { patterns, tags }))
+                byPath.set(c.path, c);
+        }
+        for (const e of explicit) {
+            const discovered = cases.find((c) => c.path === e.path);
+            // Discovery knows the case's declared id; the filename-derived one is
+            // only a fallback for files discovery never saw.
+            byPath.set(e.path, {
+                path: e.path,
+                id: discovered?.id ?? e.id,
+                relPath: discovered?.relPath ?? e.id,
+                tags: discovered?.tags ?? [],
+            });
+        }
+    }
+    return [...byPath.values()].sort((a, b) => a.id.localeCompare(b.id));
+};
+// `--loop` repeats each eval before moving to the next; each repeat gets a
+// `#n` display suffix so the reporter keeps them apart, while `caseId` keeps
+// every repeat filed under one run history.
+export const expandLoop = (base, loop) => loop > 1
+    ? base.flatMap((b) => Array.from({ length: loop }, (_, i) => ({
+        ...b,
+        id: `${b.id} #${i + 1}`,
+        caseId: b.caseId ?? b.id,
+    })))
+    : base;
+export const planSuiteItems = async (selected, options) => {
+    const plan = await planHarnessItems(selected, options);
+    for (const skipped of plan.unavailable) {
+        process.stderr.write(`lux: skipping ${skipped.id}: harness command not found: ${skipped.commands.join(", ")}\n`);
+    }
+    if (plan.excluded.length > 0) {
+        process.stderr.write(`lux: the harness focus excludes ${plan.excluded.length} pinned case${plan.excluded.length === 1 ? "" : "s"}: ${plan.excluded.join(", ")}\n`);
+    }
+    if (plan.items.length === 0) {
+        throw new Errors.IncurError({
+            code: plan.unavailable.length > 0 ? "NO_RUNNABLE_HARNESSES" : "NO_CASES_MATCHED",
+            message: plan.unavailable.length > 0
+                ? "No cases remain: all selected matrix harnesses are unavailable."
+                : "No cases remain after applying the harness focus.",
+            exitCode: 1,
+        });
+    }
+    return plan.items;
+};
 //# sourceMappingURL=run-options.js.map

package/lib/cli/run-options.js.map

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

package/lib/cli/view.d.ts

@@ -0,0 +1,15 @@
+export type ViewOptions = {
+    runsRoot?: string;
+    case?: string;
+    suites?: boolean;
+    experiments?: boolean;
+    web?: boolean;
+    port?: number;
+    open?: boolean;
+};
+export declare function webViewCommand(runDirArg: string | undefined, options: ViewOptions): AsyncGenerator<{
+    url: string;
+    runsRoot: string;
+}, void>;
+export declare const viewCommand: (runDirArg: string | undefined, options: ViewOptions) => Promise<unknown>;
+//# sourceMappingURL=view.d.ts.map

package/lib/cli/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/cli/view.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAgBF,wBAAuB,cAAc,CACnC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,WAAW,GACnB,cAAc,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,CAAC,CA8BzD;AAED,eAAO,MAAM,WAAW,cACX,MAAM,GAAG,SAAS,WACpB,WAAW,KACnB,OAAO,CAAC,OAAO,CAiDjB,CAAC"}

package/lib/cli/view.js

@@ -0,0 +1,168 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { resolve } from "node:path";
+import { Errors } from "incur";
+import { isExperimentRun, listExperimentRuns, listRuns, listSuiteRuns, loadExperimentRun, loadLuxConfig, loadRunDetail, loadSuiteRun, } from "../orchestrator/index.js";
+import { openPreviewUrl, startPreviewServer } from "../previewer/server.js";
+import { abortOnInterrupt, ensureDirectory, failWith } from "./command-runtime.js";
+const SIGINT_EXIT_CODE = 130;
+const previewKind = async (initialPath, options) => {
+    if (initialPath) {
+        if (isExperimentRun(initialPath))
+            return "experiment";
+        if (await loadSuiteRun(initialPath))
+            return "suite";
+        return "run";
+    }
+    if (options.experiments)
+        return "experiment";
+    if (options.suites)
+        return "suite";
+    return undefined;
+};
+export async function* webViewCommand(runDirArg, options) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const config = await loadLuxConfig(process.cwd());
+        const runsRoot = options.runsRoot ? resolve(options.runsRoot) : config.runsRoot;
+        const initialPath = runDirArg ? resolve(runDirArg) : undefined;
+        if (initialPath && !(await ensureDirectory("view", initialPath)))
+            failWith(1);
+        const initialKind = await previewKind(initialPath, options);
+        const controller = __addDisposableResource(env_1, abortOnInterrupt(), false);
+        const preview = await startPreviewServer({
+            runsRoot,
+            ...(options.port !== undefined ? { port: options.port } : {}),
+            ...(initialPath ? { initialPath } : {}),
+            ...(initialKind ? { initialKind } : {}),
+            ...(options.case ? { caseFilter: options.case } : {}),
+            signal: controller.signal,
+        });
+        try {
+            yield { url: preview.url, runsRoot };
+            if (options.open !== false) {
+                try {
+                    await openPreviewUrl(preview.url);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    process.stderr.write(`lux view: could not open a browser (${message})\n`);
+                }
+            }
+            await preview.closed;
+            if (controller.signal.aborted)
+                failWith(SIGINT_EXIT_CODE);
+        }
+        finally {
+            await preview.close();
+        }
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+export const viewCommand = async (runDirArg, options) => {
+    if (options.port !== undefined || options.open === false) {
+        throw new Errors.ParseError({ message: "--port and --no-open require --web" });
+    }
+    if (runDirArg) {
+        const path = resolve(runDirArg);
+        if (!(await ensureDirectory("view", path)))
+            return;
+        if (isExperimentRun(path)) {
+            const experiment = await loadExperimentRun(path);
+            if (!experiment) {
+                throw new Errors.IncurError({
+                    code: "INVALID_EXPERIMENT",
+                    message: `Invalid experiment at ${path}.`,
+                    exitCode: 1,
+                });
+            }
+            return { experimentDir: path, ...experiment };
+        }
+        const suite = await loadSuiteRun(path);
+        if (suite) {
+            return { suiteDir: path, ...suite };
+        }
+        return loadRunDetail(path);
+    }
+    const config = await loadLuxConfig(process.cwd());
+    const runsRoot = options.runsRoot ? resolve(options.runsRoot) : config.runsRoot;
+    const readErrors = [];
+    const listingOptions = {
+        onReadError: (path, error) => {
+            readErrors.push({ path, message: error instanceof Error ? error.message : String(error) });
+        },
+    };
+    if (options.experiments) {
+        const experiments = await listExperimentRuns(runsRoot, listingOptions);
+        return { runsRoot, experiments, ...(readErrors.length ? { readErrors } : {}) };
+    }
+    if (options.suites) {
+        const suites = await listSuiteRuns(runsRoot, listingOptions);
+        return { runsRoot, suites, ...(readErrors.length ? { readErrors } : {}) };
+    }
+    const all = await listRuns(runsRoot);
+    const runs = options.case ? all.filter((run) => run.caseSlug === options.case) : all;
+    return {
+        runsRoot,
+        ...(!options.case ? { suites: await listSuiteRuns(runsRoot, listingOptions) } : {}),
+        runs,
+        ...(readErrors.length ? { readErrors } : {}),
+    };
+};
+//# sourceMappingURL=view.js.map

package/lib/cli/view.js.map

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

package/lib/container/driver.d.ts

@@ -0,0 +1,27 @@
+import type { AgentDriver, Artifact, DriverEventMap, StartContext } from "../core/driver.js";
+import type { ContainerExecution } from "../core/driver-execution.js";
+import { TypedEmitter } from "../core/emitter.js";
+import { type Answer, type ReadyState } from "../core/events.js";
+export declare class ContainerDriver extends TypedEmitter<DriverEventMap> implements AgentDriver {
+    private process;
+    private resources;
+    private sequence;
+    private pending;
+    private closing;
+    private context;
+    private terminal;
+    private readonly abort;
+    private readonly name;
+    private readonly config;
+    private readonly execution;
+    constructor(name: string, config: unknown, execution: ContainerExecution);
+    private fail;
+    private receive;
+    private rpc;
+    start(ctx: StartContext): Promise<ReadyState>;
+    respond(answer: Answer): Promise<void>;
+    quiesce(): Promise<void>;
+    collect(): Promise<Artifact[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/lib/container/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/container/driver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,KAAK,MAAM,EAKX,KAAK,UAAU,EAEhB,MAAM,mBAAmB,CAAC;AAQ3B,qBAAa,eAAgB,SAAQ,YAAY,CAAC,cAAc,CAAE,YAAW,WAAW;IACtF,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,SAAS,CAA2D;IAC5E,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAEpB;IAEF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,YAAY,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAUvE;IAED,OAAO,CAAC,IAAI,CAOV;IAEF,OAAO,CAAC,OAAO,CA+Bb;IAEF,OAAO,CAAC,GAAG,CA2BN;IAEC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAkDlD;IAEK,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3C;IACK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;IACK,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAenC;IACD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAerB;CACF"}

package/lib/container/driver.js

@@ -0,0 +1,199 @@
+import { realpath } from "node:fs/promises";
+import { posix } from "node:path";
+import { TypedEmitter } from "../core/emitter.js";
+import { DoneSchema, ErrorEventSchema, InterruptSchema, ProgressSchema, ReadyStateSchema, } from "../core/events.js";
+import { spawnManagedProcess } from "../core/exec.js";
+import { walkArtifacts } from "../drivers/shared/artifacts.js";
+import { LUX_VERSION } from "../orchestrator/package-version.js";
+import { containerPaths } from "./paths.js";
+import { readMessages, writeMessage } from "./protocol.js";
+import { prepareContainer } from "./resources.js";
+export class ContainerDriver extends TypedEmitter {
+    process;
+    resources;
+    sequence = 0;
+    pending = new Map();
+    closing;
+    context;
+    terminal = false;
+    abort = () => {
+        void this.close().catch(() => { });
+    };
+    name;
+    config;
+    execution;
+    constructor(name, config, execution) {
+        super();
+        this.name = name;
+        this.config = config;
+        this.execution = execution;
+        JSON.stringify(config, (_key, value) => {
+            if (typeof value === "function" || typeof value === "symbol" || typeof value === "bigint")
+                throw new Error("container driver configuration must be JSON serializable");
+            return value;
+        });
+    }
+    fail = (error) => {
+        for (const pending of this.pending.values())
+            pending.reject(error);
+        this.pending.clear();
+        if (!this.terminal && !this.closing) {
+            this.terminal = true;
+            void this.emit("error", { exitReason: "error", reason: error.message }).catch(() => { });
+        }
+    };
+    receive = (message) => {
+        if (message.event) {
+            const dispatch = async () => {
+                switch (message.event) {
+                    case "interrupt":
+                        await this.emit("interrupt", InterruptSchema.parse(message.value));
+                        break;
+                    case "progress":
+                        await this.emit("progress", ProgressSchema.parse(message.value));
+                        break;
+                    case "done":
+                        this.terminal = true;
+                        await this.emit("done", DoneSchema.parse(message.value));
+                        break;
+                    case "error":
+                        this.terminal = true;
+                        await this.emit("error", ErrorEventSchema.parse(message.value));
+                        break;
+                    default:
+                        throw new Error("unknown container event");
+                }
+                if (this.process)
+                    writeMessage(this.process.child.stdin, { id: message.id, ack: true });
+            };
+            void dispatch().catch(this.fail);
+            return;
+        }
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        if (message.error !== undefined)
+            pending.reject(new Error(message.error));
+        else
+            pending.resolve(message.value);
+    };
+    rpc = (method, value, timeoutMs = 30_000) => new Promise((resolvePromise, reject) => {
+        if (!this.process) {
+            reject(new Error("container process is unavailable"));
+            return;
+        }
+        const id = ++this.sequence;
+        const timer = setTimeout(() => {
+            this.pending.delete(id);
+            reject(new Error(`container ${method} timed out`));
+        }, timeoutMs);
+        this.pending.set(id, {
+            resolve: (result) => {
+                clearTimeout(timer);
+                resolvePromise(result);
+            },
+            reject: (error) => {
+                clearTimeout(timer);
+                reject(error);
+            },
+        });
+        try {
+            writeMessage(this.process.child.stdin, { id, method, value });
+        }
+        catch (error) {
+            this.pending.get(id)?.reject(error);
+            this.pending.delete(id);
+        }
+    });
+    async start(ctx) {
+        this.context = ctx;
+        if (ctx.abortSignal.aborted)
+            throw new Error("container run aborted before startup");
+        const raw = this.config;
+        if (raw?.cwdMode === "runDir")
+            throw new Error("container drivers must use the artifacts workspace, not cwdMode: runDir");
+        if (raw?.cwd && (await realpath(raw.cwd)) !== (await realpath(ctx.artifactsDir)))
+            throw new Error("container driver cwd must be the mounted artifacts workspace");
+        this.resources = await prepareContainer(this.execution, ctx.artifactsDir);
+        try {
+            this.process = spawnManagedProcess(this.resources.command, this.resources.args, {
+                env: this.resources.env,
+            });
+            readMessages(this.process.child.stdout, this.receive, this.fail);
+            // Harness stderr can contain secrets. The normalized driver protocol is the evidence surface.
+            this.process.child.stderr.resume();
+            void this.process.exited.then(() => this.fail(new Error("container worker exited")));
+            ctx.abortSignal.addEventListener("abort", this.abort, { once: true });
+            await this.process.spawned;
+            if (ctx.abortSignal.aborted)
+                throw new Error("container run aborted during startup");
+            const { abortSignal: _signal, ...context } = ctx;
+            const ready = ReadyStateSchema.parse(await this.rpc("start", {
+                version: LUX_VERSION,
+                name: this.name,
+                config: containerPaths(this.config, this.resources.pathMappings),
+                module: this.execution.driverModule,
+                context: {
+                    ...containerPaths(context, this.resources.pathMappings),
+                    artifactsDir: this.resources.containerRoot,
+                    ...(context.fixtures
+                        ? { fixtures: { ...context.fixtures, rootDir: this.resources.containerRoot } }
+                        : {}),
+                    runDir: "/tmp/lux-run",
+                    runsRoot: "/tmp/lux-runs",
+                },
+            }, this.execution.startupTimeoutMs ?? 60_000));
+            return {
+                ...ready,
+                detail: { ...ready.detail, execution: "container", image: this.resources.image },
+            };
+        }
+        catch (error) {
+            await this.close();
+            throw error;
+        }
+    }
+    async respond(answer) {
+        await this.rpc("respond", answer);
+    }
+    async quiesce() {
+        await this.rpc("quiesce");
+    }
+    async collect() {
+        const root = this.resources?.root;
+        const containerRoot = this.resources?.containerRoot;
+        if (!root || !containerRoot)
+            return [];
+        try {
+            const artifacts = (await this.rpc("collect"));
+            for (const artifact of artifacts) {
+                const path = posix.resolve(artifact.root ?? containerRoot, artifact.path);
+                if (path !== containerRoot && !path.startsWith(`${containerRoot}/`))
+                    throw new Error("container driver returned artifacts outside its mounted workspace");
+            }
+        }
+        finally {
+            await this.close();
+        }
+        return walkArtifacts(root);
+    }
+    close() {
+        this.closing ??= (async () => {
+            this.context?.abortSignal.removeEventListener("abort", this.abort);
+            try {
+                if (this.process) {
+                    await this.rpc("close", undefined, 5_000).catch(() => { });
+                    this.process.child.stdin.end();
+                }
+                await this.resources?.cleanup();
+            }
+            finally {
+                await this.process?.terminate();
+                this.fail(new Error("container driver closed"));
+            }
+        })();
+        return this.closing;
+    }
+}
+//# sourceMappingURL=driver.js.map

package/lib/container/driver.js.map

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

package/lib/container/paths.d.ts

@@ -0,0 +1,3 @@
+/** Translate only mounted host paths; unrelated configuration remains untouched. */
+export declare const containerPaths: <T>(value: T, mappings: readonly (readonly [string, string])[]) => T;
+//# sourceMappingURL=paths.d.ts.map

package/lib/container/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/container/paths.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,cAAc,GAAI,CAAC,SACvB,CAAC,YACE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,KAC/C,CAwBF,CAAC"}

package/lib/container/paths.js

@@ -0,0 +1,27 @@
+/** Translate only mounted host paths; unrelated configuration remains untouched. */
+export const containerPaths = (value, mappings) => {
+    const ordered = [...mappings].sort(([a], [b]) => b.length - a.length);
+    const visit = (entry) => {
+        if (typeof entry === "string") {
+            let text = entry;
+            for (const [source, target] of ordered) {
+                if (source === target)
+                    continue;
+                if (text === source)
+                    return target;
+                if (text.startsWith(`${source}\\`) || text.startsWith(`${source}/`))
+                    return target + text.slice(source.length).replaceAll("\\", "/");
+                const escaped = source.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+                text = text.replace(new RegExp(`${escaped}([\\\\/][^\\s"']*)?(?=$|[\\s"'])`, "g"), (_match, suffix) => target + (suffix ?? "").replaceAll("\\", "/"));
+            }
+            return text;
+        }
+        if (Array.isArray(entry))
+            return entry.map(visit);
+        if (entry && typeof entry === "object")
+            return Object.fromEntries(Object.entries(entry).map(([key, item]) => [key, visit(item)]));
+        return entry;
+    };
+    return visit(value);
+};
+//# sourceMappingURL=paths.js.map