@decaf-ts/integrations 0.8.0 → 0.9.0

package/lib/types/graph/engine/execution/GraphExecutionFrame.d.cts

@@ -6,7 +6,8 @@
 import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.cts";
 import type { GraphValueStore } from "../store/GraphValueStore.d.cts";
 import type { GraphExecutionEventFactory } from "../events/GraphExecutionEventFactory.d.cts";
-import type { GraphExecutionEvent, GraphNodeExecutionResult, GraphRunId } from "../types.d.cts";
+import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
+import type { GraphNodeExecutionResult, GraphRunId } from "../types.d.cts";
 /**
  * Mutable state for a single graph execution run.
  */

package/lib/types/graph/engine/execution/GraphExecutionFrame.d.mts

@@ -6,7 +6,8 @@
 import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.mts";
 import type { GraphValueStore } from "../store/GraphValueStore.d.mts";
 import type { GraphExecutionEventFactory } from "../events/GraphExecutionEventFactory.d.mts";
-import type { GraphExecutionEvent, GraphNodeExecutionResult, GraphRunId } from "../types.d.mts";
+import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
+import type { GraphNodeExecutionResult, GraphRunId } from "../types.d.mts";
 /**
  * Mutable state for a single graph execution run.
  */

package/lib/types/graph/engine/execution/GraphExecutionResult.d.cts

@@ -3,11 +3,11 @@
  * @summary Helper for building GraphExecutionResult objects.
  * @description Provides a builder function that assembles a result from a frame.
  */
+import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
 import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.cts";
 import type { GraphExecutionResult, GraphExecutionValues } from "../types.d.cts";
-import type { GraphExecutionStatus } from "../../shared/constants.d.cts";
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphExecutionStatus } from "@decaf-ts/ui-decorators/graph";
 /**
  * Builds a {@link GraphExecutionResult} from a completed frame.
  */
-export declare function buildGraphExecutionResult(frame: GraphExecutionFrame, workflow: GraphWorkflowDefinition, inputs: GraphExecutionValues, status: GraphExecutionStatus, metadata?: Record<string, unknown>): GraphExecutionResult;
+export declare function buildGraphExecutionResult(frame: GraphExecutionFrame, document: GraphWorkflowDocument, inputs: GraphExecutionValues, status: GraphExecutionStatus, metadata?: Record<string, unknown>): GraphExecutionResult;

package/lib/types/graph/engine/execution/GraphExecutionResult.d.mts

@@ -3,11 +3,11 @@
  * @summary Helper for building GraphExecutionResult objects.
  * @description Provides a builder function that assembles a result from a frame.
  */
+import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
 import type { GraphExecutionFrame } from "./GraphExecutionFrame.d.mts";
 import type { GraphExecutionResult, GraphExecutionValues } from "../types.d.mts";
-import type { GraphExecutionStatus } from "../../shared/constants.d.mts";
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphExecutionStatus } from "@decaf-ts/ui-decorators/graph";
 /**
  * Builds a {@link GraphExecutionResult} from a completed frame.
  */
-export declare function buildGraphExecutionResult(frame: GraphExecutionFrame, workflow: GraphWorkflowDefinition, inputs: GraphExecutionValues, status: GraphExecutionStatus, metadata?: Record<string, unknown>): GraphExecutionResult;
+export declare function buildGraphExecutionResult(frame: GraphExecutionFrame, document: GraphWorkflowDocument, inputs: GraphExecutionValues, status: GraphExecutionStatus, metadata?: Record<string, unknown>): GraphExecutionResult;

package/lib/types/graph/engine/execution/GraphNodeExecutor.d.cts

@@ -1,23 +1,31 @@
 /**
  * @module integrations/graph/execution/GraphNodeExecutor
- * @summary Interface implemented by every graph node executor.
- * @description A node executor receives the node's resolved input values and a {@link GraphExecutionContext}, and returns the node's output values.
+ * @summary Node executor contract (DECAF-50 §4.9, post-cutover).
+ * @description The single executor contract: executors receive a
+ * {@link GraphNodeExecutionRequest} that separates configuration
+ * (`parameters`, `credentials`, `metadata`) from input data (`inputs`).
+ * The §4.18 transition artifacts (legacy input-only contract, the
+ * compatibility adapter, and the request-executor marker) were removed at
+ * the P7 cutover.
  */
 import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
