@elaraai/e3-rack 0.0.0-bootstrap.0 → 1.0.94

package/dist/src/runner/split.spec.js

@@ -0,0 +1,188 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { afterEach, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { setTimeout as delay } from 'node:timers/promises';
+import { ArrayType, East, IntegerType, StringType, some } from '@elaraai/east';
+import e3 from '@elaraai/e3';
+import { Budget, LocalStorage, LocalTaskRunner, datasetWrite, inputsHash, packageImport, packageRead, repoInit } from '@elaraai/e3-core';
+import { RackHub } from '../hub/hub.js';
+import { defaultHubConfig, saveHubConfig } from '../hub/config.js';
+import { HubClient } from '../client/hub-client.js';
+import { connectHub } from '../client/connect.js';
+import { TestRackAgent } from '../testing/test-rack-agent.js';
+import { DEFAULT_RACK_POLICY, setMode } from '../routing/policy.js';
+import { openRackRunner } from './rack-runner.js';
+const cleanup = [];
+afterEach(async () => { for (const close of cleanup.splice(0).reverse())
+    await close(); });
+async function fixture(background = false) {
+    const home = await mkdtemp(join(tmpdir(), 'e3s-'));
+    cleanup.push(() => rm(home, { recursive: true, force: true }));
+    await saveHubConfig({ ...defaultHubConfig(), listen: some({ host: '127.0.0.1', port: 0n }) }, home);
+    const client = new HubClient(home);
+    if (background) {
+        await connectHub({ home });
+        cleanup.push(() => client.stop().catch(() => { }));
+    }
+    else {
+        const hub = new RackHub({ foreground: true, home });
+        assert(await hub.start());
+        cleanup.push(() => hub.stop());
+    }
+    const mint = await client.enroll();
+    const agent = await TestRackAgent.enroll(mint.apiUrl, mint.enrollmentToken, { tiers: ['node', 'py'], certificateSha256: mint.certificateSha256.type === 'some' ? mint.certificateSha256.value : undefined });
+    cleanup.push(() => agent.close());
+    const repo = join(home, 'repo');
+    assert(repoInit(repo).success);
+    const storage = new LocalStorage();
+    const budget = new Budget({ cores: 2, memory: 1024 ** 3 }, { sampler: null });
+    const placements = [];
+    const rack = await openRackRunner({ repoPath: repo, workspace: 'dev', storage, label: 'split test', home, budget,
+        policy: setMode(DEFAULT_RACK_POLICY, 'auto'), rackOnly: true, waitForRackMs: 0, onPlacement: (event) => { placements.push(event); } });
+    cleanup.push(() => rack.close());
+    return { home, client, agent, repo, storage, rack, budget, placements };
+}
+for (const kind of ['array', 'set', 'dict', 'fold'])
+    it(`delegates split ${kind} pieces and merges, keeping planning and the logical record local`, async () => {
+        const original = process.env.E3_TEST_PIECE_BYTES;
+        process.env.E3_TEST_PIECE_BYTES = '64';
+        cleanup.push(() => { if (original === undefined)
+            delete process.env.E3_TEST_PIECE_BYTES;
+        else
+            process.env.E3_TEST_PIECE_BYTES = original; return Promise.resolve(); });
+        const f = await fixture();
+        const type = ArrayType(IntegerType);
+        const input = e3.input('rows', type);
+        const task = kind === 'array'
+            ? e3.streamTask('split', { inputs: [e3.partition(input)], output: e3.output.array(IntegerType) }, ($, rows, emit) => { $.for(rows, ($, row) => { $(emit(row)); }); })
+            : kind === 'set'
+                ? e3.streamTask('split', { inputs: [e3.partition(input)], output: e3.output.set(IntegerType) }, ($, rows, emit) => { $.for(rows, ($, row) => { $(emit(row)); }); })
+                : kind === 'dict'
+                    ? e3.streamTask('split', { inputs: [e3.partition(input)], output: e3.output.dict(IntegerType, IntegerType, { merge: (_$, _key, a, b) => a.add(b) }) }, ($, rows, emit) => { $.for(rows, ($, row) => { $(emit(0n, row)); }); })
+                    : e3.streamTask('split', { inputs: [e3.partition(input)], output: e3.output.fold(IntegerType, { zero: 0n, combine: (_$, a, b) => a.add(b) }) }, ($, rows, emit) => { $.for(rows, ($, row) => { $(emit(row)); }); });
+        const zip = join(f.home, 'split.zip');
+        await e3.export(e3.package('split', '1.0.0', task), zip);
+        await packageImport(f.storage, f.repo, zip);
+        const hash = (await packageRead(f.storage, f.repo, 'split', '1.0.0')).tasks.get('split');
+        const inputs = [await datasetWrite(f.storage, f.repo, Array.from({ length: 8000 }, (_, i) => BigInt(i)), type)];
+        const events = [];
+        let ended = false;
+        const pump = async () => {
+            while (!ended) {
+                if (Number((await f.client.status()).capacity.queued) === 0) {
+                    await delay(10);
+                    continue;
+                }
+                const grant = await f.agent.claim();
+                assert(grant);
+                events.push(JSON.parse(grant.eventJson));
+                assert.equal(f.budget.inFlight, 0);
+                const result = await f.agent.execute(grant);
+                assert.equal(result.status, 'success', result.error);
+            }
+        };
+        const agentLoop = pump();
+        const [remote] = await Promise.all([
+            f.rack.runner.execute(f.storage, hash, inputs, { taskName: 'split' }).finally(() => { ended = true; }),
+            agentLoop,
+        ]);
+        assert.equal(remote.state, 'success', remote.error);
+        assert.equal(f.budget.peak, 0);
+        assert(events.length > 1);
+        assert(events.every((event) => event.runnerEvent.mode === 'unit'));
+        if (kind === 'fold' || kind === 'dict')
+            assert(events.some((event) => event.runnerEvent.mode === 'unit' && event.runnerEvent.unit.merge !== null));
+        const record = await f.storage.refs.executionGet(f.repo, hash, inputsHash(inputs), remote.executionId);
+        assert(record?.type === 'success' && !record.value.unit);
+        if (kind === 'fold') {
+            // Keep every successful map in cache, but remove the merge and logical
+            // records: a resumed run must delegate only its missing merge bodies.
+            for (const event of events) {
+                if (event.runnerEvent.mode !== 'unit' || event.runnerEvent.unit.merge === null)
+                    continue;
+                const inHash = inputsHash([...event.runnerEvent.unit.inputs]);
+                for (const id of await f.storage.refs.executionListIds(f.repo, hash, inHash)) {
+                    await f.storage.refs.executionDelete(f.repo, hash, inHash, id);
+                }
+            }
+            await f.storage.refs.executionDelete(f.repo, hash, inputsHash(inputs), remote.executionId);
+            events.length = 0;
+            ended = false;
+            const resumedRun = f.rack.runner.execute(f.storage, hash, inputs, { taskName: 'split' }).finally(() => { ended = true; });
+            const [resumed] = await Promise.all([resumedRun, pump()]);
+            assert.equal(resumed.state, 'success', resumed.error);
+            assert.equal(resumed.outputHash, remote.outputHash);
+            assert(events.length > 0);
+            assert(events.every((event) => event.runnerEvent.mode === 'unit' && event.runnerEvent.unit.merge !== null));
+        }
+        const local = await new LocalTaskRunner(f.repo, f.budget).execute(f.storage, hash, inputs, { force: true });
+        assert.equal(local.state, 'success', local.error);
+        assert.equal(local.outputHash, remote.outputHash);
+        assert(f.placements.every((placement) => placement.where === 'rack' && placement.role === 'unit'));
+    });
+it('executes an east-py task through the same rack wire', { skip: spawnSync('east-py', ['--version']).error !== undefined }, async () => {
+    const f = await fixture();
+    const input = e3.input('python_text', StringType);
+    const task = e3.task('python', [input], East.function([StringType], IntegerType, (_$, text) => text.length()), { runner: { runtime: 'east-py' } });
+    const zip = join(f.home, 'python.zip');
+    await e3.export(e3.package('python', '1.0.0', task), zip);
+    await packageImport(f.storage, f.repo, zip);
+    const hash = (await packageRead(f.storage, f.repo, 'python', '1.0.0')).tasks.get('python');
+    const inputs = [await datasetWrite(f.storage, f.repo, 'python on the rack', StringType)];
+    const running = f.rack.runner.execute(f.storage, hash, inputs, { taskName: 'python' });
+    assert.equal((await f.agent.runOne())?.status, 'success');
+    const remote = await running;
+    assert.equal(remote.state, 'success', remote.error);
+    const local = await new LocalTaskRunner(f.repo).execute(f.storage, hash, inputs, { force: true });
+    assert.equal(local.outputHash, remote.outputHash);
+    assert.equal(f.budget.peak, 0);
+});
+it('finishes locally when the actual hub process is killed during a claimed task', async () => {
+    const f = await fixture(true);
+    const input = e3.input('crash_text', StringType);
+    const task = e3.task('length', [input], East.function([StringType], IntegerType, (_$, text) => text.length()));
+    const zip = join(f.home, 'crash.zip');
+    await e3.export(e3.package('crash', '1.0.0', task), zip);
+    await packageImport(f.storage, f.repo, zip);
+    const hash = (await packageRead(f.storage, f.repo, 'crash', '1.0.0')).tasks.get('length');
+    const inputs = [await datasetWrite(f.storage, f.repo, 'crash recovery', StringType)];
+    const running = f.rack.runner.execute(f.storage, hash, inputs, { taskName: 'length' });
+    assert(await f.agent.claim());
+    process.kill(Number((await f.client.hello()).pid), 'SIGKILL');
+    const result = await running;
+    assert.equal(result.state, 'success', result.error);
+    assert.equal(f.budget.peak, 1);
+    assert(f.placements.some((event) => event.where === 'local' && event.reason.includes('hub unreachable')));
+});
+it('delegates a split task with one owning unit and keeps its success as the logical record', async () => {
+    const f = await fixture();
+    const type = ArrayType(IntegerType);
+    const input = e3.input('small', type);
+    const task = e3.streamTask('small_split', { inputs: [e3.partition(input)], output: e3.output.array(IntegerType) }, ($, rows, emit) => { $.for(rows, ($, row) => { $(emit(row)); }); });
+    const zip = join(f.home, 'small.zip');
+    await e3.export(e3.package('small', '1.0.0', task), zip);
+    await packageImport(f.storage, f.repo, zip);
+    const hash = (await packageRead(f.storage, f.repo, 'small', '1.0.0')).tasks.get('small_split');
+    const inputs = [await datasetWrite(f.storage, f.repo, [1n, 2n], type)];
+    const running = f.rack.runner.execute(f.storage, hash, inputs, { taskName: 'small_split' });
+    const lease = await f.agent.claim();
+    assert(lease);
+    const event = JSON.parse(lease.eventJson);
+    assert(event.runnerEvent.mode === 'unit');
+    assert.equal(event.runnerEvent.unit.own, true);
+    await f.agent.execute(lease);
+    const result = await running;
+    assert.equal(result.state, 'success', result.error);
+    const record = await f.storage.refs.executionGet(f.repo, hash, inputsHash(inputs), result.executionId);
+    assert(record?.type === 'success' && !record.value.unit);
+    assert.equal(f.budget.peak, 0);
+    assert.equal((await f.rack.runner.execute(f.storage, hash, inputs, { taskName: 'small_split' })).cached, true);
+});
+//# sourceMappingURL=split.spec.js.map

package/dist/src/runner/split.spec.js.map

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

package/dist/src/runner-event.d.ts

@@ -0,0 +1,261 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type DetachedResult, type DetachedSpec, type IntakeResult, type IntakeSpec, type SplitUnit, type TaskResult } from '@elaraai/e3-core';
+/**
+ * A unit of a split task, whole (e3-core's `SplitUnit`): its inputs as its
+ * record names them, what a merge unit merges, and whether it is its task's
+ * own execution. e3-core records a unit with `unit: !own`, so a wire that
+ * dropped `own` would hide the one run of a task whose input closes no piece
+ * from the task's history.
+ */
+export interface SplitUnitWire {
+    /** The unit's inputs, as its execution records them */
+    readonly inputs: readonly string[];
+    /** What a merge unit merges: the parts, in piece order, and the hash of the
+     *  key range the merge is limited to, or `null` to merge them whole; `null`
+     *  for a piece */
+    readonly merge: {
+        readonly parts: readonly string[];
+        readonly range: string | null;
+    } | null;
+    /** Whether the unit is its task's own execution */
+    readonly own: boolean;
+}
+/**
+ * A detached call (e3-core's `DetachedSpec`). The program and each value
+ * argument are base64; a stored dataset argument is `{dataset}`, the hash of
+ * the object its ref names, which the container stages from the store.
+ */
+export interface DetachedSpecWire {
+    /** The program, base64 */
+    readonly bodyIr: string;
+    /** The arguments, in order: a value's beast2 bytes as base64, or a stored dataset */
+    readonly args: readonly (string | {
+        readonly dataset: string;
+    })[];
+    /** The runner, in East's JSON encoding of `RunnerType` */
+    readonly runner: unknown;
+    /** The call's limits */
+    readonly limits: {
+        readonly timeoutMs: number;
+        readonly maxResultBytes: number;
+        readonly maxLogBytes: number;
+    };
+    /** The environment spec object the call runs in, when it declares one */
+    readonly environment?: string;
+}
+/**
+ * An intake of a delivery the store holds (e3-core's `IntakeSpec` with an
+ * `{object}` source): a runner container reads a delivery from the store,
+ * never from another host's files.
+ */
+export interface IntakeSpecWire {
+    /** The delivery: the hash of the object it is stored as */
+    readonly object: string;
+    /** The collection type its header must name, in East's JSON encoding of `EastTypeType` */
+    readonly type: unknown;
+    /** The delivery's segments `[from, to)` to take in, by its index; absent, the whole delivery */
+    readonly segments?: {
+        readonly from: number;
+        readonly to: number;
+    };
+}
+/**
+ * The run a task or a unit is part of, when a dataflow launched it: a cancel
+ * requested of the run, or its end, stops the execution.
+ */
+export interface RunnerRun {
+    /** The run's workspace */
+    readonly workspace: string;
+    /** The run's id, a UUIDv7 */
+    readonly id: string;
+}
+/** What every runner event carries. */
+interface RunnerEventBase {
+    /** The launch's id, a UUIDv7 the launcher minted: the container stamps it on
+     *  the `running` records it writes */
+    readonly launchId: string;
+    /** The repository */
+    readonly repo: string;
+    /** The longest the call may run, in ms: the container caps it at the time
+     *  it has left */
+    readonly timeoutMs: number;
+}
+/** What a task and a unit event carry beyond the base. */
+interface RunnerExecutionFields {
+    /** The run the execution is part of, when a dataflow launched it */
+    readonly run?: RunnerRun;
+    /** The task object's hash */
+    readonly taskHash: string;
+    /** Run it even when the execution cache holds it */
+    readonly force?: boolean;
+    /** Pass `-v` to a stock runner's `exec` */
+    readonly verbose?: boolean;
+    /** The memory, in bytes, the execution is expected to need */
+    readonly expectedPeakBytes?: number;
+    /** Why the execution runs where it does, which the container adds to the
+     *  end of the attempt's stderr log once e3-core has recorded it: a retry
+     *  after running out of memory, or a launch on Fargate (#206) */
+    readonly notice?: string;
+}
+/** A task over its inputs: e3-core's `taskExecute`. */
+export interface RunnerTaskEvent extends RunnerEventBase, RunnerExecutionFields {
+    readonly mode: 'task';
+    /** The task's input hashes, in the order its body takes them */
+    readonly inputHashes: readonly string[];
+}
+/** A unit of a split task, which its caller planned: e3-core's `taskExecuteUnit`. */
+export interface RunnerUnitEvent extends RunnerEventBase, RunnerExecutionFields {
+    readonly mode: 'unit';
+    /** The unit */
+    readonly unit: SplitUnitWire;
+}
+/** A function or one-shot call: e3-core's `runDetached`. */
+export interface RunnerDetachedEvent extends RunnerEventBase {
+    readonly mode: 'run-detached';
+    /** The call */
+    readonly spec: DetachedSpecWire;
+    /** Pass `-v` to a stock runner's `exec` */
+    readonly verbose?: boolean;
+    /**
+     * When the call must have answered by, in ms since the epoch: when it was
+     * made, plus its timeout (#209). A request waits on the call, so the time
+     * its runner function takes to start, and the container's staging, count
+     * against it: the container gives e3-core what is left, and answers
+     * `timed_out` at once when nothing is. Absent, the call's timeout counts
+     * from its runner's start. Only the cloud's own launches carry one: a
+     * rack's clock is not the cloud's, and the delegating runner keeps a leased
+     * call's deadline itself.
+     */
+    readonly deadline?: number;
+}
+/** An intake of a delivery, or of a run of its segments: e3-core's `runIntake`. */
+export interface RunnerIntakeEvent extends RunnerEventBase {
+    readonly mode: 'intake';
+    /** The intake */
+    readonly spec: IntakeSpecWire;
+}
+/** The runner event, v2. */
+export type RunnerEvent = RunnerTaskEvent | RunnerUnitEvent | RunnerDetachedEvent | RunnerIntakeEvent;
+/** A detached call's outcome (e3-core's `DetachedResult`), the value's bytes as base64. */
+export type RunnerDetachedResponse = (Omit<Extract<DetachedResult, {
+    kind: 'success';
+}>, 'value'> & {
+    readonly value: string;
+}) | Exclude<DetachedResult, {
+    kind: 'success';
+}>;
+/**
+ * An intake's outcome: what it stored (e3-core's `IntakeResult`), or the
+ * runner's refusal of the delivery, which the caller raises again as
+ * e3-core's `DeliveryRefusedError` ({@link intakeResultFromWire}).
+ */
+export type RunnerIntakeResponse = {
+    readonly kind: 'stored';
+    readonly hash: string;
+    readonly runner: string;
+    readonly fallback?: string;
+    readonly peakBytes?: number;
+} | {
+    readonly kind: 'refused';
+    readonly runner: string;
+    readonly refusal: string;
+    readonly stderr: string;
+    readonly delivery: string;
+};
+/**
+ * What a runner container answers: e3-core's `TaskResult` for a task or a
+ * unit, which is JSON as it stands; a detached call's and an intake's
+ * outcomes as above.
+ */
+export type RunnerResponse = TaskResult | RunnerDetachedResponse | RunnerIntakeResponse;
+/**
+ * A unit as the wire carries it.
+ *
+ * @param unit - The unit
+ * @returns Its wire form
+ */
+export declare function splitUnitToWire(unit: SplitUnit): SplitUnitWire;
+/**
+ * A unit, from the wire.
+ *
+ * @param wire - Its wire form
+ * @returns The unit
+ */
+export declare function splitUnitFromWire(wire: SplitUnitWire): SplitUnit;
+/**
+ * A detached call as the wire carries it.
+ *
+ * @param spec - The call
+ * @returns Its wire form
+ */
+export declare function detachedSpecToWire(spec: DetachedSpec): DetachedSpecWire;
+/**
+ * A detached call, from the wire.
+ *
+ * @param wire - Its wire form
+ * @returns The call
+ * @throws {RunnerEventError} When its runner does not decode as a `RunnerType`
+ */
+export declare function detachedSpecFromWire(wire: DetachedSpecWire): DetachedSpec;
+/**
+ * An intake as the wire carries it.
+ *
+ * @param spec - The intake: of a delivery the store holds
+ * @returns Its wire form
+ * @throws {Error} When the delivery is a file, which a runner container
+ *   cannot read
+ */
+export declare function intakeSpecToWire(spec: IntakeSpec): IntakeSpecWire;
+/**
+ * An intake, from the wire.
+ *
+ * @param wire - Its wire form
+ * @returns The intake
+ * @throws {RunnerEventError} When its type does not decode as an East type
+ */
+export declare function intakeSpecFromWire(wire: IntakeSpecWire): IntakeSpec;
+/**
+ * A detached call's outcome as the container answers it.
+ *
+ * @param result - The outcome
+ * @returns Its wire form
+ */
+export declare function detachedResultToWire(result: DetachedResult): RunnerDetachedResponse;
+/**
+ * A detached call's outcome, from the container's answer.
+ *
+ * @param response - The answer
+ * @returns The outcome
+ */
+export declare function detachedResultFromWire(response: RunnerDetachedResponse): DetachedResult;
+/**
+ * What an intake stored, from the container's answer.
+ *
+ * @param response - The answer
+ * @returns What the intake stored
+ * @throws {DeliveryRefusedError} When the runner refused the delivery
+ */
+export declare function intakeResultFromWire(response: RunnerIntakeResponse): IntakeResult;
+/** A runner event that does not read: what is wrong with it. */
+export declare class RunnerEventError extends Error {
+    /**
+     * @param problem - What is wrong with the event
+     */
+    constructor(problem: string);
+}
+/**
+ * Reads a runner event: the JSON value a container was handed, checked
+ * against the v2 shape.
+ *
+ * @param value - The event, parsed from its JSON
+ * @returns The event
+ * @throws {RunnerEventError} When it is not a v2 runner event: a v1 event
+ *   (which no launcher sends since elaraai/e3-cloud#205), an unknown mode, or
+ *   a field that is missing or of the wrong kind
+ */
+export declare function decodeRunnerEvent(value: unknown): RunnerEvent;
+export {};
+//# sourceMappingURL=runner-event.d.ts.map

package/dist/src/runner-event.d.ts.map

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