@elaraai/e3-types 1.0.30 → 1.0.31

package/dist/src/environment.d.ts

@@ -16,7 +16,7 @@
  * 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';
+import { ArrayType, OptionType, StringType, StructType, ValueTypeOf, VariantType } from '@elaraai/east';
 /**
  * A Python (uv) project environment.
  *
@@ -85,12 +85,95 @@ export declare const ImageEnvironmentType: StructType<{
 }>;
 export type ImageEnvironmentType = typeof ImageEnvironmentType;
 export type ImageEnvironment = ValueTypeOf<typeof ImageEnvironmentType>;
+/**
+ * A prebuilt-file ("tools") environment for C and custom runners.
+ *
+ * e3 never builds anything for this kind: the developer builds their binary
+ * (or any prebuilt artifact) however they like, and capture folds the named
+ * files' bytes into the environment hash and materializes them onto the
+ * runner's PATH. Rebuilding a captured file changes its blob hash → the
+ * environment hash → the tasks that use it re-run. This closes the
+ * pre-existing hole where a custom-runner binary resolved from PATH was
+ * never part of the cache key, so a rebuild silently served stale outputs.
+ *
+ * @remarks
+ * - `files`: the captured files, sorted by `path` so capture order never
+ *   affects the environment hash.
+ *   - `path`: environment-dir-relative POSIX path; v1 writers emit
+ *     `bin/<basename>` (materialization writes it there and adds `bin` to
+ *     PATH). Validated at materialization: no absolute paths, no `..`, no
+ *     empty segments.
+ *   - `hash`: object hash of the file's bytes. No mode is stored:
+ *     materialization always applies a fixed mode, so an exec-bit-only
+ *     change does not alter the environment yet also cannot go stale.
+ */
+export declare const ToolsEnvironmentType: StructType<{
+    /** Captured files (env-relative path + object hash), sorted by path */
+    readonly files: ArrayType<StructType<{
+        readonly path: StringType;
+        readonly hash: StringType;
+    }>>;
+}>;
+export type ToolsEnvironmentType = typeof ToolsEnvironmentType;
+export type ToolsEnvironment = ValueTypeOf<typeof ToolsEnvironmentType>;
+/**
+ * A Node **workspace-member** environment (npm or pnpm workspaces).
+ *
+ * Where {@link NodeEnvironmentType} captures one self-contained project,
+ * this captures one member of a workspace together with the transitive
+ * closure of the local workspace packages it depends on — so editing a
+ * member's code re-runs only the environments whose closure contains it.
+ * Materialized by reconstructing a minimal workspace of exactly the closure
+ * members and running the frozen install against the verbatim root lock.
+ *
+ * @remarks
+ * - `packageJson`: object hash of the workspace **root** `package.json` blob.
+ * - `lock`: object hash of the **root** lockfile blob (content-sniffed as
+ *   today; npm in v1, pnpm once the pnpm capture path ships).
+ * - `config`: pnpm only — object hash of the capture-synthesized
+ *   `pnpm-workspace.yaml` blob; `none` for npm.
+ * - `subject`: workspace-relative POSIX path of the environment's own
+ *   member. Must satisfy `members.some((m) => m.path === subject)` — this is
+ *   enforced at capture and re-validated at materialization (BEAST2 typed
+ *   decode is structural only and cannot check it).
+ * - `members`: the dependency closure sorted by `path`; each carries its
+ *   package `name` (read from the member's `package.json` at capture) and
+ *   the object `hash` of its `npm pack` tarball.
+ */
+export declare const WorkspaceNodeEnvironmentType: StructType<{
+    /** Object hash of the workspace root package.json blob */
+    readonly packageJson: StringType;
+    /** Object hash of the root lockfile blob */
+    readonly lock: StringType;
+    /** pnpm only: object hash of the synthesized pnpm-workspace.yaml; none for npm */
+    readonly config: OptionType<StringType>;
+    /** Workspace-relative POSIX path of this environment's own member */
+    readonly subject: StringType;
+    /** Dependency closure (path + package name + tarball hash), sorted by path */
+    readonly members: ArrayType<StructType<{
+        readonly path: StringType;
+        readonly name: StringType;
+        readonly tarball: StringType;
+    }>>;
+}>;
+export type WorkspaceNodeEnvironmentType = typeof WorkspaceNodeEnvironmentType;
+export type WorkspaceNodeEnvironment = ValueTypeOf<typeof WorkspaceNodeEnvironmentType>;
 /**
  * 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.
+ *
+ * @remarks
+ * BEAST2 encodes a variant's tag as the index of its case in the
+ * **alphabetically sorted** case list, so the case order is load-bearing: a
+ * repo persists specs by that order, and reordering the cases in a later
+ * edit would re-tag every case after the insertion point and mis-decode
+ * already-stored specs. New cases must therefore be added so the sorted
+ * order only grows at the end (`tools` and `workspace_node` sort after the
+ * original three). The frozen-order guard test in `environment.spec.ts`
+ * turns an accidental reorder into a red test.
  */
 export declare const EnvironmentSpecType: VariantType<{
     /** Python (uv) project environment */
@@ -119,6 +202,31 @@ export declare const EnvironmentSpecType: VariantType<{
         /** Full image digest reference: `repo@sha256:<64 hex chars>` */
         readonly digest: StringType;
     }>;
+    /** Prebuilt-file environment for C / custom runners */
+    readonly tools: StructType<{
+        /** Captured files (env-relative path + object hash), sorted by path */
+        readonly files: ArrayType<StructType<{
+            readonly path: StringType;
+            readonly hash: StringType;
+        }>>;
+    }>;
+    /** Node workspace-member environment (npm/pnpm workspaces) */
+    readonly workspace_node: StructType<{
+        /** Object hash of the workspace root package.json blob */
+        readonly packageJson: StringType;
+        /** Object hash of the root lockfile blob */
+        readonly lock: StringType;
+        /** pnpm only: object hash of the synthesized pnpm-workspace.yaml; none for npm */
+        readonly config: OptionType<StringType>;
+        /** Workspace-relative POSIX path of this environment's own member */
+        readonly subject: StringType;
+        /** Dependency closure (path + package name + tarball hash), sorted by path */
+        readonly members: ArrayType<StructType<{
+            readonly path: StringType;
+            readonly name: StringType;
+            readonly tarball: StringType;
+        }>>;
+    }>;
 }>;
 export type EnvironmentSpecType = typeof EnvironmentSpecType;
 export type EnvironmentSpec = ValueTypeOf<typeof EnvironmentSpecType>;

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

