@bian-womp/spark-graph 0.3.45 → 0.3.47

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,28 @@
+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, options?: {
+        skipPropagateValues?: boolean;
+    }): 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,EACV,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EAChB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAC/C,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,eAAe,IACvD,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAC1B,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAC7C,MAAM,WAAW,MAAM;IACrB,MAAM,IAAI,IAAI,CAAC;IACf,SAAS,CACP,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,IAAI,CAAC;IACR,eAAe,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,IAAI,CAAC;IACR,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,EAAE,CAAC,CAAC,SAAS,eAAe,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,MAAM,IAAI,CAAC;IACd,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,CACT,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,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<void>;
+    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,CACH,GAAG,EAAE,eAAe,EACpB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACtE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,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,CACf,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAChC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,eAAe,CACb,eAAe,EAAE,eAAe,EAChC,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAGhC,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGtD,cAAc,CACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,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,CACX,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjB,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,94 @@
+import type { RuntimeValue, RuntimeInvalidate, RuntimeError, RuntimeStats, GraphDefinition, RunMode } from "@bian-womp/spark-protocol";
+import type { RuntimeNodeStats } from "../core/types";
+import { Registry } from "../builder/Registry";
+import type { INodeExecutor, IRuntime, IEdgePropagator, RuntimeValidator, RuntimeValidationError } from "./components/interfaces";
+import type { RunContextId } 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 runMode;
+    private pauseRefCount;
+    private persistentPauseToken;
+    private handleResolvingSkippedRef;
+    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;
+    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;
+    /**
+     * Check if an event is an invalidate event that should trigger re-execution
+     */
+    private isInvalidateEvent;
+    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;
+    getEnvironment(): Record<string, unknown>;
+    setEnvironment(env: Record<string, unknown>): void;
+    /**
+     * 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, options?: {
+        skipPropagateValues?: boolean;
+        propagate?: boolean;
+    }): Promise<void>;
+    setRunMode(runMode: RunMode): void;
+    getRunMode(): RunMode | null;
+    requestPause(): () => void;
+    isPaused(): boolean;
+    pause(): void;
+    resume(): void;
+    private executeNodeAutoRun;
+    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(): void;
+    execute(nodeId: string, runContextIds?: Set<RunContextId>, canSkipHandleResolution?: boolean): 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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"}