@decaf-ts/integrations 0.3.7 → 0.3.9

package/lib/esm/graph/engine/errors/GraphLoopLimitError.js

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/graph/errors/GraphLoopLimitError
+ * @summary Error thrown when a loop exceeds its maximum iterations.
+ * @description Raised by loop executors when the iteration count reaches the configured safety limit.
+ */
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * Thrown when a loop exceeds its maximum iterations.
+ */
+export class GraphLoopLimitError extends GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_LOOP_LIMIT_ERROR", details);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhMb29wTGltaXRFcnJvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9ncmFwaC9lbmdpbmUvZXJyb3JzL0dyYXBoTG9vcExpbWl0RXJyb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7R0FJRztBQUNILE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxpQ0FBOEI7QUFFNUQ7O0dBRUc7QUFDSCxNQUFNLE9BQU8sbUJBQW9CLFNBQVEsbUJBQW1CO0lBQzFELFlBQVksT0FBZSxFQUFFLE9BQWlCO1FBQzVDLEtBQUssQ0FBQyxPQUFPLEVBQUUsd0JBQXdCLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDcEQsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIGludGVncmF0aW9ucy9ncmFwaC9lcnJvcnMvR3JhcGhMb29wTGltaXRFcnJvclxuICogQHN1bW1hcnkgRXJyb3IgdGhyb3duIHdoZW4gYSBsb29wIGV4Y2VlZHMgaXRzIG1heGltdW0gaXRlcmF0aW9ucy5cbiAqIEBkZXNjcmlwdGlvbiBSYWlzZWQgYnkgbG9vcCBleGVjdXRvcnMgd2hlbiB0aGUgaXRlcmF0aW9uIGNvdW50IHJlYWNoZXMgdGhlIGNvbmZpZ3VyZWQgc2FmZXR5IGxpbWl0LlxuICovXG5pbXBvcnQgeyBHcmFwaEV4ZWN1dGlvbkVycm9yIH0gZnJvbSBcIi4vR3JhcGhFeGVjdXRpb25FcnJvclwiO1xuXG4vKipcbiAqIFRocm93biB3aGVuIGEgbG9vcCBleGNlZWRzIGl0cyBtYXhpbXVtIGl0ZXJhdGlvbnMuXG4gKi9cbmV4cG9ydCBjbGFzcyBHcmFwaExvb3BMaW1pdEVycm9yIGV4dGVuZHMgR3JhcGhFeGVjdXRpb25FcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2U6IHN0cmluZywgZGV0YWlscz86IHVua25vd24pIHtcbiAgICBzdXBlcihtZXNzYWdlLCBcIkdSQVBIX0xPT1BfTElNSVRfRVJST1JcIiwgZGV0YWlscyk7XG4gIH1cbn1cbiJdfQ==

package/lib/esm/graph/engine/errors/GraphPinningError.js

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/graph/errors/GraphPinningError
+ * @summary Error thrown when a pinning operation fails.
+ * @description Raised when a node cannot be pinned, e.g. because an upstream dependency is not pinnable.
+ */
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * Thrown when a pinning operation fails.
+ */
+export class GraphPinningError extends GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_PINNING_ERROR", details);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhQaW5uaW5nRXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2Vycm9ycy9HcmFwaFBpbm5pbmdFcnJvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLG1CQUFtQixFQUFFLGlDQUE4QjtBQUU1RDs7R0FFRztBQUNILE1BQU0sT0FBTyxpQkFBa0IsU0FBUSxtQkFBbUI7SUFDeEQsWUFBWSxPQUFlLEVBQUUsT0FBaUI7UUFDNUMsS0FBSyxDQUFDLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNqRCxDQUFDO0NBQ0YiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL2dyYXBoL2Vycm9ycy9HcmFwaFBpbm5pbmdFcnJvclxuICogQHN1bW1hcnkgRXJyb3IgdGhyb3duIHdoZW4gYSBwaW5uaW5nIG9wZXJhdGlvbiBmYWlscy5cbiAqIEBkZXNjcmlwdGlvbiBSYWlzZWQgd2hlbiBhIG5vZGUgY2Fubm90IGJlIHBpbm5lZCwgZS5nLiBiZWNhdXNlIGFuIHVwc3RyZWFtIGRlcGVuZGVuY3kgaXMgbm90IHBpbm5hYmxlLlxuICovXG5pbXBvcnQgeyBHcmFwaEV4ZWN1dGlvbkVycm9yIH0gZnJvbSBcIi4vR3JhcGhFeGVjdXRpb25FcnJvclwiO1xuXG4vKipcbiAqIFRocm93biB3aGVuIGEgcGlubmluZyBvcGVyYXRpb24gZmFpbHMuXG4gKi9cbmV4cG9ydCBjbGFzcyBHcmFwaFBpbm5pbmdFcnJvciBleHRlbmRzIEdyYXBoRXhlY3V0aW9uRXJyb3Ige1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcsIGRldGFpbHM/OiB1bmtub3duKSB7XG4gICAgc3VwZXIobWVzc2FnZSwgXCJHUkFQSF9QSU5OSU5HX0VSUk9SXCIsIGRldGFpbHMpO1xuICB9XG59XG4iXX0=

package/lib/esm/graph/engine/errors/GraphPortError.js

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/graph/errors/GraphPortError
+ * @summary Error thrown when a port reference is invalid.
+ * @description Raised by the relation resolver or validator when a referenced port is missing or unknown.
+ */
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * Thrown when a port reference is invalid.
+ */
+export class GraphPortError extends GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_PORT_ERROR", details);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhQb3J0RXJyb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2Vycm9ycy9HcmFwaFBvcnRFcnJvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLG1CQUFtQixFQUFFLGlDQUE4QjtBQUU1RDs7R0FFRztBQUNILE1BQU0sT0FBTyxjQUFlLFNBQVEsbUJBQW1CO0lBQ3JELFlBQVksT0FBZSxFQUFFLE9BQWlCO1FBQzVDLEtBQUssQ0FBQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDOUMsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIGludGVncmF0aW9ucy9ncmFwaC9lcnJvcnMvR3JhcGhQb3J0RXJyb3JcbiAqIEBzdW1tYXJ5IEVycm9yIHRocm93biB3aGVuIGEgcG9ydCByZWZlcmVuY2UgaXMgaW52YWxpZC5cbiAqIEBkZXNjcmlwdGlvbiBSYWlzZWQgYnkgdGhlIHJlbGF0aW9uIHJlc29sdmVyIG9yIHZhbGlkYXRvciB3aGVuIGEgcmVmZXJlbmNlZCBwb3J0IGlzIG1pc3Npbmcgb3IgdW5rbm93bi5cbiAqL1xuaW1wb3J0IHsgR3JhcGhFeGVjdXRpb25FcnJvciB9IGZyb20gXCIuL0dyYXBoRXhlY3V0aW9uRXJyb3JcIjtcblxuLyoqXG4gKiBUaHJvd24gd2hlbiBhIHBvcnQgcmVmZXJlbmNlIGlzIGludmFsaWQuXG4gKi9cbmV4cG9ydCBjbGFzcyBHcmFwaFBvcnRFcnJvciBleHRlbmRzIEdyYXBoRXhlY3V0aW9uRXJyb3Ige1xuICBjb25zdHJ1Y3RvcihtZXNzYWdlOiBzdHJpbmcsIGRldGFpbHM/OiB1bmtub3duKSB7XG4gICAgc3VwZXIobWVzc2FnZSwgXCJHUkFQSF9QT1JUX0VSUk9SXCIsIGRldGFpbHMpO1xuICB9XG59XG4iXX0=

