@elaraai/e3-types 1.0.79 → 1.0.81

package/dist/src/execution.d.ts

@@ -6,30 +6,40 @@
  * Execution status type definitions.
  *
  * An execution represents a single run of a task with specific inputs.
- * Executions are stored at: executions/<taskHash>/<inputsHash>/
+ * A local repository keeps each attempt at
+ * executions/<taskHash>/<inputsHash>/<executionId>/
  *
  * The status file tracks:
  * - For running: process identification for crash detection
- * - For success: output hash and timing
- * - For failed: exit code and timing
+ * - For success: output hash, timing, peak memory and a split task's last plan
+ * - For failed: exit code, timing and peak memory
  * - For error: internal error message and timing
+ * - For cancelled and interrupted: how e3, not the task, ended it
+ *
+ * Every case says whether the execution is a unit of a split task — a piece,
+ * or a merge of the pieces' outputs — which is recorded under its task's hash
+ * as the task's own executions are, but is not a run of the task.
  */
-import { VariantType, StructType, ArrayType, StringType, IntegerType, DateTimeType, ValueTypeOf } from '@elaraai/east';
+import { VariantType, StructType, ArrayType, OptionType, StringType, IntegerType, BooleanType, DateTimeType, ValueTypeOf } from '@elaraai/east';
 /**
- * Execution status stored in executions/<taskHash>/<inputsHash>/status.beast2
- *
- * A variant type representing the four possible states of an execution:
+ * Execution status, stored locally at
+ * executions/<taskHash>/<inputsHash>/<executionId>/status.beast2
  *
  * - `running`: Task has been launched but not yet completed
  * - `success`: Task ran and returned exit code 0
  * - `failed`: Task ran and returned non-zero exit code
  * - `error`: e3 execution engine had an internal error (runner not found, output missing, etc.)
+ * - `cancelled`: e3 stopped the execution because the run was aborted, before
+ *   its runner started or while it ran — not the task's own failure
+ * - `interrupted`: the orchestrator that owned the execution exited before it
+ *   finished, and its runner is gone too, so nothing will write its outcome
  *
  * The `running` state includes process identification fields (pid, pidStartTime, bootId)
  * to enable detection of crashed executions. See design/e3-execution.md for details.
+ *
+ * Stored state: read it with {@link decodeExecutionStatus}.
  */
 export declare const ExecutionStatusType: VariantType<{
-    /** Task has been launched but not yet completed */
     readonly running: StructType<{
         /** Unique execution ID (UUIDv7) */
         readonly executionId: StringType;
@@ -43,8 +53,11 @@ export declare const ExecutionStatusType: VariantType<{
         readonly pidStartTime: IntegerType;
         /** System boot ID (from /proc/sys/kernel/random/boot_id) */
         readonly bootId: StringType;
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        readonly unit: BooleanType;
     }>;
-    /** Task ran and returned exit code 0 */
     readonly success: StructType<{
         /** Unique execution ID (UUIDv7) */
         readonly executionId: StringType;
@@ -56,8 +69,19 @@ export declare const ExecutionStatusType: VariantType<{
         readonly startedAt: DateTimeType;
         /** When execution completed */
         readonly completedAt: DateTimeType;
+        /** The highest peak resident memory, in bytes, a runner process of the
+         *  execution reached — a split task's, the largest of its units' — when
+         *  its runners reported one */
+        readonly peakBytes: OptionType<IntegerType>;
+        /** A split task's: the `$plan` of the last stage it ran, which names the
+         *  stages before it, and so every unit its output was assembled from;
+         *  `none` for any other execution */
+        readonly plan: OptionType<StringType>;
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        readonly unit: BooleanType;
     }>;
-    /** Task ran and returned non-zero exit code */
     readonly failed: StructType<{
         /** Unique execution ID (UUIDv7) */
         readonly executionId: StringType;
@@ -69,8 +93,15 @@ export declare const ExecutionStatusType: VariantType<{
         readonly completedAt: DateTimeType;
         /** Process exit code */
         readonly exitCode: IntegerType;
+        /** The highest peak resident memory, in bytes, a runner process of the
+         *  execution reached — a split task's, the largest of its units' — when
+         *  its runners reported one */
+        readonly peakBytes: OptionType<IntegerType>;
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        readonly unit: BooleanType;
     }>;
-    /** e3 execution engine had an internal error */
     readonly error: StructType<{
         /** Unique execution ID (UUIDv7) */
         readonly executionId: StringType;
@@ -82,24 +113,87 @@ export declare const ExecutionStatusType: VariantType<{
         readonly completedAt: DateTimeType;
         /** Error message describing what went wrong */
         readonly message: StringType;
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        readonly unit: BooleanType;
+    }>;
+    readonly cancelled: StructType<{
+        /** Unique execution ID (UUIDv7) */
+        readonly executionId: StringType;
+        /** Input dataset hashes */
+        readonly inputHashes: ArrayType<StringType>;
+        /** When execution started */
+        readonly startedAt: DateTimeType;
+        /** When e3 stopped it */
+        readonly completedAt: DateTimeType;
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        readonly unit: BooleanType;
+    }>;
+    readonly interrupted: StructType<{
+        /** Unique execution ID (UUIDv7) */
+        readonly executionId: StringType;
+        /** Input dataset hashes */
+        readonly inputHashes: ArrayType<StringType>;
+        /** When execution started */
+        readonly startedAt: DateTimeType;
+        /** When the interruption was found */
+        readonly completedAt: DateTimeType;
+        /** Process ID the runner had */
+        readonly pid: IntegerType;
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        readonly unit: BooleanType;
     }>;
 }>;
 export type ExecutionStatus = ValueTypeOf<typeof ExecutionStatusType>;
 /**
- * The orchestrator process that launched an execution (issue #770).
+ * The objects an execution's record keeps from garbage collection: a
+ * success's output, and a split task's last `$plan`, which names every stage
+ * before it and so the units gc keeps beside the task.
+ *
+ * @remarks
+ * Every backend's scan of execution roots applies it, as gc does to the
+ * executions it keeps.
+ *
+ * @param status - the execution's status
+ * @returns the hashes of the objects it keeps
+ */
+export declare function executionStatusRoots(status: ExecutionStatus): string[];
+/**
+ * Decode an execution status.
+ *
+ * @remarks
+ * Stored state, so it changes by hard cutover: a repository an older e3 wrote
+ * is re-created rather than read, and this says so.
+ *
+ * @param data - the stored bytes
+ * @returns the status
+ * @throws {Error} When the bytes are not a current status — one an older e3
+ *   wrote, whose repository is re-created.
+ */
+export declare function decodeExecutionStatus(data: Uint8Array): ExecutionStatus;
+/**
+ * The orchestrator process that launched an execution.
  *
  * @remarks
- * Written beside the execution's `running` status as the `owner` sidecar. A
+ * Written beside the execution's `running` status as its owner record. A
  * `running` record whose runner is gone is repaired only when its owner is
  * gone too: a live owner may be between the runner's exit and the record's
  * write, hashing the output.
+ *
+ * Stored state: a record of another shape is read as none recorded.
  */
-export interface ExecutionOwner {
+export declare const ExecutionOwnerType: StructType<{
     /** Process ID of the orchestrator */
-    pid: number;
+    readonly pid: IntegerType;
     /** Orchestrator start time in jiffies since boot (from /proc/<pid>/stat field 22) */
-    pidStartTime: number;
+    readonly pidStartTime: IntegerType;
     /** System boot ID (from /proc/sys/kernel/random/boot_id) */
-    bootId: string;
-}
+    readonly bootId: StringType;
+}>;
+export type ExecutionOwner = ValueTypeOf<typeof ExecutionOwnerType>;
 //# sourceMappingURL=execution.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/execution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB;IAC9B,mDAAmD;;QAEjD,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,+BAA+B;;QAE/B,gFAAgF;;QAEhF,4DAA4D;;;IAG9D,wCAAwC;;QAEtC,mCAAmC;;QAEnC,2BAA2B;;QAE3B,iCAAiC;;QAEjC,6BAA6B;;QAE7B,+BAA+B;;;IAGjC,+CAA+C;;QAE7C,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,+BAA+B;;QAE/B,wBAAwB;;;IAG1B,gDAAgD;;QAE9C,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,+BAA+B;;QAE/B,+CAA+C;;;EAGjD,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/execution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EAEZ,MAAM,eAAe,CAAC;AAqFvB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;QAnG9B,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,+BAA+B;;QAE/B,gFAAgF;;QAEhF,4DAA4D;;QAE5D;;4DAEoD;;;;QAKpD,mCAAmC;;QAEnC,2BAA2B;;QAE3B,iCAAiC;;QAEjC,6BAA6B;;QAE7B,+BAA+B;;QAE/B;;uCAE+B;;QAE/B;;6CAEqC;;QAErC;;4DAEoD;;;;QAKpD,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,+BAA+B;;QAE/B,wBAAwB;;QAExB;;uCAE+B;;QAE/B;;4DAEoD;;;;QAKpD,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,+BAA+B;;QAE/B,+CAA+C;;QAE/C;;4DAEoD;;;;QA4BlD,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,yBAAyB;;QAEzB;;4DAEoD;;;;QAIpD,mCAAmC;;QAEnC,2BAA2B;;QAE3B,6BAA6B;;QAE7B,sCAAsC;;QAEtC,gCAAgC;;QAEhC;;4DAEoD;;;EAGtD,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAItE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CASvE;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB;IAC7B,qCAAqC;;IAErC,qFAAqF;;IAErF,4DAA4D;;EAE5D,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/src/execution.js

@@ -6,82 +6,211 @@
  * Execution status type definitions.
  *
  * An execution represents a single run of a task with specific inputs.
- * Executions are stored at: executions/<taskHash>/<inputsHash>/
+ * A local repository keeps each attempt at
+ * executions/<taskHash>/<inputsHash>/<executionId>/
  *
  * The status file tracks:
  * - For running: process identification for crash detection
- * - For success: output hash and timing
- * - For failed: exit code and timing
+ * - For success: output hash, timing, peak memory and a split task's last plan
+ * - For failed: exit code, timing and peak memory
  * - For error: internal error message and timing
+ * - For cancelled and interrupted: how e3, not the task, ended it
+ *
+ * Every case says whether the execution is a unit of a split task — a piece,
+ * or a merge of the pieces' outputs — which is recorded under its task's hash
+ * as the task's own executions are, but is not a run of the task.
  */
-import { VariantType, StructType, ArrayType, StringType, IntegerType, DateTimeType, } from '@elaraai/east';
+import { VariantType, StructType, ArrayType, OptionType, StringType, IntegerType, BooleanType, DateTimeType, decodeBeast2For, } from '@elaraai/east';
+/** A running execution's process identification. */
+const RunningStatusType = StructType({
+    /** Unique execution ID (UUIDv7) */
+    executionId: StringType,
+    /** Input dataset hashes */
+    inputHashes: ArrayType(StringType),
+    /** When execution started */
+    startedAt: DateTimeType,
+    /** Process ID of the runner */
+    pid: IntegerType,
+    /** Process start time in jiffies since boot (from /proc/<pid>/stat field 22) */
+    pidStartTime: IntegerType,
+    /** System boot ID (from /proc/sys/kernel/random/boot_id) */
+    bootId: StringType,
+    /** Whether the execution is a unit of a split task — a piece, or a merge of
+     *  the pieces' outputs — rather than a task's own execution, which the one
+     *  unit of a task whose input closes no piece is */
+    unit: BooleanType,
+});
+const SuccessStatusType = StructType({
+    /** Unique execution ID (UUIDv7) */
+    executionId: StringType,
+    /** Input dataset hashes */
+    inputHashes: ArrayType(StringType),
+    /** Hash of the output dataset */
+    outputHash: StringType,
+    /** When execution started */
+    startedAt: DateTimeType,
+    /** When execution completed */
+    completedAt: DateTimeType,
+    /** The highest peak resident memory, in bytes, a runner process of the
+     *  execution reached — a split task's, the largest of its units' — when
+     *  its runners reported one */
+    peakBytes: OptionType(IntegerType),
+    /** A split task's: the `$plan` of the last stage it ran, which names the
+     *  stages before it, and so every unit its output was assembled from;
+     *  `none` for any other execution */
+    plan: OptionType(StringType),
+    /** Whether the execution is a unit of a split task — a piece, or a merge of
+     *  the pieces' outputs — rather than a task's own execution, which the one
+     *  unit of a task whose input closes no piece is */
+    unit: BooleanType,
+});
+const FailedStatusType = StructType({
+    /** Unique execution ID (UUIDv7) */
+    executionId: StringType,
+    /** Input dataset hashes */
+    inputHashes: ArrayType(StringType),
+    /** When execution started */
+    startedAt: DateTimeType,
+    /** When execution completed */
+    completedAt: DateTimeType,
+    /** Process exit code */
+    exitCode: IntegerType,
+    /** The highest peak resident memory, in bytes, a runner process of the
+     *  execution reached — a split task's, the largest of its units' — when
+     *  its runners reported one */
+    peakBytes: OptionType(IntegerType),
+    /** Whether the execution is a unit of a split task — a piece, or a merge of
+     *  the pieces' outputs — rather than a task's own execution, which the one
+     *  unit of a task whose input closes no piece is */
+    unit: BooleanType,
+});
+const ErrorStatusType = StructType({
+    /** Unique execution ID (UUIDv7) */
+    executionId: StringType,
+    /** Input dataset hashes */
+    inputHashes: ArrayType(StringType),
+    /** When execution started */
+    startedAt: DateTimeType,
+    /** When execution completed */
+    completedAt: DateTimeType,
+    /** Error message describing what went wrong */
+    message: StringType,
+    /** Whether the execution is a unit of a split task — a piece, or a merge of
+     *  the pieces' outputs — rather than a task's own execution, which the one
+     *  unit of a task whose input closes no piece is */
+    unit: BooleanType,
+});
 /**
- * Execution status stored in executions/<taskHash>/<inputsHash>/status.beast2
- *
- * A variant type representing the four possible states of an execution:
+ * Execution status, stored locally at
+ * executions/<taskHash>/<inputsHash>/<executionId>/status.beast2
  *
  * - `running`: Task has been launched but not yet completed
  * - `success`: Task ran and returned exit code 0
  * - `failed`: Task ran and returned non-zero exit code
  * - `error`: e3 execution engine had an internal error (runner not found, output missing, etc.)
+ * - `cancelled`: e3 stopped the execution because the run was aborted, before
+ *   its runner started or while it ran — not the task's own failure
+ * - `interrupted`: the orchestrator that owned the execution exited before it
+ *   finished, and its runner is gone too, so nothing will write its outcome
  *
  * The `running` state includes process identification fields (pid, pidStartTime, bootId)
  * to enable detection of crashed executions. See design/e3-execution.md for details.
+ *
+ * Stored state: read it with {@link decodeExecutionStatus}.
  */
 export const ExecutionStatusType = VariantType({
-    /** Task has been launched but not yet completed */
-    running: StructType({
+    running: RunningStatusType,
+    success: SuccessStatusType,
+    failed: FailedStatusType,
+    error: ErrorStatusType,
+    cancelled: StructType({
         /** Unique execution ID (UUIDv7) */
         executionId: StringType,
         /** Input dataset hashes */
         inputHashes: ArrayType(StringType),
         /** When execution started */
         startedAt: DateTimeType,
-        /** Process ID of the runner */
-        pid: IntegerType,
-        /** Process start time in jiffies since boot (from /proc/<pid>/stat field 22) */
-        pidStartTime: IntegerType,
-        /** System boot ID (from /proc/sys/kernel/random/boot_id) */
-        bootId: StringType,
-    }),
-    /** Task ran and returned exit code 0 */
-    success: StructType({
-        /** Unique execution ID (UUIDv7) */
-        executionId: StringType,
-        /** Input dataset hashes */
-        inputHashes: ArrayType(StringType),
-        /** Hash of the output dataset */
-        outputHash: StringType,
-        /** When execution started */
-        startedAt: DateTimeType,
-        /** When execution completed */
+        /** When e3 stopped it */
         completedAt: DateTimeType,
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        unit: BooleanType,
     }),
-    /** Task ran and returned non-zero exit code */
-    failed: StructType({
+    interrupted: StructType({
         /** Unique execution ID (UUIDv7) */
         executionId: StringType,
         /** Input dataset hashes */
         inputHashes: ArrayType(StringType),
         /** When execution started */
         startedAt: DateTimeType,
-        /** When execution completed */
+        /** When the interruption was found */
         completedAt: DateTimeType,
-        /** Process exit code */
-        exitCode: IntegerType,
-    }),
-    /** e3 execution engine had an internal error */
-    error: StructType({
-        /** Unique execution ID (UUIDv7) */
-        executionId: StringType,
-        /** Input dataset hashes */
-        inputHashes: ArrayType(StringType),
-        /** When execution started */
-        startedAt: DateTimeType,
-        /** When execution completed */
-        completedAt: DateTimeType,
-        /** Error message describing what went wrong */
-        message: StringType,
+        /** Process ID the runner had */
+        pid: IntegerType,
+        /** Whether the execution is a unit of a split task — a piece, or a merge of
+         *  the pieces' outputs — rather than a task's own execution, which the one
+         *  unit of a task whose input closes no piece is */
+        unit: BooleanType,
     }),
 });
+/**
+ * The objects an execution's record keeps from garbage collection: a
+ * success's output, and a split task's last `$plan`, which names every stage
+ * before it and so the units gc keeps beside the task.
+ *
+ * @remarks
+ * Every backend's scan of execution roots applies it, as gc does to the
+ * executions it keeps.
+ *
+ * @param status - the execution's status
+ * @returns the hashes of the objects it keeps
+ */
+export function executionStatusRoots(status) {
+    if (status.type !== 'success')
+        return [];
+    const { outputHash, plan } = status.value;
+    return plan.type === 'some' ? [outputHash, plan.value] : [outputHash];
+}
+const decodeCurrentStatus = decodeBeast2For(ExecutionStatusType);
+/**
+ * Decode an execution status.
+ *
+ * @remarks
+ * Stored state, so it changes by hard cutover: a repository an older e3 wrote
+ * is re-created rather than read, and this says so.
+ *
+ * @param data - the stored bytes
+ * @returns the status
+ * @throws {Error} When the bytes are not a current status — one an older e3
+ *   wrote, whose repository is re-created.
+ */
+export function decodeExecutionStatus(data) {
+    try {
+        return decodeCurrentStatus(data);
+    }
+    catch (err) {
+        throw new Error(`the execution status does not decode: an older e3 wrote this repository — re-create it: deploy again and import its data again ` +
+            `(${err instanceof Error ? err.message : String(err)})`);
+    }
+}
+/**
+ * The orchestrator process that launched an execution.
+ *
+ * @remarks
+ * Written beside the execution's `running` status as its owner record. A
+ * `running` record whose runner is gone is repaired only when its owner is
+ * gone too: a live owner may be between the runner's exit and the record's
+ * write, hashing the output.
+ *
+ * Stored state: a record of another shape is read as none recorded.
+ */
+export const ExecutionOwnerType = StructType({
+    /** Process ID of the orchestrator */
+    pid: IntegerType,
+    /** Orchestrator start time in jiffies since boot (from /proc/<pid>/stat field 22) */
+    pidStartTime: IntegerType,
+    /** System boot ID (from /proc/sys/kernel/random/boot_id) */
+    bootId: StringType,
+});
 //# sourceMappingURL=execution.js.map

package/dist/src/execution.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/execution.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,GAEb,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC7C,mDAAmD;IACnD,OAAO,EAAE,UAAU,CAAC;QAClB,mCAAmC;QACnC,WAAW,EAAE,UAAU;QACvB,2BAA2B;QAC3B,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC;QAClC,6BAA6B;QAC7B,SAAS,EAAE,YAAY;QACvB,+BAA+B;QAC/B,GAAG,EAAE,WAAW;QAChB,gFAAgF;QAChF,YAAY,EAAE,WAAW;QACzB,4DAA4D;QAC5D,MAAM,EAAE,UAAU;KACnB,CAAC;IACF,wCAAwC;IACxC,OAAO,EAAE,UAAU,CAAC;QAClB,mCAAmC;QACnC,WAAW,EAAE,UAAU;QACvB,2BAA2B;QAC3B,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC;QAClC,iCAAiC;QACjC,UAAU,EAAE,UAAU;QACtB,6BAA6B;QAC7B,SAAS,EAAE,YAAY;QACvB,+BAA+B;QAC/B,WAAW,EAAE,YAAY;KAC1B,CAAC;IACF,+CAA+C;IAC/C,MAAM,EAAE,UAAU,CAAC;QACjB,mCAAmC;QACnC,WAAW,EAAE,UAAU;QACvB,2BAA2B;QAC3B,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC;QAClC,6BAA6B;QAC7B,SAAS,EAAE,YAAY;QACvB,+BAA+B;QAC/B,WAAW,EAAE,YAAY;QACzB,wBAAwB;QACxB,QAAQ,EAAE,WAAW;KACtB,CAAC;IACF,gDAAgD;IAChD,KAAK,EAAE,UAAU,CAAC;QAChB,mCAAmC;QACnC,WAAW,EAAE,UAAU;QACvB,2BAA2B;QAC3B,WAAW,EAAE,SAAS,CAAC,UAAU,CAAC;QAClC,6BAA6B;QAC7B,SAAS,EAAE,YAAY;QACvB,+BAA+B;QAC/B,WAAW,EAAE,YAAY;QACzB,+CAA+C;QAC/C,OAAO,EAAE,UAAU;KACpB,CAAC;CACH,CAAC,CAAC"}
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/execution.ts"],"names":[],"mappings":"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"}

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

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

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

package/dist/src/execution.spec.js

@@ -0,0 +1,108 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Execution status wire: the typed outcomes with their peaks, a split task's
+ * plan and whether the execution is a unit, what each keeps from gc, and the
+ * refusal of a record an older e3 wrote before `cancelled` and `interrupted`
+ * were cases of it, before a runner's peak was recorded, before a split task's
+ * plan was, or before a record said whether it is a unit.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { ArrayType, DateTimeType, IntegerType, OptionType, StringType, StructType, VariantType, encodeBeast2For, none, some, variant } from '@elaraai/east';
+import { ExecutionStatusType, decodeExecutionStatus, executionStatusRoots } from './execution.js';
+/** The four-case wire every record had before the typed outcomes. */
+const PreOutcomeExecutionStatusType = VariantType({
+    running: StructType({
+        executionId: StringType, inputHashes: ArrayType(StringType), startedAt: DateTimeType,
+        pid: IntegerType, pidStartTime: IntegerType, bootId: StringType,
+    }),
+    success: StructType({
+        executionId: StringType, inputHashes: ArrayType(StringType), outputHash: StringType,
+        startedAt: DateTimeType, completedAt: DateTimeType,
+    }),
+    failed: StructType({
+        executionId: StringType, inputHashes: ArrayType(StringType), startedAt: DateTimeType,
+        completedAt: DateTimeType, exitCode: IntegerType,
+    }),
+    error: StructType({
+        executionId: StringType, inputHashes: ArrayType(StringType), startedAt: DateTimeType,
+        completedAt: DateTimeType, message: StringType,
+    }),
+});
+describe('ExecutionStatusType', () => {
+    const stopped = {
+        executionId: '0199-a',
+        inputHashes: ['a'.repeat(64)],
+        startedAt: new Date(1000),
+        completedAt: new Date(2000),
+    };
+    const encodeOlder = encodeBeast2For(PreOutcomeExecutionStatusType);
+    it('round-trips the typed outcomes, with a runner\'s peak or without one, a task\'s own or a unit\'s', () => {
+        const own = { ...stopped, unit: false };
+        const statuses = [
+            variant('success', { ...own, outputHash: 'b'.repeat(64), peakBytes: some(96n * 1024n ** 2n), plan: none }),
+            variant('success', { ...own, outputHash: 'b'.repeat(64), peakBytes: none, plan: some('c'.repeat(64)) }),
+            variant('success', { ...own, outputHash: 'b'.repeat(64), peakBytes: some(64n * 1024n ** 2n), plan: none, unit: true }),
+            variant('running', { executionId: '0199-b', inputHashes: ['a'.repeat(64)], startedAt: new Date(1000), pid: 4242n, pidStartTime: 7n, bootId: 'boot', unit: true }),
+            variant('failed', { ...own, exitCode: 1n, peakBytes: some(412n * 1024n ** 2n) }),
+            variant('failed', { ...own, exitCode: -1n, peakBytes: none }),
+            variant('cancelled', own),
+            variant('interrupted', { ...own, pid: 4242n }),
+            variant('error', { ...own, message: 'Failed to read output: no such file' }),
+        ];
+        const encode = encodeBeast2For(ExecutionStatusType);
+        for (const status of statuses)
+            assert.deepEqual(decodeExecutionStatus(encode(status)), status);
+    });
+    it('keeps from gc a success\'s output, and a split task\'s last plan beside it', () => {
+        const success = { ...stopped, outputHash: 'b'.repeat(64), peakBytes: none, unit: false };
+        assert.deepEqual(executionStatusRoots(variant('success', { ...success, plan: none })), ['b'.repeat(64)]);
+        assert.deepEqual(executionStatusRoots(variant('success', { ...success, plan: some('c'.repeat(64)) })), ['b'.repeat(64), 'c'.repeat(64)]);
+        assert.deepEqual(executionStatusRoots(variant('failed', { ...stopped, exitCode: 1n, peakBytes: none, unit: false })), []);
+        assert.deepEqual(executionStatusRoots(variant('cancelled', { ...stopped, unit: false })), []);
+    });
+    it('refuses a record an older e3 wrote, naming the fix', () => {
+        const refusal = /^Error: the execution status does not decode: an older e3 wrote this repository — re-create it: deploy again and import its data again \(/;
+        const records = [
+            variant('error', { ...stopped, message: 'cancelled: e3 stopped the runner because the run was aborted' }),
+            variant('success', { ...stopped, outputHash: 'b'.repeat(64) }),
+        ];
+        for (const record of records) {
+            assert.throws(() => decodeExecutionStatus(encodeOlder(record)), refusal);
+        }
+        // The typed outcomes, before a runner's peak was recorded.
+        const withoutPeaks = VariantType({
+            ...PreOutcomeExecutionStatusType.cases,
+            cancelled: StructType({ executionId: StringType, inputHashes: ArrayType(StringType), startedAt: DateTimeType, completedAt: DateTimeType }),
+            interrupted: StructType({
+                executionId: StringType, inputHashes: ArrayType(StringType), startedAt: DateTimeType, completedAt: DateTimeType, pid: IntegerType,
+            }),
+        });
+        assert.throws(() => decodeExecutionStatus(encodeBeast2For(withoutPeaks)(variant('success', { ...stopped, outputHash: 'b'.repeat(64) }))), refusal);
+        // With peaks, before a split task's plan was recorded.
+        const withoutPlans = VariantType({
+            ...ExecutionStatusType.cases,
+            success: StructType({
+                executionId: StringType, inputHashes: ArrayType(StringType), outputHash: StringType,
+                startedAt: DateTimeType, completedAt: DateTimeType, peakBytes: OptionType(IntegerType),
+            }),
+        });
+        assert.throws(() => decodeExecutionStatus(encodeBeast2For(withoutPlans)(variant('success', { ...stopped, outputHash: 'b'.repeat(64), peakBytes: none }))), refusal);
+        // With plans, before a record said whether it is a unit of a split task.
+        const withoutUnits = VariantType({
+            ...ExecutionStatusType.cases,
+            success: StructType({
+                executionId: StringType, inputHashes: ArrayType(StringType), outputHash: StringType,
+                startedAt: DateTimeType, completedAt: DateTimeType, peakBytes: OptionType(IntegerType), plan: OptionType(StringType),
+            }),
+        });
+        assert.throws(() => decodeExecutionStatus(encodeBeast2For(withoutUnits)(variant('success', { ...stopped, outputHash: 'b'.repeat(64), peakBytes: none, plan: none }))), refusal);
+    });
+    it('throws for bytes of no status shape', () => {
+        assert.throws(() => decodeExecutionStatus(encodeBeast2For(IntegerType)(7n)), /the execution status does not decode/);
+    });
+});
+//# sourceMappingURL=execution.spec.js.map

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

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