@decaf-ts/integrations 0.3.0 → 0.3.2

package/dist/integrations.cjs

@@ -1,2 +1,2 @@
-var e,o;e=this,o=(e,o,i,n)=>{"use strict";e.COMMIT="5dab9b8",e.FULL_VERSION="0.2.2-5dab9b8",e.PACKAGE_NAME="@decaf-ts/integrations",e.VERSION="0.2.2",e.execWithLogging=async(e,t,r,d=i.LogLevel.info)=>(r.debug("Executing: "+e),new Promise((i,s)=>{const c=o.exec(e,t),a=[],l=[];c.stdout?.on("data",e=>{a.push(e),r[d](e.trim())}),c.stderr?.on("data",e=>{l.push(e),r.debug(e.trim())}),c.on("close",e=>{0===e?(r.silly("Command completed successfully"),i({stdout:a.join("\n"),stderr:l.join("\n")})):(r.critical(`Command failed with code ${e}:\n ${l.join("\n")}`),s(new n.InternalError(`Command failed with code ${e}: ${l.join("\n")}`)))}),c.on("error",e=>{r.critical("Command execution error",e),s(e)})}))},"object"==typeof exports&&"undefined"!=typeof module?o(exports,require("child_process"),require("@decaf-ts/logging"),require("@decaf-ts/db-decorators")):"function"==typeof define&&define.amd?define(["exports","child_process","@decaf-ts/logging","@decaf-ts/db-decorators"],o):o((e="undefined"!=typeof globalThis?globalThis:e||self).integrations={},e.childProcess,e.decafTsLogging,e.decafTsDbDecorators);
+var e,o;e=this,o=(e,o,i,n)=>{"use strict";e.COMMIT="538f19e",e.FULL_VERSION="0.3.1-538f19e",e.PACKAGE_NAME="@decaf-ts/integrations",e.VERSION="0.3.1",e.execWithLogging=async(e,t,r,d=i.LogLevel.info)=>(r.debug("Executing: "+e),new Promise((i,s)=>{const c=o.exec(e,t),a=[],l=[];c.stdout?.on("data",e=>{a.push(e),r[d](e.trim())}),c.stderr?.on("data",e=>{l.push(e),r.debug(e.trim())}),c.on("close",e=>{0===e?(r.silly("Command completed successfully"),i({stdout:a.join("\n"),stderr:l.join("\n")})):(r.critical(`Command failed with code ${e}:\n ${l.join("\n")}`),s(new n.InternalError(`Command failed with code ${e}: ${l.join("\n")}`)))}),c.on("error",e=>{r.critical("Command execution error",e),s(e)})}))},"object"==typeof exports&&"undefined"!=typeof module?o(exports,require("child_process"),require("@decaf-ts/logging"),require("@decaf-ts/db-decorators")):"function"==typeof define&&define.amd?define(["exports","child_process","@decaf-ts/logging","@decaf-ts/db-decorators"],o):o((e="undefined"!=typeof globalThis?globalThis:e||self).integrations={},e.childProcess,e.decafTsLogging,e.decafTsDbDecorators);
 //# sourceMappingURL=integrations.cjs.map