-import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
 /**
- * Executor for a specific graph node kind.
+ * Executor for a specific graph node kind (DECAF-50 §4.9 request contract).
  *
  * Implementations are registered in the {@link GraphNodeExecutorRegistry}
- * and resolved by the engine using the node's `kind`.
+ * (a facade over the backend catalogue) and always receive the full
+ * {@link GraphNodeExecutionRequest}; configuration and input data are
+ * separated.
  */
-export interface GraphNodeExecutor<Input extends GraphExecutionValues = GraphExecutionValues, Output extends GraphExecutionValues = GraphExecutionValues> {
+export interface GraphNodeExecutor<Output extends GraphExecutionValues = GraphExecutionValues> {
     /**
-     * Executes the node logic.
+     * Executes the node logic with configuration and input data separated.
      *
-     * @param input - Resolved input values keyed by port name.
+     * @param request - The node execution request (inputs, parameters,
+     * credentials, metadata).
      * @param context - Decaf context for emitting progress and events.
      * @returns The node's output values keyed by port name.
      */
-    execute(input: Input, context: GraphExecutionContext): Promise<Output> | Output;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<Output> | Output;
 }

package/lib/types/graph/engine/execution/GraphNodeExecutor.d.mts

@@ -1,23 +1,31 @@
 /**
  * @module integrations/graph/execution/GraphNodeExecutor
- * @summary Interface implemented by every graph node executor.
- * @description A node executor receives the node's resolved input values and a {@link GraphExecutionContext}, and returns the node's output values.
+ * @summary Node executor contract (DECAF-50 §4.9, post-cutover).
+ * @description The single executor contract: executors receive a
+ * {@link GraphNodeExecutionRequest} that separates configuration
+ * (`parameters`, `credentials`, `metadata`) from input data (`inputs`).
+ * The §4.18 transition artifacts (legacy input-only contract, the
+ * compatibility adapter, and the request-executor marker) were removed at
+ * the P7 cutover.
  */
 import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
-import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
 /**
- * Executor for a specific graph node kind.
+ * Executor for a specific graph node kind (DECAF-50 §4.9 request contract).
  *
  * Implementations are registered in the {@link GraphNodeExecutorRegistry}
- * and resolved by the engine using the node's `kind`.
+ * (a facade over the backend catalogue) and always receive the full
+ * {@link GraphNodeExecutionRequest}; configuration and input data are
+ * separated.
  */
-export interface GraphNodeExecutor<Input extends GraphExecutionValues = GraphExecutionValues, Output extends GraphExecutionValues = GraphExecutionValues> {
+export interface GraphNodeExecutor<Output extends GraphExecutionValues = GraphExecutionValues> {
     /**
-     * Executes the node logic.
+     * Executes the node logic with configuration and input data separated.
      *
-     * @param input - Resolved input values keyed by port name.
+     * @param request - The node execution request (inputs, parameters,
+     * credentials, metadata).
      * @param context - Decaf context for emitting progress and events.
      * @returns The node's output values keyed by port name.
      */
-    execute(input: Input, context: GraphExecutionContext): Promise<Output> | Output;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<Output> | Output;
 }

package/lib/types/graph/engine/execution/LogGraphNodeExecutor.d.cts

@@ -1,6 +1,6 @@
 import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.cts";
 import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
-import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
 /**
  * Executor for `core.utility.log` / `core.flow.log` nodes.
  *
@@ -17,9 +17,9 @@ export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
      * the DECAF-48 run attributes and streams over `graph.run.log` through the
      * shared `ctx.logger` path (DECAF-48 Req-1).
      *
-     * @param input - Resolved input values keyed by port name (expects `value`).
+     * @param request - The node execution request (expects the `value` input).
      * @param context - The run-scoped execution context exposing `ctx.logger`.
      * @returns The node's output values keyed by port name (the `logged` port).
      */
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
 }

package/lib/types/graph/engine/execution/LogGraphNodeExecutor.d.mts

@@ -1,6 +1,6 @@
 import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
 import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
-import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
 /**
  * Executor for `core.utility.log` / `core.flow.log` nodes.
  *
@@ -17,9 +17,9 @@ export declare class LogGraphNodeExecutor implements GraphNodeExecutor {
      * the DECAF-48 run attributes and streams over `graph.run.log` through the
      * shared `ctx.logger` path (DECAF-48 Req-1).
      *
-     * @param input - Resolved input values keyed by port name (expects `value`).
+     * @param request - The node execution request (expects the `value` input).
      * @param context - The run-scoped execution context exposing `ctx.logger`.
      * @returns The node's output values keyed by port name (the `logged` port).
      */
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
 }

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.cts

