@elaraai/e3-types 1.0.28 → 1.0.29

package/dist/src/environment.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Execution environment types for e3.
+ *
+ * An environment spec describes everything a worker needs to materialize the
+ * runtime environment a task or function executes in — beyond the stock
+ * runtime image. It is stored as a content-addressed object; tasks and
+ * functions reference it by hash (`environment` field), so identical
+ * environments dedupe and the environment hash transitively folds the user's
+ * implementation code (via lockfile + sdist/tarball hashes) into execution
+ * cache identity.
+ *
+ * All fields hold object-store hashes, never inline file contents: the blobs
+ * ride the existing content-addressed object store and transfer machinery.
+ */
+import { ArrayType, StringType, StructType, ValueTypeOf, VariantType } from '@elaraai/east';
+/**
+ * A Python (uv) project environment.
+ *
+ * Materialized by creating a venv from the locked dependency set
+ * (`uv sync --frozen`) and installing the project's own sdists into it.
+ *
+ * @remarks
+ * - `pyproject`: object hash of the project's `pyproject.toml` blob.
+ * - `lock`: object hash of the `uv.lock` blob — pins the full closure.
+ * - `sdists`: the project's own source distributions (`uv build --sdist`) —
+ *   the user's platform-function implementation code — installed in order
+ *   after the sync. Each entry carries the original filename because
+ *   Python installers derive the package name from `name-version.tar.gz`
+ *   and reject a renamed file.
+ */
+export declare const PythonEnvironmentType: StructType<{
+    /** Object hash of the pyproject.toml blob */
+    readonly pyproject: StringType;
+    /** Object hash of the uv.lock blob */
+    readonly lock: StringType;
+    /** Project sdist blobs (original filename + object hash), in install order */
+    readonly sdists: ArrayType<StructType<{
+        readonly filename: StringType;
+        readonly hash: StringType;
+    }>>;
+}>;
+export type PythonEnvironmentType = typeof PythonEnvironmentType;
+export type PythonEnvironment = ValueTypeOf<typeof PythonEnvironmentType>;
+/**
+ * A Node (npm/pnpm) project environment.
+ *
+ * Materialized by installing the locked dependency set and then the
+ * project's own packed tarballs (`npm pack`).
+ *
+ * @remarks
+ * - `packageJson`: object hash of the project's `package.json` blob.
+ * - `lock`: object hash of the lockfile blob (`package-lock.json` or
+ *   `pnpm-lock.yaml`).
+ * - `tarballs`: object hashes of `npm pack` tarballs of the project's own
+ *   package(s), installed in order.
+ */
+export declare const NodeEnvironmentType: StructType<{
+    /** Object hash of the package.json blob */
+    readonly packageJson: StringType;
+    /** Object hash of the lockfile blob */
+    readonly lock: StringType;
+    /** Object hashes of npm-pack tarball blobs, in install order */
+    readonly tarballs: ArrayType<StringType>;
+}>;
+export type NodeEnvironmentType = typeof NodeEnvironmentType;
+export type NodeEnvironment = ValueTypeOf<typeof NodeEnvironmentType>;
+/**
+ * A user-controlled container image environment.
+ *
+ * The catch-all tier for CUDA bases, system libraries, or custom native
+ * runtimes. Executed by running the task's argv inside the referenced image.
+ *
+ * @remarks
+ * `digest` must be a full immutable digest reference
+ * (`repo@sha256:<64 hex>`); mutable tags are rejected at definition time so
+ * the environment hash cannot silently drift.
+ */
+export declare const ImageEnvironmentType: StructType<{
+    /** Full image digest reference: `repo@sha256:<64 hex chars>` */
+    readonly digest: StringType;
+}>;
+export type ImageEnvironmentType = typeof ImageEnvironmentType;
+export type ImageEnvironment = ValueTypeOf<typeof ImageEnvironmentType>;
+/**
+ * An execution environment specification.
+ *
+ * Stored beast2-encoded in the object store; the **environment hash** is the
+ * object hash of the encoded spec. A task/function with no environment
+ * (`none`) runs on the stock runtime image as today.
+ */
+export declare const EnvironmentSpecType: VariantType<{
+    /** Python (uv) project environment */
+    readonly python: StructType<{
+        /** Object hash of the pyproject.toml blob */
+        readonly pyproject: StringType;
+        /** Object hash of the uv.lock blob */
+        readonly lock: StringType;
+        /** Project sdist blobs (original filename + object hash), in install order */
+        readonly sdists: ArrayType<StructType<{
+            readonly filename: StringType;
+            readonly hash: StringType;
+        }>>;
+    }>;
+    /** Node project environment */
+    readonly node: StructType<{
+        /** Object hash of the package.json blob */
+        readonly packageJson: StringType;
+        /** Object hash of the lockfile blob */
+        readonly lock: StringType;
+        /** Object hashes of npm-pack tarball blobs, in install order */
+        readonly tarballs: ArrayType<StringType>;
+    }>;
+    /** Custom container image environment */
+    readonly image: StructType<{
+        /** Full image digest reference: `repo@sha256:<64 hex chars>` */
+        readonly digest: StringType;
+    }>;
+}>;
+export type EnvironmentSpecType = typeof EnvironmentSpecType;
+export type EnvironmentSpec = ValueTypeOf<typeof EnvironmentSpecType>;
+/**
+ * Lists the object-store hashes an environment spec references.
+ *
+ * Every reachability walker (package export closure, GC) must include these
+ * so environment blobs transfer with the package and survive collection.
+ *
+ * @param spec - The environment spec to walk
+ * @returns The referenced blob hashes (empty for `image` environments)
+ */
+export declare function environmentSpecObjectHashes(spec: EnvironmentSpec): string[];
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,qBAAqB;IAChC,6CAA6C;;IAE7C,sCAAsC;;IAEtC,8EAA8E;;;;;EAE9E,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB;IAC9B,2CAA2C;;IAE3C,uCAAuC;;IAEvC,gEAAgE;;EAEhE,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;IAC/B,gEAAgE;;EAEhE,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;IAC9B,sCAAsC;;QA5DtC,6CAA6C;;QAE7C,sCAAsC;;QAEtC,8EAA8E;;;;;;IA0D9E,+BAA+B;;QAtC/B,2CAA2C;;QAE3C,uCAAuC;;QAEvC,gEAAgE;;;IAoChE,yCAAyC;;QAlBzC,gEAAgE;;;EAoBhE,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,mBAAmB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAS3E"}