package/lib/cjs/graph/constants.cjs

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRAPH_LOOP_KIND = exports.GraphConditionType = exports.GraphPinningStrategy = exports.GraphExecutionEventType = exports.GraphExecutionStatus = exports.GRAPH_PINNING_METADATA_KEY = exports.GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS = exports.GRAPH_DEFAULT_MAX_LOOP_ITERATIONS = exports.GRAPH_DEFAULT_CONCURRENCY = exports.GRAPH_WORKFLOW_BOUNDARY = void 0;
+/**
+ * @module integrations/graph/constants
+ * @summary Graph execution engine constants and enums.
+ * @description Shared constants, default limits, and enumerations used across the graph execution engine.
+ */
+/**
+ * Boundary identifier used as the node id for workflow-level input/output ports.
+ */
+exports.GRAPH_WORKFLOW_BOUNDARY = "$workflow";
+/**
+ * Default concurrency for parallel node execution within a layer.
+ */
+exports.GRAPH_DEFAULT_CONCURRENCY = 4;
+/**
+ * Default maximum iterations for `while` and `until` loop nodes.
+ */
+exports.GRAPH_DEFAULT_MAX_LOOP_ITERATIONS = 100;
+/**
+ * Default maximum iterations for `foreach` loop nodes.
+ */
+exports.GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS = 1000;
+/**
+ * Metadata key under which pinning information is stored on a graph node.
+ */
+exports.GRAPH_PINNING_METADATA_KEY = "graph.pinnable";
+(function (GraphExecutionStatus) {
+    GraphExecutionStatus["PENDING"] = "pending";
+    GraphExecutionStatus["PLANNING"] = "planning";
+    GraphExecutionStatus["RUNNING"] = "running";
+    GraphExecutionStatus["SUCCEEDED"] = "succeeded";
+    GraphExecutionStatus["FAILED"] = "failed";
+    GraphExecutionStatus["SKIPPED"] = "skipped";
+    GraphExecutionStatus["CANCELLED"] = "cancelled";
+    GraphExecutionStatus["CACHED"] = "cached";
+})(exports.GraphExecutionStatus || (exports.GraphExecutionStatus = {}));
+(function (GraphExecutionEventType) {
+    GraphExecutionEventType["WORKFLOW_STARTED"] = "workflow.started";
+    GraphExecutionEventType["WORKFLOW_PLANNED"] = "workflow.planned";
+    GraphExecutionEventType["WORKFLOW_COMPLETED"] = "workflow.completed";
+    GraphExecutionEventType["WORKFLOW_FAILED"] = "workflow.failed";
+    GraphExecutionEventType["WORKFLOW_CANCELLED"] = "workflow.cancelled";
+    GraphExecutionEventType["NODE_QUEUED"] = "node.queued";
+    GraphExecutionEventType["NODE_STARTED"] = "node.started";
+    GraphExecutionEventType["NODE_OUTPUT"] = "node.output";
+    GraphExecutionEventType["NODE_COMPLETED"] = "node.completed";
+    GraphExecutionEventType["NODE_FAILED"] = "node.failed";
+    GraphExecutionEventType["NODE_SKIPPED"] = "node.skipped";
+    GraphExecutionEventType["NODE_CACHE_HIT"] = "node.cacheHit";
+    GraphExecutionEventType["NODE_PINNED"] = "node.pinned";
+    GraphExecutionEventType["NODE_UNPINNED"] = "node.unpinned";
+    GraphExecutionEventType["EDGE_VALUE_ROUTED"] = "edge.valueRouted";
+    GraphExecutionEventType["LOOP_STARTED"] = "loop.started";
+    GraphExecutionEventType["LOOP_ITERATION_STARTED"] = "loop.iteration.started";
+    GraphExecutionEventType["LOOP_ITERATION_COMPLETED"] = "loop.iteration.completed";
+    GraphExecutionEventType["LOOP_CONDITION_EVALUATED"] = "loop.condition.evaluated";
+    GraphExecutionEventType["LOOP_COMPLETED"] = "loop.completed";
+    GraphExecutionEventType["LOOP_LIMIT_REACHED"] = "loop.limitReached";
+    GraphExecutionEventType["VALIDATION_STARTED"] = "validation.started";
+    GraphExecutionEventType["VALIDATION_FAILED"] = "validation.failed";
+    GraphExecutionEventType["VALIDATION_COMPLETED"] = "validation.completed";
+    GraphExecutionEventType["STORE_READ"] = "store.read";
+    GraphExecutionEventType["STORE_WRITE"] = "store.write";
+    GraphExecutionEventType["STORE_DELETE"] = "store.delete";
+})(exports.GraphExecutionEventType || (exports.GraphExecutionEventType = {}));
+(function (GraphPinningStrategy) {
+    GraphPinningStrategy["MANUAL"] = "manual";
+    GraphPinningStrategy["AUTOMATIC"] = "automatic";
+    GraphPinningStrategy["DISABLED"] = "disabled";
+})(exports.GraphPinningStrategy || (exports.GraphPinningStrategy = {}));
+(function (GraphConditionType) {
+    GraphConditionType["TRUTHY"] = "truthy";
+    GraphConditionType["FALSY"] = "falsy";
+    GraphConditionType["EQUALS"] = "equals";
+    GraphConditionType["NOT_EQUALS"] = "notEquals";
+    GraphConditionType["GREATER_THAN"] = "greaterThan";
+    GraphConditionType["GREATER_THAN_OR_EQUAL"] = "greaterThanOrEqual";
+    GraphConditionType["LESS_THAN"] = "lessThan";
+    GraphConditionType["LESS_THAN_OR_EQUAL"] = "lessThanOrEqual";
+    GraphConditionType["EXISTS"] = "exists";
+    GraphConditionType["CUSTOM"] = "custom";
+})(exports.GraphConditionType || (exports.GraphConditionType = {}));
+/**
+ * Loop node kinds recognised by the engine.
+ */
+exports.GRAPH_LOOP_KIND = {
+    FOREACH: "core.loop.foreach",
+    WHILE: "core.loop.while",
+    UNTIL: "core.loop.until",
+};
+//# sourceMappingURL=constants.js.map
+//# sourceMappingURL=constants.cjs.map

