@decaf-ts/integrations 0.3.8 → 0.3.10

package/lib/esm/graph/engine/planning/GraphRelationResolver.js

@@ -0,0 +1,167 @@
+import { graphDefinitionOf } from "@decaf-ts/ui-decorators/graph";
+import { GRAPH_WORKFLOW_BOUNDARY } from "./../constants.js";
+import { GraphPortError } from "./../errors/GraphPortError.js";
+import { GraphTopologyError } from "./../errors/GraphTopologyError.js";
+/**
+ * Resolves raw workflow relation metadata into normalized execution edges.
+ */
+export class GraphRelationResolver {
+    /**
+     * Resolves all relations of a workflow into execution edges.
+     *
+     * @param workflow - The workflow definition.
+     * @returns Array of normalized edges.
+     * @throws {GraphTopologyError} when an endpoint is unknown or ambiguous.
+     * @throws {GraphPortError} when a referenced port is missing or unknown.
+     */
+    resolve(workflow) {
+        const nodeIds = new Set(workflow.nodes.map((n) => n.id));
+        const boundaryAliases = this.boundaryAliases(workflow);
+        const inputPorts = this.portNames(workflow.inputs);
+        const outputPorts = this.portNames(workflow.outputs);
+        const nodePortMap = this.buildNodePortMap(workflow);
+        const edges = [];
+        for (const relation of workflow.relations ?? []) {
+            const edge = this.resolveRelation(relation, nodeIds, boundaryAliases, inputPorts, outputPorts, nodePortMap);
+            edges.push(edge);
+        }
+        return edges;
+    }
+    /**
+     * Resolves a single relation into an edge.
+     */
+    resolveRelation(relation, nodeIds, boundaryAliases, inputPorts, outputPorts, nodePortMap) {
+        const sourceNodeId = this.resolveEndpoint(relation.source, nodeIds, boundaryAliases);
+        const targetNodeId = this.resolveEndpoint(relation.target, nodeIds, boundaryAliases);
+        const sourcePort = relation.sourcePort;
+        const targetPort = relation.targetPort;
+        if (!sourcePort) {
+            throw new GraphPortError(`Relation is missing sourcePort (source: ${String(relation.source)}, target: ${String(relation.target)})`, { relation });
+        }
+        if (!targetPort) {
+            throw new GraphPortError(`Relation is missing targetPort (source: ${String(relation.source)}, target: ${String(relation.target)})`, { relation });
+        }
+        this.validatePort(sourceNodeId, sourcePort, true, boundaryAliases, inputPorts, outputPorts, nodePortMap);
+        this.validatePort(targetNodeId, targetPort, false, boundaryAliases, inputPorts, outputPorts, nodePortMap);
+        return {
+            id: this.createEdgeId(sourceNodeId, sourcePort, targetNodeId, targetPort),
+            sourceNodeId,
+            sourcePort,
+            targetNodeId,
+            targetPort,
+            label: relation.label,
+            metadata: relation.metadata,
+        };
+    }
+    /**
+     * Resolves an endpoint (source or target) to a node id or the workflow boundary.
+     */
+    resolveEndpoint(endpoint, nodeIds, boundaryAliases) {
+        const name = String(endpoint);
+        if (boundaryAliases.has(name))
+            return GRAPH_WORKFLOW_BOUNDARY;
+        if (nodeIds.has(name))
+            return name;
+        throw new GraphTopologyError(`Unknown endpoint '${name}'`, { endpoint: name, knownNodes: Array.from(nodeIds) });
+    }
+    /**
+     * Validates that a port exists on the given node or boundary.
+     */
+    validatePort(nodeId, port, isSource, boundaryAliases, inputPorts, outputPorts, nodePortMap) {
+        if (nodeId === GRAPH_WORKFLOW_BOUNDARY) {
+            const ports = isSource ? inputPorts : outputPorts;
+            if (!ports.has(port)) {
+                throw new GraphPortError(`Unknown ${isSource ? "input" : "output"} port '${port}' on workflow boundary`, { nodeId, port, isSource, available: Array.from(ports) });
+            }
+            return;
+        }
+        const nodePorts = nodePortMap.get(nodeId);
+        if (!nodePorts) {
+            throw new GraphTopologyError(`No port map for node '${nodeId}'`, {
+                nodeId,
+            });
+        }
+        const ports = isSource ? nodePorts.output : nodePorts.input;
+        if (!ports.has(port)) {
+            throw new GraphPortError(`Unknown ${isSource ? "output" : "input"} port '${port}' on node '${nodeId}'`, { nodeId, port, isSource, available: Array.from(ports) });
+        }
+    }
+    /**
+     * Builds the set of boundary aliases for a workflow.
+     */
+    boundaryAliases(workflow) {
+        return new Set([
+            GRAPH_WORKFLOW_BOUNDARY,
+            "workflow",
+            "graph",
+            workflow.name,
+        ]);
+    }
+    /**
+     * Extracts port names from a list of port definitions.
+     */
+    portNames(ports) {
+        return new Set((ports ?? []).map((p) => p.name));
+    }
+    /**
+     * Builds a map of node id -> { input ports, output ports }.
+     */
+    buildNodePortMap(workflow) {
+        const map = new Map();
+        for (const nodeMeta of workflow.nodes ?? []) {
+            const input = new Set();
+            const output = new Set();
+            const def = this.resolveNodeDefinition(nodeMeta);
+            if (def) {
+                for (const port of def.ports ?? []) {
+                    if (port.direction === "input")
+                        input.add(port.name);
+                    else
+                        output.add(port.name);
+                }
+            }
+            map.set(nodeMeta.id, { input, output });
+        }
+        return map;
+    }
+    /**
+     * Attempts to resolve a node's full definition from its metadata.
+     *
+     * Accepts either a decorated Model class/instance (resolved via
+     * `graphDefinitionOf`) or a plain `GraphNodeDefinition`-shaped object
+     * (useful for serialized workflows that inline node definitions).
+     */
+    resolveNodeDefinition(nodeMeta) {
+        if (nodeMeta.node) {
+            if (this.isRawDefinition(nodeMeta.node)) {
+                return nodeMeta.node;
+            }
+            try {
+                const def = graphDefinitionOf(nodeMeta.node);
+                return def;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Returns `true` when a value looks like a raw {@link GraphNodeDefinition}
+     * (a plain object with a `ports` array and a `name` string).
+     */
+    isRawDefinition(value) {
+        return (typeof value === "object" &&
+            value !== null &&
+            !Array.isArray(value) &&
+            typeof value.name === "string" &&
+            Array.isArray(value.ports));
+    }
+    /**
+     * Creates a stable edge id from its endpoints and ports.
+     */
+    createEdgeId(sourceNodeId, sourcePort, targetNodeId, targetPort) {
+        return `${sourceNodeId}:${sourcePort}->${targetNodeId}:${targetPort}`;
+    }
+}
+//# sourceMappingURL=GraphRelationResolver.js.map

package/lib/esm/graph/engine/planning/GraphRelationResolver.js.map

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

package/lib/esm/graph/engine/planning/GraphTopology.js

@@ -0,0 +1,52 @@
+/**
+ * Topology utility for traversing the execution plan's edges.
+ */
+export class GraphTopology {
+    /**
+     * Returns the set of upstream node ids reachable from `nodeId` by following
+     * incoming edges. The workflow boundary node is excluded.
+     */
+    static upstreamNodes(nodeId, incomingByNode, includeBoundary = false) {
+        const visited = new Set();
+        const stack = [nodeId];
+        while (stack.length) {
+            const current = stack.pop();
+            const incoming = incomingByNode.get(current) ?? [];
+            for (const edge of incoming) {
+                if (!includeBoundary && this.isBoundary(edge.sourceNodeId))
+                    continue;
+                if (!visited.has(edge.sourceNodeId)) {
+                    visited.add(edge.sourceNodeId);
+                    stack.push(edge.sourceNodeId);
+                }
+            }
+        }
+        return visited;
+    }
+    /**
+     * Returns the set of downstream node ids reachable from `nodeId` by following
+     * outgoing edges. The workflow boundary node is excluded.
+     */
+    static downstreamNodes(nodeId, outgoingByNode, includeBoundary = false) {
+        const visited = new Set();
+        const stack = [nodeId];
+        while (stack.length) {
+            const current = stack.pop();
+            const outgoing = outgoingByNode.get(current) ?? [];
+            for (const edge of outgoing) {
+                if (!includeBoundary && this.isBoundary(edge.targetNodeId))
+                    continue;
+                if (!visited.has(edge.targetNodeId)) {
+                    visited.add(edge.targetNodeId);
+                    stack.push(edge.targetNodeId);
+                }
+            }
+        }
+        return visited;
+    }
+    /** Returns whether a node id is the workflow boundary. */
+    static isBoundary(nodeId) {
+        return nodeId === "$workflow";
+    }
+}
+//# sourceMappingURL=GraphTopology.js.map

package/lib/esm/graph/engine/planning/GraphTopology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphTopology.js","sourceRoot":"","sources":["../../../../../src/graph/engine/planning/GraphTopology.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,OAAO,aAAa;IACxB;;;OAGG;IACH,MAAM,CAAC,aAAa,CAClB,MAAc,EACd,cAAqD,EACrD,eAAe,GAAG,KAAK;QAEvB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YAC7B,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;oBAAE,SAAS;gBACrE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,eAAe,CACpB,MAAc,EACd,cAAqD,EACrD,eAAe,GAAG,KAAK;QAEvB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YAC7B,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC;oBAAE,SAAS;gBACrE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;oBACpC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;oBAC/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAC,UAAU,CAAC,MAAc;QAC9B,OAAO,MAAM,KAAK,WAAW,CAAC;IAChC,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+/**
+ * @module integrations/graph/planning
+ * @summary Graph execution planning.
+ * @description Re-exports the execution plan types, relation resolver, and topological planner.
+ */
+export * from "./GraphExecutionPlanNode.js";
+export * from "./GraphExecutionPlanEdge.js";
+export * from "./GraphExecutionPlanLayer.js";
+export * from "./GraphExecutionPlan.js";
+export * from "./GraphRelationResolver.js";
+export * from "./GraphExecutionPlanner.js";
+export * from "./GraphTopology.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/planning/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,4CAAyC;AACzC,4CAAyC;AACzC,6CAA0C;AAC1C,wCAAqC;AACrC,2CAAwC;AACxC,2CAAwC;AACxC,mCAAgC"}

package/lib/esm/graph/engine/registry/GraphNodeExecutorRegistry.js

@@ -0,0 +1,39 @@
+import { GraphExecutionError } from "./../errors/GraphExecutionError.js";
+/**
+ * Registry that maps node `kind` strings to {@link GraphNodeExecutor}
+ * instances.
+ */
+export class GraphNodeExecutorRegistry {
+    constructor() {
+        this.executors = new Map();
+    }
+    /** Registers an executor for the given node kind. */
+    register(kind, executor) {
+        if (!kind)
+            throw new GraphExecutionError("Graph executor kind is required");
+        this.executors.set(kind, executor);
+        return this;
+    }
+    /** Removes the executor for the given node kind. */
+    unregister(kind) {
+        this.executors.delete(kind);
+        return this;
+    }
+    /** Returns whether an executor is registered for the given kind. */
+    has(kind) {
+        return this.executors.has(kind);
+    }
+    /**
+     * Resolves the executor for the given node kind.
+     *
+     * @throws {GraphExecutionError} when no executor is registered for `kind`.
+     */
+    resolve(kind) {
+        const executor = this.executors.get(kind);
+        if (!executor) {
+            throw new GraphExecutionError(`No graph executor registered for kind '${kind}'`, "GRAPH_EXECUTOR_NOT_FOUND", { kind });
+        }
+        return executor;
+    }
+}
+//# sourceMappingURL=GraphNodeExecutorRegistry.js.map

package/lib/esm/graph/engine/registry/GraphNodeExecutorRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNodeExecutorRegistry.js","sourceRoot":"","sources":["../../../../../src/graph/engine/registry/GraphNodeExecutorRegistry.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,2CAAsC;AAEpE;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IAAtC;QACmB,cAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;IAoCpE,CAAC;IAlCC,qDAAqD;IACrD,QAAQ,CAAC,IAAY,EAAE,QAA2B;QAChD,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;QAC5E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,mBAAmB,CAC3B,0CAA0C,IAAI,GAAG,EACjD,0BAA0B,EAC1B,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/lib/esm/graph/engine/registry/GraphNodeExecutorResolver.js

@@ -0,0 +1,22 @@
+/**
+ * Resolver that wraps a {@link GraphNodeExecutorRegistry} and optionally
+ * falls back to a default executor when a kind is not found.
+ */
+export class GraphNodeExecutorResolver {
+    constructor(registry, defaultExecutor) {
+        this.registry = registry;
+        this.defaultExecutor = defaultExecutor;
+    }
+    /**
+     * Resolves the executor for `kind`, falling back to the default executor
+     * when provided.
+     */
+    resolve(kind) {
+        if (this.registry.has(kind))
+            return this.registry.resolve(kind);
+        if (this.defaultExecutor)
+            return this.defaultExecutor;
+        return this.registry.resolve(kind);
+    }
+}
+//# sourceMappingURL=GraphNodeExecutorResolver.js.map

package/lib/esm/graph/engine/registry/GraphNodeExecutorResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphNodeExecutorResolver.js","sourceRoot":"","sources":["../../../../../src/graph/engine/registry/GraphNodeExecutorResolver.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IAGpC,YACmB,QAAmC,EACpD,eAAmC;QADlB,aAAQ,GAAR,QAAQ,CAA2B;QAGpD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC,eAAe,CAAC;QACtD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+/**
+ * @module integrations/graph/registry
+ * @summary Graph node executor registry and resolver.
+ * @description Re-exports the executor registry and resolver.
+ */
+export * from "./GraphNodeExecutorRegistry.js";
+export * from "./GraphNodeExecutorResolver.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+CAA4C;AAC5C,+CAA4C"}

package/lib/esm/graph/engine/snapshots/GraphExecutionSnapshotMapper.js

@@ -0,0 +1,48 @@
+/**
+ * @module integrations/graph/snapshots/GraphExecutionSnapshotMapper
+ * @summary Maps execution results to snapshot patches.
+ * @description Produces a GraphExecutionSnapshotPatch consumable by `@decaf-ts/ui-decorators/graph` snapshots, rather than replacing the snapshot system.
+ */
+import { GraphExecutionStatus } from "./../../shared/constants.js";
+/**
+ * Maps a {@link GraphExecutionResult} to a {@link GraphExecutionSnapshotPatch}.
+ */
+export class GraphExecutionSnapshotMapper {
+    /**
+     * Creates a snapshot patch from an execution result.
+     */
+    map(result) {
+        const nodes = {};
+        for (const [id, nodeResult] of Object.entries(result.nodeResults)) {
+            nodes[id] = {
+                status: nodeResult.status,
+                startedAt: nodeResult.startedAt?.toISOString(),
+                finishedAt: nodeResult.finishedAt?.toISOString(),
+                error: nodeResult.error,
+                outputs: nodeResult.outputs,
+                fromCache: nodeResult.fromCache,
+                pinned: nodeResult.pinned,
+            };
+        }
+        const edges = {};
+        for (const event of result.events) {
+            if (event.edgeId && event.type === "edge.valueRouted") {
+                edges[event.edgeId] = {
+                    status: GraphExecutionStatus.SUCCEEDED,
+                    lastValue: event.payload?.value,
+                    updatedAt: event.timestamp.toISOString(),
+                };
+            }
+        }
+        const events = [...result.events];
+        return {
+            runId: result.runId,
+            status: result.status,
+            nodes,
+            edges,
+            outputs: result.outputs,
+            events,
+        };
+    }
+}
+//# sourceMappingURL=GraphExecutionSnapshotMapper.js.map

package/lib/esm/graph/engine/snapshots/GraphExecutionSnapshotMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphExecutionSnapshotMapper.js","sourceRoot":"","sources":["../../../../../src/graph/engine/snapshots/GraphExecutionSnapshotMapper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,oCAA+B;AAO9D;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACvC;;OAEG;IACH,GAAG,CAAC,MAA4B;QAC9B,MAAM,KAAK,GAAyC,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;YAClE,KAAK,CAAC,EAAE,CAAC,GAAG;gBACV,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,SAAS,EAAE,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE;gBAC9C,UAAU,EAAE,UAAU,CAAC,UAAU,EAAE,WAAW,EAAE;gBAChD,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAyC,EAAE,CAAC;QACvD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACtD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;oBACpB,MAAM,EAAE,oBAAoB,CAAC,SAAS;oBACtC,SAAS,EAAG,KAAK,CAAC,OAAe,EAAE,KAAK;oBACxC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;iBACzC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAA0B,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK;YACL,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM;SACP,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/graph/snapshots
+ * @summary Graph execution snapshot mapping.
+ * @description Re-exports the snapshot patch mapper.
+ */
+export * from "./GraphExecutionSnapshotMapper.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/snapshots/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,kDAA+C"}

