@bian-womp/spark-graph 0.3.46 → 0.3.48

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

@@ -0,0 +1,468 @@
+import { unwrapTypeId } from "../../core/type-utils";
+/**
+ * Graph component - manages nodes, edges, and handle resolution
+ * This is the ONLY place where nodes, edges, and resolvedByNode are directly updated.
+ */
+export class Graph {
+    constructor(eventEmitter, registry) {
+        this.eventEmitter = eventEmitter;
+        this.registry = registry;
+        this.nodes = new Map();
+        this.edges = [];
+        this.resolvedByNode = new Map();
+    }
+    // ==================== Node Accessors ====================
+    /**
+     * Get a node by ID (readonly to prevent accidental modifications)
+     */
+    getNode(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+    /**
+     * Get a node by ID (mutable, for internal use only)
+     * @internal
+     */
+    getNodeMutable(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+    /**
+     * Iterate over all nodes safely (readonly to prevent accidental modifications)
+     */
+    forEachNode(callback) {
+        for (const [nodeId, node] of this.nodes.entries()) {
+            callback(node, nodeId);
+        }
+    }
+    /**
+     * Get all node IDs
+     */
+    getNodeIds() {
+        return Array.from(this.nodes.keys());
+    }
+    /**
+     * Check if a node exists
+     */
+    hasNode(nodeId) {
+        return this.nodes.has(nodeId);
+    }
+    // ==================== Node Mutators ====================
+    /**
+     * Set a node (creates or replaces)
+     */
+    setNode(nodeId, node) {
+        this.nodes.set(nodeId, node);
+    }
+    /**
+     * Delete a node
+     */
+    deleteNode(nodeId) {
+        this.nodes.delete(nodeId);
+    }
+    // ==================== Node Property Updates ====================
+    /**
+     * Update node inputs
+     */
+    updateNodeInput(nodeId, handle, value, calculated = true) {
+        const node = this.getNodeMutable(nodeId);
+        if (!node)
+            return;
+        if (value === undefined) {
+            delete node.inputs[handle];
+        }
+        else {
+            node.inputs[handle] = value;
+        }
+        if (calculated) {
+            this.updateNodeLastInputAt(nodeId, handle, Date.now());
+        }
+        this.eventEmitter.emit("value", {
+            nodeId,
+            handle,
+            value,
+            io: "input",
+            runtimeTypeId: unwrapTypeId(value),
+        });
+    }
+    /**
+     * Update node outputs
+     */
+    updateNodeOutput(nodeId, handle, value) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        if (value === undefined) {
+            delete node.outputs[handle];
+        }
+        else {
+            node.outputs[handle] = value;
+        }
+        this.eventEmitter.emit("value", {
+            nodeId,
+            handle,
+            value,
+            io: "output",
+            runtimeTypeId: unwrapTypeId(value),
+        });
+    }
+    /**
+     * Update node state
+     */
+    updateNodeState(nodeId, updates) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        Object.assign(node.state, updates);
+    }
+    /**
+     * Update node params
+     */
+    updateNodeParams(nodeId, params) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.params = params;
+    }
+    /**
+     * Update node policy
+     */
+    updateNodePolicy(nodeId, policy) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.policy = { ...node.policy, ...policy };
+    }
+    /**
+     * Update node stats
+     */
+    updateNodeStats(nodeId, updates) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        Object.assign(node.stats, updates);
+    }
+    /**
+     * Increment node runSeq
+     */
+    incrementNodeRunSeq(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return 0;
+        node.runSeq += 1;
+        return node.runSeq;
+    }
+    /**
+     * Set node latestRunId
+     */
+    setNodeLatestRunId(nodeId, runId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.latestRunId = runId;
+    }
+    /**
+     * Set node lastScheduledAt
+     */
+    setNodeLastScheduledAt(nodeId, timestamp) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.lastScheduledAt = timestamp;
+    }
+    /**
+     * Update node lastInputAt timestamp for a handle
+     */
+    updateNodeLastInputAt(nodeId, handle, timestamp) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        if (!node.lastInputAt)
+            node.lastInputAt = {};
+        node.lastInputAt[handle] = timestamp;
+    }
+    /**
+     * Set node lastSuccessAt timestamp
+     */
+    setNodeLastSuccessAt(nodeId, timestamp) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.lastSuccessAt = timestamp;
+    }
+    // ==================== Node Queue Operations ====================
+    /**
+     * Add item to node queue
+     */
+    addToNodeQueue(nodeId, item) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.queue.push(item);
+    }
+    /**
+     * Remove first item from node queue
+     */
+    shiftNodeQueue(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return undefined;
+        return node.queue.shift();
+    }
+    /**
+     * Clear node queue
+     */
+    clearNodeQueue(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.queue = [];
+    }
+    /**
+     * Replace node queue
+     */
+    replaceNodeQueue(nodeId, items) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.queue = items;
+    }
+    // ==================== Node Controller Operations ====================
+    /**
+     * Add controller to node
+     */
+    addNodeController(nodeId, controller, runId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.activeControllers.add(controller);
+        node.controllerRunIds.set(controller, runId);
+    }
+    /**
+     * Remove controller from node
+     */
+    removeNodeController(nodeId, controller) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.activeControllers.delete(controller);
+        node.controllerRunIds.delete(controller);
+    }
+    /**
+     * Clear all controllers from node
+     */
+    clearNodeControllers(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.activeControllers.clear();
+        node.controllerRunIds.clear();
+    }
+    /**
+     * Get all controllers for a node
+     */
+    getNodeControllers(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return new Set();
+        return new Set(node.activeControllers);
+    }
+    // ==================== Node Run Context Operations ====================
+    /**
+     * Add run context ID to node
+     */
+    addNodeRunContextId(nodeId, runContextId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.activeRunContextIds.add(runContextId);
+    }
+    /**
+     * Add multiple run context IDs to node
+     */
+    addNodeRunContextIds(nodeId, runContextIds) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        for (const id of runContextIds) {
+            node.activeRunContextIds.add(id);
+        }
+    }
+    /**
+     * Remove run context ID from node
+     */
+    removeNodeRunContextId(nodeId, runContextId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.activeRunContextIds.delete(runContextId);
+    }
+    /**
+     * Clear all run context IDs from node
+     */
+    clearNodeRunContextIds(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        node.activeRunContextIds.clear();
+    }
+    /**
+     * Get run context IDs for a node
+     */
+    getNodeRunContextIds(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return new Set();
+        return new Set(node.activeRunContextIds);
+    }
+    // ==================== Node Snapshot Cancelled Run IDs ====================
+    /**
+     * Add snapshot cancelled run ID to node
+     */
+    addSnapshotCancelledRunId(nodeId, runId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return;
+        if (!node.snapshotCancelledRunIds) {
+            node.snapshotCancelledRunIds = new Set();
+        }
+        node.snapshotCancelledRunIds.add(runId);
+    }
+    // ==================== Edge Accessors ====================
+    /**
+     * Iterate over all edges safely
+     */
+    forEachEdge(callback) {
+        this.edges.forEach(callback);
+    }
+    /**
+     * Find edges matching a predicate
+     */
+    findEdges(predicate) {
+        return this.edges.filter(predicate);
+    }
+    /**
+     * Get edges by source node and handle
+     */
+    getEdgesBySource(srcNodeId, srcHandle) {
+        return this.edges.filter((e) => e.source.nodeId === srcNodeId && e.source.handle === srcHandle);
+    }
+    /**
+     * Get edges by target node and handle
+     */
+    getEdgesByTarget(targetNodeId, targetHandle) {
+        return this.edges.filter((e) => e.target.nodeId === targetNodeId && e.target.handle === targetHandle);
+    }
+    /**
+     * Get inbound edges for a node
+     */
+    getInboundEdges(nodeId) {
+        return this.edges.filter((e) => e.target.nodeId === nodeId);
+    }
+    /**
+     * Get outbound edges for a node
+     */
+    getOutboundEdges(nodeId) {
+        return this.edges.filter((e) => e.source.nodeId === nodeId);
+    }
+    // ==================== Edge Mutators ====================
+    /**
+     * Set all edges (replaces existing)
+     */
+    setEdges(edges) {
+        this.edges = [...edges];
+    }
+    /**
+     * Update an edge by ID
+     */
+    updateEdge(edgeId, updates) {
+        const edge = this.edges.find((e) => e.id === edgeId);
+        if (!edge)
+            return;
+        Object.assign(edge, updates);
+    }
+    /**
+     * Update edge properties (convert, convertAsync, types, etc.)
+     */
+    updateEdgeProperties(edgeId, updates) {
+        const edge = this.edges.find((e) => e.id === edgeId);
+        if (!edge)
+            return;
+        if (updates.dstDeclared !== undefined) {
+            edge.dstDeclared = updates.dstDeclared;
+        }
+        if (updates.srcUnionTypes !== undefined) {
+            edge.srcUnionTypes = updates.srcUnionTypes;
+        }
+        if (updates.convert !== undefined) {
+            edge.convert = updates.convert;
+        }
+        if (updates.convertAsync !== undefined) {
+            edge.convertAsync = updates.convertAsync;
+        }
+    }
+    /**
+     * Update edge stats
+     */
+    updateEdgeStats(edgeId, updates) {
+        const edge = this.edges.find((e) => e.id === edgeId);
+        if (!edge)
+            return;
+        Object.assign(edge.stats, updates);
+    }
+    /**
+     * Get edge by ID
+     */
+    getEdge(edgeId) {
+        return this.edges.find((e) => e.id === edgeId);
+    }
+    // ==================== Registry Accessors ====================
+    getRegistry() {
+        return this.registry;
+    }
+    setRegistry(registry) {
+        this.registry = registry;
+    }
+    // ==================== Resolved Handles Accessors ====================
+    getResolvedHandles(nodeId) {
+        return this.resolvedByNode.get(nodeId);
+    }
+    setResolvedHandles(nodeId, handles) {
+        this.resolvedByNode.set(nodeId, handles);
+    }
+    /**
+     * Iterate over resolved handles safely
+     */
+    forEachResolvedHandles(callback) {
+        for (const [nodeId, handles] of this.resolvedByNode.entries()) {
+            callback(handles, nodeId);
+        }
+    }
+    // ==================== Utility Methods ====================
+    /**
+     * Check if all inbound edges for a node have values
+     */
+    allInboundHaveValue(nodeId) {
+        const node = this.nodes.get(nodeId);
+        if (!node)
+            return false;
+        const inbound = this.edges.filter((e) => e.target.nodeId === nodeId);
+        if (inbound.length === 0)
+            return true;
+        for (const e of inbound) {
+            if (node.resolvedHandles?.inputs?.[e.target.handle] &&
+                !node.inputs[e.target.handle]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // ==================== Clear Operations ====================
+    /**
+     * Clear all data
+     */
+    clear() {
+        this.nodes.clear();
+        this.edges = [];
+        this.resolvedByNode.clear();
+    }
+}
+//# sourceMappingURL=Graph.js.map

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

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

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

@@ -0,0 +1,36 @@
+import { Registry } from "../../builder/Registry";
+import type { EventEmitter } from "./EventEmitter";
+import type { Graph } from "./Graph";
+import type { RunContextManager } from "./RunContextManager";
+import type { IEdgePropagator, IHandleResolver } from "./interfaces";
+/**
+ * HandleResolver component - manages dynamic handle resolution
+ */
+export declare class HandleResolver implements IHandleResolver {
+    private readonly graph;
+    private readonly eventEmitter;
+    private readonly runContextManager;
+    private readonly edgePropagator;
+    private registry?;
+    private recomputeTokenByNode;
+    private environment;
+    private pendingResolutions;
+    private isRecomputing;
+    constructor(graph: Graph, eventEmitter: EventEmitter, runContextManager: RunContextManager, edgePropagator: IEdgePropagator, registry?: Registry | undefined, environment?: Record<string, unknown>);
+    setRegistry(registry: Registry): void;
+    setEnvironment(environment: Record<string, unknown>): void;
+    /**
+     * Get the promise for pending handle resolution, or null if none
+     */
+    getPendingResolution(nodeId: string): Promise<void> | null;
+    /**
+     * Schedule async recomputation of handles for a node
+     */
+    scheduleRecomputeHandles(nodeId: string): void;
+    private updateNodeHandles;
+    /**
+     * Recompute dynamic handles for a single node using current inputs/environment
+     */
+    private recomputeHandlesForNode;
+}
+//# sourceMappingURL=HandleResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HandleResolver.d.ts","sourceRoot":"","sources":["../../../../src/runtime/components/HandleResolver.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKrE;;GAEG;AACH,qBAAa,cAAe,YAAW,eAAe;IAOlD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC;IAVnB,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,kBAAkB,CAAoC;IAC9D,OAAO,CAAC,aAAa,CAA8B;gBAGhC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,EAAE,eAAe,EACxC,QAAQ,CAAC,EAAE,QAAQ,YAAA,EAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKvC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIrC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI1D;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI1D;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAqD9C,OAAO,CAAC,iBAAiB;IA6EzB;;OAEG;YACW,uBAAuB;CAyGtC"}