@decaf-ts/integrations 0.10.8 → 0.12.0

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

@@ -1,56 +0,0 @@
-/**
- * @module integrations/graph/engine
- * @summary Graph execution engine (backend-only).
- * @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. Frontend-safe shared
- * declarations live in `@decaf-ts/ui-decorators/graph`.
- */
-export * from "./constants.d.cts";
-export * from "./types.d.cts";
-export * from "./decorators.d.cts";
-export * from "./errors/GraphExecutionError.d.cts";
-export * from "./errors/GraphCycleError.d.cts";
-export * from "./errors/GraphInputError.d.cts";
-export * from "./errors/GraphLoopLimitError.d.cts";
-export * from "./errors/GraphPinningError.d.cts";
-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 "./errors/GraphRunCancelledError.d.cts";
-export * from "./events/GraphExecutionObserver.d.cts";
-export * from "./events/GraphExecutionEventEmitter.d.cts";
-export * from "./events/GraphExecutionEventFactory.d.cts";
-export * from "./execution/GraphExecutionContext.d.cts";
-export * from "./execution/GraphNodeExecutor.d.cts";
-export * from "./execution/GraphExecutionFrame.d.cts";
-export * from "./execution/GraphExecutionResult.d.cts";
-export * from "./execution/GraphExecutionEngine.d.cts";
-export * from "./execution/CodeSandboxEvaluator.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";
-export * from "./store/InMemoryGraphValueStoreAdapter.d.cts";
-export * from "./store/GraphValueStore.d.cts";
-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/GraphExecutionPlanner.d.cts";
-export * from "./planning/GraphTopology.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";
-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

@@ -1,56 +0,0 @@
-/**
- * @module integrations/graph/engine
- * @summary Graph execution engine (backend-only).
- * @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. Frontend-safe shared
- * declarations live in `@decaf-ts/ui-decorators/graph`.
- */
-export * from "./constants.d.mts";
-export * from "./types.d.mts";
-export * from "./decorators.d.mts";
-export * from "./errors/GraphExecutionError.d.mts";
-export * from "./errors/GraphCycleError.d.mts";
-export * from "./errors/GraphInputError.d.mts";
-export * from "./errors/GraphLoopLimitError.d.mts";
-export * from "./errors/GraphPinningError.d.mts";
-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 "./errors/GraphRunCancelledError.d.mts";
-export * from "./events/GraphExecutionObserver.d.mts";
-export * from "./events/GraphExecutionEventEmitter.d.mts";
-export * from "./events/GraphExecutionEventFactory.d.mts";
-export * from "./execution/GraphExecutionContext.d.mts";
-export * from "./execution/GraphNodeExecutor.d.mts";
-export * from "./execution/GraphExecutionFrame.d.mts";
-export * from "./execution/GraphExecutionResult.d.mts";
-export * from "./execution/GraphExecutionEngine.d.mts";
-export * from "./execution/CodeSandboxEvaluator.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";
-export * from "./store/InMemoryGraphValueStoreAdapter.d.mts";
-export * from "./store/GraphValueStore.d.mts";
-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/GraphExecutionPlanner.d.mts";
-export * from "./planning/GraphTopology.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";
-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

