footprintjs 9.26.0 → 9.28.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/AGENTS.md +3 -0
  2. package/CLAUDE.md +5 -4
  3. package/README.md +4 -0
  4. package/dist/advanced.js +3 -2
  5. package/dist/esm/advanced.d.ts +2 -2
  6. package/dist/esm/advanced.js +2 -2
  7. package/dist/esm/index.d.ts +1 -1
  8. package/dist/esm/index.js +1 -1
  9. package/dist/esm/lib/builder/FlowChartBuilder.d.ts +10 -0
  10. package/dist/esm/lib/builder/FlowChartBuilder.js +27 -13
  11. package/dist/esm/lib/engine/handlers/ChildrenExecutor.js +45 -12
  12. package/dist/esm/lib/engine/handlers/ResumeEntry.d.ts +195 -0
  13. package/dist/esm/lib/engine/handlers/ResumeEntry.js +471 -0
  14. package/dist/esm/lib/engine/handlers/SubflowExecutor.d.ts +6 -0
  15. package/dist/esm/lib/engine/handlers/SubflowExecutor.js +43 -10
  16. package/dist/esm/lib/engine/handlers/index.d.ts +2 -0
  17. package/dist/esm/lib/engine/handlers/index.js +2 -1
  18. package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +1 -1
  19. package/dist/esm/lib/engine/traversal/FlowchartTraverser.d.ts +49 -4
  20. package/dist/esm/lib/engine/traversal/FlowchartTraverser.js +64 -13
  21. package/dist/esm/lib/engine/types.d.ts +30 -11
  22. package/dist/esm/lib/engine/types.js +1 -1
  23. package/dist/esm/lib/pause/index.d.ts +1 -1
  24. package/dist/esm/lib/pause/index.js +1 -1
  25. package/dist/esm/lib/pause/types.d.ts +93 -5
  26. package/dist/esm/lib/pause/types.js +57 -3
  27. package/dist/esm/lib/runner/FlowChartExecutor.d.ts +8 -10
  28. package/dist/esm/lib/runner/FlowChartExecutor.js +153 -181
  29. package/dist/esm/lib/time-travel/bundles.js +11 -1
  30. package/dist/index.js +1 -1
  31. package/dist/lib/builder/FlowChartBuilder.js +27 -13
  32. package/dist/lib/engine/handlers/ChildrenExecutor.js +45 -12
  33. package/dist/lib/engine/handlers/ResumeEntry.js +478 -0
  34. package/dist/lib/engine/handlers/SubflowExecutor.js +43 -10
  35. package/dist/lib/engine/handlers/index.js +4 -2
  36. package/dist/lib/engine/traversal/FlowchartTraverser.js +64 -13
  37. package/dist/lib/engine/types.js +1 -1
  38. package/dist/lib/pause/index.js +1 -1
  39. package/dist/lib/pause/types.js +57 -3
  40. package/dist/lib/runner/FlowChartExecutor.js +153 -181
  41. package/dist/lib/time-travel/bundles.js +11 -1
  42. package/dist/types/advanced.d.ts +2 -2
  43. package/dist/types/index.d.ts +1 -1
  44. package/dist/types/lib/builder/FlowChartBuilder.d.ts +10 -0
  45. package/dist/types/lib/engine/handlers/ResumeEntry.d.ts +195 -0
  46. package/dist/types/lib/engine/handlers/SubflowExecutor.d.ts +6 -0
  47. package/dist/types/lib/engine/handlers/index.d.ts +2 -0
  48. package/dist/types/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +1 -1
  49. package/dist/types/lib/engine/traversal/FlowchartTraverser.d.ts +49 -4
  50. package/dist/types/lib/engine/types.d.ts +30 -11
  51. package/dist/types/lib/pause/index.d.ts +1 -1
  52. package/dist/types/lib/pause/types.d.ts +93 -5
  53. package/dist/types/lib/runner/FlowChartExecutor.d.ts +8 -10
  54. package/package.json +1 -1
@@ -89,6 +89,16 @@ function bundleRefusal(row) {
89
89
  return 'updates is not a plain object';
90
90
  if (row.overwrite !== undefined && !isPlainish(row.overwrite))
91
91
  return 'overwrite is not a plain object';
92
+ // The four verbs are the contract (9.27.0). The replay's switch used to
93
+ // treat anything else as `merge` — a silent coercion of a row a foreign
94
+ // producer got wrong. A bundle with such a row is a gap, and says which.
95
+ for (let i = 0; i < row.trace.length; i++) {
96
+ const entry = row.trace[i];
97
+ const verb = isPlainish(entry) ? entry.verb : undefined;
98
+ if (verb !== 'set' && verb !== 'merge' && verb !== 'append' && verb !== 'delete') {
99
+ return `trace[${i}].verb is ${verb === undefined ? 'missing' : JSON.stringify(verb)}, not set | merge | append | delete`;
100
+ }
101
+ }
92
102
  return undefined;
93
103
  }
94
104
  exports.bundleRefusal = bundleRefusal;
@@ -129,4 +139,4 @@ function readLog(raw) {
129
139
  return { log, gaps: Object.freeze(gaps) };
130
140
  }
131
141
  exports.readLog = readLog;