package/dist/src/environment.js

@@ -0,0 +1,113 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Execution environment types for e3.
+ *
+ * An environment spec describes everything a worker needs to materialize the
+ * runtime environment a task or function executes in — beyond the stock
+ * runtime image. It is stored as a content-addressed object; tasks and
+ * functions reference it by hash (`environment` field), so identical
+ * environments dedupe and the environment hash transitively folds the user's
+ * implementation code (via lockfile + sdist/tarball hashes) into execution
+ * cache identity.
+ *
+ * All fields hold object-store hashes, never inline file contents: the blobs
+ * ride the existing content-addressed object store and transfer machinery.
+ */
+import { ArrayType, StringType, StructType, VariantType } from '@elaraai/east';
+/**
+ * A Python (uv) project environment.
+ *
+ * Materialized by creating a venv from the locked dependency set
+ * (`uv sync --frozen`) and installing the project's own sdists into it.
+ *
+ * @remarks
+ * - `pyproject`: object hash of the project's `pyproject.toml` blob.
+ * - `lock`: object hash of the `uv.lock` blob — pins the full closure.
+ * - `sdists`: the project's own source distributions (`uv build --sdist`) —
+ *   the user's platform-function implementation code — installed in order
+ *   after the sync. Each entry carries the original filename because
+ *   Python installers derive the package name from `name-version.tar.gz`
+ *   and reject a renamed file.
+ */
+export const PythonEnvironmentType = StructType({
+    /** Object hash of the pyproject.toml blob */
+    pyproject: StringType,
+    /** Object hash of the uv.lock blob */
+    lock: StringType,
+    /** Project sdist blobs (original filename + object hash), in install order */
+    sdists: ArrayType(StructType({ filename: StringType, hash: StringType })),
+});
+/**
+ * A Node (npm/pnpm) project environment.
+ *
+ * Materialized by installing the locked dependency set and then the
+ * project's own packed tarballs (`npm pack`).
+ *
+ * @remarks
+ * - `packageJson`: object hash of the project's `package.json` blob.
+ * - `lock`: object hash of the lockfile blob (`package-lock.json` or
+ *   `pnpm-lock.yaml`).
+ * - `tarballs`: object hashes of `npm pack` tarballs of the project's own
+ *   package(s), installed in order.
+ */
+export const NodeEnvironmentType = StructType({
+    /** Object hash of the package.json blob */
+    packageJson: StringType,
+    /** Object hash of the lockfile blob */
+    lock: StringType,
+    /** Object hashes of npm-pack tarball blobs, in install order */
+    tarballs: ArrayType(StringType),
+});
+/**
+ * A user-controlled container image environment.
+ *
+ * The catch-all tier for CUDA bases, system libraries, or custom native
+ * runtimes. Executed by running the task's argv inside the referenced image.
+ *
+ * @remarks
+ * `digest` must be a full immutable digest reference
+ * (`repo@sha256:<64 hex>`); mutable tags are rejected at definition time so
+ * the environment hash cannot silently drift.
+ */
+export const ImageEnvironmentType = StructType({
+    /** Full image digest reference: `repo@sha256:<64 hex chars>` */
+    digest: StringType,
+});
+/**
+ * An execution environment specification.
+ *
+ * Stored beast2-encoded in the object store; the **environment hash** is the
+ * object hash of the encoded spec. A task/function with no environment
+ * (`none`) runs on the stock runtime image as today.
+ */
+export const EnvironmentSpecType = VariantType({
+    /** Python (uv) project environment */
+    python: PythonEnvironmentType,
+    /** Node project environment */
+    node: NodeEnvironmentType,
+    /** Custom container image environment */
+    image: ImageEnvironmentType,
+});
+/**
+ * Lists the object-store hashes an environment spec references.
+ *
+ * Every reachability walker (package export closure, GC) must include these
+ * so environment blobs transfer with the package and survive collection.
+ *
+ * @param spec - The environment spec to walk
+ * @returns The referenced blob hashes (empty for `image` environments)
+ */
+export function environmentSpecObjectHashes(spec) {
+    switch (spec.type) {
+        case 'python':
+            return [spec.value.pyproject, spec.value.lock, ...spec.value.sdists.map((s) => s.hash)];
+        case 'node':
+            return [spec.value.packageJson, spec.value.lock, ...spec.value.tarballs];
+        case 'image':
+            return [];
+    }
+}
+//# sourceMappingURL=environment.js.map