@@ -1,36 +0,0 @@
-/**
- * @module integrations/graph/loops/ConditionExpressionEvaluator
- * @summary Evaluator for the ALFRED-5 `ConditionExpression` DSL (DECAF-32 §22.3).
- * @description Evaluates declarative, serializable condition expressions with
- * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
- * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
- */
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates a {@link ConditionExpression} against the given state.
- *
- * `ExprValue` resolution:
- * - `{ const: x }` → the literal value `x`.
- * - `{ path: "a.b" }` → dotted-path lookup into `state`.
- * - `{ step: "nodeId", path: "out" }` → cross-node reference; in v1 the state
- *   is expected to contain a `nodes` map keyed by node id (reserved for future
- *   multi-step evaluation; falls back to `state` lookup when absent).
- */
-export declare class ConditionExpressionEvaluator {
-    /**
-     * Evaluates a condition expression to a boolean.
-     *
-     * @param expr - The condition expression.
-     * @param state - The current evaluation state (loop state or execution values).
-     * @returns `true` when the expression evaluates to a truthy/positive result.
-     */
-    evaluate(expr: ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves an {@link ExprValue} against the current state.
-     */
-    private resolveValue;
-    /**
-     * Resolves a dotted path into a target object.
-     */
-    private resolvePath;
-}

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

@@ -1,36 +0,0 @@
-/**
- * @module integrations/graph/loops/ConditionExpressionEvaluator
- * @summary Evaluator for the ALFRED-5 `ConditionExpression` DSL (DECAF-32 §22.3).
- * @description Evaluates declarative, serializable condition expressions with
- * `eq`/`neq`/`gt`/`gte`/`lt`/`lte`/`and`/`or`/`not`/`exists` operators and
- * `ExprValue` references (`{const}`, `{path}`, `{step, path}`).
- */
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates a {@link ConditionExpression} against the given state.
- *
- * `ExprValue` resolution:
- * - `{ const: x }` → the literal value `x`.
- * - `{ path: "a.b" }` → dotted-path lookup into `state`.
- * - `{ step: "nodeId", path: "out" }` → cross-node reference; in v1 the state
- *   is expected to contain a `nodes` map keyed by node id (reserved for future
- *   multi-step evaluation; falls back to `state` lookup when absent).
- */
-export declare class ConditionExpressionEvaluator {
-    /**
-     * Evaluates a condition expression to a boolean.
-     *
-     * @param expr - The condition expression.
-     * @param state - The current evaluation state (loop state or execution values).
-     * @returns `true` when the expression evaluates to a truthy/positive result.
-     */
-    evaluate(expr: ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves an {@link ExprValue} against the current state.
-     */
-    private resolveValue;
-    /**
-     * Resolves a dotted path into a target object.
-     */
-    private resolvePath;
-}

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

@@ -1,40 +0,0 @@
-/**
- * @module integrations/graph/loops/GraphConditionEvaluator
- * @summary Evaluator for built-in loop condition types and the `ConditionExpression` DSL.
- * @description Supports safe, built-in condition types only. Does NOT evaluate arbitrary JavaScript expressions.
- * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
- * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
- */
-import type { GraphConditionDefinition } from "../types.d.cts";
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates loop conditions using built-in comparison types or the
- * `ConditionExpression` DSL.
- */
-export declare class GraphConditionEvaluator {
-    private readonly expressionEvaluator;
-    /**
-     * Evaluates a condition against the given state.
-     *
-     * When the condition object carries an `op` field, it is treated as a
-     * `ConditionExpression` (§22.3) and dispatched to the
-     * {@link ConditionExpressionEvaluator}. Otherwise the built-in `type`-based
-     * switch is used.
-     *
-     * @param condition - The condition definition.
-     * @param state - The current loop state.
-     * @returns `true` when the condition passes.
-     */
-    evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves a value that may be a dotted path into the state object.
-     */
-    private resolveValue;
-    /**
-     * Detects whether a condition object is a `ConditionExpression` (§22.3) by
-     * checking for the presence of an `op` field. When true, the object is
-     * treated as a `ConditionExpression` and dispatched to the
-     * {@link ConditionExpressionEvaluator}.
-     */
-    private isConditionExpression;
-}

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

@@ -1,40 +0,0 @@
-/**
- * @module integrations/graph/loops/GraphConditionEvaluator
- * @summary Evaluator for built-in loop condition types and the `ConditionExpression` DSL.
- * @description Supports safe, built-in condition types only. Does NOT evaluate arbitrary JavaScript expressions.
- * When the condition object carries an `op` field (ALFRED-5 §8 / DECAF-32 §22.3), dispatches to the
- * {@link ConditionExpressionEvaluator} instead of the built-in `type`-based switch.
- */
-import type { GraphConditionDefinition } from "../types.d.mts";
-import type { ConditionExpression } from "@decaf-ts/ui-decorators/graph";
-/**
- * Evaluates loop conditions using built-in comparison types or the
- * `ConditionExpression` DSL.
- */
-export declare class GraphConditionEvaluator {
-    private readonly expressionEvaluator;
-    /**
-     * Evaluates a condition against the given state.
-     *
-     * When the condition object carries an `op` field, it is treated as a
-     * `ConditionExpression` (§22.3) and dispatched to the
-     * {@link ConditionExpressionEvaluator}. Otherwise the built-in `type`-based
-     * switch is used.
-     *
-     * @param condition - The condition definition.
-     * @param state - The current loop state.
-     * @returns `true` when the condition passes.
-     */
-    evaluate(condition: GraphConditionDefinition | ConditionExpression, state: unknown): boolean;
-    /**
-     * Resolves a value that may be a dotted path into the state object.
-     */
-    private resolveValue;
-    /**
-     * Detects whether a condition object is a `ConditionExpression` (§22.3) by
-     * checking for the presence of an `op` field. When true, the object is
-     * treated as a `ConditionExpression` and dispatched to the
-     * {@link ConditionExpressionEvaluator}.
-     */
-    private isConditionExpression;
-}

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

@@ -1,15 +0,0 @@
-/**
- * @module integrations/graph/loops/GraphLoopExecutionContext
- * @summary Context for loop node execution.
- * @description Carries loop-specific metadata and iteration state during loop execution.
- */
-import type { GraphLoopMetadata } from "../types.d.cts";
-/**
- * Context for a single loop execution, carrying the loop metadata and
- * current iteration index.
- */
-export declare class GraphLoopExecutionContext {
-    readonly iteration: number;
-    readonly metadata: GraphLoopMetadata;
-    constructor(iteration: number, metadata: GraphLoopMetadata);
-}

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

@@ -1,15 +0,0 @@
-/**
- * @module integrations/graph/loops/GraphLoopExecutionContext
- * @summary Context for loop node execution.
- * @description Carries loop-specific metadata and iteration state during loop execution.
- */
-import type { GraphLoopMetadata } from "../types.d.mts";
-/**
- * Context for a single loop execution, carrying the loop metadata and
- * current iteration index.
- */
-export declare class GraphLoopExecutionContext {
-    readonly iteration: number;
-    readonly metadata: GraphLoopMetadata;
-    constructor(iteration: number, metadata: GraphLoopMetadata);
-}

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

@@ -1,8 +0,0 @@
-/**
- * @module integrations/graph/loops
- * @summary Structured loop executors.
- * @description Re-exports the condition evaluator, loop execution context, and foreach/while/until executors.
- */
-export * from "./GraphConditionEvaluator.d.cts";
-export * from "./ConditionExpressionEvaluator.d.cts";
-export * from "./GraphLoopExecutionContext.d.cts";

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

@@ -1,8 +0,0 @@
-/**
- * @module integrations/graph/loops
- * @summary Structured loop executors.
- * @description Re-exports the condition evaluator, loop execution context, and foreach/while/until executors.
- */
-export * from "./GraphConditionEvaluator.d.mts";
-export * from "./ConditionExpressionEvaluator.d.mts";
-export * from "./GraphLoopExecutionContext.d.mts";

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

@@ -1,21 +0,0 @@
-/**
- * @module integrations/graph/pinning/GraphPinningDependencyResolver
- * @summary Resolves upstream dependency subtrees for pinning.
- * @description When a node is pinned, all upstream nodes it depends on must also be pinned. This resolver computes the dependency set.
- */
-import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.cts";
-/**
- * Resolves the upstream dependency subtree of a node for pinning operations.
- */
-export declare class GraphPinningDependencyResolver {
-    /**
-     * Returns the set of upstream node ids that the given node depends on,
-     * excluding the workflow boundary.
-     */
-    getDependencies(plan: GraphExecutionPlan, nodeId: string): Set<string>;
-    /**
-     * Returns the full set of node ids to pin: the node itself plus all its
-     * upstream dependencies.
-     */
-    getPinSet(plan: GraphExecutionPlan, nodeId: string): Set<string>;
-}

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

@@ -1,21 +0,0 @@
-/**
- * @module integrations/graph/pinning/GraphPinningDependencyResolver
- * @summary Resolves upstream dependency subtrees for pinning.
- * @description When a node is pinned, all upstream nodes it depends on must also be pinned. This resolver computes the dependency set.
- */
-import type { GraphExecutionPlan } from "../planning/GraphExecutionPlan.d.mts";
-/**
- * Resolves the upstream dependency subtree of a node for pinning operations.
- */
-export declare class GraphPinningDependencyResolver {
-    /**
-     * Returns the set of upstream node ids that the given node depends on,
-     * excluding the workflow boundary.
-     */
-    getDependencies(plan: GraphExecutionPlan, nodeId: string): Set<string>;
-    /**
-     * Returns the full set of node ids to pin: the node itself plus all its
-     * upstream dependencies.
-     */
-    getPinSet(plan: GraphExecutionPlan, nodeId: string): Set<string>;
-}

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

@@ -1,14 +0,0 @@
-/**
- * @module integrations/graph/pinning/GraphPinningMetadata
- * @summary Pinning metadata defaults and helpers.
- * @description Provides default pinning metadata values and a helper to check pinnability. The `GraphPinningMetadata` type itself is defined in `../types` and re-exported from the package root.
- */
-import type { GraphPinningMetadata } from "../types.d.cts";
-/**
- * Default pinning metadata applied when `@pinnable()` is used without options.
- */
-export declare const DEFAULT_PINNING_METADATA: GraphPinningMetadata;
-/**
- * Returns `true` when the given metadata allows pinning.
- */
-export declare function isPinnable(metadata: GraphPinningMetadata | undefined): boolean;

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

@@ -1,14 +0,0 @@
-/**
- * @module integrations/graph/pinning/GraphPinningMetadata
- * @summary Pinning metadata defaults and helpers.
- * @description Provides default pinning metadata values and a helper to check pinnability. The `GraphPinningMetadata` type itself is defined in `../types` and re-exported from the package root.
- */
-import type { GraphPinningMetadata } from "../types.d.mts";
-/**
- * Default pinning metadata applied when `@pinnable()` is used without options.
- */
-export declare const DEFAULT_PINNING_METADATA: GraphPinningMetadata;
-/**
- * Returns `true` when the given metadata allows pinning.
- */
-export declare function isPinnable(metadata: GraphPinningMetadata | undefined): boolean;

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

@@ -1,20 +0,0 @@
-/**
- * @module integrations/graph/pinning/GraphPinningPolicy
- * @summary Decides whether a node can be pinned and whether pinned values should be used.
- * @description Reads pinning metadata from plan nodes and enforces the pinning strategy.
- */
-import type { GraphExecutionPlanNode } from "../planning/GraphExecutionPlanNode.d.cts";
-import type { GraphPinningMetadata } from "../types.d.cts";
-/**
- * Policy that decides pinning behaviour for a plan node.
- */
-export declare class GraphPinningPolicy {
-    /** Returns whether the node is allowed to be pinned. */
-    canPin(node: GraphExecutionPlanNode): boolean;
-    /** Returns whether the engine should attempt to use a pinned value for the node. */
-    shouldUsePinnedValue(node: GraphExecutionPlanNode): boolean;
-    /** Returns whether automatic pinning should occur after execution. */
-    shouldAutoPin(node: GraphExecutionPlanNode): boolean;
-    /** Extracts pinning metadata from a plan node. */
-    getPinningMetadata(node: GraphExecutionPlanNode): GraphPinningMetadata;
-}

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

@@ -1,20 +0,0 @@
-/**
- * @module integrations/graph/pinning/GraphPinningPolicy
- * @summary Decides whether a node can be pinned and whether pinned values should be used.
- * @description Reads pinning metadata from plan nodes and enforces the pinning strategy.
- */
-import type { GraphExecutionPlanNode } from "../planning/GraphExecutionPlanNode.d.mts";
-import type { GraphPinningMetadata } from "../types.d.mts";
-/**
- * Policy that decides pinning behaviour for a plan node.
- */
-export declare class GraphPinningPolicy {
-    /** Returns whether the node is allowed to be pinned. */
-    canPin(node: GraphExecutionPlanNode): boolean;
-    /** Returns whether the engine should attempt to use a pinned value for the node. */
-    shouldUsePinnedValue(node: GraphExecutionPlanNode): boolean;
-    /** Returns whether automatic pinning should occur after execution. */
-    shouldAutoPin(node: GraphExecutionPlanNode): boolean;
-    /** Extracts pinning metadata from a plan node. */
-    getPinningMetadata(node: GraphExecutionPlanNode): GraphPinningMetadata;
-}

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

@@ -1,70 +0,0 @@
-import type { GraphExecutionPlanNode } from "../planning/GraphExecutionPlanNode.d.cts";
-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 { GraphPinningPolicy } from "./GraphPinningPolicy.d.cts";
-import type { GraphPinningDependencyResolver } from "./GraphPinningDependencyResolver.d.cts";
-/**
- * Service that manages pinning and unpinning of graph node values.
- */
-export declare class GraphPinningService {
-    private readonly store;
-    private readonly policy;
-    private readonly dependencyResolver;
-    constructor(store: GraphValueStore, policy: GraphPinningPolicy, dependencyResolver: GraphPinningDependencyResolver);
-    /**
-     * Pins a node and all its upstream dependencies.
-     *
-     * @throws {GraphPinningError} when the node or any dependency is not pinnable.
-     */
-    pinNode(options: GraphPinNodeOptions): Promise<void>;
-    /**
-     * Unpins a single node (does not unpin dependents in v1).
-     */
-    unpinNode(options: GraphUnpinNodeOptions): Promise<void>;
-    /**
-     * Reads a pinned value for a node, returning `undefined` when no valid
-     * pinned value exists.
-     */
-    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(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): GraphValueKey;
-    /**
-     * 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.
-     */
-    private relevantMetadata;
-    /**
-     * Returns a topological ordering of the given node set.
-     */
-    private topologicalOrder;
-    /**
-     * Computes fingerprints for all upstream dependencies of a node.
-     */
-    private dependencyFingerprints;
-    /**
-     * Serializes a value with recursively sorted keys for stable hashing.
-     */
-    private stableSerialize;
-    /**
-     * Simple non-cryptographic hash for browser environments where
-     * `node:crypto` is unavailable. Produces a deterministic hex-like string
-     * from the input. This is NOT cryptographically secure but is sufficient
-     * for fingerprint-based cache keys.
-     */
-    private simpleHash;
-}

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

@@ -1,70 +0,0 @@
-import type { GraphExecutionPlanNode } from "../planning/GraphExecutionPlanNode.d.mts";
-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 { GraphPinningPolicy } from "./GraphPinningPolicy.d.mts";
-import type { GraphPinningDependencyResolver } from "./GraphPinningDependencyResolver.d.mts";
-/**
- * Service that manages pinning and unpinning of graph node values.
- */
-export declare class GraphPinningService {
-    private readonly store;
-    private readonly policy;
-    private readonly dependencyResolver;
-    constructor(store: GraphValueStore, policy: GraphPinningPolicy, dependencyResolver: GraphPinningDependencyResolver);
-    /**
-     * Pins a node and all its upstream dependencies.
-     *
-     * @throws {GraphPinningError} when the node or any dependency is not pinnable.
-     */
-    pinNode(options: GraphPinNodeOptions): Promise<void>;
-    /**
-     * Unpins a single node (does not unpin dependents in v1).
-     */
-    unpinNode(options: GraphUnpinNodeOptions): Promise<void>;
-    /**
-     * Reads a pinned value for a node, returning `undefined` when no valid
-     * pinned value exists.
-     */
-    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(workflowId: string, node: GraphExecutionPlanNode, inputs: GraphExecutionValues, dependencyFingerprints: Record<string, string>, namespace?: string): GraphValueKey;
-    /**
-     * 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.
-     */
-    private relevantMetadata;
-    /**
-     * Returns a topological ordering of the given node set.
-     */
-    private topologicalOrder;
-    /**
-     * Computes fingerprints for all upstream dependencies of a node.
-     */
-    private dependencyFingerprints;
-    /**
-     * Serializes a value with recursively sorted keys for stable hashing.
-     */
-    private stableSerialize;
-    /**
-     * Simple non-cryptographic hash for browser environments where
-     * `node:crypto` is unavailable. Produces a deterministic hex-like string
-     * from the input. This is NOT cryptographically secure but is sufficient
-     * for fingerprint-based cache keys.
-     */
-    private simpleHash;
-}

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

@@ -1,9 +0,0 @@
-/**
- * @module integrations/graph/pinning
- * @summary Graph pinning subsystem.
- * @description Re-exports the pinning metadata, policy, dependency resolver, and service.
- */
-export * from "./GraphPinningMetadata.d.cts";
-export * from "./GraphPinningPolicy.d.cts";
-export * from "./GraphPinningDependencyResolver.d.cts";
-export * from "./GraphPinningService.d.cts";

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

@@ -1,9 +0,0 @@
-/**
- * @module integrations/graph/pinning
- * @summary Graph pinning subsystem.
- * @description Re-exports the pinning metadata, policy, dependency resolver, and service.
- */
-export * from "./GraphPinningMetadata.d.mts";
-export * from "./GraphPinningPolicy.d.mts";
-export * from "./GraphPinningDependencyResolver.d.mts";
-export * from "./GraphPinningService.d.mts";

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

@@ -1,25 +0,0 @@
-/**
- * @module integrations/graph/planning/GraphExecutionPlan
- * @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 { 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";
-/**
- * The resolved execution plan for a single workflow.
- */
-export interface GraphExecutionPlan {
-    /** The validated, catalogue-resolved workflow this plan was built from. */
-    resolved: GraphResolvedWorkflow;
-    /** The canonical document id. */
-    workflowId: string;
-    nodes: GraphExecutionPlanNode[];
-    edges: GraphExecutionPlanEdge[];
-    layers: GraphExecutionPlanLayer[];
-    incomingByNode: Map<string, GraphExecutionPlanEdge[]>;
-    outgoingByNode: Map<string, GraphExecutionPlanEdge[]>;
-}