@elaraai/east 1.0.84 → 1.0.86

package/dist/src/runner_exec.js

@@ -0,0 +1,371 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Executing a unit of the runner protocol: {@link executeUnit}, the one
+ * TypeScript unit runner, over a {@link UnitIO}.
+ *
+ * A unit (`UnitType`) runs a program on its inputs, merges the parts of one
+ * output that earlier units wrote, or takes a delivered collection in, and
+ * names where its output and its result go. A program's output is written by
+ * its kind:
+ * - a value as one blob, or as a manifest directory when it is a collection;
+ * - an array through the Writer;
+ * - a set or a dict through the RunSorter, as sorted runs;
+ * - a fold by folding every emitted value into an accumulator.
+ *
+ * A delivery taken in is read a segment at a time from its file, and written
+ * through the Writer as a manifest directory (`intakeBeast2For`).
+ *
+ * Collections are written as manifest directories, which a store takes in by
+ * linking their files. The result (`UnitResultType`) records the outcome —
+ * `ok`, or the failure's message and source locations — with where the time
+ * went and the host's peak memory. east-c and east-py implement the same
+ * protocol, and the conformance corpus holds the three to the same output
+ * bytes and outcomes.
+ *
+ * The work reaches its files only through the UnitIO it is given, its
+ * platform functions only through the host's resolver, and the host's memory
+ * only through the gauges it is given, so the same code runs as east-node's
+ * `exec` over this machine's files and in a browser's Web Worker over an
+ * `InMemoryUnitIO` — east-c's shape (`east/unit.h`), where the unit machinery
+ * is library code and its CLI wires it to files.
+ */
+import { EastTypeValueType, isTypeValueEqual } from "./type_of_type.js";
+import { variant } from "./containers/variant.js";
+import { SortedMap } from "./containers/sortedmap.js";
+import { SortedSet } from "./containers/sortedset.js";
+import { compareFor } from "./comparison.js";
+import { EastError } from "./error.js";
+import { printTypeValue } from "./compile/runtime.js";
+import { Beast2ManifestWriter, Beast2RunSorter, beast2LazyStats, configureFramePool, decodeBeast2For, encodeBeast2For, intakeBeast2For, } from "./serialization/beast2/index.js";
+import { lazyInputBytesRead, loadUnitInput, loadUnitProgram, openUnitInputs, segmentPath, } from "./runner_io.js";
+import { loadUnitMergeFunction, mergeUnitParts } from "./runner_merge.js";
+/**
+ * Executes a unit: does its work over `io`, writes its output there, and says
+ * how it went.
+ *
+ * @param unit - the unit; the files it names are read and written through `io`
+ * @param io - the unit's files
+ * @param options - the host's platform resolver, its memory gauges, the
+ *   decoded weight a lazy input's pager keeps, and who hears how the inputs
+ *   are read
+ * @returns the result — a failure is its outcome, never a throw. The host
+ *   writes it where the unit's `result` says, if it keeps it
+ *
+ * @remarks
+ * The unit's thread grant caps the frame pool for the rest of the process: a
+ * grant of one frames every output inline. A unit whose host places its
+ * segments as they are read (`fetch`) has `io` asked for each segment of a
+ * staged manifest before it is read ({@link UnitIO.segment}).
+ *
+ * @example
+ * ```ts
+ * const io = new InMemoryUnitIO(files);  // the unit and every file it names
+ * const unit = decodeBeast2For(UnitType)(io.read("unit.beast2"));
+ * const result = await executeUnit(unit, io, { platforms: (name) => packages.get(name)! });
+ * if (result.outcome.type === "ok") io.files.get("output.beast2");  // the output
+ * ```
+ */
+export async function executeUnit(unit, io, options) {
+    configureFramePool({ workers: Number(unit.threads) });
+    const timings = { load: 0, compile: 0, execute: 0, output: 0 };
+    let mark = performance.now();
+    const lap = (phase) => {
+        const now = performance.now();
+        timings[phase] += now - mark;
+        mark = now;
+    };
+    let outcome;
+    try {
+        const platforms = [];
+        for (const name of unit.platforms)
+            platforms.push(...await options.platforms(name));
+        const host = { io, platforms, fetch: unit.fetch, resident: options.resident, cacheBytes: options.cacheBytes, report: options.report, lap };
+        if (unit.work.type === "run") {
+            await runWork(unit.work.value, host);
+        }
+        else if (unit.work.type === "merge") {
+            mergeWork(unit.work.value, host);
+        }
+        else {
+            intakeWork(unit.work.value, host);
+        }
+        outcome = variant("ok", null);
+    }
+    catch (err) {
+        outcome = err instanceof EastError
+            ? variant("failed", { message: err.eastMessage, locations: err.location })
+            : variant("failed", { message: err?.message ?? String(err), locations: [] });
+    }
+    return { outcome, peakBytes: options.peakBytes?.() ?? 0n, timings };
+}
+/** Runs a program on its inputs and writes what it produces. */
+async function runWork(work, host) {
+    const { io, platforms, report, lap } = host;
+    const program = loadUnitProgram(io, work.program);
+    const signature = program.ir.value.type.value;
+    // Every kind but a value is emitted, through the trailing parameter.
+    const emitted = work.output.type !== "value";
+    if (emitted && signature.inputs.length === 0) {
+        throw new Error(`exec: a ${work.output.type} output is emitted: the program's trailing parameter must be emit, a function`);
+    }
+    const params = emitted ? signature.inputs.slice(0, -1) : signature.inputs;
+    if (work.inputs.length !== params.length) {
+        const printed = `(${signature.inputs.map((type) => printTypeValue(type)).join(", ")}) -> ${printTypeValue(signature.output)}`;
+        throw new Error(`Function expects ${params.length} inputs, got ${work.inputs.length}\nSignature: ${printed}`);
+    }
+    // Inputs are frozen: each collection opened lazily, or every input decoded
+    // whole, as the unit's `decode` says.
+    report?.running(work.program, work.inputs.map((path, i) => ({ path, type: params[i] })));
+    const inputs = openUnitInputs(io, work.inputs, params, work.decode, {
+        fetch: host.fetch,
+        ...(host.resident !== undefined && { resident: host.resident }),
+        ...(host.cacheBytes !== undefined && { cacheBytes: host.cacheBytes }),
+        ...(report !== undefined && { report }),
+    });
+    lap("load");
+    const compiled = program.compile(platforms);
+    const output = openOutput(work.output, emitted ? signature.inputs.at(-1) : signature.output, host);
+    lap("compile");
+    try {
+        const result = await compiled(...inputs, ...(output.emit !== undefined ? [output.emit] : []));
+        lap("execute");
+        output.finish(result);
+        lap("output");
+    }
+    finally {
+        // What reading each lazy input came to, the output's writing included —
+        // or up to the failure.
+        if (report !== undefined) {
+            inputs.forEach((input, i) => {
+                const read = lazyInputBytesRead(input);
+                const stats = beast2LazyStats(input);
+                if (read !== undefined && stats !== undefined)
+                    report.lazyReads(i, work.inputs[i], stats, read);
+            });
+        }
+    }
+}
+/**
+ * Opens a running program's output.
+ *
+ * @param output - the output
+ * @param type - the program's result type, for a value; its emit parameter's
+ *   type otherwise
+ * @param host - the unit's files, and the platforms a fold's functions
+ *   compile with
+ * @returns the sink
+ * @throws {Error} When the emit parameter does not fit the kind, a fold's
+ *   function does not fit the emitted type, or an output directory holds
+ *   anything already.
+ */
+function openOutput(output, type, host) {
+    const { io, platforms } = host;
+    if (output.type === "value") {
+        const path = output.value;
+        return { finish: (result) => writeValue(io, path, type, result) };
+    }
+    const arity = output.type === "dict" ? 2 : 1;
+    const emitInputs = type.type === "Function" ? type.value.inputs : null;
+    if (emitInputs === null || emitInputs.length !== arity) {
+        throw new Error(`exec: a ${output.type} output is emitted: the program's trailing parameter must be emit, a function of ${arity} argument${arity === 1 ? "" : "s"}, got ${printTypeValue(type)}`);
+    }
+    const element = emitInputs[0];
+    switch (output.type) {
+        case "array": {
+            const writer = new Beast2ManifestWriter(variant("Array", element), manifestDirectory(io, `${outputDirectory(io, output.value)}/0.beast2`), { parallel: true });
+            return {
+                emit: (value) => { writer.add(value); return null; },
+                finish: () => writer.finish(),
+            };
+        }
+        case "set": {
+            const dir = outputDirectory(io, output.value);
+            const sorter = new Beast2RunSorter(variant("Set", element), (run) => manifestDirectory(io, `${dir}/${run}.beast2`), { union: true, parallel: true });
+            return {
+                emit: (value) => { sorter.add(value); return null; },
+                finish: () => sorter.finish(),
+            };
+        }
+        case "dict": {
+            const value = emitInputs[1];
+            const merge = output.value.merge.type === "some"
+                ? loadUnitMergeFunction(io, output.value.merge.value, element, value, platforms, "the emit parameter")
+                : undefined;
+            const dir = outputDirectory(io, output.value.dir);
+            const sorter = new Beast2RunSorter(variant("Dict", { key: element, value }), (run) => manifestDirectory(io, `${dir}/${run}.beast2`), { ...(merge !== undefined && { merge }), parallel: true });
+            return {
+                emit: (key, entry) => { sorter.add([key, entry]); return null; },
+                finish: () => sorter.finish(),
+            };
+        }
+        case "fold": {
+            const { combine } = loadCombineFunction(io, output.value.combine, element, platforms);
+            const path = output.value.path;
+            let acc = loadUnitInput(io, output.value.zero, element, host.fetch);
+            return {
+                emit: (value) => { acc = combine(acc, value); return null; },
+                finish: () => writeValue(io, path, element, acc),
+            };
+        }
+    }
+}
+/** Assembles the parts of one output into one. */
+function mergeWork(work, host) {
+    const { io, platforms, lap } = host;
+    const output = work.output;
+    switch (output.type) {
+        case "set":
+        case "dict": {
+            const dir = outputDirectory(io, output.type === "set" ? output.value : output.value.dir);
+            lap("load");
+            mergeUnitParts(io, work.parts, manifestDirectory(io, `${dir}/0.beast2`), {
+                union: output.type === "set",
+                ...(output.type === "dict" && output.value.merge.type === "some" && { merge: output.value.merge.value }),
+                ...(work.range.type === "some" && { range: work.range.value }),
+                platforms,
+                fetch: host.fetch,
+            });
+            lap("execute");
+            return;
+        }
+        case "fold": {
+            const { combine, type } = loadCombineFunction(io, output.value.combine, null, platforms);
+            let acc = loadUnitInput(io, output.value.zero, type, host.fetch);
+            lap("compile");
+            for (const part of work.parts)
+                acc = combine(acc, loadUnitInput(io, part, type, host.fetch));
+            lap("execute");
+            writeValue(io, output.value.path, type, acc);
+            lap("output");
+            return;
+        }
+        case "array":
+            throw new Error("exec: an array's parts are concatenated, never merged: a merge unit takes set, dict or fold parts");
+        case "value":
+            throw new Error("exec: a value has no parts: a merge unit takes set, dict or fold parts");
+    }
+}
+/**
+ * Takes a delivered collection in: the file read a segment at a time, through
+ * ranged reads, and written through the Writer as the manifest directory the
+ * unit names.
+ *
+ * @throws {Error} When the type file does not hold a type, the delivery cannot
+ *   be read, or the intake refuses it — every refusal in the words each runner
+ *   uses.
+ */
+function intakeWork(work, host) {
+    const { io, lap } = host;
+    let type;
+    try {
+        type = decodeBeast2For(EastTypeValueType)(io.read(work.type));
+    }
+    catch {
+        throw new Error("exec: intake: its type file does not hold a type");
+    }
+    const intake = intakeBeast2For(type);
+    const delivery = {
+        size: io.size(work.input),
+        read: (offset, length) => io.readRange(work.input, offset, length),
+    };
+    lap("load");
+    const segments = work.segments.type === "some"
+        ? { segments: { from: Number(work.segments.value.from), to: Number(work.segments.value.to) } }
+        : {};
+    intake(delivery, manifestDirectory(io, work.output), { ...segments, parallel: true });
+    lap("execute");
+}
+/**
+ * Loads a fold's `combine`: an IR file holding a `(T, T) -> T` East function,
+ * compiled with the unit's platforms.
+ *
+ * @param io - the unit's files
+ * @param path - the IR file
+ * @param type - the emitted type, or `null` to take `T` from the function —
+ *   a merge of fold partials has no program to say what was emitted
+ * @param platforms - the unit's platform functions
+ * @returns the compiled function, and `T`
+ * @throws {Error} When the IR is not a function of that shape.
+ */
+function loadCombineFunction(io, path, type, platforms) {
+    const bundle = loadUnitProgram(io, path);
+    const fnType = bundle.ir.value.type;
+    const shape = fnType.type === "Function" ? fnType.value : null;
+    const t = type ?? shape?.output;
+    if (shape === null || t === undefined || shape.inputs.length !== 2 ||
+        !isTypeValueEqual(shape.inputs[0], t) ||
+        !isTypeValueEqual(shape.inputs[1], t) ||
+        !isTypeValueEqual(shape.output, t)) {
+        const expected = t !== undefined ? ` (T = ${printTypeValue(t)})` : "";
+        throw new Error(`exec: combine: expected a function (T, T) -> T${expected}, got ${printTypeValue(fnType)}`);
+    }
+    return { combine: bundle.compile(platforms), type: t };
+}
+/**
+ * Writes a value output: a collection as a manifest directory at `path`,
+ * anything else as one blob there.
+ *
+ * @param io - the unit's files
+ * @param path - the output's file
+ * @param type - the value's type
+ * @param value - the value
+ */
+function writeValue(io, path, type, value) {
+    if (type.type !== "Array" && type.type !== "Set" && type.type !== "Dict") {
+        io.write(path, encodeBeast2For(type)(value));
+        return;
+    }
+    // A collection goes in canonical order: a Set or Dict an East program
+    // built is sorted already, and a plain one is sorted first.
+    const key = (type.type === "Dict" ? type.value.key : type.value);
+    const cmp = compareFor(key);
+    const elements = type.type === "Array" ? value
+        : type.type === "Set" ? (value instanceof SortedSet ? value : [...value].sort(cmp))
+            : value instanceof SortedMap ? value.entries() : [...value.entries()].sort((a, b) => cmp(a[0], b[0]));
+    const writer = new Beast2ManifestWriter(type, manifestDirectory(io, path), { parallel: true });
+    for (const element of elements)
+        writer.add(element);
+    writer.finish();
+}
+/**
+ * The sink a manifest directory is written through: the manifest at `path`,
+ * written last, and every object it names in `<path>.segments/` under its
+ * SHA-256 — the layout a store takes in by linking, and every runner's opener
+ * reads.
+ *
+ * @param io - the unit's files
+ * @param path - the manifest's file
+ * @returns the sink
+ */
+function manifestDirectory(io, path) {
+    let made = false;
+    return {
+        object: (hash, bytes) => {
+            if (!made) {
+                io.makeDirectory(`${path}.segments`);
+                made = true;
+            }
+            io.write(segmentPath(path, hash), bytes);
+        },
+        manifest: (bytes) => io.write(path, bytes),
+    };
+}
+/**
+ * Makes an output directory of runs, which must hold nothing yet: every
+ * manifest in it is one of the unit's runs.
+ *
+ * @param io - the unit's files
+ * @param dir - the directory
+ * @returns the directory
+ * @throws {Error} When it holds anything already.
+ */
+function outputDirectory(io, dir) {
+    io.makeDirectory(dir);
+    if (io.list(dir).length > 0)
+        throw new Error(`exec: the output directory ${dir} is not empty`);
+    return dir;
+}
+//# sourceMappingURL=runner_exec.js.map

