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.
- package/AGENTS.md +3 -0
- package/CLAUDE.md +5 -4
- package/README.md +4 -0
- package/dist/advanced.js +3 -2
- package/dist/esm/advanced.d.ts +2 -2
- package/dist/esm/advanced.js +2 -2
- package/dist/esm/index.d.ts +1 -1
- package/dist/esm/index.js +1 -1
- package/dist/esm/lib/builder/FlowChartBuilder.d.ts +10 -0
- package/dist/esm/lib/builder/FlowChartBuilder.js +27 -13
- package/dist/esm/lib/engine/handlers/ChildrenExecutor.js +45 -12
- package/dist/esm/lib/engine/handlers/ResumeEntry.d.ts +195 -0
- package/dist/esm/lib/engine/handlers/ResumeEntry.js +471 -0
- package/dist/esm/lib/engine/handlers/SubflowExecutor.d.ts +6 -0
- package/dist/esm/lib/engine/handlers/SubflowExecutor.js +43 -10
- package/dist/esm/lib/engine/handlers/index.d.ts +2 -0
- package/dist/esm/lib/engine/handlers/index.js +2 -1
- package/dist/esm/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +1 -1
- package/dist/esm/lib/engine/traversal/FlowchartTraverser.d.ts +49 -4
- package/dist/esm/lib/engine/traversal/FlowchartTraverser.js +64 -13
- package/dist/esm/lib/engine/types.d.ts +30 -11
- package/dist/esm/lib/engine/types.js +1 -1
- package/dist/esm/lib/pause/index.d.ts +1 -1
- package/dist/esm/lib/pause/index.js +1 -1
- package/dist/esm/lib/pause/types.d.ts +93 -5
- package/dist/esm/lib/pause/types.js +57 -3
- package/dist/esm/lib/runner/FlowChartExecutor.d.ts +8 -10
- package/dist/esm/lib/runner/FlowChartExecutor.js +153 -181
- package/dist/esm/lib/time-travel/bundles.js +11 -1
- package/dist/index.js +1 -1
- package/dist/lib/builder/FlowChartBuilder.js +27 -13
- package/dist/lib/engine/handlers/ChildrenExecutor.js +45 -12
- package/dist/lib/engine/handlers/ResumeEntry.js +478 -0
- package/dist/lib/engine/handlers/SubflowExecutor.js +43 -10
- package/dist/lib/engine/handlers/index.js +4 -2
- package/dist/lib/engine/traversal/FlowchartTraverser.js +64 -13
- package/dist/lib/engine/types.js +1 -1
- package/dist/lib/pause/index.js +1 -1
- package/dist/lib/pause/types.js +57 -3
- package/dist/lib/runner/FlowChartExecutor.js +153 -181
- package/dist/lib/time-travel/bundles.js +11 -1
- package/dist/types/advanced.d.ts +2 -2
- package/dist/types/index.d.ts +1 -1
- package/dist/types/lib/builder/FlowChartBuilder.d.ts +10 -0
- package/dist/types/lib/engine/handlers/ResumeEntry.d.ts +195 -0
- package/dist/types/lib/engine/handlers/SubflowExecutor.d.ts +6 -0
- package/dist/types/lib/engine/handlers/index.d.ts +2 -0
- package/dist/types/lib/engine/narrative/CombinedNarrativeRecorder.d.ts +1 -1
- package/dist/types/lib/engine/traversal/FlowchartTraverser.d.ts +49 -4
- package/dist/types/lib/engine/types.d.ts +30 -11
- package/dist/types/lib/pause/index.d.ts +1 -1
- package/dist/types/lib/pause/types.d.ts +93 -5
- package/dist/types/lib/runner/FlowChartExecutor.d.ts +8 -10
- 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
|
package/dist/types/advanced.d.ts
CHANGED
|
@@ -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';
|
package/dist/types/index.d.ts
CHANGED
|
@@ -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" | "
|
|
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
|
-
*
|
|
94
|
-
*
|
|
95
|
-
*
|
|
96
|
-
*
|
|
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
|
-
*
|
|
471
|
-
*
|
|
472
|
-
*
|
|
473
|
-
*
|
|
474
|
-
*
|
|
475
|
-
* and
|
|
476
|
-
*
|
|
477
|
-
*
|
|
478
|
-
|
|
479
|
-
|
|
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';
|