@@ -9,7 +9,7 @@
  */
 import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.cts";
 import type { GraphExecutionContext } from "./GraphExecutionContext.d.cts";
-import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
 import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.cts";
 /**
  * Executor for `core.flow.switch` nodes.
@@ -31,7 +31,7 @@ export declare class SwitchGraphNodeExecutor implements GraphNodeExecutor {
     constructor(engine?: {
         codeSandboxEvaluator?: CodeSandboxEvaluator;
     } | undefined);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     /**
      * Evaluates a single switch case condition.
      */

package/lib/types/graph/engine/execution/SwitchGraphNodeExecutor.d.mts

@@ -9,7 +9,7 @@
  */
 import type { GraphNodeExecutor } from "./GraphNodeExecutor.d.mts";
 import type { GraphExecutionContext } from "./GraphExecutionContext.d.mts";
-import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
 import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
 /**
  * Executor for `core.flow.switch` nodes.
@@ -31,7 +31,7 @@ export declare class SwitchGraphNodeExecutor implements GraphNodeExecutor {
     constructor(engine?: {
         codeSandboxEvaluator?: CodeSandboxEvaluator;
     } | undefined);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     /**
      * Evaluates a single switch case condition.
      */

package/lib/types/graph/engine/index.d.cts

@@ -4,11 +4,9 @@
  * @description Reference interpreter for Decaf graph workflows. Executes
  * workflows declared with `@decaf-ts/ui-decorators/graph`, emits events
  * through Decaf's Observable pipeline, supports structured loops, configurable
- * value stores, and pinnable/cacheable nodes.
- *
- * Re-exports `../shared` so backend consumers have a single import surface.
+ * value stores, and pinnable/cacheable nodes. Frontend-safe shared
+ * declarations live in `@decaf-ts/ui-decorators/graph`.
  */
-export * from "../shared/index.d.cts";
 export * from "./constants.d.cts";
 export * from "./types.d.cts";
 export * from "./decorators.d.cts";
@@ -21,7 +19,7 @@ export * from "./errors/GraphPortError.d.cts";
 export * from "./errors/GraphStoreError.d.cts";
 export * from "./errors/GraphTopologyError.d.cts";
 export * from "./errors/GraphBreakSignal.d.cts";
-export * from "./events/GraphExecutionEvent.d.cts";
+export * from "./errors/GraphRunCancelledError.d.cts";
 export * from "./events/GraphExecutionObserver.d.cts";
 export * from "./events/GraphExecutionEventEmitter.d.cts";
 export * from "./events/GraphExecutionEventFactory.d.cts";
@@ -38,6 +36,7 @@ export * from "./execution/BreakGraphNodeExecutor.d.cts";
 export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.cts";
 export * from "./registry/GraphNodeExecutorRegistry.d.cts";
 export * from "./registry/GraphNodeExecutorResolver.d.cts";
+export * from "./catalog/index.d.cts";
 export * from "./store/GraphValueKey.d.cts";
 export * from "./store/GraphCachedValue.d.cts";
 export * from "./store/GraphValueStoreAdapter.d.cts";
@@ -47,12 +46,9 @@ export * from "./planning/GraphExecutionPlanNode.d.cts";
 export * from "./planning/GraphExecutionPlanEdge.d.cts";
 export * from "./planning/GraphExecutionPlanLayer.d.cts";
 export * from "./planning/GraphExecutionPlan.d.cts";
-export * from "./planning/GraphRelationResolver.d.cts";
 export * from "./planning/GraphExecutionPlanner.d.cts";
 export * from "./planning/GraphTopology.d.cts";
