@fluidgrids/workflows 2026.1028.1 → 2026.1029.1

package/dist/roundtrip/index.cjs

@@ -1,20 +1,23 @@
 'use strict';
 
-var chunkHR3BN4C4_cjs = require('../chunk-HR3BN4C4.cjs');
+var chunkOKX3FYIM_cjs = require('../chunk-OKX3FYIM.cjs');
 var chunkNEIUQASE_cjs = require('../chunk-NEIUQASE.cjs');
 var chunkSX2PNKKT_cjs = require('../chunk-SX2PNKKT.cjs');
 var chunkCPDK3K5N_cjs = require('../chunk-CPDK3K5N.cjs');
-var chunk2DP2Y6EU_cjs = require('../chunk-2DP2Y6EU.cjs');
-require('../chunk-CBL5JSCC.cjs');
-var chunk57MSZ24T_cjs = require('../chunk-57MSZ24T.cjs');
+var chunk6QPOJZT6_cjs = require('../chunk-6QPOJZT6.cjs');
+require('../chunk-2B37XAFQ.cjs');
+var chunkNXFBVDOI_cjs = require('../chunk-NXFBVDOI.cjs');
 var chunkGBQ33SIZ_cjs = require('../chunk-GBQ33SIZ.cjs');
 require('../chunk-G4UEPUGO.cjs');
 var chunkGVTZMA5C_cjs = require('../chunk-GVTZMA5C.cjs');
 var chunkQKZL3ONM_cjs = require('../chunk-QKZL3ONM.cjs');
 var chunkTBDXTV22_cjs = require('../chunk-TBDXTV22.cjs');
 var chunkSAENRNBJ_cjs = require('../chunk-SAENRNBJ.cjs');
-require('../chunk-FQIHX7YI.cjs');
-require('../chunk-2J6TF7YI.cjs');
+var chunkQ4MWQNJK_cjs = require('../chunk-Q4MWQNJK.cjs');
+require('../chunk-J3PYFGKA.cjs');
+require('../chunk-FR7KYWRO.cjs');
+require('../chunk-3FIDHONL.cjs');
+require('../chunk-YHBVMOMK.cjs');
 require('../chunk-Z2Y65YOY.cjs');
 var fs = require('fs');
 var path = require('path');