package/lib/cjs/graph/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/constants.cjs","sourceRoot":"","sources":["graph/constants.js"],"names":[],"mappings":"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"}

package/lib/cjs/graph/decorators.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=decorators.js.map
+//# sourceMappingURL=decorators.cjs.map

package/lib/cjs/graph/decorators.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/decorators.cjs","sourceRoot":"","sources":["graph/decorators.js"],"names":[],"mappings":";;AACA,sCAAsC"}

package/lib/cjs/graph/errors/GraphCycleError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphCycleError = void 0;
+/**
+ * @module integrations/graph/errors/GraphCycleError
+ * @summary Error thrown when a workflow contains an unsupported cycle.
+ * @description Ordinary (non-loop) workflow graphs must be acyclic. This error is raised when the planner detects a cycle.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a graph workflow contains an unsupported cycle.
+ */
+class GraphCycleError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(details) {
+        super("Graph workflow contains an unsupported cycle", "GRAPH_CYCLE_ERROR", details);
+    }
+}
+exports.GraphCycleError = GraphCycleError;
+//# sourceMappingURL=GraphCycleError.js.map
+//# sourceMappingURL=GraphCycleError.cjs.map

package/lib/cjs/graph/errors/GraphCycleError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphCycleError.cjs","sourceRoot":"","sources":["graph/errors/GraphCycleError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,eAAgB,SAAQ,4CAAmB;IACpD,YAAY,OAAO;QACf,KAAK,CAAC,8CAA8C,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACxF,CAAC;CACJ;AAJD,0CAIC;AACD,2CAA2C"}

package/lib/cjs/graph/errors/GraphExecutionError.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphExecutionError = void 0;
+/**
+ * @module integrations/graph/errors/GraphExecutionError
+ * @summary Base error for all graph execution failures.
+ * @description Extends Decaf's {@link InternalError} so graph errors follow the standard Decaf error hierarchy while carrying a graph-specific string code.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+/**
+ * Base error for the graph execution engine.
+ *
+ * Extends `InternalError` (HTTP 500) to comply with the Decaf constitution which
+ * requires runtime errors to be `BaseError` subclasses. The additional
+ * `graphCode` property carries a machine-readable string code such as
+ * `"GRAPH_CYCLE_ERROR"`.
+ */
+class GraphExecutionError extends db_decorators_1.InternalError {
+    constructor(message, graphCode = "GRAPH_EXECUTION_ERROR", details) {
+        super(message, GraphExecutionError.name, 500);
+        this.graphCode = graphCode;
+        this.details = details;
+    }
+}
+exports.GraphExecutionError = GraphExecutionError;
+//# sourceMappingURL=GraphExecutionError.js.map
+//# sourceMappingURL=GraphExecutionError.cjs.map