-export * from "./validation/GraphDefinitionValidator.d.cts";
-export * from "./validation/GraphPortSchemaResolver.d.cts";
-export * from "./validation/GraphValueValidator.d.cts";
+export * from "./validation/index.d.cts";
 export * from "./loops/GraphConditionEvaluator.d.cts";
 export * from "./loops/ConditionExpressionEvaluator.d.cts";
 export * from "./loops/GraphLoopExecutionContext.d.cts";
@@ -63,4 +59,5 @@ export * from "./pinning/GraphPinningMetadata.d.cts";
 export * from "./pinning/GraphPinningPolicy.d.cts";
 export * from "./pinning/GraphPinningDependencyResolver.d.cts";
 export * from "./pinning/GraphPinningService.d.cts";
+export * from "./runs/index.d.cts";
 export * from "./snapshots/GraphExecutionSnapshotMapper.d.cts";

package/lib/types/graph/engine/index.d.mts

@@ -4,11 +4,9 @@
  * @description Reference interpreter for Decaf graph workflows. Executes
  * workflows declared with `@decaf-ts/ui-decorators/graph`, emits events
  * through Decaf's Observable pipeline, supports structured loops, configurable
- * value stores, and pinnable/cacheable nodes.
- *
- * Re-exports `../shared` so backend consumers have a single import surface.
+ * value stores, and pinnable/cacheable nodes. Frontend-safe shared
+ * declarations live in `@decaf-ts/ui-decorators/graph`.
  */
-export * from "../shared/index.d.mts";
 export * from "./constants.d.mts";
 export * from "./types.d.mts";
 export * from "./decorators.d.mts";
@@ -21,7 +19,7 @@ export * from "./errors/GraphPortError.d.mts";
 export * from "./errors/GraphStoreError.d.mts";
 export * from "./errors/GraphTopologyError.d.mts";
 export * from "./errors/GraphBreakSignal.d.mts";
-export * from "./events/GraphExecutionEvent.d.mts";
+export * from "./errors/GraphRunCancelledError.d.mts";
 export * from "./events/GraphExecutionObserver.d.mts";
 export * from "./events/GraphExecutionEventEmitter.d.mts";
 export * from "./events/GraphExecutionEventFactory.d.mts";
@@ -38,6 +36,7 @@ export * from "./execution/BreakGraphNodeExecutor.d.mts";
 export * from "./execution/IsolatedVmCodeSandboxEvaluator.d.mts";
 export * from "./registry/GraphNodeExecutorRegistry.d.mts";
 export * from "./registry/GraphNodeExecutorResolver.d.mts";
+export * from "./catalog/index.d.mts";
 export * from "./store/GraphValueKey.d.mts";
 export * from "./store/GraphCachedValue.d.mts";
 export * from "./store/GraphValueStoreAdapter.d.mts";
@@ -47,12 +46,9 @@ export * from "./planning/GraphExecutionPlanNode.d.mts";
 export * from "./planning/GraphExecutionPlanEdge.d.mts";
 export * from "./planning/GraphExecutionPlanLayer.d.mts";
 export * from "./planning/GraphExecutionPlan.d.mts";
-export * from "./planning/GraphRelationResolver.d.mts";
 export * from "./planning/GraphExecutionPlanner.d.mts";
 export * from "./planning/GraphTopology.d.mts";
-export * from "./validation/GraphDefinitionValidator.d.mts";
-export * from "./validation/GraphPortSchemaResolver.d.mts";
-export * from "./validation/GraphValueValidator.d.mts";
+export * from "./validation/index.d.mts";
 export * from "./loops/GraphConditionEvaluator.d.mts";
 export * from "./loops/ConditionExpressionEvaluator.d.mts";
 export * from "./loops/GraphLoopExecutionContext.d.mts";
@@ -63,4 +59,5 @@ export * from "./pinning/GraphPinningMetadata.d.mts";
 export * from "./pinning/GraphPinningPolicy.d.mts";
 export * from "./pinning/GraphPinningDependencyResolver.d.mts";
 export * from "./pinning/GraphPinningService.d.mts";