package/dist/src/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAe,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5F;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;IAC9C,6CAA6C;IAC7C,SAAS,EAAE,UAAU;IACrB,sCAAsC;IACtC,IAAI,EAAE,UAAU;IAChB,8EAA8E;IAC9E,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;CAC1E,CAAC,CAAC;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,2CAA2C;IAC3C,WAAW,EAAE,UAAU;IACvB,uCAAuC;IACvC,IAAI,EAAE,UAAU;IAChB,gEAAgE;IAChE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC;CAChC,CAAC,CAAC;AAIH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC;IAC7C,gEAAgE;IAChE,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;IAC7C,sCAAsC;IACtC,MAAM,EAAE,qBAAqB;IAC7B,+BAA+B;IAC/B,IAAI,EAAE,mBAAmB;IACzB,yCAAyC;IACzC,KAAK,EAAE,oBAAoB;CAC5B,CAAC,CAAC;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAqB;IAC/D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ;YACX,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1F,KAAK,MAAM;YACT,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3E,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/src/function.d.ts

@@ -15,7 +15,7 @@
  * loading the IR bundle, and so dynamic callers (CLI literal parsing,
  * non-TS clients) have the types they need to encode arguments.
  */
-import { StructType, StringType, ArrayType, ValueTypeOf } from '@elaraai/east';
+import { StructType, StringType, ArrayType, OptionType, ValueTypeOf } from '@elaraai/east';
 /**
  * Function object stored in the object store, referenced by name from
  * `PackageObject.functions`.
@@ -126,7 +126,24 @@ export declare const FunctionObjectType: StructType<{
             readonly command: ArrayType<StringType>;
         }>;
     }>;
+    /**
+     * Hash of an `EnvironmentSpecType` object the function executes in;
+     * `none` ⇒ the stock runtime image. Appended LAST (BEAST2 encodes struct
+     * fields positionally) with a legacy dual decoder — see
+     * {@link decodeFunctionObject}.
+     */
+    readonly environment: OptionType<StringType>;
 }>;
 export type FunctionObjectType = typeof FunctionObjectType;
 export type FunctionObject = ValueTypeOf<typeof FunctionObjectType>;
+/**
+ * Decode a `FunctionObject` from BEAST2 bytes, tolerating the
+ * pre-`environment` wire format (dual-decode migration, like
+ * `decodePackageObject`).
+ *
+ * Every function-read path — local AND cloud — must use this instead of
+ * `decodeBeast2For(FunctionObjectType)` directly. Older bytes decode with
+ * `environment` defaulted to `none`.
+ */
+export declare function decodeFunctionObject(data: Uint8Array): FunctionObject;
 //# sourceMappingURL=function.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/function.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAgB,WAAW,EAAE,MAAM,eAAe,CAAC;AAG7F;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,wFAAwF;;IAExF;mEAC+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE/D,wEAAwE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAExE;oEACgE;;;;;;;;;;;;;;;EAEhE,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../src/function.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAgB,UAAU,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AAGhI;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,wFAAwF;;IAExF;mEAC+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE/D,wEAAwE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAExE;oEACgE;;;;;;;;;;;;;;;IAEhE;;;;;OAKG;;EAEH,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAiBpE;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAWrE"}

package/dist/src/function.js

@@ -15,7 +15,7 @@
  * loading the IR bundle, and so dynamic callers (CLI literal parsing,
  * non-TS clients) have the types they need to encode arguments.
  */
