@decaf-ts/integrations 0.8.0 → 0.10.0

package/lib/esm/graph/engine/catalog/GraphNodeRegistration.js

@@ -0,0 +1,12 @@
+/**
+ * Identity helper that types a registration payload as a
+ * {@link GraphNodeRegistration} for catalogue registration.
+ */
+export function defineGraphNode(registration) {
+    return registration;
+}
+/** Returns the method manifests declared by a node manifest. */
+export function declaredGraphNodeMethods(manifest) {
+    return manifest.methods ?? [];
+}
+//# sourceMappingURL=GraphNodeRegistration.js.map

package/lib/esm/graph/engine/catalog/GraphNodeRegistration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNodeRegistration.js","sourceRoot":"","sources":["../../../../../src/graph/engine/catalog/GraphNodeRegistration.ts"],"names":[],"mappings":"AAkFA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAmC;IAEnC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,wBAAwB,CACtC,QAA2B;IAE3B,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,7 @@
+export * from "./GraphCatalogueErrors.js";
+export * from "./GraphNodeRegistration.js";
+export * from "./GraphNodeMethodRegistry.js";
+export * from "./GraphNodeManifestResolver.js";
+export * from "./GraphNodeCatalogue.js";
+export * from "./GraphBuiltInRegistrations.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/graph/engine/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/catalog/index.ts"],"names":[],"mappings":"AAAA,0CAAuC;AACvC,2CAAwC;AACxC,6CAA0C;AAC1C,+CAA4C;AAC5C,wCAAqC;AACrC,+CAA4C"}

package/lib/esm/graph/engine/constants.js

@@ -3,8 +3,8 @@
  * @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/esm/graph/engine/errors/GraphExecutionError.js

@@ -17,6 +17,7 @@ export class GraphExecutionError extends InternalError {
         super(message, GraphExecutionError.name, 500);
         this.graphCode = graphCode;
         this.details = details;
+        this.name = this.constructor.name;
     }
 }
 //# sourceMappingURL=GraphExecutionError.js.map

package/lib/esm/graph/engine/errors/GraphExecutionError.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionError.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/GraphExecutionError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD,YACE,OAAe,EACf,SAAS,GAAG,uBAAuB,EACnC,OAAiB;QAEjB,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;IACzB,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionError.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/GraphExecutionError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IAIpD,YACE,OAAe,EACf,SAAS,GAAG,uBAAuB,EACnC,OAAiB;QAEjB,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;IACpC,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import { GraphExecutionError } from "./GraphExecutionError.js";
+/**
+ * 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.
+ */
+export class GraphRunCancelledError extends GraphExecutionError {
+    constructor(runId) {
+        super(`Graph run '${runId}' was cancelled`, "GRAPH_RUN_CANCELLED", { runId });
+        this.name = GraphRunCancelledError.name;
+    }
+}
+//# sourceMappingURL=GraphRunCancelledError.js.map

package/lib/esm/graph/engine/errors/GraphRunCancelledError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphRunCancelledError.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/GraphRunCancelledError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iCAA8B;AAE5D;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,mBAAmB;IAC7D,YAAY,KAAa;QACvB,KAAK,CACH,cAAc,KAAK,iBAAiB,EACpC,qBAAqB,EACrB,EAAE,KAAK,EAAE,CACV,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;IAC1C,CAAC;CACF"}

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

@@ -12,4 +12,5 @@ export * from "./GraphPortError.js";
 export * from "./GraphStoreError.js";
 export * from "./GraphTopologyError.js";
 export * from "./GraphBreakSignal.js";
+export * from "./GraphRunCancelledError.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAAsC;AACtC,qCAAkC;AAClC,qCAAkC;AAClC,yCAAsC;AACtC,uCAAoC;AACpC,oCAAiC;AACjC,qCAAkC;AAClC,wCAAqC;AACrC,sCAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/errors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAAsC;AACtC,qCAAkC;AAClC,qCAAkC;AAClC,yCAAsC;AACtC,uCAAoC;AACpC,oCAAiC;AACjC,qCAAkC;AAClC,wCAAqC;AACrC,sCAAmC;AACnC,4CAAyC"}

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

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionEventEmitter.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventEmitter.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QAEmB,cAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IA8BjE,CAAC;IA5BC,iEAAiE;IACjE,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,KAA0B;QAC9C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionEventEmitter.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventEmitter.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QAEmB,cAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IA8BjE,CAAC;IA5BC,iEAAiE;IACjE,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,gDAAgD;IAChD,SAAS,CAAC,QAAgC;QACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,KAA0B;QAC9C,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YAChD,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;QACH,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionEventFactory.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventFactory.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACU,aAAQ,GAAG,CAAC,CAAC;IA6BvB,CAAC;IA3BC;;;;;OAKG;IACH,MAAM,CACJ,IAAgE;QAEhE,OAAO;YACL,GAAG,IAAI;YACP,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,OAAO,CACL,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACjC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionEventFactory.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/GraphExecutionEventFactory.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,OAAO,0BAA0B;IAAvC;QACU,aAAQ,GAAG,CAAC,CAAC;IA6BvB,CAAC;IA3BC;;;;;OAKG;IACH,MAAM,CACJ,IAAgE;QAEhE,OAAO;YACL,GAAG,IAAI;YACP,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE;YACxB,QAAQ,EAAE,EAAE,IAAI,CAAC,QAAQ;YACzB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,OAAO,CACL,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE;YACjC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;CACF"}

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