package/lib/esm/graph/engine/store/GraphCachedValue.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphCachedValue.js.map

package/lib/esm/graph/engine/store/GraphCachedValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphCachedValue.js","sourceRoot":"","sources":["../../../../../src/graph/engine/store/GraphCachedValue.ts"],"names":[],"mappings":""}

package/lib/esm/graph/engine/store/GraphValueKey.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/graph/store/GraphValueKey
+ * @summary Stable key for cached graph values.
+ * @description Identifies a cached value in the store by workflow, node, fingerprint, and optional namespace/version.
+ */
+export {};
+//# sourceMappingURL=GraphValueKey.js.map

package/lib/esm/graph/engine/store/GraphValueKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphValueKey.js","sourceRoot":"","sources":["../../../../../src/graph/engine/store/GraphValueKey.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/esm/graph/engine/store/GraphValueStore.js

@@ -0,0 +1,71 @@
+/**
+ * @module integrations/graph/store/GraphValueStore
+ * @summary Runtime value store wrapping a persistent adapter.
+ * @description Holds runtime values for the current execution in memory and delegates cached/pinned values to a {@link GraphValueStoreAdapter}.
+ */
+import { GRAPH_WORKFLOW_BOUNDARY } from "./../constants.js";
+/**
+ * Manages values during a single graph execution.
+ *
+ * Runtime values (workflow inputs, node outputs, workflow outputs) are kept in
+ * an in-memory map. Persistent cache and pinning operations are delegated to
+ * the configured {@link GraphValueStoreAdapter}.
+ */
+export class GraphValueStore {
+    /**
+     * @param adapter - The persistent adapter for cached/pinned values.
+     */
+    constructor(adapter) {
+        this.adapter = adapter;
+        this.runtimeValues = new Map();
+    }
+    /** Seeds the workflow input values. */
+    seedWorkflowInputs(inputs) {
+        this.runtimeValues.set(GRAPH_WORKFLOW_BOUNDARY, { ...inputs });
+    }
+    /** Stores the outputs produced by a node. */
+    setNodeOutputs(nodeId, outputs) {
+        this.runtimeValues.set(nodeId, { ...outputs });
+    }
+    /** Reads a single port value from a node's stored outputs. */
+    getPort(nodeId, port) {
+        return this.runtimeValues.get(nodeId)?.[port];
+    }
+    /** Returns whether a node has a value for the given port. */
+    hasPort(nodeId, port) {
+        return Object.prototype.hasOwnProperty.call(this.runtimeValues.get(nodeId) ?? {}, port);
+    }
+    /** Sets a single workflow output port value. */
+    setWorkflowOutput(port, value) {
+        const current = this.runtimeValues.get(GRAPH_WORKFLOW_BOUNDARY) ?? {};
+        current[port] = value;
+        this.runtimeValues.set(GRAPH_WORKFLOW_BOUNDARY, current);
+    }
+    /** Returns all workflow-level values (inputs merged with outputs). */
+    getWorkflowValues() {
+        return {
+            ...(this.runtimeValues.get(GRAPH_WORKFLOW_BOUNDARY) ?? {}),
+        };
+    }
+    /** Reads a cached value from the adapter. */
+    async readCached(key) {
+        return this.adapter.read(key);
+    }
+    /** Writes a cached value through the adapter. */
+    async writeCached(key, value) {
+        await this.adapter.write(key, value);
+    }
+    /** Deletes a cached value through the adapter. */
+    async deleteCached(key) {
+        await this.adapter.delete(key);
+    }
+    /** Returns a snapshot of all runtime values. */
+    snapshot() {
+        return Object.fromEntries(this.runtimeValues.entries());
+    }
+    /** Returns the underlying adapter (used by the pinning service). */
+    getAdapter() {
+        return this.adapter;
+    }
+}
+//# sourceMappingURL=GraphValueStore.js.map

