@bian-womp/spark-graph 0.3.88 → 0.3.90

package/lib/src/misc/utils/test-logger-output.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env tsx
+/**
+ * Simple test script to see LevelLogger output for different logFormat options
+ * Run with: yarn test-logger
+ */
+import { LevelLogger } from "./LevelLogger";
+console.log("=== Testing LevelLogger with different logFormat options ===\n");
+const logger = new LevelLogger("info");
+// Test data
+const testData = {
+    object: { key: "value", nested: { foo: "bar" } },
+    jsonString: '{"parsed": true, "nested": {"deep": "value"}}',
+    arrayString: '["apple", "banana", "cherry"]',
+    partialJson: 'Some text {"key": "value"} more text',
+    realWorld: ['{"parsed": true, "nested": {"deep": "value"}}'],
+    number: 42,
+    boolean: true,
+};
+console.log("1. logFormat: 'plain' (default)");
+console.log("─────────────────────────────────────────");
+logger.info("Test message", {
+    ...testData,
+});
+console.log("\n");
+console.log("2. logFormat: 'json' (format JSON only, don't parse strings)");
+console.log("─────────────────────────────────────────");
+logger.info("Test message", {
+    ...testData,
+    logFormat: "json",
+});
+console.log("\n");
+console.log("3. logFormat: 'json-deep' (format JSON and parse strings as JSON)");
+console.log("─────────────────────────────────────────");
+logger.info("Test message", {
+    ...testData,
+    logFormat: "json-deep",
+});
+console.log("\n");
+console.log("4. Message with JSON (never parsed, always output as-is)");
+console.log("─────────────────────────────────────────");
+logger.info('{"message": "test", "value": 123}', { logFormat: "json-deep" });
+console.log("\n");
+console.log("5. Message with partial JSON (never parsed, always output as-is)");
+console.log("─────────────────────────────────────────");
+logger.info('Some text {"key": "value"} more text');
+console.log("\n");
+console.log("=== All tests completed ===");
+//# sourceMappingURL=test-logger-output.js.map

package/lib/src/misc/utils/test-logger-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-logger-output.js","sourceRoot":"","sources":["../../../../src/misc/utils/test-logger-output.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;AAE9E,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;AAEvC,YAAY;AACZ,MAAM,QAAQ,GAAG;IACf,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IAChD,UAAU,EAAE,+CAA+C;IAC3D,WAAW,EAAE,+BAA+B;IAC5C,WAAW,EAAE,sCAAsC;IACnD,SAAS,EAAE,CAAC,+CAA+C,CAAC;IAC5D,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAC/C,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AACzD,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;IAC1B,GAAG,QAAQ;CACZ,CAAC,CAAC;AACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAElB,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;AAC5E,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AACzD,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;IAC1B,GAAG,QAAQ;IACX,SAAS,EAAE,MAAM;CAClB,CAAC,CAAC;AACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAElB,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;AACjF,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AACzD,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;IAC1B,GAAG,QAAQ;IACX,SAAS,EAAE,WAAW;CACvB,CAAC,CAAC;AACH,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAElB,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;AACxE,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AACzD,MAAM,CAAC,IAAI,CAAC,mCAAmC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;AAC7E,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAElB,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;AAChF,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;AACzD,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;AACpD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAElB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC"}

package/lib/src/plugins/composite.d.ts

@@ -0,0 +1,22 @@
+import type { GraphDefinition } from "@bian-womp/spark-protocol";
+import type { NodeCategoryDescriptor } from "../core/categories";
+import { Registry } from "../builder/Registry";
+import { GraphRuntime } from "../runtime/GraphRuntime";
+export interface CompositeImpl {
+    def: GraphDefinition;
+    exposure: {
+        inputs: Record<string, {
+            nodeId: string;
+            handle: string;
+        }>;
+        outputs: Record<string, {
+            nodeId: string;
+            handle: string;
+        }>;
+    };
+}
+export declare const CompositeCategory: (registry: Registry) => NodeCategoryDescriptor<CompositeImpl, {
+    inner?: GraphRuntime;
+    unsub?: () => void;
+}>;
+//# sourceMappingURL=composite.d.ts.map