132
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVuZGxlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvdGltZS10cmF2ZWwvYnVuZGxlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7OztBQUtIOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sVUFBVSxHQUFpQixNQUFNLENBQUMsTUFBTSxDQUFDO0lBQzdDLEtBQUssRUFBRSxFQUFFO0lBQ1QsT0FBTyxFQUFFLEVBQUU7SUFDWCxjQUFjLEVBQUUsRUFBRTtJQUNsQixLQUFLLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQXFDO0lBQzVELGFBQWEsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBd0I7SUFDdkQsU0FBUyxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO0lBQzVCLE9BQU8sRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztDQUMzQixDQUFDLENBQUM7QUFFSCxnRUFBZ0U7QUFDaEUsU0FBZ0IsVUFBVSxDQUFDLEtBQWM7SUFDdkMsT0FBTyxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksS0FBSyxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDOUUsQ0FBQztBQUZELGdDQUVDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxTQUFnQixRQUFRLENBQUMsS0FBYztJQUNyQyxPQUFPLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUUsS0FBa0MsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQzdFLENBQUM7QUFGRCw0QkFFQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBbUJHO0FBQ0gsU0FBZ0IsYUFBYSxDQUFDLEdBQVk7SUFDeEMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ3JCLE9BQU8sa0JBQWtCLEdBQUcsS0FBSyxJQUFJLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxPQUFPLEdBQUcsR0FBRyxDQUFDO0lBQ2hHLENBQUM7SUFDRCxJQUFJLE9BQU8sR0FBRyxDQUFDLGNBQWMsS0FBSyxRQUFRLEVBQUUsQ0FBQztRQUMzQyxPQUFPLHFCQUNMLEdBQUcsQ0FBQyxjQUFjLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLEtBQUssT0FBTyxHQUFHLENBQUMsY0FBYyxFQUMvRSxnQkFBZ0IsQ0FBQztJQUNuQixDQUFDO0lBQ0QsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDOUIsT0FBTyxZQUFZLEdBQUcsQ0FBQyxLQUFLLEtBQUssU0FBUyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLEtBQUssT0FBTyxHQUFHLENBQUMsS0FBSyxFQUFFLGdCQUFnQixDQUFDO0lBQ25HLENBQUM7SUFDRCxJQUFJLEdBQUcsQ0FBQyxPQUFPLEtBQUssU0FBUyxJQUFJLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUM7UUFBRSxPQUFPLCtCQUErQixDQUFDO0lBQ2xHLElBQUksR0FBRyxDQUFDLFNBQVMsS0FBSyxTQUFTLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQztRQUFFLE9BQU8saUNBQWlDLENBQUM7SUFDeEcsT0FBTyxTQUFTLENBQUM7QUFDbkIsQ0FBQztBQWZELHNDQWVDO0FBRUQsK0RBQStEO0FBQy9ELFNBQWdCLGNBQWMsQ0FBQyxHQUFZO0lBQ3pDLE9BQU8sYUFBYSxDQUFDLEdBQUcsQ0FBQyxLQUFLLFNBQVMsQ0FBQztBQUMxQyxDQUFDO0FBRkQsd0NBRUM7QUFVRCwyRUFBMkU7QUFDM0UsTUFBTSxPQUFPLEdBQXNCLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDLENBQUM7QUFFckQ7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFDSCxTQUFnQixPQUFPLENBQUMsR0FBbUM7SUFDekQsSUFBSSxDQUFDLEdBQUcsSUFBSSxHQUFHLENBQUMsTUFBTSxLQUFLLENBQUM7UUFBRSxPQUFPLEVBQUUsR0FBRyxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFLENBQUM7SUFFaEUsSUFBSSxJQUEwQixDQUFDO0lBQy9CLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxHQUFHLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDcEMsTUFBTSxNQUFNLEdBQUcsYUFBYSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQ3JDLElBQUksTUFBTSxLQUFLLFNBQVM7WUFBRSxDQUFDLElBQUksS0FBSyxFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsRUFBRSxLQUFLLEVBQUUsQ0FBQyxFQUFFLE1BQU0sRUFBRSxDQUFDLENBQUM7SUFDckUsQ0FBQztJQUNELElBQUksQ0FBQyxJQUFJO1FBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxHQUE4QixFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsQ0FBQztJQUV6RSxNQUFNLEdBQUcsR0FBRyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FBQyxDQUFDLGNBQWMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxVQUFVLENBQUMsQ0FBQyxDQUFDO0lBQ3ZFLE9BQU8sRUFBRSxHQUFHLEVBQUUsSUFBSSxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztBQUM1QyxDQUFDO0FBWkQsMEJBWUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIGJ1bmRsZXMudHMg4oCUIHJlYWRpbmcgYSBsb2cgd2hvc2Ugcm93cyBhcmUgbm90IHR5cGVkIHlldC5cbiAqXG4gKiBXSFkgVEhJUyBGSUxFIEVYSVNUUy4gQSBMSVZFIHNuYXBzaG90IGhhbmRzIHRpbWUgdHJhdmVsIHJlYWxcbiAqIHtAbGluayBDb21taXRCdW5kbGV9cy4gQSBTVE9SRUQgcmVjb3JkaW5nIGhhbmRzIGl0IHBhcnNlZCBKU09OLCBhbmQgYVxuICogY2FyZWZ1bCBjb25zdW1lciB3aWxsIG5vdCBjbGFpbSB0aGF0IHdoYXQgY2FtZSBiYWNrIG9mZiBkaXNrIGlzIGFcbiAqIGBDb21taXRCdW5kbGVgIOKAlCBzbyBpdCBlaXRoZXIgY2FzdHMgKGEgbGllIHdpdGggYSBjb21tZW50IG9uIGl0KSBvciBjYW5ub3RcbiAqIGNhbGwgdGhlIGxpYnJhcnkgYXQgYWxsLiBTaW5jZSA5LjE4LjAgdGhlIHNvdXJjZSB0YWtlcyBgcmVhZG9ubHkgdW5rbm93bltdYFxuICogYW5kIHRoZSBuYXJyb3dpbmcgaGFwcGVucyBoZXJlLCBwZXIgcm93LCBhdCB0aGUgb25lIHBsYWNlIHRoYXQgYWN0dWFsbHlcbiAqIHJlYWRzIG9uZS5cbiAqXG4gKiBBIHJvdyB0aGF0IGlzIG5vdCBhIGJ1bmRsZSBiZWNvbWVzIGEgR0FQIHJhdGhlciB0aGFuIGFuIGV4Y2VwdGlvbjogaXQgS0VFUFNcbiAqIElUUyBJTkRFWCDigJQgc28gZXZlcnkgYGNvbW1pdElkeGAgaW4gdGhlIGF4aXMgc3RpbGwgYWRkcmVzc2VzIHRoZSBzYW1lXG4gKiBwb3NpdGlvbiDigJQgY29udHJpYnV0ZXMgbm8gc3RhdGUsIGdldHMgbm8gc3RvcCwgYW5kIGlzIHJlcG9ydGVkIHdpdGggaXRzXG4gKiBpbmRleCBhbmQgYSByZWFzb24uIE9uZSBjb3JydXB0IHJvdyBpbiBhIHN0b3JlZCByZWNvcmRpbmcgbG9zZXMgdGhhdCByb3csXG4gKiBub3QgdGhlIHJlY29yZGluZy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENvbW1pdEJ1bmRsZSwgU3RhZ2VTbmFwc2hvdCB9IGZyb20gJy4uL21lbW9yeS90eXBlcy5qcyc7XG5pbXBvcnQgdHlwZSB7IExvZ0dhcCB9IGZyb20gJy4vdHlwZXMuanMnO1xuXG4vKipcbiAqIFRoZSBzdGFuZC1pbiBhIGdhcCBsZWF2ZXMgYXQgaXRzIGluZGV4OiBhIGNvbW1pdCB0aGF0IGJlbG9uZ3MgdG8gbm8gc3RhZ2VcbiAqIGFuZCBjYXJyaWVzIG5vdGhpbmcuXG4gKlxuICogSXQgaXMgTk9UIGludmVudGVkIGV2aWRlbmNlIOKAlCBldmVyeSBmaWVsZCBpcyB0aGUgZW1wdHkgdmFsdWUsIGFuZCBhbiBpZC1sZXNzXG4gKiBidW5kbGUgaXMgYSBzaGFwZSB0aGUgbG9nIGFscmVhZHkgaGFzIChhIHJvb3QtY29udGV4dCBjb21taXQgbWFkZSBiZWZvcmUgYW55XG4gKiBzdGFnZSByYW4pLiBgY29tbWl0U3RvcHNgIGdpdmVzIGl0IG5vIHN0b3AgZm9yIGV4YWN0bHkgdGhhdCByZWFzb24sIHRoZSBmb2xkXG4gKiBmb2xkcyBub3RoaW5nIGZyb20gaXQsIGFuZCBgY2hhbmdlZFNpbmNlYCByZWFkcyBubyBrZXlzIG9mZiBpdC4gV2hhdCBpdCBkb2VzXG4gKiBpcyBob2xkIHRoZSBpbmRleCwgc28gdGhlIGFyaXRobWV0aWMgZG93bnN0cmVhbSBuZXZlciBoYXMgdG8ga25vdy5cbiAqL1xuY29uc3QgR0FQX0JVTkRMRTogQ29tbWl0QnVuZGxlID0gT2JqZWN0LmZyZWV6ZSh7XG4gIHN0YWdlOiAnJyxcbiAgc3RhZ2VJZDogJycsXG4gIHJ1bnRpbWVTdGFnZUlkOiAnJyxcbiAgdHJhY2U6IE9iamVjdC5mcmVlemUoW10pIGFzIHVua25vd24gYXMgQ29tbWl0QnVuZGxlWyd0cmFjZSddLFxuICByZWRhY3RlZFBhdGhzOiBPYmplY3QuZnJlZXplKFtdKSBhcyB1bmtub3duIGFzIHN0cmluZ1tdLFxuICBvdmVyd3JpdGU6IE9iamVjdC5mcmVlemUoe30pLFxuICB1cGRhdGVzOiBPYmplY3QuZnJlZXplKHt9KSxcbn0pO1xuXG4vKiogQSBwbGFpbiBvYmplY3Qg4oCUIG5vdCBudWxsLCBub3QgYW4gYXJyYXksIG5vdCBhIHByaW1pdGl2ZS4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1BsYWluaXNoKHZhbHVlOiB1bmtub3duKTogdmFsdWUgaXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj4ge1xuICByZXR1cm4gdHlwZW9mIHZhbHVlID09PSAnb2JqZWN0JyAmJiB2YWx1ZSAhPT0gbnVsbCAmJiAhQXJyYXkuaXNBcnJheSh2YWx1ZSk7XG59XG5cbi8qKlxuICogUmVhZCBhIHNvdXJjZSdzIGBleGVjdXRpb25UcmVlYCBhcyBhIHtAbGluayBTdGFnZVNuYXBzaG90fSwgb3IgYXMgYWJzZW50LlxuICpcbiAqIFRoZSB0cmVlIGlzIG9ubHkgZXZlciBXQUxLRUQgZm9yIG1vdW50IGlkcyAoYHN1YmZsb3dJZGAgKyBgcnVudGltZVN0YWdlSWRgXG4gKiBvbiBlYWNoIG5vZGUpLCBzbyB0aGUgaG9uZXN0IG5hcnJvd2luZyBhIHJlYWRlciBjYW4gZG8gaXMgXCJhIHBsYWluIG9iamVjdFwiO1xuICogYW55dGhpbmcgZWxzZSDigJQgYSBzdG9yZWQgZmllbGQgdGhhdCBjYW1lIGJhY2sgYXMgYSBzdHJpbmcsIGEgbnVtYmVyLCBhblxuICogYXJyYXkg4oCUIGlzIHJlYWQgYXMgbm8gdHJlZSBhdCBhbGwsIHdoaWNoIHNlbmRzIGBjb21taXRTdG9wc2AgZG93biB0aGUgc2FtZVxuICogc2hhcGUtaGV1cmlzdGljIHBhdGggYSBsb2cgaGFuZGVkIG92ZXIgd2l0aG91dCBpdHMgdHJlZSBhbHJlYWR5IHRha2VzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVhZFRyZWUodmFsdWU6IHVua25vd24pOiBTdGFnZVNuYXBzaG90IHwgdW5kZWZpbmVkIHtcbiAgcmV0dXJuIGlzUGxhaW5pc2godmFsdWUpID8gKHZhbHVlIGFzIHVua25vd24gYXMgU3RhZ2VTbmFwc2hvdCkgOiB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogV2h5IGByb3dgIGNhbm5vdCBiZSByZWFkIGFzIGEgY29tbWl0IGJ1bmRsZSwgb3IgYHVuZGVmaW5lZGAgd2hlbiBpdCBjYW4uXG4gKlxuICogREVMSUJFUkFURUxZIExFTklFTlQg4oCUIGJ1dCBleGFjdGx5IGFzIGxlbmllbnQgYXMgdGhlIHJlYWRlcnMgYXJlLiBJdCBjaGVja3NcbiAqIHdoYXQgdGhlIGZvbGQsIHRoZSBheGlzIGFuZCBgY2hhbmdlZFNpbmNlYCBhY3R1YWxseSB0b3VjaDpcbiAqXG4gKiAtIGBydW50aW1lU3RhZ2VJZGAgbXVzdCBiZSBhIHN0cmluZyDigJQgdGhlIGF4aXMga2V5cyBvbiBpdC5cbiAqIC0gYHRyYWNlYCBtdXN0IGJlIGFuIEFSUkFZLCBhbmQgaXQgbXVzdCBiZSBQUkVTRU5ULiBJdCBpcyB0aGUgb25lIGZpZWxkXG4gKiAgIGV2ZXJ5IHJlYWRlciBXQUxLUyAoYGFwcGx5U21hcnRNZXJnZWAgaXRlcmF0ZXMgaXQgdmVyYiBieSB2ZXJiO1xuICogICBgY2hhbmdlZFNpbmNlYCByZWFkcyBpdHMgcGF0aHMpLCBzbyBhIHJvdyB3aXRob3V0IG9uZSBpcyBub3QgYSBidW5kbGUgdGhlXG4gKiAgIGZvbGQgY2FuIHN1cnZpdmUg4oCUIGl0IGlzIHRoZSBjcmFzaCBhIGdhcCBleGlzdHMgdG8gcHJldmVudC4gYENvbW1pdEJ1bmRsZWBcbiAqICAgZGVjbGFyZXMgaXQgcmVxdWlyZWQsIHNvIG5vIGxpdmUgbG9nIGlzIGFmZmVjdGVkLlxuICogLSBgdXBkYXRlc2AgLyBgb3ZlcndyaXRlYCwgd2hlbiBwcmVzZW50LCBtdXN0IGJlIHBsYWluIG9iamVjdHMuIFRoZXkgYXJlXG4gKiAgIHJlYWQgb25seSBBVCBUSEUgUEFUSFMgVEhFIFRSQUNFIE5BTUVTLCBzbyBhbiBhYnNlbnQgb25lIGlzIGhhcm1sZXNzIGFuZFxuICogICBpcyB0b2xlcmF0ZWQsIGV4YWN0bHkgYXMgdGhlIGZvbGQgdG9sZXJhdGVzIGFuIGFic2VudCBgcmVkYWN0ZWRQYXRoc2AuXG4gKlxuICogQmVpbmcgc3RyaWN0ZXIgdGhhbiB0aGF0IOKAlCBkZW1hbmRpbmcgYHN0YWdlYCwgYHN0YWdlSWRgLCBgaWR4YCDigJQgd291bGRcbiAqIHJlamVjdCBoYW5kLWJ1aWx0IGxvZ3MgdGhhdCBoYXZlIGZvbGRlZCBjb3JyZWN0bHkgc2luY2UgOS4xNy4wLCB3aGljaCBpcyBhXG4gKiBjb21wYXRpYmlsaXR5IGJyZWFrIGRyZXNzZWQgdXAgYXMgdmFsaWRhdGlvbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJ1bmRsZVJlZnVzYWwocm93OiB1bmtub3duKTogc3RyaW5nIHwgdW5kZWZpbmVkIHtcbiAgaWYgKCFpc1BsYWluaXNoKHJvdykpIHtcbiAgICByZXR1cm4gYG5vdCBhbiBvYmplY3QgKCR7cm93ID09PSBudWxsID8gJ251bGwnIDogQXJyYXkuaXNBcnJheShyb3cpID8gJ2FycmF5JyA6IHR5cGVvZiByb3d9KWA7XG4gIH1cbiAgaWYgKHR5cGVvZiByb3cucnVudGltZVN0YWdlSWQgIT09ICdzdHJpbmcnKSB7XG4gICAgcmV0dXJuIGBydW50aW1lU3RhZ2VJZCBpcyAke1xuICAgICAgcm93LnJ1bnRpbWVTdGFnZUlkID09PSB1bmRlZmluZWQgPyAnbWlzc2luZycgOiBgYSAke3R5cGVvZiByb3cucnVudGltZVN0YWdlSWR9YFxuICAgIH0sIG5vdCBhIHN0cmluZ2A7XG4gIH1cbiAgaWYgKCFBcnJheS5pc0FycmF5KHJvdy50cmFjZSkpIHtcbiAgICByZXR1cm4gYHRyYWNlIGlzICR7cm93LnRyYWNlID09PSB1bmRlZmluZWQgPyAnbWlzc2luZycgOiBgYSAke3R5cGVvZiByb3cudHJhY2V9YH0sIG5vdCBhbiBhcnJheWA7XG4gIH1cbiAgaWYgKHJvdy51cGRhdGVzICE9PSB1bmRlZmluZWQgJiYgIWlzUGxhaW5pc2gocm93LnVwZGF0ZXMpKSByZXR1cm4gJ3VwZGF0ZXMgaXMgbm90IGEgcGxhaW4gb2JqZWN0JztcbiAgaWYgKHJvdy5vdmVyd3JpdGUgIT09IHVuZGVmaW5lZCAmJiAhaXNQbGFpbmlzaChyb3cub3ZlcndyaXRlKSkgcmV0dXJuICdvdmVyd3JpdGUgaXMgbm90IGEgcGxhaW4gb2JqZWN0JztcbiAgcmV0dXJuIHVuZGVmaW5lZDtcbn1cblxuLyoqIGB0cnVlYCB3aGVuIGByb3dgIGNhbiBiZSByZWFkIGFzIGEge0BsaW5rIENvbW1pdEJ1bmRsZX0uICovXG5leHBvcnQgZnVuY3Rpb24gaXNDb21taXRCdW5kbGUocm93OiB1bmtub3duKTogcm93IGlzIENvbW1pdEJ1bmRsZSB7XG4gIHJldHVybiBidW5kbGVSZWZ1c2FsKHJvdykgPT09IHVuZGVmaW5lZDtcbn1cblxuLyoqIEEgbG9nIHJlYWQgcm93IGJ5IHJvdzogdGhlIGJ1bmRsZXMsIGluZGV4LWFsaWduZWQsIHBsdXMgd2hhdCB3YXMgcmVmdXNlZC4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVhZExvZyB7XG4gIC8qKiBTYW1lIGxlbmd0aCBhbmQgb3JkZXIgYXMgdGhlIGlucHV0OyBhIHJlZnVzZWQgcm93IGhvbGRzIGEgR0FQIHN0YW5kLWluLiAqL1xuICByZWFkb25seSBsb2c6IHJlYWRvbmx5IENvbW1pdEJ1bmRsZVtdO1xuICAvKiogVGhlIHJlZnVzZWQgcm93cywgaW4gaW5kZXggb3JkZXIuIEVtcHR5IHdoZW4gdGhlIGxvZyB3YXMgY2xlYW4uICovXG4gIHJlYWRvbmx5IGdhcHM6IHJlYWRvbmx5IExvZ0dhcFtdO1xufVxuXG4vKiogTm90aGluZyB0byByZWFkIOKAlCBzaGFyZWQsIHNvIHRoZSBjbGVhbiBwYXRoIGFsbG9jYXRlcyBub3RoaW5nIGV4dHJhLiAqL1xuY29uc3QgTk9fR0FQUzogcmVhZG9ubHkgTG9nR2FwW10gPSBPYmplY3QuZnJlZXplKFtdKTtcblxuLyoqXG4gKiBSZWFkIGFuIHVudmFsaWRhdGVkIGFycmF5IGFzIGEgY29tbWl0IGxvZy5cbiAqXG4gKiBUaGUgY2xlYW4gY2FzZSAoYSBsaXZlIHNuYXBzaG90LCBvciBhIHN0b3JlZCByZWNvcmRpbmcgdGhhdCByb3VuZC10cmlwcGVkXG4gKiBpbnRhY3QpIHJldHVybnMgdGhlIFNBTUUgYXJyYXkgcmVmZXJlbmNlIGFuZCBubyBnYXBzOiBub3RoaW5nIGlzIGNvcGllZCxcbiAqIG5vdGhpbmcgaXMgYWxsb2NhdGVkLCBhbmQgdGhlIGZvbGQgYmVoYXZlcyBieXRlIGZvciBieXRlIGFzIGl0IGRpZCBpblxuICogOS4xNy4wLiBPbmx5IGEgbG9nIHdpdGggYSByZWZ1c2VkIHJvdyBpcyByZWJ1aWx0LCBhbmQgb25seSB0byBrZWVwIHRoZVxuICogaW5kaWNlcyBhbGlnbmVkLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCB7IGxvZywgZ2FwcyB9ID0gcmVhZExvZyhKU09OLnBhcnNlKHN0b3JlZCkuY29tbWl0TG9nKTtcbiAqIGdhcHM7IC8vIFt7IGluZGV4OiAzLCByZWFzb246ICdub3QgYW4gb2JqZWN0IChudWxsKScgfV1cbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVhZExvZyhyYXc6IHJlYWRvbmx5IHVua25vd25bXSB8IHVuZGVmaW5lZCk6IFJlYWRMb2cge1xuICBpZiAoIXJhdyB8fCByYXcubGVuZ3RoID09PSAwKSByZXR1cm4geyBsb2c6IFtdLCBnYXBzOiBOT19HQVBTIH07XG5cbiAgbGV0IGdhcHM6IExvZ0dhcFtdIHwgdW5kZWZpbmVkO1xuICBmb3IgKGxldCBpID0gMDsgaSA8IHJhdy5sZW5ndGg7IGkrKykge1xuICAgIGNvbnN0IHJlYXNvbiA9IGJ1bmRsZVJlZnVzYWwocmF3W2ldKTtcbiAgICBpZiAocmVhc29uICE9PSB1bmRlZmluZWQpIChnYXBzID8/PSBbXSkucHVzaCh7IGluZGV4OiBpLCByZWFzb24gfSk7XG4gIH1cbiAgaWYgKCFnYXBzKSByZXR1cm4geyBsb2c6IHJhdyBhcyByZWFkb25seSBDb21taXRCdW5kbGVbXSwgZ2FwczogTk9fR0FQUyB9O1xuXG4gIGNvbnN0IGxvZyA9IHJhdy5tYXAoKHJvdykgPT4gKGlzQ29tbWl0QnVuZGxlKHJvdykgPyByb3cgOiBHQVBfQlVORExFKSk7XG4gIHJldHVybiB7IGxvZywgZ2FwczogT2JqZWN0LmZyZWV6ZShnYXBzKSB9O1xufVxuIl19
142
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVuZGxlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvdGltZS10cmF2ZWwvYnVuZGxlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7OztBQUtIOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sVUFBVSxHQUFpQixNQUFNLENBQUMsTUFBTSxDQUFDO0lBQzdDLEtBQUssRUFBRSxFQUFFO0lBQ1QsT0FBTyxFQUFFLEVBQUU7SUFDWCxjQUFjLEVBQUUsRUFBRTtJQUNsQixLQUFLLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQXFDO0lBQzVELGFBQWEsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBd0I7SUFDdkQsU0FBUyxFQUFFLE1BQU0sQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO0lBQzVCLE9BQU8sRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztDQUMzQixDQUFDLENBQUM7QUFFSCxnRUFBZ0U7QUFDaEUsU0FBZ0IsVUFBVSxDQUFDLEtBQWM7SUFDdkMsT0FBTyxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksS0FBSyxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUM7QUFDOUUsQ0FBQztBQUZELGdDQUVDO0FBRUQ7Ozs7Ozs7O0dBUUc7QUFDSCxTQUFnQixRQUFRLENBQUMsS0FBYztJQUNyQyxPQUFPLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUUsS0FBa0MsQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQzdFLENBQUM7QUFGRCw0QkFFQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBbUJHO0FBQ0gsU0FBZ0IsYUFBYSxDQUFDLEdBQVk7SUFDeEMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQ3JCLE9BQU8sa0JBQWtCLEdBQUcs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LEtBQUssU0FBUztZQUFFLENBQUMsSUFBSSxLQUFLLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxFQUFFLEtBQUssRUFBRSxDQUFDLEVBQUUsTUFBTSxFQUFFLENBQUMsQ0FBQztJQUNyRSxDQUFDO0lBQ0QsSUFBSSxDQUFDLElBQUk7UUFBRSxPQUFPLEVBQUUsR0FBRyxFQUFFLEdBQThCLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxDQUFDO0lBRXpFLE1BQU0sR0FBRyxHQUFHLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLENBQUMsY0FBYyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUM7SUFDdkUsT0FBTyxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO0FBQzVDLENBQUM7QUFaRCwwQkFZQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogYnVuZGxlcy50cyDigJQgcmVhZGluZyBhIGxvZyB3aG9zZSByb3dzIGFyZSBub3QgdHlwZWQgeWV0LlxuICpcbiAqIFdIWSBUSElTIEZJTEUgRVhJU1RTLiBBIExJVkUgc25hcHNob3QgaGFuZHMgdGltZSB0cmF2ZWwgcmVhbFxuICoge0BsaW5rIENvbW1pdEJ1bmRsZX1zLiBBIFNUT1JFRCByZWNvcmRpbmcgaGFuZHMgaXQgcGFyc2VkIEpTT04sIGFuZCBhXG4gKiBjYXJlZnVsIGNvbnN1bWVyIHdpbGwgbm90IGNsYWltIHRoYXQgd2hhdCBjYW1lIGJhY2sgb2ZmIGRpc2sgaXMgYVxuICogYENvbW1pdEJ1bmRsZWAg4oCUIHNvIGl0IGVpdGhlciBjYXN0cyAoYSBsaWUgd2l0aCBhIGNvbW1lbnQgb24gaXQpIG9yIGNhbm5vdFxuICogY2FsbCB0aGUgbGlicmFyeSBhdCBhbGwuIFNpbmNlIDkuMTguMCB0aGUgc291cmNlIHRha2VzIGByZWFkb25seSB1bmtub3duW11gXG4gKiBhbmQgdGhlIG5hcnJvd2luZyBoYXBwZW5zIGhlcmUsIHBlciByb3csIGF0IHRoZSBvbmUgcGxhY2UgdGhhdCBhY3R1YWxseVxuICogcmVhZHMgb25lLlxuICpcbiAqIEEgcm93IHRoYXQgaXMgbm90IGEgYnVuZGxlIGJlY29tZXMgYSBHQVAgcmF0aGVyIHRoYW4gYW4gZXhjZXB0aW9uOiBpdCBLRUVQU1xuICogSVRTIElOREVYIOKAlCBzbyBldmVyeSBgY29tbWl0SWR4YCBpbiB0aGUgYXhpcyBzdGlsbCBhZGRyZXNzZXMgdGhlIHNhbWVcbiAqIHBvc2l0aW9uIOKAlCBjb250cmlidXRlcyBubyBzdGF0ZSwgZ2V0cyBubyBzdG9wLCBhbmQgaXMgcmVwb3J0ZWQgd2l0aCBpdHNcbiAqIGluZGV4IGFuZCBhIHJlYXNvbi4gT25lIGNvcnJ1cHQgcm93IGluIGEgc3RvcmVkIHJlY29yZGluZyBsb3NlcyB0aGF0IHJvdyxcbiAqIG5vdCB0aGUgcmVjb3JkaW5nLlxuICovXG5cbmltcG9ydCB0eXBlIHsgQ29tbWl0QnVuZGxlLCBTdGFnZVNuYXBzaG90IH0gZnJvbSAnLi4vbWVtb3J5L3R5cGVzLmpzJztcbmltcG9ydCB0eXBlIHsgTG9nR2FwIH0gZnJvbSAnLi90eXBlcy5qcyc7XG5cbi8qKlxuICogVGhlIHN0YW5kLWluIGEgZ2FwIGxlYXZlcyBhdCBpdHMgaW5kZXg6IGEgY29tbWl0IHRoYXQgYmVsb25ncyB0byBubyBzdGFnZVxuICogYW5kIGNhcnJpZXMgbm90aGluZy5cbiAqXG4gKiBJdCBpcyBOT1QgaW52ZW50ZWQgZXZpZGVuY2Ug4oCUIGV2ZXJ5IGZpZWxkIGlzIHRoZSBlbXB0eSB2YWx1ZSwgYW5kIGFuIGlkLWxlc3NcbiAqIGJ1bmRsZSBpcyBhIHNoYXBlIHRoZSBsb2cgYWxyZWFkeSBoYXMgKGEgcm9vdC1jb250ZXh0IGNvbW1pdCBtYWRlIGJlZm9yZSBhbnlcbiAqIHN0YWdlIHJhbikuIGBjb21taXRTdG9wc2AgZ2l2ZXMgaXQgbm8gc3RvcCBmb3IgZXhhY3RseSB0aGF0IHJlYXNvbiwgdGhlIGZvbGRcbiAqIGZvbGRzIG5vdGhpbmcgZnJvbSBpdCwgYW5kIGBjaGFuZ2VkU2luY2VgIHJlYWRzIG5vIGtleXMgb2ZmIGl0LiBXaGF0IGl0IGRvZXNcbiAqIGlzIGhvbGQgdGhlIGluZGV4LCBzbyB0aGUgYXJpdGhtZXRpYyBkb3duc3RyZWFtIG5ldmVyIGhhcyB0byBrbm93LlxuICovXG5jb25zdCBHQVBfQlVORExFOiBDb21taXRCdW5kbGUgPSBPYmplY3QuZnJlZXplKHtcbiAgc3RhZ2U6ICcnLFxuICBzdGFnZUlkOiAnJyxcbiAgcnVudGltZVN0YWdlSWQ6ICcnLFxuICB0cmFjZTogT2JqZWN0LmZyZWV6ZShbXSkgYXMgdW5rbm93biBhcyBDb21taXRCdW5kbGVbJ3RyYWNlJ10sXG4gIHJlZGFjdGVkUGF0aHM6IE9iamVjdC5mcmVlemUoW10pIGFzIHVua25vd24gYXMgc3RyaW5nW10sXG4gIG92ZXJ3cml0ZTogT2JqZWN0LmZyZWV6ZSh7fSksXG4gIHVwZGF0ZXM6IE9iamVjdC5mcmVlemUoe30pLFxufSk7XG5cbi8qKiBBIHBsYWluIG9iamVjdCDigJQgbm90IG51bGwsIG5vdCBhbiBhcnJheSwgbm90IGEgcHJpbWl0aXZlLiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzUGxhaW5pc2godmFsdWU6IHVua25vd24pOiB2YWx1ZSBpcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPiB7XG4gIHJldHVybiB0eXBlb2YgdmFsdWUgPT09ICdvYmplY3QnICYmIHZhbHVlICE9PSBudWxsICYmICFBcnJheS5pc0FycmF5KHZhbHVlKTtcbn1cblxuLyoqXG4gKiBSZWFkIGEgc291cmNlJ3MgYGV4ZWN1dGlvblRyZWVgIGFzIGEge0BsaW5rIFN0YWdlU25hcHNob3R9LCBvciBhcyBhYnNlbnQuXG4gKlxuICogVGhlIHRyZWUgaXMgb25seSBldmVyIFdBTEtFRCBmb3IgbW91bnQgaWRzIChgc3ViZmxvd0lkYCArIGBydW50aW1lU3RhZ2VJZGBcbiAqIG9uIGVhY2ggbm9kZSksIHNvIHRoZSBob25lc3QgbmFycm93aW5nIGEgcmVhZGVyIGNhbiBkbyBpcyBcImEgcGxhaW4gb2JqZWN0XCI7XG4gKiBhbnl0aGluZyBlbHNlIOKAlCBhIHN0b3JlZCBmaWVsZCB0aGF0IGNhbWUgYmFjayBhcyBhIHN0cmluZywgYSBudW1iZXIsIGFuXG4gKiBhcnJheSDigJQgaXMgcmVhZCBhcyBubyB0cmVlIGF0IGFsbCwgd2hpY2ggc2VuZHMgYGNvbW1pdFN0b3BzYCBkb3duIHRoZSBzYW1lXG4gKiBzaGFwZS1oZXVyaXN0aWMgcGF0aCBhIGxvZyBoYW5kZWQgb3ZlciB3aXRob3V0IGl0cyB0cmVlIGFscmVhZHkgdGFrZXMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiByZWFkVHJlZSh2YWx1ZTogdW5rbm93bik6IFN0YWdlU25hcHNob3QgfCB1bmRlZmluZWQge1xuICByZXR1cm4gaXNQbGFpbmlzaCh2YWx1ZSkgPyAodmFsdWUgYXMgdW5rbm93biBhcyBTdGFnZVNuYXBzaG90KSA6IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBXaHkgYHJvd2AgY2Fubm90IGJlIHJlYWQgYXMgYSBjb21taXQgYnVuZGxlLCBvciBgdW5kZWZpbmVkYCB3aGVuIGl0IGNhbi5cbiAqXG4gKiBERUxJQkVSQVRFTFkgTEVOSUVOVCDigJQgYnV0IGV4YWN0bHkgYXMgbGVuaWVudCBhcyB0aGUgcmVhZGVycyBhcmUuIEl0IGNoZWNrc1xuICogd2hhdCB0aGUgZm9sZCwgdGhlIGF4aXMgYW5kIGBjaGFuZ2VkU2luY2VgIGFjdHVhbGx5IHRvdWNoOlxuICpcbiAqIC0gYHJ1bnRpbWVTdGFnZUlkYCBtdXN0IGJlIGEgc3RyaW5nIOKAlCB0aGUgYXhpcyBrZXlzIG9uIGl0LlxuICogLSBgdHJhY2VgIG11c3QgYmUgYW4gQVJSQVksIGFuZCBpdCBtdXN0IGJlIFBSRVNFTlQuIEl0IGlzIHRoZSBvbmUgZmllbGRcbiAqICAgZXZlcnkgcmVhZGVyIFdBTEtTIChgYXBwbHlTbWFydE1lcmdlYCBpdGVyYXRlcyBpdCB2ZXJiIGJ5IHZlcmI7XG4gKiAgIGBjaGFuZ2VkU2luY2VgIHJlYWRzIGl0cyBwYXRocyksIHNvIGEgcm93IHdpdGhvdXQgb25lIGlzIG5vdCBhIGJ1bmRsZSB0aGVcbiAqICAgZm9sZCBjYW4gc3Vydml2ZSDigJQgaXQgaXMgdGhlIGNyYXNoIGEgZ2FwIGV4aXN0cyB0byBwcmV2ZW50LiBgQ29tbWl0QnVuZGxlYFxuICogICBkZWNsYXJlcyBpdCByZXF1aXJlZCwgc28gbm8gbGl2ZSBsb2cgaXMgYWZmZWN0ZWQuXG4gKiAtIGB1cGRhdGVzYCAvIGBvdmVyd3JpdGVgLCB3aGVuIHByZXNlbnQsIG11c3QgYmUgcGxhaW4gb2JqZWN0cy4gVGhleSBhcmVcbiAqICAgcmVhZCBvbmx5IEFUIFRIRSBQQVRIUyBUSEUgVFJBQ0UgTkFNRVMsIHNvIGFuIGFic2VudCBvbmUgaXMgaGFybWxlc3MgYW5kXG4gKiAgIGlzIHRvbGVyYXRlZCwgZXhhY3RseSBhcyB0aGUgZm9sZCB0b2xlcmF0ZXMgYW4gYWJzZW50IGByZWRhY3RlZFBhdGhzYC5cbiAqXG4gKiBCZWluZyBzdHJpY3RlciB0aGFuIHRoYXQg4oCUIGRlbWFuZGluZyBgc3RhZ2VgLCBgc3RhZ2VJZGAsIGBpZHhgIOKAlCB3b3VsZFxuICogcmVqZWN0IGhhbmQtYnVpbHQgbG9ncyB0aGF0IGhhdmUgZm9sZGVkIGNvcnJlY3RseSBzaW5jZSA5LjE3LjAsIHdoaWNoIGlzIGFcbiAqIGNvbXBhdGliaWxpdHkgYnJlYWsgZHJlc3NlZCB1cCBhcyB2YWxpZGF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gYnVuZGxlUmVmdXNhbChyb3c6IHVua25vd24pOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuICBpZiAoIWlzUGxhaW5pc2gocm93KSkge1xuICAgIHJldHVybiBgbm90IGFuIG9iamVjdCAoJHtyb3cgPT09IG51bGwgPyAnbnVsbCcgOiBBcnJheS5pc0FycmF5KHJvdykgPyAnYXJyYXknIDogdHlwZW9mIHJvd30pYDtcbiAgfVxuICBpZiAodHlwZW9mIHJvdy5ydW50aW1lU3RhZ2VJZCAhPT0gJ3N0cmluZycpIHtcbiAgICByZXR1cm4gYHJ1bnRpbWVTdGFnZUlkIGlzICR7XG4gICAgICByb3cucnVudGltZVN0YWdlSWQgPT09IHVuZGVmaW5lZCA/ICdtaXNzaW5nJyA6IGBhICR7dHlwZW9mIHJvdy5ydW50aW1lU3RhZ2VJZH1gXG4gICAgfSwgbm90IGEgc3RyaW5nYDtcbiAgfVxuICBpZiAoIUFycmF5LmlzQXJyYXkocm93LnRyYWNlKSkge1xuICAgIHJldHVybiBgdHJhY2UgaXMgJHtyb3cudHJhY2UgPT09IHVuZGVmaW5lZCA/ICdtaXNzaW5nJyA6IGBhICR7dHlwZW9mIHJvdy50cmFjZX1gfSwgbm90IGFuIGFycmF5YDtcbiAgfVxuICBpZiAocm93LnVwZGF0ZXMgIT09IHVuZGVmaW5lZCAmJiAhaXNQbGFpbmlzaChyb3cudXBkYXRlcykpIHJldHVybiAndXBkYXRlcyBpcyBub3QgYSBwbGFpbiBvYmplY3QnO1xuICBpZiAocm93Lm92ZXJ3cml0ZSAhPT0gdW5kZWZpbmVkICYmICFpc1BsYWluaXNoKHJvdy5vdmVyd3JpdGUpKSByZXR1cm4gJ292ZXJ3cml0ZSBpcyBub3QgYSBwbGFpbiBvYmplY3QnO1xuICAvLyBUaGUgZm91ciB2ZXJicyBhcmUgdGhlIGNvbnRyYWN0ICg5LjI3LjApLiBUaGUgcmVwbGF5J3Mgc3dpdGNoIHVzZWQgdG9cbiAgLy8gdHJlYXQgYW55dGhpbmcgZWxzZSBhcyBgbWVyZ2VgIOKAlCBhIHNpbGVudCBjb2VyY2lvbiBvZiBhIHJvdyBhIGZvcmVpZ25cbiAgLy8gcHJvZHVjZXIgZ290IHdyb25nLiBBIGJ1bmRsZSB3aXRoIHN1Y2ggYSByb3cgaXMgYSBnYXAsIGFuZCBzYXlzIHdoaWNoLlxuICBmb3IgKGxldCBpID0gMDsgaSA8IHJvdy50cmFjZS5sZW5ndGg7IGkrKykge1xuICAgIGNvbnN0IGVudHJ5OiB1bmtub3duID0gcm93LnRyYWNlW2ldO1xuICAgIGNvbnN0IHZlcmIgPSBpc1BsYWluaXNoKGVudHJ5KSA/IGVudHJ5LnZlcmIgOiB1bmRlZmluZWQ7XG4gICAgaWYgKHZlcmIgIT09ICdzZXQnICYmIHZlcmIgIT09ICdtZXJnZScgJiYgdmVyYiAhPT0gJ2FwcGVuZCcgJiYgdmVyYiAhPT0gJ2RlbGV0ZScpIHtcbiAgICAgIHJldHVybiBgdHJhY2VbJHtpfV0udmVyYiBpcyAke1xuICAgICAgICB2ZXJiID09PSB1bmRlZmluZWQgPyAnbWlzc2luZycgOiBKU09OLnN0cmluZ2lmeSh2ZXJiKVxuICAgICAgfSwgbm90IHNldCB8IG1lcmdlIHwgYXBwZW5kIHwgZGVsZXRlYDtcbiAgICB9XG4gIH1cbiAgcmV0dXJuIHVuZGVmaW5lZDtcbn1cblxuLyoqIGB0cnVlYCB3aGVuIGByb3dgIGNhbiBiZSByZWFkIGFzIGEge0BsaW5rIENvbW1pdEJ1bmRsZX0uICovXG5leHBvcnQgZnVuY3Rpb24gaXNDb21taXRCdW5kbGUocm93OiB1bmtub3duKTogcm93IGlzIENvbW1pdEJ1bmRsZSB7XG4gIHJldHVybiBidW5kbGVSZWZ1c2FsKHJvdykgPT09IHVuZGVmaW5lZDtcbn1cblxuLyoqIEEgbG9nIHJlYWQgcm93IGJ5IHJvdzogdGhlIGJ1bmRsZXMsIGluZGV4LWFsaWduZWQsIHBsdXMgd2hhdCB3YXMgcmVmdXNlZC4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVhZExvZyB7XG4gIC8qKiBTYW1lIGxlbmd0aCBhbmQgb3JkZXIgYXMgdGhlIGlucHV0OyBhIHJlZnVzZWQgcm93IGhvbGRzIGEgR0FQIHN0YW5kLWluLiAqL1xuICByZWFkb25seSBsb2c6IHJlYWRvbmx5IENvbW1pdEJ1bmRsZVtdO1xuICAvKiogVGhlIHJlZnVzZWQgcm93cywgaW4gaW5kZXggb3JkZXIuIEVtcHR5IHdoZW4gdGhlIGxvZyB3YXMgY2xlYW4uICovXG4gIHJlYWRvbmx5IGdhcHM6IHJlYWRvbmx5IExvZ0dhcFtdO1xufVxuXG4vKiogTm90aGluZyB0byByZWFkIOKAlCBzaGFyZWQsIHNvIHRoZSBjbGVhbiBwYXRoIGFsbG9jYXRlcyBub3RoaW5nIGV4dHJhLiAqL1xuY29uc3QgTk9fR0FQUzogcmVhZG9ubHkgTG9nR2FwW10gPSBPYmplY3QuZnJlZXplKFtdKTtcblxuLyoqXG4gKiBSZWFkIGFuIHVudmFsaWRhdGVkIGFycmF5IGFzIGEgY29tbWl0IGxvZy5cbiAqXG4gKiBUaGUgY2xlYW4gY2FzZSAoYSBsaXZlIHNuYXBzaG90LCBvciBhIHN0b3JlZCByZWNvcmRpbmcgdGhhdCByb3VuZC10cmlwcGVkXG4gKiBpbnRhY3QpIHJldHVybnMgdGhlIFNBTUUgYXJyYXkgcmVmZXJlbmNlIGFuZCBubyBnYXBzOiBub3RoaW5nIGlzIGNvcGllZCxcbiAqIG5vdGhpbmcgaXMgYWxsb2NhdGVkLCBhbmQgdGhlIGZvbGQgYmVoYXZlcyBieXRlIGZvciBieXRlIGFzIGl0IGRpZCBpblxuICogOS4xNy4wLiBPbmx5IGEgbG9nIHdpdGggYSByZWZ1c2VkIHJvdyBpcyByZWJ1aWx0LCBhbmQgb25seSB0byBrZWVwIHRoZVxuICogaW5kaWNlcyBhbGlnbmVkLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBjb25zdCB7IGxvZywgZ2FwcyB9ID0gcmVhZExvZyhKU09OLnBhcnNlKHN0b3JlZCkuY29tbWl0TG9nKTtcbiAqIGdhcHM7IC8vIFt7IGluZGV4OiAzLCByZWFzb246ICdub3QgYW4gb2JqZWN0IChudWxsKScgfV1cbiAqIGBgYFxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVhZExvZyhyYXc6IHJlYWRvbmx5IHVua25vd25bXSB8IHVuZGVmaW5lZCk6IFJlYWRMb2cge1xuICBpZiAoIXJhdyB8fCByYXcubGVuZ3RoID09PSAwKSByZXR1cm4geyBsb2c6IFtdLCBnYXBzOiBOT19HQVBTIH07XG5cbiAgbGV0IGdhcHM6IExvZ0dhcFtdIHwgdW5kZWZpbmVkO1xuICBmb3IgKGxldCBpID0gMDsgaSA8IHJhdy5sZW5ndGg7IGkrKykge1xuICAgIGNvbnN0IHJlYXNvbiA9IGJ1bmRsZVJlZnVzYWwocmF3W2ldKTtcbiAgICBpZiAocmVhc29uICE9PSB1bmRlZmluZWQpIChnYXBzID8/PSBbXSkucHVzaCh7IGluZGV4OiBpLCByZWFzb24gfSk7XG4gIH1cbiAgaWYgKCFnYXBzKSByZXR1cm4geyBsb2c6IHJhdyBhcyByZWFkb25seSBDb21taXRCdW5kbGVbXSwgZ2FwczogTk9fR0FQUyB9O1xuXG4gIGNvbnN0IGxvZyA9IHJhdy5tYXAoKHJvdykgPT4gKGlzQ29tbWl0QnVuZGxlKHJvdykgPyByb3cgOiBHQVBfQlVORExFKSk7XG4gIHJldHVybiB7IGxvZywgZ2FwczogT2JqZWN0LmZyZWV6ZShnYXBzKSB9O1xufVxuIl19
@@ -47,8 +47,8 @@ export type { IControlFlowNarrative } from './lib/engine/index.js';
47
47
  export type { CombinedNarrativeEntry, CombinedNarrativeOptions } from './lib/engine/index.js';