@@ -1 +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"}
+{"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,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAExG;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB;IAC/B,uEAAuE;;;;;EAEvE,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,4BAA4B;IACvC,0DAA0D;;IAE1D,4CAA4C;;IAE5C,kFAAkF;;IAElF,qEAAqE;;IAErE,8EAA8E;;;;;;EAE9E,CAAC;AACH,MAAM,MAAM,4BAA4B,GAAG,OAAO,4BAA4B,CAAC;AAC/E,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAExF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,mBAAmB;IAC9B,sCAAsC;;QA1ItC,6CAA6C;;QAE7C,sCAAsC;;QAEtC,8EAA8E;;;;;;IAwI9E,+BAA+B;;QApH/B,2CAA2C;;QAE3C,uCAAuC;;QAEvC,gEAAgE;;;IAkHhE,yCAAyC;;QAhGzC,gEAAgE;;;IAkGhE,uDAAuD;;QArEvD,uEAAuE;;;;;;IAuEvE,8DAA8D;;QAxC9D,0DAA0D;;QAE1D,4CAA4C;;QAE5C,kFAAkF;;QAElF,qEAAqE;;QAErE,8EAA8E;;;;;;;EAkC9E,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,CAkB3E"}

package/dist/src/environment.js

@@ -16,7 +16,7 @@
  * 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';
+import { ArrayType, OptionType, StringType, StructType, VariantType } from '@elaraai/east';
 /**
  * A Python (uv) project environment.
  *
@@ -76,12 +76,84 @@ export const ImageEnvironmentType = StructType({
     /** Full image digest reference: `repo@sha256:<64 hex chars>` */
     digest: StringType,
 });
