@fluidgrids/workflows 2026.1027.0 → 2026.1028.1

package/dist/roundtrip/index.d.cts

@@ -1,11 +1,16 @@
-import { W as WorkflowDefinition, a as JsonObject } from '../types-Dr2Fn1Ax.cjs';
-import { m as LayoutSidecar } from '../assemble-BJo9TECS.cjs';
-import { N as NodeManifest } from '../manifest-Duf-gHdO.cjs';
+import { b as WorkflowDefinition, J as JsonObject } from '../types-BGoPzgcl.cjs';
+import { b as LayoutSidecar } from '../assemble-BLqQ8lSu.cjs';
+import { N as NodeManifest } from '../manifest-0OLw0i7k.cjs';
 import { P as PathSegment } from '../expressions-DhHaqyar.cjs';
-import { E as Evaluator, a as EsbuildApi } from '../lower-DcOY8ux0.cjs';
-export { b as ESBUILD_VERSION, c as EVALUATION_GLOBAL, L as LowerError, d as LowerOptions, e as LowerResult, f as LoweredWorkflow, g as bundleProject, h as defaultEntries, l as lower } from '../lower-DcOY8ux0.cjs';
-import 'esbuild';
+import { V as VendoredDeps, a as VendoredPackage, E as Evaluator } from '../lower-BuSvAFqi.cjs';
+export { B as BuildBundleOptions, b as BuiltBundle, D as DeterminismViolationError, c as ESBUILD_VERSION, d as EVALUATION_GLOBAL, L as LowerIssue, e as LowerOptions, f as LowerResult, g as LoweredWorkflow, N as NODE_BUILTINS, h as buildBundle, i as bundleProject, j as bundleSourceHash, k as defaultEntries, l as lower, r as resolvePackageEntry, s as scanDurableSources, m as splitSpecifier } from '../lower-BuSvAFqi.cjs';
+import { E as EsbuildApi } from '../lower-types-nofRXw9c.cjs';
+export { L as LowerError, a as LowerFailureReason } from '../lower-types-nofRXw9c.cjs';
+import '../workflow-FXUkpIBc.cjs';
+import '../workflow-J-yYixny.cjs';
+import '../types-CpBBjaGX.cjs';
 import '../hash-CZkTXPCX.cjs';
+import 'esbuild';
 
 /**
  * The language-neutral lift plan: a definition expressed as tier-1 builder
@@ -139,12 +144,13 @@ interface LiftPlan {
  * - `legacy-syntax`: a `${…}` template, an edge mapping or legacy credentials kept verbatim;
  * - `unknown-node`: a node type or operation the registry snapshot does not know, written as `nodes.custom()`;
  * - `connection-id-only`: a connection with no name, kept as its id;
+ * - `connection-ambiguous`: a connection whose name more than one connection has, kept as its id;
  * - `raw-node`: a node written in its exact form (`nodes.custom()` plus `extra`);
  * - `layout-omitted`, `pinned-data-omitted`: left out by the export options (lossy);
  * - `key-added`: the definition had no `key`; the workflow key was written;
  * - `roundtrip-mismatch` / `lowering-failed`: lowering the code did not reproduce the IR (lossy).
  */
