@elaraai/e3-types 1.0.79 → 1.0.80

package/dist/src/release.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The release of e3 this build is, and how two releases order.
+ *
+ * @remarks
+ * A release is the version the release scripts write into every package.
+ * `scripts/set-npm-version.mjs` writes it here with them, and
+ * `scripts/check-version-drift.mjs` refuses a tree where it differs from
+ * theirs. What e3 keeps or ships records the release that wrote it: a
+ * repository's record, an execution state and a package zip, and a transfer
+ * request the release that sent it, so a refusal of any of them names that
+ * release beside this one.
+ */
+/** The release of e3 this build is. */
+export declare const E3_RELEASE = "1.0.79";
+/**
+ * Orders two releases by semantic-version precedence.
+ *
+ * @remarks
+ * The core, `major.minor.patch`, orders numerically. A pre-release
+ * (`1.1.0-beta.2`) precedes the release of its core, and two pre-releases of
+ * one core order by their dot-separated identifiers in turn: numbers
+ * numerically and before words, words in ASCII order, and a list that is a
+ * prefix of the other first. Build metadata (`+…`) orders nothing.
+ *
+ * @param a - A release, such as `1.0.79` or `1.1.0-beta.2`
+ * @param b - Another release
+ * @returns A negative number when `a` precedes `b`, a positive one when it
+ *   follows it, and 0 when neither does
+ * @throws {Error} When either is not a semantic version
+ */
+export declare function compareReleases(a: string, b: string): number;
+//# sourceMappingURL=release.d.ts.map

package/dist/src/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../../src/release.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,uCAAuC;AACvC,eAAO,MAAM,UAAU,WAAW,CAAC;AAKnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB5D"}

package/dist/src/release.js

@@ -0,0 +1,71 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The release of e3 this build is, and how two releases order.
+ *
+ * @remarks
+ * A release is the version the release scripts write into every package.
+ * `scripts/set-npm-version.mjs` writes it here with them, and
+ * `scripts/check-version-drift.mjs` refuses a tree where it differs from
+ * theirs. What e3 keeps or ships records the release that wrote it: a
+ * repository's record, an execution state and a package zip, and a transfer
+ * request the release that sent it, so a refusal of any of them names that
+ * release beside this one.
+ */
+/** The release of e3 this build is. */
+export const E3_RELEASE = '1.0.79';
+/** A semantic version: its core, a pre-release, and build metadata. */
+const RELEASE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+/**
+ * Orders two releases by semantic-version precedence.
+ *
+ * @remarks
+ * The core, `major.minor.patch`, orders numerically. A pre-release
+ * (`1.1.0-beta.2`) precedes the release of its core, and two pre-releases of
+ * one core order by their dot-separated identifiers in turn: numbers
+ * numerically and before words, words in ASCII order, and a list that is a
+ * prefix of the other first. Build metadata (`+…`) orders nothing.
+ *
+ * @param a - A release, such as `1.0.79` or `1.1.0-beta.2`
+ * @param b - Another release
+ * @returns A negative number when `a` precedes `b`, a positive one when it
+ *   follows it, and 0 when neither does
+ * @throws {Error} When either is not a semantic version
+ */
+export function compareReleases(a, b) {
+    const x = parseRelease(a);
+    const y = parseRelease(b);
+    for (let i = 0; i < 3; i++) {
+        if (x.core[i] !== y.core[i])
+            return x.core[i] < y.core[i] ? -1 : 1;
+    }
+    if (x.pre.length === 0 || y.pre.length === 0)
+        return y.pre.length - x.pre.length;
+    for (let i = 0; i < Math.min(x.pre.length, y.pre.length); i++) {
+        const p = x.pre[i];
+        const q = y.pre[i];
+        if (p === q)
+            continue;
+        const pNumber = /^\d+$/.test(p);
+        const qNumber = /^\d+$/.test(q);
+        if (pNumber && qNumber)
+            return BigInt(p) < BigInt(q) ? -1 : 1;
+        if (pNumber !== qNumber)
+            return pNumber ? -1 : 1;
+        return p < q ? -1 : 1;
+    }
+    return x.pre.length - y.pre.length;
+}
+/** A release's core numbers and pre-release identifiers. */
+function parseRelease(release) {
+    const match = RELEASE.exec(release);
+    if (match === null)
+        throw new Error(`${JSON.stringify(release)} is not a release: a release is a semantic version, such as ${E3_RELEASE}`);
+    return {
+        core: [Number(match[1]), Number(match[2]), Number(match[3])],
+        pre: match[4] === undefined ? [] : match[4].split('.'),
+    };
+}
+//# sourceMappingURL=release.js.map

