@fluidgrids/workflows 2026.1028.1 → 2026.1029.1

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-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 { 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-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-XB53G2DK.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-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 { 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-7NQ37GZU.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 chunkCSNWNFKU_cjs = require('../chunk-CSNWNFKU.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-FQIHX7YI.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 chunkCSNWNFKU_cjs.CommandIds; }
+  get: function () { return chunkOMY3CKUZ_cjs.CommandIds; }
 });
 Object.defineProperty(exports, "RUNTIME_GLOBAL", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.RUNTIME_GLOBAL; }
+  get: function () { return chunkOMY3CKUZ_cjs.RUNTIME_GLOBAL; }
 });
 Object.defineProperty(exports, "SDK_NAME", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.SDK_NAME; }
+  get: function () { return chunkOMY3CKUZ_cjs.SDK_NAME; }
 });
 Object.defineProperty(exports, "WorkflowExecution", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.WorkflowExecution; }
+  get: function () { return chunkOMY3CKUZ_cjs.WorkflowExecution; }
 });
 Object.defineProperty(exports, "buildWorkflowRegistry", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.buildWorkflowRegistry; }
+  get: function () { return chunkOMY3CKUZ_cjs.buildWorkflowRegistry; }
 });
 Object.defineProperty(exports, "createWorkflowRuntime", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.createWorkflowRuntime; }
+  get: function () { return chunkOMY3CKUZ_cjs.createWorkflowRuntime; }
 });
 Object.defineProperty(exports, "installWorkflowRuntime", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.installWorkflowRuntime; }
+  get: function () { return chunkOMY3CKUZ_cjs.installWorkflowRuntime; }
 });
 Object.defineProperty(exports, "isPatchMarkerId", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.isPatchMarkerId; }
+  get: function () { return chunkOMY3CKUZ_cjs.isPatchMarkerId; }
 });
 Object.defineProperty(exports, "isRuntimeAbi", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.isRuntimeAbi; }
+  get: function () { return chunkOMY3CKUZ_cjs.isRuntimeAbi; }
 });
 Object.defineProperty(exports, "matchActivation", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.matchActivation; }
+  get: function () { return chunkOMY3CKUZ_cjs.matchActivation; }
 });
 Object.defineProperty(exports, "mismatch", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_cjs.mismatch; }
+  get: function () { return chunkOMY3CKUZ_cjs.mismatch; }
 });
 Object.defineProperty(exports, "patchMarkerId", {
   enumerable: true,
-  get: function () { return chunkCSNWNFKU_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; }
 });

package/dist/runtime/index.d.cts

@@ -1,7 +1,7 @@
-import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, j as Duration, l as SignalDefinition, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-J-yYixny.cjs';
-export { A as Activation, s as splitActivations } from '../activation-BBh1p82z.cjs';
-import { W as WorkflowCommand, U as RunEventRecord, a7 as WorkflowTaskRequest, a8 as WorkflowTaskResult, a as WorkflowTaskFailureCause, X as RunTarget } from '../types-CpBBjaGX.cjs';
-import { a as Json, J as JsonObject } from '../types-BGoPzgcl.cjs';
+import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, l as LocalActivityOptions, j as Duration, n as SignalDefinition, o as SignalHandlerOptions, k as ExternalRunTarget, E as ExternalRunHandle, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-O6e64ZcG.cjs';
+export { A as Activation, s as splitActivations } from '../activation-CESehfYi.cjs';
+import { W as WorkflowCommand, Z as RunEventRecord, aj as WorkflowTaskRequest, ak as WorkflowTaskResult, a as WorkflowTaskFailureCause, $ as RunTarget } from '../types-CQKOhPTa.cjs';
+import { J as Json, a as JsonObject } from '../types-Bb2wRnJ5.cjs';
 
 /**
  * Determinism shims for workflow tasks (C-ABI, spec 04 §4).
@@ -71,9 +71,10 @@ declare function matchActivation(commands: readonly WorkflowCommand[], recorded:
 /**
  * Command ids (C-HIST): one counter per kind, in issue order, so a replay that
  * issues the same commands in the same order derives the same ids, and a
- * reordered await is caught as a mismatch. Patch markers use `patch:<id>`.
+ * reordered await is caught as a mismatch. Patch markers use `patch:<id>`;
+ * local activities (R2) use `l<n>`.
  */