package/lib/esm/graph/engine/errors/GraphStoreError.js

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/graph/errors/GraphStoreError
+ * @summary Error thrown when a value store operation fails.
+ * @description Raised by the value store or adapter when reading, writing, or deleting cached values fails.
+ */
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * Thrown when a value store operation fails.
+ */
+export class GraphStoreError extends GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_STORE_ERROR", details);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhTdG9yZUVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2dyYXBoL2VuZ2luZS9lcnJvcnMvR3JhcGhTdG9yZUVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsaUNBQThCO0FBRTVEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGVBQWdCLFNBQVEsbUJBQW1CO0lBQ3RELFlBQVksT0FBZSxFQUFFLE9BQWlCO1FBQzVDLEtBQUssQ0FBQyxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDL0MsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIGludGVncmF0aW9ucy9ncmFwaC9lcnJvcnMvR3JhcGhTdG9yZUVycm9yXG4gKiBAc3VtbWFyeSBFcnJvciB0aHJvd24gd2hlbiBhIHZhbHVlIHN0b3JlIG9wZXJhdGlvbiBmYWlscy5cbiAqIEBkZXNjcmlwdGlvbiBSYWlzZWQgYnkgdGhlIHZhbHVlIHN0b3JlIG9yIGFkYXB0ZXIgd2hlbiByZWFkaW5nLCB3cml0aW5nLCBvciBkZWxldGluZyBjYWNoZWQgdmFsdWVzIGZhaWxzLlxuICovXG5pbXBvcnQgeyBHcmFwaEV4ZWN1dGlvbkVycm9yIH0gZnJvbSBcIi4vR3JhcGhFeGVjdXRpb25FcnJvclwiO1xuXG4vKipcbiAqIFRocm93biB3aGVuIGEgdmFsdWUgc3RvcmUgb3BlcmF0aW9uIGZhaWxzLlxuICovXG5leHBvcnQgY2xhc3MgR3JhcGhTdG9yZUVycm9yIGV4dGVuZHMgR3JhcGhFeGVjdXRpb25FcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2U6IHN0cmluZywgZGV0YWlscz86IHVua25vd24pIHtcbiAgICBzdXBlcihtZXNzYWdlLCBcIkdSQVBIX1NUT1JFX0VSUk9SXCIsIGRldGFpbHMpO1xuICB9XG59XG4iXX0=

package/lib/esm/graph/engine/errors/GraphTopologyError.js

@@ -0,0 +1,15 @@
+/**
+ * @module integrations/graph/errors/GraphTopologyError
+ * @summary Error thrown when workflow topology is invalid.
+ * @description Raised by the relation resolver or planner when an endpoint is unknown or ambiguous.
+ */
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * Thrown when workflow topology is invalid.
+ */
+export class GraphTopologyError extends GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_TOPOLOGY_ERROR", details);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhUb3BvbG9neUVycm9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2dyYXBoL2VuZ2luZS9lcnJvcnMvR3JhcGhUb3BvbG9neUVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsaUNBQThCO0FBRTVEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGtCQUFtQixTQUFRLG1CQUFtQjtJQUN6RCxZQUFZLE9BQWUsRUFBRSxPQUFpQjtRQUM1QyxLQUFLLENBQUMsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ2xELENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvZ3JhcGgvZXJyb3JzL0dyYXBoVG9wb2xvZ3lFcnJvclxuICogQHN1bW1hcnkgRXJyb3IgdGhyb3duIHdoZW4gd29ya2Zsb3cgdG9wb2xvZ3kgaXMgaW52YWxpZC5cbiAqIEBkZXNjcmlwdGlvbiBSYWlzZWQgYnkgdGhlIHJlbGF0aW9uIHJlc29sdmVyIG9yIHBsYW5uZXIgd2hlbiBhbiBlbmRwb2ludCBpcyB1bmtub3duIG9yIGFtYmlndW91cy5cbiAqL1xuaW1wb3J0IHsgR3JhcGhFeGVjdXRpb25FcnJvciB9IGZyb20gXCIuL0dyYXBoRXhlY3V0aW9uRXJyb3JcIjtcblxuLyoqXG4gKiBUaHJvd24gd2hlbiB3b3JrZmxvdyB0b3BvbG9neSBpcyBpbnZhbGlkLlxuICovXG5leHBvcnQgY2xhc3MgR3JhcGhUb3BvbG9neUVycm9yIGV4dGVuZHMgR3JhcGhFeGVjdXRpb25FcnJvciB7XG4gIGNvbnN0cnVjdG9yKG1lc3NhZ2U6IHN0cmluZywgZGV0YWlscz86IHVua25vd24pIHtcbiAgICBzdXBlcihtZXNzYWdlLCBcIkdSQVBIX1RPUE9MT0dZX0VSUk9SXCIsIGRldGFpbHMpO1xuICB9XG59XG4iXX0=

package/lib/esm/graph/engine/errors/index.js

@@ -0,0 +1,14 @@
+/**
+ * @module integrations/graph/errors
+ * @summary Graph execution error classes.
+ * @description Re-exports all structured error types used by the graph execution engine.
+ */
+export * from "./GraphExecutionError.js";
+export * from "./GraphCycleError.js";
+export * from "./GraphInputError.js";
+export * from "./GraphLoopLimitError.js";
+export * from "./GraphPinningError.js";
+export * from "./GraphPortError.js";
+export * from "./GraphStoreError.js";
+export * from "./GraphTopologyError.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2Vycm9ycy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gseUNBQXNDO0FBQ3RDLHFDQUFrQztBQUNsQyxxQ0FBa0M7QUFDbEMseUNBQXNDO0FBQ3RDLHVDQUFvQztBQUNwQyxvQ0FBaUM7QUFDakMscUNBQWtDO0FBQ2xDLHdDQUFxQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvZ3JhcGgvZXJyb3JzXG4gKiBAc3VtbWFyeSBHcmFwaCBleGVjdXRpb24gZXJyb3IgY2xhc3Nlcy5cbiAqIEBkZXNjcmlwdGlvbiBSZS1leHBvcnRzIGFsbCBzdHJ1Y3R1cmVkIGVycm9yIHR5cGVzIHVzZWQgYnkgdGhlIGdyYXBoIGV4ZWN1dGlvbiBlbmdpbmUuXG4gKi9cbmV4cG9ydCAqIGZyb20gXCIuL0dyYXBoRXhlY3V0aW9uRXJyb3JcIjtcbmV4cG9ydCAqIGZyb20gXCIuL0dyYXBoQ3ljbGVFcnJvclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vR3JhcGhJbnB1dEVycm9yXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9HcmFwaExvb3BMaW1pdEVycm9yXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9HcmFwaFBpbm5pbmdFcnJvclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vR3JhcGhQb3J0RXJyb3JcIjtcbmV4cG9ydCAqIGZyb20gXCIuL0dyYXBoU3RvcmVFcnJvclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vR3JhcGhUb3BvbG9neUVycm9yXCI7XG4iXX0=