package/lib/esm/graph/engine/store/GraphValueStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphValueStore.js","sourceRoot":"","sources":["../../../../../src/graph/engine/store/GraphValueStore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,uBAAuB,EAAE,0BAAqB;AAMvD;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IAG1B;;OAEG;IACH,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAL3C,kBAAa,GAAG,IAAI,GAAG,EAAgC,CAAC;IAKV,CAAC;IAEhE,uCAAuC;IACvC,kBAAkB,CAAC,MAA4B;QAC7C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,uBAAuB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,6CAA6C;IAC7C,cAAc,CAAC,MAAc,EAAE,OAA6B;QAC1D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,8DAA8D;IAC9D,OAAO,CAAC,MAAc,EAAE,IAAY;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,6DAA6D;IAC7D,OAAO,CAAC,MAAc,EAAE,IAAY;QAClC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EACpC,IAAI,CACL,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,iBAAiB,CAAC,IAAY,EAAE,KAAc;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,sEAAsE;IACtE,iBAAiB;QACf,OAAO;YACL,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,KAAK,CAAC,UAAU,CAAC,GAAkB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,WAAW,CAAC,GAAkB,EAAE,KAAuB;QAC3D,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,YAAY,CAAC,GAAkB;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,gDAAgD;IAChD,QAAQ;QACN,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,oEAAoE;IACpE,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/lib/esm/graph/engine/store/GraphValueStoreAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphValueStoreAdapter.js.map