-type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm';
+type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm' | 'l';
 declare class CommandIds {
     private readonly counters;
     /** The next id of a kind: `a1`, `a2`, ... */
@@ -183,7 +184,16 @@ declare class WorkflowExecution {
     private readonly signalHandlers;
     private readonly signalWaiters;
     private defaultSignalHandler;
+    private defaultSignalPolicy;
+    private readonly signalPolicies;
     private runningHandlers;
+    /** Running asynchronous handlers by name, for the drain warning (11 §2.18). */
+    private readonly running;
+    private unfinished;
+    private readonly recordedLocalActivities;
+    private readonly localActivityResults;
+    private readonly localActivities;
+    private memo;
     private conditions;
     private currentDetails;
     readonly context: WorkflowContext;
@@ -198,10 +208,24 @@ declare class WorkflowExecution {
     step(): 'more' | 'done';
     /** The task's result. Call after `step()` returned `done` and jobs were drained. */
     complete(): WorkflowTaskResult;
+    /**
+     * The local activities the open activation waits for, when the task is a
+     * workflow task that has not failed or closed the run (a run that ends
+     * abandons a local activity it did not await).
+     */
+    private pendingLocalActivityRequests;
     /** Fail the task (the runtime's own failures and code errors). */
     failTask(cause: WorkflowTaskFailureCause, message: string, stackTrace?: string, seq?: number, errorType?: string): void;
     private beginActivation;
     private finishActivation;
+    /**
+     * A local activity issued on a replayed activation without a recorded
+     * outcome is fine only when the first execution dropped it in that same
+     * activation: its scope was cancelled (the entry is gone) or the run closed.
+     * One still waiting means the first execution would have requested and
+     * recorded it, so the code diverged from the history.
+     */
+    private checkReplayedLocalActivities;
     private deliver;
     private expectIssued;
     private settleActivity;
@@ -209,6 +233,12 @@ declare class WorkflowExecution {
     private dispatchSignal;
     private takeBuffered;
     private runHandler;
+    /**
+     * The drain check of 11 §2.18 when the workflow finishes: handlers still
+     * running with policy `WARN_AND_ABANDON` give one warning line and
+     * `unfinishedHandlers` in the result. A replay never reports them.
+     */
+    private checkUnfinishedHandlers;
     private startFunction;
     private onReturn;
     private isFailureType;
@@ -227,6 +257,15 @@ declare class WorkflowExecution {
     private stack;
     private never;
     scheduleActivity<In, Out>(scope: Scope, operation: Operation<In, Out>, options: RunOptions<In>): Promise<Out>;
+    /**
+     * `ctx.localActivity` (11 §2.12). A replayed activation returns the outcome
+     * its history recorded; the open activation takes the outcome the worker
+     * passed in `localActivityResults`, or asks for the local activity
+     * (`localActivityRequested`) and waits for the same task to run again.
+     * Either way the outcome is recorded with `RECORD_LOCAL_ACTIVITY` at the
+     * call, so a replay issues the same command at the same position.
+     */
+    localActivity<In, Out>(scope: Scope, operation: unknown, options: LocalActivityOptions<In> | undefined): Promise<Out>;
     startTimer(scope: Scope, durationMs: number, summary: string | undefined): Promise<void>;
     /** Start a durable timer; `timerId` is undefined when no timer was needed or issued. */
     private timer;
@@ -236,8 +275,11 @@ declare class WorkflowExecution {
     /** Resolve conditions whose predicate now holds; true when any did. */
     private checkConditions;
     signalReceived<P>(scope: Scope, signal: SignalDefinition<P> | string): Promise<P>;
-    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown): void;
+    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown, options?: SignalHandlerOptions): void;
     setDefaultSignalHandler(handler: (name: string, payload: unknown) => unknown): void;
+    /** The command target of a run handle (11 §2.1, §2.24). */
+    externalTarget(target: ExternalRunTarget): RunTarget;
+    runHandle(target: ExternalRunTarget): ExternalRunHandle;
     private childTarget;
     private childCommand;
     private startChildRun;

package/dist/runtime/index.d.ts

@@ -1,7 +1,7 @@
-import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, j as Duration, l as SignalDefinition, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-C2a05WUJ.js';
-export { A as Activation, s as splitActivations } from '../activation-DnhG7SmF.js';
-import { W as WorkflowCommand, U as RunEventRecord, a7 as WorkflowTaskRequest, a8 as WorkflowTaskResult, a as WorkflowTaskFailureCause, X as RunTarget } from '../types-DV-HX_Gt.js';
-import { a as Json, J as JsonObject } from '../types-BGoPzgcl.js';
+import { W as WorkflowContext, h as DurableWorkflow, C as CancellationScope, O as Operation, R as RunOptions, l as LocalActivityOptions, j as Duration, n as SignalDefinition, o as SignalHandlerOptions, k as ExternalRunTarget, E as ExternalRunHandle, e as ChildTarget, d as ChildOptions, c as ChildHandle, f as ContinueAsNewOptions, b as CancellationScopeOptions } from '../workflow-DWTPHFbt.js';
+export { A as Activation, s as splitActivations } from '../activation-BnVQMv9y.js';
+import { W as WorkflowCommand, Z as RunEventRecord, aj as WorkflowTaskRequest, ak as WorkflowTaskResult, a as WorkflowTaskFailureCause, $ as RunTarget } from '../types-CnIOinoz.js';
+import { J as Json, a as JsonObject } from '../types-Bb2wRnJ5.js';
 
 /**
  * Determinism shims for workflow tasks (C-ABI, spec 04 §4).
@@ -71,9 +71,10 @@ declare function matchActivation(commands: readonly WorkflowCommand[], recorded:
 /**
  * Command ids (C-HIST): one counter per kind, in issue order, so a replay that
  * issues the same commands in the same order derives the same ids, and a
- * reordered await is caught as a mismatch. Patch markers use `patch:<id>`.
+ * reordered await is caught as a mismatch. Patch markers use `patch:<id>`;
+ * local activities (R2) use `l<n>`.
  */
-type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm';
+type CommandIdKind = 'a' | 't' | 'c' | 's' | 'x' | 'm' | 'l';
 declare class CommandIds {
     private readonly counters;
     /** The next id of a kind: `a1`, `a2`, ... */
@@ -183,7 +184,16 @@ declare class WorkflowExecution {
     private readonly signalHandlers;
     private readonly signalWaiters;
     private defaultSignalHandler;
+    private defaultSignalPolicy;
+    private readonly signalPolicies;
     private runningHandlers;
+    /** Running asynchronous handlers by name, for the drain warning (11 §2.18). */
+    private readonly running;
+    private unfinished;
+    private readonly recordedLocalActivities;
+    private readonly localActivityResults;
+    private readonly localActivities;
+    private memo;
     private conditions;
     private currentDetails;
     readonly context: WorkflowContext;
@@ -198,10 +208,24 @@ declare class WorkflowExecution {
     step(): 'more' | 'done';
     /** The task's result. Call after `step()` returned `done` and jobs were drained. */
     complete(): WorkflowTaskResult;
+    /**
+     * The local activities the open activation waits for, when the task is a
+     * workflow task that has not failed or closed the run (a run that ends
+     * abandons a local activity it did not await).
+     */
+    private pendingLocalActivityRequests;
     /** Fail the task (the runtime's own failures and code errors). */
     failTask(cause: WorkflowTaskFailureCause, message: string, stackTrace?: string, seq?: number, errorType?: string): void;
     private beginActivation;
     private finishActivation;
+    /**
+     * A local activity issued on a replayed activation without a recorded
+     * outcome is fine only when the first execution dropped it in that same
+     * activation: its scope was cancelled (the entry is gone) or the run closed.
+     * One still waiting means the first execution would have requested and
+     * recorded it, so the code diverged from the history.
+     */
+    private checkReplayedLocalActivities;
     private deliver;
     private expectIssued;
     private settleActivity;
@@ -209,6 +233,12 @@ declare class WorkflowExecution {
     private dispatchSignal;
     private takeBuffered;
     private runHandler;
+    /**
+     * The drain check of 11 §2.18 when the workflow finishes: handlers still
+     * running with policy `WARN_AND_ABANDON` give one warning line and
+     * `unfinishedHandlers` in the result. A replay never reports them.
+     */
+    private checkUnfinishedHandlers;
     private startFunction;
     private onReturn;
     private isFailureType;
@@ -227,6 +257,15 @@ declare class WorkflowExecution {
     private stack;
     private never;
     scheduleActivity<In, Out>(scope: Scope, operation: Operation<In, Out>, options: RunOptions<In>): Promise<Out>;
+    /**
+     * `ctx.localActivity` (11 §2.12). A replayed activation returns the outcome
+     * its history recorded; the open activation takes the outcome the worker
+     * passed in `localActivityResults`, or asks for the local activity
+     * (`localActivityRequested`) and waits for the same task to run again.
+     * Either way the outcome is recorded with `RECORD_LOCAL_ACTIVITY` at the
+     * call, so a replay issues the same command at the same position.
+     */
+    localActivity<In, Out>(scope: Scope, operation: unknown, options: LocalActivityOptions<In> | undefined): Promise<Out>;
     startTimer(scope: Scope, durationMs: number, summary: string | undefined): Promise<void>;
     /** Start a durable timer; `timerId` is undefined when no timer was needed or issued. */
     private timer;
@@ -236,8 +275,11 @@ declare class WorkflowExecution {
     /** Resolve conditions whose predicate now holds; true when any did. */
     private checkConditions;
     signalReceived<P>(scope: Scope, signal: SignalDefinition<P> | string): Promise<P>;
-    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown): void;
+    onSignal(signal: SignalDefinition<unknown> | string, handler: (payload: unknown) => unknown, options?: SignalHandlerOptions): void;
     setDefaultSignalHandler(handler: (name: string, payload: unknown) => unknown): void;
+    /** The command target of a run handle (11 §2.1, §2.24). */
+    externalTarget(target: ExternalRunTarget): RunTarget;
+    runHandle(target: ExternalRunTarget): ExternalRunHandle;
     private childTarget;
     private childCommand;
     private startChildRun;