@bian-womp/spark-graph 0.3.46 → 0.3.48

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

@@ -0,0 +1,372 @@
+import { isTyped } from "../../core/type-utils";
+import { valuesEqual } from "../utils";
+/**
+ * EdgePropagator component - handles value propagation through edges
+ */
+export class EdgePropagator {
+    constructor(graph, eventEmitter, runContextManager, handleResolver, nodeExecutor) {
+        this.graph = graph;
+        this.eventEmitter = eventEmitter;
+        this.runContextManager = runContextManager;
+        this.handleResolver = handleResolver;
+        this.nodeExecutor = nodeExecutor;
+        this.arrayInputBuckets = new Map();
+    }
+    /**
+     * 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);
+        }
+    }
+    /**
+     * 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 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 },
+                err,
+            });
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Handle synchronous conversion
+     */
+    handleSyncConversion(edge, value, effectiveRunContexts) {
+        let convertedValue = value;
+        if (edge.convert) {
+            convertedValue = edge.convert(value);
+        }
+        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);
+            }
+        }
+        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 },
+        });
+        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 (respecting skipPropagateValues)
+        const shouldSetValue = this.shouldSetInputValue(effectiveRunContexts);
+        if (shouldSetValue && valueChanged) {
+            this.setTargetInput(edge, dstNode, processedValue);
+        }
+        else if (shouldSetValue && !valueChanged) {
+            // 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;
+    }
+    /**
+     * Check if input value should be set (respecting skipPropagateValues)
+     */
+    shouldSetInputValue(effectiveRunContexts) {
+        if (!effectiveRunContexts) {
+            return true; // Auto mode always sets values
+        }
+        // Check skipPropagateValues (only in run-context mode)
+        for (const id of effectiveRunContexts) {
+            const ctx = this.runContextManager.getRunContext(id);
+            if (ctx && ctx.skipPropagateValues) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Set target input value and emit event
+     */
+    setTargetInput(edge, dstNode, value) {
+        this.graph.updateNodeInput(edge.target.nodeId, edge.target.handle, value);
+        this.handleResolver.scheduleRecomputeHandles(edge.target.nodeId);
+    }
+    /**
+     * 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, effectiveRunContexts);
+        }
+    }
+    /**
+     * Check if execution should propagate
+     */
+    shouldPropagateExecution(effectiveRunContexts) {
+        if (!effectiveRunContexts) {
+            return true; // Auto mode always propagates
+        }
+        // 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 },
+            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 },
+            err,
+        });
+    }
+    /**
+     * Finish edge conversion and decrement pending edges
+     */
+    finishEdgeConversion(edgeRunContextIds, edgeId) {
+        if (!edgeRunContextIds)
+            return;
+        for (const id of edgeRunContextIds) {
+            this.runContextManager.finishEdgeConversion(id, edgeId);
+        }
+    }
+    /**
+     * 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,EACV,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACrB,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAGb;IAEJ,EAAE,CAAC,CAAC,SAAS,gBAAgB,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,MAAM,IAAI;IAOb,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAC7B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,IAAI;IAYP,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":"AAMA;;;GAGG;AACH,MAAM,OAAO,YAAY;IAAzB;QACU,cAAS,GAAG,IAAI,GAAG,EAGxB,CAAC;IA8BN,CAAC;IA5BC,EAAE,CACA,KAAQ,EACR,OAAgC;QAEhC,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,CACF,KAAQ,EACR,OAA2B;QAE3B,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,211 @@
+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: {
+        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;
+    /**
+     * Iterate over resolved handles safely
+     */
+    forEachResolvedHandles(callback: (handles: ResolvedHandles, nodeId: string) => void): 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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"}