package/dist/src/release.js.map

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

package/dist/src/release.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=release.spec.d.ts.map

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

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

package/dist/src/release.spec.js

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The order of releases, by which an e3 tells a newer release's zip or
+ * execution state from an older one's.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { E3_RELEASE, compareReleases } from './release.js';
+describe('compareReleases', () => {
+    it('orders releases by semantic-version precedence', () => {
+        // Each precedes the next: the core numerically, a pre-release before its
+        // core's release, numeric identifiers before words and numerically, and a
+        // list before a longer one it begins.
+        const ordered = [
+            '0.9.0', '1.0.0-alpha', '1.0.0-alpha.1', '1.0.0-alpha.beta', '1.0.0-beta', '1.0.0-beta.2', '1.0.0-beta.11',
+            '1.0.0-rc.1', '1.0.0', '1.0.9', '1.0.10', '1.0.79', '1.0.80-beta.1', '1.0.80', '1.1.0', '2.0.0',
+        ];
+        for (let i = 0; i < ordered.length; i++) {
+            for (let j = 0; j < ordered.length; j++) {
+                const order = Math.sign(compareReleases(ordered[i], ordered[j]));
+                assert.equal(order, Math.sign(i - j), `${ordered[i]} against ${ordered[j]}`);
+            }
+        }
+    });
+    it('orders nothing by build metadata', () => {
+        assert.equal(compareReleases('1.0.79+ci.7', '1.0.79'), 0);
+        assert.equal(compareReleases('1.0.80-beta.1+a', '1.0.80-beta.1+b'), 0);
+    });
+    it('refuses what is not a semantic version, naming it', () => {
+        for (const release of ['1.0', 'v1.0.79', '1.0.079', '1.0.79-', 'latest', '']) {
+            assert.throws(() => compareReleases(release, E3_RELEASE), { message: new RegExp(`^${JSON.stringify(release).replace(/[.+]/g, '\\$&')} is not a release`) });
+            assert.throws(() => compareReleases(E3_RELEASE, release), /is not a release/);
+        }
+    });
+    it('is a release itself', () => {
+        assert.equal(compareReleases(E3_RELEASE, E3_RELEASE), 0);
+    });
+});
+//# sourceMappingURL=release.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"release.spec.js","sourceRoot":"","sources":["../../src/release.spec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE3D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,yEAAyE;QACzE,0EAA0E;QAC1E,sCAAsC;QACtC,MAAM,OAAO,GAAG;YACd,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe;YAC1G,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;SAChG,CAAC;QACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;gBACnE,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,KAAK,MAAM,OAAO,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;YAC5J,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC;QAChF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/repository.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * A repository's own records: the record of the forms it keeps — the release
+ * of e3 that last wrote it, and the store upgrades it has had — and its
+ * metadata: its name, its lifecycle status and when each began.
+ */
+import { ArrayType, VariantType, StructType, StringType, DateTimeType, NullType, ValueTypeOf } from '@elaraai/east';
+/**
+ * The repository record: the release of e3 that last wrote it, and the store
+ * upgrades the repository has had, which an e3 opening it reads before
+ * anything else.
+ */
+export declare const RepositoryRecordType: StructType<{
+    /** The release of e3 that last wrote the record */
+    readonly release: StringType;
+    /** The store upgrades the repository has had, in the order they were
+     *  applied: each by its name, with the release of e3 that applied it */
+    readonly upgrades: ArrayType<StructType<{
+        readonly name: StringType;
+        readonly release: StringType;
+    }>>;
+}>;
+export type RepositoryRecord = ValueTypeOf<typeof RepositoryRecordType>;
+/**
+ * Where a repository is in its lifecycle.
+ */
+export declare const RepoStatusType: VariantType<{
+    /** Being initialised */
+    readonly creating: NullType;
+    /** Ready for use */
+    readonly active: NullType;
+    /** A garbage collection is running */
+    readonly gc: NullType;
+    /** Being deleted */
+    readonly deleting: NullType;
+}>;
+export type RepoStatus = ValueTypeOf<typeof RepoStatusType>;
+/**
+ * A repository's metadata.
+ */
+export declare const RepoMetadataType: StructType<{
+    /** The repository's name */
+    readonly name: StringType;
+    /** Where it is in its lifecycle */
+    readonly status: VariantType<{
+        /** Being initialised */
+        readonly creating: NullType;
+        /** Ready for use */
+        readonly active: NullType;
+        /** A garbage collection is running */
+        readonly gc: NullType;
+        /** Being deleted */
+        readonly deleting: NullType;
+    }>;
+    /** When it was created */
+    readonly createdAt: DateTimeType;
+    /** When its status last changed */
+    readonly statusChangedAt: DateTimeType;
+}>;
+export type RepoMetadata = ValueTypeOf<typeof RepoMetadataType>;
+//# sourceMappingURL=repository.d.ts.map

