@bian-womp/spark-graph 0.3.88 → 0.3.90

package/lib/src/runtime/components/EdgePropagator.js

@@ -0,0 +1,378 @@
+import { isTyped, unwrapTypeId } from "../../core/type-utils";
+import { formatNodeRef, valuesEqual } from "../utils";
+/**
+ * EdgePropagator component - handles value propagation through edges
+ */
+export class EdgePropagator {
+    constructor(graph, eventEmitter, runContextManager, nodeExecutor, runtime) {
+        this.graph = graph;
+        this.eventEmitter = eventEmitter;
+        this.runContextManager = runContextManager;
+        this.nodeExecutor = nodeExecutor;
+        this.runtime = runtime;
+        this.arrayInputBuckets = new Map();
+    }
+    /**
+     * Set source output value and emit event
+     */
+    setSourceOutput(srcNodeId, srcHandle, value) {
+        if (!this.graph.hasNode(srcNodeId)) {
+            // Node was removed (e.g., graph updated) but an async emit arrived late; ignore
+            return false;
+        }
+        this.graph.updateNodeOutput(srcNodeId, srcHandle, value);
+        return true;
+    }
+    /**
+     * Find all outgoing edges from a source node handle
+     */
+    findOutgoingEdges(srcNodeId, srcHandle) {
+        return this.graph.getEdgesBySource(srcNodeId, srcHandle);
+    }
+    /**
+     * Propagate value to a single edge
+     */
+    propagateToEdge(edge, value, srcNodeId, runContextIds) {
+        // Filter run-contexts
+        const effectiveRunContexts = runContextIds && runContextIds.size > 0
+            ? this.filterEffectiveRunContexts(edge, srcNodeId, runContextIds)
+            : undefined;
+        if (runContextIds && runContextIds.size > 0 && !(effectiveRunContexts && effectiveRunContexts.size > 0)) {
+            return; // No valid run-contexts for this edge
+        }
+        // Validate union types
+        if (!this.validateUnionType(edge, value, srcNodeId)) {
+            return;
+        }
+        // Clone value per edge to isolate conversions
+        let nextVal = structuredClone(value);
+        // Apply conversion and propagate
+        if (edge.convertAsync) {
+            this.handleAsyncConversion(edge, nextVal, effectiveRunContexts);
+        }
+        else {
+            this.handleSyncConversion(edge, nextVal, effectiveRunContexts);
+        }
+    }
+    /**
+     * Filter run-contexts to exclude cancelled nodes
+     */
+    filterEffectiveRunContexts(edge, srcNodeId, runContextIds) {
+        const effectiveRunContexts = new Set();
+        for (const id of runContextIds) {
+            const ctx = this.runContextManager.getRunContext(id);
+            if (!ctx)
+                continue;
+            if (ctx.cancelledNodes.has(srcNodeId))
+                continue;
+            if (ctx.cancelledNodes.has(edge.target.nodeId))
+                continue;
+            effectiveRunContexts.add(id);
+        }
+        return effectiveRunContexts.size > 0 ? effectiveRunContexts : undefined;
+    }
+    /**
+     * Validate union type requirements
+     */
+    validateUnionType(edge, value, srcNodeId) {
+        const isUnion = Array.isArray(edge.srcUnionTypes);
+        const isTypedValue = isTyped(value);
+        if (isUnion && !isTypedValue) {
+            const sourceTypeId = this.graph.getNode(edge.source.nodeId)?.typeId;
+            const targetTypeId = this.graph.getNode(edge.target.nodeId)?.typeId;
+            const err = new Error(`Output ${srcNodeId}.${edge.source.handle} requires typed value for union output (allowed: ${edge.srcUnionTypes.join("|")})`);
+            this.eventEmitter.emit("error", {
+                kind: "edge-convert",
+                edgeId: edge.id,
+                source: { nodeId: edge.source.nodeId, handle: edge.source.handle },
+                target: { nodeId: edge.target.nodeId, handle: edge.target.handle },
+                sourceTypeId,
+                targetTypeId,
+                err,
+            });
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Handle synchronous conversion
+     */
+    handleSyncConversion(edge, value, effectiveRunContexts) {
+        let convertedValue = value;
+        if (edge.convert) {
+            convertedValue = edge.convert(value);
+        }
+        else {
+            const srcResolved = this.graph.getResolvedHandles(edge.source.nodeId);
+            const dstResolved = this.graph.getResolvedHandles(edge.target.nodeId);
+            const srcResolvedNode = srcResolved !== undefined;
+            const dstResolvedNode = dstResolved !== undefined;
+            const srcResolvedHandle = srcResolvedNode && srcResolved.outputs?.[edge.source.handle] !== undefined;
+            const dstResolvedHandle = dstResolvedNode && dstResolved.inputs?.[edge.target.handle] !== undefined;
+            const fromType = (Array.isArray(edge.srcUnionTypes) && edge.srcUnionTypes.length > 0
+                ? edge.srcUnionTypes.join("|")
+                : undefined) ??
+                unwrapTypeId(value) ??
+                (Array.isArray(edge.srcDeclared) ? edge.srcDeclared.join("|") : edge.srcDeclared) ??
+                edge.typeId ??
+                "unknown";
+            const toType = Array.isArray(edge.dstDeclared) ? edge.dstDeclared.join("|") : (edge.dstDeclared ?? "unknown");
+            console.warn(`No convert function for edge ${edge.id} [${formatNodeRef(this.graph, edge.source.nodeId)}.${edge.source.handle} -> ${formatNodeRef(this.graph, edge.target.nodeId)}.${edge.target.handle}] from:${fromType} to:${toType}`);
+            console.warn(`Edge ${edge.id} unresolved-handle details: resolvedHandles:{srcNode:${srcResolvedNode},srcHandle:${srcResolvedHandle},dstNode:${dstResolvedNode},dstHandle:${dstResolvedHandle}}`);
+        }
+        this.applyToTarget(edge, convertedValue, effectiveRunContexts);
+    }
+    /**
+     * Handle asynchronous conversion
+     */
+    handleAsyncConversion(edge, value, effectiveRunContexts) {
+        if (!edge.convertAsync)
+            return;
+        // Track edge run-context IDs for pendingEdges tracking
+        const edgeRunContextIds = effectiveRunContexts ? Array.from(effectiveRunContexts) : undefined;
+        if (edgeRunContextIds) {
+            for (const id of edgeRunContextIds) {
+                this.runContextManager.startEdgeConversion(id, edge.id);
+            }
+        }
+        const sourceTypeId = this.graph.getNode(edge.source.nodeId)?.typeId;
+        const targetTypeId = this.graph.getNode(edge.target.nodeId)?.typeId;
+        this.eventEmitter.emit("stats", {
+            kind: "edge-start",
+            edgeId: edge.id,
+            typeId: edge.typeId,
+            source: { nodeId: edge.source.nodeId, handle: edge.source.handle },
+            target: { nodeId: edge.target.nodeId, handle: edge.target.handle },
+            sourceTypeId,
+            targetTypeId,
+        });
+        const controller = new AbortController();
+        const startAt = Date.now();
+        const currentStats = edge.stats;
+        this.graph.updateEdgeStats(edge.id, {
+            runs: currentStats.runs + 1,
+            inFlight: true,
+            progress: 0,
+        });
+        edge
+            .convertAsync(value, controller.signal)
+            .then((converted) => {
+            if (!controller.signal.aborted) {
+                this.applyToTarget(edge, converted, effectiveRunContexts);
+                this.updateEdgeStatsOnSuccess(edge, startAt);
+            }
+        })
+            .catch((err) => {
+            if (controller.signal.aborted)
+                return;
+            this.handleEdgeConversionError(edge, err);
+        })
+            .finally(() => {
+            this.finishEdgeConversion(edgeRunContextIds, edge.id);
+        });
+    }
+    /**
+     * Apply value to target node input
+     */
+    applyToTarget(edge, value, effectiveRunContexts) {
+        const dstNode = this.graph.getNode(edge.target.nodeId);
+        if (!dstNode)
+            return;
+        // Skip writing to unresolved handles
+        if (edge.dstDeclared === undefined)
+            return;
+        // Handle array types
+        const processedValue = this.processArrayInput(edge, value);
+        // Check if value changed
+        const prev = dstNode.inputs[edge.target.handle];
+        const valueChanged = !valuesEqual(prev, processedValue);
+        // Check if we should execute even if value is same:
+        // 1. If node has rerunOnSameInput policy (from node params or registry)
+        // 2. If input was set after last successful run (stale input detection)
+        const registry = this.graph.getRegistry();
+        const desc = registry?.nodes.get(dstNode.typeId);
+        const nodeRerunPolicy = dstNode.policy?.rerunOnSameInput === true;
+        const descRerunPolicy = desc?.policy?.rerunOnSameInput === true;
+        const shouldRerunOnSameInput = nodeRerunPolicy || descRerunPolicy;
+        const inputWasSetAfterLastRun = !dstNode.lastInputAt?.[edge.target.handle] ||
+            !dstNode.lastSuccessAt ||
+            dstNode.lastInputAt[edge.target.handle] > dstNode.lastSuccessAt;
+        const shouldExecute = valueChanged || shouldRerunOnSameInput || inputWasSetAfterLastRun;
+        if (!shouldExecute) {
+            return; // No change and no reason to rerun
+        }
+        // Set input value
+        if (valueChanged) {
+            this.runtime.setTargetInput(edge, processedValue, "applyToTarget");
+        }
+        else {
+            // Even if value didn't change, update timestamp if we're forcing execution
+            const now = Date.now();
+            this.graph.updateNodeLastInputAt(edge.target.nodeId, edge.target.handle, now);
+        }
+        // Schedule downstream execution
+        this.executeDownstream(edge.target.nodeId, effectiveRunContexts);
+    }
+    /**
+     * Process array input by merging values from all edges
+     */
+    processArrayInput(edge, value) {
+        const dstIsArray = typeof edge.dstDeclared === "string" && edge.dstDeclared.endsWith("[]");
+        if (!dstIsArray) {
+            return value;
+        }
+        const toArray = (x) => (Array.isArray(x) ? x : x === undefined ? [] : [x]);
+        let forNode = this.arrayInputBuckets.get(edge.target.nodeId);
+        if (!forNode) {
+            forNode = new Map();
+            this.arrayInputBuckets.set(edge.target.nodeId, forNode);
+        }
+        let forHandle = forNode.get(edge.target.handle);
+        if (!forHandle) {
+            forHandle = new Map();
+            forNode.set(edge.target.handle, forHandle);
+        }
+        forHandle.set(edge.id, toArray(value));
+        // Merge all parts for this handle
+        const targetEdges = this.graph.getEdgesByTarget(edge.target.nodeId, edge.target.handle);
+        const merged = [];
+        for (const ed of targetEdges) {
+            const part = forHandle.get(ed.id);
+            if (part && part.length)
+                merged.push(...part);
+        }
+        return merged;
+    }
+    /**
+     * Execute downstream if conditions are met
+     */
+    executeDownstream(targetNodeId, effectiveRunContexts) {
+        // Determine if we should propagate
+        const shouldPropagate = this.shouldPropagateExecution(effectiveRunContexts);
+        if (shouldPropagate && this.graph.allInboundHaveValue(targetNodeId)) {
+            this.nodeExecutor.execute(targetNodeId, {
+                runContextIds: effectiveRunContexts,
+                reason: "executeDownstream",
+            });
+        }
+    }
+    /**
+     * Check if execution should propagate
+     */
+    shouldPropagateExecution(effectiveRunContexts) {
+        if (!effectiveRunContexts) {
+            // Without run-context IDs, only auto mode should schedule downstream execution.
+            // In manual mode this path is used for value refresh/re-emits (e.g. handle updates),
+            // and should not implicitly trigger node runs.
+            return this.runtime.getRunMode() === "auto";
+        }
+        // Check propagate flag (only in run-context mode)
+        for (const id of effectiveRunContexts) {
+            const ctx = this.runContextManager.getRunContext(id);
+            if (ctx && ctx.propagate) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Update edge stats on successful conversion
+     */
+    updateEdgeStatsOnSuccess(edge, startAt) {
+        const duration = Date.now() - startAt;
+        this.graph.updateEdgeStats(edge.id, {
+            inFlight: false,
+            lastDurationMs: duration,
+            lastEndAt: Date.now(),
+            lastError: undefined,
+        });
+        this.eventEmitter.emit("stats", {
+            kind: "edge-done",
+            edgeId: edge.id,
+            typeId: edge.typeId,
+            source: { nodeId: edge.source.nodeId, handle: edge.source.handle },
+            target: { nodeId: edge.target.nodeId, handle: edge.target.handle },
+            sourceTypeId: this.graph.getNode(edge.source.nodeId)?.typeId,
+            targetTypeId: this.graph.getNode(edge.target.nodeId)?.typeId,
+            durationMs: duration,
+        });
+    }
+    /**
+     * Handle edge conversion error
+     */
+    handleEdgeConversionError(edge, err) {
+        this.graph.updateEdgeStats(edge.id, {
+            inFlight: false,
+            lastError: err,
+        });
+        this.eventEmitter.emit("error", {
+            kind: "edge-convert",
+            edgeId: edge.id,
+            source: { nodeId: edge.source.nodeId, handle: edge.source.handle },
+            target: { nodeId: edge.target.nodeId, handle: edge.target.handle },
+            sourceTypeId: this.graph.getNode(edge.source.nodeId)?.typeId,
+            targetTypeId: this.graph.getNode(edge.target.nodeId)?.typeId,
+            err,
+        });
+    }
+    /**
+     * Finish edge conversion and decrement pending edges
+     */
+    finishEdgeConversion(edgeRunContextIds, edgeId) {
+        if (!edgeRunContextIds)
+            return;
+        for (const id of edgeRunContextIds) {
+            this.runContextManager.finishEdgeConversion(id, edgeId);
+        }
+    }
+    /**
+     * Propagate value through edges
+     * @param runContextIds - Optional set of run-context IDs. If provided, propagation is run-context aware.
+     *                        If undefined or empty, behaves like auto mode (always propagates values and execution).
+     */
+    propagate(srcNodeId, srcHandle, value, runContextIds) {
+        // Set source output
+        if (!this.setSourceOutput(srcNodeId, srcHandle, value)) {
+            return; // Node was removed
+        }
+        // Find outgoing edges
+        const outEdges = this.findOutgoingEdges(srcNodeId, srcHandle);
+        // Process each edge
+        for (const edge of outEdges) {
+            this.propagateToEdge(edge, value, srcNodeId, runContextIds);
+        }
+    }
+    /**
+     * Re-emit all outputs from a node (used when graph updates)
+     * Only re-emits outputs that are valid according to resolved handles
+     */
+    invalidateDownstream(nodeId) {
+        const node = this.graph.getNode(nodeId);
+        if (!node)
+            return;
+        // Get resolved handles to filter out invalid outputs
+        const resolved = this.graph.getResolvedHandles(nodeId);
+        const validOutputHandles = resolved?.outputs ? new Set(Object.keys(resolved.outputs)) : new Set();
+        // Use node's activeRunContexts to propagate to new nodes that were added
+        const activeRunContextIds = this.graph.getNodeRunContextIds(nodeId);
+        for (const [handle, value] of Object.entries(node.outputs)) {
+            // Only re-emit if this handle is still valid
+            if (validOutputHandles.has(handle)) {
+                this.propagate(nodeId, handle, value, activeRunContextIds.size > 0 ? activeRunContextIds : undefined);
+            }
+        }
+    }
+    /**
+     * Clear array input buckets for a node (when node is deleted)
+     */
+    clearArrayBuckets(nodeId) {
+        this.arrayInputBuckets.delete(nodeId);
+    }
+    /**
+     * Clear all array buckets
+     */
+    clearAllArrayBuckets() {
+        this.arrayInputBuckets.clear();
+    }
+}
+//# sourceMappingURL=EdgePropagator.js.map

package/lib/src/runtime/components/EdgePropagator.js.map

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

package/lib/src/runtime/components/EventEmitter.d.ts

@@ -0,0 +1,12 @@
+import type { RuntimeEventName, RuntimeEventMap, RuntimeEventListener } from "../GraphRuntime";
+/**
+ * Event emitter component for GraphRuntime
+ * Handles all event listener management and emission
+ */
+export declare class EventEmitter {
+    private listeners;
+    on<K extends RuntimeEventName>(event: K, handler: RuntimeEventListener<K>): () => void;
+    emit<K extends RuntimeEventName>(event: K, payload: RuntimeEventMap[K]): void;
+    clear(): void;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

package/lib/src/runtime/components/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/components/EventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE/F;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAA4E;IAE7F,EAAE,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAOtF,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAY7E,KAAK,IAAI,IAAI;CAGd"}

package/lib/src/runtime/components/EventEmitter.js

@@ -0,0 +1,33 @@
+/**
+ * Event emitter component for GraphRuntime
+ * Handles all event listener management and emission
+ */
+export class EventEmitter {
+    constructor() {
+        this.listeners = new Map();
+    }
+    on(event, handler) {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        const set = this.listeners.get(event);
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        for (const handler of Array.from(set)) {
+            try {
+                handler(payload);
+            }
+            catch (err) {
+                console.error(`Error in ${event} handler:`, err);
+            }
+        }
+    }
+    clear() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=EventEmitter.js.map

package/lib/src/runtime/components/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../../../../src/runtime/components/EventEmitter.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,YAAY;IAAzB;QACU,cAAS,GAAG,IAAI,GAAG,EAAiE,CAAC;IAwB/F,CAAC;IAtBC,EAAE,CAA6B,KAAQ,EAAE,OAAgC;QACvE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAiC,CAAC;QACtE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAA6B,KAAQ,EAAE,OAA2B;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,YAAY,KAAK,WAAW,EAAE,GAAG,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/lib/src/runtime/components/Graph.d.ts

@@ -0,0 +1,208 @@
+import type { ResolvedHandles } from "@bian-womp/spark-protocol";
+import { Registry } from "../../builder/Registry";
+import { EventEmitter } from "./EventEmitter";
+import type { RuntimeNode, RuntimeEdge, ReadonlyRuntimeNode, ExecutionPlan } from "./types";
+/**
+ * Graph component - manages nodes, edges, and handle resolution
+ * This is the ONLY place where nodes, edges, and resolvedByNode are directly updated.
+ */
+export declare class Graph {
+    private eventEmitter;
+    private registry?;
+    private nodes;
+    private edges;
+    private resolvedByNode;
+    constructor(eventEmitter: EventEmitter, registry?: Registry | undefined);
+    /**
+     * Get a node by ID (readonly to prevent accidental modifications)
+     */
+    getNode(nodeId: string): ReadonlyRuntimeNode<any> | undefined;
+    /**
+     * Get a node by ID (mutable, for internal use only)
+     * @internal
+     */
+    private getNodeMutable;
+    /**
+     * Iterate over all nodes safely (readonly to prevent accidental modifications)
+     */
+    forEachNode(callback: (node: ReadonlyRuntimeNode<any>, nodeId: string) => void): void;
+    /**
+     * Get all node IDs
+     */
+    getNodeIds(): string[];
+    /**
+     * Check if a node exists
+     */
+    hasNode(nodeId: string): boolean;
+    /**
+     * Set a node (creates or replaces)
+     */
+    setNode(nodeId: string, node: RuntimeNode<any>): void;
+    /**
+     * Delete a node
+     */
+    deleteNode(nodeId: string): void;
+    /**
+     * Update node inputs
+     */
+    updateNodeInput(nodeId: string, handle: string, value: unknown, calculated?: boolean): void;
+    /**
+     * Update node outputs
+     */
+    updateNodeOutput(nodeId: string, handle: string, value: unknown): void;
+    /**
+     * Update node state
+     */
+    updateNodeState(nodeId: string, updates: Partial<RuntimeNode<any>["state"]>): void;
+    /**
+     * Update node params
+     */
+    updateNodeParams(nodeId: string, params: Record<string, unknown> | undefined): void;
+    /**
+     * Update node policy
+     */
+    updateNodePolicy(nodeId: string, policy: Partial<RuntimeNode<any>["policy"]>): void;
+    /**
+     * Update node stats
+     */
+    updateNodeStats(nodeId: string, updates: Partial<RuntimeNode<any>["stats"]>): void;
+    /**
+     * Increment node runSeq
+     */
+    incrementNodeRunSeq(nodeId: string): number;
+    /**
+     * Set node latestRunId
+     */
+    setNodeLatestRunId(nodeId: string, runId: string): void;
+    /**
+     * Set node lastScheduledAt
+     */
+    setNodeLastScheduledAt(nodeId: string, timestamp: number): void;
+    /**
+     * Update node lastInputAt timestamp for a handle
+     */
+    updateNodeLastInputAt(nodeId: string, handle: string, timestamp: number): void;
+    /**
+     * Set node lastSuccessAt timestamp
+     */
+    setNodeLastSuccessAt(nodeId: string, timestamp: number): void;
+    /**
+     * Add item to node queue
+     */
+    addToNodeQueue(nodeId: string, item: ExecutionPlan): void;
+    /**
+     * Remove first item from node queue
+     */
+    shiftNodeQueue(nodeId: string): ExecutionPlan | undefined;
+    /**
+     * Clear node queue
+     */
+    clearNodeQueue(nodeId: string): void;
+    /**
+     * Replace node queue
+     */
+    replaceNodeQueue(nodeId: string, items: ExecutionPlan[]): void;
+    /**
+     * Add controller to node
+     */
+    addNodeController(nodeId: string, controller: AbortController, runId: string): void;
+    /**
+     * Remove controller from node
+     */
+    removeNodeController(nodeId: string, controller: AbortController): void;
+    /**
+     * Clear all controllers from node
+     */
+    clearNodeControllers(nodeId: string): void;
+    /**
+     * Get all controllers for a node
+     */
+    getNodeControllers(nodeId: string): Set<AbortController>;
+    /**
+     * Add run context ID to node
+     */
+    addNodeRunContextId(nodeId: string, runContextId: string): void;
+    /**
+     * Add multiple run context IDs to node
+     */
+    addNodeRunContextIds(nodeId: string, runContextIds: Set<string>): void;
+    /**
+     * Remove run context ID from node
+     */
+    removeNodeRunContextId(nodeId: string, runContextId: string): void;
+    /**
+     * Clear all run context IDs from node
+     */
+    clearNodeRunContextIds(nodeId: string): void;
+    /**
+     * Get run context IDs for a node
+     */
+    getNodeRunContextIds(nodeId: string): Set<string>;
+    /**
+     * Add snapshot cancelled run ID to node
+     */
+    addSnapshotCancelledRunId(nodeId: string, runId: string): void;
+    /**
+     * Iterate over all edges safely
+     */
+    forEachEdge(callback: (edge: RuntimeEdge, index: number) => void): void;
+    /**
+     * Find edges matching a predicate
+     */
+    findEdges(predicate: (edge: RuntimeEdge) => boolean): RuntimeEdge[];
+    /**
+     * Get edges by source node and handle
+     */
+    getEdgesBySource(srcNodeId: string, srcHandle: string): RuntimeEdge[];
+    /**
+     * Get edges by target node and handle
+     */
+    getEdgesByTarget(targetNodeId: string, targetHandle: string): RuntimeEdge[];
+    /**
+     * Get inbound edges for a node
+     */
+    getInboundEdges(nodeId: string): RuntimeEdge[];
+    /**
+     * Get outbound edges for a node
+     */
+    getOutboundEdges(nodeId: string): RuntimeEdge[];
+    /**
+     * Set all edges (replaces existing)
+     */
+    setEdges(edges: RuntimeEdge[]): void;
+    /**
+     * Update an edge by ID
+     */
+    updateEdge(edgeId: string, updates: Partial<RuntimeEdge>): void;
+    /**
+     * Update edge properties (convert, convertAsync, types, etc.)
+     */
+    updateEdgeProperties(edgeId: string, updates: {
+        srcDeclared?: string | string[];
+        dstDeclared?: string | string[];
+        srcUnionTypes?: string[] | undefined;
+        convert?: ((value: unknown) => unknown) | undefined;
+        convertAsync?: ((value: unknown, signal: AbortSignal) => Promise<unknown>) | undefined;
+    }): void;
+    /**
+     * Update edge stats
+     */
+    updateEdgeStats(edgeId: string, updates: Partial<RuntimeEdge["stats"]>): void;
+    /**
+     * Get edge by ID
+     */
+    getEdge(edgeId: string): RuntimeEdge | undefined;
+    getRegistry(): Registry | undefined;
+    setRegistry(registry: Registry): void;
+    getResolvedHandles(nodeId: string): ResolvedHandles | undefined;
+    setResolvedHandles(nodeId: string, handles: ResolvedHandles): void;
+    /**
+     * Check if all inbound edges for a node have values
+     */
+    allInboundHaveValue(nodeId: string): boolean;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+}
+//# sourceMappingURL=Graph.d.ts.map

package/lib/src/runtime/components/Graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Graph.d.ts","sourceRoot":"","sources":["../../../../src/runtime/components/Graph.ts"],"names":[],"mappings":"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"}