48
48
  export type { BranchResult, BranchResults, SerializedPipelineStructure as EngineSerializedPipelineStructure, HandlerDeps, IExecutionRuntime, NodeResultType, RuntimeStructureMetadata, ScopeFactory, SerializedPipelineNode, StageFunction, SubflowResult, TraversalResult, } from './lib/engine/index.js';
49
49
  export { NullControlFlowNarrativeGenerator } from './lib/engine/index.js';
50
- export type { ExecuteNodeFn, RunStageFn } from './lib/engine/index.js';
51
- export { applyOutputMapping, ChildrenExecutor, computeNodeType, ContinuationResolver, createSubflowHandlerDeps, DeciderHandler, DEFAULT_MAX_ITERATIONS, extractParentScopeValues, getInitialScopeValues, NodeResolver, RuntimeStructureManager, seedSubflowGlobalStore, SelectorHandler, StageRunner, SubflowExecutor, } from './lib/engine/index.js';
50
+ export type { ExecuteNodeFn, QueuedPause, ResumeHop, RunStageFn } from './lib/engine/index.js';
51
+ export { applyOutputMapping, ChildrenExecutor, computeNodeType, ContinuationResolver, createSubflowHandlerDeps, DeciderHandler, DEFAULT_MAX_ITERATIONS, extractParentScopeValues, getInitialScopeValues, NodeResolver, ResumeEntry, RuntimeStructureManager, seedSubflowGlobalStore, SelectorHandler, StageRunner, SubflowExecutor, } from './lib/engine/index.js';
52
52
  export type { ExecutionCounter } from './lib/engine/runtimeStageId.js';
