@bian-womp/spark-graph 0.3.88 → 0.3.89

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

@@ -0,0 +1,229 @@
+import { LOG_LEVEL_VALUES } from "@bian-womp/spark-protocol";
+import { buildEdgeConverters, extractEdgeTypes } from "./graph-utils";
+import { mergeInputHandleDescriptors } from "../../core/type-utils";
+import { formatNodeRef, unwrapMaybePromise } from "../utils";
+/**
+ * HandleResolver component - manages dynamic handle resolution
+ */
+export class HandleResolver {
+    constructor(graph, eventEmitter, runContextManager, edgePropagator, registry, environment) {
+        this.graph = graph;
+        this.eventEmitter = eventEmitter;
+        this.runContextManager = runContextManager;
+        this.edgePropagator = edgePropagator;
+        this.registry = registry;
+        this.recomputeTokenByNode = new Map();
+        this.environment = {};
+        this.pendingResolutions = new Map();
+        this.isRecomputing = new Map();
+        this.environment = environment ?? {};
+    }
+    setRegistry(registry) {
+        this.registry = registry;
+    }
+    setEnvironment(environment) {
+        this.environment = environment;
+    }
+    /**
+     * Get the promise for pending handle resolution, or null if none
+     */
+    getPendingResolution(nodeId) {
+        return this.pendingResolutions.get(nodeId) || null;
+    }
+    /**
+     * Schedule async recomputation of handles for a node
+     */
+    scheduleRecomputeHandles(nodeId) {
+        // If no registry or node not found, skip
+        if (!this.registry)
+            return;
+        const node = this.graph.getNode(nodeId);
+        if (!node)
+            return;
+        // If already recomputing, increment token to mark that a new recompute is needed
+        // but don't schedule another concurrent execution
+        if (this.isRecomputing.get(nodeId)) {
+            const currentToken = this.recomputeTokenByNode.get(nodeId) ?? 0;
+            this.recomputeTokenByNode.set(nodeId, currentToken + 1);
+            return;
+        }
+        // Track resolver start for all active run-contexts
+        const activeRunContextIds = this.graph.getNodeRunContextIds(nodeId);
+        if (activeRunContextIds.size > 0) {
+            for (const runContextId of activeRunContextIds) {
+                this.runContextManager.startHandleResolution(runContextId, nodeId);
+            }
+        }
+        // Mark as recomputing
+        this.isRecomputing.set(nodeId, true);
+        // Capture initial token before starting (will be incremented in recomputeHandlesForNode)
+        const initialToken = this.recomputeTokenByNode.get(nodeId) ?? 0;
+        // Create and track the resolution promise
+        const resolutionPromise = new Promise((resolve) => {
+            setTimeout(async () => {
+                await this.recomputeHandlesForNode(nodeId, activeRunContextIds);
+                this.pendingResolutions.delete(nodeId);
+                this.isRecomputing.delete(nodeId);
+                // Check if a new recompute was requested while we were running
+                // (token was incremented by another scheduleRecomputeHandles call)
+                const finalToken = this.recomputeTokenByNode.get(nodeId) ?? 0;
+                // After recomputeHandlesForNode, token should be initialToken + 1
+                // If finalToken > initialToken + 1, a new recompute was requested
+                if (finalToken > initialToken + 1) {
+                    // A new recompute was requested, schedule it now
+                    this.scheduleRecomputeHandles(nodeId);
+                }
+                resolve();
+            }, 0);
+        });
+        this.pendingResolutions.set(nodeId, resolutionPromise);
+    }
+    // Update resolved handles for a single node and refresh edge converters/types that touch it
+    updateNodeHandles(nodeId, handles) {
+        if (!this.registry)
+            return;
+        const node = this.graph.getNode(nodeId);
+        if (!node)
+            return;
+        this.graph.setResolvedHandles(nodeId, handles);
+        const registry = this.registry; // Store for use in callback
+        this.graph.forEachEdge((e, _index) => {
+            // Only update edges that touch the changed node
+            const touchesChangedNode = e.source.nodeId === nodeId || e.target.nodeId === nodeId;
+            if (!touchesChangedNode)
+                return;
+            const srcNode = this.graph.getNode(e.source.nodeId);
+            const dstNode = this.graph.getNode(e.target.nodeId);
+            const oldDstDeclared = e.dstDeclared;
+            // Extract edge types using shared helper (handles both source and target updates)
+            const { srcDeclared, dstDeclared } = extractEdgeTypes(e.source.nodeId, e.source.handle, e.target.nodeId, e.target.handle, registry, this.graph);
+            // Update converters
+            const conv = buildEdgeConverters(srcDeclared, dstDeclared, registry, `updateNodeHandles: ${srcNode?.typeId || ""}.${e.source.nodeId}.${e.source.handle} -> ${dstNode?.typeId || ""}.${e.target.nodeId}.${e.target.handle}`);
+            // Update edge properties via Graph
+            this.graph.updateEdgeProperties(e.id, {
+                srcDeclared,
+                dstDeclared,
+                srcUnionTypes: Array.isArray(srcDeclared) ? [...srcDeclared] : undefined,
+                convert: conv.convert,
+                convertAsync: conv.convertAsync,
+            });
+            if (e.target.nodeId === nodeId && oldDstDeclared === undefined && dstDeclared !== undefined) {
+                const srcNode = this.graph.getNode(e.source.nodeId);
+                if (srcNode) {
+                    const srcValue = srcNode.outputs[e.source.handle];
+                    if (srcValue !== undefined) {
+                        const activeRunContextIds = this.graph.getNodeRunContextIds(e.source.nodeId);
+                        this.edgePropagator.propagate(e.source.nodeId, e.source.handle, srcValue, activeRunContextIds.size > 0 ? activeRunContextIds : undefined);
+                    }
+                }
+            }
+        });
+        this.edgePropagator.invalidateDownstream(nodeId);
+    }
+    /**
+     * Recompute dynamic handles for a single node using current inputs/environment
+     */
+    async recomputeHandlesForNode(nodeId, activeRunContextIds) {
+        try {
+            if (!this.registry)
+                return;
+            const node = this.graph.getNode(nodeId);
+            if (!node)
+                return;
+            const desc = this.registry.nodes.get(node.typeId);
+            if (!desc)
+                return;
+            const resolveHandles = desc.resolveHandles;
+            if (typeof resolveHandles !== "function")
+                return;
+            const token = (this.recomputeTokenByNode.get(nodeId) ?? 0) + 1;
+            this.recomputeTokenByNode.set(nodeId, token);
+            // Log resolveHandles-start
+            const nodeLogLevel = node.logLevel ?? "info";
+            const nodeLogValue = LOG_LEVEL_VALUES[nodeLogLevel] ?? 1;
+            const shouldLog = nodeLogValue <= LOG_LEVEL_VALUES.debug && nodeLogLevel !== "silent";
+            if (shouldLog) {
+                console.info(`[node:${formatNodeRef(this.graph, nodeId)}] resolveHandles-start`);
+            }
+            let resolved;
+            try {
+                const res = resolveHandles({
+                    nodeId,
+                    environment: this.environment || {},
+                    params: node.params,
+                    inputs: node.inputs || {},
+                });
+                resolved = await unwrapMaybePromise(res);
+            }
+            catch {
+                // Log resolveHandles-done even on error
+                if (shouldLog) {
+                    console.info(`[node:${formatNodeRef(this.graph, nodeId)}] resolveHandles-done (error)`);
+                }
+                return;
+            }
+            // Log resolveHandles-done
+            if (shouldLog) {
+                console.info(`[node:${formatNodeRef(this.graph, nodeId)}] resolveHandles-done`);
+            }
+            // If a newer recompute was scheduled, drop this result
+            if ((this.recomputeTokenByNode.get(nodeId) ?? 0) !== token)
+                return;
+            const before = this.graph.getResolvedHandles(nodeId);
+            // Re-fetch desc to ensure we have the latest (node might have been updated)
+            const nodeDesc = this.registry.nodes.get(node.typeId);
+            if (!nodeDesc)
+                return;
+            // Merge inputs properly, handling metadata
+            const inputs = {};
+            // First, add all static handles
+            if (nodeDesc.inputs) {
+                for (const [handle, staticDesc] of Object.entries(nodeDesc.inputs)) {
+                    inputs[handle] = staticDesc;
+                }
+            }
+            // Then, merge dynamic handles
+            if (resolved?.inputs) {
+                for (const [handle, dynamicDesc] of Object.entries(resolved.inputs)) {
+                    const staticDesc = nodeDesc.inputs?.[handle];
+                    const merged = mergeInputHandleDescriptors(staticDesc, dynamicDesc);
+                    if (merged) {
+                        inputs[handle] = merged;
+                    }
+                }
+            }
+            const outputs = { ...nodeDesc.outputs, ...resolved?.outputs };
+            const inputDefaults = {
+                ...nodeDesc.inputDefaults,
+                ...resolved?.inputDefaults,
+            };
+            const after = { inputs, outputs, inputDefaults };
+            // If we have prior handles, skip update when unchanged; for new nodes (no before),
+            // always write the resolved handles.
+            if (before && JSON.stringify(before) === JSON.stringify(after))
+                return;
+            // Call GraphRuntime's updateNodeHandles to update edges and re-propagate values
+            // Note: updateNodeHandles will set the resolved handles internally
+            this.updateNodeHandles(nodeId, after);
+            // Effective inputs = inputDefaults merged with node.inputs (scene-derived defaults + user overrides)
+            const inputDefaults = after.inputDefaults ?? {};
+            const nodeInputs = node.inputs ?? {};
+            const effectiveInputs = { ...inputDefaults, ...nodeInputs };
+            // Notify graph updated with the changed handles
+            this.eventEmitter.emit("invalidate", {
+                reason: "graph-updated",
+                resolvedHandles: { [nodeId]: after },
+                effectiveInputs: { [nodeId]: effectiveInputs },
+            });
+        }
+        finally {
+            // Track resolver finish after successful completion
+            if (activeRunContextIds && activeRunContextIds.size > 0) {
+                for (const runContextId of activeRunContextIds) {
+                    this.runContextManager.finishHandleResolution(runContextId, nodeId);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=HandleResolver.js.map

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

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

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

@@ -0,0 +1,116 @@
+import type { ExecutionContext } from "../../core/types";
+import type { RunContextId } from "./types";
+import type { Graph } from "./Graph";
+import type { EventEmitter } from "./EventEmitter";
+import type { RunContextManager } from "./RunContextManager";
+import { IEdgePropagator, INodeExecutor, IRuntime, IHandleResolver } from "./interfaces";
+/**
+ * NodeExecutor component - handles node execution scheduling and lifecycle
+ */
+export declare class NodeExecutor implements INodeExecutor {
+    private readonly graph;
+    private readonly eventEmitter;
+    private readonly runContextManager;
+    private readonly handleResolver;
+    private readonly edgePropagator;
+    private readonly runtime;
+    private environment;
+    private customNodeData;
+    constructor(graph: Graph, eventEmitter: EventEmitter, runContextManager: RunContextManager, handleResolver: IHandleResolver, edgePropagator: IEdgePropagator, runtime: IRuntime, environment?: Record<string, unknown>);
+    setEnvironment(environment: Record<string, unknown>): void;
+    setCustomNodeData(customNodeData: Record<string, Record<string, unknown>>): void;
+    /**
+     * Compute effective inputs for a node by merging real inputs with defaults
+     */
+    getEffectiveInputs(nodeId: string): Record<string, unknown>;
+    /**
+     * Create an execution context for a node
+     */
+    createExecutionContext(nodeId: string, inputs: Record<string, unknown>, runId: string, abortSignal: AbortSignal, runContextIds?: Set<RunContextId>, options?: {
+        emitHandler?: (handle: string, value: unknown) => void;
+        reportProgress?: (p: number) => void;
+    }): ExecutionContext<any>;
+    /**
+     * Internal method for executing inputs changed (also used by GraphRuntime)
+     */
+    execute(nodeId: string, opts?: {
+        runContextIds?: Set<RunContextId>;
+        canSkipHandleResolution?: boolean;
+        reason?: string;
+    }): void;
+    /**
+     * Check if execution should be debounced
+     */
+    private shouldDebounce;
+    /**
+     * Handle debounced scheduling by replacing the latest queued item
+     */
+    private handleDebouncedSchedule;
+    /**
+     * Prepare execution plan with all necessary information
+     */
+    private prepareExecutionPlan;
+    /**
+     * Route execution to appropriate concurrency handler
+     */
+    private routeToConcurrencyHandler;
+    /**
+     * Handle drop mode - drop execution if node is already running, otherwise start run
+     */
+    private handleDropMode;
+    /**
+     * Handle queue mode - add to queue and process sequentially
+     */
+    private handleQueueMode;
+    /**
+     * Process queued executions sequentially
+     */
+    private processQueue;
+    /**
+     * Start a node execution run
+     */
+    private startRun;
+    /**
+     * Track run-context start for pending nodes
+     */
+    private trackRunContextStart;
+    /**
+     * Decrement pendingQueued counters for plans' run-contexts.
+     * Used when queued work is being started, dropped, or cancelled.
+     */
+    private decrementQueuedForPlans;
+    /**
+     * Create execution controller and update node stats
+     */
+    private createExecutionController;
+    /**
+     * Apply concurrency mode (switch mode aborts other controllers)
+     */
+    private applyConcurrencyMode;
+    /**
+     * Setup timeout for execution if configured
+     */
+    private setupTimeout;
+    /**
+     * Create emit and progress handlers for execution context
+     */
+    private createEmitAndProgressHandlers;
+    /**
+     * Execute the node with retry logic and cleanup
+     */
+    private executeNode;
+    /**
+     * Cleanup after execution completes
+     */
+    private cleanupExecution;
+    /**
+     * Cancel all active runs for a node
+     */
+    cancelNodeActiveRuns(nodeId: string, reason: "snapshot" | "node-deleted" | "user-cancelled"): void;
+    /**
+     * Cancel runs for multiple nodes.
+     * Can be called for snapshot/undo/redo operations or user-initiated cancellation.
+     */
+    cancelNodeRuns(nodeIds: string[], reason?: "snapshot" | "user-cancelled"): void;
+}
+//# sourceMappingURL=NodeExecutor.d.ts.map

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

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