@bian-womp/spark-workbench 0.3.87 → 0.3.89

package/lib/src/misc/types.d.ts

@@ -0,0 +1,18 @@
+import type { Viewport } from "@bian-womp/spark-protocol";
+export interface WorkbenchUIState {
+    positions?: Record<string, {
+        x: number;
+        y: number;
+    }>;
+    selection?: {
+        nodes: string[];
+        edges: string[];
+    };
+    nodeNames?: Record<string, string>;
+    viewport?: Viewport;
+    sizes?: Record<string, {
+        width: number;
+        height: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/src/misc/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/misc/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D"}

package/lib/src/misc/types.js

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

package/lib/src/misc/types.js.map

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

package/lib/src/misc/value.d.ts

@@ -0,0 +1,16 @@
+import { type Registry } from "@bian-womp/spark-graph";
+export declare function formatDataUrlAsLabel(dataUrl: string): string;
+export declare function resolveOutputDisplay(raw: unknown, declared: string | string[] | undefined): {
+    typeId?: string;
+    value: unknown;
+};
+export declare function formatDeclaredTypeSignature(declared: string | string[] | undefined): string | undefined;
+/**
+ * Formats a handle ID for display in the UI.
+ * For handles with format "prefix:middle:suffix:extra" (4 parts), displays only the middle part.
+ * Otherwise returns the handle ID as-is.
+ */
+export declare function prettyHandle(id: string): string;
+export declare function preformatValueForDisplay(typeId: string | undefined, value: unknown, registry?: Registry): string | undefined;
+export declare function summarizeDeep(value: unknown): unknown;
+//# sourceMappingURL=value.d.ts.map

package/lib/src/misc/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../../src/misc/value.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,QAAQ,EAA6B,MAAM,wBAAwB,CAAC;AAE3F,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GACtC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAcrC;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGvG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAS/C;AAGD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,GAAG,SAAS,CAyBpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA6BrD"}

package/lib/src/misc/value.js

@@ -0,0 +1,114 @@
+import { isTyped, unwrapTypeId, unwrapValue } from "@bian-womp/spark-graph";
+export function formatDataUrlAsLabel(dataUrl) {
+    try {
+        const semi = dataUrl.indexOf(";");
+        const comma = dataUrl.indexOf(",");
+        const mime = dataUrl.slice(5, semi > 0 ? semi : undefined).toUpperCase();
+        const b64 = comma >= 0 ? dataUrl.slice(comma + 1) : "";
+        const bytes = Math.floor((b64.length * 3) / 4);
+        return `${mime} Data (${bytes} bytes)`;
+    }
+    catch {
+        return dataUrl.length > 64 ? dataUrl.slice(0, 64) + "…" : dataUrl;
+    }
+}
+export function resolveOutputDisplay(raw, declared) {
+    if (isTyped(raw)) {
+        return {
+            typeId: unwrapTypeId(raw),
+            value: unwrapValue(raw),
+        };
+    }
+    let typeId = undefined;
+    if (Array.isArray(declared)) {
+        typeId = declared.length === 1 ? declared[0] : undefined;
+    }
+    else if (typeof declared === "string") {
+        typeId = declared.includes("|") ? undefined : declared;
+    }
+    return { typeId, value: raw };
+}
+export function formatDeclaredTypeSignature(declared) {
+    if (Array.isArray(declared))
+        return declared.join(" | ");
+    return declared;
+}
+/**
+ * Formats a handle ID for display in the UI.
+ * For handles with format "prefix:middle:suffix:extra" (4 parts), displays only the middle part.
+ * Otherwise returns the handle ID as-is.
+ */
+export function prettyHandle(id) {
+    try {
+        const parts = String(id).split(":");
+        // If there are exactly 3 colons (4 parts), display only the second part
+        if (parts.length >= 3)
+            return parts[1] || id;
+        return id;
+    }
+    catch {
+        return id;
+    }
+}
+// Pre-format common structures for display; return undefined to defer to caller
+export function preformatValueForDisplay(typeId, value, registry) {
+    if (value === undefined || value === null)
+        return "";
+    // Unwrap typed outputs
+    if (isTyped(value)) {
+        return preformatValueForDisplay(unwrapTypeId(value), unwrapValue(value), registry);
+    }
+    // Enums
+    if (typeId && typeId.startsWith("enum:") && registry) {
+        const n = Number(value);
+        const label = registry.enums.get(typeId)?.valueToLabel.get(n);
+        if (label)
+            return label;
+    }
+    // Use deep summarization for strings, arrays and nested objects to avoid huge HTML payloads
+    const summarized = summarizeDeep(value);
+    if (typeof summarized === "string")
+        return summarized;
+    // Resource-like objects with url/title (after summarization)
+    if (summarized && typeof summarized === "object") {
+        const urlMaybe = summarized.url;
+        if (typeof urlMaybe === "string") {
+            const title = summarized.title || "";
+            const shortUrl = urlMaybe.length > 32 ? urlMaybe.slice(0, 32) + "…" : urlMaybe;
+            return title ? `${title} (${shortUrl})` : shortUrl;
+        }
+    }
+    return undefined;
+}
+export function summarizeDeep(value) {
+    // Strings: summarize data URLs and trim extremely long strings
+    if (typeof value === "string") {
+        if (value.startsWith("data:"))
+            return formatDataUrlAsLabel(value);
+        return value.length > 512 ? value.slice(0, 512) + "…" : value;
+    }
+    // Typed output wrapper
+    if (isTyped(value)) {
+        return summarizeDeep(unwrapValue(value));
+    }
+    // Arrays
+    if (Array.isArray(value)) {
+        return value.map((v) => summarizeDeep(v));
+    }
+    // Objects
+    if (value && typeof value === "object") {
+        const obj = value;
+        const out = {};
+        for (const [k, v] of Object.entries(obj)) {
+            // Special-case any 'url' field
+            if (typeof v === "string" && k.toLowerCase() === "url" && v.startsWith("data:")) {
+                out[k] = formatDataUrlAsLabel(v);
+                continue;
+            }
+            out[k] = summarizeDeep(v);
+        }
+        return out;
+    }
+    return value;
+}
+//# sourceMappingURL=value.js.map

package/lib/src/misc/value.js.map

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

package/lib/src/misc/viewport-utils.d.ts

@@ -0,0 +1,6 @@
+import type { Viewport } from "@bian-womp/spark-protocol";
+export declare function isValidViewport(viewport: unknown): viewport is Viewport;
+export declare function excludeViewportFromUIState<T extends {
+    viewport?: unknown;
+}>(uiState: T | null | undefined): Omit<T, "viewport">;
+//# sourceMappingURL=viewport-utils.d.ts.map

package/lib/src/misc/viewport-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-utils.d.ts","sourceRoot":"","sources":["../../../src/misc/viewport-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAWvE;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EACzE,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAC5B,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAMrB"}

package/lib/src/misc/viewport-utils.js

@@ -0,0 +1,18 @@
+export function isValidViewport(viewport) {
+    return (viewport !== null &&
+        typeof viewport === "object" &&
+        "x" in viewport &&
+        "y" in viewport &&
+        "zoom" in viewport &&
+        typeof viewport.x === "number" &&
+        typeof viewport.y === "number" &&
+        typeof viewport.zoom === "number");
+}
+export function excludeViewportFromUIState(uiState) {
+    if (!uiState) {
+        return {};
+    }
+    const { viewport: _ignoredViewport, ...rest } = uiState;
+    return rest;
+}
+//# sourceMappingURL=viewport-utils.js.map

package/lib/src/misc/viewport-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-utils.js","sourceRoot":"","sources":["../../../src/misc/viewport-utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,QAAiB;IAC/C,OAAO,CACL,QAAQ,KAAK,IAAI;QACjB,OAAO,QAAQ,KAAK,QAAQ;QAC5B,GAAG,IAAI,QAAQ;QACf,GAAG,IAAI,QAAQ;QACf,MAAM,IAAI,QAAQ;QAClB,OAAQ,QAA2B,CAAC,CAAC,KAAK,QAAQ;QAClD,OAAQ,QAA2B,CAAC,CAAC,KAAK,QAAQ;QAClD,OAAQ,QAA8B,CAAC,IAAI,KAAK,QAAQ,CACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA6B;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAyB,CAAC;IACnC,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,61 @@
+import type { RuntimeSnapshotFull, GraphDefinition, RunMode, RunnerOptions, RuntimeHistoryInfo } from "@bian-womp/spark-protocol";
+import { Engine, Registry, GraphRuntime } from "@bian-womp/spark-graph";
+import { IGraphRunner, RunnerEventName, type RunnerEventListener, ExecutionBackend, RunnerEventMap } from "./IGraphRunner";
+export declare abstract class AbstractGraphRunner implements IGraphRunner {
+    protected backend: ExecutionBackend;
+    readonly runnerId: string;
+    protected registry: Registry;
+    protected runtime?: GraphRuntime;
+    protected engine?: Engine;
+    private listeners;
+    protected stagedInputs: Record<string, Record<string, unknown>>;
+    constructor(backend: ExecutionBackend, registry?: Registry);
+    abstract launch(def: GraphDefinition, opts: RunnerOptions): void;
+    abstract build(def: GraphDefinition): void;
+    abstract update(def: GraphDefinition, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    abstract computeNode(nodeId: string): Promise<void>;
+    abstract getInputs(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    abstract getOutputs(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    abstract setEnvironment(env: Record<string, unknown>, opts?: {
+        merge?: boolean;
+        dry?: boolean;
+    }): void | Promise<void>;
+    abstract getEnvironment(): Record<string, unknown> | undefined;
+    abstract setInputs(nodeId: string, inputs: Record<string, unknown>, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    abstract copyOutputs(fromNodeId: string, toNodeId: string, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    abstract runFromHere(nodeId: string): Promise<void>;
+    abstract cancelNodeRuns(nodeIds: string[]): void | Promise<void>;
+    abstract triggerExternal(nodeId: string, event: unknown, options?: {
+        dry?: boolean;
+    }): void;
+    abstract snapshotFull(): Promise<RuntimeSnapshotFull>;
+    abstract applySnapshotFull(payload: RuntimeSnapshotFull, options?: {
+        skipBuild?: boolean;
+        dry?: boolean;
+    }): Promise<void>;
+    abstract setExtData(data: Record<string, unknown>): Promise<void>;
+    abstract updateExtData(updates: Array<{
+        path: string;
+        value: unknown;
+    }>): Promise<boolean>;
+    protected abstract createAndLaunchEngine(opts?: RunnerOptions): Promise<void>;
+    abstract pause(): Promise<void>;
+    abstract resume(): Promise<void>;
+    whenIdle(): Promise<void>;
+    setRunMode(runMode: RunMode): void;
+    getInputDefaults(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    on<K extends RunnerEventName>(event: K, handler: RunnerEventListener<K>): () => void;
+    protected emit<K extends RunnerEventName>(event: K, payload: RunnerEventMap[K]): void;
+    dispose(): void | Promise<void>;
+    isRunning(): boolean;
+    undo(): Promise<boolean>;
+    redo(): Promise<boolean>;
+    commit(_reason?: string): Promise<RuntimeHistoryInfo | undefined>;
+}
+//# sourceMappingURL=AbstractGraphRunner.d.ts.map

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

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

package/lib/src/runtime/AbstractGraphRunner.js

@@ -0,0 +1,63 @@
+import { createSimpleGraphRegistry } from "@bian-womp/spark-graph";
+export class AbstractGraphRunner {
+    constructor(backend, registry) {
+        this.backend = backend;
+        this.listeners = new Map();
+        this.stagedInputs = {};
+        this.runnerId = "";
+        this.registry = registry ?? createSimpleGraphRegistry();
+    }
+    async whenIdle() {
+        await this.engine?.whenIdle();
+    }
+    setRunMode(runMode) {
+        if (this.engine) {
+            this.engine.setRunMode(runMode);
+            this.emit("status", { running: true, runMode });
+        }
+    }
+    getInputDefaults(def) {
+        const out = {};
+        for (const n of def.nodes) {
+            const dynDefaults = n.resolvedHandles?.inputDefaults ?? {};
+            if (Object.keys(dynDefaults).length > 0) {
+                out[n.nodeId] = dynDefaults;
+            }
+        }
+        return out;
+    }
+    on(event, handler) {
+        if (!this.listeners.has(event))
+            this.listeners.set(event, new Set());
+        const set = this.listeners.get(event);
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (set)
+            for (const h of Array.from(set))
+                h(payload);
+    }
+    dispose() {
+        this.engine?.dispose();
+        this.engine = undefined;
+        this.runtime?.dispose();
+        this.runtime = undefined;
+    }
+    isRunning() {
+        return !!this.engine;
+    }
+    // Optional undo/redo support
+    async undo() {
+        return false;
+    }
+    async redo() {
+        return false;
+    }
+    // Optional commit support
+    async commit(_reason) {
+        return undefined;
+    }
+}
+//# sourceMappingURL=AbstractGraphRunner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractGraphRunner.js","sourceRoot":"","sources":["../../../src/runtime/AbstractGraphRunner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAkC,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AASnG,MAAM,OAAgB,mBAAmB;IAQvC,YACY,OAAyB,EACnC,QAAmB;QADT,YAAO,GAAP,OAAO,CAAkB;QAJ7B,cAAS,GAAG,IAAI,GAAG,EAA8D,CAAC;QAChF,iBAAY,GAA4C,EAAE,CAAC;QAMnE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,yBAAyB,EAAE,CAAC;IAC1D,CAAC;IAkDD,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,GAAoB;QACnC,MAAM,GAAG,GAA4C,EAAE,CAAC;QACxD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,WAAW,GAAG,CAAC,CAAC,eAAe,EAAE,aAAa,IAAI,EAAE,CAAC;YAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,EAAE,CAA4B,KAAQ,EAAE,OAA+B;QACrE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAiC,CAAC;QACtE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAES,IAAI,CAA4B,KAAQ,EAAE,OAA0B;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG;YAAE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED,SAAS;QACP,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,6BAA6B;IAC7B,KAAK,CAAC,IAAI;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,IAAI;QACR,OAAO,KAAK,CAAC;IACf,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,MAAM,CAAC,OAAgB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,100 @@
+import type { GraphDefinition, RuntimeSnapshotFull, RunMode, RunnerOptions, RuntimeHistoryInfo, Viewport } from "@bian-womp/spark-protocol";
+import { EngineEventName, Registry, type RuntimeEventMap } from "@bian-womp/spark-graph";
+import { HttpPollingTransport, WebSocketTransport, TransportConnectOptions } from "@bian-womp/spark-remote";
+export type RemoteExecutionBackend = {
+    kind: "remote-http";
+    baseUrl: string;
+    connectOptions?: TransportConnectOptions;
+    onCustomEvent?: (event: any) => void;
+} | {
+    kind: "remote-ws";
+    url: string;
+    connectOptions?: TransportConnectOptions;
+    onCustomEvent?: (event: any) => void;
+};
+export type ExecutionBackend = {
+    kind: "local";
+} | RemoteExecutionBackend;
+export type ExecutionBackendKind = ExecutionBackend["kind"];
+export type RemoteExecutionBackendKind = Exclude<ExecutionBackendKind, "local">;
+export type RunnerEventListener<K extends RunnerEventName> = (e: RunnerEventMap[K]) => void;
+export type RunnerEventName = EngineEventName | "status" | "transport" | "registry" | "viewport";
+export type RemoteTransport = HttpPollingTransport | WebSocketTransport;
+export interface RunnerStatus {
+    running: boolean;
+    runMode?: RunMode;
+}
+export type TransportState = "local" | "connecting" | "connected" | "disconnected" | "retrying";
+export interface TransportStatus {
+    state: TransportState;
+    kind?: RemoteExecutionBackendKind;
+    runnerId?: string;
+}
+export interface RunnerEventMap extends RuntimeEventMap {
+    status: RunnerStatus;
+    transport: TransportStatus;
+    registry: Registry;
+    viewport: {
+        viewport: Viewport;
+    };
+}
+export interface IGraphRunner {
+    readonly runnerId: string;
+    build(def: GraphDefinition): void;
+    update(def: GraphDefinition, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    computeNode(nodeId: string): Promise<void>;
+    /**
+     * Run this node and all downstream nodes in execution order.
+     * Implemented only for pull/manual mode; callers should ensure the
+     * runner is in manual RunMode before calling.
+     */
+    runFromHere(nodeId: string): Promise<void>;
+    /**
+     * Cancel active runs for one or more nodes.
+     * This will abort any currently executing nodes and cancel their downstream execution.
+     */
+    cancelNodeRuns(nodeIds: string[]): void | Promise<void>;
+    getOutputs(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    getInputs(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    getInputDefaults(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    launch(def: GraphDefinition, opts: RunnerOptions): void;
+    setInputs(nodeId: string, inputs: Record<string, unknown>, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    copyOutputs(fromNodeId: string, toNodeId: string, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    triggerExternal(nodeId: string, event: unknown, options?: {
+        dry?: boolean;
+    }): void | Promise<void>;
+    coerce?(from: string, to: string, value: unknown): Promise<unknown>;
+    on<K extends RunnerEventName>(event: K, handler: RunnerEventListener<K>): () => void;
+    whenIdle(): Promise<void>;
+    setRunMode(runMode: RunMode): void | Promise<void>;
+    dispose(): void | Promise<void>;
+    isRunning(): boolean;
+    snapshotFull: () => Promise<RuntimeSnapshotFull>;
+    applySnapshotFull: (payload: RuntimeSnapshotFull, options?: {
+        skipBuild?: boolean;
+        dry?: boolean;
+    }) => Promise<void>;
+    setEnvironment: (env: Record<string, unknown>, opts?: {
+        merge?: boolean;
+        dry?: boolean;
+    }) => void | Promise<void>;
+    getEnvironment: () => Record<string, unknown> | undefined;
+    setExtData: (data: Record<string, unknown>) => Promise<void>;
+    updateExtData: (updates: Array<{
+        path: string;
+        value: unknown;
+    }>) => Promise<boolean>;
+    setViewport?: (viewport: Viewport) => Promise<void>;
+    undo: () => Promise<boolean>;
+    redo: () => Promise<boolean>;
+    commit: (reason?: string) => Promise<RuntimeHistoryInfo | undefined>;
+    pause: () => Promise<void>;
+    resume: () => Promise<void>;
+}
+//# sourceMappingURL=IGraphRunner.d.ts.map

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

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

package/lib/src/runtime/IGraphRunner.js

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

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

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

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

@@ -0,0 +1,60 @@
+import { Registry, LocalEngine } from "@bian-womp/spark-graph";
+import type { GraphDefinition, RuntimeSnapshotFull, RunnerOptions, ConverterConfig } from "@bian-womp/spark-protocol";
+import { AbstractGraphRunner } from "./AbstractGraphRunner";
+export declare class LocalGraphRunner extends AbstractGraphRunner {
+    readonly runnerId: string;
+    protected engine?: LocalEngine;
+    private extData;
+    constructor(registry?: Registry);
+    build(def: GraphDefinition, opts?: {
+        startPaused?: boolean;
+    }): void;
+    update(def: GraphDefinition, options?: {
+        dry?: boolean;
+    }): void;
+    launch(def: GraphDefinition, opts: RunnerOptions): void;
+    protected createAndLaunchEngine(opts?: RunnerOptions): Promise<void>;
+    computeNode(nodeId: string): Promise<void>;
+    runFromHere(nodeId: string): Promise<void>;
+    cancelNodeRuns(nodeIds: string[]): void;
+    getOutputs(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    getInputs(def: GraphDefinition): Record<string, Record<string, unknown>>;
+    triggerExternal(nodeId: string, event: unknown, options?: {
+        dry?: boolean;
+    }): void;
+    setInputs(nodeId: string, inputs: Record<string, unknown>, options?: {
+        dry?: boolean;
+    }): void;
+    copyOutputs(fromNodeId: string, toNodeId: string, options?: {
+        dry?: boolean;
+    }): void;
+    setEnvironment: (env: Record<string, unknown>, opts?: {
+        merge?: boolean;
+        dry?: boolean;
+    }) => void;
+    getEnvironment: () => Record<string, unknown> | undefined;
+    setExtData(data: Record<string, unknown>): Promise<void>;
+    updateExtData(updates: Array<{
+        path: string;
+        value: unknown;
+    }>): Promise<boolean>;
+    snapshotFull(): Promise<{
+        def: any;
+        environment: Record<string, unknown>;
+        inputs: Record<string, Record<string, unknown>>;
+        outputs: Record<string, Record<string, unknown>>;
+        extData: Record<string, unknown>;
+    }>;
+    applySnapshotFull(payload: RuntimeSnapshotFull, options?: {
+        skipBuild?: boolean;
+        dry?: boolean;
+    }): Promise<void>;
+    convertSnapshot(converterConfig: ConverterConfig, options?: {
+        dry?: boolean;
+    }): Promise<RuntimeSnapshotFull>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    private hydrate;
+    dispose(): void;
+}
+//# sourceMappingURL=LocalGraphRunner.d.ts.map

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

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