53
53
  export { buildRuntimeStageId, createExecutionCounter, parseRuntimeStageId } from './lib/engine/runtimeStageId.js';
54
54
  export { findCommit, findCommits, findLastWriter } from './lib/memory/commitLogUtils.js';
@@ -138,7 +138,7 @@ export { getSubtreeSnapshot, listSubflowPaths } from './lib/runner/index.js';
138
138
  export { CompositeRecorder } from './lib/recorder/index.js';
139
139
  /** @category Pause/Resume */
140
140
  /** @category Pause/Resume */
141
- export type { FlowchartCheckpoint, PausableHandler } from './lib/pause/index.js';
141
+ export type { FlowchartCheckpoint, PausableHandler, PendingPause } from './lib/pause/index.js';
142
142
  /**
143
143
  * @category Pause/Resume
144
144
  *
@@ -621,6 +621,16 @@ export declare class FlowChartBuilder<TOut = any, TScope = any> {
621
621
  private _cursorTail?;
622
622
  private _advanceCursorSpec;
623
623
  _stageMapHas(key: string): boolean;
624
+ /**
625
+ * @internal Register a mounted subflow's definition — first mount wins,
626
+ * at every eager mount site (linear, fork child, decider and selector
627
+ * branch). A SECOND mount under the same id is allowed (existing charts do
628
+ * it) and shares the first one's definition — but a pause inside either
629
+ * cannot be resumed: a checkpoint's `subflowPath` names the subflow id, not
630
+ * the mount, so `resume()` refuses the ambiguous path. Dev mode says so
631
+ * here, at build time, where the id can still be changed.
632
+ */
633
+ _registerSubflowDef(id: string, root: StageNode<TOut, TScope>): void;
624
634
  _addToMap(id: string, fn: StageFunction<TOut, TScope>): void;