@@ -3,7 +3,6 @@
  * @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";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,yCAAsC;AACtC,4CAAyC;AACzC,gDAA6C;AAC7C,gDAA6C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/events/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,4CAAyC;AACzC,gDAA6C;AAC7C,gDAA6C"}

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

@@ -9,10 +9,10 @@ import { GraphBreakSignal } from "./../errors/GraphBreakSignal.js";
  * final partial result).
  */
 export 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(value);
     }
 }

package/lib/esm/graph/engine/execution/BreakGraphNodeExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"BreakGraphNodeExecutor.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/BreakGraphNodeExecutor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,wCAAmC;AAE9D;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,OAAO,CACX,KAA2B;IAC3B,6DAA6D;IAC7D,QAA+B;QAE/B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"BreakGraphNodeExecutor.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/BreakGraphNodeExecutor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,wCAAmC;AAE9D;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,OAAO,CACX,OAAkC;IAClC,6DAA6D;IAC7D,QAA+B;QAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;CACF"}

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

@@ -1,13 +1,16 @@
 import { GraphExecutionError } from "./../errors/GraphExecutionError.js";
 import { GraphInputError } from "./../errors/GraphInputError.js";
 /**
- * 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.
@@ -42,8 +45,9 @@ export 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("Code node has no code to execute (input.code is empty)", { input });

package/lib/esm/graph/engine/execution/CodeGraphNodeExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"CodeGraphNodeExecutor.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/CodeGraphNodeExecutor.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,mBAAmB,EAAE,2CAAsC;AACpE,OAAO,EAAE,eAAe,EAAE,uCAAkC;AAW5D;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAA8B;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAEpB,CAAC;IACd,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,qBAAqB;IAChC;;;;OAIG;IACH,YACmB,MAAwD;QAAxD,WAAM,GAAN,MAAM,CAAkD;IACxE,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,KAA2B,EAC3B,OAA8B;QAE9B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAI,KAAK,CAAC,MAAM,CAAwB,IAAI,IAAI,CAAC,WAAW,CAAC;QAEvE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,eAAe,CACvB,wDAAwD,EACxD,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAC3B,yHAAyH,EACzH,mCAAmC,EACnC,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;YACvC,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QAE7E,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;OAWG;IACK,mBAAmB,CACzB,KAA2B,EAC3B,OAA8B;QAE9B,MAAM,EAAE,GAAG,OAAO,CAAC,QAA+C,CAAC;QACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAI,KAAK,CAAC,MAAM,CAAwB,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE7E,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAgC;YACvC,IAAI,EAAG,EAAE,EAAE,IAA4C,IAAI,SAAS;YACpE,IAAI,EAAE,EAAE,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,EAAE,KAA2B;YACtC,KAAK,EACF,EAAE,EAAE,KAA6D;gBAClE,SAAS;YACX,MAAM,EAAE,OAAO,CAAC,MAA8C;SAC/D,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"CodeGraphNodeExecutor.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/CodeGraphNodeExecutor.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,mBAAmB,EAAE,2CAAsC;AACpE,OAAO,EAAE,eAAe,EAAE,uCAAkC;AAW5D;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,OAA8B;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,UAAqC,CAAC;IACtE,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAA+C,CAAC;IAC9E,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;IACtD,OAAO,MAA0B,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,qBAAqB;IAChC;;;;OAIG;IACH,YACmB,MAAwD;QAAxD,WAAM,GAAN,MAAM,CAAkD;IACxE,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,OAAkC,EAClC,OAA8B;QAE9B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAI,KAAK,CAAC,MAAM,CAAwB,IAAI,IAAI,CAAC,WAAW,CAAC;QAEvE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,eAAe,CACvB,wDAAwD,EACxD,EAAE,KAAK,EAAE,CACV,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,mBAAmB,CAC3B,yHAAyH,EACzH,mCAAmC,EACnC,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEhE,MAAM,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE;YACvC,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAExD,MAAM,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QAE7E,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;OAWG;IACK,mBAAmB,CACzB,KAA2B,EAC3B,OAA8B;QAE9B,MAAM,EAAE,GAAG,OAAO,CAAC,QAA+C,CAAC;QACnE,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAI,KAAK,CAAC,MAAM,CAAwB,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE7E,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,KAAgC;YACvC,IAAI,EAAG,EAAE,EAAE,IAA4C,IAAI,SAAS;YACpE,IAAI,EAAE,EAAE,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,EAAE,KAA2B;YACtC,KAAK,EACF,EAAE,EAAE,KAA6D;gBAClE,SAAS;YACX,MAAM,EAAE,OAAO,CAAC,MAA8C;SAC/D,CAAC;IACJ,CAAC;CACF"}

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

@@ -1,44 +1,56 @@
 /**
  * @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.
  */
 import { Context } from "@decaf-ts/core";
