@decaf-ts/integrations 0.7.0 → 0.9.0

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

@@ -1,15 +1,32 @@
 /**
  * @module integrations/graph/execution/GraphExecutionEngine
- * @summary Reference graph execution engine.
- * @description Executes graph workflows declared with `@decaf-ts/ui-decorators/graph`, emits events through Decaf's Observable pipeline, supports parallel node execution within topological layers, and returns a complete execution result. Per DECAF-48 §4.4 it also emits `NODE_STATE_CHANGED` / `EDGE_STATE_CHANGED` visual-state events on the same pipeline, and node executors log through the run-scoped `ctx.logger` (streamed over the `graph.run.log` SSE channel).
+ * @summary Reference graph execution engine (DECAF-50 §4.9).
+ * @description Executes canonical {@link GraphWorkflowDocument}s. The public
+ * `execute(document, inputs, options)` entrypoint performs resolution
+ * internally: the document runs through the nine-stage §4.8 validation gate
+ * (structured issue accumulation), is resolved against the trusted backend
+ * catalogue into a {@link GraphResolvedWorkflow}, planned by the
+ * {@link GraphExecutionPlanner} (resolved workflows only — never raw
+ * definitions), and executed layer by layer. Node inputs are built from
+ * routed edges, literal bindings, allowed expressions, manifest defaults,
+ * and node parameters; configuration and input data are separated in the
+ * {@link GraphNodeExecutionRequest}. Executor outputs are validated against
+ * the effective output manifest. Disabled nodes follow the explicit
+ * {@link GraphDisabledNodeBehavior} semantics. Events are emitted through
+ * Decaf's Observable pipeline, including the DECAF-48 §4.4 visual-state
+ * events and the `graph.run.log` run-log channel.
  */
 import type { Observable } from "@decaf-ts/core";