-import { StructType, StringType, ArrayType, EastTypeType } from '@elaraai/east';
+import { StructType, StringType, ArrayType, EastTypeType, OptionType, decodeBeast2For, none } from '@elaraai/east';
 import { RunnerType } from './runner.js';
 /**
  * Function object stored in the object store, referenced by name from
@@ -32,5 +32,48 @@ export const FunctionObjectType = StructType({
     /** Author-chosen runtime; resolved to argv by runnerToArgv. One of the known
      *  runtime tags — there is no raw-argv runner for functions. */
     runner: RunnerType,
+    /**
+     * Hash of an `EnvironmentSpecType` object the function executes in;
+     * `none` ⇒ the stock runtime image. Appended LAST (BEAST2 encodes struct
+     * fields positionally) with a legacy dual decoder — see
+     * {@link decodeFunctionObject}.
+     */
+    environment: OptionType(StringType),
 });
+/**
+ * The pre-`environment` function object wire shape, kept only so
+ * {@link decodeFunctionObject} can read functions exported before execution
+ * environments existed.
+ */
+const PreEnvironmentFunctionObjectType = StructType({
+    bodyIr: StringType,
+    inputTypes: ArrayType(EastTypeType),
+    outputType: EastTypeType,
+    runner: RunnerType,
+});
+const decodeCurrentFunction = decodeBeast2For(FunctionObjectType);
+const decodePreEnvironmentFunction = decodeBeast2For(PreEnvironmentFunctionObjectType);
+/**
+ * Decode a `FunctionObject` from BEAST2 bytes, tolerating the
+ * pre-`environment` wire format (dual-decode migration, like
+ * `decodePackageObject`).
+ *
+ * Every function-read path — local AND cloud — must use this instead of
+ * `decodeBeast2For(FunctionObjectType)` directly. Older bytes decode with
+ * `environment` defaulted to `none`.
+ */
+export function decodeFunctionObject(data) {
+    try {
+        return decodeCurrentFunction(data);
+    }
+    catch (err) {
+        try {
+            const legacy = decodePreEnvironmentFunction(data);
+            return { ...legacy, environment: none };
+        }
+        catch {
+            throw err; // no known shape — surface the current-format error
+        }
+    }
+}
 //# sourceMappingURL=function.js.map

package/dist/src/function.js.map

@@ -1 +1 @@
-{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/function.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAe,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,wFAAwF;IACxF,MAAM,EAAE,UAAU;IAClB;mEAC+D;IAC/D,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;IACnC,wEAAwE;IACxE,UAAU,EAAE,YAAY;IACxB;oEACgE;IAChE,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC"}
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../src/function.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAe,eAAe,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChI,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,wFAAwF;IACxF,MAAM,EAAE,UAAU;IAClB;mEAC+D;IAC/D,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;IACnC,wEAAwE;IACxE,UAAU,EAAE,YAAY;IACxB;oEACgE;IAChE,MAAM,EAAE,UAAU;IAClB;;;;;OAKG;IACH,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAKH;;;;GAIG;AACH,MAAM,gCAAgC,GAAG,UAAU,CAAC;IAClD,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;IACnC,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC;AAClE,MAAM,4BAA4B,GAAG,eAAe,CAAC,gCAAgC,CAAC,CAAC;AAEvF;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;YAClD,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,CAAC,CAAC,oDAAoD;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/index.d.ts

@@ -22,10 +22,11 @@
  */
 export { DataRefType, type DataRef, unassignedRef, nullRef, DataTreeType, } from './dataset.js';
 export { VersionVectorType, type VersionVector, DatasetRefType, type DatasetRef, } from './dataset-ref.js';
-export { TaskObjectType, type TaskObject, } from './task.js';
+export { TaskObjectType, type TaskObject, decodeTaskObject, } from './task.js';
+export { EnvironmentSpecType, type EnvironmentSpec, PythonEnvironmentType, type PythonEnvironment, NodeEnvironmentType, type NodeEnvironment, ImageEnvironmentType, type ImageEnvironment, environmentSpecObjectHashes, } from './environment.js';
 export { StructureType, type Structure, PathSegmentType, type PathSegment, TreePathType, type TreePath, type ParsePathResult, type ParseDatasetPathResult, type ParsePackageRefResult, treePath, pathToString, parsePath, parseDatasetPath, parsePackageRef, urlPathToTreePath, DatasetSchemaType, type DatasetSchema, } from './structure.js';
 export { RunnerType, type RunnerValue, runnerToArgv, } from './runner.js';
-export { FunctionObjectType, type FunctionObject, } from './function.js';
+export { FunctionObjectType, type FunctionObject, decodeFunctionObject, } from './function.js';
 export { RecordCommitType, type RecordCommit, MutationObjectType, type MutationObject, RecordObjectType, type RecordObject, } from './record.js';
 export { PackageDataType, type PackageData, PackageObjectType, type PackageObject, decodePackageObject, PackageDatasetsType, type PackageDatasets, PackageTransferInitRequestType, type PackageTransferInitRequest, PackageTransferInitResponseType, type PackageTransferInitResponse, PackageJobResponseType, type PackageJobResponse, PackageImportResultType, type PackageImportResult, PackageExportResultType, type PackageExportResult, PackageImportProgressType, type PackageImportProgress, PackageImportStatusType, type PackageImportStatus, PackageExportProgressType, type PackageExportProgress, PackageExportStatusType, type PackageExportStatus, } from './package.js';
 export { WorkspaceStateType, type WorkspaceState, } from './workspace.js';

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

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

package/dist/src/index.js

@@ -25,7 +25,9 @@ export { DataRefType, unassignedRef, nullRef, DataTreeType, } from './dataset.js
 // Per-dataset refs and version vectors (reactive dataflow)
 export { VersionVectorType, DatasetRefType, } from './dataset-ref.js';
 // Task definitions
-export { TaskObjectType, } from './task.js';
+export { TaskObjectType, decodeTaskObject, } from './task.js';
+// Execution environments
+export { EnvironmentSpecType, PythonEnvironmentType, NodeEnvironmentType, ImageEnvironmentType, environmentSpecObjectHashes, } from './environment.js';
 // Data structure and paths
 export { StructureType, PathSegmentType, TreePathType, treePath, pathToString, parsePath, parseDatasetPath, parsePackageRef, urlPathToTreePath, 
 // Backwards compatibility
@@ -33,7 +35,7 @@ DatasetSchemaType, } from './structure.js';
 // Runner wire types (functions)
 export { RunnerType, runnerToArgv, } from './runner.js';
 // Function objects
-export { FunctionObjectType, } from './function.js';
+export { FunctionObjectType, decodeFunctionObject, } from './function.js';
 // Record objects
 export { RecordCommitType, MutationObjectType, RecordObjectType, } from './record.js';
 // Package objects

package/dist/src/index.js.map

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

package/dist/src/task.d.ts

@@ -86,7 +86,23 @@ export declare const TaskObjectType: StructType<{
             readonly command: ArrayType<StringType>;
         }>;
     }>;