package/lib/esm/graph/engine/store/GraphValueStoreAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphValueStoreAdapter.js","sourceRoot":"","sources":["../../../../../src/graph/engine/store/GraphValueStoreAdapter.ts"],"names":[],"mappings":""}

package/lib/esm/graph/engine/store/InMemoryGraphValueStoreAdapter.js

@@ -0,0 +1,64 @@
+/**
+ * In-memory implementation of {@link GraphValueStoreAdapter}.
+ *
+ * Values are keyed by a serialized string combining namespace, workflowId,
+ * nodeId, version, and fingerprint.
+ */
+export class InMemoryGraphValueStoreAdapter {
+    constructor() {
+        this.values = new Map();
+    }
+    /** @inheritDoc */
+    async read(key) {
+        return this.values.get(this.serializeKey(key));
+    }
+    /** @inheritDoc */
+    async write(key, value) {
+        this.values.set(this.serializeKey(key), value);
+    }
+    /** @inheritDoc */
+    async delete(key) {
+        this.values.delete(this.serializeKey(key));
+    }
+    /** @inheritDoc */
+    async has(key) {
+        return this.values.has(this.serializeKey(key));
+    }
+    /** @inheritDoc */
+    async list(prefix) {
+        const results = [];
+        for (const value of this.values.values()) {
+            const k = value.key;
+            if (prefix.workflowId !== undefined &&
+                k.workflowId !== prefix.workflowId)
+                continue;
+            if (prefix.nodeId !== undefined && k.nodeId !== prefix.nodeId)
+                continue;
+            if (prefix.namespace !== undefined &&
+                k.namespace !== prefix.namespace)
+                continue;
+            if (prefix.version !== undefined && k.version !== prefix.version)
+                continue;
+            results.push(value);
+        }
+        return results;
+    }
+    /** @inheritDoc */
+    async clearRun(runId) {
+        void runId;
+        this.values.clear();
+    }
+    /**
+     * Serializes a key into a stable string used as the Map key.
+     */
+    serializeKey(key) {
+        return [
+            key.namespace ?? "default",
+            key.workflowId,
+            key.nodeId,
+            key.version ?? "default",
+            key.fingerprint,
+        ].join(":");
+    }
+}
+//# sourceMappingURL=InMemoryGraphValueStoreAdapter.js.map