-import type { GraphWorkflowDefinition } from "@decaf-ts/ui-decorators/graph";
-import type { GraphExecutionEvent, GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.mts";
+import type { GraphWorkflowDocument } from "@decaf-ts/ui-decorators/graph";
+import type { GraphExecutionEvent } from "@decaf-ts/ui-decorators/graph";
+import type { GraphExecutionOptions, GraphExecutionResult, GraphExecutionValues, GraphPinNodeOptions, GraphUnpinNodeOptions } from "../types.d.mts";
 import type { GraphExecutionObserver } from "../events/GraphExecutionObserver.d.mts";
 import { GraphExecutionEventEmitter } from "../events/GraphExecutionEventEmitter.d.mts";
 import type { GraphNodeExecutorRegistry } from "../registry/GraphNodeExecutorRegistry.d.mts";
+import type { GraphNodeCatalogue } from "../catalog/GraphNodeCatalogue.d.mts";
 import { GraphExecutionPlanner } from "../planning/GraphExecutionPlanner.d.mts";
+import { GraphWorkflowDocumentValidator, type GraphWorkflowDocumentValidationLimits } from "../validation/GraphWorkflowDocumentValidator.d.mts";
+import type { GraphCredentialAuthorizer } from "../validation/GraphCredentialReferenceValidator.d.mts";
 import type { GraphValueStoreAdapter } from "../store/GraphValueStoreAdapter.d.mts";
 import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
 /**
@@ -17,15 +34,27 @@ import type { CodeSandboxEvaluator } from "./CodeSandboxEvaluator.d.mts";
  */
 export interface GraphExecutionEngineConfig {
     registry: GraphNodeExecutorRegistry;
+    /**
+     * Trusted backend kind catalogue. Defaults to the registry facade's
+     * catalogue; required for the nine-stage document validation gate.
+     */
+    catalogue?: GraphNodeCatalogue;
+    /** Optional pre-configured document validator (overrides catalogue/limits). */
+    documentValidator?: GraphWorkflowDocumentValidator;
+    /** Backend-enforced document resource limits (§4.8 stage 1). */
+    documentLimits?: GraphWorkflowDocumentValidationLimits;
+    /** Pluggable credential existence/authorization hook (§4.8 stage 8). */
+    credentialAuthorizer?: GraphCredentialAuthorizer;
     planner?: GraphExecutionPlanner;
     valueStoreAdapter?: GraphValueStoreAdapter;
     eventEmitter?: GraphExecutionEventEmitter;
     defaultOptions?: Partial<GraphExecutionOptions>;
     /**
-     * Optional pluggable code sandbox evaluator for code-based conditions
-     * (DECAF-32 §22.4). When absent, code conditions throw
-     * `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`. Downstream projects (e.g. ALFRED)
-     * supply the actual VM sandbox implementation.
+     * Optional pluggable code sandbox evaluator for code-based conditions and
+     * expression bindings (DECAF-32 §22.4). When absent, code conditions and
+     * expression bindings throw `GRAPH_CODE_SANDBOX_NOT_CONFIGURED`.
+     * Downstream projects (e.g. ALFRED) supply the actual VM sandbox
+     * implementation.
      */
     codeSandboxEvaluator?: CodeSandboxEvaluator;
     /**
@@ -39,19 +68,27 @@ export interface GraphExecutionEngineConfig {
 /**
  * Reference graph execution engine.
  *
- * Executes a {@link GraphWorkflowDefinition} by:
- * 1. Planning the workflow into topological layers.
- * 2. Seeding workflow inputs into the value store.
- * 3. Executing nodes layer-by-layer with configurable concurrency.
- * 4. Routing values along edges.
- * 5. Emitting structured events through Decaf's Observable pipeline.
- * 6. Returning a complete {@link GraphExecutionResult}.
+ * Executes a canonical {@link GraphWorkflowDocument} by:
+ * 1. Validating it through the nine-stage gate and resolving it against the
+ *    backend catalogue (§4.8).
+ * 2. Planning the resolved workflow into topological layers (§4.9).
+ * 3. Seeding workflow inputs into the value store.
+ * 4. Executing nodes layer-by-layer with configurable concurrency, honouring
+ *    disabled-node semantics.
+ * 5. Building node inputs from routed edges, literal bindings, allowed
+ *    expressions, and manifest defaults; keeping configuration (parameters,
+ *    credentials) separate from input data.
+ * 6. Validating executor outputs against the effective output manifest.
+ * 7. Routing values along data edges.
+ * 8. Emitting structured events through Decaf's Observable pipeline.
+ * 9. Returning a complete {@link GraphExecutionResult}.
  */
 export declare class GraphExecutionEngine implements Observable<[GraphExecutionObserver], [GraphExecutionEvent]> {
     private readonly emitter;
     private readonly planner;
     private readonly valueStoreAdapter;
     private readonly defaultOptions;
+    private readonly documentValidator;
     /** Pluggable code sandbox evaluator (§22.4); may be undefined. */
     readonly codeSandboxEvaluator?: CodeSandboxEvaluator;
     constructor(config: GraphExecutionEngineConfig);
@@ -76,15 +113,22 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      */
     updateObservers(event: GraphExecutionEvent): Promise<void>;
     /**
-     * Executes a workflow with the given inputs and options.
+     * Executes a canonical workflow document with the given inputs and options.
      *
-     * @param workflow - The workflow definition to execute.
-     * @param inputs - Workflow input values keyed by input port name.
+     * Resolution happens internally (DECAF-50 §4.9): the document is validated
+     * through the nine-stage gate and resolved against the backend catalogue
+     * before planning. Decorated `GraphWorkflowDefinition` objects are NOT
+     * accepted — compile them with the §4.18 transition compiler first.
+     *
+     * @param document - The canonical workflow document to execute.
+     * @param inputs - Workflow input values keyed by input port id.
      * @param options - Optional execution overrides (merged over the defaults).
      * @returns The complete execution result, including a `runId`, per-node
-     * results, and workflow outputs (or the failure payload).
+     *   results, and workflow outputs (or the failure payload).
+     * @throws {GraphDocumentValidationError} when the document fails the
+     *   nine-stage validation gate (carries every structured issue).
      */
-    execute(workflow: GraphWorkflowDefinition, inputs?: GraphExecutionValues, options?: GraphExecutionOptions): Promise<GraphExecutionResult>;
+    execute(document: GraphWorkflowDocument, inputs?: GraphExecutionValues, options?: GraphExecutionOptions): Promise<GraphExecutionResult>;
     /**
      * Pins a node and its upstream dependencies after a completed run.
      *
@@ -105,16 +149,46 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      * Emits a pinning-related event to all observers.
      */
     private emitPinningEvent;
+    /**
+     * Fills unprovided workflow inputs with their declared port defaults.
+     */
+    private withWorkflowInputDefaults;
     /**
      * Executes a layer of nodes with the configured concurrency.
      */
     private executeLayer;
     /**
-     * Executes a single node.
+     * Executes a single node, honouring disabled-node semantics (§4.9).
      */
     private executeNode;
     /**
-     * Resolves a node's input values from incoming edges.
+     * Applies the explicit disabled-node semantics (§4.9):
+     * `skip`, `passThroughFirstInput`, or `emitDefaults`, resolved from the
+     * instance metadata, document settings, and the default.
+     */
+    private executeDisabledNode;
+    /**
+     * Invokes the node's catalogue-resolved executor (§4.9 request contract,
+     * post-cutover: every executor receives the full request with
+     * configuration and input data separated).
+     */
+    private invokeExecutor;
+    /**
+     * Validates executor outputs against the effective output manifest
+     * (§4.9): unknown outputs are rejected by default; missing required
+     * outputs fail the node. Lenient transition manifests (legacy
+     * executor-only registrations) are exempt until cutover.
+     */
+    private validateNodeOutputs;
+    /**
+     * Collects the resolved credential references for a node: credential-type
+     * parameter values plus the `credentials` record in instance metadata.
+     * Documents carry references only — secret material never enters requests.
+     */
+    private collectCredentials;
+    /**
+     * Resolves a node's input values from routed data edges, literal bindings,
+     * allowed expression bindings, and manifest port defaults (§4.9).
      *
      * When multiple edges target the same port, their values are spread into the
      * top-level inputs keyed by each edge's `sourcePort`. This allows multiple
@@ -123,6 +197,13 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      * `$input.{sourcePort}` (e.g. `$input.count`, `$input.text`).
      */
     private resolveNodeInputs;
+    /**
+     * Evaluates an expression binding with the EXISTING allowed-expression
+     * machinery only (the pluggable {@link CodeSandboxEvaluator}, DECAF-32
+     * §22.4) — no new evaluator. The expression sees the already-routed input
+     * values as `$input` and the run metadata as context.
+     */
+    private evaluateExpressionBinding;
     /**
      * Attempts to read a pinned value for the node. Returns the cached outputs
      * when a valid pinned value exists, or `undefined` to proceed with normal
@@ -135,7 +216,8 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      */
     private computeDependencyFingerprints;
     /**
-     * Routes a node's outputs to downstream inputs and workflow outputs.
+     * Routes a node's outputs to downstream inputs and workflow outputs along
+     * data edges (connection edges are structural and never route values).
      */
     private routeOutgoingEdges;
     /**
@@ -157,6 +239,7 @@ export declare class GraphExecutionEngine implements Observable<[GraphExecutionO
      * Merges default options with the given options.
      */
     private mergeOptions;
+    private assertNotAborted;
     /**
      * Generates a unique run id.
      */

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;
 }