+    /**
+     * Hash of an {@link EnvironmentSpecType} object the task executes in;
+     * `none` ⇒ the stock runtime image. Appended LAST (BEAST2 encodes struct
+     * fields positionally) with a legacy dual decoder — see
+     * {@link decodeTaskObject}.
+     */
+    readonly environment: OptionType<StringType>;
 }>;
 export type TaskObjectType = typeof TaskObjectType;
 export type TaskObject = ValueTypeOf<typeof TaskObjectType>;
+/**
+ * Decode a `TaskObject` from BEAST2 bytes, tolerating the pre-`environment`
+ * wire format (dual-decode migration, like {@link decodePackageObject}).
+ *
+ * Every task-read path — local AND cloud — must use this instead of
+ * `decodeBeast2For(TaskObjectType)` directly. Older bytes decode with
+ * `environment` defaulted to `none`.
+ */
+export declare function decodeTaskObject(data: Uint8Array): TaskObject;
 //# sourceMappingURL=task.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc;IACzB,kFAAkF;;IAElF,uEAAuE;;;;IAEvE,sEAAsE;;;;IAEtE,sFAAsF;;IAEtF,6FAA6F;;IAE7F;;;;;;;OAOG;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC"}
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AAI5H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc;IACzB,kFAAkF;;IAElF,uEAAuE;;;;IAEvE,sEAAsE;;;;IAEtE,sFAAsF;;IAEtF,6FAA6F;;IAE7F;;;;;;;OAOG;;;;;;;;;;;;;;;IAEH;;;;;OAKG;;EAEH,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAmB5D;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAW7D"}

package/dist/src/task.js

@@ -14,7 +14,7 @@
  * Input and output types are inferred from the package's structure at the
  * specified paths - the task just references locations, not types.
  */
-import { StructType, StringType, ArrayType, BlobType, OptionType } from '@elaraai/east';
+import { StructType, StringType, ArrayType, BlobType, OptionType, decodeBeast2For, none } from '@elaraai/east';
 import { TreePathType } from './structure.js';
 import { RunnerType } from './runner.js';
 /**
@@ -71,5 +71,49 @@ export const TaskObjectType = StructType({
      * older SDKs must be re-exported.
      */
     runner: RunnerType,
