@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/cjs/graph/engine/catalog/GraphNodeMethodRegistry.cjs

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphNodeMethodRegistry = void 0;
+const GraphCatalogueErrors_js_1 = require("./GraphCatalogueErrors.cjs");
+/**
+ * Per-kind registry of declared node methods (DECAF-50 §4.12): validates at
+ * construction that every declared method has an implementation and no
+ * implementation exists without a declaration, then serves declarations and
+ * implementations by name.
+ */
+class GraphNodeMethodRegistry {
+    constructor(kind, declared, provided = {}) {
+        this.kind = kind;
+        this.declarations = new Map();
+        this.implementations = new Map();
+        for (const declaration of declared) {
+            if (typeof declaration?.name !== "string" || !declaration.name) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Method declaration for kind '${this.kind}' is missing a name`);
+            }
+            if (this.declarations.has(declaration.name)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Kind '${this.kind}' declares duplicate method '${declaration.name}'`);
+            }
+            this.declarations.set(declaration.name, declaration);
+        }
+        for (const [name, implementation] of Object.entries(provided)) {
+            if (typeof implementation !== "function") {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Method implementation '${name}' for kind '${this.kind}' is not a function`);
+            }
+            if (!this.declarations.has(name)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Kind '${this.kind}' implements method '${name}' which is not declared by its manifest`);
+            }
+            this.implementations.set(name, implementation);
+        }
+        for (const name of this.declarations.keys()) {
+            if (!this.implementations.has(name)) {
+                throw new GraphCatalogueErrors_js_1.GraphNodeRegistrationError(`Kind '${this.kind}' declares method '${name}' with no implementation`);
+            }
+        }
+    }
+    /** Whether a method with the given name is declared. */
+    has(name) {
+        return this.declarations.has(name);
+    }
+    /** Returns the method's declaration; throws {@link GraphNodeMethodNotFoundError} when undeclared. */
+    getDeclaration(name) {
+        const declaration = this.declarations.get(name);
+        if (!declaration) {
+            throw new GraphCatalogueErrors_js_1.GraphNodeMethodNotFoundError(`Kind '${this.kind}' does not declare method '${name}'`);
+        }
+        return declaration;
+    }
+    /** Returns the method's implementation (asserting it is declared first). */
+    get(name) {
+        this.getDeclaration(name);
+        return this.implementations.get(name);
+    }
+    /** Lists all declarations, sorted by method name. */
+    list() {
+        return [...this.declarations.values()].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+    }
+}
+exports.GraphNodeMethodRegistry = GraphNodeMethodRegistry;
+//# sourceMappingURL=GraphNodeMethodRegistry.js.map
+//# sourceMappingURL=GraphNodeMethodRegistry.cjs.map

package/lib/cjs/graph/engine/catalog/GraphNodeMethodRegistry.cjs.map

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

package/lib/cjs/graph/engine/catalog/GraphNodeRegistration.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineGraphNode = defineGraphNode;
+exports.declaredGraphNodeMethods = declaredGraphNodeMethods;
+/**
+ * Identity helper that types a registration payload as a
+ * {@link GraphNodeRegistration} for catalogue registration.
+ */
+function defineGraphNode(registration) {
+    return registration;
+}
+/** Returns the method manifests declared by a node manifest. */
+function declaredGraphNodeMethods(manifest) {
+    return manifest.methods ?? [];
+}
+//# sourceMappingURL=GraphNodeRegistration.js.map
+//# sourceMappingURL=GraphNodeRegistration.cjs.map

package/lib/cjs/graph/engine/catalog/GraphNodeRegistration.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/GraphNodeRegistration.cjs","sourceRoot":"","sources":["graph/engine/catalog/GraphNodeRegistration.js"],"names":[],"mappings":";;AAIA,0CAEC;AAED,4DAEC;AAVD;;;GAGG;AACH,SAAgB,eAAe,CAAC,YAAY;IACxC,OAAO,YAAY,CAAC;AACxB,CAAC;AACD,gEAAgE;AAChE,SAAgB,wBAAwB,CAAC,QAAQ;IAC7C,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;AAClC,CAAC;AACD,iDAAiD"}