@@ -253,7 +256,7 @@ function richEdge(edge2, info, items) {
   const options2 = [];
   const extra = [];
   if (edge2["id"] === void 0) options2.push(["id", { k: "literal", value: false }]);
-  else if (edge2["id"] !== chunk57MSZ24T_cjs.defaultEdgeId(source, target, sourceHandle, targetHandle))
+  else if (edge2["id"] !== chunkNXFBVDOI_cjs.defaultEdgeId(source, target, sourceHandle, targetHandle))
     options2.push(["id", literalOrStructure(edge2["id"])]);
   if (edge2["type"] === void 0) options2.push(["type", { k: "literal", value: false }]);
   else if (edge2["type"] !== "deletable") options2.push(["type", literalOrStructure(edge2["type"])]);
@@ -754,19 +757,19 @@ function connectionsByName(connectionNames, definition) {
 function descriptor(operation) {
   switch (operation.kind) {
     case "trigger": {
-      const value2 = chunk57MSZ24T_cjs.triggers[operation.name];
+      const value2 = chunkNXFBVDOI_cjs.triggers[operation.name];
       if (!value2) throw new LiftError(`Unknown trigger ${operation.name}`);
       return value2;
     }
     case "internal": {
-      const value2 = chunk57MSZ24T_cjs.internalNodes[operation.name];
+      const value2 = chunkNXFBVDOI_cjs.internalNodes[operation.name];
       if (!value2) throw new LiftError(`Unknown internal node ${operation.name}`);
       return value2;
     }
     case "client":
-      return operation.role === "trigger" ? chunk57MSZ24T_cjs.trigger(operation.nodeType, operation.version, operation.operation) : chunk57MSZ24T_cjs.op(operation.nodeType, operation.version, operation.operation);
+      return operation.role === "trigger" ? chunkNXFBVDOI_cjs.trigger(operation.nodeType, operation.version, operation.operation) : chunkNXFBVDOI_cjs.op(operation.nodeType, operation.version, operation.operation);
     case "custom":
-      return chunk57MSZ24T_cjs.nodes.custom(operation.nodeType, operation.operation, operation.version);
+      return chunkNXFBVDOI_cjs.nodes.custom(operation.nodeType, operation.operation, operation.version);
   }
 }
 function refValue(ref, wf, runtime) {
@@ -824,7 +827,7 @@ function value(expression2, wf, runtime) {
       return (declared ?? wf.ref(expression2.nodeId)).handle(expression2.handle);
     }
     case "edge":
-      return chunk57MSZ24T_cjs.edge(
+      return chunkNXFBVDOI_cjs.edge(
         value(expression2.from, wf, runtime),
         value({ k: "object", entries: expression2.options }, wf, runtime)
       );
@@ -852,7 +855,7 @@ function interpretPlan(plan) {
     k: "object",
     entries: plan.workflowOptions
   });
-  const workflow = chunk57MSZ24T_cjs.defineWorkflow(workflowOptions2, (wf) => {
+  const workflow = chunkNXFBVDOI_cjs.defineWorkflow(workflowOptions2, (wf) => {
     const runtime = /* @__PURE__ */ new Map();
     for (const statement of plan.statements) {
       if (statement.kind === "node") {
@@ -1130,8 +1133,8 @@ function layoutOf(reference) {
     if (typeof x === "number" && typeof y === "number") chunkSAENRNBJ_cjs.setOwn(positions, node["id"], { x, y });
   }
   const sidecar = {
-    format: chunk57MSZ24T_cjs.LAYOUT_FORMAT,
-    formatVersion: chunk57MSZ24T_cjs.LAYOUT_FORMAT_VERSION,
+    format: chunkNXFBVDOI_cjs.LAYOUT_FORMAT,
+    formatVersion: chunkNXFBVDOI_cjs.LAYOUT_FORMAT_VERSION,
     positions
   };
   if (Array.isArray(data["stickyNotes"])) sidecar.stickyNotes = data["stickyNotes"];
@@ -1229,7 +1232,7 @@ function prepareLift(definition, options2 = {}) {
   const run = (rawNodes, rawEdges) => {
     const build = buildPlan(reference, options2, rawNodes, rawEdges);
     const recording = interpretPlan(build.plan);
-    const candidate = chunk57MSZ24T_cjs.assembleRecording(recording, {
+    const candidate = chunkNXFBVDOI_cjs.assembleRecording(recording, {
       layout,
       ...connections ? { connections } : {},
       ...pinned ? { pinnedData: pinned } : {}
@@ -1357,12 +1360,12 @@ function readJson(path) {
   try {
     parsed = JSON.parse(fs.readFileSync(path, "utf8"));
   } catch (error) {
-    throw new chunk2DP2Y6EU_cjs.LowerError(
+    throw new chunk6QPOJZT6_cjs.LowerError(
       `Cannot read ${path}: ${error instanceof Error ? error.message : String(error)}`
     );
   }
   if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
-    throw new chunk2DP2Y6EU_cjs.LowerError(`${path} is not a JSON object`);
+    throw new chunk6QPOJZT6_cjs.LowerError(`${path} is not a JSON object`);
   return parsed;
 }
 function namesOf(value2) {
@@ -1395,7 +1398,7 @@ function collectFiles(packageDir, dir, files, budget) {
     if (!KEPT_EXTENSIONS.some((ext) => entry.endsWith(ext))) continue;
     budget.left -= stats.size;
     if (budget.left < 0)
-      throw new chunk2DP2Y6EU_cjs.LowerError(
+      throw new chunk6QPOJZT6_cjs.LowerError(
         `The vendored packages are larger than the limit (reached at "${budget.name}")`,
         "too-large"
       );
@@ -1415,7 +1418,7 @@ function vendorDependencies(projectDir, options2 = {}) {
     const packageDir = locate(next.name, next.fromDir);
     if (packageDir === void 0) {
       if (next.optional) continue;
-      throw new chunk2DP2Y6EU_cjs.LowerError(
+      throw new chunk6QPOJZT6_cjs.LowerError(
         `"${next.name}" is a dependency but is not installed under ${rootDir}; run your package manager's install first`
       );
     }
@@ -1446,16 +1449,17 @@ function packSources(archive) {
   if (archive.lock !== void 0) value2["lock"] = archive.lock;
   if (archive.vendored !== void 0 && Object.keys(archive.vendored).length > 0)
     value2["vendored"] = archive.vendored;
+  if (archive.map !== void 0) value2["map"] = archive.map;
   const text = chunkQKZL3ONM_cjs.canonicalJson(value2);
   const zipped = zlib.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 (!chunkSAENRNBJ_cjs.isRecord(value2)) throw new chunk2DP2Y6EU_cjs.LowerError(`${what} must be an object`);
+  if (!chunkSAENRNBJ_cjs.isRecord(value2)) throw new chunk6QPOJZT6_cjs.LowerError(`${what} must be an object`);
   const out = {};
   for (const [key, entry] of Object.entries(value2)) {
-    if (typeof entry !== "string") throw new chunk2DP2Y6EU_cjs.LowerError(`${what}["${key}"] must be a string`);
+    if (typeof entry !== "string") throw new chunk6QPOJZT6_cjs.LowerError(`${what}["${key}"] must be a string`);
     Object.defineProperty(out, key, {
       value: entry,
       enumerable: true,
@@ -1472,7 +1476,7 @@ function unpackSources(data, options2 = {}) {
     text = zlib.gunzipSync(data, { maxOutputLength: maxBytes }).toString("utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw new chunk2DP2Y6EU_cjs.LowerError(
+    throw new chunk6QPOJZT6_cjs.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
     );
@@ -1481,20 +1485,24 @@ function unpackSources(data, options2 = {}) {
   try {
     parsed = JSON.parse(text);
   } catch {
-    throw new chunk2DP2Y6EU_cjs.LowerError("The source archive is not JSON");
+    throw new chunk6QPOJZT6_cjs.LowerError("The source archive is not JSON");
   }
-  if (!chunkSAENRNBJ_cjs.isRecord(parsed)) throw new chunk2DP2Y6EU_cjs.LowerError("The source archive is not an object");
+  if (!chunkSAENRNBJ_cjs.isRecord(parsed)) throw new chunk6QPOJZT6_cjs.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 chunk2DP2Y6EU_cjs.LowerError("lock must be a string");
+    if (typeof parsed["lock"] !== "string") throw new chunk6QPOJZT6_cjs.LowerError("lock must be a string");
     archive.lock = parsed["lock"];
   }
+  if (parsed["map"] !== void 0) {
+    if (typeof parsed["map"] !== "string") throw new chunk6QPOJZT6_cjs.LowerError("map must be a string");
+    archive.map = parsed["map"];
+  }
   if (parsed["vendored"] !== void 0) {
-    if (!chunkSAENRNBJ_cjs.isRecord(parsed["vendored"])) throw new chunk2DP2Y6EU_cjs.LowerError("vendored must be an object");
+    if (!chunkSAENRNBJ_cjs.isRecord(parsed["vendored"])) throw new chunk6QPOJZT6_cjs.LowerError("vendored must be an object");
     const vendored = {};
     for (const [name, pkg] of Object.entries(parsed["vendored"])) {
       if (!chunkSAENRNBJ_cjs.isRecord(pkg) || typeof pkg["version"] !== "string")
-        throw new chunk2DP2Y6EU_cjs.LowerError(`vendored["${name}"] needs a version`);
+        throw new chunk6QPOJZT6_cjs.LowerError(`vendored["${name}"] needs a version`);
       Object.defineProperty(vendored, name, {
         value: {
           version: pkg["version"],
@@ -1513,6 +1521,162 @@ function archiveDeps(archive) {
   return archive.vendored ?? {};
 }
 
+// src/roundtrip/source-map.ts
+var BUNDLE_FILE_NAME = "workflow-bundle.mjs";
+var BASE64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var BASE64_VALUE = new Map([...BASE64].map((char, index) => [char, index]));
+function decodeVlq(segment) {
+  const values = [];
+  let value2 = 0;
+  let shift = 0;
+  for (const char of segment) {
+    const digit = BASE64_VALUE.get(char);
+    if (digit === void 0) throw new chunk6QPOJZT6_cjs.LowerError(`Invalid source map character "${char}"`);
+    value2 += (digit & 31) * 2 ** shift;
+    if (digit & 32) {
+      shift += 5;
+      continue;
+    }
+    values.push(value2 % 2 === 1 ? -Math.floor(value2 / 2) : Math.floor(value2 / 2));
+    value2 = 0;
+    shift = 0;
+  }
+  if (shift !== 0) throw new chunk6QPOJZT6_cjs.LowerError("A source map segment ends in the middle of a number");
+  return values;
+}
+function createSourceMapper(mapText) {
+  let parsed;
+  try {
+    parsed = JSON.parse(mapText);
+  } catch {
+    throw new chunk6QPOJZT6_cjs.LowerError("The source map is not JSON");
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+    throw new chunk6QPOJZT6_cjs.LowerError("The source map is not an object");
+  const record = parsed;
+  const sources = record["sources"];
+  const names = Array.isArray(record["names"]) ? record["names"].map(String) : [];
+  const mappings = record["mappings"];
+  if (record["version"] !== 3 || !Array.isArray(sources) || typeof mappings !== "string")
+    throw new chunk6QPOJZT6_cjs.LowerError("Only version 3 source maps with mappings are supported");
+  const sourceNames = sources.map(String);
+  const lines = [];
+  let source = 0;
+  let line = 0;
+  let sourceColumn = 0;
+  let name = 0;
+  for (const lineText of mappings.split(";")) {
+    const segments = [];
+    let column = 0;
+    for (const text of lineText.split(",")) {
+      if (text === "") continue;
+      const values = decodeVlq(text);
+      column += values[0] ?? 0;
+      if (values.length < 4) continue;
+      source += values[1] ?? 0;
+      line += values[2] ?? 0;
+      sourceColumn += values[3] ?? 0;
+      const segment = { column, source, line, sourceColumn };
+      if (values.length >= 5) {
+        name += values[4] ?? 0;
+        segment.name = name;
+      }
+      segments.push(segment);
+    }
+    segments.sort((a, b) => a.column - b.column);
+    lines.push(segments);
+  }
+  return {
+    lookup(atLine, atColumn) {
+      const segments = lines[atLine - 1];
+      if (!segments || segments.length === 0) return void 0;
+      let found = segments[0];
+      if (atColumn !== void 0) {
+        found = void 0;
+        for (const segment of segments) {
+          if (segment.column > atColumn) break;
+          found = segment;
+        }
+        found ??= segments[0];
+      }
+      if (!found) return void 0;
+      const sourceName = sourceNames[found.source];
+      if (sourceName === void 0) return void 0;
+      const position = {
+        source: sourceName,
+        line: found.line + 1,
+        column: found.sourceColumn
+      };
+      const mappedName = found.name !== void 0 ? names[found.name] : void 0;
+      if (mappedName !== void 0) position.name = mappedName;
+      return position;
+    }
+  };
+}
+function isBundleFile(path, bundleFile) {
+  return path !== void 0 && (path === bundleFile || path.endsWith(`/${bundleFile}`));
+}
+function mapStackTrace(stack, mapper, bundleFile = BUNDLE_FILE_NAME) {
+  const frame = new RegExp(
+    `${bundleFile.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}:(\\d+)(?::(\\d+))?`,
+    "g"
+  );
+  return stack.split("\n").map(
+    (line) => line.replace(frame, (whole, lineText, columnText) => {
+      const position = mapper.lookup(
+        Number(lineText),
+        columnText !== void 0 ? Number(columnText) - 1 : void 0
+      );
+      return position ? `${position.source}:${position.line}:${position.column + 1}` : whole;
+    })
+  ).join("\n");
+}
+function mapEnhancedStackTrace(value2, mapper, bundleFile = BUNDLE_FILE_NAME) {
+  if (typeof value2 !== "object" || value2 === null || Array.isArray(value2)) return value2;
+  const stacks = value2["stacks"];
+  if (!Array.isArray(stacks)) return value2;
+  const mappedStacks = stacks.map((stack) => {
+    if (typeof stack !== "object" || stack === null || Array.isArray(stack)) return stack;
+    const locations = stack["locations"];
+    if (!Array.isArray(locations)) return stack;
+    return {
+      ...stack,
+      locations: locations.map((location) => {
+        if (typeof location !== "object" || location === null || Array.isArray(location))
+          return location;
+        const filePath = typeof location["filePath"] === "string" ? location["filePath"] : void 0;
+        const line = typeof location["line"] === "number" ? location["line"] : void 0;
+        const column = typeof location["column"] === "number" ? location["column"] : void 0;
+        if (!isBundleFile(filePath, bundleFile) || line === void 0) return location;
+        const position = mapper.lookup(line, column !== void 0 ? column - 1 : void 0);
+        if (!position) return location;
+        const out = {
+          ...location,
+          filePath: position.source,
+          line: position.line,
+          column: position.column + 1,
+          bundleLine: line
+        };
+        if (column !== void 0) out["bundleColumn"] = column;
+        return out;
+      })
+    };
+  });
+  return { ...value2, stacks: mappedStacks };
+}
+function sourceLocations(stack, mapper, bundleFile = BUNDLE_FILE_NAME) {
+  const out = [];
+  for (const location of chunkQ4MWQNJK_cjs.parseStack(stack)) {
+    if (!isBundleFile(location.filePath, bundleFile) || location.line === void 0) continue;
+    const position = mapper.lookup(
+      location.line,
+      location.column !== void 0 ? location.column - 1 : void 0
+    );
+    if (position) out.push(position);
+  }
+  return out;
+}
+
 // src/roundtrip/fidelity.ts
 var LOSSY_KINDS = /* @__PURE__ */ new Set([
   "layout-omitted",
@@ -1524,7 +1688,7 @@ async function checkFidelity(files, reference, items, options2 = {}) {
   const all = [...items];
   const connections = options2.connectionNames && chunkSAENRNBJ_cjs.isRecord(reference) ? connectionsByName(options2.connectionNames, reference) : void 0;
   try {
-    const result = await chunk2DP2Y6EU_cjs.lower(
+    const result = await chunk6QPOJZT6_cjs.lower(
       files.map((file) => ({ path: file.path, content: file.content })),
       {
         ...options2.esbuild ? { esbuild: options2.esbuild } : {},
@@ -1569,7 +1733,7 @@ async function exportWorkflowCode(definition, options2) {
 
 Object.defineProperty(exports, "createNodeVmEvaluator", {
   enumerable: true,
-  get: function () { return chunkHR3BN4C4_cjs.createNodeVmEvaluator; }
+  get: function () { return chunkOKX3FYIM_cjs.createNodeVmEvaluator; }
 });
 Object.defineProperty(exports, "PY_LINE_LENGTH", {
   enumerable: true,
@@ -1585,66 +1749,104 @@ Object.defineProperty(exports, "TS_NODES_IMPORT", {
 });
 Object.defineProperty(exports, "DeterminismViolationError", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.DeterminismViolationError; }
+  get: function () { return chunk6QPOJZT6_cjs.DeterminismViolationError; }
 });
 Object.defineProperty(exports, "ESBUILD_VERSION", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.ESBUILD_VERSION; }
+  get: function () { return chunk6QPOJZT6_cjs.ESBUILD_VERSION; }
 });
 Object.defineProperty(exports, "EVALUATION_GLOBAL", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.EVALUATION_GLOBAL; }
+  get: function () { return chunk6QPOJZT6_cjs.EVALUATION_GLOBAL; }
 });
 Object.defineProperty(exports, "LowerError", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.LowerError; }
+  get: function () { return chunk6QPOJZT6_cjs.LowerError; }
 });
 Object.defineProperty(exports, "NODE_BUILTINS", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.NODE_BUILTINS; }
+  get: function () { return chunk6QPOJZT6_cjs.NODE_BUILTINS; }
 });
 Object.defineProperty(exports, "buildBundle", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.buildBundle; }
+  get: function () { return chunk6QPOJZT6_cjs.buildBundle; }
 });
 Object.defineProperty(exports, "bundleProject", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.bundleProject; }
+  get: function () { return chunk6QPOJZT6_cjs.bundleProject; }
 });
 Object.defineProperty(exports, "bundleSourceHash", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.bundleSourceHash; }
+  get: function () { return chunk6QPOJZT6_cjs.bundleSourceHash; }
+});
+Object.defineProperty(exports, "callArguments", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.callArguments; }
 });
 Object.defineProperty(exports, "defaultEntries", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.defaultEntries; }
+  get: function () { return chunk6QPOJZT6_cjs.defaultEntries; }
+});
+Object.defineProperty(exports, "durableFeatures", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.durableFeatures; }
+});
+Object.defineProperty(exports, "durableScanModules", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.durableScanModules; }
+});
+Object.defineProperty(exports, "literalDurationMs", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.literalDurationMs; }
 });
 Object.defineProperty(exports, "lower", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.lower; }
+  get: function () { return chunk6QPOJZT6_cjs.lower; }
+});
+Object.defineProperty(exports, "objectEntries", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.objectEntries; }
 });
 Object.defineProperty(exports, "resolvePackageEntry", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.resolvePackageEntry; }
+  get: function () { return chunk6QPOJZT6_cjs.resolvePackageEntry; }
+});
+Object.defineProperty(exports, "scanDurableSource", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.scanDurableSource; }
 });
 Object.defineProperty(exports, "scanDurableSources", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.scanDurableSources; }
+  get: function () { return chunk6QPOJZT6_cjs.scanDurableSources; }
 });
 Object.defineProperty(exports, "splitSpecifier", {
   enumerable: true,
-  get: function () { return chunk2DP2Y6EU_cjs.splitSpecifier; }
+  get: function () { return chunk6QPOJZT6_cjs.splitSpecifier; }
+});
+Object.defineProperty(exports, "splitTopLevel", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.splitTopLevel; }
+});
+Object.defineProperty(exports, "withoutAllComments", {
+  enumerable: true,
+  get: function () { return chunk6QPOJZT6_cjs.withoutAllComments; }
 });
+exports.BUNDLE_FILE_NAME = BUNDLE_FILE_NAME;
 exports.LiftError = LiftError;
 exports.PY_PROJECT_MODULE = PY_PROJECT_MODULE;
 exports.PY_SDK_MODULE = PY_SDK_MODULE;
 exports.SOURCE_ARCHIVE_MAX_BYTES = SOURCE_ARCHIVE_MAX_BYTES;
 exports.archiveDeps = archiveDeps;
 exports.checkFidelity = checkFidelity;
+exports.createSourceMapper = createSourceMapper;
+exports.decodeVlq = decodeVlq;
 exports.exportWorkflowCode = exportWorkflowCode;
 exports.liftToPython = liftToPython;
 exports.liftToTypeScript = liftToTypeScript;
+exports.mapEnhancedStackTrace = mapEnhancedStackTrace;
+exports.mapStackTrace = mapStackTrace;
 exports.packSources = packSources;
 exports.prepareLift = prepareLift;
+exports.sourceLocations = sourceLocations;
 exports.unpackSources = unpackSources;
 exports.vendorDependencies = vendorDependencies;

package/dist/roundtrip/index.d.cts

@@ -1,14 +1,14 @@
-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 { W as WorkflowDefinition, a as JsonObject, J as Json } from '../types-Bb2wRnJ5.cjs';
+import { f as LayoutSidecar } from '../collect-CSyOg5XC.cjs';
+import { N as NodeManifest } from '../manifest-gRI2Q5Fj.cjs';
 import { P as PathSegment } from '../expressions-DhHaqyar.cjs';
-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 { V as VendoredDeps, a as VendoredPackage, E as Evaluator } from '../lower-3S6PsqjJ.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 durableFeatures, m as durableScanModules, n as lower, r as resolvePackageEntry, s as scanDurableSources, o as splitSpecifier } from '../lower-3S6PsqjJ.cjs';
+import { E as EsbuildApi } from '../lower-types-DQNBfWQn.cjs';
+export { B as BuildDiagnostic, a as BuildDiagnosticLocation, L as LowerError, b as LowerFailureReason } from '../lower-types-DQNBfWQn.cjs';
+import '../workflow-CZOXUlQ5.cjs';
+import '../workflow-O6e64ZcG.cjs';
+import '../types-CQKOhPTa.cjs';
 import '../hash-CZkTXPCX.cjs';
 import 'esbuild';
 
@@ -236,6 +236,8 @@ interface SourceArchive {
     lock?: string;
     /** Vendored packages by name. */
     vendored?: Record<string, VendoredPackage>;
+    /** The bundle's source map (`buildBundle(…, { sourcemap: 'external' }).map`, R2). */
+    map?: string;
 }
 declare const SOURCE_ARCHIVE_MAX_BYTES: number;
 /** Pack a source archive. */
@@ -247,6 +249,81 @@ declare function unpackSources(data: Uint8Array, options?: {
 /** The vendored packages of an archive as `buildBundle` takes them. */
 declare function archiveDeps(archive: SourceArchive): VendoredDeps;
 
+/**
+ * Read a bundle's source map (C-SOURCEMAP): map a position in the bundle back
+ * to the workflow source, so `__stack_trace` and `__enhanced_stack_trace` name
+ * the original TypeScript line (11 §2.21). The service keeps the map in the
+ * source archive (`map`) and applies it to the stacks a query returns.
+ *
+ * Only version 3 maps with `mappings` are read; index maps (`sections`) are
+ * not produced by `buildBundle` and are refused.
+ */
+
+/** The file name the isolates give a workflow bundle in stack traces. */
+declare const BUNDLE_FILE_NAME = "workflow-bundle.mjs";
+/** A position in the original source. Lines are 1-based, columns 0-based. */
+interface SourcePosition {
+    source: string;
+    line: number;
+    column: number;
+    name?: string;
+}
+/** Maps a bundle position (1-based line, 0-based column) to its source position. */
+interface SourceMapper {
+    /** Without a column, the first mapped segment of the line is used. */
+    lookup(line: number, column?: number): SourcePosition | undefined;
+}
+/** Decode one segment's base64 VLQ numbers. */
+declare function decodeVlq(segment: string): number[];
+/** Parse a version 3 source map. */
+declare function createSourceMapper(mapText: string): SourceMapper;
+/**
+ * Rewrite the bundle frames of a stack text (`at fn (workflow-bundle.mjs:12:5)`)
+ * to source positions (`at fn (workflows/order.ts:7:11)`). Other frames are kept.
+ */
+declare function mapStackTrace(stack: string, mapper: SourceMapper, bundleFile?: string): string;
+/**
+ * Map the locations of an `__enhanced_stack_trace` value in place of their
+ * bundle positions; a location keeps `bundleLine`/`bundleColumn` with the
+ * original position. Anything that is not the SDK's shape is returned as is.
+ */
+declare function mapEnhancedStackTrace(value: Json, mapper: SourceMapper, bundleFile?: string): Json;
+/** The source positions of the bundle frames of a stack text, innermost first. */
+declare function sourceLocations(stack: string, mapper: SourceMapper, bundleFile?: string): SourcePosition[];
+
+/** Bundle features a call site can show (the option-level ones come from the declarations). */
+type SourceFeature = 'localActivity' | 'externalCancel' | 'childOptions' | 'canOptions';
+/**
+ * The text between the parenthesis at `open` and its match, skipping string
+ * and template literals and comments. Unbalanced text runs to the end.
+ */
+declare function callArguments(text: string, open: number): string;
+/** Split `text` at commas that are not nested in brackets, literals or comments. */
+declare function splitTopLevel(text: string): string[];
+/**
+ * The top-level entries of an object literal (`{ a: 1, b }`): key and value
+ * text. Undefined when `text` is not an object literal or spreads another
+ * object, whose keys cannot be known.
+ */
+declare function objectEntries(text: string): Map<string, string> | undefined;
+/**
+ * `text` with its comments replaced by spaces (string and template literals
+ * are kept, so offsets and bracket access still read the same).
+ */
+declare function withoutAllComments(text: string): string;
+/** The milliseconds of a literal duration (`30000`, `'45s'`), or undefined for anything else. */
+declare function literalDurationMs(value: string): number | undefined;
+/** What one module's source shows. */
+interface DurableSourceFindings {
+    features: SourceFeature[];
+    /** `startToCloseTimeout` literals of local activities above the cap, in milliseconds. */
+    localActivityTimeouts: number[];
+    /** Local activities given a function (user local activities, Phase C). */
+    userLocalActivities: number;
+}
+/** Read one tier-2 module (or a module a tier-2 workflow may call). */
+declare function scanDurableSource(source: string): DurableSourceFindings;
+
 interface NodeVmEvaluatorOptions {
     /** Wall-clock budget for evaluating the bundle. Default 5000 ms. */
     timeoutMs?: number;
@@ -319,4 +396,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, 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 };
+export { BUNDLE_FILE_NAME, type DurableSourceFindings, 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, type SourceFeature, type SourceMapper, type SourcePosition, TS_FORMAT_OPTIONS, TS_NODES_IMPORT, type VendorOptions, VendoredDeps, VendoredPackage, archiveDeps, callArguments, checkFidelity, createNodeVmEvaluator, createSourceMapper, decodeVlq, exportWorkflowCode, liftToPython, liftToTypeScript, literalDurationMs, mapEnhancedStackTrace, mapStackTrace, objectEntries, packSources, prepareLift, scanDurableSource, sourceLocations, splitTopLevel, unpackSources, vendorDependencies, withoutAllComments };