package/lib/cjs/graph/errors/GraphExecutionError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphExecutionError.cjs","sourceRoot":"","sources":["graph/errors/GraphExecutionError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,2DAAwD;AACxD;;;;;;;GAOG;AACH,MAAa,mBAAoB,SAAQ,6BAAa;IAClD,YAAY,OAAO,EAAE,SAAS,GAAG,uBAAuB,EAAE,OAAO;QAC7D,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;CACJ;AAND,kDAMC;AACD,+CAA+C"}

package/lib/cjs/graph/errors/GraphInputError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphInputError = void 0;
+/**
+ * @module integrations/graph/errors/GraphInputError
+ * @summary Error thrown when workflow or node inputs are invalid.
+ * @description Raised by the value validator when required inputs are missing or fail schema validation.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when workflow or node inputs are invalid.
+ */
+class GraphInputError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_INPUT_ERROR", details);
+    }
+}
+exports.GraphInputError = GraphInputError;
+//# sourceMappingURL=GraphInputError.js.map
+//# sourceMappingURL=GraphInputError.cjs.map

package/lib/cjs/graph/errors/GraphInputError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphInputError.cjs","sourceRoot":"","sources":["graph/errors/GraphInputError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,eAAgB,SAAQ,4CAAmB;IACpD,YAAY,OAAO,EAAE,OAAO;QACxB,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACJ;AAJD,0CAIC;AACD,2CAA2C"}

package/lib/cjs/graph/errors/GraphLoopLimitError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphLoopLimitError = void 0;
+/**
+ * @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.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a loop exceeds its maximum iterations.
+ */
+class GraphLoopLimitError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_LOOP_LIMIT_ERROR", details);
+    }
+}
+exports.GraphLoopLimitError = GraphLoopLimitError;
+//# sourceMappingURL=GraphLoopLimitError.js.map
+//# sourceMappingURL=GraphLoopLimitError.cjs.map

package/lib/cjs/graph/errors/GraphLoopLimitError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphLoopLimitError.cjs","sourceRoot":"","sources":["graph/errors/GraphLoopLimitError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,mBAAoB,SAAQ,4CAAmB;IACxD,YAAY,OAAO,EAAE,OAAO;QACxB,KAAK,CAAC,OAAO,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;CACJ;AAJD,kDAIC;AACD,+CAA+C"}

package/lib/cjs/graph/errors/GraphPinningError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphPinningError = void 0;
+/**
+ * @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.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a pinning operation fails.
+ */
+class GraphPinningError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_PINNING_ERROR", details);
+    }
+}
+exports.GraphPinningError = GraphPinningError;
+//# sourceMappingURL=GraphPinningError.js.map
+//# sourceMappingURL=GraphPinningError.cjs.map

package/lib/cjs/graph/errors/GraphPinningError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphPinningError.cjs","sourceRoot":"","sources":["graph/errors/GraphPinningError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,iBAAkB,SAAQ,4CAAmB;IACtD,YAAY,OAAO,EAAE,OAAO;QACxB,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACJ;AAJD,8CAIC;AACD,6CAA6C"}

package/lib/cjs/graph/errors/GraphPortError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphPortError = void 0;
+/**
+ * @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.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a port reference is invalid.
+ */
+class GraphPortError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_PORT_ERROR", details);
+    }
+}
+exports.GraphPortError = GraphPortError;
+//# sourceMappingURL=GraphPortError.js.map
+//# sourceMappingURL=GraphPortError.cjs.map

package/lib/cjs/graph/errors/GraphPortError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphPortError.cjs","sourceRoot":"","sources":["graph/errors/GraphPortError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,cAAe,SAAQ,4CAAmB;IACnD,YAAY,OAAO,EAAE,OAAO;QACxB,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;CACJ;AAJD,wCAIC;AACD,0CAA0C"}

package/lib/cjs/graph/errors/GraphStoreError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphStoreError = void 0;
+/**
+ * @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.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a value store operation fails.
+ */
+class GraphStoreError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_STORE_ERROR", details);
+    }
+}
+exports.GraphStoreError = GraphStoreError;
+//# sourceMappingURL=GraphStoreError.js.map
+//# sourceMappingURL=GraphStoreError.cjs.map

