@fluidgrids/workflows 2026.1028.2 → 2026.1029.1

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-BzmUz0sq.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-BzmUz0sq.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-FXUkpIBc.cjs';
-import '../workflow-J-yYixny.cjs';
-import '../types-CpBBjaGX.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 };

package/dist/roundtrip/index.d.ts

@@ -1,14 +1,14 @@
-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 { W as WorkflowDefinition, a as JsonObject, J as Json } from '../types-Bb2wRnJ5.js';
+import { f as LayoutSidecar } from '../collect-BTHjQaSp.js';
+import { N as NodeManifest } from '../manifest-BJjrQt77.js';
 import { P as PathSegment } from '../expressions-DhHaqyar.js';
-import { V as VendoredDeps, a as VendoredPackage, E as Evaluator } from '../lower-_-iT4HYs.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-_-iT4HYs.js';
+import { V as VendoredDeps, a as VendoredPackage, E as Evaluator } from '../lower-DmZpQ8hJ.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 durableFeatures, m as durableScanModules, n as lower, r as resolvePackageEntry, s as scanDurableSources, o as splitSpecifier } from '../lower-DmZpQ8hJ.js';
 import { E as EsbuildApi } from '../lower-types-DQNBfWQn.js';
 export { B as BuildDiagnostic, a as BuildDiagnosticLocation, L as LowerError, b as LowerFailureReason } from '../lower-types-DQNBfWQn.js';
-import '../workflow-Bpr3vnA_.js';
-import '../workflow-C2a05WUJ.js';
-import '../types-DV-HX_Gt.js';
+import '../workflow-8uRU9rhL.js';
+import '../workflow-DWTPHFbt.js';
+import '../types-CnIOinoz.js';
 import '../hash-CZkTXPCX.js';
 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 };

package/dist/roundtrip/index.js

@@ -1,20 +1,23 @@
-export { createNodeVmEvaluator } from '../chunk-XHXIDVEC.js';
+export { createNodeVmEvaluator } from '../chunk-25BKWR2O.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-I5LR3D2K.js';
-export { DeterminismViolationError, ESBUILD_VERSION, EVALUATION_GLOBAL, LowerError, NODE_BUILTINS, buildBundle, bundleProject, bundleSourceHash, defaultEntries, lower, resolvePackageEntry, scanDurableSources, splitSpecifier } from '../chunk-I5LR3D2K.js';
-import '../chunk-XKJA7KX3.js';
-import { assembleRecording, LAYOUT_FORMAT_VERSION, LAYOUT_FORMAT, defineWorkflow, nodes, trigger, op, internalNodes, triggers, edge, defaultEdgeId } from '../chunk-HWJZVOG7.js';
+import { LowerError, lower } from '../chunk-A2OHX3UQ.js';
+export { DeterminismViolationError, ESBUILD_VERSION, EVALUATION_GLOBAL, LowerError, NODE_BUILTINS, buildBundle, bundleProject, bundleSourceHash, callArguments, defaultEntries, durableFeatures, durableScanModules, literalDurationMs, lower, objectEntries, resolvePackageEntry, scanDurableSource, scanDurableSources, splitSpecifier, splitTopLevel, withoutAllComments } from '../chunk-A2OHX3UQ.js';
+import '../chunk-OIX4O6UR.js';
+import { assembleRecording, LAYOUT_FORMAT_VERSION, LAYOUT_FORMAT, defineWorkflow, nodes, trigger, op, internalNodes, triggers, edge, defaultEdgeId } from '../chunk-FQSJI5NV.js';
 import { normalizeDefinition, irHash } from '../chunk-BD7ZPG53.js';
 import '../chunk-5LUIDMF4.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-N23SKIG4.js';
-import '../chunk-BO6OVILK.js';
+import { parseStack } from '../chunk-M272AHEX.js';
+import '../chunk-7ILGCUI6.js';
+import '../chunk-LNUQE6D6.js';
+import '../chunk-2DDULZFM.js';
+import '../chunk-PWIUEWC3.js';
 import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
 import { resolve, join, dirname, relative, sep } from 'path';
 import { gzipSync, gunzipSync } from 'zlib';
@@ -1445,6 +1448,7 @@ 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 = canonicalJson(value2);
   const zipped = gzipSync(Buffer.from(text, "utf8"), { level: 9 });
   zipped[GZIP_OS_BYTE] = 255;
@@ -1488,6 +1492,10 @@ function unpackSources(data, options2 = {}) {
     if (typeof parsed["lock"] !== "string") throw new LowerError("lock must be a string");
     archive.lock = parsed["lock"];
   }