package/lib/esm/graph/engine/events/GraphExecutionEvent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhFeGVjdXRpb25FdmVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9ncmFwaC9lbmdpbmUvZXZlbnRzL0dyYXBoRXhlY3V0aW9uRXZlbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvZ3JhcGgvZXZlbnRzL0dyYXBoRXhlY3V0aW9uRXZlbnRcbiAqIEBzdW1tYXJ5IFJlLWV4cG9ydCBvZiB0aGUgR3JhcGhFeGVjdXRpb25FdmVudCB0eXBlIGZvciB0aGUgZXZlbnRzIHN1YnBhdGguXG4gKiBAZGVzY3JpcHRpb24gVGhlIEdyYXBoRXhlY3V0aW9uRXZlbnQgaW50ZXJmYWNlIGlzIGRlZmluZWQgaW4gdGhlIHNoYXJlZCB0eXBlcyBtb2R1bGUgYW5kIHJlLWV4cG9ydGVkIGhlcmUgZm9yIGNvbnZlbmllbmNlLlxuICovXG5leHBvcnQgdHlwZSB7IEdyYXBoRXhlY3V0aW9uRXZlbnQgfSBmcm9tIFwiLi4vdHlwZXNcIjtcbiJdfQ==

package/lib/esm/graph/engine/events/GraphExecutionEventEmitter.js