+    /**
+     * Hash of an {@link EnvironmentSpecType} object the task executes in;
+     * `none` ⇒ the stock runtime image. Appended LAST (BEAST2 encodes struct
+     * fields positionally) with a legacy dual decoder — see
+     * {@link decodeTaskObject}.
+     */
+    environment: OptionType(StringType),
+});
+/**
+ * The pre-`environment` task object wire shape, kept only so
+ * {@link decodeTaskObject} can read tasks exported before execution
+ * environments existed.
+ */
+const PreEnvironmentTaskObjectType = StructType({
+    commandIr: StringType,
+    inputs: ArrayType(TreePathType),
+    output: TreePathType,
+    kind: OptionType(StringType),
+    metadata: OptionType(BlobType),
+    runner: RunnerType,
 });
+const decodeCurrentTask = decodeBeast2For(TaskObjectType);
+const decodePreEnvironmentTask = decodeBeast2For(PreEnvironmentTaskObjectType);
+/**
+ * Decode a `TaskObject` from BEAST2 bytes, tolerating the pre-`environment`
+ * wire format (dual-decode migration, like {@link decodePackageObject}).
+ *
+ * Every task-read path — local AND cloud — must use this instead of
+ * `decodeBeast2For(TaskObjectType)` directly. Older bytes decode with
+ * `environment` defaulted to `none`.
+ */
+export function decodeTaskObject(data) {
+    try {
+        return decodeCurrentTask(data);
+    }
+    catch (err) {
+        try {
+            const legacy = decodePreEnvironmentTask(data);
+            return { ...legacy, environment: none };
+        }
+        catch {
+            throw err; // no known shape — surface the current-format error
+        }
+    }
+}
 //# sourceMappingURL=task.js.map

package/dist/src/task.js.map