package/lib/cjs/graph/errors/GraphStoreError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphStoreError.cjs","sourceRoot":"","sources":["graph/errors/GraphStoreError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,eAAgB,SAAQ,4CAAmB;IACpD,YAAY,OAAO,EAAE,OAAO;QACxB,KAAK,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CACJ;AAJD,0CAIC;AACD,2CAA2C"}

package/lib/cjs/graph/errors/GraphTopologyError.cjs

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphTopologyError = void 0;
+/**
+ * @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.
+ */
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when workflow topology is invalid.
+ */
+class GraphTopologyError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(message, details) {
+        super(message, "GRAPH_TOPOLOGY_ERROR", details);
+    }
+}
+exports.GraphTopologyError = GraphTopologyError;
+//# sourceMappingURL=GraphTopologyError.js.map
+//# sourceMappingURL=GraphTopologyError.cjs.map

package/lib/cjs/graph/errors/GraphTopologyError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/GraphTopologyError.cjs","sourceRoot":"","sources":["graph/errors/GraphTopologyError.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,qEAA+D;AAC/D;;GAEG;AACH,MAAa,kBAAmB,SAAQ,4CAAmB;IACvD,YAAY,OAAO,EAAE,OAAO;QACxB,KAAK,CAAC,OAAO,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACJ;AAJD,gDAIC;AACD,8CAA8C"}

package/lib/cjs/graph/errors/index.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/graph/errors
+ * @summary Graph execution error classes.
+ * @description Re-exports all structured error types used by the graph execution engine.
+ */
+__exportStar(require("./GraphExecutionError.cjs"), exports);
+__exportStar(require("./GraphCycleError.cjs"), exports);
+__exportStar(require("./GraphInputError.cjs"), exports);
+__exportStar(require("./GraphLoopLimitError.cjs"), exports);
+__exportStar(require("./GraphPinningError.cjs"), exports);
+__exportStar(require("./GraphPortError.cjs"), exports);
+__exportStar(require("./GraphStoreError.cjs"), exports);
+__exportStar(require("./GraphTopologyError.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/graph/errors/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/errors/index.cjs","sourceRoot":"","sources":["graph/errors/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,2DAAyC;AACzC,uDAAqC;AACrC,uDAAqC;AACrC,2DAAyC;AACzC,yDAAuC;AACvC,sDAAoC;AACpC,uDAAqC;AACrC,0DAAwC;AACxC,iCAAiC"}

package/lib/cjs/graph/events/GraphExecutionEvent.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GraphExecutionEvent.js.map
+//# sourceMappingURL=GraphExecutionEvent.cjs.map

package/lib/cjs/graph/events/GraphExecutionEvent.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/events/GraphExecutionEvent.cjs","sourceRoot":"","sources":["graph/events/GraphExecutionEvent.js"],"names":[],"mappings":";;AACA,+CAA+C"}

package/lib/cjs/graph/events/GraphExecutionEventEmitter.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphExecutionEventEmitter = void 0;
+/**
+ * Manages observer registration and event dispatch for the graph execution
+ * engine.
+ */
+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.
+            }
+        }));
+    }
+}
+exports.GraphExecutionEventEmitter = GraphExecutionEventEmitter;
+//# sourceMappingURL=GraphExecutionEventEmitter.js.map
+//# sourceMappingURL=GraphExecutionEventEmitter.cjs.map

package/lib/cjs/graph/events/GraphExecutionEventEmitter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/events/GraphExecutionEventEmitter.cjs","sourceRoot":"","sources":["graph/events/GraphExecutionEventEmitter.js"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,0BAA0B;IACnC;QACI,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;IAC/B,CAAC;IACD,iEAAiE;IACjE,OAAO,CAAC,QAAQ;QACZ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,gDAAgD;IAChD,SAAS,CAAC,QAAQ;QACd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,KAAK;QACvB,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChE,IAAI,CAAC;gBACD,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,CAAC;gBACH,8CAA8C;YAClD,CAAC;QACL,CAAC,CAAC,CAAC,CAAC;IACR,CAAC;CACJ;AA7BD,gEA6BC;AACD,sDAAsD"}