625
635
  _mergeStageMap(other: Map<string, StageFunction<TOut, TScope>>, prefix?: string): void;
626
636
  /**
@@ -0,0 +1,195 @@
1
+ /**
2
+ * ResumeEntry — the resume's ONE-SHOT re-entry (M2, pause/resume).
3
+ *
4
+ * A resume has to get back to a stage in the middle of a chart. It does that
5
+ * with a small synthetic structure: a stand-in for the paused stage (the
6
+ * stage's own node with its function swapped for the resume half — or, for an
7
+ * `interrupt()` pause, for its own function with the answer deposited), and,
8
+ * for a pause inside subflows, the checkpoint's capture of each subflow's
9
+ * state on the way down.
10
+ *
11
+ * THE LAW: that structure is used EXACTLY ONCE, for the re-entry. The stand-in
12
+ * is where the resumed traversal STARTS (or where the leaf subflow's traversal
13
+ * starts) — it is never a node any id can resolve to. Each subflow on the pause
14
+ * path takes its seed and its entry point on its FIRST entry and never again.
15
+ * After that the run belongs to the real chart: every loop target, every later
16
+ * subflow entry (real root, inputMapper runs), every re-visit of the paused
17
+ * stage (which pauses again) resolves against the chart as built.
18
+ *
19
+ * ONE RULE AT EVERY LEVEL — what runs after the entry. On the original run,
20
+ * whatever DISPATCHED the paused stage (or the mount of the next subflow on
21
+ * the path) — a decider, a selector, a fork — ran its own continuation once
22
+ * that child's chain ended: the decider's `next`, the fork's join. A resume
23
+ * enters AT the child, so that continuation must be carried: the entry is
24
+ * the child with the enclosing dispatcher's continuation attached at the end
25
+ * of its own chain (`{ ...child, next: dispatcher.next }` for a chart the
26
+ * builder made). It is read from the CHART, level by level — never from the
27
+ * checkpoint, so an edited checkpoint cannot redirect a run — and it lands
28
+ * at the level it belongs to: a top-level decider's `next` runs at the top
29
+ * level, after the subflow's outputMapper, not inside the subflow.
30
+ *
31
+ * PARALLEL SIBLINGS THAT PAUSED TOO (9.28.0). When two children of one
32
+ * fan-out paused, the checkpoint asks the first and carries the others
33
+ * (`FlowchartCheckpoint.pendingPauses`). At that fan-out's level the entry is
34
+ * the child's own chain only — no join — and once it ends, the next sibling's
35
+ * pause is raised again as it was (its question, its captured state), without
36
+ * re-running anything. The join runs only when the last sibling is resumed.
37
+ *
38
+ * Before 9.28.0 the structure stayed in force for the whole resumed run — the
39
+ * traversal was ROOTED at the stand-in (so a loop back to the paused id re-ran
40
+ * the resume half, and a loop target upstream of the resume point was
41
+ * unreachable: one stage ran, then the run ended silently), and the leaf
42
+ * subflow's root was SWAPPED for the stand-in in the subflow dictionary (so a
43
+ * later entry into it would re-run the resume half on a stale seed).
44
+ *
45
+ * @example
46
+ * ```typescript
47
+ * // What FlowChartExecutor.resume() builds for a pause at 'sf-a/sf-b/ask'
48
+ * // (subflowPath ['sf-a', 'sf-a/sf-b']), 'sf-a/sf-b' mounted as a decider
49
+ * // branch inside sf-a whose decider continues to 'sf-a/after':
50
+ * const entry = ResumeEntry.plan({ root, subflows, path, captures, standIn });
51
+ * entry.start; // the top-level mount of 'sf-a'
52
+ * entry.enterSubflow('sf-a'); // { seed: sf-a's capture, entry: { ...mount of 'sf-a/sf-b', next: sf-a/after } }
53
+ * entry.enterSubflow('sf-a/sf-b'); // { seed: sf-b's capture, entry: the stand-in }
54
+ * entry.enterSubflow('sf-a/sf-b'); // undefined — a later entry is an ordinary one
55
+ * ```
56
+ *
57
+ * A pause two (or more) subflows deep therefore re-enters each outer subflow
58
+ * AT the mount of the next one — the outer subflow's stages before that mount
59
+ * do not run again (they did before 9.28.0). The one exception is a degraded
60
+ * checkpoint missing an outer subflow's capture: that subflow re-runs from its
61
+ * root with its inputMapper (its earlier stages recompute what the capture
62
+ * would have held), exactly as 9.27.0 did.
63
+ */
64
+ import type { PendingPause } from '../../pause/types.js';
65
+ import { PauseSignal } from '../../pause/types.js';
66
+ import type { StageNode } from '../graph/StageNode.js';
67
+ /**
68
+ * A parallel sibling's pause, queued at the level of its fan-out: raised
69
+ * again there once the resumed child's chain ends (see {@link raiseQueuedPause}).
70
+ */
71
+ export interface QueuedPause {
72
+ /** The sibling's pause as the checkpoint carries it — its path from the top. */
73
+ readonly pause: PendingPause;
74
+ /** How many subflows deep the fan-out sits (0 = the top level). */
75
+ readonly level: number;
76
+ /** The sibling's paused stage's name, for the `onPause` event. */
77
+ readonly stageName: string;
78
+ }
79
+ /** One subflow boundary on the way back to a paused stage. */
80
+ export interface ResumeHop<TOut = any, TScope = any> {
81
+ /** The path-prefixed subflow id (a `FlowchartCheckpoint.subflowPath` entry). */
82
+ readonly subflowId: string;
83
+ /**
84
+ * The subflow's state at the pause (`checkpoint.subflowStates[subflowId]`).
85
+ * Seeds the nested runtime INSTEAD of the inputMapper's values — the capture
86
+ * already holds the post-input, pre-pause memory (the inputMapper still
87
+ * runs, for the stages' read-only args only). Absent when the checkpoint
88
+ * holds no capture for this subflow; the inputMapper then seeds it, as on
89
+ * any entry.
90
+ */
91
+ readonly seed?: Record<string, unknown>;
92
+ /**
93
+ * Where this subflow's traversal starts on the re-entry: the mount of the
94
+ * next subflow on the path, or — on the last hop — the paused stage's
95
+ * stand-in, each with its dispatcher's continuation attached (see the
96
+ * module doc). Absent: the subflow's own root — a seed-only hop (see
97
+ * {@link ResumeEntry.fromCaptures}), or an outer subflow whose capture the
98
+ * checkpoint lacks.
99
+ */
100
+ readonly entry?: StageNode<TOut, TScope>;
101
+ /**
102
+ * Pauses of parallel siblings whose fan-out sits in THIS subflow, raised in
103
+ * order once `entry`'s chain ends (the first is raised, the rest wait
104
+ * behind it). Absent when no sibling is waiting here.
105
+ */
106
+ readonly pendingPauses?: readonly QueuedPause[];
107
+ }
108
+ export declare class ResumeEntry<TOut = any, TScope = any> {
109
+ /**
110
+ * Where the resumed TOP-LEVEL traversal starts: the stand-in (a top-level
111
+ * pause) or the mount of the first subflow on the path — each with its
112
+ * dispatcher's continuation attached. `undefined` for a seed-only entry —
113
+ * the traversal starts at its root.
114
+ */
115
+ readonly start: StageNode<TOut, TScope> | undefined;
116
+ /** Sibling pauses whose fan-out sits at the TOP level — raised once `start`'s chain ends. */
117
+ readonly startPendingPauses: readonly QueuedPause[] | undefined;
118
+ /**
119
+ * How many stage executions the resumed run makes before the stand-in runs
120
+ * — one per subflow on the path, each entered at its mount — so the
121
+ * executor's `onResume` names the stand-in's own `runtimeStageId`.
122
+ * `undefined` when it cannot be known before the run: an outer subflow
123
+ * missing its capture re-runs from its root.
124
+ */
125
+ readonly stepsBeforeStandIn: number | undefined;
126
+ /** Hops not taken yet, by subflow id. A hop leaves this map when it is taken. */
127
+ private readonly pending;
128
+ private constructor();
129
+ /**
130
+ * Plan the re-entry of a paused chart. Every mount on the path, every
131
+ * dispatcher continuation and every waiting sibling is resolved HERE,
132
+ * against the chart as built, before a single stage runs — so a checkpoint
133
+ * whose path the chart cannot walk is refused up front instead of resuming
134
+ * into the wrong shape.
135
+ *
136
+ * @param args - `root` and `subflows`: the chart as built
137
+ * (`FlowChart.root`, `FlowChart.subflows`); `path`:
138
+ * `checkpoint.subflowPath`, outermost first; `captures`:
139
+ * `checkpoint.subflowStates` (a detached copy); `standIn`: the node that
140
+ * runs the resume half — the paused stage's own node, function swapped
141
+ * (its continuation is attached here); `pendingPauses`:
142
+ * `checkpoint.pendingPauses` (a detached copy).
143
+ * @throws when a subflow on the path is missing, mounted more than once, or
144
+ * its mount cannot be reached from the enclosing graph; or when a pending
145
+ * pause is malformed or is not a parallel sibling of the paused stage
146
+ */
147
+ static plan<TOut, TScope>(args: {
148
+ root: StageNode<TOut, TScope>;
149
+ subflows: Record<string, {
150
+ root: StageNode<TOut, TScope>;
151
+ }> | undefined;
152
+ path: readonly string[];
153
+ captures: Record<string, Record<string, unknown>> | undefined;
154
+ standIn: StageNode<TOut, TScope>;
155
+ pendingPauses?: readonly PendingPause[];
156
+ }): ResumeEntry<TOut, TScope>;
157
+ /**
158
+ * A seed-only entry: each capture seeds the FIRST entry into its subflow,
159
+ * which then starts at its own root. What the deprecated
160
+ * `subflowStatesForResume` option (TraverserOptions / HandlerDeps) means
161
+ * since 9.28.0 — the same one-shot law, without a stand-in or a path.
162
+ */
163
+ static fromCaptures<TOut, TScope>(captures: Record<string, Record<string, unknown>>): ResumeEntry<TOut, TScope>;
164
+ /**
165
+ * The re-entry into `subflowId`, taken — or `undefined` when this entry is
166
+ * an ordinary one (the subflow is off the pause path, or its hop was already
167
+ * taken). ONE-SHOT: a hop is returned at most once, so a second entry into
168
+ * the same subflow (a loop passing its mount again) runs the real subflow
169
+ * from its real root with its inputMapper.
170
+ */
171
+ enterSubflow(subflowId: string): ResumeHop<TOut, TScope> | undefined;
172
+ /** `true` once every hop has been taken — the rest of the run is ordinary. */
173
+ get spent(): boolean;
174
+ }
175
+ /**
176
+ * Queue `queue` behind a pause passing through its level: a pause raised
177
+ * while siblings still wait must carry them to its checkpoint. Each path is
178
+ * cut to that level — the bubble-up prepends the levels above.
179
+ */
180
+ export declare function queueBehind(signal: PauseSignal, queue: readonly QueuedPause[]): void;
181
+ /**
182
+ * The first waiting sibling's pause, raised again at its fan-out's level —
183
+ * exactly as it bubbled up to that level the first time (its stage, its
184
+ * question, its own subflow captures), nothing re-run; the rest of the queue
185
+ * waits behind it. The subflows ABOVE the fan-out capture themselves afresh
186
+ * as it bubbles up, so they carry what the resumed child wrote.
187
+ */
188
+ export declare function raiseQueuedPause(queue: readonly QueuedPause[]): PauseSignal;
189
+ /**
190
+ * The node that mounts `subflowId`, found by DFS from `start` over `next` and
191
+ * `children` (loop-ref stubs skipped — they share their target's id and carry
192
+ * nothing). Cycle-safe (visited by identity, so an absent id terminates too);
193
+ * first match in DFS pre-order (children before `next`, like the builder).
194
+ */
195
+ export declare function findMount<TOut, TScope>(start: StageNode<TOut, TScope>, subflowId: string): StageNode<TOut, TScope> | undefined;
@@ -20,6 +20,12 @@ import type { BreakFlag } from './types.js';
20
20
  export declare class SubflowExecutor<TOut = any, TScope = any> {
21
21
  private deps;
22
22
  private traverserFactory;
23
+ /**
24
+ * The resume's one-shot re-entry (`deps.resume`), or a seed-only one built
25
+ * from the deprecated `deps.subflowStatesForResume`. Undefined on a normal
26
+ * run. Asked once per subflow entry — see {@link ResumeEntry}.
27
+ */
28
+ private readonly resume;
23
29
  constructor(deps: HandlerDeps<TOut, TScope>, traverserFactory: SubflowTraverserFactory<TOut, TScope>);
24
30
  /**
25
31
  * Execute a subflow with isolated context.
@@ -9,5 +9,7 @@ export { DeciderHandler } from './DeciderHandler.js';
9
9
  export { SelectorHandler } from './SelectorHandler.js';
10
10
  export { ContinuationResolver, DEFAULT_MAX_ITERATIONS } from './ContinuationResolver.js';
11
11
  export { SubflowExecutor } from './SubflowExecutor.js';
12
+ export type { QueuedPause, ResumeHop } from './ResumeEntry.js';
13
+ export { ResumeEntry } from './ResumeEntry.js';
12
14
  export { applyOutputMapping, createSubflowHandlerDeps, extractParentScopeValues, getInitialScopeValues, seedSubflowGlobalStore, } from './SubflowInputMapper.js';
13
15
  export { computeNodeType, RuntimeStructureManager } from './RuntimeStructureManager.js';
@@ -155,7 +155,7 @@ export declare class CombinedNarrativeRecorder implements CombinedRecorder {
155
155
  description: string;
156
156
  preferredOperation: "translate";
157
157
  data: {
158
- type: "subflow" | "loop" | "error" | "fork" | "selector" | "stage" | "step" | "condition" | "break" | "pause" | "resume" | "emit" | "retry";
158
+ type: "subflow" | "loop" | "error" | "pause" | "fork" | "selector" | "stage" | "step" | "condition" | "break" | "resume" | "emit" | "retry";
159
159
  text: string;
160
160
  depth: number;
161
161
  stageName?: string | undefined;
@@ -23,11 +23,34 @@
23
23
  * Patch model: Stage writes into local patch; commitPatch() after return or throw.
24
24
  */
25
25
  import type { ScopeProtectionMode } from '../../scope/protection/types.js';
26
+ import type { QueuedPause } from '../handlers/ResumeEntry.js';
27
+ import { ResumeEntry } from '../handlers/ResumeEntry.js';
26
28
  import { FlowRecorderDispatcher } from '../narrative/FlowRecorderDispatcher.js';
27
29
  import type { FlowRecorder, IControlFlowNarrative } from '../narrative/types.js';
28
30
  import type { IExecutionRuntime, ILogger, ScopeFactory, Selector, SerializedPipelineStructure, StageFunction, StageNode, StreamHandlers, SubflowMountOptions, SubflowResult, TraversalResult } from '../types.js';
29
31
  export interface TraverserOptions<TOut = any, TScope = any> {
32
+ /**
33
+ * The graph this traverser walks — and the graph every id resolves against
34
+ * (the node map behind every `loopTo`, the DFS fallback). `execute()`
35
+ * starts here unless `entry` says otherwise.
36
+ */
30
37
  root: StageNode<TOut, TScope>;
38
+ /**
39
+ * Where `execute()` starts when not at `root` — a resume's one-shot
40
+ * re-entry (M2): the paused stage's stand-in, or the mount of the first
41
+ * subflow on the pause path, each with its dispatcher's continuation
42
+ * attached. Visited once, first, and never registered anywhere an id can
43
+ * reach it, so a loop back to the paused stage finds the REAL stage.
44
+ * Consumed by the first `execute()`.
45
+ */
46
+ entry?: StageNode<TOut, TScope>;
47
+ /**
48
+ * Parallel siblings' pauses waiting at this level (a resume, 9.28.0): once
49
+ * `entry`'s chain ends, `execute()` raises the first again (the rest wait
50
+ * behind it); a pause raised from inside the chain carries them all. Only
51
+ * with `entry`; consumed by the first `execute()`. See `ResumeEntry`.
52
+ */
53
+ pendingPauses?: readonly QueuedPause[];
31
54
  stageMap: Map<string, StageFunction<TOut, TScope>>;
32
55
  scopeFactory: ScopeFactory<TScope>;
33
56
  executionRuntime: IExecutionRuntime;
@@ -90,10 +113,17 @@ export interface TraverserOptions<TOut = any, TScope = any> {
90
113
  */
91
114
  visitCounts?: Map<string, number>;
92
115
  /**
93
- * Per-subflow scope captures from a checkpoint, on the resume path.
94
- * Forwarded to `HandlerDeps.subflowStatesForResume` so SubflowExecutor
95
- * can re-seed nested runtimes from pre-pause state instead of running
96
- * the inputMapper. Undefined on normal `run()` paths.
116
+ * The resume's one-shot re-entry (M2), shared by reference with every
117
+ * nested traverser (the execution counter's precedent): each subflow on the
118
+ * pause path takes its captured state and its entry point exactly once, on
119
+ * its first entry. See `ResumeEntry`. Undefined on normal `run()` paths.
120
+ */
121
+ resume?: ResumeEntry<TOut, TScope>;
122
+ /**
123
+ * @deprecated since 9.28.0 — pass {@link resume}. Still honoured, under the
124
+ * same one-shot law: each capture seeds only the FIRST entry into its
125
+ * subflow (in place of the inputMapper's values); later entries are
126
+ * ordinary. Ignored when `resume` is set.
97
127
  */
98
128
  subflowStatesForResume?: Record<string, Record<string, unknown>>;
99
129
  /**
@@ -138,6 +168,12 @@ export interface DynamicNodePatch<TOut = any, TScope = any> {
138
168
  }
139
169
  export declare class FlowchartTraverser<TOut = any, TScope = any> {
140
170
  private readonly root;
171
+ /** Where the next `execute()` starts when not at `root` — one-shot (see TraverserOptions.entry). */
172
+ private entry;
173
+ /** Siblings' pauses raised once `entry`'s chain ends — one-shot (see TraverserOptions.pendingPauses). */
174
+ private entryPendingPauses;
175
+ /** The resume's one-shot re-entry, shared with nested traversers. Undefined on a normal run. */
176
+ private readonly resume;
141
177
  private stageMap;
142
178
  private readonly executionRuntime;
143
179
  private subflows;
@@ -269,6 +305,15 @@ export declare class FlowchartTraverser<TOut = any, TScope = any> {
269
305
  */
270
306
  private _topBreakFlag;
271
307
  execute(branchPath?: string): Promise<TraversalResult>;
308
+ /**
309
+ * A resume's entry chain at a level where parallel siblings' pauses wait
310
+ * (9.28.0): run the chain — the resumed child only, the fan-out's join is
311
+ * NOT attached — then raise the first waiting pause again, the rest behind
312
+ * it. Nothing of the sibling re-runs; its question comes back as it was
313
+ * asked. A pause raised from inside the chain (the resumed child asking
314
+ * again) carries every waiting sibling instead, so none is ever dropped.
315
+ */
316
+ private walkThenRaise;
272
317
  /**
273
318
  * Break state captured at the top-level of the most recent `execute()`.
274
319
  * `shouldBreak` is true when a stage called `scope.$break(reason)`; the
@@ -9,6 +9,7 @@ import type { StageContext } from '../memory/StageContext.js';
9
9
  import type { FlowControlType, FlowMessage } from '../memory/types.js';
10
10
  import type { ScopeProtectionMode } from '../scope/protection/types.js';
11
11
  import type { StageNode } from './graph/StageNode.js';
12
+ import type { QueuedPause, ResumeEntry } from './handlers/ResumeEntry.js';
12
13
  import type { IControlFlowNarrative } from './narrative/types.js';
13
14
  export type { Decider, Selector, StageNode } from './graph/StageNode.js';
14
15
  export type { FlowchartCheckpoint, PausableHandler, PauseResult } from '../pause/index.js';
@@ -336,8 +337,20 @@ export interface SubflowResult {
336
337
  * so deciders, selectors, loops, lazy subflows, and abort signals all work inside subflows.
337
338
  */
338
339
  export type SubflowTraverserFactory<TOut = any, TScope = any> = (options: {
339
- /** Root node of the subflow (with isSubflowRoot stripped). */
340
+ /** Root node of the subflow (with isSubflowRoot stripped) — the graph every id inside the subflow resolves against. */
340
341
  root: StageNode<TOut, TScope>;
342
+ /**
343
+ * Where the subflow's traversal starts when not at `root` — a resume's
344
+ * one-shot re-entry (`ResumeHop.entry`): the next mount on the pause path,
345
+ * or the paused stage's stand-in, each with its dispatcher's continuation
346
+ * attached. Visited once, first; never resolvable by id.
347
+ */
348
+ entry?: StageNode<TOut, TScope>;
349
+ /**
350
+ * Parallel siblings' pauses waiting in this subflow (`ResumeHop.pendingPauses`,
351
+ * 9.28.0) — raised in order once `entry`'s chain ends.
352
+ */
353
+ pendingPauses?: readonly QueuedPause[];
341
354
  /** Isolated execution runtime for the subflow. */
342
355
  executionRuntime: IExecutionRuntime;
343
356
  /** Mapped input from parent scope (becomes readOnlyContext for stages). */
@@ -467,16 +480,22 @@ export interface HandlerDeps<TOut = any, TScope = any> {
467
480
  logger: ILogger;
468
481
  signal?: AbortSignal;
469
482
  /**
470
- * On resume, the per-subflow scope captures from the checkpoint.
471
- * Keyed by path-prefixed `subflowId` (matches `PauseSignal.subflowPath`).
472
- *
473
- * `SubflowExecutor` consults this on entry: if a key matches the
474
- * current subflow id, the nested runtime is seeded from this state
475
- * and the inputMapper is SKIPPED (the captured state already
476
- * reflects post-input pre-pause memory). This is what makes
477
- * cross-executor resume work for pauses INSIDE a subflow.
478
- *
479
- * Undefined on normal `run()` paths — only the resume path sets it.
483
+ * The resume's one-shot re-entry (M2) — shared by reference with every
484
+ * nested traverser, like the execution counter. `SubflowExecutor` asks it
485
+ * at each subflow entry: the FIRST entry into a subflow on the pause path
486
+ * takes that subflow's captured state (seeding the nested runtime in place
487
+ * of the inputMapper's values — the mapper still runs for the read-only
488
+ * args), its entry point and any sibling pauses waiting there; every later
489
+ * entry is an ordinary one. See `ResumeEntry`. Undefined on normal `run()`
490
+ * paths.
491
+ */
492
+ resume?: ResumeEntry<TOut, TScope>;
493
+ /**
494
+ * @deprecated since 9.28.0 — the engine plans a resume with {@link resume}.
495
+ * Still honoured, under the same one-shot law: each capture (keyed by
496
+ * path-prefixed `subflowId`) seeds only the FIRST entry into its subflow,
497
+ * in place of the inputMapper's values; later entries are ordinary.
498
+ * Ignored when `resume` is set.
480
499
  */
481
500
  subflowStatesForResume?: Record<string, Record<string, unknown>>;
482
501
  }
@@ -1,4 +1,4 @@
1
1
  export type { InterruptPayload } from './interrupt.js';
2
2
  export { interrupt, InterruptSignal, isInterruptSignal, provideInterruptAnswer } from './interrupt.js';
3
- export type { FlowchartCheckpoint, PausableHandler, PauseResult } from './types.js';
3
+ export type { FlowchartCheckpoint, PausableHandler, PauseResult, PendingPause } from './types.js';
4
4
  export { isPauseResult, isPauseSignal, PauseSignal } from './types.js';