+export * from "./runs/index.d.mts";
 export * from "./snapshots/GraphExecutionSnapshotMapper.d.mts";

package/lib/types/graph/engine/loops/ConditionExpressionEvaluator.d.cts

@@ -5,7 +5,7 @@
  * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
  * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
  */
-import type { ConditionExpression } from "../../shared/types.d.cts";
+import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
 /**
  * Evaluates a {@link ConditionExpression} against the given state.
  *

package/lib/types/graph/engine/loops/ConditionExpressionEvaluator.d.mts

@@ -5,7 +5,7 @@
  * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
  * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
  */
-import type { ConditionExpression } from "../../shared/types.d.mts";
+import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
 /**
  * Evaluates a {@link ConditionExpression} against the given state.
  *

package/lib/types/graph/engine/loops/ForeachGraphNodeExecutor.d.cts

@@ -9,7 +9,7 @@
 import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
 import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
 import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
 /**
  * Executor for `core.loop.foreach` nodes.
  *
@@ -30,6 +30,6 @@ import type { GraphExecutionValues } from "../types.d.cts";
 export declare class ForeachGraphNodeExecutor implements GraphNodeExecutor {
     private readonly engine;
     constructor(engine: GraphExecutionEngine);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     private extractMetadata;
 }

package/lib/types/graph/engine/loops/ForeachGraphNodeExecutor.d.mts

@@ -9,7 +9,7 @@
 import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
 import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
 import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
 /**
  * Executor for `core.loop.foreach` nodes.
  *
@@ -30,6 +30,6 @@ import type { GraphExecutionValues } from "../types.d.mts";
 export declare class ForeachGraphNodeExecutor implements GraphNodeExecutor {
     private readonly engine;
     constructor(engine: GraphExecutionEngine);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     private extractMetadata;
 }

package/lib/types/graph/engine/loops/GraphConditionEvaluator.d.cts

@@ -6,7 +6,7 @@
  * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
  */
 import type { GraphConditionDefinition } from "../types.d.cts";
-import type { ConditionExpression } from "../../shared/types.d.cts";
+import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
 /**
  * Evaluates loop conditions using built-in comparison types or the
  * `ConditionExpression` DSL.

package/lib/types/graph/engine/loops/GraphConditionEvaluator.d.mts

@@ -6,7 +6,7 @@
  * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
  */
 import type { GraphConditionDefinition } from "../types.d.mts";
