@decaf-ts/integrations 0.3.8 → 0.3.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphExecutionError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/GraphInputError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphInputError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/GraphLoopLimitError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphLoopLimitError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/GraphPinningError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphPinningError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/GraphPortError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphPortError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/GraphStoreError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphStoreError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/GraphTopologyError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphTopologyError.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/errors/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/index.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/events/GraphExecutionEvent.cjs.map

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

package/lib/cjs/graph/engine/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/engine/events/GraphExecutionEventEmitter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/events/GraphExecutionEventEmitter.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/events/GraphExecutionEventFactory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/events/GraphExecutionEventFactory.cjs","sourceRoot":"","sources":["graph/engine/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/engine/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/engine/events/GraphExecutionObserver.cjs.map

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

package/lib/cjs/graph/engine/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/engine/events/index.cjs.map

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

package/lib/cjs/graph/engine/execution/CodeSandboxEvaluator.cjs

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

package/lib/cjs/graph/engine/execution/CodeSandboxEvaluator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/execution/CodeSandboxEvaluator.cjs","sourceRoot":"","sources":["graph/engine/execution/CodeSandboxEvaluator.js"],"names":[],"mappings":";;AAiBA,gDAAgD"}

package/lib/cjs/graph/engine/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("./../../shared/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/engine/execution/GraphExecutionContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/execution/GraphExecutionContext.cjs","sourceRoot":"","sources":["graph/engine/execution/GraphExecutionContext.js"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,yCAAyC;AACzC,8DAAsE;AACtE;;;;;;;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"}