package/dist/src/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,mDAAmD;;IAEnD;4EACwE;;;;;EAExE,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB,wBAAwB;;IAExB,oBAAoB;;IAEpB,sCAAsC;;IAEtC,oBAAoB;;EAEpB,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,gBAAgB;IAC3B,4BAA4B;;IAE5B,mCAAmC;;QAlBnC,wBAAwB;;QAExB,oBAAoB;;QAEpB,sCAAsC;;QAEtC,oBAAoB;;;IAcpB,0BAA0B;;IAE1B,mCAAmC;;EAEnC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/src/repository.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * A repository's own records: the record of the forms it keeps — the release
+ * of e3 that last wrote it, and the store upgrades it has had — and its
+ * metadata: its name, its lifecycle status and when each began.
+ */
+import { ArrayType, VariantType, StructType, StringType, DateTimeType, NullType, } from '@elaraai/east';
+/**
+ * The repository record: the release of e3 that last wrote it, and the store
+ * upgrades the repository has had, which an e3 opening it reads before
+ * anything else.
+ */
+export const RepositoryRecordType = StructType({
+    /** The release of e3 that last wrote the record */
+    release: StringType,
+    /** The store upgrades the repository has had, in the order they were
+     *  applied: each by its name, with the release of e3 that applied it */
+    upgrades: ArrayType(StructType({ name: StringType, release: StringType })),
+});
+/**
+ * Where a repository is in its lifecycle.
+ */
+export const RepoStatusType = VariantType({
+    /** Being initialised */
+    creating: NullType,
+    /** Ready for use */
+    active: NullType,
+    /** A garbage collection is running */
+    gc: NullType,
+    /** Being deleted */
+    deleting: NullType,
+});
+/**
+ * A repository's metadata.
+ */
+export const RepoMetadataType = StructType({
+    /** The repository's name */
+    name: StringType,
+    /** Where it is in its lifecycle */
+    status: RepoStatusType,
+    /** When it was created */
+    createdAt: DateTimeType,
+    /** When its status last changed */
+    statusChangedAt: DateTimeType,
+});
+//# sourceMappingURL=repository.js.map

package/dist/src/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,GAET,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC7C,mDAAmD;IACnD,OAAO,EAAE,UAAU;IACnB;4EACwE;IACxE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;CAC3E,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;IACxC,wBAAwB;IACxB,QAAQ,EAAE,QAAQ;IAClB,oBAAoB;IACpB,MAAM,EAAE,QAAQ;IAChB,sCAAsC;IACtC,EAAE,EAAE,QAAQ;IACZ,oBAAoB;IACpB,QAAQ,EAAE,QAAQ;CACnB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAC;IACzC,4BAA4B;IAC5B,IAAI,EAAE,UAAU;IAChB,mCAAmC;IACnC,MAAM,EAAE,cAAc;IACtB,0BAA0B;IAC1B,SAAS,EAAE,YAAY;IACvB,mCAAmC;IACnC,eAAe,EAAE,YAAY;CAC9B,CAAC,CAAC"}

package/dist/src/runner.d.ts