package/dist/src/runner_exec.js.map

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

package/dist/src/runner_exec.spec.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+export {};
+//# sourceMappingURL=runner_exec.spec.d.ts.map

package/dist/src/runner_exec.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner_exec.spec.d.ts","sourceRoot":"","sources":["../../src/runner_exec.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/runner_exec.spec.js

@@ -0,0 +1,198 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `executeUnit` and what it asks of its host: the platform functions of each
+ * package a unit lists, the host's memory gauges, who hears how a run unit's
+ * inputs are read, and the segments a unit whose host places them as they are
+ * read asks for. What a unit's work comes to — its outputs and outcome, byte
+ * for byte — the runner corpus holds it to (`test/runner_corpus.spec.ts`).
+ */
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { DictType, IntegerType, StringType, East, InMemoryUnitIO, UnitOutcomeType, Beast2ManifestWriter, decodeBeast2For, decodeCollectionManifest, encodeBeast2For, encodeEastIR, equalFor, executeUnit, isTypeValueEqual, none, printFor, toEastTypeValue, variant, } from "./index.js";
+const DT = DictType(IntegerType, StringType);
+/** An outcome as a message shows it. */
+const printOutcome = printFor(UnitOutcomeType);
+/** A unit's files: a Dict staged as e3 stages one, as `table.beast2` and the
+ *  segments beside it, and whatever else is given. */
+function staged(rows, others = []) {
+    const files = new Map(others);
+    const writer = new Beast2ManifestWriter(DT, {
+        object: (hash, blob) => { files.set(`table.beast2.segments/${hash}.beast2`, blob.slice()); },
+        manifest: (blob) => { files.set("table.beast2", blob.slice()); },
+    });
+    for (let i = 0; i < rows; i++)
+        writer.add([BigInt(i), `row-${i}`]);
+    writer.finish();
+    return files;
+}
+/** A run unit over `inputs`, its output a value. */
+function runUnit(inputs, options = {}) {
+    return {
+        work: variant("run", {
+            program: "program.beast2",
+            inputs,
+            output: variant("value", "out.beast2"),
+            decode: options.decode === "whole" ? variant("whole", null) : variant("lazy", null),
+        }),
+        platforms: options.platforms ?? [],
+        threads: 1n,
+        fetch: options.fetch ?? false,
+        result: "result.beast2",
+    };
+}
+/** A resolver for units that list no platform package. */
+const noPackages = (name) => {
+    throw new Error(`no platform package ${name} here`);
+};
+/** An IO that records every segment it is asked to make there. */
+class AskedIO extends InMemoryUnitIO {
+    asked = [];
+    segment(path, fetch) {
+        this.asked.push([path, fetch]);
+        super.segment(path, fetch);
+    }
+}
+describe("executeUnit", () => {
+    it("resolves each platform package the unit lists, once and in order, and runs the program with their functions", async () => {
+        const double = East.platform("exec_spec_double", [IntegerType], IntegerType);
+        const inc = East.platform("exec_spec_inc", [IntegerType], IntegerType);
+        const program = East.function([IntegerType], IntegerType, ($, x) => inc(double(x)));
+        const io = new InMemoryUnitIO([
+            ["program.beast2", encodeEastIR(program.toIR())],
+            ["x.beast2", encodeBeast2For(IntegerType)(7n)],
+        ]);
+        const resolved = [];
+        const result = await executeUnit(runUnit(["x.beast2"], { platforms: ["pkg-double", "pkg-inc"] }), io, {
+            platforms: (name) => {
+                resolved.push(name);
+                // A host may resolve a package at once, or later.
+                return name === "pkg-double"
+                    ? [double.implement((x) => x * 2n)]
+                    : Promise.resolve([inc.implement((x) => x + 1n)]);
+            },
+        });
+        assert.ok(equalFor(UnitOutcomeType)(result.outcome, variant("ok", null)), printOutcome(result.outcome));
+        assert.deepEqual(resolved, ["pkg-double", "pkg-inc"]);
+        assert.equal(decodeBeast2For(IntegerType)(io.read("out.beast2")), 15n);
+    });
+    it("fails a unit whose package its host cannot resolve, in the host's words, before any work", async () => {
+        // The program the unit names is not there: the resolver's refusal comes
+        // first, so its words are the outcome's.
+        const io = new InMemoryUnitIO([["x.beast2", encodeBeast2For(IntegerType)(7n)]]);
+        const result = await executeUnit(runUnit(["x.beast2"], { platforms: ["pkg-missing"] }), io, { platforms: noPackages });
+        assert.ok(equalFor(UnitOutcomeType)(result.outcome, variant("failed", { message: "no platform package pkg-missing here", locations: [] })), printOutcome(result.outcome));
+        assert.deepEqual([...io.files.keys()], ["x.beast2"], "nothing is written");
+    });
+    it("tells its report how a run unit reads its inputs, and weighs them by the host's gauges", async () => {
+        const program = East.function([DT, IntegerType], StringType, ($, table, key) => table.get(key));
+        const io = new InMemoryUnitIO(staged(20_000, [
+            ["program.beast2", encodeEastIR(program.toIR())],
+            ["x.beast2", encodeBeast2For(IntegerType)(123n)],
+        ]));
+        const segments = decodeCollectionManifest(io.read("table.beast2")).entries.length;
+        const heard = [];
+        let inputTypes = [];
+        const report = {
+            running: (path, inputs) => {
+                heard.push(["running", path, inputs.map((input) => input.path)]);
+                inputTypes = inputs.map((input) => input.type);
+            },
+            openedLazily: (i) => { heard.push(["lazily", i]); },
+            decodedWhole: (i, grown) => { heard.push(["whole", i, grown]); },
+            lazyReads: (i, path, stats, read) => { heard.push(["reads", i, path, stats, read > 0]); },
+        };
+        let gauge = 1_000;
+        const result = await executeUnit(runUnit(["table.beast2", "x.beast2"]), io, {
+            platforms: noPackages,
+            resident: () => (gauge += 10),
+            peakBytes: () => 42n,
+            report,
+        });
+        assert.ok(equalFor(UnitOutcomeType)(result.outcome, variant("ok", null)), printOutcome(result.outcome));
+        assert.equal(decodeBeast2For(StringType)(io.read("out.beast2")), "row-123");
+        assert.equal(result.peakBytes, 42n, "the peak is the host's gauge's");
+        assert.deepEqual(heard, [
+            ["running", "program.beast2", ["table.beast2", "x.beast2"]],
+            ["lazily", 0],
+            ["whole", 1, 10],
+            ["reads", 0, "table.beast2", { segments, segmentsDecoded: 1, fencesProbed: segments, hydrated: false, hydratedBytes: 0 }, true],
+        ], "the collection opened lazily, and its one keyed read decoded one segment; the Integer decoded whole, weighed by the gauge");
+        assert.equal(inputTypes.length, 2);
+        assert.ok(isTypeValueEqual(inputTypes[0], toEastTypeValue(DT)), "the table is read as its parameter's type");
+        assert.ok(isTypeValueEqual(inputTypes[1], toEastTypeValue(IntegerType)), "the key is read as its parameter's type");
+    });
+    it("gives each lazily opened input's pager the decoded weight its host keeps", async () => {
+        // Keyed reads that cycle over three segments far apart, so no run of reads
+        // in key order forms: kept, each segment decodes once; at a budget of 1,
+        // every read decodes its segment again.
+        const program = East.function([DT], IntegerType, ($, table) => {
+            const hits = $.let(0n);
+            $.for(East.Array.range(0n, 30n), ($, i) => {
+                $.if(table.has(i.remainder(3n).multiply(9000n)), ($) => {
+                    $.assign(hits, hits.add(1n));
+                });
+            });
+            return hits;
+        });
+        for (const [cacheBytes, decodes] of [[1, 30], [undefined, 3]]) {
+            const io = new InMemoryUnitIO(staged(20_000, [["program.beast2", encodeEastIR(program.toIR())]]));
+            let stats;
+            const report = {
+                running: () => { },
+                openedLazily: () => { },
+                decodedWhole: () => { },
+                lazyReads: (_i, _path, read) => { stats = read; },
+            };
+            const result = await executeUnit(runUnit(["table.beast2"]), io, {
+                platforms: noPackages,
+                report,
+                ...(cacheBytes !== undefined && { cacheBytes }),
+            });
+            assert.ok(equalFor(UnitOutcomeType)(result.outcome, variant("ok", null)), printOutcome(result.outcome));
+            assert.equal(decodeBeast2For(IntegerType)(io.read("out.beast2")), 30n);
+            assert.equal(stats?.segmentsDecoded, decodes, `at a budget of ${cacheBytes ?? "256 MiB"}`);
+        }
+    });
+    it("measures nothing its host gives it no gauge for", async () => {
+        const io = new InMemoryUnitIO([["program.beast2", encodeEastIR(East.function([], IntegerType, (_$) => 1n).toIR())]]);
+        const result = await executeUnit(runUnit([]), io, { platforms: noPackages });
+        assert.ok(equalFor(UnitOutcomeType)(result.outcome, variant("ok", null)), printOutcome(result.outcome));
+        assert.equal(result.peakBytes, 0n, "a host that does not measure memory reports no peak");
+        for (const phase of ["load", "compile", "execute", "output"])
+            assert.ok(result.timings[phase] >= 0, phase);
+    });
+    it("asks its IO for each segment a unit reads, saying whether the unit's host places them as they are read", async () => {
+        const program = East.function([DT], StringType, ($, table) => table.get(9999n));
+        const files = staged(20_000, [["program.beast2", encodeEastIR(program.toIR())]]);
+        const segments = decodeCollectionManifest(files.get("table.beast2")).entries.map((entry) => `table.beast2.segments/${entry.hash}.beast2`);
+        assert.ok(segments.length > 2, `several segments, got ${segments.length}`);
+        // Lazily, one keyed read reads one segment.
+        const lazy = new AskedIO(files);
+        const fetched = await executeUnit(runUnit(["table.beast2"], { fetch: true }), lazy, { platforms: noPackages });
+        assert.ok(equalFor(UnitOutcomeType)(fetched.outcome, variant("ok", null)), printOutcome(fetched.outcome));
+        assert.equal(lazy.asked.length, 1, `one segment asked for: ${JSON.stringify(lazy.asked)}`);
+        assert.ok(segments.includes(lazy.asked[0][0]) && lazy.asked[0][1], "a segment the manifest names, asked of a host that places them");
+        // Decoded whole, every segment is read, and the unit's host places none.
+        const whole = new AskedIO(files);
+        const decoded = await executeUnit(runUnit(["table.beast2"], { decode: "whole" }), whole, { platforms: noPackages });
+        assert.ok(equalFor(UnitOutcomeType)(decoded.outcome, variant("ok", null)), printOutcome(decoded.outcome));
+        assert.deepEqual(whole.asked, segments.map((path) => [path, false]));
+    });
+    it("refuses an output directory that holds anything already", async () => {
+        const io = new InMemoryUnitIO([["out/stale.beast2", new Uint8Array([1])]]);
+        const unit = {
+            work: variant("merge", { parts: ["part.beast2"], range: none, output: variant("set", "out") }),
+            platforms: [],
+            threads: 1n,
+            fetch: false,
+            result: "result.beast2",
+        };
+        const result = await executeUnit(unit, io, { platforms: noPackages });
+        assert.ok(equalFor(UnitOutcomeType)(result.outcome, variant("failed", { message: "exec: the output directory out is not empty", locations: [] })), printOutcome(result.outcome));
+        assert.deepEqual([...io.files.keys()], ["out/stale.beast2"], "nothing is written");
+    });
+});
+//# sourceMappingURL=runner_exec.spec.js.map

package/dist/src/runner_exec.spec.js.map

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