package/lib/src/plugins/composite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite.d.ts","sourceRoot":"","sources":["../../../src/plugins/composite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,eAAe,CAAC;IACrB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC7D,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,GAC5B,UAAU,QAAQ,KACjB,sBAAsB,CAAC,aAAa,EAAE;IAAE,KAAK,CAAC,EAAE,YAAY,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAmDnF,CAAC"}

package/lib/src/plugins/composite.js

@@ -0,0 +1,59 @@
+import { GraphRuntime } from "../runtime/GraphRuntime";
+export const CompositeCategory = (registry) => ({
+    id: "composite",
+    displayName: "Composite",
+    validateImpl: (impl) => {
+        if (!impl || !impl.def)
+            throw new Error("Composite impl requires def");
+    },
+    createRuntime: ({ impl }) => {
+        let inner;
+        let unsub;
+        return {
+            onActivated: () => {
+                inner = GraphRuntime.create(impl.def, registry);
+                // Wire inner outputs to outer emits
+                unsub = inner.on("value", (e) => {
+                    for (const [outHandle, map] of Object.entries(impl.exposure.outputs)) {
+                        if (e.nodeId === map.nodeId && e.handle === map.handle) {
+                            // We cannot access outer ctx here; emit will occur on next input change cycle
+                            // Instead, we cache outputs and pull them during onInputsChanged
+                        }
+                    }
+                });
+                inner.launch();
+            },
+            onInputsChanged: (inputs, ctx) => {
+                if (!inner)
+                    return;
+                // map outer inputs => batch per inner node to avoid extra runs
+                const grouped = {};
+                for (const [inHandle, map] of Object.entries(impl.exposure.inputs)) {
+                    if (inHandle in inputs) {
+                        const nodeMap = (grouped[map.nodeId] = grouped[map.nodeId] || {});
+                        nodeMap[map.handle] = inputs[inHandle];
+                    }
+                }
+                for (const [nodeId, map] of Object.entries(grouped)) {
+                    inner.setInputs(nodeId, map);
+                }
+                // pull inner exposed outputs and emit
+                for (const [outHandle, map] of Object.entries(impl.exposure.outputs)) {
+                    const v = inner.getOutput(map.nodeId, map.handle);
+                    if (v !== undefined)
+                        ctx.emit(outHandle, v);
+                }
+            },
+            onDeactivated: () => {
+                if (unsub)
+                    unsub();
+            },
+            dispose: () => {
+                if (unsub)
+                    unsub();
+                inner?.dispose();
+            },
+        };
+    },
+});
+//# sourceMappingURL=composite.js.map

package/lib/src/plugins/composite.js.map

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

package/lib/src/plugins/compute.d.ts

@@ -0,0 +1,5 @@
+import type { NodeCategoryDescriptor } from "../core/categories";
+import type { ExecutionContext } from "../core/types";
+export type ComputeImpl = (inputs: Record<string, unknown>, ctx: ExecutionContext<any>) => void | Record<string, unknown> | Promise<void | Record<string, unknown>>;
+export declare const ComputeCategory: NodeCategoryDescriptor<ComputeImpl, any>;
+//# sourceMappingURL=compute.d.ts.map

package/lib/src/plugins/compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../../../src/plugins/compute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC,KACvB,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9E,eAAO,MAAM,eAAe,EAAE,sBAAsB,CAAC,WAAW,EAAE,GAAG,CAgCpE,CAAC"}

package/lib/src/plugins/compute.js