@@ -1 +1 @@
-{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,kFAAkF;IAClF,SAAS,EAAE,UAAU;IACrB,uEAAuE;IACvE,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC;IAC/B,sEAAsE;IACtE,MAAM,EAAE,YAAY;IACpB,sFAAsF;IACtF,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,6FAA6F;IAC7F,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC;IAC9B;;;;;;;OAOG;IACH,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC"}
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAe,eAAe,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC5H,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,kFAAkF;IAClF,SAAS,EAAE,UAAU;IACrB,uEAAuE;IACvE,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC;IAC/B,sEAAsE;IACtE,MAAM,EAAE,YAAY;IACpB,sFAAsF;IACtF,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,6FAA6F;IAC7F,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC;IAC9B;;;;;;;OAOG;IACH,MAAM,EAAE,UAAU;IAClB;;;;;OAKG;IACH,WAAW,EAAE,UAAU,CAAC,UAAU,CAAC;CACpC,CAAC,CAAC;AAKH;;;;GAIG;AACH,MAAM,4BAA4B,GAAG,UAAU,CAAC;IAC9C,SAAS,EAAE,UAAU;IACrB,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC;IAC/B,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC;IAC9B,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;AAC1D,MAAM,wBAAwB,GAAG,eAAe,CAAC,4BAA4B,CAAC,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB;IAC/C,IAAI,CAAC;QACH,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,CAAC,CAAC,oDAAoD;QACjE,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/e3-types",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "description": "Shared type definitions for e3 (East Execution Engine)",
   "type": "module",
   "main": "dist/src/index.js",
@@ -18,7 +18,7 @@
     "directory": "libs/e3/packages/e3-types"
   },
   "peerDependencies": {
-    "@elaraai/east": "1.0.28"
+    "@elaraai/east": "1.0.29"
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^8.47.0",

package/src/environment.ts

@@ -0,0 +1,127 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+
+/**
+ * Execution environment types for e3.
+ *
+ * An environment spec describes everything a worker needs to materialize the
+ * runtime environment a task or function executes in — beyond the stock
+ * runtime image. It is stored as a content-addressed object; tasks and
+ * functions reference it by hash (`environment` field), so identical
+ * environments dedupe and the environment hash transitively folds the user's
+ * implementation code (via lockfile + sdist/tarball hashes) into execution
+ * cache identity.
+ *
+ * All fields hold object-store hashes, never inline file contents: the blobs
+ * ride the existing content-addressed object store and transfer machinery.
+ */
+
+import { ArrayType, StringType, StructType, ValueTypeOf, VariantType } from '@elaraai/east';
+
+/**
+ * A Python (uv) project environment.
+ *
+ * Materialized by creating a venv from the locked dependency set
+ * (`uv sync --frozen`) and installing the project's own sdists into it.
+ *
+ * @remarks
+ * - `pyproject`: object hash of the project's `pyproject.toml` blob.
+ * - `lock`: object hash of the `uv.lock` blob — pins the full closure.
+ * - `sdists`: the project's own source distributions (`uv build --sdist`) —
+ *   the user's platform-function implementation code — installed in order
+ *   after the sync. Each entry carries the original filename because
+ *   Python installers derive the package name from `name-version.tar.gz`
+ *   and reject a renamed file.
+ */
+export const PythonEnvironmentType = StructType({
+  /** Object hash of the pyproject.toml blob */
+  pyproject: StringType,
+  /** Object hash of the uv.lock blob */
+  lock: StringType,
+  /** Project sdist blobs (original filename + object hash), in install order */
+  sdists: ArrayType(StructType({ filename: StringType, hash: StringType })),
+});
+export type PythonEnvironmentType = typeof PythonEnvironmentType;
+export type PythonEnvironment = ValueTypeOf<typeof PythonEnvironmentType>;
+
+/**
+ * A Node (npm/pnpm) project environment.
+ *
+ * Materialized by installing the locked dependency set and then the
+ * project's own packed tarballs (`npm pack`).
+ *
+ * @remarks
+ * - `packageJson`: object hash of the project's `package.json` blob.
+ * - `lock`: object hash of the lockfile blob (`package-lock.json` or
+ *   `pnpm-lock.yaml`).
+ * - `tarballs`: object hashes of `npm pack` tarballs of the project's own
+ *   package(s), installed in order.
+ */
+export const NodeEnvironmentType = StructType({
+  /** Object hash of the package.json blob */
+  packageJson: StringType,
+  /** Object hash of the lockfile blob */
+  lock: StringType,
+  /** Object hashes of npm-pack tarball blobs, in install order */
+  tarballs: ArrayType(StringType),
+});
+export type NodeEnvironmentType = typeof NodeEnvironmentType;
+export type NodeEnvironment = ValueTypeOf<typeof NodeEnvironmentType>;
+
+/**
+ * A user-controlled container image environment.
+ *
+ * The catch-all tier for CUDA bases, system libraries, or custom native
+ * runtimes. Executed by running the task's argv inside the referenced image.
+ *
+ * @remarks
+ * `digest` must be a full immutable digest reference
+ * (`repo@sha256:<64 hex>`); mutable tags are rejected at definition time so
+ * the environment hash cannot silently drift.
+ */
+export const ImageEnvironmentType = StructType({
+  /** Full image digest reference: `repo@sha256:<64 hex chars>` */
+  digest: StringType,
+});
+export type ImageEnvironmentType = typeof ImageEnvironmentType;
+export type ImageEnvironment = ValueTypeOf<typeof ImageEnvironmentType>;
+
+/**
+ * An execution environment specification.
+ *
+ * Stored beast2-encoded in the object store; the **environment hash** is the
+ * object hash of the encoded spec. A task/function with no environment
+ * (`none`) runs on the stock runtime image as today.
+ */
+export const EnvironmentSpecType = VariantType({
+  /** Python (uv) project environment */
+  python: PythonEnvironmentType,
+  /** Node project environment */
+  node: NodeEnvironmentType,
+  /** Custom container image environment */
+  image: ImageEnvironmentType,
+});
+export type EnvironmentSpecType = typeof EnvironmentSpecType;
+export type EnvironmentSpec = ValueTypeOf<typeof EnvironmentSpecType>;
+
+/**
+ * Lists the object-store hashes an environment spec references.
+ *
+ * Every reachability walker (package export closure, GC) must include these
+ * so environment blobs transfer with the package and survive collection.
+ *
+ * @param spec - The environment spec to walk
+ * @returns The referenced blob hashes (empty for `image` environments)
+ */
+export function environmentSpecObjectHashes(spec: EnvironmentSpec): string[] {
+  switch (spec.type) {
+    case 'python':
+      return [spec.value.pyproject, spec.value.lock, ...spec.value.sdists.map((s) => s.hash)];
+    case 'node':
+      return [spec.value.packageJson, spec.value.lock, ...spec.value.tarballs];
+    case 'image':
+      return [];
+  }
+}

package/src/function.ts

@@ -17,7 +17,7 @@
  * non-TS clients) have the types they need to encode arguments.
  */
 
-import { StructType, StringType, ArrayType, EastTypeType, ValueTypeOf } from '@elaraai/east';
+import { StructType, StringType, ArrayType, EastTypeType, OptionType, ValueTypeOf, decodeBeast2For, none } from '@elaraai/east';
 import { RunnerType } from './runner.js';
 
 /**
@@ -35,7 +35,51 @@ export const FunctionObjectType = StructType({
   /** Author-chosen runtime; resolved to argv by runnerToArgv. One of the known
    *  runtime tags — there is no raw-argv runner for functions. */
   runner: RunnerType,
+  /**
+   * Hash of an `EnvironmentSpecType` object the function executes in;
+   * `none` ⇒ the stock runtime image. Appended LAST (BEAST2 encodes struct
+   * fields positionally) with a legacy dual decoder — see
+   * {@link decodeFunctionObject}.
+   */
+  environment: OptionType(StringType),
 });
 export type FunctionObjectType = typeof FunctionObjectType;
 
 export type FunctionObject = ValueTypeOf<typeof FunctionObjectType>;