-import type { ConditionExpression } from "../../shared/types.d.mts";
+import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
 /**
  * Evaluates loop conditions using built-in comparison types or the
  * `ConditionExpression` DSL.

package/lib/types/graph/engine/loops/UntilGraphNodeExecutor.d.cts

@@ -6,7 +6,7 @@
 import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
 import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
 import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
 /**
  * Executor for `core.loop.until` nodes.
  *
@@ -17,6 +17,6 @@ export declare class UntilGraphNodeExecutor implements GraphNodeExecutor {
     private readonly engine;
     private readonly evaluator;
     constructor(engine: GraphExecutionEngine);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     private extractMetadata;
 }

package/lib/types/graph/engine/loops/UntilGraphNodeExecutor.d.mts

@@ -6,7 +6,7 @@
 import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
 import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
 import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
 /**
  * Executor for `core.loop.until` nodes.
  *
@@ -17,6 +17,6 @@ export declare class UntilGraphNodeExecutor implements GraphNodeExecutor {
     private readonly engine;
     private readonly evaluator;
     constructor(engine: GraphExecutionEngine);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     private extractMetadata;
 }

package/lib/types/graph/engine/loops/WhileGraphNodeExecutor.d.cts

@@ -6,7 +6,7 @@
 import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.cts";
 import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.cts";
 import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.cts";
-import type { GraphExecutionValues } from "../types.d.cts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.cts";
 /**
  * Executor for `core.loop.while` nodes.
  *
@@ -21,6 +21,6 @@ export declare class WhileGraphNodeExecutor implements GraphNodeExecutor {
     private readonly engine;
     private readonly evaluator;
     constructor(engine: GraphExecutionEngine);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     private extractMetadata;
 }

package/lib/types/graph/engine/loops/WhileGraphNodeExecutor.d.mts

@@ -6,7 +6,7 @@
 import type { GraphNodeExecutor } from "../execution/GraphNodeExecutor.d.mts";
 import type { GraphExecutionContext } from "../execution/GraphExecutionContext.d.mts";
 import type { GraphExecutionEngine } from "../execution/GraphExecutionEngine.d.mts";
-import type { GraphExecutionValues } from "../types.d.mts";
+import type { GraphExecutionValues, GraphNodeExecutionRequest } from "../types.d.mts";
 /**
  * Executor for `core.loop.while` nodes.
  *
@@ -21,6 +21,6 @@ export declare class WhileGraphNodeExecutor implements GraphNodeExecutor {
     private readonly engine;
     private readonly evaluator;
     constructor(engine: GraphExecutionEngine);
-    execute(input: GraphExecutionValues, context: GraphExecutionContext): Promise<GraphExecutionValues>;
+    execute(request: GraphNodeExecutionRequest, context: GraphExecutionContext): Promise<GraphExecutionValues>;
     private extractMetadata;
 }

package/lib/types/graph/engine/pinning/GraphPinningService.d.cts

@@ -3,7 +3,6 @@ import type { GraphValueStore } from "../store/GraphValueStore.d.cts";
 import type { GraphValueKey } from "../store/GraphValueKey.d.cts";
 import type { GraphCachedValue } from "../store/GraphCachedValue.d.cts";
 import type { GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.cts";
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
 import type { GraphPinningPolicy } from "./GraphPinningPolicy.d.cts";
 import type { GraphPinningDependencyResolver } from "./GraphPinningDependencyResolver.d.cts";
 /**
@@ -28,15 +27,27 @@ export declare class GraphPinningService {
      * Reads a pinned value for a node, returning `undefined` when no valid
      * pinned value exists.
      */
-    readPinnedValue(workflow: GraphWorkflowDefinition, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): Promise<GraphCachedValue | undefined>;
+    readPinnedValue(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): Promise<GraphCachedValue | undefined>;
     /**
      * Creates a stable value key for a node.
      */
-    createValueKey(workflow: GraphWorkflowDefinition, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): GraphValueKey;
+    createValueKey(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): GraphValueKey;
     /**
-     * Computes a stable fingerprint for a node's inputs and dependencies.
+     * Computes a stable fingerprint for a node (DECAF-50 §4.9).
+     *
+     * The fingerprint derives from the node kind, the instance parameters, the
+     * input bindings, the effective input values, relevant instance metadata,
+     * and the configured dependency fingerprints. Presentation-only UI state is
+     * excluded: the instance `ui` record is never read, and a `ui` key inside
+     * metadata is stripped, so canvas positions and visual settings cannot
+     * affect pinning.
+     */
+    computeFingerprint(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>): string;
+    /**
+     * Strips presentation-only keys (`ui` and UI-state shapes) from the node's
+     * instance metadata, leaving only pinning-relevant metadata.
      */
-    computeFingerprint(workflow: GraphWorkflowDefinition, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>): string;
+    private relevantMetadata;
     /**
      * Returns a topological ordering of the given node set.
      */

package/lib/types/graph/engine/pinning/GraphPinningService.d.mts