@@ -0,0 +1,39 @@
+export const ComputeCategory = {
+    id: "compute",
+    displayName: "Compute",
+    createRuntime: ({ impl }) => ({
+        async onInputsChanged(inputs, ctx) {
+            const out = await impl(inputs, ctx);
+            if (out && typeof out === "object") {
+                for (const [h, v] of Object.entries(out))
+                    ctx.emit(h, v);
+            }
+        },
+        onExternalEvent(event, state) {
+            try {
+                const e = event;
+                // Preferred: call a function on state keyed by e.action
+                const action = e?.action;
+                if (action && typeof state?.[action] === "function") {
+                    const fn = state[action];
+                    // Normalize args: prefer explicit args array, else wrap single value;
+                    let args = [];
+                    if (Array.isArray(e?.args))
+                        args = [...e.args];
+                    else if (e?.args !== undefined)
+                        args = [e.args];
+                    else if (e?.params !== undefined)
+                        args = [e.params];
+                    void fn(...args);
+                    return;
+                }
+                console.warn("Unsupported external event", JSON.stringify(event));
+            }
+            catch {
+                console.warn("Error handling external event", JSON.stringify(event));
+            }
+        },
+    }),
+    policy: { asyncConcurrency: "switch" },
+};
+//# sourceMappingURL=compute.js.map

package/lib/src/plugins/compute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.js","sourceRoot":"","sources":["../../../src/plugins/compute.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,eAAe,GAA6C;IACvE,EAAE,EAAE,SAAS;IACb,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG;YAC/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACpC,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACnC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QACD,eAAe,CAAC,KAAK,EAAE,KAAK;YAC1B,IAAI,CAAC;gBACH,MAAM,CAAC,GAAQ,KAAK,CAAC;gBACrB,wDAAwD;gBACxD,MAAM,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC;gBACzB,IAAI,MAAM,IAAI,OAAO,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;oBACpD,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAA4B,CAAC;oBACpD,sEAAsE;oBACtE,IAAI,IAAI,GAAU,EAAE,CAAC;oBACrB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC;wBAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;yBAC1C,IAAI,CAAC,EAAE,IAAI,KAAK,SAAS;wBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;yBAC3C,IAAI,CAAC,EAAE,MAAM,KAAK,SAAS;wBAAE,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBACpD,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;oBACjB,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACpE,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;KACF,CAAC;IACF,MAAM,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE;CACvC,CAAC"}

package/lib/src/runtime/Engine.d.ts