package/lib/cjs/graph/engine/catalog/index.cjs

@@ -0,0 +1,24 @@
+"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 });
+__exportStar(require("./GraphCatalogueErrors.cjs"), exports);
+__exportStar(require("./GraphNodeRegistration.cjs"), exports);
+__exportStar(require("./GraphNodeMethodRegistry.cjs"), exports);
+__exportStar(require("./GraphNodeManifestResolver.cjs"), exports);
+__exportStar(require("./GraphNodeCatalogue.cjs"), exports);
+__exportStar(require("./GraphBuiltInRegistrations.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/graph/engine/catalog/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/catalog/index.cjs","sourceRoot":"","sources":["graph/engine/catalog/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,6DAA2C;AAC3C,+DAA6C;AAC7C,iEAA+C;AAC/C,0DAAwC;AACxC,iEAA+C;AAC/C,iCAAiC"}

package/lib/cjs/graph/engine/constants.cjs

@@ -6,8 +6,8 @@ exports.GRAPH_LOOP_KIND = exports.GraphConditionType = exports.GraphPinningStrat
  * @summary Graph execution engine-private constants and enums.
  * @description Engine-only constants, default limits, and enumerations.
  * Frontend-safe enums (`GraphExecutionStatus`, `GraphExecutionEventType`)
- * live in `../shared/constants`; engine modules import shared symbols from
- * there and engine-private symbols from here.
+ * live in `@decaf-ts/ui-decorators/graph`; engine modules import shared
+ * symbols from there and engine-private symbols from here.
  */
 /**
  * Boundary identifier used as the node id for workflow-level input/output ports.

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

@@ -20,6 +20,7 @@ class GraphExecutionError extends db_decorators_1.InternalError {
         super(message, GraphExecutionError.name, 500);
         this.graphCode = graphCode;
         this.details = details;
+        this.name = this.constructor.name;
     }
 }
 exports.GraphExecutionError = GraphExecutionError;

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

@@ -1 +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"}
+{"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;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACtC,CAAC;CACJ;AAPD,kDAOC;AACD,+CAA+C"}

package/lib/cjs/graph/engine/errors/GraphRunCancelledError.cjs

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphRunCancelledError = void 0;
+const GraphExecutionError_js_1 = require("./GraphExecutionError.cjs");
+/**
+ * Thrown when a graph run is cancelled before completion: carries the run id
+ * under the `GRAPH_RUN_CANCELLED` code so run lifecycle bookkeeping can
+ * distinguish cancellation from failure.
+ */
+class GraphRunCancelledError extends GraphExecutionError_js_1.GraphExecutionError {
+    constructor(runId) {
+        super(`Graph run '${runId}' was cancelled`, "GRAPH_RUN_CANCELLED", { runId });
+        this.name = GraphRunCancelledError.name;
+    }
+}
+exports.GraphRunCancelledError = GraphRunCancelledError;
+//# sourceMappingURL=GraphRunCancelledError.js.map
+//# sourceMappingURL=GraphRunCancelledError.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph/engine/errors/GraphRunCancelledError.cjs","sourceRoot":"","sources":["graph/engine/errors/GraphRunCancelledError.js"],"names":[],"mappings":";;;AAAA,qEAA+D;AAC/D;;;;GAIG;AACH,MAAa,sBAAuB,SAAQ,4CAAmB;IAC3D,YAAY,KAAK;QACb,KAAK,CAAC,cAAc,KAAK,iBAAiB,EAAE,qBAAqB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC5C,CAAC;CACJ;AALD,wDAKC;AACD,kDAAkD"}

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

@@ -28,5 +28,6 @@ __exportStar(require("./GraphPortError.cjs"), exports);
 __exportStar(require("./GraphStoreError.cjs"), exports);
 __exportStar(require("./GraphTopologyError.cjs"), exports);
 __exportStar(require("./GraphBreakSignal.cjs"), exports);
+__exportStar(require("./GraphRunCancelledError.cjs"), exports);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +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,wDAAsC;AACtC,iCAAiC"}
+{"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,wDAAsC;AACtC,8DAA4C;AAC5C,iCAAiC"}

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

@@ -19,7 +19,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * @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);

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

@@ -1 +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"}
+{"version":3,"file":"graph/engine/events/index.cjs","sourceRoot":"","sources":["graph/engine/events/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,8DAA4C;AAC5C,kEAAgD;AAChD,kEAAgD;AAChD,iCAAiC"}

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

@@ -12,10 +12,10 @@ const GraphBreakSignal_js_1 = require("./../errors/GraphBreakSignal.cjs");
  * final partial result).
  */
 class BreakGraphNodeExecutor {
-    async execute(input, 
+    async execute(request, 
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     _context) {
-        const value = input["value"];
+        const value = request.inputs["value"];
         throw new GraphBreakSignal_js_1.GraphBreakSignal(value);
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"graph/engine/execution/BreakGraphNodeExecutor.cjs","sourceRoot":"","sources":["graph/engine/execution/BreakGraphNodeExecutor.js"],"names":[],"mappings":";;;AAAA,yEAAmE;AACnE;;;;;;;;GAQG;AACH,MAAa,sBAAsB;IAC/B,KAAK,CAAC,OAAO,CAAC,KAAK;IACnB,6DAA6D;IAC7D,QAAQ;QACJ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,IAAI,sCAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACJ;AAPD,wDAOC;AACD,kDAAkD"}
+{"version":3,"file":"graph/engine/execution/BreakGraphNodeExecutor.cjs","sourceRoot":"","sources":["graph/engine/execution/BreakGraphNodeExecutor.js"],"names":[],"mappings":";;;AAAA,yEAAmE;AACnE;;;;;;;;GAQG;AACH,MAAa,sBAAsB;IAC/B,KAAK,CAAC,OAAO,CAAC,OAAO;IACrB,6DAA6D;IAC7D,QAAQ;QACJ,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,IAAI,sCAAgB,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACJ;AAPD,wDAOC;AACD,kDAAkD"}

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

@@ -4,13 +4,16 @@ exports.CodeGraphNodeExecutor = void 0;
 const GraphExecutionError_js_1 = require("./../errors/GraphExecutionError.cjs");
 const GraphInputError_js_1 = require("./../errors/GraphInputError.cjs");
 /**
- * Reads the Code node metadata from the node definition's graph metadata.
+ * Reads the Code node metadata from the canonical node instance (DECAF-50):
+ * configuration lives in the instance `parameters` with `metadata` as the
+ * legacy fallback (the §4.18 transition compiler mirrors legacy
+ * `graph.metadata` bags into instance metadata).
  */
 function readCodeMetadata(context) {
-    const meta = context.node.graph?.metadata;
-    if (!meta)
-        return {};
-    return meta;
+    const parameters = context.node.parameters;
+    const metadata = context.node.metadata;
+    const source = { ...(metadata ?? {}), ...parameters };
+    return source;
 }
 /**
  * Executor for `core.flow.code` nodes.
@@ -45,8 +48,9 @@ class CodeGraphNodeExecutor {
     constructor(engine) {
         this.engine = engine;
     }
-    async execute(input, context) {
+    async execute(request, context) {
         const meta = readCodeMetadata(context);
+        const input = request.inputs;
         const code = input["code"] ?? meta.defaultCode;
         if (!code || typeof code !== "string" || code.trim().length === 0) {
             throw new GraphInputError_js_1.GraphInputError("Code node has no code to execute (input.code is empty)", { input });

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

@@ -1 +1 @@
-{"version":3,"file":"graph/engine/execution/CodeGraphNodeExecutor.cjs","sourceRoot":"","sources":["graph/engine/execution/CodeGraphNodeExecutor.js"],"names":[],"mappings":";;;AAAA,+EAAyE;AACzE,uEAAiE;AACjE;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAO;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC1C,IAAI,CAAC,IAAI;QACL,OAAO,EAAE,CAAC;IACd,OAAO,IAAI,CAAC;AAChB,CAAC;AACD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,qBAAqB;IAC9B;;;;OAIG;IACH,YAAY,MAAM;QACd,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;QACxB,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC;QAC/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,oCAAe,CAAC,wDAAwD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,4CAAmB,CAAC,yHAAyH,EAAE,mCAAmC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5M,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;YACrC,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACxD,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC;IACD;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,KAAK,EAAE,OAAO;QAC9B,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC5B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,OAAO;YACH,IAAI;YACJ,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,SAAS;YAC3B,IAAI,EAAE,EAAE,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,EAAE,KAAK;YAChB,KAAK,EAAE,EAAE,EAAE,KAAK;gBACZ,SAAS;YACb,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC;IACN,CAAC;CACJ;AAzDD,sDAyDC;AACD,iDAAiD"}
+{"version":3,"file":"graph/engine/execution/CodeGraphNodeExecutor.cjs","sourceRoot":"","sources":["graph/engine/execution/CodeGraphNodeExecutor.js"],"names":[],"mappings":";;;AAAA,+EAAyE;AACzE,uEAAiE;AACjE;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAAO;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;IACvC,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IACtD,OAAO,MAAM,CAAC;AAClB,CAAC;AACD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAa,qBAAqB;IAC9B;;;;OAIG;IACH,YAAY,MAAM;QACd,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO;QAC1B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC;QAC/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,oCAAe,CAAC,wDAAwD,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,4CAAmB,CAAC,yHAAyH,EAAE,mCAAmC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5M,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChE,MAAM,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;YACrC,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACxD,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QAC7E,OAAO,EAAE,MAAM,EAAE,CAAC;IACtB,CAAC;IACD;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,KAAK,EAAE,OAAO;QAC9B,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC5B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,OAAO;YACH,IAAI;YACJ,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAK;YACZ,IAAI,EAAE,EAAE,EAAE,IAAI,IAAI,SAAS;YAC3B,IAAI,EAAE,EAAE,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,EAAE,KAAK;YAChB,KAAK,EAAE,EAAE,EAAE,KAAK;gBACZ,SAAS;YACb,MAAM,EAAE,OAAO,CAAC,MAAM;SACzB,CAAC;IACN,CAAC;CACJ;AA1DD,sDA0DC;AACD,iDAAiD"}

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

@@ -3,45 +3,57 @@ 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. Each context also exposes a run-scoped `ctx.logger` (DECAF-48 §4.3) bound to the executing node's `runId` / `workflowId` / `nodeId` / `user`, so every log line streams over `graph.run.log` with the DECAF-9 custom attributes.
+ * @summary Decaf Context for graph node execution (DECAF-50 §4.9).
+ * @description Extends Decaf's {@link Context} so node executors receive the
+ * same contextual plumbing as task handlers. The context carries the
+ * canonical workflow document, the executing node's canonical instance, and
+ * its effective resolved manifest — never a raw node definition. Executors
+ * use the context to emit progress, log messages, and report state through
+ * the engine's observer pipeline. Each context also exposes a run-scoped
+ * `ctx.logger` (DECAF-48 §4.3) bound to the executing node's `runId` /
+ * `workflowId` / `nodeId` / `user`, so every log line streams over
+ * `graph.run.log` with the DECAF-9 custom attributes.
  */
 const core_1 = require("@decaf-ts/core");
-const constants_js_1 = require("./../../shared/constants.cjs");
+const graph_1 = require("@decaf-ts/ui-decorators/graph");
 const GraphRunLogger_js_1 = require("./../../log/GraphRunLogger.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, and `context.logger`
- * to emit structured run log lines (DECAF-48 §4.3).
+ * The engine creates a `GraphExecutionContext` per node execution and passes
+ * it to the executor alongside the node's inputs/parameters. The executor
+ * uses `context.progress(...)` and `context.log(...)` to report intermediate
+ * state, and `context.logger` to emit structured run log lines (DECAF-48
+ * §4.3).
  */
 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 workflowId - The canonical workflow document id.
+     * @param document - The canonical workflow document being executed.
+     * @param node - The canonical node instance being executed.
+     * @param manifest - The effective (dynamics-expanded) manifest for the node.
      * @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 = {}) {
+    constructor(runId, parentRunId, workflowId, document, node, manifest, path, emitFn, metadata = {}) {
         super();
         this.runId = runId;
         this.parentRunId = parentRunId;
-        this.workflow = workflow;
+        this.workflowId = workflowId;
+        this.document = document;
         this.node = node;
+        this.manifest = manifest;
         this.path = path;
         this.emitFn = emitFn;
         this.metadata = metadata;
         const user = typeof metadata?.["user"] === "string" ? metadata["user"] : null;
         this.runLogger = new GraphRunLogger_js_1.GraphRunLogger({
             runId,
-            workflowId: workflow.name,
-            nodeId: node.name,
+            workflowId,
+            nodeId: node.id,
             user,
             forward: async (event) => {
                 await this.emit(event);
@@ -66,8 +78,8 @@ class GraphExecutionContext extends core_1.Context {
             ...event,
             runId: this.runId,
             parentRunId: this.parentRunId,
-            workflowId: this.workflow.name,
-            nodeId: this.node.name,
+            workflowId: this.workflowId,
+            nodeId: this.node.id,
             path: event.path ?? this.path,
         });
     }
@@ -77,7 +89,7 @@ class GraphExecutionContext extends core_1.Context {
      */
     async progress(payload) {
         await this.emit({
-            type: constants_js_1.GraphExecutionEventType.NODE_OUTPUT,
+            type: graph_1.GraphExecutionEventType.NODE_OUTPUT,
             payload,
         });
     }
@@ -87,7 +99,7 @@ class GraphExecutionContext extends core_1.Context {
      */
     async log(message, payload) {
         await this.emit({
-            type: constants_js_1.GraphExecutionEventType.NODE_OUTPUT,
+            type: graph_1.GraphExecutionEventType.NODE_OUTPUT,
             payload: {
                 message,
                 payload,

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

@@ -1 +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,qEAA+D;AAC/D;;;;;;;;GAQG;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;QACzB,MAAM,IAAI,GAAG,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,IAAI,CAAC,SAAS,GAAG,IAAI,kCAAc,CAAC;YAChC,KAAK;YACL,UAAU,EAAE,QAAQ,CAAC,IAAI;YACzB,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACrB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IACD;;;;;OAKG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,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;AA5ED,sDA4EC;AACD,iDAAiD"}
+{"version":3,"file":"graph/engine/execution/GraphExecutionContext.cjs","sourceRoot":"","sources":["graph/engine/execution/GraphExecutionContext.js"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,yCAAyC;AACzC,yDAAwE;AACxE,qEAA+D;AAC/D;;;;;;;;GAQG;AACH,MAAa,qBAAsB,SAAQ,cAAO;IAC9C;;;;;;;;;;OAUG;IACH,YAAY,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAG,EAAE;QAC7F,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,IAAI,GAAG,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,IAAI,CAAC,SAAS,GAAG,IAAI,kCAAc,CAAC;YAChC,KAAK;YACL,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACrB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IACD;;;;;OAKG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,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,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE;YACpB,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,+BAAuB,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,+BAAuB,CAAC,WAAW;YACzC,OAAO,EAAE;gBACL,OAAO;gBACP,OAAO;aACV;SACJ,CAAC,CAAC;IACP,CAAC;CACJ;AAhFD,sDAgFC;AACD,iDAAiD"}