+/**
+ * A prebuilt-file ("tools") environment for C and custom runners.
+ *
+ * e3 never builds anything for this kind: the developer builds their binary
+ * (or any prebuilt artifact) however they like, and capture folds the named
+ * files' bytes into the environment hash and materializes them onto the
+ * runner's PATH. Rebuilding a captured file changes its blob hash → the
+ * environment hash → the tasks that use it re-run. This closes the
+ * pre-existing hole where a custom-runner binary resolved from PATH was
+ * never part of the cache key, so a rebuild silently served stale outputs.
+ *
+ * @remarks
+ * - `files`: the captured files, sorted by `path` so capture order never
+ *   affects the environment hash.
+ *   - `path`: environment-dir-relative POSIX path; v1 writers emit
+ *     `bin/<basename>` (materialization writes it there and adds `bin` to
+ *     PATH). Validated at materialization: no absolute paths, no `..`, no
+ *     empty segments.
+ *   - `hash`: object hash of the file's bytes. No mode is stored:
+ *     materialization always applies a fixed mode, so an exec-bit-only
+ *     change does not alter the environment yet also cannot go stale.
+ */
+export const ToolsEnvironmentType = StructType({
+    /** Captured files (env-relative path + object hash), sorted by path */
+    files: ArrayType(StructType({ path: StringType, hash: StringType })),
+});
+/**
+ * A Node **workspace-member** environment (npm or pnpm workspaces).
+ *
+ * Where {@link NodeEnvironmentType} captures one self-contained project,
+ * this captures one member of a workspace together with the transitive
+ * closure of the local workspace packages it depends on — so editing a
+ * member's code re-runs only the environments whose closure contains it.
+ * Materialized by reconstructing a minimal workspace of exactly the closure
+ * members and running the frozen install against the verbatim root lock.
+ *
+ * @remarks
+ * - `packageJson`: object hash of the workspace **root** `package.json` blob.
+ * - `lock`: object hash of the **root** lockfile blob (content-sniffed as
+ *   today; npm in v1, pnpm once the pnpm capture path ships).
+ * - `config`: pnpm only — object hash of the capture-synthesized
+ *   `pnpm-workspace.yaml` blob; `none` for npm.
+ * - `subject`: workspace-relative POSIX path of the environment's own
+ *   member. Must satisfy `members.some((m) => m.path === subject)` — this is
+ *   enforced at capture and re-validated at materialization (BEAST2 typed
+ *   decode is structural only and cannot check it).
+ * - `members`: the dependency closure sorted by `path`; each carries its
+ *   package `name` (read from the member's `package.json` at capture) and
+ *   the object `hash` of its `npm pack` tarball.
+ */
+export const WorkspaceNodeEnvironmentType = StructType({
+    /** Object hash of the workspace root package.json blob */
+    packageJson: StringType,
+    /** Object hash of the root lockfile blob */
+    lock: StringType,
+    /** pnpm only: object hash of the synthesized pnpm-workspace.yaml; none for npm */
+    config: OptionType(StringType),
+    /** Workspace-relative POSIX path of this environment's own member */
+    subject: StringType,
+    /** Dependency closure (path + package name + tarball hash), sorted by path */
+    members: ArrayType(StructType({ path: StringType, name: StringType, tarball: 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.
+ *
+ * @remarks
+ * BEAST2 encodes a variant's tag as the index of its case in the
+ * **alphabetically sorted** case list, so the case order is load-bearing: a
+ * repo persists specs by that order, and reordering the cases in a later
+ * edit would re-tag every case after the insertion point and mis-decode
+ * already-stored specs. New cases must therefore be added so the sorted
+ * order only grows at the end (`tools` and `workspace_node` sort after the
+ * original three). The frozen-order guard test in `environment.spec.ts`
+ * turns an accidental reorder into a red test.
  */
 export const EnvironmentSpecType = VariantType({
     /** Python (uv) project environment */
@@ -90,6 +162,10 @@ export const EnvironmentSpecType = VariantType({
     node: NodeEnvironmentType,
     /** Custom container image environment */
     image: ImageEnvironmentType,
+    /** Prebuilt-file environment for C / custom runners */
+    tools: ToolsEnvironmentType,
+    /** Node workspace-member environment (npm/pnpm workspaces) */
+    workspace_node: WorkspaceNodeEnvironmentType,
 });
 /**
  * Lists the object-store hashes an environment spec references.
@@ -108,6 +184,15 @@ export function environmentSpecObjectHashes(spec) {
             return [spec.value.packageJson, spec.value.lock, ...spec.value.tarballs];
         case 'image':
             return [];
+        case 'tools':
+            return spec.value.files.map((f) => f.hash);
+        case 'workspace_node':
+            return [
+                spec.value.packageJson,
+                spec.value.lock,
+                ...(spec.value.config.type === 'some' ? [spec.value.config.value] : []),
+                ...spec.value.members.map((m) => m.tarball),
+            ];
     }
 }
 //# sourceMappingURL=environment.js.map

package/dist/src/environment.js.map

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

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

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

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

package/dist/src/environment.spec.js

@@ -0,0 +1,90 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Encode/decode contract for {@link EnvironmentSpecType}.
+ *
+ * BEAST2 encodes a variant's tag as the index of its case in the
+ * alphabetically-sorted case list, so the case order is load-bearing: a repo
+ * persists specs by that order, and a later code edit that inserts a case
+ * before an existing one silently re-tags every later case and mis-decodes
+ * already-stored specs. The frozen-order test pins the order so that mistake
+ * is a red test; the round-trip tests pin the new cases.
+ */
+import { describe, it } from 'node:test';
+import * as assert from 'node:assert';
+import { encodeBeast2For, decodeBeast2For, variant, some, none } from '@elaraai/east';
+import { EnvironmentSpecType, environmentSpecObjectHashes, } from './environment.js';
+const encodeCurrent = encodeBeast2For(EnvironmentSpecType);
+const decodeCurrent = decodeBeast2For(EnvironmentSpecType);
+const H = (c) => c.repeat(64); // stand-in 64-hex object hash
+describe('EnvironmentSpecType frozen case order', () => {
+    it('is exactly [image, node, python, tools, workspace_node]', () => {
+        // BEAST2 tags are indices into this sorted list. A new case must be
+        // added so the order only grows at the end (or readers must migrate to
+        // name-based decoding first) — inserting before an existing case
+        // re-tags every later one and mis-decodes stored specs. This assertion
+        // turns that mistake into a red test.
+        assert.deepStrictEqual(Object.keys(EnvironmentSpecType.cases), ['image', 'node', 'python', 'tools', 'workspace_node']);
+    });
+});
+describe('EnvironmentSpecType round-trips every case', () => {
+    const specs = [
+        variant('python', { pyproject: H('a'), lock: H('b'), sdists: [{ filename: 'pricing-1.0.0.tar.gz', hash: H('c') }] }),
+        variant('node', { packageJson: H('d'), lock: H('e'), tarballs: [H('f')] }),
+        variant('image', { digest: `repo@sha256:${H('0')}` }),
+        variant('tools', { files: [{ path: 'bin/my-runner', hash: H('1') }] }),
+        variant('workspace_node', {
+            packageJson: H('2'), lock: H('3'), config: none, subject: 'packages/pricing',
+            members: [{ path: 'packages/pricing', name: '@acme/pricing', tarball: H('4') }],
+        }),
+    ];
+    it('encodes and decodes back to the same value', () => {
+        for (const spec of specs) {
+            assert.deepStrictEqual(decodeCurrent(encodeCurrent(spec)), spec);
+        }
+    });
+    it('round-trips a workspace_node spec carrying a pnpm config blob and multiple members', () => {
+        const withConfig = variant('workspace_node', {
+            packageJson: H('2'), lock: H('3'), config: some(H('5')), subject: 'packages/pricing',
+            members: [
+                { path: 'packages/common', name: '@acme/common', tarball: H('6') },
+                { path: 'packages/pricing', name: '@acme/pricing', tarball: H('7') },
+            ],
+        });
+        assert.deepStrictEqual(decodeCurrent(encodeCurrent(withConfig)), withConfig);
+    });
+});
+describe('environmentSpecObjectHashes', () => {
+    it('lists python blobs', () => {
+        assert.deepStrictEqual(environmentSpecObjectHashes(variant('python', {
+            pyproject: 'p', lock: 'l',
+            sdists: [{ filename: 'a-1.0.tar.gz', hash: 's1' }, { filename: 'b-1.0.tar.gz', hash: 's2' }],
+        })), ['p', 'l', 's1', 's2']);
+    });
+    it('lists node blobs', () => {
+        assert.deepStrictEqual(environmentSpecObjectHashes(variant('node', { packageJson: 'p', lock: 'l', tarballs: ['t'] })), ['p', 'l', 't']);
+    });
+    it('lists nothing for image', () => {
+        assert.deepStrictEqual(environmentSpecObjectHashes(variant('image', { digest: `repo@sha256:${H('0')}` })), []);
+    });
+    it('lists every tools file hash', () => {
+        assert.deepStrictEqual(environmentSpecObjectHashes(variant('tools', {
+            files: [{ path: 'bin/a', hash: 'h1' }, { path: 'bin/b', hash: 'h2' }],
+        })), ['h1', 'h2']);
+    });
+    it('lists workspace_node blobs including the config when present', () => {
+        assert.deepStrictEqual(environmentSpecObjectHashes(variant('workspace_node', {
+            packageJson: 'p', lock: 'l', config: some('cfg'), subject: 'packages/x',
+            members: [{ path: 'packages/x', name: '@acme/x', tarball: 't1' }, { path: 'packages/y', name: '@acme/y', tarball: 't2' }],
+        })), ['p', 'l', 'cfg', 't1', 't2']);
+    });
+    it('omits the config hash for an npm workspace_node (none)', () => {
+        assert.deepStrictEqual(environmentSpecObjectHashes(variant('workspace_node', {
+            packageJson: 'p', lock: 'l', config: none, subject: 'packages/x',
+            members: [{ path: 'packages/x', name: '@acme/x', tarball: 't1' }],
+        })), ['p', 'l', 't1']);
+    });
+});
+//# sourceMappingURL=environment.spec.js.map

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

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

package/dist/src/index.d.ts

@@ -23,9 +23,9 @@
 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, decodeTaskObject, } from './task.js';
-export { EnvironmentSpecType, type EnvironmentSpec, PythonEnvironmentType, type PythonEnvironment, NodeEnvironmentType, type NodeEnvironment, ImageEnvironmentType, type ImageEnvironment, environmentSpecObjectHashes, } from './environment.js';
+export { EnvironmentSpecType, type EnvironmentSpec, PythonEnvironmentType, type PythonEnvironment, NodeEnvironmentType, type NodeEnvironment, ImageEnvironmentType, type ImageEnvironment, ToolsEnvironmentType, type ToolsEnvironment, WorkspaceNodeEnvironmentType, type WorkspaceNodeEnvironment, 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 { RunnerType, type RunnerValue, runnerToArgv, withRunnerVerbose, } from './runner.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';

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

@@ -27,13 +27,13 @@ export { VersionVectorType, DatasetRefType, } from './dataset-ref.js';
 // Task definitions
 export { TaskObjectType, decodeTaskObject, } from './task.js';
 // Execution environments
-export { EnvironmentSpecType, PythonEnvironmentType, NodeEnvironmentType, ImageEnvironmentType, environmentSpecObjectHashes, } from './environment.js';
+export { EnvironmentSpecType, PythonEnvironmentType, NodeEnvironmentType, ImageEnvironmentType, ToolsEnvironmentType, WorkspaceNodeEnvironmentType, environmentSpecObjectHashes, } from './environment.js';
 // Data structure and paths
 export { StructureType, PathSegmentType, TreePathType, treePath, pathToString, parsePath, parseDatasetPath, parsePackageRef, urlPathToTreePath, 
 // Backwards compatibility
 DatasetSchemaType, } from './structure.js';
 // Runner wire types (functions)
-export { RunnerType, runnerToArgv, } from './runner.js';
+export { RunnerType, runnerToArgv, withRunnerVerbose, } from './runner.js';
 // Function objects
 export { FunctionObjectType, decodeFunctionObject, } from './function.js';
 // Record 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/runner.d.ts

@@ -52,4 +52,25 @@ export type RunnerValue = ValueTypeOf<typeof RunnerType>;
  * (`east-node`) here.
  */
 export declare function runnerToArgv(r: RunnerValue): 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`) 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>, 'run', …]` (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[];
 //# sourceMappingURL=runner.d.ts.map

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;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAOrD"}
+{"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;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,EAAE,CAOrD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAGlG"}

package/dist/src/runner.js

@@ -52,4 +52,29 @@ export function runnerToArgv(r) {
         case 'custom': 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`) 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>, 'run', …]` (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)];
+}
 //# sourceMappingURL=runner.js.map

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;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,CAAc;IACzC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,SAAS,CAAC,CAAG,OAAO,CAAC,SAAS,EAAI,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,QAAQ,CAAC,CAAI,OAAO,CAAC,QAAQ,EAAK,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,QAAQ,CAAC,CAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}
+{"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;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,CAAc;IACzC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,WAAW,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,SAAS,CAAC,CAAG,OAAO,CAAC,SAAS,EAAI,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,QAAQ,CAAC,CAAI,OAAO,CAAC,QAAQ,EAAK,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3E,KAAK,QAAQ,CAAC,CAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,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"}

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

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

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

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

package/dist/src/runner.spec.js

@@ -0,0 +1,68 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Gating contract for {@link withRunnerVerbose}.
+ *
+ * `-v` is a pure runtime toggle: it is spliced into an already-built argv just
+ * before spawn. These tests pin the two things that make it safe — it reaches
+ * the known runtimes (which all accept `-v`) at the right argv position, and it
+ * never touches a `custom` runner's user-authored command. Because it only
+ * rewrites the argv (never the runner variant or any hash), it is
+ * cache-irrelevant by construction.
+ */
+import { describe, it } from 'node:test';
+import * as assert from 'node:assert';
+import { variant } from '@elaraai/east';
+import { runnerToArgv, withRunnerVerbose } from './runner.js';
+/** A realistic fully-built argv: runner prefix + the `-i`/`-o`/`<ir>` suffix. */
+function fullArgv(runner) {
+    return [...runnerToArgv(runner), '-i', 'in.beast2', '-o', 'out.beast2', 'body.beast2'];
+}
+const KNOWN = [
+    ['east_node', variant('east_node', { platforms: ['@elaraai/east-node-std'] }), 'east-node'],
+    ['east_py', variant('east_py', { platforms: ['east-py-std'] }), 'east-py'],
+    ['east_c', variant('east_c', { platforms: ['east-c-std'] }), 'east-c'],
+];
+describe('withRunnerVerbose', () => {
+    for (const [tag, runner, bin] of KNOWN) {
+        it(`inserts -v after the 'run' subcommand for ${tag}`, () => {
+            const args = fullArgv(runner);
+            const out = withRunnerVerbose(runner, args, true);
+            // `[<bin>, 'run', '-v', …rest]` — position 2, ahead of -p/-i/-o and the IR.
+            assert.deepStrictEqual(out.slice(0, 3), [bin, 'run', '-v']);
+            // Exactly one -v, and the rest of the argv is preserved in order.
+            assert.strictEqual(out.filter((a) => a === '-v').length, 1);
+            assert.deepStrictEqual(out.slice(3), args.slice(2));
+            // The IR path is still last.
+            assert.strictEqual(out[out.length - 1], 'body.beast2');
+        });
+        it(`leaves the argv untouched when verbose is off for ${tag}`, () => {
+            const args = fullArgv(runner);
+            assert.deepStrictEqual(withRunnerVerbose(runner, args, false), args);
+            assert.deepStrictEqual(withRunnerVerbose(runner, args, undefined), args);
+        });
+    }
+    it('never splices -v into a custom runner (user-authored argv)', () => {
+        const runner = variant('custom', { command: ['uv', 'run', 'east-py', 'run'] });
+        const args = fullArgv(runner);
+        // Even with verbose requested, a custom command is passed through verbatim —
+        // we cannot know it understands `-v`.
+        assert.deepStrictEqual(withRunnerVerbose(runner, args, true), args);
+        assert.ok(!withRunnerVerbose(runner, args, true).includes('-v'));
+    });
+    it('does not mutate the input argv (returns a new array)', () => {
+        const runner = variant('east_node', { platforms: ['@elaraai/east-node-std'] });
+        const args = fullArgv(runner);
+        const before = [...args];
+        withRunnerVerbose(runner, args, true);
+        assert.deepStrictEqual(args, before, 'input array must be unchanged');
+    });
+    it('is a no-op on a degenerate (too-short) argv rather than throwing', () => {
+        const runner = variant('east_node', { platforms: [] });
+        assert.deepStrictEqual(withRunnerVerbose(runner, ['east-node'], true), ['east-node']);
+        assert.deepStrictEqual(withRunnerVerbose(runner, [], true), []);
+    });
+});
+//# sourceMappingURL=runner.spec.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/e3-types",
-  "version": "1.0.30",
+  "version": "1.0.31",
   "description": "Shared type definitions for e3 (East Execution Engine)",
   "type": "module",
   "main": "dist/src/index.js",
@@ -18,9 +18,10 @@
     "directory": "libs/e3/packages/e3-types"
   },
   "peerDependencies": {
-    "@elaraai/east": "1.0.30"
+    "@elaraai/east": "1.0.31"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@typescript-eslint/eslint-plugin": "^8.47.0",
     "@typescript-eslint/parser": "^8.47.0",
     "eslint-plugin-headers": "^1.3.3",
@@ -29,6 +30,7 @@
   "scripts": {
     "build": "tsc",
     "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
+    "lint:fix": "eslint . --fix",
+    "test": "npm run build && node --enable-source-maps --test-reporter=spec --test 'dist/src/**/*.spec.js'"
   }
 }

package/src/environment.spec.ts

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+
+/**
+ * Encode/decode contract for {@link EnvironmentSpecType}.
+ *
+ * BEAST2 encodes a variant's tag as the index of its case in the
+ * alphabetically-sorted case list, so the case order is load-bearing: a repo
+ * persists specs by that order, and a later code edit that inserts a case
+ * before an existing one silently re-tags every later case and mis-decodes
+ * already-stored specs. The frozen-order test pins the order so that mistake
+ * is a red test; the round-trip tests pin the new cases.
+ */
+
+import { describe, it } from 'node:test';
+import * as assert from 'node:assert';
+import { encodeBeast2For, decodeBeast2For, variant, some, none } from '@elaraai/east';
+import {
+  EnvironmentSpecType,
+  environmentSpecObjectHashes,
+  type EnvironmentSpec,
+} from './environment.js';
+
+const encodeCurrent = encodeBeast2For(EnvironmentSpecType);
+const decodeCurrent = decodeBeast2For(EnvironmentSpecType);
+
+const H = (c: string): string => c.repeat(64); // stand-in 64-hex object hash
+
+describe('EnvironmentSpecType frozen case order', () => {
+  it('is exactly [image, node, python, tools, workspace_node]', () => {
+    // BEAST2 tags are indices into this sorted list. A new case must be
+    // added so the order only grows at the end (or readers must migrate to
+    // name-based decoding first) — inserting before an existing case
+    // re-tags every later one and mis-decodes stored specs. This assertion
+    // turns that mistake into a red test.
+    assert.deepStrictEqual(
+      Object.keys((EnvironmentSpecType as unknown as { cases: Record<string, unknown> }).cases),
+      ['image', 'node', 'python', 'tools', 'workspace_node'],
+    );
+  });
+});
+
+describe('EnvironmentSpecType round-trips every case', () => {
+  const specs: EnvironmentSpec[] = [
+    variant('python', { pyproject: H('a'), lock: H('b'), sdists: [{ filename: 'pricing-1.0.0.tar.gz', hash: H('c') }] }),
+    variant('node', { packageJson: H('d'), lock: H('e'), tarballs: [H('f')] }),
+    variant('image', { digest: `repo@sha256:${H('0')}` }),
+    variant('tools', { files: [{ path: 'bin/my-runner', hash: H('1') }] }),
+    variant('workspace_node', {
+      packageJson: H('2'), lock: H('3'), config: none, subject: 'packages/pricing',
+      members: [{ path: 'packages/pricing', name: '@acme/pricing', tarball: H('4') }],
+    }),
+  ];
+
+  it('encodes and decodes back to the same value', () => {
+    for (const spec of specs) {
+      assert.deepStrictEqual(decodeCurrent(encodeCurrent(spec)), spec);
+    }
+  });
+
+  it('round-trips a workspace_node spec carrying a pnpm config blob and multiple members', () => {
+    const withConfig: EnvironmentSpec = variant('workspace_node', {
+      packageJson: H('2'), lock: H('3'), config: some(H('5')), subject: 'packages/pricing',
+      members: [
+        { path: 'packages/common', name: '@acme/common', tarball: H('6') },
+        { path: 'packages/pricing', name: '@acme/pricing', tarball: H('7') },
+      ],
+    });
+    assert.deepStrictEqual(decodeCurrent(encodeCurrent(withConfig)), withConfig);
+  });
+});
+
+describe('environmentSpecObjectHashes', () => {
+  it('lists python blobs', () => {
+    assert.deepStrictEqual(
+      environmentSpecObjectHashes(variant('python', {
+        pyproject: 'p', lock: 'l',
+        sdists: [{ filename: 'a-1.0.tar.gz', hash: 's1' }, { filename: 'b-1.0.tar.gz', hash: 's2' }],
+      })),
+      ['p', 'l', 's1', 's2'],
+    );
+  });
+
+  it('lists node blobs', () => {
+    assert.deepStrictEqual(
+      environmentSpecObjectHashes(variant('node', { packageJson: 'p', lock: 'l', tarballs: ['t'] })),
+      ['p', 'l', 't'],
+    );
+  });
+
+  it('lists nothing for image', () => {
+    assert.deepStrictEqual(
+      environmentSpecObjectHashes(variant('image', { digest: `repo@sha256:${H('0')}` })),
+      [],
+    );
+  });
+
+  it('lists every tools file hash', () => {
+    assert.deepStrictEqual(
+      environmentSpecObjectHashes(variant('tools', {
+        files: [{ path: 'bin/a', hash: 'h1' }, { path: 'bin/b', hash: 'h2' }],
+      })),
+      ['h1', 'h2'],
+    );
+  });
+
+  it('lists workspace_node blobs including the config when present', () => {
+    assert.deepStrictEqual(
+      environmentSpecObjectHashes(variant('workspace_node', {
+        packageJson: 'p', lock: 'l', config: some('cfg'), subject: 'packages/x',
+        members: [{ path: 'packages/x', name: '@acme/x', tarball: 't1' }, { path: 'packages/y', name: '@acme/y', tarball: 't2' }],
+      })),
+      ['p', 'l', 'cfg', 't1', 't2'],
+    );
+  });
+
+  it('omits the config hash for an npm workspace_node (none)', () => {
+    assert.deepStrictEqual(
+      environmentSpecObjectHashes(variant('workspace_node', {
+        packageJson: 'p', lock: 'l', config: none, subject: 'packages/x',
+        members: [{ path: 'packages/x', name: '@acme/x', tarball: 't1' }],
+      })),
+      ['p', 'l', 't1'],
+    );
+  });
+});

package/src/environment.ts

@@ -18,7 +18,7 @@
  * ride the existing content-addressed object store and transfer machinery.
  */
 
-import { ArrayType, StringType, StructType, ValueTypeOf, VariantType } from '@elaraai/east';
+import { ArrayType, OptionType, StringType, StructType, ValueTypeOf, VariantType } from '@elaraai/east';
 
 /**
  * A Python (uv) project environment.
@@ -88,12 +88,90 @@ export const ImageEnvironmentType = StructType({
 export type ImageEnvironmentType = typeof ImageEnvironmentType;
 export type ImageEnvironment = ValueTypeOf<typeof ImageEnvironmentType>;
 
+/**
+ * A prebuilt-file ("tools") environment for C and custom runners.
+ *
+ * e3 never builds anything for this kind: the developer builds their binary
+ * (or any prebuilt artifact) however they like, and capture folds the named
+ * files' bytes into the environment hash and materializes them onto the
+ * runner's PATH. Rebuilding a captured file changes its blob hash → the
+ * environment hash → the tasks that use it re-run. This closes the
+ * pre-existing hole where a custom-runner binary resolved from PATH was
+ * never part of the cache key, so a rebuild silently served stale outputs.
+ *
+ * @remarks
+ * - `files`: the captured files, sorted by `path` so capture order never
+ *   affects the environment hash.
+ *   - `path`: environment-dir-relative POSIX path; v1 writers emit
+ *     `bin/<basename>` (materialization writes it there and adds `bin` to
+ *     PATH). Validated at materialization: no absolute paths, no `..`, no
+ *     empty segments.
+ *   - `hash`: object hash of the file's bytes. No mode is stored:
+ *     materialization always applies a fixed mode, so an exec-bit-only
+ *     change does not alter the environment yet also cannot go stale.
+ */
+export const ToolsEnvironmentType = StructType({
+  /** Captured files (env-relative path + object hash), sorted by path */
+  files: ArrayType(StructType({ path: StringType, hash: StringType })),
+});
+export type ToolsEnvironmentType = typeof ToolsEnvironmentType;
+export type ToolsEnvironment = ValueTypeOf<typeof ToolsEnvironmentType>;
+
+/**
+ * A Node **workspace-member** environment (npm or pnpm workspaces).
+ *
+ * Where {@link NodeEnvironmentType} captures one self-contained project,
+ * this captures one member of a workspace together with the transitive
+ * closure of the local workspace packages it depends on — so editing a
+ * member's code re-runs only the environments whose closure contains it.
+ * Materialized by reconstructing a minimal workspace of exactly the closure
+ * members and running the frozen install against the verbatim root lock.
+ *
+ * @remarks
+ * - `packageJson`: object hash of the workspace **root** `package.json` blob.
+ * - `lock`: object hash of the **root** lockfile blob (content-sniffed as
+ *   today; npm in v1, pnpm once the pnpm capture path ships).
+ * - `config`: pnpm only — object hash of the capture-synthesized
+ *   `pnpm-workspace.yaml` blob; `none` for npm.
+ * - `subject`: workspace-relative POSIX path of the environment's own
+ *   member. Must satisfy `members.some((m) => m.path === subject)` — this is
+ *   enforced at capture and re-validated at materialization (BEAST2 typed
+ *   decode is structural only and cannot check it).
+ * - `members`: the dependency closure sorted by `path`; each carries its
+ *   package `name` (read from the member's `package.json` at capture) and
+ *   the object `hash` of its `npm pack` tarball.
+ */
+export const WorkspaceNodeEnvironmentType = StructType({
+  /** Object hash of the workspace root package.json blob */
+  packageJson: StringType,
+  /** Object hash of the root lockfile blob */
+  lock: StringType,
+  /** pnpm only: object hash of the synthesized pnpm-workspace.yaml; none for npm */
+  config: OptionType(StringType),
+  /** Workspace-relative POSIX path of this environment's own member */
+  subject: StringType,
+  /** Dependency closure (path + package name + tarball hash), sorted by path */
+  members: ArrayType(StructType({ path: StringType, name: StringType, tarball: StringType })),
+});
+export type WorkspaceNodeEnvironmentType = typeof WorkspaceNodeEnvironmentType;
+export type WorkspaceNodeEnvironment = ValueTypeOf<typeof WorkspaceNodeEnvironmentType>;
+
 /**
  * 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.
+ *
+ * @remarks
+ * BEAST2 encodes a variant's tag as the index of its case in the
+ * **alphabetically sorted** case list, so the case order is load-bearing: a
+ * repo persists specs by that order, and reordering the cases in a later
+ * edit would re-tag every case after the insertion point and mis-decode
+ * already-stored specs. New cases must therefore be added so the sorted
+ * order only grows at the end (`tools` and `workspace_node` sort after the
+ * original three). The frozen-order guard test in `environment.spec.ts`
+ * turns an accidental reorder into a red test.
  */
 export const EnvironmentSpecType = VariantType({
   /** Python (uv) project environment */
@@ -102,6 +180,10 @@ export const EnvironmentSpecType = VariantType({
   node: NodeEnvironmentType,
   /** Custom container image environment */
   image: ImageEnvironmentType,
+  /** Prebuilt-file environment for C / custom runners */
+  tools: ToolsEnvironmentType,
+  /** Node workspace-member environment (npm/pnpm workspaces) */
+  workspace_node: WorkspaceNodeEnvironmentType,
 });
 export type EnvironmentSpecType = typeof EnvironmentSpecType;
 export type EnvironmentSpec = ValueTypeOf<typeof EnvironmentSpecType>;
@@ -123,5 +205,14 @@ export function environmentSpecObjectHashes(spec: EnvironmentSpec): string[] {
       return [spec.value.packageJson, spec.value.lock, ...spec.value.tarballs];
     case 'image':
       return [];
+    case 'tools':
+      return spec.value.files.map((f) => f.hash);
+    case 'workspace_node':
+      return [
+        spec.value.packageJson,
+        spec.value.lock,
+        ...(spec.value.config.type === 'some' ? [spec.value.config.value] : []),
+        ...spec.value.members.map((m) => m.tarball),
+      ];
   }
 }

package/src/index.ts

@@ -56,6 +56,10 @@ export {
   type NodeEnvironment,
   ImageEnvironmentType,
   type ImageEnvironment,
+  ToolsEnvironmentType,
+  type ToolsEnvironment,
+  WorkspaceNodeEnvironmentType,
+  type WorkspaceNodeEnvironment,
   environmentSpecObjectHashes,
 } from './environment.js';
 
@@ -86,6 +90,7 @@ export {
   RunnerType,
   type RunnerValue,
   runnerToArgv,
+  withRunnerVerbose,
 } from './runner.js';
 
 // Function objects

package/src/runner.spec.ts

@@ -0,0 +1,76 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+
+/**
+ * Gating contract for {@link withRunnerVerbose}.
+ *
+ * `-v` is a pure runtime toggle: it is spliced into an already-built argv just
+ * before spawn. These tests pin the two things that make it safe — it reaches
+ * the known runtimes (which all accept `-v`) at the right argv position, and it
+ * never touches a `custom` runner's user-authored command. Because it only
+ * rewrites the argv (never the runner variant or any hash), it is
+ * cache-irrelevant by construction.
+ */
+
+import { describe, it } from 'node:test';
+import * as assert from 'node:assert';
+import { variant } from '@elaraai/east';
+import { runnerToArgv, withRunnerVerbose, type RunnerValue } from './runner.js';
+
+/** A realistic fully-built argv: runner prefix + the `-i`/`-o`/`<ir>` suffix. */
+function fullArgv(runner: RunnerValue): string[] {
+  return [...runnerToArgv(runner), '-i', 'in.beast2', '-o', 'out.beast2', 'body.beast2'];
+}
+
+const KNOWN: Array<[string, RunnerValue, string]> = [
+  ['east_node', variant('east_node', { platforms: ['@elaraai/east-node-std'] }), 'east-node'],
+  ['east_py', variant('east_py', { platforms: ['east-py-std'] }), 'east-py'],
+  ['east_c', variant('east_c', { platforms: ['east-c-std'] }), 'east-c'],
+];
+
+describe('withRunnerVerbose', () => {
+  for (const [tag, runner, bin] of KNOWN) {
+    it(`inserts -v after the 'run' subcommand for ${tag}`, () => {
+      const args = fullArgv(runner);
+      const out = withRunnerVerbose(runner, args, true);
+      // `[<bin>, 'run', '-v', …rest]` — position 2, ahead of -p/-i/-o and the IR.
+      assert.deepStrictEqual(out.slice(0, 3), [bin, 'run', '-v']);
+      // Exactly one -v, and the rest of the argv is preserved in order.
+      assert.strictEqual(out.filter((a) => a === '-v').length, 1);
+      assert.deepStrictEqual(out.slice(3), args.slice(2));
+      // The IR path is still last.
+      assert.strictEqual(out[out.length - 1], 'body.beast2');
+    });
+
+    it(`leaves the argv untouched when verbose is off for ${tag}`, () => {
+      const args = fullArgv(runner);
+      assert.deepStrictEqual(withRunnerVerbose(runner, args, false), args);
+      assert.deepStrictEqual(withRunnerVerbose(runner, args, undefined), args);
+    });
+  }
+
+  it('never splices -v into a custom runner (user-authored argv)', () => {
+    const runner: RunnerValue = variant('custom', { command: ['uv', 'run', 'east-py', 'run'] });
+    const args = fullArgv(runner);
+    // Even with verbose requested, a custom command is passed through verbatim —
+    // we cannot know it understands `-v`.
+    assert.deepStrictEqual(withRunnerVerbose(runner, args, true), args);
+    assert.ok(!withRunnerVerbose(runner, args, true).includes('-v'));
+  });
+
+  it('does not mutate the input argv (returns a new array)', () => {
+    const runner = variant('east_node', { platforms: ['@elaraai/east-node-std'] });
+    const args = fullArgv(runner);
+    const before = [...args];
+    withRunnerVerbose(runner, args, true);
+    assert.deepStrictEqual(args, before, 'input array must be unchanged');
+  });
+
+  it('is a no-op on a degenerate (too-short) argv rather than throwing', () => {
+    const runner = variant('east_node', { platforms: [] });
+    assert.deepStrictEqual(withRunnerVerbose(runner, ['east-node'], true), ['east-node']);
+    assert.deepStrictEqual(withRunnerVerbose(runner, [], true), []);
+  });
+});

package/src/runner.ts

@@ -60,3 +60,28 @@ export function runnerToArgv(r: RunnerValue): string[] {
     case 'custom':    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`) 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>, 'run', …]` (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: RunnerValue, args: string[], verbose?: boolean): string[] {
+  if (!verbose || runner.type === 'custom' || args.length < 2) return args;
+  return [...args.slice(0, 2), '-v', ...args.slice(2)];
+}