+  if (parsed["map"] !== void 0) {
+    if (typeof parsed["map"] !== "string") throw new LowerError("map must be a string");
+    archive.map = parsed["map"];
+  }
   if (parsed["vendored"] !== void 0) {
     if (!isRecord(parsed["vendored"])) throw new LowerError("vendored must be an object");
     const vendored = {};
@@ -1512,6 +1520,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 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 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 LowerError("The source map is not JSON");
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+    throw new 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 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 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",
@@ -1566,4 +1730,4 @@ async function exportWorkflowCode(definition, options2) {
   return { format: options2.format, files, fidelity, irHash: irHash(definition) };
 }
 
-export { LiftError, PY_PROJECT_MODULE, PY_SDK_MODULE, SOURCE_ARCHIVE_MAX_BYTES, archiveDeps, checkFidelity, exportWorkflowCode, liftToPython, liftToTypeScript, packSources, prepareLift, unpackSources, vendorDependencies };
+export { BUNDLE_FILE_NAME, LiftError, PY_PROJECT_MODULE, PY_SDK_MODULE, SOURCE_ARCHIVE_MAX_BYTES, archiveDeps, checkFidelity, createSourceMapper, decodeVlq, exportWorkflowCode, liftToPython, liftToTypeScript, mapEnhancedStackTrace, mapStackTrace, packSources, prepareLift, sourceLocations, unpackSources, vendorDependencies };

package/dist/runtime/index.cjs

@@ -1,64 +1,65 @@
 'use strict';
 
-var chunkM4BBAERY_cjs = require('../chunk-M4BBAERY.cjs');
-require('../chunk-FMSW2HDF.cjs');
-require('../chunk-FR7KYWRO.cjs');
+var chunkOMY3CKUZ_cjs = require('../chunk-OMY3CKUZ.cjs');
+require('../chunk-ELL2RBML.cjs');
+require('../chunk-Q4MWQNJK.cjs');
 var chunkL24YIZY7_cjs = require('../chunk-L24YIZY7.cjs');
-require('../chunk-DHTLALBL.cjs');
-var chunkP6TA5EZT_cjs = require('../chunk-P6TA5EZT.cjs');
-require('../chunk-623FVQSN.cjs');
-require('../chunk-2J6TF7YI.cjs');
+require('../chunk-J3PYFGKA.cjs');
+require('../chunk-FR7KYWRO.cjs');
+var chunkRUQIMTN5_cjs = require('../chunk-RUQIMTN5.cjs');
+require('../chunk-3FIDHONL.cjs');
+require('../chunk-YHBVMOMK.cjs');
 require('../chunk-Z2Y65YOY.cjs');
 
 
 
 Object.defineProperty(exports, "CommandIds", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.CommandIds; }
+  get: function () { return chunkOMY3CKUZ_cjs.CommandIds; }
 });
 Object.defineProperty(exports, "RUNTIME_GLOBAL", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.RUNTIME_GLOBAL; }
+  get: function () { return chunkOMY3CKUZ_cjs.RUNTIME_GLOBAL; }
 });
 Object.defineProperty(exports, "SDK_NAME", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.SDK_NAME; }
+  get: function () { return chunkOMY3CKUZ_cjs.SDK_NAME; }
 });
 Object.defineProperty(exports, "WorkflowExecution", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.WorkflowExecution; }
+  get: function () { return chunkOMY3CKUZ_cjs.WorkflowExecution; }
 });
 Object.defineProperty(exports, "buildWorkflowRegistry", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.buildWorkflowRegistry; }
+  get: function () { return chunkOMY3CKUZ_cjs.buildWorkflowRegistry; }
 });
 Object.defineProperty(exports, "createWorkflowRuntime", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.createWorkflowRuntime; }
+  get: function () { return chunkOMY3CKUZ_cjs.createWorkflowRuntime; }
 });
 Object.defineProperty(exports, "installWorkflowRuntime", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.installWorkflowRuntime; }
+  get: function () { return chunkOMY3CKUZ_cjs.installWorkflowRuntime; }
 });
 Object.defineProperty(exports, "isPatchMarkerId", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.isPatchMarkerId; }
+  get: function () { return chunkOMY3CKUZ_cjs.isPatchMarkerId; }
 });
 Object.defineProperty(exports, "isRuntimeAbi", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.isRuntimeAbi; }
+  get: function () { return chunkOMY3CKUZ_cjs.isRuntimeAbi; }
 });
 Object.defineProperty(exports, "matchActivation", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.matchActivation; }
+  get: function () { return chunkOMY3CKUZ_cjs.matchActivation; }
 });
 Object.defineProperty(exports, "mismatch", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.mismatch; }
+  get: function () { return chunkOMY3CKUZ_cjs.mismatch; }
 });
 Object.defineProperty(exports, "patchMarkerId", {
   enumerable: true,
-  get: function () { return chunkM4BBAERY_cjs.patchMarkerId; }
+  get: function () { return chunkOMY3CKUZ_cjs.patchMarkerId; }
 });
 Object.defineProperty(exports, "SHIM_HOOK", {
   enumerable: true,
@@ -86,5 +87,5 @@ Object.defineProperty(exports, "uuidFrom", {
 });
 Object.defineProperty(exports, "splitActivations", {
   enumerable: true,
-  get: function () { return chunkP6TA5EZT_cjs.splitActivations; }
+  get: function () { return chunkRUQIMTN5_cjs.splitActivations; }
 });