@@ -0,0 +1,26 @@
+import type { RunMode } from "@bian-womp/spark-protocol";
+import type { RuntimeEventName, RuntimeEventListener, RuntimeEventMap } from "./GraphRuntime";
+export type EngineEventName = RuntimeEventName;
+export type EngineEventListener<K extends EngineEventName> = RuntimeEventListener<K>;
+export type EngineEventMap = RuntimeEventMap;
+export interface Engine {
+    launch(): void;
+    setInputs(nodeId: string, inputs: Record<string, unknown>, options?: {
+        dry?: boolean;
+    }): void;
+    triggerExternal(nodeId: string, event: unknown, options?: {
+        dry?: boolean;
+    }): void;
+    setRunMode(runMode: RunMode): void;
+    on<K extends EngineEventName>(event: K, handler: EngineEventListener<K>): () => void;
+    getOutput(nodeId: string, output: string): unknown;
+    whenIdle(): Promise<void>;
+    runFromHere(nodeId: string): Promise<void>;
+    computeNode(nodeId: string): Promise<void>;
+    cancelNodeRuns(nodeIds: string[]): void | Promise<void>;
+    copyOutputs(fromNodeId: string, toNodeId: string, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=Engine.d.ts.map

package/lib/src/runtime/Engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../../src/runtime/Engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9F,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAC/C,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACrF,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAC7C,MAAM,WAAW,MAAM;IACrB,MAAM,IAAI,IAAI,CAAC;IACf,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9F,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACnF,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,EAAE,CAAC,CAAC,SAAS,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IACrF,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrG,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/lib/src/runtime/Engine.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Engine.js.map

package/lib/src/runtime/Engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Engine.js","sourceRoot":"","sources":["../../../src/runtime/Engine.ts"],"names":[],"mappings":""}

package/lib/src/runtime/GraphLifecycleApi.d.ts

@@ -0,0 +1,46 @@
+import type { GraphDefinition, RegistryDescriptor, RegistryDelta, RuntimeSnapshot, RuntimeSnapshotFull, RunnerOptions, RuntimeHistoryInfo, Viewport, ConverterConfig } from "@bian-womp/spark-protocol";
+/**
+ * GraphLifecycleApi interface for non-execution operations.
+ * These operations manage graph lifecycle, snapshots, registry, environment, etc.
+ * Execution operations are handled by the Engine interface.
+ *
+ * This interface can be implemented by both local and remote graph runtimes.
+ */
+export interface GraphLifecycleApi {
+    build(def: GraphDefinition, opts?: {
+        environment?: Record<string, unknown>;
+        startPaused?: boolean;
+    }): Promise<void>;
+    update(def: GraphDefinition, options?: {
+        dry?: boolean;
+    }): Promise<void>;
+    launch(opts?: RunnerOptions): Promise<void>;
+    snapshot(): Promise<RuntimeSnapshot>;
+    snapshotFull(): Promise<RuntimeSnapshotFull>;
+    applySnapshotFull(payload: RuntimeSnapshotFull, options?: {
+        skipBuild?: boolean;
+    }): Promise<void>;
+    convertSnapshot(converterConfig: ConverterConfig, options?: {
+        dry?: boolean;
+    }): Promise<RuntimeSnapshotFull>;
+    describeRegistry(): Promise<RegistryDescriptor>;
+    applyRegistry(deltas: RegistryDelta[]): Promise<void>;
+    setEnvironment(environment: Record<string, unknown>, opts?: {
+        merge?: boolean;
+        dry?: boolean;
+    }): Promise<void>;
+    getEnvironment(): Promise<Record<string, unknown>>;
+    coerce(from: string, to: string, value: unknown): Promise<unknown>;
+    setExtData(data: Record<string, unknown>): Promise<void>;
+    updateExtData(updates: Array<{
+        path: string;
+        value: unknown;
+    }>): Promise<boolean>;
+    setViewport(viewport: Viewport): Promise<void>;
+    commit(reason?: string): Promise<RuntimeHistoryInfo | undefined>;
+    undo(): Promise<boolean>;
+    redo(): Promise<boolean>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+}
+//# sourceMappingURL=GraphLifecycleApi.d.ts.map

package/lib/src/runtime/GraphLifecycleApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphLifecycleApi.d.ts","sourceRoot":"","sources":["../../../src/runtime/GraphLifecycleApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,QAAQ,EACR,eAAe,EAChB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAEhC,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpH,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5C,QAAQ,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACrC,YAAY,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7C,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClG,eAAe,CAAC,eAAe,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAG7G,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGtD,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/G,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAGnD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGnE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlF,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG/C,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IACjE,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAGzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/lib/src/runtime/GraphLifecycleApi.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GraphLifecycleApi.js.map

package/lib/src/runtime/GraphLifecycleApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphLifecycleApi.js","sourceRoot":"","sources":["../../../src/runtime/GraphLifecycleApi.ts"],"names":[],"mappings":""}

package/lib/src/runtime/GraphRuntime.d.ts

@@ -0,0 +1,111 @@
+import type { RuntimeValue, RuntimeInvalidate, RuntimeError, RuntimeStats, GraphDefinition, RunMode } from "@bian-womp/spark-protocol";
+import type { NodeDisposeReason, RuntimeNodeStats } from "../core/types";
+import { Registry } from "../builder/Registry";
+import type { INodeExecutor, IRuntime, IEdgePropagator, RuntimeValidator, RuntimeValidationError } from "./components/interfaces";
+import type { RunContextId, RuntimeEdge } from "./components/types";
+export type RuntimeEventListener<K extends RuntimeEventName> = (e: RuntimeEventMap[K]) => void;
+export type RuntimeEventName = "value" | "invalidate" | "error" | "stats";
+export interface RuntimeEventMap {
+    value: RuntimeValue;
+    invalidate: RuntimeInvalidate;
+    error: RuntimeError;
+    stats: RuntimeStats;
+}
+export declare class GraphRuntime implements IRuntime, INodeExecutor, IEdgePropagator {
+    private graph;
+    private eventEmitter;
+    private runContextManager;
+    private handleResolver;
+    private edgePropagator;
+    private nodeExecutor;
+    private runtimeValidatorManager;
+    private environment;
+    private customNodeData;
+    private runMode;
+    private pauseRefCount;
+    private persistentPauseToken;
+    private handleResolvingSkippedRef;
+    private deferredAutoRunNodeIds;
+    constructor();
+    static create(def: GraphDefinition, registry: Registry, opts?: {
+        environment?: Record<string, unknown>;
+        startPaused?: boolean;
+    }): GraphRuntime;
+    on<K extends RuntimeEventName>(event: K, handler: RuntimeEventListener<K>): () => void;
+    /**
+     * Check if an event is an invalidate event that should trigger re-execution
+     */
+    private isInvalidateEvent;
+    private withRunContext;
+    private withManualNoPropagateContext;
+    private executeNodeAutoRun;
+    private flushDeferredAutoRunNodes;
+    setInputs(nodeId: string, inputs: Record<string, unknown>): void;
+    getOutput(nodeId: string, output: string): unknown;
+    launch(invalidate?: boolean, startPaused?: boolean): void;
+    triggerExternal(nodeId: string, event: unknown): void;
+    cancelNodeRuns(nodeIds: string[]): void;
+    getNodeIds(): string[];
+    getNodeData(nodeId: string): {
+        inputs: Record<string, unknown>;
+        outputs: Record<string, unknown>;
+        state: unknown;
+        params?: Record<string, unknown>;
+        stats?: RuntimeNodeStats;
+    } | undefined;
+    /**
+     * Returns effective inputs for a node: inputDefaults merged with node.inputs.
+     * Used by snapshot to include scene-derived defaults (e.g. geo:* params).
+     */
+    getEffectiveInputs(nodeId: string): Record<string, unknown>;
+    getEnvironment(): Record<string, unknown>;
+    setEnvironment(env: Record<string, unknown>): void;
+    setCustomNodeData(customNodeData: Record<string, Record<string, unknown>>): void;
+    getCustomNodeData(): Record<string, Record<string, unknown>>;
+    /**
+     * Register a runtime validator that will be called before node execution.
+     * Validators are called in registration order - if any returns true, execution is blocked.
+     */
+    registerRuntimeValidator(validator: RuntimeValidator): void;
+    /**
+     * Unregister a runtime validator.
+     */
+    unregisterRuntimeValidator(validator: RuntimeValidator): void;
+    /**
+     * Check if any runtime validator blocks execution for this node.
+     * Returns RuntimeValidationError if execution should be blocked, null otherwise.
+     */
+    hasRuntimeValidationBlock(nodeId: string): RuntimeValidationError | null;
+    getGraphDef(): GraphDefinition;
+    whenIdle(): Promise<void>;
+    runFromHereContext(startNodeId: string, opts?: {
+        propagate?: boolean;
+        reason?: string;
+    }): Promise<void>;
+    setRunMode(runMode: RunMode): void;
+    getRunMode(): RunMode | null;
+    requestPause(): () => void;
+    isPaused(): boolean;
+    pause(): void;
+    resume(): void;
+    setTargetInput(edge: RuntimeEdge, value: unknown, reason: string): void;
+    copyOutputs(fromNodeId: string, toNodeId: string, options?: {
+        dry?: boolean;
+    }): void;
+    hydrate(payload: {
+        inputs?: Record<string, Record<string, unknown>>;
+        outputs?: Record<string, Record<string, unknown>>;
+    }, opts?: {
+        invalidate?: boolean;
+    }): void;
+    update(def: GraphDefinition, registry: Registry): void;
+    dispose(reason?: NodeDisposeReason): void;
+    execute(nodeId: string, opts?: {
+        runContextIds?: Set<RunContextId>;
+        canSkipHandleResolution?: boolean;
+        reason?: string;
+    }): void;
+    propagate(srcNodeId: string, srcHandle: string, value: unknown, runContextIds?: Set<RunContextId>): void;
+    invalidateDownstream(nodeId: string): void;
+}
+//# sourceMappingURL=GraphRuntime.d.ts.map

package/lib/src/runtime/GraphRuntime.d.ts.map

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