+
+/**
+ * The pre-`environment` function object wire shape, kept only so
+ * {@link decodeFunctionObject} can read functions exported before execution
+ * environments existed.
+ */
+const PreEnvironmentFunctionObjectType = StructType({
+  bodyIr: StringType,
+  inputTypes: ArrayType(EastTypeType),
+  outputType: EastTypeType,
+  runner: RunnerType,
+});
+
+const decodeCurrentFunction = decodeBeast2For(FunctionObjectType);
+const decodePreEnvironmentFunction = decodeBeast2For(PreEnvironmentFunctionObjectType);
+
+/**
+ * Decode a `FunctionObject` from BEAST2 bytes, tolerating the
+ * pre-`environment` wire format (dual-decode migration, like
+ * `decodePackageObject`).
+ *
+ * Every function-read path — local AND cloud — must use this instead of
+ * `decodeBeast2For(FunctionObjectType)` directly. Older bytes decode with
+ * `environment` defaulted to `none`.
+ */
+export function decodeFunctionObject(data: Uint8Array): FunctionObject {
+  try {
+    return decodeCurrentFunction(data);
+  } catch (err) {
+    try {
+      const legacy = decodePreEnvironmentFunction(data);
+      return { ...legacy, environment: none };
+    } catch {
+      throw err; // no known shape — surface the current-format error
+    }
+  }
+}

package/src/index.ts

@@ -43,8 +43,22 @@ export {
 export {
   TaskObjectType,
   type TaskObject,
+  decodeTaskObject,
 } from './task.js';
 
+// Execution environments
+export {
+  EnvironmentSpecType,
+  type EnvironmentSpec,
+  PythonEnvironmentType,
+  type PythonEnvironment,
+  NodeEnvironmentType,
+  type NodeEnvironment,
+  ImageEnvironmentType,
+  type ImageEnvironment,
+  environmentSpecObjectHashes,
+} from './environment.js';
+
 // Data structure and paths
 export {
   StructureType,
@@ -78,6 +92,7 @@ export {
 export {
   FunctionObjectType,
   type FunctionObject,
+  decodeFunctionObject,
 } from './function.js';
 
 // Record objects

package/src/task.ts

@@ -16,7 +16,7 @@
  * specified paths - the task just references locations, not types.
  */
 
-import { StructType, StringType, ArrayType, BlobType, OptionType, ValueTypeOf } from '@elaraai/east';
+import { StructType, StringType, ArrayType, BlobType, OptionType, ValueTypeOf, decodeBeast2For, none } from '@elaraai/east';
 import { TreePathType } from './structure.js';
 import { RunnerType } from './runner.js';
 
@@ -74,7 +74,52 @@ export const TaskObjectType = StructType({
    * older SDKs must be re-exported.
    */
   runner: RunnerType,
+  /**
+   * Hash of an {@link EnvironmentSpecType} object the task executes in;
+   * `none` ⇒ the stock runtime image. Appended LAST (BEAST2 encodes struct
+   * fields positionally) with a legacy dual decoder — see
+   * {@link decodeTaskObject}.
+   */
+  environment: OptionType(StringType),
 });
 export type TaskObjectType = typeof TaskObjectType;
 
 export type TaskObject = ValueTypeOf<typeof TaskObjectType>;
+
+/**
+ * The pre-`environment` task object wire shape, kept only so
+ * {@link decodeTaskObject} can read tasks exported before execution
+ * environments existed.
+ */
+const PreEnvironmentTaskObjectType = StructType({
+  commandIr: StringType,
+  inputs: ArrayType(TreePathType),
+  output: TreePathType,
+  kind: OptionType(StringType),
+  metadata: OptionType(BlobType),
+  runner: RunnerType,
+});
+
+const decodeCurrentTask = decodeBeast2For(TaskObjectType);
+const decodePreEnvironmentTask = decodeBeast2For(PreEnvironmentTaskObjectType);
+
+/**
+ * Decode a `TaskObject` from BEAST2 bytes, tolerating the pre-`environment`
+ * wire format (dual-decode migration, like {@link decodePackageObject}).
+ *
+ * Every task-read path — local AND cloud — must use this instead of
+ * `decodeBeast2For(TaskObjectType)` directly. Older bytes decode with
+ * `environment` defaulted to `none`.
+ */
+export function decodeTaskObject(data: Uint8Array): TaskObject {
+  try {
+    return decodeCurrentTask(data);
+  } catch (err) {
+    try {
+      const legacy = decodePreEnvironmentTask(data);
+      return { ...legacy, environment: none };
+    } catch {
+      throw err; // no known shape — surface the current-format error
+    }
+  }
+}