-type FidelityItemKind = 'expression-verbatim' | 'legacy-syntax' | 'unknown-node' | 'connection-id-only' | 'raw-node' | 'layout-omitted' | 'pinned-data-omitted' | 'key-added' | 'roundtrip-mismatch' | 'lowering-failed';
+type FidelityItemKind = 'expression-verbatim' | 'legacy-syntax' | 'unknown-node' | 'connection-id-only' | 'connection-ambiguous' | 'raw-node' | 'layout-omitted' | 'pinned-data-omitted' | 'key-added' | 'roundtrip-mismatch' | 'lowering-failed';
 interface FidelityItem {
     nodeId?: string;
     path?: string;
@@ -214,9 +220,38 @@ declare function liftToTypeScript(definition: unknown, options?: LiftOptions): P
 /** Lift to a tier-1 Python project fragment. */
 declare function liftToPython(definition: unknown, options?: LiftOptions): Promise<LiftResult>;
 
+interface VendorOptions {
+    /** Package names to vendor instead of the project's `dependencies`. */
+    packages?: readonly string[];
+    /** Largest total size of the vendored files, in bytes. Default 32 MiB. */
+    maxBytes?: number;
+}
+/** Vendor the dependencies of the project at `projectDir`. */
+declare function vendorDependencies(projectDir: string, options?: VendorOptions): VendoredDeps;
+
+interface SourceArchive {
+    /** Project files by path. */
+    files: Record<string, string>;
+    /** The lockfile text (`bun.lock`, `package-lock.json`), if any. */
+    lock?: string;
+    /** Vendored packages by name. */
+    vendored?: Record<string, VendoredPackage>;
+}
+declare const SOURCE_ARCHIVE_MAX_BYTES: number;
+/** Pack a source archive. */
+declare function packSources(archive: SourceArchive): Uint8Array;
+/** Unpack and check a source archive. */
+declare function unpackSources(data: Uint8Array, options?: {
+    maxBytes?: number;
+}): SourceArchive;
+/** The vendored packages of an archive as `buildBundle` takes them. */
+declare function archiveDeps(archive: SourceArchive): VendoredDeps;
+
 interface NodeVmEvaluatorOptions {
     /** Wall-clock budget for evaluating the bundle. Default 5000 ms. */
     timeoutMs?: number;
+    /** Old-generation heap cap of the evaluation worker. Default 512 MiB. */
+    memoryLimitBytes?: number;
 }
 declare function createNodeVmEvaluator(options?: NodeVmEvaluatorOptions): Evaluator;
 
@@ -284,4 +319,4 @@ declare const PY_PROJECT_MODULE = "fluidgrids_workflows.project";
  */
 declare const PY_LINE_LENGTH = 88;
 
-export { EsbuildApi, Evaluator, type ExportCodeOptions, type ExportCodeResult, type ExportedFile, type FidelityItem, type FidelityItemKind, type FidelityReport, LiftError, type LiftHeader, type LiftOptions, type LiftResult, type NodeVmEvaluatorOptions, PY_LINE_LENGTH, PY_PROJECT_MODULE, PY_SDK_MODULE, type PlanOptions, type PreparedLift, TS_FORMAT_OPTIONS, TS_NODES_IMPORT, checkFidelity, createNodeVmEvaluator, exportWorkflowCode, liftToPython, liftToTypeScript, prepareLift };
+export { EsbuildApi, Evaluator, type ExportCodeOptions, type ExportCodeResult, type ExportedFile, type FidelityItem, type FidelityItemKind, type FidelityReport, LiftError, type LiftHeader, type LiftOptions, type LiftResult, type NodeVmEvaluatorOptions, PY_LINE_LENGTH, PY_PROJECT_MODULE, PY_SDK_MODULE, type PlanOptions, type PreparedLift, SOURCE_ARCHIVE_MAX_BYTES, type SourceArchive, TS_FORMAT_OPTIONS, TS_NODES_IMPORT, type VendorOptions, VendoredDeps, VendoredPackage, archiveDeps, checkFidelity, createNodeVmEvaluator, exportWorkflowCode, liftToPython, liftToTypeScript, packSources, prepareLift, unpackSources, vendorDependencies };

package/dist/roundtrip/index.d.ts

@@ -1,11 +1,16 @@
-import { W as WorkflowDefinition, a as JsonObject } from '../types-Dr2Fn1Ax.js';
-import { m as LayoutSidecar } from '../assemble-DMOuaxRI.js';
-import { N as NodeManifest } from '../manifest-Bp9ZJlav.js';
+import { b as WorkflowDefinition, J as JsonObject } from '../types-BGoPzgcl.js';
+import { b as LayoutSidecar } from '../assemble-DWgaXHd-.js';
+import { N as NodeManifest } from '../manifest-C8N6HDYl.js';
 import { P as PathSegment } from '../expressions-DhHaqyar.js';
-import { E as Evaluator, a as EsbuildApi } from '../lower-Dw5grNrI.js';
-export { b as ESBUILD_VERSION, c as EVALUATION_GLOBAL, L as LowerError, d as LowerOptions, e as LowerResult, f as LoweredWorkflow, g as bundleProject, h as defaultEntries, l as lower } from '../lower-Dw5grNrI.js';
-import 'esbuild';
+import { V as VendoredDeps, a as VendoredPackage, E as Evaluator } from '../lower-C_Qv_34S.js';
+export { B as BuildBundleOptions, b as BuiltBundle, D as DeterminismViolationError, c as ESBUILD_VERSION, d as EVALUATION_GLOBAL, L as LowerIssue, e as LowerOptions, f as LowerResult, g as LoweredWorkflow, N as NODE_BUILTINS, h as buildBundle, i as bundleProject, j as bundleSourceHash, k as defaultEntries, l as lower, r as resolvePackageEntry, s as scanDurableSources, m as splitSpecifier } from '../lower-C_Qv_34S.js';
+import { E as EsbuildApi } from '../lower-types-nofRXw9c.js';
+export { L as LowerError, a as LowerFailureReason } from '../lower-types-nofRXw9c.js';
+import '../workflow-Bpr3vnA_.js';
+import '../workflow-C2a05WUJ.js';
+import '../types-DV-HX_Gt.js';
 import '../hash-CZkTXPCX.js';
+import 'esbuild';
 
 /**
  * The language-neutral lift plan: a definition expressed as tier-1 builder
@@ -139,12 +144,13 @@ interface LiftPlan {
  * - `legacy-syntax`: a `${…}` template, an edge mapping or legacy credentials kept verbatim;
  * - `unknown-node`: a node type or operation the registry snapshot does not know, written as `nodes.custom()`;
  * - `connection-id-only`: a connection with no name, kept as its id;
+ * - `connection-ambiguous`: a connection whose name more than one connection has, kept as its id;
  * - `raw-node`: a node written in its exact form (`nodes.custom()` plus `extra`);
  * - `layout-omitted`, `pinned-data-omitted`: left out by the export options (lossy);
  * - `key-added`: the definition had no `key`; the workflow key was written;
  * - `roundtrip-mismatch` / `lowering-failed`: lowering the code did not reproduce the IR (lossy).
  */
-type FidelityItemKind = 'expression-verbatim' | 'legacy-syntax' | 'unknown-node' | 'connection-id-only' | 'raw-node' | 'layout-omitted' | 'pinned-data-omitted' | 'key-added' | 'roundtrip-mismatch' | 'lowering-failed';
+type FidelityItemKind = 'expression-verbatim' | 'legacy-syntax' | 'unknown-node' | 'connection-id-only' | 'connection-ambiguous' | 'raw-node' | 'layout-omitted' | 'pinned-data-omitted' | 'key-added' | 'roundtrip-mismatch' | 'lowering-failed';
 interface FidelityItem {
     nodeId?: string;
     path?: string;
@@ -214,9 +220,38 @@ declare function liftToTypeScript(definition: unknown, options?: LiftOptions): P
 /** Lift to a tier-1 Python project fragment. */
 declare function liftToPython(definition: unknown, options?: LiftOptions): Promise<LiftResult>;
 
+interface VendorOptions {
+    /** Package names to vendor instead of the project's `dependencies`. */
+    packages?: readonly string[];
+    /** Largest total size of the vendored files, in bytes. Default 32 MiB. */
+    maxBytes?: number;
+}
+/** Vendor the dependencies of the project at `projectDir`. */
+declare function vendorDependencies(projectDir: string, options?: VendorOptions): VendoredDeps;
+
+interface SourceArchive {
+    /** Project files by path. */
+    files: Record<string, string>;
+    /** The lockfile text (`bun.lock`, `package-lock.json`), if any. */
+    lock?: string;
+    /** Vendored packages by name. */
+    vendored?: Record<string, VendoredPackage>;
+}
+declare const SOURCE_ARCHIVE_MAX_BYTES: number;
+/** Pack a source archive. */
+declare function packSources(archive: SourceArchive): Uint8Array;
+/** Unpack and check a source archive. */
+declare function unpackSources(data: Uint8Array, options?: {
+    maxBytes?: number;
+}): SourceArchive;
+/** The vendored packages of an archive as `buildBundle` takes them. */
+declare function archiveDeps(archive: SourceArchive): VendoredDeps;
+
 interface NodeVmEvaluatorOptions {
     /** Wall-clock budget for evaluating the bundle. Default 5000 ms. */
     timeoutMs?: number;
+    /** Old-generation heap cap of the evaluation worker. Default 512 MiB. */
+    memoryLimitBytes?: number;
 }
 declare function createNodeVmEvaluator(options?: NodeVmEvaluatorOptions): Evaluator;
 
@@ -284,4 +319,4 @@ declare const PY_PROJECT_MODULE = "fluidgrids_workflows.project";
  */
 declare const PY_LINE_LENGTH = 88;
 
-export { EsbuildApi, Evaluator, type ExportCodeOptions, type ExportCodeResult, type ExportedFile, type FidelityItem, type FidelityItemKind, type FidelityReport, LiftError, type LiftHeader, type LiftOptions, type LiftResult, type NodeVmEvaluatorOptions, PY_LINE_LENGTH, PY_PROJECT_MODULE, PY_SDK_MODULE, type PlanOptions, type PreparedLift, TS_FORMAT_OPTIONS, TS_NODES_IMPORT, checkFidelity, createNodeVmEvaluator, exportWorkflowCode, liftToPython, liftToTypeScript, prepareLift };
+export { EsbuildApi, Evaluator, type ExportCodeOptions, type ExportCodeResult, type ExportedFile, type FidelityItem, type FidelityItemKind, type FidelityReport, LiftError, type LiftHeader, type LiftOptions, type LiftResult, type NodeVmEvaluatorOptions, PY_LINE_LENGTH, PY_PROJECT_MODULE, PY_SDK_MODULE, type PlanOptions, type PreparedLift, SOURCE_ARCHIVE_MAX_BYTES, type SourceArchive, TS_FORMAT_OPTIONS, TS_NODES_IMPORT, type VendorOptions, VendoredDeps, VendoredPackage, archiveDeps, checkFidelity, createNodeVmEvaluator, exportWorkflowCode, liftToPython, liftToTypeScript, packSources, prepareLift, unpackSources, vendorDependencies };

package/dist/roundtrip/index.js

@@ -1,16 +1,23 @@
-import { diffDefinitions } from '../chunk-4DPEGDPW.js';
-import { renderTypeScript, generateNodeClients, pyWorkflowName, NameAllocator, referencedLater, formatLines, formatImport, clientNames, pyString, snakeCase, pyNumber, PY_KEYWORDS } from '../chunk-LMX35GNQ.js';
-export { PY_LINE_LENGTH, TS_FORMAT_OPTIONS, TS_NODES_IMPORT } from '../chunk-LMX35GNQ.js';
-import { operationsOf, isTriggerOperation } from '../chunk-GO34UHSY.js';
-export { createNodeVmEvaluator } from '../chunk-SRQRLWOS.js';
-import { lower } from '../chunk-S34NJE3A.js';
-export { ESBUILD_VERSION, EVALUATION_GLOBAL, LowerError, bundleProject, defaultEntries, lower } from '../chunk-S34NJE3A.js';
-import { assembleRecording, LAYOUT_FORMAT_VERSION, LAYOUT_FORMAT, defineWorkflow, nodes, trigger, op, internalNodes, triggers, edge, defaultEdgeId } from '../chunk-BWSLWF2E.js';
-import { normalizeDefinition, irHash } from '../chunk-SS4LT2IP.js';
+export { createNodeVmEvaluator } from '../chunk-XB53G2DK.js';
+import { diffDefinitions } from '../chunk-6FSHT5IL.js';
+import { renderTypeScript, generateNodeClients, pyWorkflowName, NameAllocator, referencedLater, formatLines, formatImport, clientNames, pyString, snakeCase, pyNumber, PY_KEYWORDS } from '../chunk-SMCANK3F.js';
+export { PY_LINE_LENGTH, TS_FORMAT_OPTIONS, TS_NODES_IMPORT } from '../chunk-SMCANK3F.js';
+import { operationsOf, isTriggerOperation } from '../chunk-QAN5MZEM.js';
+import { LowerError, lower } from '../chunk-H7KEVW2M.js';
+export { DeterminismViolationError, ESBUILD_VERSION, EVALUATION_GLOBAL, LowerError, NODE_BUILTINS, buildBundle, bundleProject, bundleSourceHash, defaultEntries, lower, resolvePackageEntry, scanDurableSources, splitSpecifier } from '../chunk-H7KEVW2M.js';
+import '../chunk-PDHLTDZB.js';
+import { assembleRecording, LAYOUT_FORMAT_VERSION, LAYOUT_FORMAT, defineWorkflow, nodes, trigger, op, internalNodes, triggers, edge, defaultEdgeId } from '../chunk-5HDSBTBX.js';
+import { normalizeDefinition, irHash } from '../chunk-BD7ZPG53.js';
 import '../chunk-5LUIDMF4.js';
-import { PREDICATE_OPERATORS, and, or, expr, RESERVED_REF_KEYS } from '../chunk-PL73GJR4.js';
-import { stableStringify } from '../chunk-X4HKU3MX.js';
-import { isRecord, deepEqual, parseTemplate } from '../chunk-REV7ZOA4.js';
+import { PREDICATE_OPERATORS, BuilderError, and, or, expr, RESERVED_REF_KEYS } from '../chunk-JZ4TOOLN.js';
+import { canonicalJson, stableStringify } from '../chunk-E2VK7J2C.js';
+import { parseTemplate } from '../chunk-7AAZGVKD.js';
+import { isRecord, setOwn, deepEqual } from '../chunk-PMCM2OH4.js';
+import '../chunk-7NQ37GZU.js';
+import '../chunk-BO6OVILK.js';
+import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
+import { resolve, join, dirname, relative, sep } from 'path';
+import { gzipSync, gunzipSync } from 'zlib';
 
 // src/roundtrip/plan.ts
 var TYPED_HANDLES = {
@@ -379,14 +386,37 @@ function errorConfigOptions(errorConfig) {
   }
   return options2;
 }
+function ambiguousConnectionNames(names) {
+  const idByName = /* @__PURE__ */ new Map();
+  const ambiguous = /* @__PURE__ */ new Set();
+  for (const [id, name] of Object.entries(names)) {
+    const previous = idByName.get(name);
+    if (previous === void 0) idByName.set(name, id);
+    else if (previous !== id) ambiguous.add(name);
+  }
+  return ambiguous;
+}
 function connectionOptions(value2, names, nodeId, items) {
   if (Array.isArray(value2) && value2.length > 0 && names) {
+    const ambiguous = ambiguousConnectionNames(names);
     const resolved = value2.map((ref) => {
       if (!isRecord(ref) || Object.keys(ref).sort().join(",") !== "adapter,connectionId")
         return void 0;
       const id = ref["connectionId"];
       return typeof id === "string" && Object.hasOwn(names, id) ? names[id] : void 0;
     });
+    const shared = resolved.filter(
+      (name) => typeof name === "string" && ambiguous.has(name)
+    );
+    if (shared.length > 0) {
+      items.push({
+        nodeId,
+        path: "args.connections",
+        kind: "connection-ambiguous",
+        detail: `The connection name ${[...new Set(shared)].map((name) => `"${name}"`).join(", ")} belongs to more than one connection; the connection id is kept`
+      });
+      return ["connections", literalOrStructure(value2)];
+    }
     if (resolved.every((name) => typeof name === "string")) {
       return resolved.length === 1 ? ["connection", { k: "literal", value: resolved[0] ?? "" }] : [
         "connection",
@@ -699,15 +729,21 @@ function buildPlan(normalized, options2, rawNodeIds = /* @__PURE__ */ new Set(),
 }
 function connectionsByName(connectionNames, definition) {
   const out = {};
+  const ambiguous = ambiguousConnectionNames(connectionNames);
   const data = isRecord(definition["data"]) ? definition["data"] : {};
   for (const node of Array.isArray(data["nodes"]) ? data["nodes"] : []) {
     const args = isRecord(node) && isRecord(node["args"]) ? node["args"] : void 0;
     for (const ref of Array.isArray(args?.["connections"]) ? args["connections"] : []) {
       if (!isRecord(ref) || typeof ref["connectionId"] !== "string" || typeof ref["adapter"] !== "string")
         continue;
-      const name = connectionNames[ref["connectionId"]];
-      if (name !== void 0)
-        out[name] = { connectionId: ref["connectionId"], adapter: ref["adapter"] };
+      const id = ref["connectionId"];
+      const name = Object.hasOwn(connectionNames, id) ? connectionNames[id] : void 0;
+      if (name === void 0 || ambiguous.has(name)) continue;
+      const previous = Object.hasOwn(out, name) ? out[name] : void 0;
+      if (previous && previous.adapter !== ref["adapter"]) {
+        ambiguous.add(name);
+        delete out[name];
+      } else setOwn(out, name, { connectionId: id, adapter: ref["adapter"] });
     }
   }
   return out;
@@ -1090,7 +1126,7 @@ function layoutOf(reference) {
   for (const node of Array.isArray(data["nodes"]) ? data["nodes"] : []) {
     if (!isRecord(node) || typeof node["id"] !== "string" || !isRecord(node["position"])) continue;
     const { x, y } = node["position"];
-    if (typeof x === "number" && typeof y === "number") positions[node["id"]] = { x, y };
+    if (typeof x === "number" && typeof y === "number") setOwn(positions, node["id"], { x, y });
   }
   const sidecar = {
     format: LAYOUT_FORMAT,
@@ -1129,6 +1165,37 @@ function mismatches(reference, candidate) {
   };
   return { nodes: nodes2, edges, document: !deepEqual(strip(reference), strip(candidate)) };
 }
+function tryRun(attempt) {
+  try {
+    return attempt();
+  } catch (error) {
+    if (error instanceof BuilderError) return void 0;
+    throw error;
+  }
+}
+function rejectedByBuilder(reference, run) {
+  const nodes2 = /* @__PURE__ */ new Set();
+  const edges = /* @__PURE__ */ new Set();
+  const data = isRecord(reference["data"]) ? reference["data"] : {};
+  const nodeIds = (Array.isArray(data["nodes"]) ? data["nodes"] : []).flatMap(
+    (node) => isRecord(node) && typeof node["id"] === "string" ? [node["id"]] : []
+  );
+  const edgeCount = Array.isArray(data["edges"]) ? data["edges"].length : 0;
+  const edgeIndices = Array.from({ length: edgeCount }, (_, index) => index);
+  const allNodes = new Set(nodeIds);
+  const allEdges = new Set(edgeIndices);
+  for (const id of nodeIds) {
+    const others = new Set(allNodes);
+    others.delete(id);
+    if (tryRun(() => run(others, allEdges)) === void 0) nodes2.add(id);
+  }
+  for (const index of edgeIndices) {
+    const others = new Set(allEdges);
+    others.delete(index);
+    if (tryRun(() => run(allNodes, others)) === void 0) edges.add(index);
+  }
+  return { nodes: nodes2, edges };
+}
 function prepareLift(definition, options2 = {}) {
   const normalized = normalizeDefinition(definition);
   if (!isRecord(normalized) || !isRecord(normalized["data"]))
@@ -1168,9 +1235,18 @@ function prepareLift(definition, options2 = {}) {
     });
     return { build, candidate: normalizeDefinition(candidate) };
   };
-  let attempt = run(/* @__PURE__ */ new Set(), /* @__PURE__ */ new Set());
+  let rejected = { nodes: /* @__PURE__ */ new Set(), edges: /* @__PURE__ */ new Set() };
+  let attempt = tryRun(() => run(rejected.nodes, rejected.edges));
+  if (attempt === void 0) {
+    rejected = rejectedByBuilder(reference, run);
+    attempt = run(rejected.nodes, rejected.edges);
+  }
   const first = mismatches(reference, attempt.candidate);
-  if (first.nodes.size > 0 || first.edges.size > 0) attempt = run(first.nodes, first.edges);
+  if (first.nodes.size > 0 || first.edges.size > 0)
+    attempt = run(
+      /* @__PURE__ */ new Set([...rejected.nodes, ...first.nodes]),
+      /* @__PURE__ */ new Set([...rejected.edges, ...first.edges])
+    );
   const residual = mismatches(reference, attempt.candidate);
   for (const id of residual.nodes)
     items.push({
@@ -1270,6 +1346,171 @@ async function liftToPython(definition, options2 = {}) {
   }
   return { files, items: prepared.items, reference: prepared.reference };
 }
+var SDK_PACKAGE = "@fluidgrids/workflows";
+var KEPT_EXTENSIONS = [".js", ".mjs", ".json"];
+var NATIVE_MARKERS = [".node", "binding.gyp"];
+var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set(["node_modules", ".git", "test", "tests", "__tests__"]);
+var DEFAULT_MAX_BYTES = 32 * 1024 * 1024;
+function readJson(path) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path, "utf8"));
+  } catch (error) {
+    throw new LowerError(
+      `Cannot read ${path}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+    throw new LowerError(`${path} is not a JSON object`);
+  return parsed;
+}
+function namesOf(value2) {
+  if (typeof value2 !== "object" || value2 === null || Array.isArray(value2)) return [];
+  return Object.keys(value2);
+}
+function locate(name, fromDir) {
+  let dir = fromDir;
+  for (; ; ) {
+    const candidate = join(dir, "node_modules", ...name.split("/"));
+    if (existsSync(join(candidate, "package.json"))) return candidate;
+    const parent = dirname(dir);
+    if (parent === dir) return void 0;
+    dir = parent;
+  }
+}
+function collectFiles(packageDir, dir, files, budget) {
+  for (const entry of readdirSync(dir).sort()) {
+    const full = join(dir, entry);
+    const stats = statSync(full);
+    if (stats.isDirectory()) {
+      if (!SKIPPED_DIRECTORIES.has(entry)) collectFiles(packageDir, full, files, budget);
+      continue;
+    }
+    const path = relative(packageDir, full).split(sep).join("/");
+    if (NATIVE_MARKERS.some((marker) => entry.endsWith(marker))) {
+      files[path] = "";
+      continue;
+    }
+    if (!KEPT_EXTENSIONS.some((ext) => entry.endsWith(ext))) continue;
+    budget.left -= stats.size;
+    if (budget.left < 0)
+      throw new LowerError(
+        `The vendored packages are larger than the limit (reached at "${budget.name}")`,
+        "too-large"
+      );
+    files[path] = readFileSync(full, "utf8");
+  }
+}
+function vendorDependencies(projectDir, options2 = {}) {
+  const rootDir = resolve(projectDir);
+  const manifest = readJson(join(rootDir, "package.json"));
+  const wanted = options2.packages ?? namesOf(manifest["dependencies"]);
+  const budget = { left: options2.maxBytes ?? DEFAULT_MAX_BYTES, name: "" };
+  const out = {};
+  const queue = wanted.filter((name) => name !== SDK_PACKAGE).map((name) => ({ name, fromDir: rootDir, optional: false }));
+  while (queue.length > 0) {
+    const next = queue.shift();
+    if (!next || Object.hasOwn(out, next.name) || next.name === SDK_PACKAGE) continue;
+    const packageDir = locate(next.name, next.fromDir);
+    if (packageDir === void 0) {
+      if (next.optional) continue;
+      throw new LowerError(
+        `"${next.name}" is a dependency but is not installed under ${rootDir}; run your package manager's install first`
+      );
+    }
+    const pkgJson = readJson(join(packageDir, "package.json"));
+    const files = {};
+    budget.name = next.name;
+    collectFiles(packageDir, packageDir, files, budget);
+    out[next.name] = {
+      version: typeof pkgJson["version"] === "string" ? pkgJson["version"] : "0.0.0",
+      files
+    };
+    for (const dependency of namesOf(pkgJson["dependencies"]))
+      queue.push({ name: dependency, fromDir: packageDir, optional: false });
+    for (const peer of namesOf(pkgJson["peerDependencies"]))
+      queue.push({ name: peer, fromDir: packageDir, optional: true });
+  }
+  const sorted = {};
+  for (const name of Object.keys(out).sort()) {
+    const pkg = out[name];
+    if (pkg) sorted[name] = pkg;
+  }
+  return sorted;
+}
+var SOURCE_ARCHIVE_MAX_BYTES = 64 * 1024 * 1024;
+var GZIP_OS_BYTE = 9;
+function packSources(archive) {
+  const value2 = { files: archive.files };
+  if (archive.lock !== void 0) value2["lock"] = archive.lock;
+  if (archive.vendored !== void 0 && Object.keys(archive.vendored).length > 0)
+    value2["vendored"] = archive.vendored;
+  const text = canonicalJson(value2);
+  const zipped = gzipSync(Buffer.from(text, "utf8"), { level: 9 });
+  zipped[GZIP_OS_BYTE] = 255;
+  return new Uint8Array(zipped.buffer, zipped.byteOffset, zipped.byteLength);
+}
+function stringMap(value2, what) {
+  if (!isRecord(value2)) throw new LowerError(`${what} must be an object`);
+  const out = {};
+  for (const [key, entry] of Object.entries(value2)) {
+    if (typeof entry !== "string") throw new LowerError(`${what}["${key}"] must be a string`);
+    Object.defineProperty(out, key, {
+      value: entry,
+      enumerable: true,
+      writable: true,
+      configurable: true
+    });
+  }
+  return out;
+}
+function unpackSources(data, options2 = {}) {
+  const maxBytes = options2.maxBytes ?? SOURCE_ARCHIVE_MAX_BYTES;
+  let text;
+  try {
+    text = gunzipSync(data, { maxOutputLength: maxBytes }).toString("utf8");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new LowerError(
+      /buffer|length|range/i.test(message) ? `The source archive is larger than ${maxBytes} bytes uncompressed` : `The source archive is not gzip: ${message}`,
+      /buffer|length|range/i.test(message) ? "too-large" : void 0
+    );
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    throw new LowerError("The source archive is not JSON");
+  }
+  if (!isRecord(parsed)) throw new LowerError("The source archive is not an object");
+  const archive = { files: stringMap(parsed["files"], "files") };
+  if (parsed["lock"] !== void 0) {
+    if (typeof parsed["lock"] !== "string") throw new LowerError("lock must be a string");
+    archive.lock = parsed["lock"];
+  }
+  if (parsed["vendored"] !== void 0) {
+    if (!isRecord(parsed["vendored"])) throw new LowerError("vendored must be an object");
+    const vendored = {};
+    for (const [name, pkg] of Object.entries(parsed["vendored"])) {
+      if (!isRecord(pkg) || typeof pkg["version"] !== "string")
+        throw new LowerError(`vendored["${name}"] needs a version`);
+      Object.defineProperty(vendored, name, {
+        value: {
+          version: pkg["version"],
+          files: stringMap(pkg["files"], `vendored["${name}"].files`)
+        },
+        enumerable: true,
+        writable: true,
+        configurable: true
+      });
+    }
+    archive.vendored = vendored;
+  }
+  return archive;
+}
+function archiveDeps(archive) {
+  return archive.vendored ?? {};
+}
 
 // src/roundtrip/fidelity.ts
 var LOSSY_KINDS = /* @__PURE__ */ new Set([
@@ -1325,4 +1566,4 @@ async function exportWorkflowCode(definition, options2) {
   return { format: options2.format, files, fidelity, irHash: irHash(definition) };
 }
 
-export { LiftError, PY_PROJECT_MODULE, PY_SDK_MODULE, checkFidelity, exportWorkflowCode, liftToPython, liftToTypeScript, prepareLift };
+export { LiftError, PY_PROJECT_MODULE, PY_SDK_MODULE, SOURCE_ARCHIVE_MAX_BYTES, archiveDeps, checkFidelity, exportWorkflowCode, liftToPython, liftToTypeScript, packSources, prepareLift, unpackSources, vendorDependencies };

package/dist/runtime/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+var chunkCSNWNFKU_cjs = require('../chunk-CSNWNFKU.cjs');
+require('../chunk-FMSW2HDF.cjs');
+require('../chunk-FR7KYWRO.cjs');
+var chunkL24YIZY7_cjs = require('../chunk-L24YIZY7.cjs');
+require('../chunk-FQIHX7YI.cjs');
+var chunkP6TA5EZT_cjs = require('../chunk-P6TA5EZT.cjs');
+require('../chunk-623FVQSN.cjs');
+require('../chunk-2J6TF7YI.cjs');
+require('../chunk-Z2Y65YOY.cjs');
+
+
+
+Object.defineProperty(exports, "CommandIds", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.CommandIds; }
+});
+Object.defineProperty(exports, "RUNTIME_GLOBAL", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.RUNTIME_GLOBAL; }
+});
+Object.defineProperty(exports, "SDK_NAME", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.SDK_NAME; }
+});
+Object.defineProperty(exports, "WorkflowExecution", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.WorkflowExecution; }
+});
+Object.defineProperty(exports, "buildWorkflowRegistry", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.buildWorkflowRegistry; }
+});
+Object.defineProperty(exports, "createWorkflowRuntime", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.createWorkflowRuntime; }
+});
+Object.defineProperty(exports, "installWorkflowRuntime", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.installWorkflowRuntime; }
+});
+Object.defineProperty(exports, "isPatchMarkerId", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.isPatchMarkerId; }
+});
+Object.defineProperty(exports, "isRuntimeAbi", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.isRuntimeAbi; }
+});
+Object.defineProperty(exports, "matchActivation", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.matchActivation; }
+});
+Object.defineProperty(exports, "mismatch", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.mismatch; }
+});
+Object.defineProperty(exports, "patchMarkerId", {
+  enumerable: true,
+  get: function () { return chunkCSNWNFKU_cjs.patchMarkerId; }
+});
+Object.defineProperty(exports, "SHIM_HOOK", {
+  enumerable: true,
+  get: function () { return chunkL24YIZY7_cjs.SHIM_HOOK; }
+});
+Object.defineProperty(exports, "SHIM_VIOLATION", {
+  enumerable: true,
+  get: function () { return chunkL24YIZY7_cjs.SHIM_VIOLATION; }
+});
+Object.defineProperty(exports, "TASK_PRELUDE", {
+  enumerable: true,
+  get: function () { return chunkL24YIZY7_cjs.TASK_PRELUDE; }
+});
+Object.defineProperty(exports, "createRandom", {
+  enumerable: true,
+  get: function () { return chunkL24YIZY7_cjs.createRandom; }
+});
+Object.defineProperty(exports, "seedOf", {
+  enumerable: true,
+  get: function () { return chunkL24YIZY7_cjs.seedOf; }
+});
+Object.defineProperty(exports, "uuidFrom", {
+  enumerable: true,
+  get: function () { return chunkL24YIZY7_cjs.uuidFrom; }
+});
+Object.defineProperty(exports, "splitActivations", {
+  enumerable: true,
+  get: function () { return chunkP6TA5EZT_cjs.splitActivations; }
+});