package/lib/esm/graph/engine/store/InMemoryGraphValueStoreAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryGraphValueStoreAdapter.js","sourceRoot":"","sources":["../../../../../src/graph/engine/store/InMemoryGraphValueStoreAdapter.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,OAAO,8BAA8B;IAA3C;QACmB,WAAM,GAAG,IAAI,GAAG,EAA4B,CAAC;IA+DhE,CAAC;IA7DC,kBAAkB;IAClB,KAAK,CAAC,IAAI,CAAC,GAAkB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,KAAK,CAAC,GAAkB,EAAE,KAAuB;QACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,MAAM,CAAC,GAAkB;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,GAAG,CAAC,GAAkB;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,IAAI,CAAC,MAA8B;QACvC,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;YACpB,IACE,MAAM,CAAC,UAAU,KAAK,SAAS;gBAC/B,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;gBAElC,SAAS;YACX,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;gBAAE,SAAS;YACxE,IACE,MAAM,CAAC,SAAS,KAAK,SAAS;gBAC9B,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;gBAEhC,SAAS;YACX,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;gBAC9D,SAAS;YACX,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,QAAQ,CAAC,KAAa;QAC1B,KAAK,KAAK,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,GAAkB;QACrC,OAAO;YACL,GAAG,CAAC,SAAS,IAAI,SAAS;YAC1B,GAAG,CAAC,UAAU;YACd,GAAG,CAAC,MAAM;YACV,GAAG,CAAC,OAAO,IAAI,SAAS;YACxB,GAAG,CAAC,WAAW;SAChB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/graph/store
+ * @summary Graph value store, adapter, and key types.
+ * @description Re-exports the value store adapter interface, in-memory default, key/cached-value types, and the runtime store wrapper.
+ */
+export * from "./GraphValueKey.js";
+export * from "./GraphCachedValue.js";
+export * from "./GraphValueStoreAdapter.js";
+export * from "./InMemoryGraphValueStoreAdapter.js";
+export * from "./GraphValueStore.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/graph/engine/store/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,mCAAgC;AAChC,sCAAmC;AACnC,4CAAyC;AACzC,oDAAiD;AACjD,qCAAkC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/esm/graph/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/graph/engine/types.ts"],"names":[],"mappings":""}