-import { GraphExecutionEventType } from "./../../shared/constants.js";
+import { GraphExecutionEventType } from "@decaf-ts/ui-decorators/graph";
 import { GraphRunLogger } from "./../../log/GraphRunLogger.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, 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).
  */
 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 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({
             runId,
-            workflowId: workflow.name,
-            nodeId: node.name,
+            workflowId,
+            nodeId: node.id,
             user,
             forward: async (event) => {
                 await this.emit(event);
@@ -63,8 +75,8 @@ export class GraphExecutionContext extends 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,
         });
     }

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

@@ -1 +1 @@
-{"version":3,"file":"GraphExecutionContext.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/GraphExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAOzC,OAAO,EAAE,uBAAuB,EAAE,oCAA+B;AACjE,OAAO,EAAE,cAAc,EAAE,sCAAiC;AAM1D;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,OAAO;IAGhD;;;;;;;;OAQG;IACH,YACW,KAAiB,EACjB,WAAmC,EACnC,QAAiC,EACjC,IAAyB,EACzB,IAAc,EACN,MAA8D,EACtE,WAAoC,EAAE;QAE/C,KAAK,EAAE,CAAC;QARC,UAAK,GAAL,KAAK,CAAY;QACjB,gBAAW,GAAX,WAAW,CAAwB;QACnC,aAAQ,GAAR,QAAQ,CAAyB;QACjC,SAAI,GAAJ,IAAI,CAAqB;QACzB,SAAI,GAAJ,IAAI,CAAU;QACN,WAAM,GAAN,MAAM,CAAwD;QACtE,aAAQ,GAAR,QAAQ,CAA8B;QAG/C,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,cAAc,CAAC;YAClC,KAAK;YACL,UAAU,EAAE,QAAQ,CAAC,IAAI;YACzB,MAAM,EAAE,IAAI,CAAC,IAAI;YACjB,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAmC;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC;YAChB,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;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAgB;QAC7B,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,uBAAuB,CAAC,WAAW;YACzC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,OAAiB;QAC1C,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,uBAAuB,CAAC,WAAW;YACzC,OAAO,EAAE;gBACP,OAAO;gBACP,OAAO;aACR;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"GraphExecutionContext.js","sourceRoot":"","sources":["../../../../../src/graph/engine/execution/GraphExecutionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAOzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,sCAAiC;AAQ1D;;;;;;;;GAQG;AACH,MAAM,OAAO,qBAAsB,SAAQ,OAAO;IAGhD;;;;;;;;;;OAUG;IACH,YACW,KAAiB,EACjB,WAAmC,EACnC,UAAkB,EAClB,QAA+B,EAC/B,IAAuB,EACvB,QAAmC,EACnC,IAAc,EACN,MAA8D,EACtE,WAAoC,EAAE;QAE/C,KAAK,EAAE,CAAC;QAVC,UAAK,GAAL,KAAK,CAAY;QACjB,gBAAW,GAAX,WAAW,CAAwB;QACnC,eAAU,GAAV,UAAU,CAAQ;QAClB,aAAQ,GAAR,QAAQ,CAAuB;QAC/B,SAAI,GAAJ,IAAI,CAAmB;QACvB,aAAQ,GAAR,QAAQ,CAA2B;QACnC,SAAI,GAAJ,IAAI,CAAU;QACN,WAAM,GAAN,MAAM,CAAwD;QACtE,aAAQ,GAAR,QAAQ,CAA8B;QAG/C,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,cAAc,CAAC;YAClC,KAAK;YACL,UAAU;YACV,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,IAAI;YACJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvB,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,SAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,KAAmC;QAC5C,MAAM,IAAI,CAAC,MAAM,CAAC;YAChB,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;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAgB;QAC7B,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,uBAAuB,CAAC,WAAW;YACzC,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe,EAAE,OAAiB;QAC1C,MAAM,IAAI,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,uBAAuB,CAAC,WAAW;YACzC,OAAO,EAAE;gBACP,OAAO;gBACP,OAAO;aACR;SACF,CAAC,CAAC;IACL,CAAC;CACF"}