@decaf-ts/integrations 0.3.1 → 0.3.2

package/lib/esm/graph/execution/GraphExecutionEngine.js

@@ -0,0 +1,400 @@
+import { GRAPH_DEFAULT_CONCURRENCY, GRAPH_WORKFLOW_BOUNDARY, GraphExecutionEventType, GraphExecutionStatus, } from "./../constants.js";
+import { GraphExecutionEventEmitter } from "./../events/GraphExecutionEventEmitter.js";
+import { GraphExecutionEventFactory } from "./../events/GraphExecutionEventFactory.js";
+import { GraphExecutionPlanner } from "./../planning/GraphExecutionPlanner.js";
+import { InMemoryGraphValueStoreAdapter } from "./../store/InMemoryGraphValueStoreAdapter.js";
+import { GraphValueStore } from "./../store/GraphValueStore.js";
+import { GraphPinningService } from "./../pinning/GraphPinningService.js";
+import { GraphPinningPolicy } from "./../pinning/GraphPinningPolicy.js";
+import { GraphPinningDependencyResolver } from "./../pinning/GraphPinningDependencyResolver.js";
+import { GraphExecutionContext } from "./GraphExecutionContext.js";
+import { GraphExecutionFrame } from "./GraphExecutionFrame.js";
+import { buildGraphExecutionResult } from "./GraphExecutionResult.js";
+/**
+ * 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}.
+ */
+export class GraphExecutionEngine {
+    constructor(config) {
+        this.emitter = config.eventEmitter ?? new GraphExecutionEventEmitter();
+        this.planner = config.planner ?? new GraphExecutionPlanner();
+        this.valueStoreAdapter =
+            config.valueStoreAdapter ?? new InMemoryGraphValueStoreAdapter();
+        this.defaultOptions = config.defaultOptions ?? {};
+        this.config = config;
+    }
+    observe(observer) {
+        return this.emitter.observe(observer);
+    }
+    unObserve(observer) {
+        this.emitter.unObserve(observer);
+    }
+    async updateObservers(event) {
+        await this.emitter.updateObservers(event);
+    }
+    /**
+     * Executes a workflow with the given inputs and options.
+     */
+    async execute(workflow, inputs = {}, options = {}) {
+        const opts = this.mergeOptions(options);
+        const runId = opts.runId ?? this.generateRunId();
+        const path = opts.path ?? [];
+        const eventFactory = new GraphExecutionEventFactory();
+        const valueStore = new GraphValueStore(this.valueStoreAdapter);
+        valueStore.seedWorkflowInputs(inputs);
+        const plan = this.planner.plan(workflow);
+        const frame = new GraphExecutionFrame(runId, plan, valueStore, eventFactory);
+        const emitFn = async (partial) => {
+            await this.emitEvent(frame, {
+                type: partial.type ?? GraphExecutionEventType.NODE_OUTPUT,
+                runId,
+                parentRunId: opts.parentRunId,
+                workflowId: workflow.name,
+                nodeId: partial.nodeId,
+                path: partial.path ?? path,
+                ...partial,
+            });
+        };
+        await this.emitEvent(frame, {
+            type: GraphExecutionEventType.WORKFLOW_STARTED,
+            runId,
+            parentRunId: opts.parentRunId,
+            workflowId: workflow.name,
+            path,
+            status: GraphExecutionStatus.RUNNING,
+            payload: { inputs },
+        });
+        await this.emitEvent(frame, {
+            type: GraphExecutionEventType.WORKFLOW_PLANNED,
+            runId,
+            parentRunId: opts.parentRunId,
+            workflowId: workflow.name,
+            path,
+            status: GraphExecutionStatus.PLANNING,
+            payload: { layers: plan.layers.length, nodes: plan.nodes.length },
+        });
+        try {
+            for (const layer of plan.layers) {
+                await this.executeLayer(frame, plan, layer.nodes, opts, emitFn);
+            }
+            frame.finish();
+            await this.emitEvent(frame, {
+                type: GraphExecutionEventType.WORKFLOW_COMPLETED,
+                runId,
+                parentRunId: opts.parentRunId,
+                workflowId: workflow.name,
+                path,
+                status: GraphExecutionStatus.SUCCEEDED,
+                payload: { outputs: valueStore.getWorkflowValues() },
+            });
+            return buildGraphExecutionResult(frame, workflow, inputs, GraphExecutionStatus.SUCCEEDED, opts.metadata);
+        }
+        catch (error) {
+            frame.finish();
+            const errorPayload = this.toErrorPayload(error);
+            await this.emitEvent(frame, {
+                type: GraphExecutionEventType.WORKFLOW_FAILED,
+                runId,
+                parentRunId: opts.parentRunId,
+                workflowId: workflow.name,
+                path,
+                status: GraphExecutionStatus.FAILED,
+                error: errorPayload,
+            });
+            return buildGraphExecutionResult(frame, workflow, inputs, GraphExecutionStatus.FAILED, opts.metadata);
+        }
+    }
+    /**
+     * Pins a node and its upstream dependencies after a completed run.
+     *
+     * Delegates to {@link GraphPinningService}. The plan and result must come
+     * from a prior successful execution of the same workflow.
+     */
+    async pinNode(options) {
+        const service = this.createPinningService();
+        await service.pinNode(options);
+        await this.emitPinningEvent(options.nodeId, GraphExecutionEventType.NODE_PINNED);
+    }
+    /**
+     * Unpins a node by its fingerprint.
+     */
+    async unpinNode(options) {
+        const service = this.createPinningService();
+        await service.unpinNode(options);
+        await this.emitPinningEvent(options.nodeId, GraphExecutionEventType.NODE_UNPINNED);
+    }
+    /**
+     * Creates a {@link GraphPinningService} backed by this engine's value store
+     * adapter.
+     */
+    createPinningService() {
+        const store = new GraphValueStore(this.valueStoreAdapter);
+        return new GraphPinningService(store, new GraphPinningPolicy(), new GraphPinningDependencyResolver());
+    }
+    /**
+     * Emits a pinning-related event to all observers.
+     */
+    async emitPinningEvent(nodeId, type) {
+        const factory = new GraphExecutionEventFactory();
+        const event = factory.create({
+            id: "",
+            sequence: 0,
+            timestamp: new Date(),
+            runId: "pinning",
+            workflowId: "",
+            type,
+            nodeId,
+            path: [],
+        });
+        await this.emitter.updateObservers(event);
+    }
+    /**
+     * Executes a layer of nodes with the configured concurrency.
+     */
+    async executeLayer(frame, plan, nodes, opts, emitFn) {
+        const concurrency = Math.max(1, opts.concurrency ?? GRAPH_DEFAULT_CONCURRENCY);
+        const queue = [...nodes];
+        while (queue.length > 0) {
+            const batch = queue.splice(0, concurrency);
+            await Promise.all(batch.map((node) => this.executeNode(frame, plan, node, opts, emitFn)));
+        }
+    }
+    /**
+     * Executes a single node.
+     */
+    async executeNode(frame, plan, planNode, opts, emitFn) {
+        const startedAt = new Date();
+        const nodePath = [...(opts.path ?? []), planNode.id];
+        await this.emitEvent(frame, {
+            type: GraphExecutionEventType.NODE_STARTED,
+            runId: frame.runId,
+            workflowId: plan.workflowId,
+            nodeId: planNode.id,
+            path: nodePath,
+            status: GraphExecutionStatus.RUNNING,
+        });
+        const inputs = this.resolveNodeInputs(frame, plan, planNode);
+        // Cache-hit: check for a pinned value before executing the node
+        if (opts.usePinnedValues) {
+            const cached = await this.tryPinnedValue(frame, plan, planNode, inputs);
+            if (cached) {
+                frame.valueStore.setNodeOutputs(planNode.id, cached.outputs);
+                this.routeOutgoingEdges(frame, plan, planNode, cached.outputs);
+                const finishedAt = new Date();
+                const result = {
+                    nodeId: planNode.id,
+                    status: GraphExecutionStatus.CACHED,
+                    inputs,
+                    outputs: cached.outputs,
+                    startedAt,
+                    finishedAt,
+                    fromCache: true,
+                    pinned: true,
+                    events: [],
+                };
+                frame.recordNodeResult(result);
+                await this.emitEvent(frame, {
+                    type: GraphExecutionEventType.NODE_CACHE_HIT,
+                    runId: frame.runId,
+                    workflowId: plan.workflowId,
+                    nodeId: planNode.id,
+                    path: nodePath,
+                    status: GraphExecutionStatus.CACHED,
+                    payload: { outputs: cached.outputs },
+                });
+                await this.emitEvent(frame, {
+                    type: GraphExecutionEventType.NODE_COMPLETED,
+                    runId: frame.runId,
+                    workflowId: plan.workflowId,
+                    nodeId: planNode.id,
+                    path: nodePath,
+                    status: GraphExecutionStatus.SUCCEEDED,
+                    payload: { outputs: cached.outputs, fromCache: true },
+                });
+                return;
+            }
+        }
+        try {
+            const executor = this.config.registry.resolve(planNode.kind);
+            const context = new GraphExecutionContext(frame.runId, opts.parentRunId, plan.workflow, planNode.definition, nodePath, emitFn, opts.metadata);
+            const outputs = await executor.execute(inputs, context);
+            const resolvedOutputs = outputs ?? {};
+            frame.valueStore.setNodeOutputs(planNode.id, resolvedOutputs);
+            this.routeOutgoingEdges(frame, plan, planNode, resolvedOutputs);
+            const finishedAt = new Date();
+            const result = {
+                nodeId: planNode.id,
+                status: GraphExecutionStatus.SUCCEEDED,
+                inputs,
+                outputs: resolvedOutputs,
+                startedAt,
+                finishedAt,
+                events: [],
+            };
+            frame.recordNodeResult(result);
+            await this.emitEvent(frame, {
+                type: GraphExecutionEventType.NODE_COMPLETED,
+                runId: frame.runId,
+                workflowId: plan.workflowId,
+                nodeId: planNode.id,
+                path: nodePath,
+                status: GraphExecutionStatus.SUCCEEDED,
+                payload: { outputs: resolvedOutputs },
+            });
+        }
+        catch (error) {
+            const finishedAt = new Date();
+            const errorPayload = this.toErrorPayload(error);
+            const result = {
+                nodeId: planNode.id,
+                status: GraphExecutionStatus.FAILED,
+                inputs,
+                error: errorPayload,
+                startedAt,
+                finishedAt,
+                events: [],
+            };
+            frame.recordNodeResult(result);
+            await this.emitEvent(frame, {
+                type: GraphExecutionEventType.NODE_FAILED,
+                runId: frame.runId,
+                workflowId: plan.workflowId,
+                nodeId: planNode.id,
+                path: nodePath,
+                status: GraphExecutionStatus.FAILED,
+                error: errorPayload,
+            });
+            if (opts.failFast ?? true)
+                throw error;
+        }
+    }
+    /**
+     * Resolves a node's input values from incoming edges.
+     */
+    resolveNodeInputs(frame, plan, planNode) {
+        const inputs = {};
+        const incoming = plan.incomingByNode.get(planNode.id) ?? [];
+        for (const edge of incoming) {
+            inputs[edge.targetPort] = frame.valueStore.getPort(edge.sourceNodeId, edge.sourcePort);
+        }
+        return inputs;
+    }
+    /**
+     * 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
+     * execution.
+     */
+    async tryPinnedValue(frame, plan, planNode, inputs) {
+        const policy = new GraphPinningPolicy();
+        if (!policy.shouldUsePinnedValue(planNode))
+            return undefined;
+        const service = this.createPinningService();
+        const depFingerprints = this.computeDependencyFingerprints(frame, plan, planNode.id);
+        return service.readPinnedValue(plan.workflow, planNode, inputs, depFingerprints);
+    }
+    /**
+     * Recursively computes fingerprints for all upstream dependencies of a node
+     * using the results already accumulated in the frame.
+     */
+    computeDependencyFingerprints(frame, plan, nodeId) {
+        const service = this.createPinningService();
+        const depResolver = new GraphPinningDependencyResolver();
+        const deps = depResolver.getDependencies(plan, nodeId);
+        const fingerprints = {};
+        for (const dep of deps) {
+            const node = plan.nodes.find((n) => n.id === dep);
+            if (node) {
+                const depResult = frame.nodeResults.get(dep);
+                const inputs = depResult?.inputs ?? {};
+                const nestedDeps = this.computeDependencyFingerprints(frame, plan, dep);
+                fingerprints[dep] = service.computeFingerprint(plan.workflow, node, inputs, nestedDeps);
+            }
+        }
+        return fingerprints;
+    }
+    /**
+     * Routes a node's outputs to downstream inputs and workflow outputs.
+     */
+    routeOutgoingEdges(frame, plan, planNode, outputs) {
+        const outgoing = plan.outgoingByNode.get(planNode.id) ?? [];
+        for (const edge of outgoing) {
+            const value = outputs[edge.sourcePort];
+            if (edge.targetNodeId === GRAPH_WORKFLOW_BOUNDARY) {
+                frame.valueStore.setWorkflowOutput(edge.targetPort, value);
+            }
+            this.emitEvent(frame, {
+                type: GraphExecutionEventType.EDGE_VALUE_ROUTED,
+                runId: frame.runId,
+                workflowId: plan.workflowId,
+                edgeId: edge.id,
+                nodeId: planNode.id,
+                path: [],
+                payload: { edge, value },
+            }).catch(() => {
+                // observer failures must not crash
+            });
+        }
+    }
+    /**
+     * Emits an event, records it in the frame, and dispatches to observers.
+     */
+    async emitEvent(frame, partial) {
+        const event = frame.eventFactory.create({
+            id: "",
+            sequence: 0,
+            timestamp: new Date(),
+            ...partial,
+        });
+        frame.appendEvent(event);
+        await this.emitter.updateObservers(event);
+    }
+    /**
+     * Merges default options with the given options.
+     */
+    mergeOptions(options) {
+        return {
+            concurrency: GRAPH_DEFAULT_CONCURRENCY,
+            failFast: true,
+            validateInputs: true,
+            validateOutputs: true,
+            usePinnedValues: true,
+            writeThroughCache: false,
+            path: [],
+            metadata: {},
+            ...this.defaultOptions,
+            ...options,
+        };
+    }
+    /**
+     * Generates a unique run id.
+     */
+    generateRunId() {
+        return (globalThis.crypto?.randomUUID?.() ??
+            `graph-run-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    }
+    /**
+     * Converts an error into a serialized payload.
+     */
+    toErrorPayload(error) {
+        if (error instanceof Error) {
+            return {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+                code: error.graphCode ??
+                    (typeof error.code === "number"
+                        ? String(error.code)
+                        : error.code),
+            };
+        }
+        return { name: "UnknownError", message: String(error) };
+    }
+}
+//# sourceMappingURL=GraphExecutionEngine.js.map

package/lib/esm/graph/execution/GraphExecutionEngine.js.map

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

package/lib/esm/graph/execution/GraphExecutionFrame.js

@@ -0,0 +1,27 @@
+/**
+ * Mutable state for a single graph execution run.
+ */
+export class GraphExecutionFrame {
+    constructor(runId, plan, valueStore, eventFactory) {
+        this.nodeResults = new Map();
+        this.events = [];
+        this.runId = runId;
+        this.plan = plan;
+        this.valueStore = valueStore;
+        this.eventFactory = eventFactory;
+        this.startedAt = new Date();
+    }
+    /** Records a node execution result. */
+    recordNodeResult(result) {
+        this.nodeResults.set(result.nodeId, result);
+    }
+    /** Appends an event to the run's event log. */
+    appendEvent(event) {
+        this.events.push(event);
+    }
+    /** Marks the run as finished. */
+    finish() {
+        this.finishedAt = new Date();
+    }
+}
+//# sourceMappingURL=GraphExecutionFrame.js.map

package/lib/esm/graph/execution/GraphExecutionFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphExecutionFrame.js","sourceRoot":"","sources":["../../../../src/graph/execution/GraphExecutionFrame.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAW9B,YACE,KAAiB,EACjB,IAAwB,EACxB,UAA2B,EAC3B,YAAwC;QATjC,gBAAW,GAA0C,IAAI,GAAG,EAAE,CAAC;QAC/D,WAAM,GAA0B,EAAE,CAAC;QAU1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,uCAAuC;IACvC,gBAAgB,CAAC,MAAgC;QAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,+CAA+C;IAC/C,WAAW,CAAC,KAA0B;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,iCAAiC;IACjC,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/lib/esm/graph/execution/GraphExecutionResult.js

@@ -0,0 +1,26 @@
+/**
+ * Builds a {@link GraphExecutionResult} from a completed frame.
+ */
+export function buildGraphExecutionResult(frame, workflow, inputs, status, metadata) {
+    const outputs = frame.valueStore.getWorkflowValues();
+    const nodeResults = {};
+    for (const [id, result] of frame.nodeResults) {
+        nodeResults[id] = result;
+    }
+    const events = [...frame.events];
+    const runId = frame.runId;
+    return {
+        runId,
+        workflowId: workflow.name,
+        status,
+        workflow,
+        inputs: { ...inputs },
+        outputs,
+        nodeResults,
+        events,
+        startedAt: frame.startedAt,
+        finishedAt: frame.finishedAt,
+        metadata,
+    };
+}
+//# sourceMappingURL=GraphExecutionResult.js.map

package/lib/esm/graph/execution/GraphExecutionResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphExecutionResult.js","sourceRoot":"","sources":["../../../../src/graph/execution/GraphExecutionResult.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA0B,EAC1B,QAAiC,EACjC,MAA4B,EAC5B,MAA4B,EAC5B,QAAkC;IAElC,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;IACrD,MAAM,WAAW,GAA6C,EAAE,CAAC;IACjE,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7C,WAAW,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IAC3B,CAAC;IACD,MAAM,MAAM,GAA0B,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,KAAK,GAAe,KAAK,CAAC,KAAK,CAAC;IAEtC,OAAO;QACL,KAAK;QACL,UAAU,EAAE,QAAQ,CAAC,IAAI;QACzB,MAAM;QACN,QAAQ;QACR,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;QACrB,OAAO;QACP,WAAW;QACX,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/lib/esm/graph/execution/GraphNodeExecutor.js

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

package/lib/esm/graph/execution/GraphNodeExecutor.js.map

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

package/lib/esm/graph/execution/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module integrations/graph/execution
+ * @summary Graph execution context and executor interface.
+ * @description Re-exports the graph execution context and node executor interface.
+ */
+export * from "./GraphExecutionContext.js";
+export * from "./GraphNodeExecutor.js";
+export * from "./GraphExecutionResult.js";
+export * from "./GraphExecutionFrame.js";
+export * from "./GraphExecutionEngine.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/graph/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/graph/execution/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,2CAAwC;AACxC,uCAAoC;AACpC,0CAAuC;AACvC,yCAAsC;AACtC,0CAAuC"}

package/lib/esm/graph/index.js

@@ -0,0 +1,57 @@
+/**
+ * @module integrations/graph
+ * @summary Decaf Graph Execution Engine.
+ * @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.
+ */
+export * from "./constants.js";
+export * from "./types.js";
+export * from "./decorators.js";
+export * from "./errors/GraphExecutionError.js";
+export * from "./errors/GraphCycleError.js";
+export * from "./errors/GraphInputError.js";
+export * from "./errors/GraphLoopLimitError.js";
+export * from "./errors/GraphPinningError.js";
+export * from "./errors/GraphPortError.js";
+export * from "./errors/GraphStoreError.js";
+export * from "./errors/GraphTopologyError.js";
+export * from "./events/GraphExecutionEvent.js";
+export * from "./events/GraphExecutionObserver.js";
+export * from "./events/GraphExecutionEventEmitter.js";
+export * from "./events/GraphExecutionEventFactory.js";
+export * from "./execution/GraphExecutionContext.js";
+export * from "./execution/GraphNodeExecutor.js";
+export * from "./execution/GraphExecutionFrame.js";
+export * from "./execution/GraphExecutionResult.js";
+export * from "./execution/GraphExecutionEngine.js";
+export * from "./registry/GraphNodeExecutorRegistry.js";
+export * from "./registry/GraphNodeExecutorResolver.js";
+export * from "./store/GraphValueKey.js";
+export * from "./store/GraphCachedValue.js";
+export * from "./store/GraphValueStoreAdapter.js";
+export * from "./store/InMemoryGraphValueStoreAdapter.js";
+export * from "./store/GraphValueStore.js";
+export * from "./planning/GraphExecutionPlanNode.js";
+export * from "./planning/GraphExecutionPlanEdge.js";
+export * from "./planning/GraphExecutionPlanLayer.js";
+export * from "./planning/GraphExecutionPlan.js";
+export * from "./planning/GraphRelationResolver.js";
+export * from "./planning/GraphExecutionPlanner.js";
+export * from "./planning/GraphTopology.js";
+// Validation (TASK-215)
+export * from "./validation/GraphDefinitionValidator.js";
+export * from "./validation/GraphPortSchemaResolver.js";
+export * from "./validation/GraphValueValidator.js";
+// Loops (TASK-216)
+export * from "./loops/GraphConditionEvaluator.js";
+export * from "./loops/GraphLoopExecutionContext.js";
+export * from "./loops/ForeachGraphNodeExecutor.js";
+export * from "./loops/WhileGraphNodeExecutor.js";
+export * from "./loops/UntilGraphNodeExecutor.js";
+// Pinning (TASK-217/218)
+export * from "./pinning/GraphPinningMetadata.js";
+export * from "./pinning/GraphPinningPolicy.js";
+export * from "./pinning/GraphPinningDependencyResolver.js";
+export * from "./pinning/GraphPinningService.js";
+// Snapshots (TASK-219)
+export * from "./snapshots/GraphExecutionSnapshotMapper.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+BAA4B;AAC5B,2BAAwB;AACxB,gCAA6B;AAE7B,gDAA6C;AAC7C,4CAAyC;AACzC,4CAAyC;AACzC,gDAA6C;AAC7C,8CAA2C;AAC3C,2CAAwC;AACxC,4CAAyC;AACzC,+CAA4C;AAE5C,gDAA6C;AAC7C,mDAAgD;AAChD,uDAAoD;AACpD,uDAAoD;AAEpD,qDAAkD;AAClD,iDAA8C;AAC9C,mDAAgD;AAChD,oDAAiD;AACjD,oDAAiD;AAEjD,wDAAqD;AACrD,wDAAqD;AAErD,yCAAsC;AACtC,4CAAyC;AACzC,kDAA+C;AAC/C,0DAAuD;AACvD,2CAAwC;AAExC,qDAAkD;AAClD,qDAAkD;AAClD,sDAAmD;AACnD,iDAA8C;AAC9C,oDAAiD;AACjD,oDAAiD;AACjD,4CAAyC;AAEzC,wBAAwB;AACxB,yDAAsD;AACtD,wDAAqD;AACrD,oDAAiD;AAEjD,mBAAmB;AACnB,mDAAgD;AAChD,qDAAkD;AAClD,oDAAiD;AACjD,kDAA+C;AAC/C,kDAA+C;AAE/C,yBAAyB;AACzB,kDAA+C;AAC/C,gDAA6C;AAC7C,4DAAyD;AACzD,iDAA8C;AAE9C,uBAAuB;AACvB,4DAAyD"}

package/lib/esm/graph/loops/ForeachGraphNodeExecutor.js

@@ -0,0 +1,79 @@
+import { GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS, GraphExecutionEventType } from "./../constants.js";
+import { GraphInputError } from "./../errors/GraphInputError.js";
+import { GraphLoopLimitError } from "./../errors/GraphLoopLimitError.js";
+/**
+ * Executor for `core.loop.foreach` nodes.
+ *
+ * Expects input:
+ * - `items`: array of values to iterate over
+ * - `state?`: optional initial state
+ *
+ * Produces output:
+ * - `results`: array of body outputs (in item order)
+ * - `state?`: final state
+ * - `iterations`: number of iterations executed
+ */
+export class ForeachGraphNodeExecutor {
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async execute(input, context) {
+        const metadata = this.extractMetadata(context);
+        const items = input.items;
+        const maxIterations = metadata.maxIterations ?? GRAPH_DEFAULT_MAX_FOREACH_ITERATIONS;
+        if (!Array.isArray(items)) {
+            throw new GraphInputError("foreach input 'items' must be an array");
+        }
+        if (items.length > maxIterations) {
+            throw new GraphLoopLimitError(`foreach exceeded max iterations (${items.length} > ${maxIterations})`);
+        }
+        const itemPort = metadata.itemPort ?? "item";
+        const resultPort = metadata.resultPort ?? "result";
+        const statePort = metadata.statePort ?? "state";
+        const bodyWorkflow = metadata.body;
+        const results = [];
+        let state = input.state;
+        await context.emit({ type: GraphExecutionEventType.LOOP_STARTED });
+        for (let i = 0; i < items.length; i++) {
+            await context.emit({
+                type: GraphExecutionEventType.LOOP_ITERATION_STARTED,
+                iteration: i,
+            });
+            const childInputs = {
+                [itemPort]: items[i],
+                index: i,
+            };
+            if (state !== undefined)
+                childInputs[statePort] = state;
+            const childResult = await this.engine.execute(bodyWorkflow, childInputs, {
+                parentRunId: context.runId,
+                path: [...context.path, `iteration:${i}`],
+            });
+            results.push(childResult.outputs[resultPort]);
+            if (childResult.outputs[statePort] !== undefined) {
+                state = childResult.outputs[statePort];
+            }
+            await context.emit({
+                type: GraphExecutionEventType.LOOP_ITERATION_COMPLETED,
+                iteration: i,
+            });
+        }
+        await context.emit({ type: GraphExecutionEventType.LOOP_COMPLETED });
+        const output = {
+            results,
+            iterations: items.length,
+        };
+        if (state !== undefined)
+            output[statePort] = state;
+        return output;
+    }
+    extractMetadata(context) {
+        const raw = context.node.graph?.metadata?.loop ??
+            context.metadata?.loop;
+        if (!raw) {
+            throw new GraphInputError("foreach node is missing loop metadata");
+        }
+        return raw;
+    }
+}
+//# sourceMappingURL=ForeachGraphNodeExecutor.js.map

package/lib/esm/graph/loops/ForeachGraphNodeExecutor.js.map

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