@@ -0,0 +1,35 @@
+/**
+ * Manages observer registration and event dispatch for the graph execution
+ * engine.
+ */
+export class GraphExecutionEventEmitter {
+    constructor() {
+        this.observers = new Set();
+    }
+    /** Registers an observer and returns an unsubscribe function. */
+    observe(observer) {
+        this.observers.add(observer);
+        return () => this.unObserve(observer);
+    }
+    /** Removes a previously-registered observer. */
+    unObserve(observer) {
+        this.observers.delete(observer);
+    }
+    /**
+     * Notifies all registered observers of a new event.
+     *
+     * Observer failures are caught and swallowed so that a misbehaving observer
+     * cannot crash the workflow execution.
+     */
+    async updateObservers(event) {
+        await Promise.all(Array.from(this.observers).map(async (observer) => {
+            try {
+                await Promise.resolve(observer.refresh(event));
+            }
+            catch {
+                // Observer failures must not crash execution.
+            }
+        }));
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhFeGVjdXRpb25FdmVudEVtaXR0ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2V2ZW50cy9HcmFwaEV4ZWN1dGlvbkV2ZW50RW1pdHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFTQTs7O0dBR0c7QUFDSCxNQUFNLE9BQU8sMEJBQTBCO0lBQXZDO1FBRW1CLGNBQVMsR0FBRyxJQUFJLEdBQUcsRUFBMEIsQ0FBQztJQThCakUsQ0FBQztJQTVCQyxpRUFBaUU7SUFDakUsT0FBTyxDQUFDLFFBQWdDO1FBQ3RDLElBQUksQ0FBQyxTQUFTLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQzdCLE9BQU8sR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUN4QyxDQUFDO0lBRUQsZ0RBQWdEO0lBQ2hELFNBQVMsQ0FBQyxRQUFnQztRQUN4QyxJQUFJLENBQUMsU0FBUyxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsQ0FBQztJQUNsQyxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxLQUFLLENBQUMsZUFBZSxDQUFDLEtBQTBCO1FBQzlDLE1BQU0sT0FBTyxDQUFDLEdBQUcsQ0FDZixLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLFFBQVEsRUFBRSxFQUFFO1lBQ2hELElBQUksQ0FBQztnQkFDSCxNQUFNLE9BQU8sQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1lBQ2pELENBQUM7WUFBQyxNQUFNLENBQUM7Z0JBQ1AsOENBQThDO1lBQ2hELENBQUM7UUFDSCxDQUFDLENBQUMsQ0FDSCxDQUFDO0lBQ0osQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIGludGVncmF0aW9ucy9ncmFwaC9ldmVudHMvR3JhcGhFeGVjdXRpb25FdmVudEVtaXR0ZXJcbiAqIEBzdW1tYXJ5IE9ic2VydmFibGUgaW1wbGVtZW50YXRpb24gZm9yIGdyYXBoIGV4ZWN1dGlvbiBldmVudHMuXG4gKiBAZGVzY3JpcHRpb24gSW1wbGVtZW50cyBEZWNhZidzIHtAbGluayBPYnNlcnZhYmxlfSBpbnRlcmZhY2Ugc28gb2JzZXJ2ZXJzIGNhbiBzdWJzY3JpYmUgdG8gZ3JhcGggZXhlY3V0aW9uIGV2ZW50cy4gT2JzZXJ2ZXIgZmFpbHVyZXMgYXJlIGlzb2xhdGVkIGFuZCBkbyBub3QgY3Jhc2ggdGhlIHdvcmtmbG93LlxuICovXG5pbXBvcnQgdHlwZSB7IE9ic2VydmFibGUgfSBmcm9tIFwiQGRlY2FmLXRzL2NvcmVcIjtcbmltcG9ydCB0eXBlIHsgR3JhcGhFeGVjdXRpb25PYnNlcnZlciB9IGZyb20gXCIuL0dyYXBoRXhlY3V0aW9uT2JzZXJ2ZXJcIjtcbmltcG9ydCB0eXBlIHsgR3JhcGhFeGVjdXRpb25FdmVudCB9IGZyb20gXCIuLi90eXBlc1wiO1xuXG4vKipcbiAqIE1hbmFnZXMgb2JzZXJ2ZXIgcmVnaXN0cmF0aW9uIGFuZCBldmVudCBkaXNwYXRjaCBmb3IgdGhlIGdyYXBoIGV4ZWN1dGlvblxuICogZW5naW5lLlxuICovXG5leHBvcnQgY2xhc3MgR3JhcGhFeGVjdXRpb25FdmVudEVtaXR0ZXJcbiAgaW1wbGVtZW50cyBPYnNlcnZhYmxlPFtHcmFwaEV4ZWN1dGlvbk9ic2VydmVyXSwgW0dyYXBoRXhlY3V0aW9uRXZlbnRdPiB7XG4gIHByaXZhdGUgcmVhZG9ubHkgb2JzZXJ2ZXJzID0gbmV3IFNldDxHcmFwaEV4ZWN1dGlvbk9ic2VydmVyPigpO1xuXG4gIC8qKiBSZWdpc3RlcnMgYW4gb2JzZXJ2ZXIgYW5kIHJldHVybnMgYW4gdW5zdWJzY3JpYmUgZnVuY3Rpb24uICovXG4gIG9ic2VydmUob2JzZXJ2ZXI6IEdyYXBoRXhlY3V0aW9uT2JzZXJ2ZXIpOiAoKSA9PiB2b2lkIHtcbiAgICB0aGlzLm9ic2VydmVycy5hZGQob2JzZXJ2ZXIpO1xuICAgIHJldHVybiAoKSA9PiB0aGlzLnVuT2JzZXJ2ZShvYnNlcnZlcik7XG4gIH1cblxuICAvKiogUmVtb3ZlcyBhIHByZXZpb3VzbHktcmVnaXN0ZXJlZCBvYnNlcnZlci4gKi9cbiAgdW5PYnNlcnZlKG9ic2VydmVyOiBHcmFwaEV4ZWN1dGlvbk9ic2VydmVyKTogdm9pZCB7XG4gICAgdGhpcy5vYnNlcnZlcnMuZGVsZXRlKG9ic2VydmVyKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBOb3RpZmllcyBhbGwgcmVnaXN0ZXJlZCBvYnNlcnZlcnMgb2YgYSBuZXcgZXZlbnQuXG4gICAqXG4gICAqIE9ic2VydmVyIGZhaWx1cmVzIGFyZSBjYXVnaHQgYW5kIHN3YWxsb3dlZCBzbyB0aGF0IGEgbWlzYmVoYXZpbmcgb2JzZXJ2ZXJcbiAgICogY2Fubm90IGNyYXNoIHRoZSB3b3JrZmxvdyBleGVjdXRpb24uXG4gICAqL1xuICBhc3luYyB1cGRhdGVPYnNlcnZlcnMoZXZlbnQ6IEdyYXBoRXhlY3V0aW9uRXZlbnQpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBhd2FpdCBQcm9taXNlLmFsbChcbiAgICAgIEFycmF5LmZyb20odGhpcy5vYnNlcnZlcnMpLm1hcChhc3luYyAob2JzZXJ2ZXIpID0+IHtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICBhd2FpdCBQcm9taXNlLnJlc29sdmUob2JzZXJ2ZXIucmVmcmVzaChldmVudCkpO1xuICAgICAgICB9IGNhdGNoIHtcbiAgICAgICAgICAvLyBPYnNlcnZlciBmYWlsdXJlcyBtdXN0IG5vdCBjcmFzaCBleGVjdXRpb24uXG4gICAgICAgIH1cbiAgICAgIH0pXG4gICAgKTtcbiAgfVxufVxuIl19

package/lib/esm/graph/engine/events/GraphExecutionEventFactory.js

@@ -0,0 +1,32 @@
+/**
+ * Factory that enriches partial events with a unique id, an incrementing
+ * sequence number, and a timestamp.
+ */
+export class GraphExecutionEventFactory {
+    constructor() {
+        this.sequence = 0;
+    }
+    /**
+     * Creates a fully-populated event from the given base fields.
+     *
+     * @param base - All event fields except `id`, `sequence`, and `timestamp`.
+     * @returns A complete {@link GraphExecutionEvent}.
+     */
+    create(base) {
+        return {
+            ...base,
+            id: this.createEventId(),
+            sequence: ++this.sequence,
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Generates a unique event id using `crypto.randomUUID` when available,
+     * falling back to a timestamp + random string.
+     */
+    createEventId() {
+        return (globalThis.crypto?.randomUUID?.() ??
+            `${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhFeGVjdXRpb25FdmVudEZhY3RvcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2V2ZW50cy9HcmFwaEV4ZWN1dGlvbkV2ZW50RmFjdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFPQTs7O0dBR0c7QUFDSCxNQUFNLE9BQU8sMEJBQTBCO0lBQXZDO1FBQ1UsYUFBUSxHQUFHLENBQUMsQ0FBQztJQTZCdkIsQ0FBQztJQTNCQzs7Ozs7T0FLRztJQUNILE1BQU0sQ0FDSixJQUFnRTtRQUVoRSxPQUFPO1lBQ0wsR0FBRyxJQUFJO1lBQ1AsRUFBRSxFQUFFLElBQUksQ0FBQyxhQUFhLEVBQUU7WUFDeEIsUUFBUSxFQUFFLEVBQUUsSUFBSSxDQUFDLFFBQVE7WUFDekIsU0FBUyxFQUFFLElBQUksSUFBSSxFQUFFO1NBQ3RCLENBQUM7SUFDSixDQUFDO0lBRUQ7OztPQUdHO0lBQ0ssYUFBYTtRQUNuQixPQUFPLENBQ0wsVUFBVSxDQUFDLE1BQU0sRUFBRSxVQUFVLEVBQUUsRUFBRTtZQUNqQyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsSUFBSSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUN2RCxDQUFDO0lBQ0osQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIGludGVncmF0aW9ucy9ncmFwaC9ldmVudHMvR3JhcGhFeGVjdXRpb25FdmVudEZhY3RvcnlcbiAqIEBzdW1tYXJ5IEZhY3RvcnkgZm9yIGNyZWF0aW5nIGdyYXBoIGV4ZWN1dGlvbiBldmVudHMgd2l0aCB1bmlxdWUgaWRzLCBzZXF1ZW5jZSBudW1iZXJzLCBhbmQgdGltZXN0YW1wcy5cbiAqIEBkZXNjcmlwdGlvbiBQcm92aWRlcyBhIHN0YXRlZnVsIGZhY3RvcnkgdGhhdCBwcm9kdWNlcyBtb25vdG9uaWNhbGx5LXNlcXVlbmNlZCBldmVudHMgZm9yIGEgc2luZ2xlIGV4ZWN1dGlvbiBydW4uXG4gKi9cbmltcG9ydCB0eXBlIHsgR3JhcGhFeGVjdXRpb25FdmVudCB9IGZyb20gXCIuLi90eXBlc1wiO1xuXG4vKipcbiAqIEZhY3RvcnkgdGhhdCBlbnJpY2hlcyBwYXJ0aWFsIGV2ZW50cyB3aXRoIGEgdW5pcXVlIGlkLCBhbiBpbmNyZW1lbnRpbmdcbiAqIHNlcXVlbmNlIG51bWJlciwgYW5kIGEgdGltZXN0YW1wLlxuICovXG5leHBvcnQgY2xhc3MgR3JhcGhFeGVjdXRpb25FdmVudEZhY3Rvcnkge1xuICBwcml2YXRlIHNlcXVlbmNlID0gMDtcblxuICAvKipcbiAgICogQ3JlYXRlcyBhIGZ1bGx5LXBvcHVsYXRlZCBldmVudCBmcm9tIHRoZSBnaXZlbiBiYXNlIGZpZWxkcy5cbiAgICpcbiAgICogQHBhcmFtIGJhc2UgLSBBbGwgZXZlbnQgZmllbGRzIGV4Y2VwdCBgaWRgLCBgc2VxdWVuY2VgLCBhbmQgYHRpbWVzdGFtcGAuXG4gICAqIEByZXR1cm5zIEEgY29tcGxldGUge0BsaW5rIEdyYXBoRXhlY3V0aW9uRXZlbnR9LlxuICAgKi9cbiAgY3JlYXRlKFxuICAgIGJhc2U6IE9taXQ8R3JhcGhFeGVjdXRpb25FdmVudCwgXCJpZFwiIHwgXCJzZXF1ZW5jZVwiIHwgXCJ0aW1lc3RhbXBcIj5cbiAgKTogR3JhcGhFeGVjdXRpb25FdmVudCB7XG4gICAgcmV0dXJuIHtcbiAgICAgIC4uLmJhc2UsXG4gICAgICBpZDogdGhpcy5jcmVhdGVFdmVudElkKCksXG4gICAgICBzZXF1ZW5jZTogKyt0aGlzLnNlcXVlbmNlLFxuICAgICAgdGltZXN0YW1wOiBuZXcgRGF0ZSgpLFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogR2VuZXJhdGVzIGEgdW5pcXVlIGV2ZW50IGlkIHVzaW5nIGBjcnlwdG8ucmFuZG9tVVVJRGAgd2hlbiBhdmFpbGFibGUsXG4gICAqIGZhbGxpbmcgYmFjayB0byBhIHRpbWVzdGFtcCArIHJhbmRvbSBzdHJpbmcuXG4gICAqL1xuICBwcml2YXRlIGNyZWF0ZUV2ZW50SWQoKTogc3RyaW5nIHtcbiAgICByZXR1cm4gKFxuICAgICAgZ2xvYmFsVGhpcy5jcnlwdG8/LnJhbmRvbVVVSUQ/LigpID8/XG4gICAgICBgJHtEYXRlLm5vdygpfS0ke01hdGgucmFuZG9tKCkudG9TdHJpbmcoMzYpLnNsaWNlKDIpfWBcbiAgICApO1xuICB9XG59XG4iXX0=

package/lib/esm/graph/engine/events/GraphExecutionObserver.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhFeGVjdXRpb25PYnNlcnZlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9ncmFwaC9lbmdpbmUvZXZlbnRzL0dyYXBoRXhlY3V0aW9uT2JzZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvZ3JhcGgvZXZlbnRzL0dyYXBoRXhlY3V0aW9uT2JzZXJ2ZXJcbiAqIEBzdW1tYXJ5IE9ic2VydmVyIGludGVyZmFjZSBmb3IgZ3JhcGggZXhlY3V0aW9uIGV2ZW50cy5cbiAqIEBkZXNjcmlwdGlvbiBFeHRlbmRzIERlY2FmJ3Mge0BsaW5rIE9ic2VydmVyfSBzbyBncmFwaCBldmVudHMgZmxvdyB0aHJvdWdoIHRoZSBzdGFuZGFyZCBPYnNlcnZhYmxlL09ic2VydmVyIHBpcGVsaW5lLlxuICovXG5pbXBvcnQgdHlwZSB7IE9ic2VydmVyIH0gZnJvbSBcIkBkZWNhZi10cy9jb3JlXCI7XG5pbXBvcnQgdHlwZSB7IEdyYXBoRXhlY3V0aW9uRXZlbnQgfSBmcm9tIFwiLi4vdHlwZXNcIjtcblxuLyoqXG4gKiBPYnNlcnZlciB0aGF0IHJlY2VpdmVzIHtAbGluayBHcmFwaEV4ZWN1dGlvbkV2ZW50fSBpbnN0YW5jZXMgZnJvbSB0aGVcbiAqIGdyYXBoIGV4ZWN1dGlvbiBlbmdpbmUuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR3JhcGhFeGVjdXRpb25PYnNlcnZlciBleHRlbmRzIE9ic2VydmVyPFtHcmFwaEV4ZWN1dGlvbkV2ZW50XT4ge1xuICAvKipcbiAgICogQ2FsbGVkIGJ5IHRoZSBlbmdpbmUgd2hlbiBhIG5ldyBncmFwaCBleGVjdXRpb24gZXZlbnQgaXMgZW1pdHRlZC5cbiAgICovXG4gIHJlZnJlc2goZXZlbnQ6IEdyYXBoRXhlY3V0aW9uRXZlbnQpOiBQcm9taXNlPHZvaWQ+O1xufVxuIl19

package/lib/esm/graph/engine/events/index.js

@@ -0,0 +1,10 @@
+/**
+ * @module integrations/graph/events
+ * @summary Graph execution event pipeline.
+ * @description Re-exports the observer interface, event emitter, and event factory.
+ */
+export * from "./GraphExecutionEvent.js";
+export * from "./GraphExecutionObserver.js";
+export * from "./GraphExecutionEventEmitter.js";
+export * from "./GraphExecutionEventFactory.js";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2V2ZW50cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7OztHQUlHO0FBQ0gseUNBQXNDO0FBQ3RDLDRDQUF5QztBQUN6QyxnREFBNkM7QUFDN0MsZ0RBQTZDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAbW9kdWxlIGludGVncmF0aW9ucy9ncmFwaC9ldmVudHNcbiAqIEBzdW1tYXJ5IEdyYXBoIGV4ZWN1dGlvbiBldmVudCBwaXBlbGluZS5cbiAqIEBkZXNjcmlwdGlvbiBSZS1leHBvcnRzIHRoZSBvYnNlcnZlciBpbnRlcmZhY2UsIGV2ZW50IGVtaXR0ZXIsIGFuZCBldmVudCBmYWN0b3J5LlxuICovXG5leHBvcnQgKiBmcm9tIFwiLi9HcmFwaEV4ZWN1dGlvbkV2ZW50XCI7XG5leHBvcnQgKiBmcm9tIFwiLi9HcmFwaEV4ZWN1dGlvbk9ic2VydmVyXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9HcmFwaEV4ZWN1dGlvbkV2ZW50RW1pdHRlclwiO1xuZXhwb3J0ICogZnJvbSBcIi4vR3JhcGhFeGVjdXRpb25FdmVudEZhY3RvcnlcIjtcbiJdfQ==

package/lib/esm/graph/engine/execution/CodeSandboxEvaluator.js

@@ -0,0 +1,18 @@
+/**
+ * @module integrations/graph/execution/CodeSandboxEvaluator
+ * @summary Pluggable contract for evaluating code-based conditions (DECAF-32 §22.4).
+ * @description The engine does NOT implement the VM sandbox directly (§22.4).
+ * Downstream projects (e.g. ALFRED) register a `CodeSandboxEvaluator` via the
+ * `GraphExecutionEngineConfig.codeSandboxEvaluator` field. When absent, code
+ * conditions throw a `GRAPH_CODE_SANDBOX_NOT_CONFIGURED` error.
+ *
+ * The sandbox must follow the same restrictions as the Code Node (§22.4):
+ * - No system API access (`require`, `process`, `fs`, `child_process`, etc.)
+ * - Placeholder syntax for workflow data references (`{{ $input.foo }}`,
+ *   `{{ $node["Name"].output }}`, `{{ $vars.bar }}`, etc.)
+ * - Static code validation (e.g. `acorn`-based) before execution
+ * - The code must return a boolean value (for conditions) or any value
+ *   (for Code Node transforms)
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQ29kZVNhbmRib3hFdmFsdWF0b3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi9zcmMvZ3JhcGgvZW5naW5lL2V4ZWN1dGlvbi9Db2RlU2FuZGJveEV2YWx1YXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7O0dBZUciLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBtb2R1bGUgaW50ZWdyYXRpb25zL2dyYXBoL2V4ZWN1dGlvbi9Db2RlU2FuZGJveEV2YWx1YXRvclxuICogQHN1bW1hcnkgUGx1Z2dhYmxlIGNvbnRyYWN0IGZvciBldmFsdWF0aW5nIGNvZGUtYmFzZWQgY29uZGl0aW9ucyAoREVDQUYtMzIgwqcyMi40KS5cbiAqIEBkZXNjcmlwdGlvbiBUaGUgZW5naW5lIGRvZXMgTk9UIGltcGxlbWVudCB0aGUgVk0gc2FuZGJveCBkaXJlY3RseSAowqcyMi40KS5cbiAqIERvd25zdHJlYW0gcHJvamVjdHMgKGUuZy4gQUxGUkVEKSByZWdpc3RlciBhIGBDb2RlU2FuZGJveEV2YWx1YXRvcmAgdmlhIHRoZVxuICogYEdyYXBoRXhlY3V0aW9uRW5naW5lQ29uZmlnLmNvZGVTYW5kYm94RXZhbHVhdG9yYCBmaWVsZC4gV2hlbiBhYnNlbnQsIGNvZGVcbiAqIGNvbmRpdGlvbnMgdGhyb3cgYSBgR1JBUEhfQ09ERV9TQU5EQk9YX05PVF9DT05GSUdVUkVEYCBlcnJvci5cbiAqXG4gKiBUaGUgc2FuZGJveCBtdXN0IGZvbGxvdyB0aGUgc2FtZSByZXN0cmljdGlvbnMgYXMgdGhlIENvZGUgTm9kZSAowqcyMi40KTpcbiAqIC0gTm8gc3lzdGVtIEFQSSBhY2Nlc3MgKGByZXF1aXJlYCwgYHByb2Nlc3NgLCBgZnNgLCBgY2hpbGRfcHJvY2Vzc2AsIGV0Yy4pXG4gKiAtIFBsYWNlaG9sZGVyIHN5bnRheCBmb3Igd29ya2Zsb3cgZGF0YSByZWZlcmVuY2VzIChge3sgJGlucHV0LmZvbyB9fWAsXG4gKiAgIGB7eyAkbm9kZVtcIk5hbWVcIl0ub3V0cHV0IH19YCwgYHt7ICR2YXJzLmJhciB9fWAsIGV0Yy4pXG4gKiAtIFN0YXRpYyBjb2RlIHZhbGlkYXRpb24gKGUuZy4gYGFjb3JuYC1iYXNlZCkgYmVmb3JlIGV4ZWN1dGlvblxuICogLSBUaGUgY29kZSBtdXN0IHJldHVybiBhIGJvb2xlYW4gdmFsdWUgKGZvciBjb25kaXRpb25zKSBvciBhbnkgdmFsdWVcbiAqICAgKGZvciBDb2RlIE5vZGUgdHJhbnNmb3JtcylcbiAqL1xuXG4vKipcbiAqIENvbnRleHQgcGFzc2VkIHRvIHRoZSBjb2RlIHNhbmRib3ggZXZhbHVhdG9yLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIENvZGVTYW5kYm94Q29udGV4dCB7XG4gIC8qKiBUaGUgcmF3IGNvZGUgc3RyaW5nIGF1dGhvcmVkIGJ5IHRoZSB1c2VyLiAqL1xuICBjb2RlOiBzdHJpbmc7XG4gIC8qKiBUaGUgcHJvZ3JhbW1pbmcgbGFuZ3VhZ2UgKGRlZmF1bHRzIHRvIGBcImphdmFzY3JpcHRcImApLiAqL1xuICBsYW5ndWFnZT86IFwiamF2YXNjcmlwdFwiIHwgXCJ0eXBlc2NyaXB0XCI7XG4gIC8qKiBUaGUgY3VycmVudCBpbnB1dCB2YWx1ZXMsIGFjY2Vzc2libGUgYXMgYCRpbnB1dGAgaW4gcGxhY2Vob2xkZXJzLiAqL1xuICBpbnB1dDogUmVjb3JkPHN0cmluZywgdW5rbm93bj47XG4gIC8qKiBXb3JrZmxvdyB2YXJpYWJsZXMsIGFjY2Vzc2libGUgYXMgYCR2YXJzYCBpbiBwbGFjZWhvbGRlcnMuICovXG4gIHZhcnM/OiBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPjtcbiAgLyoqIEN1cnJlbnQgbG9vcCBpdGVtIChpZiBpbnNpZGUgYSBmb3JlYWNoKSwgYWNjZXNzaWJsZSBhcyBgJGl0ZW1gLiAqL1xuICBpdGVtPzogdW5rbm93bjtcbiAgLyoqIEN1cnJlbnQgbG9vcCBpbmRleCAoaWYgaW5zaWRlIGEgZm9yZWFjaCksIGFjY2Vzc2libGUgYXMgYCRpbmRleGAuICovXG4gIGluZGV4PzogbnVtYmVyO1xuICAvKiogT3V0cHV0cyBvZiB1cHN0cmVhbSBub2RlcywgYWNjZXNzaWJsZSBhcyBgJG5vZGVbXCJOYW1lXCJdLm91dHB1dGAuICovXG4gIG5vZGVzPzogUmVjb3JkPHN0cmluZywgUmVjb3JkPHN0cmluZywgdW5rbm93bj4+O1xufVxuXG4vKipcbiAqIFBsdWdnYWJsZSBldmFsdWF0b3IgZm9yIGNvZGUtYmFzZWQgY29uZGl0aW9ucyBhbmQgQ29kZSBOb2RlIHRyYW5zZm9ybXMuXG4gKlxuICogSW1wbGVtZW50YXRpb25zIE1VU1QgZW5mb3JjZSB0aGUgQ29kZSBOb2RlIHJlc3RyaWN0aW9ucyAowqcyMi40KTpcbiAqIG5vIHN5c3RlbSBBUEkgYWNjZXNzLCBzdGF0aWMgdmFsaWRhdGlvbiwgcGxhY2Vob2xkZXIgcmVzb2x1dGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDb2RlU2FuZGJveEV2YWx1YXRvciB7XG4gIC8qKlxuICAgKiBFdmFsdWF0ZXMgdGhlIGdpdmVuIGNvZGUgaW4gYSByZXN0cmljdGVkIHNhbmRib3ggYW5kIHJldHVybnMgdGhlIHJlc3VsdC5cbiAgICpcbiAgICogRm9yIGNvbmRpdGlvbnMsIHRoZSBjb2RlIGlzIGV4cGVjdGVkIHRvIHJldHVybiBhIGJvb2xlYW4uXG4gICAqIEZvciBDb2RlIE5vZGUgdHJhbnNmb3JtcywgdGhlIGNvZGUgbWF5IHJldHVybiBhbnkgdmFsdWUuXG4gICAqXG4gICAqIEBwYXJhbSBjdHggLSBUaGUgc2FuZGJveCBjb250ZXh0IGNvbnRhaW5pbmcgY29kZSwgaW5wdXQsIGFuZCByZWZlcmVuY2VzLlxuICAgKiBAcmV0dXJucyBUaGUgcmVzdWx0IG9mIGV2YWx1YXRpbmcgdGhlIGNvZGUuXG4gICAqL1xuICBldmFsdWF0ZShjdHg6IENvZGVTYW5kYm94Q29udGV4dCk6IFByb21pc2U8dW5rbm93bj4gfCB1bmtub3duO1xufVxuIl19

package/lib/esm/graph/engine/execution/GraphExecutionContext.js

@@ -0,0 +1,74 @@
+/**
+ * @module integrations/graph/execution/GraphExecutionContext
+ * @summary Decaf Context for graph node execution.
+ * @description Extends Decaf's {@link Context} so node executors receive the same contextual plumbing as task handlers. Executors use the context to emit progress, log messages, and report state through the engine's observer pipeline.
+ */
+import { Context } from "@decaf-ts/core";
+import { GraphExecutionEventType } from "./../../shared/constants.js";
+/**
+ * Context passed to every graph node executor.
+ *
+ * Mirrors the `TaskEngine` / `TaskContext` pattern: the engine creates a
+ * `GraphExecutionContext` per node execution and passes it to
+ * `executor.execute(inputs, context)`. The executor uses `context.progress(...)`
+ * and `context.log(...)` to report intermediate state.
+ */
+export class GraphExecutionContext extends Context {
+    /**
+     * @param runId - Unique identifier for the current execution run.
+     * @param parentRunId - Run id of the parent execution (for nested loop bodies).
+     * @param workflow - The workflow definition being executed.
+     * @param node - The node definition being executed.
+     * @param path - Dotted path from the workflow root to this node.
+     * @param emitFn - Callback invoked when an event is emitted from this context.
+     * @param metadata - Free-form metadata attached to this context.
+     */
+    constructor(runId, parentRunId, workflow, node, path, emitFn, metadata = {}) {
+        super();
+        this.runId = runId;
+        this.parentRunId = parentRunId;
+        this.workflow = workflow;
+        this.node = node;
+        this.path = path;
+        this.emitFn = emitFn;
+        this.metadata = metadata;
+    }
+    /**
+     * Emits a partial graph execution event. The engine fills in runId,
+     * parentRunId, workflowId, nodeId, and path automatically.
+     */
+    async emit(event) {
+        await this.emitFn({
+            ...event,
+            runId: this.runId,
+            parentRunId: this.parentRunId,
+            workflowId: this.workflow.name,
+            nodeId: this.node.name,
+            path: event.path ?? this.path,
+        });
+    }
+    /**
+     * Emits a `NODE_OUTPUT` event with the given payload, useful for reporting
+     * intermediate progress from within a node executor.
+     */
+    async progress(payload) {
+        await this.emit({
+            type: GraphExecutionEventType.NODE_OUTPUT,
+            payload,
+        });
+    }
+    /**
+     * Emits a `NODE_OUTPUT` event with a structured `{ message, payload }` shape
+     * so executors can log human-readable messages.
+     */
+    async log(message, payload) {
+        await this.emit({
+            type: GraphExecutionEventType.NODE_OUTPUT,
+            payload: {
+                message,
+                payload,
+            },
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiR3JhcGhFeGVjdXRpb25Db250ZXh0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vc3JjL2dyYXBoL2VuZ2luZS9leGVjdXRpb24vR3JhcGhFeGVjdXRpb25Db250ZXh0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFNekMsT0FBTyxFQUFFLHVCQUF1QixFQUFFLG9DQUErQjtBQU1qRTs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxPQUFPLHFCQUFzQixTQUFRLE9BQU87SUFDaEQ7Ozs7Ozs7O09BUUc7SUFDSCxZQUNXLEtBQWlCLEVBQ2pCLFdBQW1DLEVBQ25DLFFBQWlDLEVBQ2pDLElBQXlCLEVBQ3pCLElBQWMsRUFDTixNQUE4RCxFQUN0RSxXQUFvQyxFQUFFO1FBRS9DLEtBQUssRUFBRSxDQUFDO1FBUkMsVUFBSyxHQUFMLEtBQUssQ0FBWTtRQUNqQixnQkFBVyxHQUFYLFdBQVcsQ0FBd0I7UUFDbkMsYUFBUSxHQUFSLFFBQVEsQ0FBeUI7UUFDakMsU0FBSSxHQUFKLElBQUksQ0FBcUI7UUFDekIsU0FBSSxHQUFKLElBQUksQ0FBVTtRQUNOLFdBQU0sR0FBTixNQUFNLENBQXdEO1FBQ3RFLGFBQVEsR0FBUixRQUFRLENBQThCO0lBR2pELENBQUM7SUFFRDs7O09BR0c7SUFDSCxLQUFLLENBQUMsSUFBSSxDQUFDLEtBQW1DO1FBQzVDLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQztZQUNoQixHQUFHLEtBQUs7WUFDUixLQUFLLEVBQUUsSUFBSSxDQUFDLEtBQUs7WUFDakIsV0FBVyxFQUFFLElBQUksQ0FBQyxXQUFXO1lBQzdCLFVBQVUsRUFBRSxJQUFJLENBQUMsUUFBUSxDQUFDLElBQUk7WUFDOUIsTUFBTSxFQUFFLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSTtZQUN0QixJQUFJLEVBQUUsS0FBSyxDQUFDLElBQUksSUFBSSxJQUFJLENBQUMsSUFBSTtTQUM5QixDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQ7OztPQUdHO0lBQ0gsS0FBSyxDQUFDLFFBQVEsQ0FBQyxPQUFnQjtRQUM3QixNQUFNLElBQUksQ0FBQyxJQUFJLENBQUM7WUFDZCxJQUFJLEVBQUUsdUJBQXVCLENBQUMsV0FBVztZQUN6QyxPQUFPO1NBQ1IsQ0FBQyxDQUFDO0lBQ0wsQ0FBQztJQUVEOzs7T0FHRztJQUNILEtBQUssQ0FBQyxHQUFHLENBQUMsT0FBZSxFQUFFLE9BQWlCO1FBQzFDLE1BQU0sSUFBSSxDQUFDLElBQUksQ0FBQztZQUNkLElBQUksRUFBRSx1QkFBdUIsQ0FBQyxXQUFXO1lBQ3pDLE9BQU8sRUFBRTtnQkFDUCxPQUFPO2dCQUNQLE9BQU87YUFDUjtTQUNGLENBQUMsQ0FBQztJQUNMLENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBpbnRlZ3JhdGlvbnMvZ3JhcGgvZXhlY3V0aW9uL0dyYXBoRXhlY3V0aW9uQ29udGV4dFxuICogQHN1bW1hcnkgRGVjYWYgQ29udGV4dCBmb3IgZ3JhcGggbm9kZSBleGVjdXRpb24uXG4gKiBAZGVzY3JpcHRpb24gRXh0ZW5kcyBEZWNhZidzIHtAbGluayBDb250ZXh0fSBzbyBub2RlIGV4ZWN1dG9ycyByZWNlaXZlIHRoZSBzYW1lIGNvbnRleHR1YWwgcGx1bWJpbmcgYXMgdGFzayBoYW5kbGVycy4gRXhlY3V0b3JzIHVzZSB0aGUgY29udGV4dCB0byBlbWl0IHByb2dyZXNzLCBsb2cgbWVzc2FnZXMsIGFuZCByZXBvcnQgc3RhdGUgdGhyb3VnaCB0aGUgZW5naW5lJ3Mgb2JzZXJ2ZXIgcGlwZWxpbmUuXG4gKi9cbmltcG9ydCB7IENvbnRleHQgfSBmcm9tIFwiQGRlY2FmLXRzL2NvcmVcIjtcbmltcG9ydCB0eXBlIHtcbiAgR3JhcGhOb2RlRGVmaW5pdGlvbixcbiAgR3JhcGhXb3JrZmxvd0RlZmluaXRpb24sXG59IGZyb20gXCJAZGVjYWYtdHMvdWktZGVjb3JhdG9ycy9ncmFwaFwiO1xuXG5pbXBvcnQgeyBHcmFwaEV4ZWN1dGlvbkV2ZW50VHlwZSB9IGZyb20gXCIuLi8uLi9zaGFyZWQvY29uc3RhbnRzXCI7XG5pbXBvcnQgdHlwZSB7XG4gIEdyYXBoRXhlY3V0aW9uRXZlbnQsXG4gIEdyYXBoUnVuSWQsXG59IGZyb20gXCIuLi90eXBlc1wiO1xuXG4vKipcbiAqIENvbnRleHQgcGFzc2VkIHRvIGV2ZXJ5IGdyYXBoIG5vZGUgZXhlY3V0b3IuXG4gKlxuICogTWlycm9ycyB0aGUgYFRhc2tFbmdpbmVgIC8gYFRhc2tDb250ZXh0YCBwYXR0ZXJuOiB0aGUgZW5naW5lIGNyZWF0ZXMgYVxuICogYEdyYXBoRXhlY3V0aW9uQ29udGV4dGAgcGVyIG5vZGUgZXhlY3V0aW9uIGFuZCBwYXNzZXMgaXQgdG9cbiAqIGBleGVjdXRvci5leGVjdXRlKGlucHV0cywgY29udGV4dClgLiBUaGUgZXhlY3V0b3IgdXNlcyBgY29udGV4dC5wcm9ncmVzcyguLi4pYFxuICogYW5kIGBjb250ZXh0LmxvZyguLi4pYCB0byByZXBvcnQgaW50ZXJtZWRpYXRlIHN0YXRlLlxuICovXG5leHBvcnQgY2xhc3MgR3JhcGhFeGVjdXRpb25Db250ZXh0IGV4dGVuZHMgQ29udGV4dCB7XG4gIC8qKlxuICAgKiBAcGFyYW0gcnVuSWQgLSBVbmlxdWUgaWRlbnRpZmllciBmb3IgdGhlIGN1cnJlbnQgZXhlY3V0aW9uIHJ1bi5cbiAgICogQHBhcmFtIHBhcmVudFJ1bklkIC0gUnVuIGlkIG9mIHRoZSBwYXJlbnQgZXhlY3V0aW9uIChmb3IgbmVzdGVkIGxvb3AgYm9kaWVzKS5cbiAgICogQHBhcmFtIHdvcmtmbG93IC0gVGhlIHdvcmtmbG93IGRlZmluaXRpb24gYmVpbmcgZXhlY3V0ZWQuXG4gICAqIEBwYXJhbSBub2RlIC0gVGhlIG5vZGUgZGVmaW5pdGlvbiBiZWluZyBleGVjdXRlZC5cbiAgICogQHBhcmFtIHBhdGggLSBEb3R0ZWQgcGF0aCBmcm9tIHRoZSB3b3JrZmxvdyByb290IHRvIHRoaXMgbm9kZS5cbiAgICogQHBhcmFtIGVtaXRGbiAtIENhbGxiYWNrIGludm9rZWQgd2hlbiBhbiBldmVudCBpcyBlbWl0dGVkIGZyb20gdGhpcyBjb250ZXh0LlxuICAgKiBAcGFyYW0gbWV0YWRhdGEgLSBGcmVlLWZvcm0gbWV0YWRhdGEgYXR0YWNoZWQgdG8gdGhpcyBjb250ZXh0LlxuICAgKi9cbiAgY29uc3RydWN0b3IoXG4gICAgcmVhZG9ubHkgcnVuSWQ6IEdyYXBoUnVuSWQsXG4gICAgcmVhZG9ubHkgcGFyZW50UnVuSWQ6IEdyYXBoUnVuSWQgfCB1bmRlZmluZWQsXG4gICAgcmVhZG9ubHkgd29ya2Zsb3c6IEdyYXBoV29ya2Zsb3dEZWZpbml0aW9uLFxuICAgIHJlYWRvbmx5IG5vZGU6IEdyYXBoTm9kZURlZmluaXRpb24sXG4gICAgcmVhZG9ubHkgcGF0aDogc3RyaW5nW10sXG4gICAgcHJpdmF0ZSByZWFkb25seSBlbWl0Rm46IChldmVudDogUGFydGlhbDxHcmFwaEV4ZWN1dGlvbkV2ZW50PikgPT4gUHJvbWlzZTx2b2lkPixcbiAgICByZWFkb25seSBtZXRhZGF0YTogUmVjb3JkPHN0cmluZywgdW5rbm93bj4gPSB7fVxuICApIHtcbiAgICBzdXBlcigpO1xuICB9XG5cbiAgLyoqXG4gICAqIEVtaXRzIGEgcGFydGlhbCBncmFwaCBleGVjdXRpb24gZXZlbnQuIFRoZSBlbmdpbmUgZmlsbHMgaW4gcnVuSWQsXG4gICAqIHBhcmVudFJ1bklkLCB3b3JrZmxvd0lkLCBub2RlSWQsIGFuZCBwYXRoIGF1dG9tYXRpY2FsbHkuXG4gICAqL1xuICBhc3luYyBlbWl0KGV2ZW50OiBQYXJ0aWFsPEdyYXBoRXhlY3V0aW9uRXZlbnQ+KTogUHJvbWlzZTx2b2lkPiB7XG4gICAgYXdhaXQgdGhpcy5lbWl0Rm4oe1xuICAgICAgLi4uZXZlbnQsXG4gICAgICBydW5JZDogdGhpcy5ydW5JZCxcbiAgICAgIHBhcmVudFJ1bklkOiB0aGlzLnBhcmVudFJ1bklkLFxuICAgICAgd29ya2Zsb3dJZDogdGhpcy53b3JrZmxvdy5uYW1lLFxuICAgICAgbm9kZUlkOiB0aGlzLm5vZGUubmFtZSxcbiAgICAgIHBhdGg6IGV2ZW50LnBhdGggPz8gdGhpcy5wYXRoLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEVtaXRzIGEgYE5PREVfT1VUUFVUYCBldmVudCB3aXRoIHRoZSBnaXZlbiBwYXlsb2FkLCB1c2VmdWwgZm9yIHJlcG9ydGluZ1xuICAgKiBpbnRlcm1lZGlhdGUgcHJvZ3Jlc3MgZnJvbSB3aXRoaW4gYSBub2RlIGV4ZWN1dG9yLlxuICAgKi9cbiAgYXN5bmMgcHJvZ3Jlc3MocGF5bG9hZDogdW5rbm93bik6IFByb21pc2U8dm9pZD4ge1xuICAgIGF3YWl0IHRoaXMuZW1pdCh7XG4gICAgICB0eXBlOiBHcmFwaEV4ZWN1dGlvbkV2ZW50VHlwZS5OT0RFX09VVFBVVCxcbiAgICAgIHBheWxvYWQsXG4gICAgfSk7XG4gIH1cblxuICAvKipcbiAgICogRW1pdHMgYSBgTk9ERV9PVVRQVVRgIGV2ZW50IHdpdGggYSBzdHJ1Y3R1cmVkIGB7IG1lc3NhZ2UsIHBheWxvYWQgfWAgc2hhcGVcbiAgICogc28gZXhlY3V0b3JzIGNhbiBsb2cgaHVtYW4tcmVhZGFibGUgbWVzc2FnZXMuXG4gICAqL1xuICBhc3luYyBsb2cobWVzc2FnZTogc3RyaW5nLCBwYXlsb2FkPzogdW5rbm93bik6IFByb21pc2U8dm9pZD4ge1xuICAgIGF3YWl0IHRoaXMuZW1pdCh7XG4gICAgICB0eXBlOiBHcmFwaEV4ZWN1dGlvbkV2ZW50VHlwZS5OT0RFX09VVFBVVCxcbiAgICAgIHBheWxvYWQ6IHtcbiAgICAgICAgbWVzc2FnZSxcbiAgICAgICAgcGF5bG9hZCxcbiAgICAgIH0sXG4gICAgfSk7XG4gIH1cbn1cbiJdfQ==