footprintjs 0.2.3 → 0.4.0

package/dist/lib/runner/FlowChartExecutor.js

@@ -17,6 +17,7 @@ const ExecutionRuntime_1 = require("./ExecutionRuntime");
 class FlowChartExecutor {
     constructor(flowChart, scopeFactory, defaultValuesForContext, initialContext, readOnlyContext, throttlingErrorChecker, streamHandlers, scopeProtectionMode, enrichSnapshots) {
         this.narrativeEnabled = false;
+        this.flowRecorders = [];
         this.flowChartArgs = {
             flowChart,
             scopeFactory,
@@ -70,11 +71,30 @@ class FlowChartExecutor {
             buildTimeStructure: fc.buildTimeStructure,
             logger: (_c = fc.logger) !== null && _c !== void 0 ? _c : types_1.defaultLogger,
             signal,
+            flowRecorders: this.flowRecorders.length > 0 ? this.flowRecorders : undefined,
         });
     }
     enableNarrative() {
         this.narrativeEnabled = true;
     }
+    // ─── FlowRecorder Management ───
+    /**
+     * Attach a FlowRecorder to observe control flow events.
+     * Automatically enables narrative if not already enabled.
+     * Must be called before run() — recorders are passed to the traverser at creation time.
+     */
+    attachFlowRecorder(recorder) {
+        this.flowRecorders.push(recorder);
+        this.narrativeEnabled = true;
+    }
+    /** Detach all FlowRecorders with the given ID. */
+    detachFlowRecorder(id) {
+        this.flowRecorders = this.flowRecorders.filter((r) => r.id !== id);
+    }
+    /** Returns a defensive copy of attached FlowRecorders. */
+    getFlowRecorders() {
+        return [...this.flowRecorders];
+    }
     /**
      * Returns the execution narrative.
      *
@@ -159,4 +179,4 @@ class FlowChartExecutor {
     }
 }
 exports.FlowChartExecutor = FlowChartExecutor;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRmxvd0NoYXJ0RXhlY3V0b3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL3J1bm5lci9GbG93Q2hhcnRFeGVjdXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7R0FPRzs7O0FBR0gsMkZBQXdGO0FBQ3hGLCtFQUE0RTtBQUM1RSwyQ0FXeUI7QUFFekIsNEVBQXlFO0FBQ3pFLHlEQUFzRDtBQUV0RCxNQUFhLGlCQUFpQjtJQWlCNUIsWUFDRSxTQUFrQyxFQUNsQyxZQUFrQyxFQUNsQyx1QkFBaUMsRUFDakMsY0FBd0IsRUFDeEIsZUFBeUIsRUFDekIsc0JBQW9ELEVBQ3BELGNBQStCLEVBQy9CLG1CQUF5QyxFQUN6QyxlQUF5QjtRQXhCbkIscUJBQWdCLEdBQUcsS0FBSyxDQUFDO1FBMEIvQixJQUFJLENBQUMsYUFBYSxHQUFHO1lBQ25CLFNBQVM7WUFDVCxZQUFZO1lBQ1osdUJBQXVCO1lBQ3ZCLGNBQWM7WUFDZCxlQUFlO1lBQ2Ysc0JBQXNCO1lBQ3RCLGNBQWM7WUFDZCxtQkFBbUI7WUFDbkIsZUFBZTtTQUNoQixDQUFDO1FBQ0YsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsZUFBZSxFQUFFLENBQUM7SUFDMUMsQ0FBQztJQUVPLGVBQWUsQ0FBQyxNQUFvQjs7UUFDMUMsTUFBTSxJQUFJLEdBQUcsSUFBSSxDQUFDLGFBQWEsQ0FBQztRQUNoQyxNQUFNLEVBQUUsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDO1FBQzFCLE1BQU0sYUFBYSxHQUFHLElBQUksQ0FBQyxnQkFBZ0IsSUFBSSxDQUFDLE1BQUEsRUFBRSxDQUFDLGVBQWUsbUNBQUksS0FBSyxDQUFDLENBQUM7UUFFN0UsMEVBQTBFO1FBQzFFLG1FQUFtRTtRQUNuRSxJQUFJLFlBQVksR0FBRyxJQUFJLENBQUMsWUFBWSxDQUFDO1FBQ3JDLElBQUksYUFBYSxFQUFFLENBQUM7WUFDbEIsSUFBSSxDQUFDLGlCQUFpQixHQUFH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QUMsSUFBYyxFQUFFLEdBQVcsRUFBRSxLQUFjO1FBQ3ZELElBQUksQ0FBQyxTQUFTLENBQUMsYUFBYSxDQUFDLElBQUksRUFBRSxHQUFHLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDakQsQ0FBQztJQUVELFlBQVk7UUFDVixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsWUFBWSxFQUFFLENBQUM7SUFDdkMsQ0FBQztJQUVELGNBQWM7UUFDWixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsY0FBYyxFQUFFLENBQUM7SUFDekMsQ0FBQztJQUVELG1CQUFtQjtRQUNqQixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsbUJBQW1CLEVBQUUsQ0FBQztJQUM5QyxDQUFDO0lBRUQsaUJBQWlCO1FBQ2YsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLGlCQUFpQixFQUFFLENBQUM7SUFDNUMsQ0FBQztJQUVELG1CQUFtQjtRQUNqQixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsbUJBQW1CLEVBQVcsQ0FBQztJQUN2RCxDQUFDO0lBRUQsa0JBQWtCO1FBQ2hCLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxtQkFBbUIsRUFBVyxDQUFDO0lBQ3ZELENBQUM7SUFFRCxrQkFBa0I7UUFDaEIsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLGtCQUFrQixFQUFFLENBQUM7SUFDN0MsQ0FBQztDQUNGO0FBN0xELDhDQTZMQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRmxvd0NoYXJ0RXhlY3V0b3Ig4oCUIFB1YmxpYyBBUEkgZm9yIGV4ZWN1dGluZyBhIGNvbXBpbGVkIEZsb3dDaGFydC5cbiAqXG4gKiBXcmFwcyBGbG93Y2hhcnRUcmF2ZXJzZXIuIFBhaXJzIHdpdGggRmxvd0NoYXJ0QnVpbGRlcjpcbiAqICAgY29uc3QgY2hhcnQgPSBmbG93Q2hhcnQoJ2VudHJ5JywgZW50cnlGbikuYWRkRnVuY3Rpb24oJ3Byb2Nlc3MnLCBwcm9jZXNzRm4pLmJ1aWxkKCk7XG4gKiAgIGNvbnN0IGV4ZWN1dG9yID0gbmV3IEZsb3dDaGFydEV4ZWN1dG9yKGNoYXJ0LCBzY29wZUZhY3RvcnkpO1xuICogICBjb25zdCByZXN1bHQgPSBhd2FpdCBleGVjdXRvci5ydW4oKTtcbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENvbWJpbmVkTmFycmF0aXZlRW50cnkgfSBmcm9tICcuLi9lbmdpbmUvbmFycmF0aXZlL0NvbWJpbmVkTmFycmF0aXZlQnVpbGRlcic7XG5pbXBvcnQgeyBDb21iaW5lZE5hcnJhdGl2ZUJ1aWxkZXIgfSBmcm9tICcuLi9lbmdpbmUvbmFycmF0aXZlL0NvbWJpbmVkTmFycmF0aXZlQnVpbGRlcic7XG5pbXBvcnQgeyBGbG93Y2hhcnRUcmF2ZXJzZXIgfSBmcm9tICcuLi9lbmdpbmUvdHJhdmVyc2FsL0Zsb3djaGFydFRyYXZlcnNlcic7XG5pbXBvcnQge1xuICB0eXBlIEV4dHJhY3RvckVycm9yLFxuICB0eXBlIEZsb3dDaGFydCxcbiAgdHlwZSBSdW5PcHRpb25zLFxuICB0eXBlIFNjb3BlRmFjdG9yeSxcbiAgdHlwZSBTZXJpYWxpemVkUGlwZWxpbmVTdHJ1Y3R1cmUsXG4gIHR5cGUgU3RhZ2VOb2RlLFxuICB0eXBlIFN0cmVhbUhhbmRsZXJzLFxuICB0eXBlIFN1YmZsb3dSZXN1bHQsXG4gIHR5cGUgVHJhdmVyc2FsUmVzdWx0LFxuICBkZWZhdWx0TG9nZ2VyLFxufSBmcm9tICcuLi9lbmdpbmUvdHlwZXMnO1xuaW1wb3J0IHR5cGUgeyBTY29wZVByb3RlY3Rpb25Nb2RlIH0gZnJvbSAnLi4vc2NvcGUvcHJvdGVjdGlvbi90eXBlcyc7XG5pbXBvcnQgeyBOYXJyYXRpdmVSZWNvcmRlciB9IGZyb20gJy4uL3Njb3BlL3JlY29yZGVycy9OYXJyYXRpdmVSZWNvcmRlcic7XG5pbXBvcnQgeyBFeGVjdXRpb25SdW50aW1lIH0gZnJvbSAnLi9FeGVjdXRpb25SdW50aW1lJztcblxuZXhwb3J0IGNsYXNzIEZsb3dDaGFydEV4ZWN1dG9yPFRPdXQgPSBhbnksIFRTY29wZSA9IGFueT4ge1xuICBwcml2YXRlIHRyYXZlcnNlcjogRmxvd2NoYXJ0VHJhdmVyc2VyPFRPdXQsIFRTY29wZT47XG4gIHByaXZhdGUgbmFycmF0aXZlRW5hYmxlZCA9IGZhbHNlO1xuICBwcml2YXRlIG5hcnJhdGl2ZVJlY29yZGVyOiBOYXJyYXRpdmVSZWNvcmRlciB8IHVuZGVmaW5lZDtcblxuICBwcml2YXRlIHJlYWRvbmx5IGZsb3dDaGFydEFyZ3M6IHtcbiAgICBmbG93Q2hhcnQ6IEZsb3dDaGFydDxUT3V0LCBUU2NvcGU+O1xuICAgIHNjb3BlRmFjdG9yeTogU2NvcGVGYWN0b3J5PFRTY29wZT47XG4gICAgZGVmYXVsdFZhbHVlc0ZvckNvbnRleHQ/OiB1bmtub3duO1xuICAgIGluaXRpYWxDb250ZXh0PzogdW5rbm93bjtcbiAgICByZWFkT25seUNvbnRleHQ/OiB1bmtub3duO1xuICAgIHRocm90dGxpbmdFcnJvckNoZWNrZXI/OiAoZXJyb3I6IHVua25vd24pID0+IGJvb2xlYW47XG4gICAgc3RyZWFtSGFuZGxlcnM/OiBTdHJlYW1IYW5kbGVycztcbiAgICBzY29wZVByb3RlY3Rpb25Nb2RlPzogU2NvcGVQcm90ZWN0aW9uTW9kZTtcbiAgICBlbnJpY2hTbmFwc2hvdHM/OiBib29sZWFuO1xuICB9O1xuXG4gIGNvbnN0cnVjdG9yKFxuICAgIGZsb3dDaGFydDogRmxvd0NoYXJ0PFRPdXQsIFRTY29wZT4sXG4gICAgc2NvcGVGYWN0b3J5OiBTY29wZUZhY3Rvcnk8VFNjb3BlPixcbiAgICBkZWZhdWx0VmFsdWVzRm9yQ29udGV4dD86IHVua25vd24sXG4gICAgaW5pdGlhbENvbnRleHQ/OiB1bmtub3duLFxuICAgIHJlYWRPbmx5Q29udGV4dD86IHVua25vd24sXG4gICAgdGhyb3R0bGluZ0Vycm9yQ2hlY2tlcj86IChlcnJvcjogdW5rbm93bikgPT4gYm9vbGVhbixcbiAgICBzdHJlYW1IYW5kbGVycz86IFN0cmVhbUhhbmRsZXJzLFxuICAgIHNjb3BlUHJvdGVjdGlvbk1vZGU/OiBTY29wZVByb3RlY3Rpb25Nb2RlLFxuICAgIGVucmljaFNuYXBzaG90cz86IGJvb2xlYW4sXG4gICkge1xuICAgIHRoaXMuZmxvd0NoYXJ0QXJncyA9IHtcbiAgICAgIGZsb3dDaGFydCxcbiAgICAgIHNjb3BlRmFjdG9yeSxcbiAgICAgIGRlZmF1bHRWYWx1ZXNGb3JDb250ZXh0LFxuICAgICAgaW5pdGlhbENvbnRleHQsXG4gICAgICByZWFkT25seUNvbnRleHQsXG4gICAgICB0aHJvdHRsaW5nRXJyb3JDaGVja2VyLFxuICAgICAgc3RyZWFtSGFuZGxlcnMsXG4gICAgICBzY29wZVByb3RlY3Rpb25Nb2RlLFxuICAgICAgZW5yaWNoU25hcHNob3RzLFxuICAgIH07XG4gICAgdGhpcy50cmF2ZXJzZXIgPSB0aGlzLmNyZWF0ZVRyYXZlcnNlcigpO1xuICB9XG5cbiAgcHJpdmF0ZSBjcmVhdGVUcmF2ZXJzZXIoc2lnbmFsPzogQWJvcnRTaWduYWwpOiBGbG93Y2hhcnRUcmF2ZXJzZXI8VE91dCwgVFNjb3BlPiB7XG4gICAgY29uc3QgYXJncyA9IHRoaXMuZmxvd0NoYXJ0QXJncztcbiAgICBjb25zdCBmYyA9IGFyZ3MuZmxvd0NoYXJ0O1xuICAgIGNvbnN0IG5hcnJhdGl2ZUZsYWcgPSB0aGlzLm5hcnJhdGl2ZUVuYWJsZWQgfHwgKGZjLmVuYWJsZU5hcnJhdGl2ZSA/PyBmYWxzZSk7XG5cbiAgICAvLyBXaGVuIG5hcnJhdGl2ZSBpcyBlbmFibGVkLCBjcmVhdGUgYSByZWNvcmRlciBhbmQgd3JhcCB0aGUgc2NvcGUgZmFjdG9yeVxuICAgIC8vIHRvIGF1dG8tYXR0YWNoIGl0IHRvIGV2ZXJ5IHNjb3BlIHRoYXQgc3VwcG9ydHMgYXR0YWNoUmVjb3JkZXIoKS5cbiAgICBsZXQgc2NvcGVGYWN0b3J5ID0gYXJncy5zY29wZUZhY3Rvcnk7XG4gICAgaWYgKG5hcnJhdGl2ZUZsYWcpIHtcbiAgICAgIHRoaXMubmFycmF0aXZlUmVjb3JkZXIgPSBuZXcgTmFycmF0aXZlUmVjb3JkZXIoKTtcbiAgICAgIGNvbnN0IHJlY29yZGVyID0gdGhpcy5uYXJyYXRpdmVSZWNvcmRlcjtcbiAgICAgIGNvbnN0IG9yaWdpbmFsRmFjdG9yeSA9IGFyZ3Muc2NvcGVGYWN0b3J5O1xuICAgICAgc2NvcGVGYWN0b3J5ID0gKChjdHg6IGFueSwgc3RhZ2VOYW1lOiBzdHJpbmcsIHJlYWRPbmx5PzogdW5rbm93bikgPT4ge1xuICAgICAgICBjb25zdCBzY29wZSA9IG9yaWdpbmFsRmFjdG9yeShjdHgsIHN0YWdlTmFtZSwgcmVhZE9ubHkpO1xuICAgICAgICBpZiAoc2NvcGUgJiYgdHlwZW9mIChzY29wZSBhcyBhbnkpLmF0dGFjaFJlY29yZGVyID09PSAnZnVuY3Rpb24nKSB7XG4gICAgICAgICAgKHNjb3BlIGFzIGFueSkuYXR0YWNoUmVjb3JkZXIocmVjb3JkZXIpO1xuICAgICAgICB9XG4gICAgICAgIHJldHVybiBzY29wZTtcbiAgICAgIH0pIGFzIFNjb3BlRmFjdG9yeTxUU2NvcGU+O1xuICAgIH0gZWxzZSB7XG4gICAgICB0aGlzLm5hcnJhdGl2ZVJlY29yZGVyID0gdW5kZWZpbmVkO1xuICAgIH1cblxuICAgIGNvbnN0IHJ1bnRpbWUgPSBuZXcgRXhlY3V0aW9uUnVudGltZShmYy5yb290Lm5hbWUsIGFyZ3MuZGVmYXVsdFZhbHVlc0ZvckNvbnRleHQsIGFyZ3MuaW5pdGlhbENvbnRleHQpO1xuXG4gICAgcmV0dXJuIG5ldyBGbG93Y2hhcnRUcmF2ZXJzZXI8VE91dCwgVFNjb3BlPih7XG4gICAgICByb290OiBmYy5yb290LFxuICAgICAgc3RhZ2VNYXA6IGZjLnN0YWdlTWFwLFxuICAgICAgc2NvcGVGYWN0b3J5LFxuICAgICAgZXhlY3V0aW9uUnVudGltZTogcnVudGltZSxcbiAgICAgIHJlYWRPbmx5Q29udGV4dDogYXJncy5yZWFkT25seUNvbnRleHQsXG4gICAgICB0aHJvdHRsaW5nRXJyb3JDaGVja2VyOiBhcmdzLnRocm90dGxpbmdFcnJvckNoZWNrZXIsXG4gICAgICBzdHJlYW1IYW5kbGVyczogYXJncy5zdHJlYW1IYW5kbGVycyxcbiAgICAgIGV4dHJhY3RvcjogZmMuZXh0cmFjdG9yLFxuICAgICAgc2NvcGVQcm90ZWN0aW9uTW9kZTogYXJncy5zY29wZVByb3RlY3Rpb25Nb2RlLFxuICAgICAgc3ViZmxvd3M6IGZjLnN1YmZsb3dzLFxuICAgICAgZW5yaWNoU25hcHNob3RzOiBhcmdzLmVucmljaFNuYXBzaG90cyA/PyBmYy5lbnJpY2hTbmFwc2hvdHMsXG4gICAgICBuYXJyYXRpdmVFbmFibGVkOiBuYXJyYXRpdmVGbGFnLFxuICAgICAgYnVpbGRUaW1lU3RydWN0dXJlOiBmYy5idWlsZFRpbWVTdHJ1Y3R1cmUsXG4gICAgICBsb2dnZXI6IGZjLmxvZ2dlciA/PyBkZWZhdWx0TG9nZ2VyLFxuICAgICAgc2lnbmFsLFxuICAgIH0pO1xuICB9XG5cbiAgZW5hYmxlTmFycmF0aXZlKCk6IHZvaWQge1xuICAgIHRoaXMubmFycmF0aXZlRW5hYmxlZCA9IHRydWU7XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJucyB0aGUgZXhlY3V0aW9uIG5hcnJhdGl2ZS5cbiAgICpcbiAgICogV2hlbiB1c2luZyBTY29wZUZhY2FkZS1iYXNlZCBzY29wZXMsIHJldHVybnMgYSBjb21iaW5lZCBuYXJyYXRpdmUgdGhhdFxuICAgKiBpbnRlcmxlYXZlcyBmbG93IGV2ZW50cyAoc3RhZ2VzLCBkZWNpc2lvbnMsIGZvcmtzKSB3aXRoIGRhdGEgb3BlcmF0aW9uc1xuICAgKiAocmVhZHMsIHdyaXRlcywgdXBkYXRlcykuIEZvciBwbGFpbiBzY29wZXMgd2l0aG91dCBhdHRhY2hSZWNvcmRlciBzdXBwb3J0LFxuICAgKiByZXR1cm5zIGZsb3ctb25seSBuYXJyYXRpdmUgc2VudGVuY2VzLlxuICAgKi9cbiAgZ2V0TmFycmF0aXZlKCk6IHN0cmluZ1tdIHtcbiAgICBjb25zdCBmbG93U2VudGVuY2VzID0gdGhpcy50cmF2ZXJzZXIuZ2V0TmFycmF0aXZlKCk7XG4gICAgaWYgKHRoaXMubmFycmF0aXZlUmVjb3JkZXIgJiYgdGhpcy5uYXJyYXRpdmVSZWNvcmRlci5nZXRTdGFnZURhdGEoKS5zaXplID4gMCkge1xuICAgICAgcmV0dXJuIG5ldyBDb21iaW5lZE5hcnJhdGl2ZUJ1aWxkZXIoKS5idWlsZChmbG93U2VudGVuY2VzLCB0aGlzLm5hcnJhdGl2ZVJlY29yZGVyKTtcbiAgICB9XG4gICAgcmV0dXJuIGZsb3dTZW50ZW5jZXM7XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJucyBzdHJ1Y3R1cmVkIG5hcnJhdGl2ZSBlbnRyaWVzIGZvciBwcm9ncmFtbWF0aWMgY29uc3VtcHRpb24uXG4gICAqIEVhY2ggZW50cnkgaGFzIGEgdHlwZSAoc3RhZ2UsIHN0ZXAsIGNvbmRpdGlvbiwgZm9yaywgZXRjLiksIHRleHQsIGFuZCBkZXB0aC5cbiAgICovXG4gIGdldE5hcnJhdGl2ZUVudHJpZXMoKTogQ29tYmluZWROYXJyYXRpdmVFbnRyeVtdIHtcbiAgICBjb25zdCBmbG93U2VudGVuY2VzID0gdGhpcy50cmF2ZXJzZXIuZ2V0TmFycmF0aXZlKCk7XG4gICAgaWYgKHRoaXMubmFycmF0aXZlUmVjb3JkZXIpIHtcbiAgICAgIHJldHVybiBuZXcgQ29tYmluZWROYXJyYXRpdmVCdWlsZGVyKCkuYnVpbGRFbnRyaWVzKGZsb3dTZW50ZW5jZXMsIHRoaXMubmFycmF0aXZlUmVjb3JkZXIpO1xuICAgIH1cbiAgICByZXR1cm4gZmxvd1NlbnRlbmNlcy5tYXAoKHRleHQpID0+ICh7IHR5cGU6ICdzdGFnZScgYXMgY29uc3QsIHRleHQsIGRlcHRoOiAwIH0pKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIGZsb3ctb25seSBuYXJyYXRpdmUgc2VudGVuY2VzICh3aXRob3V0IGRhdGEgb3BlcmF0aW9ucykuXG4gICAqIFVzZSB0aGlzIHdoZW4geW91IG9ubHkgd2FudCBjb250cm9sIGZsb3cgZGVzY3JpcHRpb25zLlxuICAgKi9cbiAgZ2V0Rmxvd05hcnJhdGl2ZSgpOiBzdHJpbmdbXSB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldE5hcnJhdGl2ZSgpO1xuICB9XG5cbiAgYXN5bmMgcnVuKG9wdGlvbnM/OiBSdW5PcHRpb25zKTogUHJvbWlzZTxUcmF2ZXJzYWxSZXN1bHQ+IHtcbiAgICBsZXQgc2lnbmFsID0gb3B0aW9ucz8uc2lnbmFsO1xuICAgIGxldCB0aW1lb3V0SWQ6IFJldHVyblR5cGU8dHlwZW9mIHNldFRpbWVvdXQ+IHwgdW5kZWZpbmVkO1xuXG4gICAgLy8gQ3JlYXRlIGFuIGludGVybmFsIEFib3J0Q29udHJvbGxlciBmb3IgdGltZW91dE1zXG4gICAgaWYgKG9wdGlvbnM/LnRpbWVvdXRNcyAmJiAhc2lnbmFsKSB7XG4gICAgICBjb25zdCBjb250cm9sbGVyID0gbmV3IEFib3J0Q29udHJvbGxlcigpO1xuICAgICAgc2lnbmFsID0gY29udHJvbGxlci5zaWduYWw7XG4gICAgICB0aW1lb3V0SWQgPSBzZXRUaW1lb3V0KFxuICAgICAgICAoKSA9PiBjb250cm9sbGVyLmFib3J0KG5ldyBFcnJvcihgRXhlY3V0aW9uIHRpbWVkIG91dCBhZnRlciAke29wdGlvbnMudGltZW91dE1zfW1zYCkpLFxuICAgICAgICBvcHRpb25zLnRpbWVvdXRNcyxcbiAgICAgICk7XG4gICAgfVxuXG4gICAgdGhpcy50cmF2ZXJzZXIgPSB0aGlzLmNyZWF0ZVRyYXZlcnNlcihzaWduYWwpO1xuICAgIHRyeSB7XG4gICAgICByZXR1cm4gYXdhaXQgdGhpcy50cmF2ZXJzZXIuZXhlY3V0ZSgpO1xuICAgIH0gZmluYWxseSB7XG4gICAgICBpZiAodGltZW91dElkICE9PSB1bmRlZmluZWQpIGNsZWFyVGltZW91dCh0aW1lb3V0SWQpO1xuICAgIH1cbiAgfVxuXG4gIC8vIOKUgOKUgOKUgCBJbnRyb3NwZWN0aW9uIOKUgOKUgOKUgFxuXG4gIGdldFNuYXBzaG90KCkge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRTbmFwc2hvdCgpO1xuICB9XG5cbiAgZ2V0UnVudGltZSgpIHtcbiAgICByZXR1cm4gdGhpcy50cmF2ZXJzZXIuZ2V0UnVudGltZSgpO1xuICB9XG5cbiAgc2V0Um9vdE9iamVjdChwYXRoOiBzdHJpbmdbXSwga2V5OiBzdHJpbmcsIHZhbHVlOiB1bmtub3duKTogdm9pZCB7XG4gICAgdGhpcy50cmF2ZXJzZXIuc2V0Um9vdE9iamVjdChwYXRoLCBrZXksIHZhbHVlKTtcbiAgfVxuXG4gIGdldEJyYW5jaElkcygpIHtcbiAgICByZXR1cm4gdGhpcy50cmF2ZXJzZXIuZ2V0QnJhbmNoSWRzKCk7XG4gIH1cblxuICBnZXRSdW50aW1lUm9vdCgpOiBTdGFnZU5vZGUge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRSdW50aW1lUm9vdCgpO1xuICB9XG5cbiAgZ2V0UnVudGltZVN0cnVjdHVyZSgpOiBTZXJpYWxpemVkUGlwZWxpbmVTdHJ1Y3R1cmUgfCB1bmRlZmluZWQge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRSdW50aW1lU3RydWN0dXJlKCk7XG4gIH1cblxuICBnZXRTdWJmbG93UmVzdWx0cygpOiBNYXA8c3RyaW5nLCBTdWJmbG93UmVzdWx0PiB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldFN1YmZsb3dSZXN1bHRzKCk7XG4gIH1cblxuICBnZXRFeHRyYWN0ZWRSZXN1bHRzPFRSZXN1bHQgPSB1bmtub3duPigpOiBNYXA8c3RyaW5nLCBUUmVzdWx0PiB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldEV4dHJhY3RlZFJlc3VsdHM8VFJlc3VsdD4oKTtcbiAgfVxuXG4gIGdldEVucmljaGVkUmVzdWx0czxUUmVzdWx0ID0gdW5rbm93bj4oKTogTWFwPHN0cmluZywgVFJlc3VsdD4ge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRFeHRyYWN0ZWRSZXN1bHRzPFRSZXN1bHQ+KCk7XG4gIH1cblxuICBnZXRFeHRyYWN0b3JFcnJvcnMoKTogRXh0cmFjdG9yRXJyb3JbXSB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldEV4dHJhY3RvckVycm9ycygpO1xuICB9XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRmxvd0NoYXJ0RXhlY3V0b3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL3J1bm5lci9GbG93Q2hhcnRFeGVjdXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7R0FPRzs7O0FBR0gsMkZBQXdGO0FBRXhGLCtFQUE0RTtBQUM1RSwyQ0FXeUI7QUFFekIsNEVBQXlFO0FBQ3pFLHlEQUFzRDtBQUV0RCxNQUFhLGlCQUFpQjtJQWtCNUIsWUFDRSxTQUFrQyxFQUNsQyxZQUFrQyxFQUNsQyx1QkFBaUMsRUFDakMsY0FBd0IsRUFDeEIsZUFBeUIsRUFDekIsc0JBQW9ELEVBQ3BELGNBQStCLEVBQy9CLG1CQUF5QyxFQUN6QyxlQUF5QjtRQXpCbkIscUJBQWdCLEdBQUcsS0FBSyxDQUFDO1FBRXpCLGtCQUFhLEdBQW1CLEVBQUUsQ0FBQztRQXlCekMsSUFBSSxDQUFDLGFBQWEsR0FBRztZQUNuQixTQUFTO1lBQ1QsWUFBWTtZQUNaLHVCQUF1QjtZQUN2QixjQUFjO1lBQ2QsZUFBZTtZQUNmLHNCQUFzQjtZQUN0QixjQUFjO1lBQ2QsbUJBQW1CO1lBQ25CLGVBQWU7U0FDaEIsQ0FBQztRQUNGLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDO0lBQzFDLENBQUM7SUFFTyxlQUFlLENBQUMsTUFBb0I7O1FBQzFDLE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxhQUFhLENBQUM7UUFDaEMsTUFBTSxFQUFFLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQztRQUMxQixNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsZ0JBQWdCLElBQUksQ0FBQyxNQUFBLEVBQUUsQ0FBQyxlQUFlLG1DQUFJLEtBQUssQ0FBQyxDQUFDO1FBRTdFLDBFQUEwRTtRQUMxRSxtRUFBbUU7UUFDbkUsSUFBSSxZQUFZLEdBQUcsSUFBSSxDQUFDLFlBQVksQ0FBQztRQUNyQyxJQUFJLGFBQWEsRUFBRSxDQUFD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QUFDO0lBRUQsbUJBQW1CO1FBQ2pCLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxtQkFBbUIsRUFBVyxDQUFDO0lBQ3ZELENBQUM7SUFFRCxrQkFBa0I7UUFDaEIsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLG1CQUFtQixFQUFXLENBQUM7SUFDdkQsQ0FBQztJQUVELGtCQUFrQjtRQUNoQixPQUFPLElBQUksQ0FBQyxTQUFTLENBQUMsa0JBQWtCLEVBQUUsQ0FBQztJQUM3QyxDQUFDO0NBQ0Y7QUFyTkQsOENBcU5DIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBGbG93Q2hhcnRFeGVjdXRvciDigJQgUHVibGljIEFQSSBmb3IgZXhlY3V0aW5nIGEgY29tcGlsZWQgRmxvd0NoYXJ0LlxuICpcbiAqIFdyYXBzIEZsb3djaGFydFRyYXZlcnNlci4gUGFpcnMgd2l0aCBGbG93Q2hhcnRCdWlsZGVyOlxuICogICBjb25zdCBjaGFydCA9IGZsb3dDaGFydCgnZW50cnknLCBlbnRyeUZuKS5hZGRGdW5jdGlvbigncHJvY2VzcycsIHByb2Nlc3NGbikuYnVpbGQoKTtcbiAqICAgY29uc3QgZXhlY3V0b3IgPSBuZXcgRmxvd0NoYXJ0RXhlY3V0b3IoY2hhcnQsIHNjb3BlRmFjdG9yeSk7XG4gKiAgIGNvbnN0IHJlc3VsdCA9IGF3YWl0IGV4ZWN1dG9yLnJ1bigpO1xuICovXG5cbmltcG9ydCB0eXBlIHsgQ29tYmluZWROYXJyYXRpdmVFbnRyeSB9IGZyb20gJy4uL2VuZ2luZS9uYXJyYXRpdmUvQ29tYmluZWROYXJyYXRpdmVCdWlsZGVyJztcbmltcG9ydCB7IENvbWJpbmVkTmFycmF0aXZlQnVpbGRlciB9IGZyb20gJy4uL2VuZ2luZS9uYXJyYXRpdmUvQ29tYmluZWROYXJyYXRpdmVCdWlsZGVyJztcbmltcG9ydCB0eXBlIHsgRmxvd1JlY29yZGVyIH0gZnJvbSAnLi4vZW5naW5lL25hcnJhdGl2ZS90eXBlcyc7XG5pbXBvcnQgeyBGbG93Y2hhcnRUcmF2ZXJzZXIgfSBmcm9tICcuLi9lbmdpbmUvdHJhdmVyc2FsL0Zsb3djaGFydFRyYXZlcnNlcic7XG5pbXBvcnQge1xuICB0eXBlIEV4dHJhY3RvckVycm9yLFxuICB0eXBlIEZsb3dDaGFydCxcbiAgdHlwZSBSdW5PcHRpb25zLFxuICB0eXBlIFNjb3BlRmFjdG9yeSxcbiAgdHlwZSBTZXJpYWxpemVkUGlwZWxpbmVTdHJ1Y3R1cmUsXG4gIHR5cGUgU3RhZ2VOb2RlLFxuICB0eXBlIFN0cmVhbUhhbmRsZXJzLFxuICB0eXBlIFN1YmZsb3dSZXN1bHQsXG4gIHR5cGUgVHJhdmVyc2FsUmVzdWx0LFxuICBkZWZhdWx0TG9nZ2VyLFxufSBmcm9tICcuLi9lbmdpbmUvdHlwZXMnO1xuaW1wb3J0IHR5cGUgeyBTY29wZVByb3RlY3Rpb25Nb2RlIH0gZnJvbSAnLi4vc2NvcGUvcHJvdGVjdGlvbi90eXBlcyc7XG5pbXBvcnQgeyBOYXJyYXRpdmVSZWNvcmRlciB9IGZyb20gJy4uL3Njb3BlL3JlY29yZGVycy9OYXJyYXRpdmVSZWNvcmRlcic7XG5pbXBvcnQgeyBFeGVjdXRpb25SdW50aW1lIH0gZnJvbSAnLi9FeGVjdXRpb25SdW50aW1lJztcblxuZXhwb3J0IGNsYXNzIEZsb3dDaGFydEV4ZWN1dG9yPFRPdXQgPSBhbnksIFRTY29wZSA9IGFueT4ge1xuICBwcml2YXRlIHRyYXZlcnNlcjogRmxvd2NoYXJ0VHJhdmVyc2VyPFRPdXQsIFRTY29wZT47XG4gIHByaXZhdGUgbmFycmF0aXZlRW5hYmxlZCA9IGZhbHNlO1xuICBwcml2YXRlIG5hcnJhdGl2ZVJlY29yZGVyOiBOYXJyYXRpdmVSZWNvcmRlciB8IHVuZGVmaW5lZDtcbiAgcHJpdmF0ZSBmbG93UmVjb3JkZXJzOiBGbG93UmVjb3JkZXJbXSA9IFtdO1xuXG4gIHByaXZhdGUgcmVhZG9ubHkgZmxvd0NoYXJ0QXJnczoge1xuICAgIGZsb3dDaGFydDogRmxvd0NoYXJ0PFRPdXQsIFRTY29wZT47XG4gICAgc2NvcGVGYWN0b3J5OiBTY29wZUZhY3Rvcnk8VFNjb3BlPjtcbiAgICBkZWZhdWx0VmFsdWVzRm9yQ29udGV4dD86IHVua25vd247XG4gICAgaW5pdGlhbENvbnRleHQ/OiB1bmtub3duO1xuICAgIHJlYWRPbmx5Q29udGV4dD86IHVua25vd247XG4gICAgdGhyb3R0bGluZ0Vycm9yQ2hlY2tlcj86IChlcnJvcjogdW5rbm93bikgPT4gYm9vbGVhbjtcbiAgICBzdHJlYW1IYW5kbGVycz86IFN0cmVhbUhhbmRsZXJzO1xuICAgIHNjb3BlUHJvdGVjdGlvbk1vZGU/OiBTY29wZVByb3RlY3Rpb25Nb2RlO1xuICAgIGVucmljaFNuYXBzaG90cz86IGJvb2xlYW47XG4gIH07XG5cbiAgY29uc3RydWN0b3IoXG4gICAgZmxvd0NoYXJ0OiBGbG93Q2hhcnQ8VE91dCwgVFNjb3BlPixcbiAgICBzY29wZUZhY3Rvcnk6IFNjb3BlRmFjdG9yeTxUU2NvcGU+LFxuICAgIGRlZmF1bHRWYWx1ZXNGb3JDb250ZXh0PzogdW5rbm93bixcbiAgICBpbml0aWFsQ29udGV4dD86IHVua25vd24sXG4gICAgcmVhZE9ubHlDb250ZXh0PzogdW5rbm93bixcbiAgICB0aHJvdHRsaW5nRXJyb3JDaGVja2VyPzogKGVycm9yOiB1bmtub3duKSA9PiBib29sZWFuLFxuICAgIHN0cmVhbUhhbmRsZXJzPzogU3RyZWFtSGFuZGxlcnMsXG4gICAgc2NvcGVQcm90ZWN0aW9uTW9kZT86IFNjb3BlUHJvdGVjdGlvbk1vZGUsXG4gICAgZW5yaWNoU25hcHNob3RzPzogYm9vbGVhbixcbiAgKSB7XG4gICAgdGhpcy5mbG93Q2hhcnRBcmdzID0ge1xuICAgICAgZmxvd0NoYXJ0LFxuICAgICAgc2NvcGVGYWN0b3J5LFxuICAgICAgZGVmYXVsdFZhbHVlc0ZvckNvbnRleHQsXG4gICAgICBpbml0aWFsQ29udGV4dCxcbiAgICAgIHJlYWRPbmx5Q29udGV4dCxcbiAgICAgIHRocm90dGxpbmdFcnJvckNoZWNrZXIsXG4gICAgICBzdHJlYW1IYW5kbGVycyxcbiAgICAgIHNjb3BlUHJvdGVjdGlvbk1vZGUsXG4gICAgICBlbnJpY2hTbmFwc2hvdHMsXG4gICAgfTtcbiAgICB0aGlzLnRyYXZlcnNlciA9IHRoaXMuY3JlYXRlVHJhdmVyc2VyKCk7XG4gIH1cblxuICBwcml2YXRlIGNyZWF0ZVRyYXZlcnNlcihzaWduYWw/OiBBYm9ydFNpZ25hbCk6IEZsb3djaGFydFRyYXZlcnNlcjxUT3V0LCBUU2NvcGU+IHtcbiAgICBjb25zdCBhcmdzID0gdGhpcy5mbG93Q2hhcnRBcmdzO1xuICAgIGNvbnN0IGZjID0gYXJncy5mbG93Q2hhcnQ7XG4gICAgY29uc3QgbmFycmF0aXZlRmxhZyA9IHRoaXMubmFycmF0aXZlRW5hYmxlZCB8fCAoZmMuZW5hYmxlTmFycmF0aXZlID8/IGZhbHNlKTtcblxuICAgIC8vIFdoZW4gbmFycmF0aXZlIGlzIGVuYWJsZWQsIGNyZWF0ZSBhIHJlY29yZGVyIGFuZCB3cmFwIHRoZSBzY29wZSBmYWN0b3J5XG4gICAgLy8gdG8gYXV0by1hdHRhY2ggaXQgdG8gZXZlcnkgc2NvcGUgdGhhdCBzdXBwb3J0cyBhdHRhY2hSZWNvcmRlcigpLlxuICAgIGxldCBzY29wZUZhY3RvcnkgPSBhcmdzLnNjb3BlRmFjdG9yeTtcbiAgICBpZiAobmFycmF0aXZlRmxhZykge1xuICAgICAgdGhpcy5uYXJyYXRpdmVSZWNvcmRlciA9IG5ldyBOYXJyYXRpdmVSZWNvcmRlcigpO1xuICAgICAgY29uc3QgcmVjb3JkZXIgPSB0aGlzLm5hcnJhdGl2ZVJlY29yZGVyO1xuICAgICAgY29uc3Qgb3JpZ2luYWxGYWN0b3J5ID0gYXJncy5zY29wZUZhY3Rvcnk7XG4gICAgICBzY29wZUZhY3RvcnkgPSAoKGN0eDogYW55LCBzdGFnZU5hbWU6IHN0cmluZywgcmVhZE9ubHk/OiB1bmtub3duKSA9PiB7XG4gICAgICAgIGNvbnN0IHNjb3BlID0gb3JpZ2luYWxGYWN0b3J5KGN0eCwgc3RhZ2VOYW1lLCByZWFkT25seSk7XG4gICAgICAgIGlmIChzY29wZSAmJiB0eXBlb2YgKHNjb3BlIGFzIGFueSkuYXR0YWNoUmVjb3JkZXIgPT09ICdmdW5jdGlvbicpIHtcbiAgICAgICAgICAoc2NvcGUgYXMgYW55KS5hdHRhY2hSZWNvcmRlcihyZWNvcmRlcik7XG4gICAgICAgIH1cbiAgICAgICAgcmV0dXJuIHNjb3BlO1xuICAgICAgfSkgYXMgU2NvcGVGYWN0b3J5PFRTY29wZT47XG4gICAgfSBlbHNlIHtcbiAgICAgIHRoaXMubmFycmF0aXZlUmVjb3JkZXIgPSB1bmRlZmluZWQ7XG4gICAgfVxuXG4gICAgY29uc3QgcnVudGltZSA9IG5ldyBFeGVjdXRpb25SdW50aW1lKGZjLnJvb3QubmFtZSwgYXJncy5kZWZhdWx0VmFsdWVzRm9yQ29udGV4dCwgYXJncy5pbml0aWFsQ29udGV4dCk7XG5cbiAgICByZXR1cm4gbmV3IEZsb3djaGFydFRyYXZlcnNlcjxUT3V0LCBUU2NvcGU+KHtcbiAgICAgIHJvb3Q6IGZjLnJvb3QsXG4gICAgICBzdGFnZU1hcDogZmMuc3RhZ2VNYXAsXG4gICAgICBzY29wZUZhY3RvcnksXG4gICAgICBleGVjdXRpb25SdW50aW1lOiBydW50aW1lLFxuICAgICAgcmVhZE9ubHlDb250ZXh0OiBhcmdzLnJlYWRPbmx5Q29udGV4dCxcbiAgICAgIHRocm90dGxpbmdFcnJvckNoZWNrZXI6IGFyZ3MudGhyb3R0bGluZ0Vycm9yQ2hlY2tlcixcbiAgICAgIHN0cmVhbUhhbmRsZXJzOiBhcmdzLnN0cmVhbUhhbmRsZXJzLFxuICAgICAgZXh0cmFjdG9yOiBmYy5leHRyYWN0b3IsXG4gICAgICBzY29wZVByb3RlY3Rpb25Nb2RlOiBhcmdzLnNjb3BlUHJvdGVjdGlvbk1vZGUsXG4gICAgICBzdWJmbG93czogZmMuc3ViZmxvd3MsXG4gICAgICBlbnJpY2hTbmFwc2hvdHM6IGFyZ3MuZW5yaWNoU25hcHNob3RzID8/IGZjLmVucmljaFNuYXBzaG90cyxcbiAgICAgIG5hcnJhdGl2ZUVuYWJsZWQ6IG5hcnJhdGl2ZUZsYWcsXG4gICAgICBidWlsZFRpbWVTdHJ1Y3R1cmU6IGZjLmJ1aWxkVGltZVN0cnVjdHVyZSxcbiAgICAgIGxvZ2dlcjogZmMubG9nZ2VyID8/IGRlZmF1bHRMb2dnZXIsXG4gICAgICBzaWduYWwsXG4gICAgICBmbG93UmVjb3JkZXJzOiB0aGlzLmZsb3dSZWNvcmRlcnMubGVuZ3RoID4gMCA/IHRoaXMuZmxvd1JlY29yZGVycyA6IHVuZGVmaW5lZCxcbiAgICB9KTtcbiAgfVxuXG4gIGVuYWJsZU5hcnJhdGl2ZSgpOiB2b2lkIHtcbiAgICB0aGlzLm5hcnJhdGl2ZUVuYWJsZWQgPSB0cnVlO1xuICB9XG5cbiAgLy8g4pSA4pSA4pSAIEZsb3dSZWNvcmRlciBNYW5hZ2VtZW50IOKUgOKUgOKUgFxuXG4gIC8qKlxuICAgKiBBdHRhY2ggYSBGbG93UmVjb3JkZXIgdG8gb2JzZXJ2ZSBjb250cm9sIGZsb3cgZXZlbnRzLlxuICAgKiBBdXRvbWF0aWNhbGx5IGVuYWJsZXMgbmFycmF0aXZlIGlmIG5vdCBhbHJlYWR5IGVuYWJsZWQuXG4gICAqIE11c3QgYmUgY2FsbGVkIGJlZm9yZSBydW4oKSDigJQgcmVjb3JkZXJzIGFyZSBwYXNzZWQgdG8gdGhlIHRyYXZlcnNlciBhdCBjcmVhdGlvbiB0aW1lLlxuICAgKi9cbiAgYXR0YWNoRmxvd1JlY29yZGVyKHJlY29yZGVyOiBGbG93UmVjb3JkZXIpOiB2b2lkIHtcbiAgICB0aGlzLmZsb3dSZWNvcmRlcnMucHVzaChyZWNvcmRlcik7XG4gICAgdGhpcy5uYXJyYXRpdmVFbmFibGVkID0gdHJ1ZTtcbiAgfVxuXG4gIC8qKiBEZXRhY2ggYWxsIEZsb3dSZWNvcmRlcnMgd2l0aCB0aGUgZ2l2ZW4gSUQuICovXG4gIGRldGFjaEZsb3dSZWNvcmRlcihpZDogc3RyaW5nKTogdm9pZCB7XG4gICAgdGhpcy5mbG93UmVjb3JkZXJzID0gdGhpcy5mbG93UmVjb3JkZXJzLmZpbHRlcigocikgPT4gci5pZCAhPT0gaWQpO1xuICB9XG5cbiAgLyoqIFJldHVybnMgYSBkZWZlbnNpdmUgY29weSBvZiBhdHRhY2hlZCBGbG93UmVjb3JkZXJzLiAqL1xuICBnZXRGbG93UmVjb3JkZXJzKCk6IEZsb3dSZWNvcmRlcltdIHtcbiAgICByZXR1cm4gWy4uLnRoaXMuZmxvd1JlY29yZGVyc107XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJucyB0aGUgZXhlY3V0aW9uIG5hcnJhdGl2ZS5cbiAgICpcbiAgICogV2hlbiB1c2luZyBTY29wZUZhY2FkZS1iYXNlZCBzY29wZXMsIHJldHVybnMgYSBjb21iaW5lZCBuYXJyYXRpdmUgdGhhdFxuICAgKiBpbnRlcmxlYXZlcyBmbG93IGV2ZW50cyAoc3RhZ2VzLCBkZWNpc2lvbnMsIGZvcmtzKSB3aXRoIGRhdGEgb3BlcmF0aW9uc1xuICAgKiAocmVhZHMsIHdyaXRlcywgdXBkYXRlcykuIEZvciBwbGFpbiBzY29wZXMgd2l0aG91dCBhdHRhY2hSZWNvcmRlciBzdXBwb3J0LFxuICAgKiByZXR1cm5zIGZsb3ctb25seSBuYXJyYXRpdmUgc2VudGVuY2VzLlxuICAgKi9cbiAgZ2V0TmFycmF0aXZlKCk6IHN0cmluZ1tdIHtcbiAgICBjb25zdCBmbG93U2VudGVuY2VzID0gdGhpcy50cmF2ZXJzZXIuZ2V0TmFycmF0aXZlKCk7XG4gICAgaWYgKHRoaXMubmFycmF0aXZlUmVjb3JkZXIgJiYgdGhpcy5uYXJyYXRpdmVSZWNvcmRlci5nZXRTdGFnZURhdGEoKS5zaXplID4gMCkge1xuICAgICAgcmV0dXJuIG5ldyBDb21iaW5lZE5hcnJhdGl2ZUJ1aWxkZXIoKS5idWlsZChmbG93U2VudGVuY2VzLCB0aGlzLm5hcnJhdGl2ZVJlY29yZGVyKTtcbiAgICB9XG4gICAgcmV0dXJuIGZsb3dTZW50ZW5jZXM7XG4gIH1cblxuICAvKipcbiAgICogUmV0dXJucyBzdHJ1Y3R1cmVkIG5hcnJhdGl2ZSBlbnRyaWVzIGZvciBwcm9ncmFtbWF0aWMgY29uc3VtcHRpb24uXG4gICAqIEVhY2ggZW50cnkgaGFzIGEgdHlwZSAoc3RhZ2UsIHN0ZXAsIGNvbmRpdGlvbiwgZm9yaywgZXRjLiksIHRleHQsIGFuZCBkZXB0aC5cbiAgICovXG4gIGdldE5hcnJhdGl2ZUVudHJpZXMoKTogQ29tYmluZWROYXJyYXRpdmVFbnRyeVtdIHtcbiAgICBjb25zdCBmbG93U2VudGVuY2VzID0gdGhpcy50cmF2ZXJzZXIuZ2V0TmFycmF0aXZlKCk7XG4gICAgaWYgKHRoaXMubmFycmF0aXZlUmVjb3JkZXIpIHtcbiAgICAgIHJldHVybiBuZXcgQ29tYmluZWROYXJyYXRpdmVCdWlsZGVyKCkuYnVpbGRFbnRyaWVzKGZsb3dTZW50ZW5jZXMsIHRoaXMubmFycmF0aXZlUmVjb3JkZXIpO1xuICAgIH1cbiAgICByZXR1cm4gZmxvd1NlbnRlbmNlcy5tYXAoKHRleHQpID0+ICh7IHR5cGU6ICdzdGFnZScgYXMgY29uc3QsIHRleHQsIGRlcHRoOiAwIH0pKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm5zIGZsb3ctb25seSBuYXJyYXRpdmUgc2VudGVuY2VzICh3aXRob3V0IGRhdGEgb3BlcmF0aW9ucykuXG4gICAqIFVzZSB0aGlzIHdoZW4geW91IG9ubHkgd2FudCBjb250cm9sIGZsb3cgZGVzY3JpcHRpb25zLlxuICAgKi9cbiAgZ2V0Rmxvd05hcnJhdGl2ZSgpOiBzdHJpbmdbXSB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldE5hcnJhdGl2ZSgpO1xuICB9XG5cbiAgYXN5bmMgcnVuKG9wdGlvbnM/OiBSdW5PcHRpb25zKTogUHJvbWlzZTxUcmF2ZXJzYWxSZXN1bHQ+IHtcbiAgICBsZXQgc2lnbmFsID0gb3B0aW9ucz8uc2lnbmFsO1xuICAgIGxldCB0aW1lb3V0SWQ6IFJldHVyblR5cGU8dHlwZW9mIHNldFRpbWVvdXQ+IHwgdW5kZWZpbmVkO1xuXG4gICAgLy8gQ3JlYXRlIGFuIGludGVybmFsIEFib3J0Q29udHJvbGxlciBmb3IgdGltZW91dE1zXG4gICAgaWYgKG9wdGlvbnM/LnRpbWVvdXRNcyAmJiAhc2lnbmFsKSB7XG4gICAgICBjb25zdCBjb250cm9sbGVyID0gbmV3IEFib3J0Q29udHJvbGxlcigpO1xuICAgICAgc2lnbmFsID0gY29udHJvbGxlci5zaWduYWw7XG4gICAgICB0aW1lb3V0SWQgPSBzZXRUaW1lb3V0KFxuICAgICAgICAoKSA9PiBjb250cm9sbGVyLmFib3J0KG5ldyBFcnJvcihgRXhlY3V0aW9uIHRpbWVkIG91dCBhZnRlciAke29wdGlvbnMudGltZW91dE1zfW1zYCkpLFxuICAgICAgICBvcHRpb25zLnRpbWVvdXRNcyxcbiAgICAgICk7XG4gICAgfVxuXG4gICAgdGhpcy50cmF2ZXJzZXIgPSB0aGlzLmNyZWF0ZVRyYXZlcnNlcihzaWduYWwpO1xuICAgIHRyeSB7XG4gICAgICByZXR1cm4gYXdhaXQgdGhpcy50cmF2ZXJzZXIuZXhlY3V0ZSgpO1xuICAgIH0gZmluYWxseSB7XG4gICAgICBpZiAodGltZW91dElkICE9PSB1bmRlZmluZWQpIGNsZWFyVGltZW91dCh0aW1lb3V0SWQpO1xuICAgIH1cbiAgfVxuXG4gIC8vIOKUgOKUgOKUgCBJbnRyb3NwZWN0aW9uIOKUgOKUgOKUgFxuXG4gIGdldFNuYXBzaG90KCkge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRTbmFwc2hvdCgpO1xuICB9XG5cbiAgZ2V0UnVudGltZSgpIHtcbiAgICByZXR1cm4gdGhpcy50cmF2ZXJzZXIuZ2V0UnVudGltZSgpO1xuICB9XG5cbiAgc2V0Um9vdE9iamVjdChwYXRoOiBzdHJpbmdbXSwga2V5OiBzdHJpbmcsIHZhbHVlOiB1bmtub3duKTogdm9pZCB7XG4gICAgdGhpcy50cmF2ZXJzZXIuc2V0Um9vdE9iamVjdChwYXRoLCBrZXksIHZhbHVlKTtcbiAgfVxuXG4gIGdldEJyYW5jaElkcygpIHtcbiAgICByZXR1cm4gdGhpcy50cmF2ZXJzZXIuZ2V0QnJhbmNoSWRzKCk7XG4gIH1cblxuICBnZXRSdW50aW1lUm9vdCgpOiBTdGFnZU5vZGUge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRSdW50aW1lUm9vdCgpO1xuICB9XG5cbiAgZ2V0UnVudGltZVN0cnVjdHVyZSgpOiBTZXJpYWxpemVkUGlwZWxpbmVTdHJ1Y3R1cmUgfCB1bmRlZmluZWQge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRSdW50aW1lU3RydWN0dXJlKCk7XG4gIH1cblxuICBnZXRTdWJmbG93UmVzdWx0cygpOiBNYXA8c3RyaW5nLCBTdWJmbG93UmVzdWx0PiB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldFN1YmZsb3dSZXN1bHRzKCk7XG4gIH1cblxuICBnZXRFeHRyYWN0ZWRSZXN1bHRzPFRSZXN1bHQgPSB1bmtub3duPigpOiBNYXA8c3RyaW5nLCBUUmVzdWx0PiB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldEV4dHJhY3RlZFJlc3VsdHM8VFJlc3VsdD4oKTtcbiAgfVxuXG4gIGdldEVucmljaGVkUmVzdWx0czxUUmVzdWx0ID0gdW5rbm93bj4oKTogTWFwPHN0cmluZywgVFJlc3VsdD4ge1xuICAgIHJldHVybiB0aGlzLnRyYXZlcnNlci5nZXRFeHRyYWN0ZWRSZXN1bHRzPFRSZXN1bHQ+KCk7XG4gIH1cblxuICBnZXRFeHRyYWN0b3JFcnJvcnMoKTogRXh0cmFjdG9yRXJyb3JbXSB7XG4gICAgcmV0dXJuIHRoaXMudHJhdmVyc2VyLmdldEV4dHJhY3RvckVycm9ycygpO1xuICB9XG59XG4iXX0=

package/dist/types/index.d.ts

@@ -19,5 +19,18 @@ export type { CommitEvent, ErrorEvent, ReadEvent, Recorder, WriteEvent } from '.
 export { defineScopeFromZod } from './lib/scope';
 export type { CombinedNarrativeEntry } from './lib/engine';
 export { CombinedNarrativeBuilder } from './lib/engine';
+export type { FlowLoopEvent, FlowRecorder } from './lib/engine';
+export { NarrativeFlowRecorder } from './lib/engine';
+export { AdaptiveNarrativeFlowRecorder } from './lib/engine';
+export { MilestoneNarrativeFlowRecorder } from './lib/engine';
+export { ProgressiveNarrativeFlowRecorder } from './lib/engine';
+export { RLENarrativeFlowRecorder } from './lib/engine';
+export { SeparateNarrativeFlowRecorder } from './lib/engine';
+export { SilentNarrativeFlowRecorder } from './lib/engine';
+export { WindowedNarrativeFlowRecorder } from './lib/engine';
 export type { RunOptions } from './lib/engine';
 export type { ScopeFactory } from './lib/memory';
+export type { FlowChartContract, FlowChartContractOptions, JsonSchema, OpenAPIOptions, OpenAPISpec, } from './lib/contract';
+export { defineContract } from './lib/contract';
+export { normalizeSchema, zodToJsonSchema } from './lib/contract';
+export { generateOpenAPI } from './lib/contract';

package/dist/types/lib/builder/FlowChartBuilder.d.ts

@@ -77,11 +77,20 @@ export declare class FlowChartBuilder<TOut = any, TScope = any> {
     private _stepCounter;
     private _stageDescriptions;
     private _stageStepMap;
+    private _inputSchema?;
+    private _outputSchema?;
+    private _outputMapper?;
     constructor(buildTimeExtractor?: BuildTimeExtractor<any>);
     private _appendDescriptionLine;
     private _appendSubflowDescription;
     setEnableNarrative(): this;
     setLogger(logger: ILogger): this;
+    /** Declare the input schema (readOnlyContext shape). Accepts Zod schema or JSON Schema. */
+    setInputSchema(schema: unknown): this;
+    /** Declare the output schema (response shape). Accepts Zod schema or JSON Schema. */
+    setOutputSchema(schema: unknown): this;
+    /** Set the output mapper that extracts the response from final scope. */
+    setOutputMapper(mapper: (finalScope: Record<string, unknown>) => unknown): this;
     start(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): this;
     addFunction(name: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): this;
     addStreamingFunction(name: string, streamId?: string, fn?: PipelineStageFunction<TOut, TScope>, id?: string, description?: string): this;

package/dist/types/lib/builder/types.d.ts

@@ -126,6 +126,12 @@ export type FlowChart<TOut = any, TScope = any> = {
     logger?: ILogger;
     description: string;
     stageDescriptions: Map<string, string>;
+    /** Input schema (Zod or JSON Schema) — declared via setInputSchema(). */
+    inputSchema?: unknown;
+    /** Output schema (Zod or JSON Schema) — declared via setOutputSchema(). */
+    outputSchema?: unknown;
+    /** Output mapper — extracts response from final scope. */
+    outputMapper?: (finalScope: Record<string, unknown>) => unknown;
 };
 export type SimplifiedParallelSpec<TOut = any, TScope = any> = {
     id: string;

package/dist/types/lib/contract/defineContract.d.ts

@@ -0,0 +1,18 @@
+/**
+ * contract/defineContract.ts — Factory for creating a FlowChartContract.
+ *
+ * Wraps a compiled FlowChart with I/O schemas and an output mapper,
+ * using the same pattern as SubflowMountOptions (inputMapper/outputMapper).
+ *
+ * Usage:
+ *   const contract = defineContract(chart, {
+ *     inputSchema: z.object({ name: z.string() }),
+ *     outputSchema: z.object({ greeting: z.string() }),
+ *     outputMapper: (scope) => ({ greeting: scope.message as string }),
+ *   });
+ *
+ *   const openapi = contract.toOpenAPI();
+ */
+import type { FlowChart } from '../builder/types';
+import type { FlowChartContract, FlowChartContractOptions } from './types';
+export declare function defineContract<TInput = unknown, TOutput = unknown>(chart: FlowChart, options: FlowChartContractOptions<TInput, TOutput>): FlowChartContract<TInput, TOutput>;

package/dist/types/lib/contract/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * contract/ — FlowChart I/O contract and OpenAPI generation layer.
+ *
+ * Standalone library: wraps a compiled FlowChart with input/output schemas
+ * and generates OpenAPI 3.1 specs. Uses the same inputMapper/outputMapper
+ * pattern as subflow mounting.
+ *
+ * Zero runtime deps on Zod — Zod schemas detected via duck-typing and
+ * converted to JSON Schema at contract creation time.
+ */
+export { defineContract } from './defineContract';
+export { isZodSchema, normalizeSchema, zodToJsonSchema } from './schema';
+export { generateOpenAPI } from './openapi';
+export type { FlowChartContract, FlowChartContractOptions, JsonSchema, OpenAPIOptions, OpenAPISpec, SchemaInput, } from './types';

package/dist/types/lib/contract/openapi.d.ts

@@ -0,0 +1,12 @@
+/**
+ * contract/openapi.ts — OpenAPI 3.1 spec generator.
+ *
+ * Generates an OpenAPI spec from a FlowChartContract by combining:
+ * - chart.description → operation description
+ * - chart.stageDescriptions → step-by-step detail
+ * - inputSchema → requestBody
+ * - outputSchema → response
+ * - chart.buildTimeStructure → operation metadata (branches, forks, etc.)
+ */
+import type { FlowChartContract, OpenAPIOptions, OpenAPISpec } from './types';
+export declare function generateOpenAPI(contract: FlowChartContract, options?: OpenAPIOptions): OpenAPISpec;

package/dist/types/lib/contract/schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * contract/schema.ts — Schema normalization utilities.
+ *
+ * Converts Zod schemas or raw JSON Schema objects into a normalized
+ * JsonSchema format. Zod detection uses duck-typing (checks for `_def`).
+ *
+ * Standalone: no dependency on Zod at import time.
+ * Compatible with Zod v4 internals.
+ */
+import type { JsonSchema, SchemaInput } from './types';
+export declare function isZodSchema(input: unknown): boolean;
+/** Convert a Zod schema object to JSON Schema. */
+export declare function zodToJsonSchema(zodSchema: Record<string, unknown>): JsonSchema;
+export declare function normalizeSchema(input: SchemaInput): JsonSchema;

package/dist/types/lib/contract/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * contract/types.ts — Types for the FlowChart contract layer.
+ *
+ * Defines the I/O boundary for a flowchart: input schema, output schema,
+ * and output mapper. Uses the same pattern as SubflowMountOptions
+ * (inputMapper/outputMapper) but at the top-level flowchart boundary.
+ */
+import type { FlowChart } from '../builder/types';
+export type JsonSchema = {
+    type?: string | string[];
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: unknown[];
+    description?: string;
+    default?: unknown;
+    format?: string;
+    additionalProperties?: boolean | JsonSchema;
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    [key: string]: unknown;
+};
+/** Anything with a `def` (Zod v4) or `_def` (Zod v3) property is treated as a Zod schema. */
+export type SchemaInput = JsonSchema | {
+    def: unknown;
+    [key: string]: unknown;
+};
+export interface FlowChartContractOptions<_TInput = unknown, TOutput = unknown> {
+    /** Schema describing the input (readOnlyContext) shape. Zod or JSON Schema. */
+    inputSchema?: SchemaInput;
+    /** Schema describing the output shape. Zod or JSON Schema. */
+    outputSchema?: SchemaInput;
+    /** Maps the final scope state into the response shape. */
+    outputMapper?: (finalScope: Record<string, unknown>) => TOutput;
+}
+export interface FlowChartContract<_TInput = unknown, TOutput = unknown> {
+    /** The compiled flowchart. */
+    chart: FlowChart;
+    /** JSON Schema for the input (normalized from Zod or raw). */
+    inputSchema?: JsonSchema;
+    /** JSON Schema for the output (normalized from Zod or raw). */
+    outputSchema?: JsonSchema;
+    /** Maps the final scope state into the response shape. */
+    outputMapper?: (finalScope: Record<string, unknown>) => TOutput;
+    /** Auto-generated OpenAPI spec. */
+    toOpenAPI(options?: OpenAPIOptions): OpenAPISpec;
+}
+export interface OpenAPIOptions {
+    /** API version string (default: "1.0.0"). */
+    version?: string;
+    /** Base path prefix (default: "/"). */
+    basePath?: string;
+    /** HTTP method for the execute endpoint (default: "post"). */
+    method?: string;
+}
+export interface OpenAPISpec {
+    openapi: '3.1.0';
+    info: {
+        title: string;
+        description: string;
+        version: string;
+    };
+    paths: Record<string, Record<string, OpenAPIOperation>>;
+    components?: {
+        schemas?: Record<string, JsonSchema>;
+    };
+}
+export interface OpenAPIOperation {
+    operationId: string;
+    summary: string;
+    description: string;
+    requestBody?: {
+        required: boolean;
+        content: {
+            'application/json': {
+                schema: JsonSchema | {
+                    $ref: string;
+                };
+            };
+        };
+    };
+    responses: Record<string, {
+        description: string;
+        content?: {
+            'application/json': {
+                schema: JsonSchema | {
+                    $ref: string;
+                };
+            };
+        };
+    }>;
+}

package/dist/types/lib/engine/index.d.ts

@@ -14,3 +14,13 @@ export { CombinedNarrativeBuilder } from './narrative/CombinedNarrativeBuilder';
 export { ControlFlowNarrativeGenerator } from './narrative/ControlFlowNarrativeGenerator';
 export { NullControlFlowNarrativeGenerator } from './narrative/NullControlFlowNarrativeGenerator';
 export type { IControlFlowNarrative } from './narrative/types';
+export { FlowRecorderDispatcher } from './narrative/FlowRecorderDispatcher';
+export { NarrativeFlowRecorder } from './narrative/NarrativeFlowRecorder';
+export type { FlowBreakEvent, FlowDecisionEvent, FlowErrorEvent, FlowForkEvent, FlowLoopEvent, FlowNextEvent, FlowRecorder, FlowSelectedEvent, FlowStageEvent, FlowSubflowEvent, } from './narrative/types';
+export { AdaptiveNarrativeFlowRecorder } from './narrative/recorders/AdaptiveNarrativeFlowRecorder';
+export { MilestoneNarrativeFlowRecorder } from './narrative/recorders/MilestoneNarrativeFlowRecorder';
+export { ProgressiveNarrativeFlowRecorder } from './narrative/recorders/ProgressiveNarrativeFlowRecorder';
+export { RLENarrativeFlowRecorder } from './narrative/recorders/RLENarrativeFlowRecorder';
+export { SeparateNarrativeFlowRecorder } from './narrative/recorders/SeparateNarrativeFlowRecorder';
+export { SilentNarrativeFlowRecorder } from './narrative/recorders/SilentNarrativeFlowRecorder';
+export { WindowedNarrativeFlowRecorder } from './narrative/recorders/WindowedNarrativeFlowRecorder';

package/dist/types/lib/engine/narrative/FlowRecorderDispatcher.d.ts

@@ -0,0 +1,38 @@
+/**
+ * FlowRecorderDispatcher — Fans out control flow events to N attached FlowRecorders.
+ *
+ * Implements IControlFlowNarrative so it can replace the single
+ * ControlFlowNarrativeGenerator in the traverser's HandlerDeps.
+ *
+ * Design mirrors ScopeFacade._invokeHook: iterate recorders, call optional
+ * hooks, swallow errors so a failing recorder never breaks execution.
+ *
+ * When no recorders are attached, every method is a fast no-op (empty array check).
+ */
+import type { FlowRecorder, IControlFlowNarrative } from './types';
+export declare class FlowRecorderDispatcher implements IControlFlowNarrative {
+    private recorders;
+    /** Attach a FlowRecorder. Duplicate IDs are allowed (same as scope Recorder). */
+    attach(recorder: FlowRecorder): void;
+    /** Detach all FlowRecorders with the given ID. */
+    detach(id: string): void;
+    /** Returns a defensive copy of attached recorders. */
+    getRecorders(): FlowRecorder[];
+    /** Find a recorder by ID. Useful for retrieving built-in recorders like NarrativeFlowRecorder. */
+    getRecorderById<T extends FlowRecorder = FlowRecorder>(id: string): T | undefined;
+    onStageExecuted(stageName: string, description?: string): void;
+    onNext(fromStage: string, toStage: string, description?: string): void;
+    onDecision(deciderName: string, chosenBranch: string, rationale?: string, deciderDescription?: string): void;
+    onFork(parentStage: string, childNames: string[]): void;
+    onSelected(parentStage: string, selectedNames: string[], totalCount: number): void;
+    onSubflowEntry(subflowName: string): void;
+    onSubflowExit(subflowName: string): void;
+    onLoop(targetStage: string, iteration: number, description?: string): void;
+    onBreak(stageName: string): void;
+    onError(stageName: string, errorMessage: string): void;
+    /**
+     * Returns sentences from the first attached recorder that provides them.
+     * By convention, NarrativeFlowRecorder exposes getSentences().
+     */
+    getSentences(): string[];
+}

package/dist/types/lib/engine/narrative/NarrativeFlowRecorder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * NarrativeFlowRecorder — Default FlowRecorder that generates plain-English narrative.
+ *
+ * This is the FlowRecorder equivalent of ControlFlowNarrativeGenerator.
+ * Produces the same sentences, same format, same behavior — but as a
+ * pluggable FlowRecorder that can be swapped, extended, or composed.
+ *
+ * Consumers who want different narrative behavior (windowed loops, adaptive
+ * summarization, etc.) can replace this with a different FlowRecorder.
+ */
+import type { FlowBreakEvent, FlowDecisionEvent, FlowErrorEvent, FlowForkEvent, FlowLoopEvent, FlowNextEvent, FlowRecorder, FlowSelectedEvent, FlowStageEvent, FlowSubflowEvent } from './types';
+export declare class NarrativeFlowRecorder implements FlowRecorder {
+    readonly id: string;
+    private sentences;
+    private isFirstStage;
+    constructor(id?: string);
+    onStageExecuted(event: FlowStageEvent): void;
+    onNext(event: FlowNextEvent): void;
+    onDecision(event: FlowDecisionEvent): void;
+    onFork(event: FlowForkEvent): void;
+    onSelected(event: FlowSelectedEvent): void;
+    onSubflowEntry(event: FlowSubflowEvent): void;
+    onSubflowExit(event: FlowSubflowEvent): void;
+    onLoop(event: FlowLoopEvent): void;
+    onBreak(event: FlowBreakEvent): void;
+    onError(event: FlowErrorEvent): void;
+    /** Returns a defensive copy of accumulated sentences. */
+    getSentences(): string[];
+    /** Clears accumulated sentences. Useful for reuse across runs. */
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/index.d.ts

@@ -3,3 +3,13 @@ export { CombinedNarrativeBuilder } from './CombinedNarrativeBuilder';
 export { ControlFlowNarrativeGenerator } from './ControlFlowNarrativeGenerator';
 export { NullControlFlowNarrativeGenerator } from './NullControlFlowNarrativeGenerator';
 export type { IControlFlowNarrative } from './types';
+export { FlowRecorderDispatcher } from './FlowRecorderDispatcher';
+export { NarrativeFlowRecorder } from './NarrativeFlowRecorder';
+export type { FlowBreakEvent, FlowDecisionEvent, FlowErrorEvent, FlowForkEvent, FlowLoopEvent, FlowNextEvent, FlowRecorder, FlowSelectedEvent, FlowStageEvent, FlowSubflowEvent, } from './types';
+export { AdaptiveNarrativeFlowRecorder } from './recorders/AdaptiveNarrativeFlowRecorder';
+export { MilestoneNarrativeFlowRecorder } from './recorders/MilestoneNarrativeFlowRecorder';
+export { ProgressiveNarrativeFlowRecorder } from './recorders/ProgressiveNarrativeFlowRecorder';
+export { RLENarrativeFlowRecorder } from './recorders/RLENarrativeFlowRecorder';
+export { SeparateNarrativeFlowRecorder } from './recorders/SeparateNarrativeFlowRecorder';
+export { SilentNarrativeFlowRecorder } from './recorders/SilentNarrativeFlowRecorder';
+export { WindowedNarrativeFlowRecorder } from './recorders/WindowedNarrativeFlowRecorder';

package/dist/types/lib/engine/narrative/recorders/AdaptiveNarrativeFlowRecorder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AdaptiveNarrativeFlowRecorder — Full detail until threshold, then samples every Nth.
+ *
+ * Best for: Unknown loop counts where you want full detail for short loops
+ * but automatic compression for long ones.
+ *
+ * @example
+ * ```typescript
+ * // Full detail for first 5, then every 10th iteration
+ * executor.attachFlowRecorder(new AdaptiveNarrativeFlowRecorder(5, 10));
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class AdaptiveNarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private readonly threshold;
+    private readonly sampleRate;
+    private totalPerTarget;
+    private suppressedCount;
+    constructor(threshold?: number, sampleRate?: number, id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    /** Returns the number of suppressed loop sentences. */
+    getSuppressedCount(): number;
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/recorders/MilestoneNarrativeFlowRecorder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MilestoneNarrativeFlowRecorder — Emits every Nth iteration (milestones only).
+ *
+ * Best for: High-iteration loops where you want regular progress markers
+ * without caring about individual iterations.
+ *
+ * @example
+ * ```typescript
+ * // Emit every 10th iteration
+ * executor.attachFlowRecorder(new MilestoneNarrativeFlowRecorder(10));
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class MilestoneNarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private readonly interval;
+    private readonly alwaysEmitFirst;
+    private suppressedCount;
+    constructor(interval?: number, alwaysEmitFirst?: boolean, id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    /** Returns the number of suppressed loop sentences. */
+    getSuppressedCount(): number;
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/recorders/ProgressiveNarrativeFlowRecorder.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ProgressiveNarrativeFlowRecorder — Exponentially decreasing detail as iterations grow.
+ *
+ * Emits at exponentially increasing intervals: 1, 2, 4, 8, 16, 32, ...
+ * Gives rich detail for early iterations and progressively less as the loop continues.
+ *
+ * Best for: Convergence-style loops (gradient descent, iterative refinement)
+ * where early iterations are most informative.
+ *
+ * @example
+ * ```typescript
+ * executor.attachFlowRecorder(new ProgressiveNarrativeFlowRecorder());
+ * // Emits: pass 1, 2, 4, 8, 16, 32, 64, 128...
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class ProgressiveNarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private readonly base;
+    private suppressedCount;
+    /**
+     * @param base - The exponential base. Default 2 means emit at 1, 2, 4, 8, 16...
+     */
+    constructor(base?: number, id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    private shouldEmit;
+    /** Returns the number of suppressed loop sentences. */
+    getSuppressedCount(): number;
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/recorders/RLENarrativeFlowRecorder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * RLENarrativeFlowRecorder — Run-Length Encoding for consecutive identical loop targets.
+ *
+ * Instead of emitting one sentence per iteration, collapses consecutive loops
+ * through the same target into a single "Looped N times through X" sentence.
+ *
+ * Best for: Simple retry loops where every iteration looks the same.
+ *
+ * @example
+ * ```typescript
+ * executor.attachFlowRecorder(new RLENarrativeFlowRecorder());
+ * // Instead of 50 "On pass N..." lines:
+ * // "Looped through AskLLM 50 times (passes 1–50)."
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class RLENarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private currentRun;
+    private completedRuns;
+    constructor(id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    getSentences(): string[];
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/recorders/SeparateNarrativeFlowRecorder.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SeparateNarrativeFlowRecorder — Collects loop iterations in a separate channel.
+ *
+ * Keeps the main narrative clean (no loop sentences) while preserving full
+ * iteration detail in a separate accessor for consumers who need it.
+ *
+ * Best for: UIs or reports where loop detail is in a collapsible section,
+ * or LLM pipelines where loop context should be available but not in the main prompt.
+ *
+ * @example
+ * ```typescript
+ * const recorder = new SeparateNarrativeFlowRecorder();
+ * executor.attachFlowRecorder(recorder);
+ * await executor.run();
+ *
+ * const mainNarrative = executor.getNarrative();     // No loop sentences
+ * const loopDetail = recorder.getLoopSentences();    // All loop detail
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class SeparateNarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private loopSentences;
+    private loopCounts;
+    constructor(id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    /** Returns all loop iteration sentences (the separate channel). */
+    getLoopSentences(): string[];
+    /** Returns total loop count per target. */
+    getLoopCounts(): Map<string, number>;
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/recorders/SilentNarrativeFlowRecorder.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SilentNarrativeFlowRecorder — Suppresses all per-iteration loop sentences,
+ * emits a single summary sentence at the end.
+ *
+ * Best for: Loops where iteration details are irrelevant and you only care
+ * about the total count.
+ *
+ * @example
+ * ```typescript
+ * executor.attachFlowRecorder(new SilentNarrativeFlowRecorder());
+ * // Produces: "Looped 50 times through AskLLM."
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class SilentNarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private loopCounts;
+    private loopOrder;
+    constructor(id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    getSentences(): string[];
+    /** Returns the total loop count per target. */
+    getLoopCounts(): Map<string, number>;
+    clear(): void;
+}

package/dist/types/lib/engine/narrative/recorders/WindowedNarrativeFlowRecorder.d.ts

@@ -0,0 +1,29 @@
+/**
+ * WindowedNarrativeFlowRecorder — Shows first N and last M loop iterations, skips the middle.
+ *
+ * Best for: Moderate loops (10–200 iterations) where you want to see how it started
+ * and how it ended, without the noise in between.
+ *
+ * When total iterations <= head + tail, all iterations are emitted (no compression).
+ * When total > head + tail, the middle is replaced with a summary line.
+ *
+ * @example
+ * ```typescript
+ * // Show first 3 and last 2 iterations
+ * executor.attachFlowRecorder(new WindowedNarrativeFlowRecorder(3, 2));
+ * ```
+ */
+import { NarrativeFlowRecorder } from '../NarrativeFlowRecorder';
+import type { FlowLoopEvent } from '../types';
+export declare class WindowedNarrativeFlowRecorder extends NarrativeFlowRecorder {
+    private readonly head;
+    private readonly tail;
+    private loopEvents;
+    constructor(head?: number, tail?: number, id?: string);
+    onLoop(event: FlowLoopEvent): void;
+    getSentences(): string[];
+    /** Returns the number of suppressed loop sentences. */
+    getSuppressedCount(): number;
+    clear(): void;
+    private formatLoopSentence;
+}

package/dist/types/lib/engine/narrative/recorders/index.d.ts

@@ -0,0 +1,7 @@
+export { AdaptiveNarrativeFlowRecorder } from './AdaptiveNarrativeFlowRecorder';
+export { MilestoneNarrativeFlowRecorder } from './MilestoneNarrativeFlowRecorder';
+export { ProgressiveNarrativeFlowRecorder } from './ProgressiveNarrativeFlowRecorder';
+export { RLENarrativeFlowRecorder } from './RLENarrativeFlowRecorder';
+export { SeparateNarrativeFlowRecorder } from './SeparateNarrativeFlowRecorder';
+export { SilentNarrativeFlowRecorder } from './SilentNarrativeFlowRecorder';
+export { WindowedNarrativeFlowRecorder } from './WindowedNarrativeFlowRecorder';