@bian-womp/spark-graph 0.3.4 → 0.3.6

package/lib/cjs/index.cjs

@@ -1560,9 +1560,20 @@ class NodeExecutor {
             console.warn("NodeExecutor.execute: no runMode, skipping execution");
             return;
         }
+        // In manual mode, require runContextIds unless autoRun policy is set
         if (runMode === "manual" && (!runContextIds || runContextIds.size === 0)) {
-            console.warn("NodeExecutor.execute: no runContextIds provided in manual mode, skipping execution");
-            return;
+            // If autoRun is true, auto-generate a run context (similar to createExecutionContext pattern)
+            if (node.policy?.autoRun === true) {
+                runContextIds = new Set([
+                    this.runContextManager.createRunContext(nodeId, () => { }, {
+                        propagate: false,
+                    }),
+                ]);
+            }
+            else {
+                console.warn("NodeExecutor.execute: no runContextIds provided in manual mode, skipping execution");
+                return;
+            }
         }
         if (runMode === "auto" && runContextIds && runContextIds.size > 0) {
             console.warn("NodeExecutor.execute: runContextIds provided in auto mode, ignoring");
@@ -2109,9 +2120,12 @@ class GraphRuntime {
             }
         }
         // In auto mode, input updates can trigger execution; in manual mode they never should.
+        // However, if autoRun policy is set, nodes run automatically even in manual mode.
         if (anyChanged) {
             this.handleResolver.scheduleRecomputeHandles(nodeId);
-            if (this.runMode === "auto" && this.graph.allInboundHaveValue(nodeId)) {
+            const node = this.graph.getNode(nodeId);
+            const shouldAutoRun = this.runMode === "auto" || node?.policy?.autoRun === true;
+            if (shouldAutoRun && this.graph.allInboundHaveValue(nodeId)) {
                 this.execute(nodeId);
             }
         }
@@ -2385,6 +2399,14 @@ class GraphRuntime {
                 }
                 else {
                     existing.params = n.params;
+                    // Re-merge policy when params change (params.policy can override descriptor/category policy)
+                    const desc = registry.nodes.get(existing.typeId);
+                    const cat = registry.categories.get(desc?.categoryId ?? "");
+                    existing.policy = {
+                        ...cat?.policy,
+                        ...desc?.policy,
+                        ...n.params?.policy,
+                    };
                     if (!existing.stats) {
                         existing.stats = {
                             runs: 0,
@@ -3242,6 +3264,7 @@ function setupBasicGraphRegistry(id) {
         categoryId: "compute",
         inputs: { Value: "base.float" },
         outputs: { Result: "base.float" },
+        policy: { autoRun: true },
         impl: (ins) => ({ Result: Number(ins.Value) }),
     });
     registry.registerNode({
@@ -3249,6 +3272,7 @@ function setupBasicGraphRegistry(id) {
         categoryId: "compute",
         inputs: { Value: "base.string" },
         outputs: { Result: "base.string" },
+        policy: { autoRun: true },
         impl: (ins) => ({ Result: String(ins.Value) }),
     });
     registry.registerNode({
@@ -3256,6 +3280,7 @@ function setupBasicGraphRegistry(id) {
         categoryId: "compute",
         inputs: { Value: "base.bool" },
         outputs: { Result: "base.bool" },
+        policy: { autoRun: true },
         impl: (ins) => ({ Result: Boolean(ins.Value) }),
     });
     registry.registerNode({
@@ -3263,6 +3288,7 @@ function setupBasicGraphRegistry(id) {
         categoryId: "compute",
         inputs: { Value: "base.object" },
         outputs: { Result: "base.object" },
+        policy: { autoRun: true },
         impl: (ins) => ({ Result: ins.Value }),
     });
     registry.registerNode({
@@ -3270,6 +3296,7 @@ function setupBasicGraphRegistry(id) {
         categoryId: "compute",
         inputs: { Value: "base.vec3" },
         outputs: { Result: "base.vec3" },
+        policy: { autoRun: true },
         impl: (ins) => ({ Result: ins.Value }),
     });
     // JSON parser node: base.stringToObject