package/lib/esm/graph/engine/validation/GraphDefinitionValidator.js

@@ -0,0 +1,28 @@
+import { GraphInputError } from "./../errors/GraphInputError.js";
+import { GraphExecutionPlanner } from "./../planning/GraphExecutionPlanner.js";
+/**
+ * Validates a {@link GraphWorkflowDefinition} before execution.
+ */
+export class GraphDefinitionValidator {
+    constructor(planner) {
+        this.planner = planner ?? new GraphExecutionPlanner();
+    }
+    /**
+     * Validates the workflow definition.
+     *
+     * @throws {GraphInputError} when the workflow has no name or invalid structure.
+     * @throws {GraphCycleError} when the workflow contains an unsupported cycle.
+     */
+    validate(workflow) {
+        if (!workflow.name) {
+            throw new GraphInputError("Workflow must have a name");
+        }
+        const nodeIds = new Set((workflow.nodes ?? []).map((n) => n.id));
+        if (nodeIds.size !== (workflow.nodes ?? []).length) {
+            throw new GraphInputError("Workflow node IDs must be unique");
+        }
+        // The planner performs full topology validation (endpoints, ports, cycles)
+        this.planner.plan(workflow);
+    }
+}
+//# sourceMappingURL=GraphDefinitionValidator.js.map

package/lib/esm/graph/engine/validation/GraphDefinitionValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphDefinitionValidator.js","sourceRoot":"","sources":["../../../../../src/graph/engine/validation/GraphDefinitionValidator.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,eAAe,EAAE,uCAAkC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,+CAA0C;AAE1E;;GAEG;AACH,MAAM,OAAO,wBAAwB;IAGnC,YAAY,OAA+B;QACzC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,qBAAqB,EAAE,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAiC;QACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,IAAI,eAAe,CAAC,2BAA2B,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,IAAI,eAAe,CAAC,kCAAkC,CAAC,CAAC;QAChE,CAAC;QAED,2EAA2E;QAC3E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;CACF"}