@@ -3,29 +3,23 @@
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
 /**
- * Runner wire types for e3 functions.
+ * Runner wire types for e3 tasks, functions and records.
  *
- * `RunnerType` is the wire image of the SDK's `Runner` union (minus its
- * `custom` raw-argv runtime — see the security note below). It pins the
- * executable to a known runtime for every tag, so a function call can never
- * name its own executable; only platform flags vary.
- *
- * A `platforms` entry is just a `-p <name>` flag on the wire; the SDK's
- * `Platform<Known> | { custom }` distinction is authoring sugar that
- * collapses to a string.
+ * `RunnerType` is the wire image of the SDK's `Runner` union. A known-runtime
+ * tag pins the executable to one of the stock runners, which runs units through
+ * its `exec` command; `custom` names a command of the author's own.
  */
 import { VariantType, StructType, ArrayType, StringType, ValueTypeOf } from '@elaraai/east';
 /**
- * Wire representation of a runner — shared by tasks and functions
- * (symmetric: both carry `runner: RunnerType`).
- *
- * The known-runtime tags name a runtime binary; `platforms` are passed as
- * `-p` flags. `custom` carries a raw argv prefix: for functions it is the
- * executed command (the standard `-i/-o/<ir>` suffix is appended, so the
- * command must speak the runner CLI convention); for tasks it is routing
- * metadata only — a task's `commandIr` remains authoritative for execution.
- * Package authors can already execute arbitrary commands via custom tasks,
- * so `custom` grants no capability that tasks don't have.
+ * Wire representation of a runner — shared by tasks, functions and records.
+ *
+ * A known-runtime tag names a stock runner, and `platforms` names the platform
+ * packages the units it runs load. `custom` carries a command, which e3 runs
+ * with the arguments of a stock runner's `run`: `-i` for each input, `-o` for
+ * the output, then the program's file. A custom task's body is its own
+ * command, and its runner's is empty. Package authors can already execute
+ * arbitrary commands via custom tasks, so `custom` grants no capability that
+ * tasks don't have.
  */
 export declare const RunnerType: VariantType<{
     readonly east_node: StructType<{
@@ -43,45 +37,6 @@ export declare const RunnerType: VariantType<{
 }>;
 export type RunnerType = typeof RunnerType;
 export type RunnerValue = ValueTypeOf<typeof RunnerType>;
-/**
- * Resolve a {@link RunnerType} value to the argv prefix of one of its
- * commands (the wire-value analogue of the SDK's `runnerToCommand`): `run`,
- * the default — `[<bin>, 'run', -p…]` — or `merge`, the blob merge every
- * stock runner ships — `[<bin>, 'merge', -p…]`, the fan-in of a partitioned
- * task's keyed partials (issue #770). Lives in e3-types so both e3-core
- * (local) and the cloud execution kernel import the one resolver.
- *
- * Variant tags use underscores (`east_node`) mapped to the binary name
- * (`east-node`) here. A `custom` runner's command is its `run`; it has no
- * merge command.
- *
- * @param r - the runner
- * @param command - the runner command, `run` by default
- * @returns the argv prefix
- * @throws {Error} When `merge` is asked of a custom runner.
- */
-export declare function runnerToArgv(r: RunnerValue, command?: 'run' | 'merge'): string[];
-/**
- * Insert the runner's `-v/--verbose` flag into a fully-built argv, for the
- * known runtimes only.
- *
- * All three known runners (`east-node`/`east-py`/`east-c`, `run` and `merge`)
- * accept `-v` among their options and print timing/perf detail to stderr; a
- * `custom` runner's argv is user-authored, so a flag is never spliced into
- * it. A known-runtime argv always starts `[<bin>, <command>, …]` (see
- * {@link runnerToArgv} and the SDK's `runnerToCommand`), so `-v` goes at
- * index 2 — ahead of the `-p`/`-i`/`-o` flags and the trailing IR path.
- *
- * This is a pure **runtime** toggle: it is applied to the *evaluated* argv
- * immediately before spawn and never touches the task's `commandIr`, the
- * {@link RunnerType}, or any hash — so it cannot affect caching.
- *
- * @param runner - the runner the argv was built for (gates the injection)
- * @param args - the fully-built argv (runner prefix + `-i`/`-o`/`<ir>` suffix)
- * @param verbose - when true, request the runner's verbose output
- * @returns the argv, with `-v` inserted for known runtimes when verbose
- */
-export declare function withRunnerVerbose(runner: RunnerValue, args: string[], verbose?: boolean): string[];
 /**
  * Insert the runner's `--exit-with-parent` flag into a fully-built argv, for
  * the known runtimes only — the stdin lifeline (issue #770).
@@ -89,10 +44,9 @@ export declare function withRunnerVerbose(runner: RunnerValue, args: string[], v
  * A stock runner given the flag and a stdin pipe its parent never writes to
  * exits as soon as the pipe reaches end of file: when the parent dies. A
  * `custom` runner's argv is user-authored, so the flag is never spliced into
- * it, and it keeps an ignored stdin. Like {@link withRunnerVerbose} the flag
- * goes at index 2, after `[<bin>, <command>]`, and is a pure runtime toggle
- * applied just before spawn — never part of the task's `commandIr` or any
- * hash.
+ * it, and it keeps an ignored stdin. The flag goes at index 2, after
+ * `[<bin>, <command>]`, and is a pure runtime toggle applied just before
+ * spawn — never part of the task object or any hash.
  *
  * @param runner - the runner the argv was built for (gates the injection)
  * @param args - the fully-built argv

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

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;EAKrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,CAAC;AAMzD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,GAAE,KAAK,GAAG,OAAe,GAAG,MAAM,EAAE,CASvF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAGlG;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGhF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5F;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;EAKrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGhF"}

package/dist/src/runner.js

@@ -3,29 +3,23 @@
  * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
  */
 /**
- * Runner wire types for e3 functions.
+ * Runner wire types for e3 tasks, functions and records.
  *
- * `RunnerType` is the wire image of the SDK's `Runner` union (minus its
- * `custom` raw-argv runtime — see the security note below). It pins the
- * executable to a known runtime for every tag, so a function call can never
- * name its own executable; only platform flags vary.
- *
- * A `platforms` entry is just a `-p <name>` flag on the wire; the SDK's
- * `Platform<Known> | { custom }` distinction is authoring sugar that
- * collapses to a string.
+ * `RunnerType` is the wire image of the SDK's `Runner` union. A known-runtime
+ * tag pins the executable to one of the stock runners, which runs units through
+ * its `exec` command; `custom` names a command of the author's own.
  */
 import { VariantType, StructType, ArrayType, StringType } from '@elaraai/east';
 /**
- * Wire representation of a runner — shared by tasks and functions
- * (symmetric: both carry `runner: RunnerType`).
- *
- * The known-runtime tags name a runtime binary; `platforms` are passed as
- * `-p` flags. `custom` carries a raw argv prefix: for functions it is the
- * executed command (the standard `-i/-o/<ir>` suffix is appended, so the
- * command must speak the runner CLI convention); for tasks it is routing
- * metadata only — a task's `commandIr` remains authoritative for execution.
- * Package authors can already execute arbitrary commands via custom tasks,
- * so `custom` grants no capability that tasks don't have.
+ * Wire representation of a runner — shared by tasks, functions and records.
+ *
+ * A known-runtime tag names a stock runner, and `platforms` names the platform
+ * packages the units it runs load. `custom` carries a command, which e3 runs
+ * with the arguments of a stock runner's `run`: `-i` for each input, `-o` for
+ * the output, then the program's file. A custom task's body is its own
+ * command, and its runner's is empty. Package authors can already execute
+ * arbitrary commands via custom tasks, so `custom` grants no capability that
+ * tasks don't have.
  */
 export const RunnerType = VariantType({
     east_node: StructType({ platforms: ArrayType(StringType) }),
@@ -33,62 +27,6 @@ export const RunnerType = VariantType({
     east_c: StructType({ platforms: ArrayType(StringType) }),
     custom: StructType({ command: ArrayType(StringType) }),
 });
-function flags(platforms) {
-    return platforms.flatMap((p) => ['-p', p]);
-}
-/**
- * Resolve a {@link RunnerType} value to the argv prefix of one of its
- * commands (the wire-value analogue of the SDK's `runnerToCommand`): `run`,
- * the default — `[<bin>, 'run', -p…]` — or `merge`, the blob merge every
- * stock runner ships — `[<bin>, 'merge', -p…]`, the fan-in of a partitioned
- * task's keyed partials (issue #770). Lives in e3-types so both e3-core
- * (local) and the cloud execution kernel import the one resolver.
- *
- * Variant tags use underscores (`east_node`) mapped to the binary name
- * (`east-node`) here. A `custom` runner's command is its `run`; it has no
- * merge command.
- *
- * @param r - the runner
- * @param command - the runner command, `run` by default
- * @returns the argv prefix
- * @throws {Error} When `merge` is asked of a custom runner.
- */
-export function runnerToArgv(r, command = 'run') {
-    switch (r.type) {
-        case 'east_node': return ['east-node', command, ...flags(r.value.platforms)];
-        case 'east_py': return ['east-py', command, ...flags(r.value.platforms)];
-        case 'east_c': return ['east-c', command, ...flags(r.value.platforms)];
-        case 'custom':
-            if (command !== 'run')
-                throw new Error(`a custom runner has no ${command} command`);
-            return [...r.value.command];
-    }
-}
-/**
- * Insert the runner's `-v/--verbose` flag into a fully-built argv, for the
- * known runtimes only.
- *
- * All three known runners (`east-node`/`east-py`/`east-c`, `run` and `merge`)
- * accept `-v` among their options and print timing/perf detail to stderr; a
- * `custom` runner's argv is user-authored, so a flag is never spliced into
- * it. A known-runtime argv always starts `[<bin>, <command>, …]` (see
- * {@link runnerToArgv} and the SDK's `runnerToCommand`), so `-v` goes at
- * index 2 — ahead of the `-p`/`-i`/`-o` flags and the trailing IR path.
- *
- * This is a pure **runtime** toggle: it is applied to the *evaluated* argv
- * immediately before spawn and never touches the task's `commandIr`, the
- * {@link RunnerType}, or any hash — so it cannot affect caching.
- *
- * @param runner - the runner the argv was built for (gates the injection)
- * @param args - the fully-built argv (runner prefix + `-i`/`-o`/`<ir>` suffix)
- * @param verbose - when true, request the runner's verbose output
- * @returns the argv, with `-v` inserted for known runtimes when verbose
- */
-export function withRunnerVerbose(runner, args, verbose) {
-    if (!verbose || runner.type === 'custom' || args.length < 2)
-        return args;
-    return [...args.slice(0, 2), '-v', ...args.slice(2)];
-}
 /**
  * Insert the runner's `--exit-with-parent` flag into a fully-built argv, for
  * the known runtimes only — the stdin lifeline (issue #770).
@@ -96,10 +34,9 @@ export function withRunnerVerbose(runner, args, verbose) {
  * A stock runner given the flag and a stdin pipe its parent never writes to
  * exits as soon as the pipe reaches end of file: when the parent dies. A
  * `custom` runner's argv is user-authored, so the flag is never spliced into
- * it, and it keeps an ignored stdin. Like {@link withRunnerVerbose} the flag
- * goes at index 2, after `[<bin>, <command>]`, and is a pure runtime toggle
- * applied just before spawn — never part of the task's `commandIr` or any
- * hash.
+ * it, and it keeps an ignored stdin. The flag goes at index 2, after
+ * `[<bin>, <command>]`, and is a pure runtime toggle applied just before
+ * spawn — never part of the task object or any hash.
  *
  * @param runner - the runner the argv was built for (gates the injection)
  * @param args - the fully-built argv

package/dist/src/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;IACpC,SAAS,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,OAAO,EAAI,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,MAAM,EAAK,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,MAAM,EAAK,UAAU,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAC;AAKH,SAAS,KAAK,CAAC,SAAmB;IAChC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAAC,CAAc,EAAE,UAA2B,KAAK;IAC3E,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7E,KAAK,SAAS,CAAC,CAAG,OAAO,CAAC,SAAS,EAAI,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7E,KAAK,QAAQ,CAAC,CAAI,OAAO,CAAC,QAAQ,EAAK,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7E,KAAK,QAAQ;YACX,IAAI,OAAO,KAAK,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,UAAU,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,IAAc,EAAE,OAAiB;IACtF,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,IAAc;IACpE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAE5F;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;IACpC,SAAS,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,OAAO,EAAI,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,MAAM,EAAK,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;IAC3D,MAAM,EAAK,UAAU,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAC;AAKH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB,EAAE,IAAc;IACpE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC"}