@@ -3,7 +3,6 @@ import type { GraphValueStore } from "../store/GraphValueStore.d.mts";
 import type { GraphValueKey } from "../store/GraphValueKey.d.mts";
 import type { GraphCachedValue } from "../store/GraphCachedValue.d.mts";
 import type { GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.mts";
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
 import type { GraphPinningPolicy } from "./GraphPinningPolicy.d.mts";
 import type { GraphPinningDependencyResolver } from "./GraphPinningDependencyResolver.d.mts";
 /**
@@ -28,15 +27,27 @@ export declare class GraphPinningService {
      * Reads a pinned value for a node, returning `undefined` when no valid
      * pinned value exists.
      */
-    readPinnedValue(workflow: GraphWorkflowDefinition, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): Promise<GraphCachedValue | undefined>;
+    readPinnedValue(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): Promise<GraphCachedValue | undefined>;
     /**
      * Creates a stable value key for a node.
      */
-    createValueKey(workflow: GraphWorkflowDefinition, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): GraphValueKey;
+    createValueKey(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): GraphValueKey;
     /**
-     * Computes a stable fingerprint for a node's inputs and dependencies.
+     * Computes a stable fingerprint for a node (DECAF-50 §4.9).
+     *
+     * The fingerprint derives from the node kind, the instance parameters, the
+     * input bindings, the effective input values, relevant instance metadata,
+     * and the configured dependency fingerprints. Presentation-only UI state is
+     * excluded: the instance `ui` record is never read, and a `ui` key inside
+     * metadata is stripped, so canvas positions and visual settings cannot
+     * affect pinning.
+     */
+    computeFingerprint(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>): string;
+    /**
+     * Strips presentation-only keys (`ui` and UI-state shapes) from the node's
+     * instance metadata, leaving only pinning-relevant metadata.
      */
-    computeFingerprint(workflow: GraphWorkflowDefinition, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>): string;
+    private relevantMetadata;
     /**
      * Returns a topological ordering of the given node set.
      */

package/lib/types/graph/engine/planning/GraphExecutionPlan.d.cts

@@ -1,9 +1,11 @@
 /**
  * @module integrations/graph/planning/GraphExecutionPlan
- * @summary The complete execution plan for a workflow.
- * @description Contains resolved nodes, edges, topological layers, and incoming/outgoing maps.
+ * @summary The complete execution plan for a workflow (DECAF-50 §4.9).
+ * @description Contains the resolved workflow, catalogue-resolved plan nodes,
+ * validated edges, topological layers, and incoming/outgoing maps. Plans are
+ * produced exclusively from a {@link GraphResolvedWorkflow}.
  */
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphResolvedWorkflow } from "../validation/GraphResolvedWorkflow.d.cts";
 import type { GraphExecutionPlanNode } from "./GraphExecutionPlanNode.d.cts";
 import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.cts";
 import type { GraphExecutionPlanLayer } from "./GraphExecutionPlanLayer.d.cts";
@@ -11,7 +13,9 @@ import type { GraphExecutionPlanLayer } from "./GraphExecutionPlanLayer.d.cts";
  * The resolved execution plan for a single workflow.
  */
 export interface GraphExecutionPlan {
-    workflow: GraphWorkflowDefinition;
+    /** The validated, catalogue-resolved workflow this plan was built from. */
+    resolved: GraphResolvedWorkflow;
+    /** The canonical document id. */
     workflowId: string;
     nodes: GraphExecutionPlanNode[];
     edges: GraphExecutionPlanEdge[];

package/lib/types/graph/engine/planning/GraphExecutionPlan.d.mts

@@ -1,9 +1,11 @@
 /**
  * @module integrations/graph/planning/GraphExecutionPlan
- * @summary The complete execution plan for a workflow.
- * @description Contains resolved nodes, edges, topological layers, and incoming/outgoing maps.
+ * @summary The complete execution plan for a workflow (DECAF-50 §4.9).
+ * @description Contains the resolved workflow, catalogue-resolved plan nodes,
+ * validated edges, topological layers, and incoming/outgoing maps. Plans are
+ * produced exclusively from a {@link GraphResolvedWorkflow}.
  */
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
+import type { GraphResolvedWorkflow } from "../validation/GraphResolvedWorkflow.d.mts";
 import type { GraphExecutionPlanNode } from "./GraphExecutionPlanNode.d.mts";
 import type { GraphExecutionPlanEdge } from "./GraphExecutionPlanEdge.d.mts";
 import type { GraphExecutionPlanLayer } from "./GraphExecutionPlanLayer.d.mts";
@@ -11,7 +13,9 @@ import type { GraphExecutionPlanLayer } from "./GraphExecutionPlanLayer.d.mts";
  * The resolved execution plan for a single workflow.
  */
 export interface GraphExecutionPlan {
-    workflow: GraphWorkflowDefinition;
+    /** The validated, catalogue-resolved workflow this plan was built from. */
+    resolved: GraphResolvedWorkflow;
+    /** The canonical document id. */
     workflowId: string;
     nodes: GraphExecutionPlanNode[];
     edges: GraphExecutionPlanEdge[];