package/lib/cjs/graph/events/GraphExecutionEventFactory.cjs

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphExecutionEventFactory = void 0;
+/**
+ * Factory that enriches partial events with a unique id, an incrementing
+ * sequence number, and a timestamp.
+ */
+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)}`);
+    }
+}
+exports.GraphExecutionEventFactory = GraphExecutionEventFactory;
+//# sourceMappingURL=GraphExecutionEventFactory.js.map
+//# sourceMappingURL=GraphExecutionEventFactory.cjs.map

package/lib/cjs/graph/events/GraphExecutionEventFactory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/events/GraphExecutionEventFactory.cjs","sourceRoot":"","sources":["graph/events/GraphExecutionEventFactory.js"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,0BAA0B;IACnC;QACI,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACtB,CAAC;IACD;;;;;OAKG;IACH,MAAM,CAAC,IAAI;QACP,OAAO;YACH,GAAG,IAAI;YACP,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;IACN,CAAC;IACD;;;OAGG;IACH,aAAa;QACT,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACrC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;CACJ;AA1BD,gEA0BC;AACD,sDAAsD"}

package/lib/cjs/graph/events/GraphExecutionObserver.cjs

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=GraphExecutionObserver.js.map
+//# sourceMappingURL=GraphExecutionObserver.cjs.map

package/lib/cjs/graph/events/GraphExecutionObserver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/events/GraphExecutionObserver.cjs","sourceRoot":"","sources":["graph/events/GraphExecutionObserver.js"],"names":[],"mappings":";;AACA,kDAAkD"}

package/lib/cjs/graph/events/index.cjs

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module integrations/graph/events
+ * @summary Graph execution event pipeline.
+ * @description Re-exports the observer interface, event emitter, and event factory.
+ */
+__exportStar(require("./GraphExecutionEvent.cjs"), exports);
+__exportStar(require("./GraphExecutionObserver.cjs"), exports);
+__exportStar(require("./GraphExecutionEventEmitter.cjs"), exports);
+__exportStar(require("./GraphExecutionEventFactory.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/graph/events/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/events/index.cjs","sourceRoot":"","sources":["graph/events/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,2DAAyC;AACzC,8DAA4C;AAC5C,kEAAgD;AAChD,kEAAgD;AAChD,iCAAiC"}

package/lib/cjs/graph/execution/GraphExecutionContext.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphExecutionContext = void 0;
+/**
+ * @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.
+ */
+const core_1 = require("@decaf-ts/core");
+const constants_js_1 = require("./../constants.cjs");
+/**
+ * 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.
+ */
+class GraphExecutionContext extends core_1.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: constants_js_1.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: constants_js_1.GraphExecutionEventType.NODE_OUTPUT,
+            payload: {
+                message,
+                payload,
+            },
+        });
+    }
+}
+exports.GraphExecutionContext = GraphExecutionContext;
+//# sourceMappingURL=GraphExecutionContext.js.map
+//# sourceMappingURL=GraphExecutionContext.cjs.map

package/lib/cjs/graph/execution/GraphExecutionContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/execution/GraphExecutionContext.cjs","sourceRoot":"","sources":["graph/execution/GraphExecutionContext.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,yCAAyC;AACzC,oDAA4D;AAC5D;;;;;;;GAOG;AACH,MAAa,qBAAsB,SAAQ,cAAO;IAC9C;;;;;;;;OAQG;IACH,YAAY,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAG,EAAE;QACvE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAK;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC;YACd,GAAG,KAAK;YACR,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YAC9B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI;SAChC,CAAC,CAAC;IACP,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAO;QAClB,MAAM,IAAI,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,sCAAuB,CAAC,WAAW;YACzC,OAAO;SACV,CAAC,CAAC;IACP,CAAC;IACD;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO;QACtB,MAAM,IAAI,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,sCAAuB,CAAC,WAAW;YACzC,OAAO,EAAE;gBACL,OAAO;gBACP,OAAO;aACV;SACJ,CAAC,CAAC;IACP,CAAC;CACJ;AAzDD,sDAyDC;AACD,iDAAiD"}