@bian-womp/spark-remote 0.3.1 → 0.3.3

package/lib/cjs/src/server/ServerCommandHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerCommandHandler.d.ts","sourceRoot":"","sources":["../../../../src/server/ServerCommandHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,WAAW,EACX,UAAU,EACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,KACxD,IAAI,CAAC;AAEV,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO,CAAC;IAJlB,OAAO,CAAC,WAAW,CAA2B;gBAGpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;QAChB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,YAAA;IAGH;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIxC;;OAEG;IACG,aAAa,CACjB,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,EACtB,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,IAAI,GAC5B,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;YACW,kBAAkB;IAgBhC;;OAEG;YACW,cAAc;IAmO5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CA6BpB"}
+{"version":3,"file":"ServerCommandHandler.d.ts","sourceRoot":"","sources":["../../../../src/server/ServerCommandHandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,WAAW,EACX,UAAU,EACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAInE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,EACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,QAAQ,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC,KACxD,IAAI,CAAC;AAEV,qBAAa,oBAAoB;IAI7B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO,CAAC;IAJlB,OAAO,CAAC,WAAW,CAA2B;gBAGpC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,CAAC,EAAE;QAChB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,UAAU,CAAC,EAAE,UAAU,CAAC;KACzB,YAAA;IAGH;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAIxC;;OAEG;IACG,aAAa,CACjB,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,EACtB,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,KAAK,IAAI,GAC5B,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;YACW,kBAAkB;IAgBhC;;OAEG;YACW,cAAc;IAwO5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAuBlB;;;;OAIG;IACH,OAAO,CAAC,WAAW;CA6BpB"}

package/lib/cjs/src/server/ServerRuntimeAdapter.d.ts

@@ -1,5 +1,5 @@
 import type { Envelope, RuntimeEvent, RuntimeMetadata } from "@bian-womp/spark-protocol";
-import { GraphBuilder, Registry, GraphRuntime, UnifiedEngine, type GraphLifecycleApi, type Engine } from "@bian-womp/spark-graph";
+import { GraphBuilder, Registry, GraphRuntime, LocalEngine, type GraphLifecycleApi, type Engine } from "@bian-womp/spark-graph";
 /**
  * ServerRuntimeAdapter extends GraphLifecycleApi and Engine to provide a unified interface
  * for both lifecycle and execution operations on the server side.
@@ -14,7 +14,7 @@ export interface ServerRuntimeAdapterContext {
     registry: Registry;
     builder: GraphBuilder;
     graphRuntime: GraphRuntime | undefined;
-    engine: UnifiedEngine | undefined;
+    engine: LocalEngine | undefined;
     extData: {
         runtime?: RuntimeMetadata;
     } & Record<string, unknown>;

package/lib/cjs/src/server/ServerRuntimeAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServerRuntimeAdapter.d.ts","sourceRoot":"","sources":["../../../../src/server/ServerRuntimeAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAIZ,eAAe,EAEhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,MAAM,EAGZ,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,oBACf,SAAQ,iBAAiB,EACvB,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;CAEzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,6BAA6B,GAAG;KACzC,CAAC,IAAI,MAAM,oBAAoB,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAClE,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,GACJ,CACE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACjC,OAAO,EAAE,2BAA2B,EACpC,GAAG,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,KACzC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACxC,KAAK;CACV,CAAC;AAEF,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAClD,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,EACzC,UAAU,CAAC,EAAE,6BAA6B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CA0X/B"}
+{"version":3,"file":"ServerRuntimeAdapter.d.ts","sourceRoot":"","sources":["../../../../src/server/ServerRuntimeAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAIZ,eAAe,EAEhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,EAGX,KAAK,iBAAiB,EACtB,KAAK,MAAM,EAGZ,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,WAAW,oBACf,SAAQ,iBAAiB,EACvB,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC;CAEzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,eAAe,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,6BAA6B,GAAG;KACzC,CAAC,IAAI,MAAM,oBAAoB,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAClE,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,GAAG,GACJ,CACE,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EACjC,OAAO,EAAE,2BAA2B,EACpC,GAAG,IAAI,EAAE,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,KACzC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACxC,KAAK;CACV,CAAC;AAEF,wBAAsB,0BAA0B,CAC9C,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,cAAc,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,EAClD,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,EACzC,UAAU,CAAC,EAAE,6BAA6B,GACzC,OAAO,CAAC,oBAAoB,CAAC,CA8X/B"}

package/lib/cjs/src/transport/Transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Transport.d.ts","sourceRoot":"","sources":["../../../../src/transport/Transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACzC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,SAAS,CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EACpC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}
+{"version":3,"file":"Transport.d.ts","sourceRoot":"","sources":["../../../../src/transport/Transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CACzC,MAAM,EACN,MAAM,GAAG,MAAM,GAAG,SAAS,CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,GAAG,OAAO,EACpC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAClB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/lib/esm/index.js

@@ -1,5 +1,5 @@
 import { WebSocket } from 'ws';
-import { GraphBuilder, UnifiedEngine } from '@bian-womp/spark-graph';
+import { GraphBuilder, parseJsonPath, setValueAtPathWithCreation, LocalEngine } from '@bian-womp/spark-graph';
 
 class SeqGenerator {
     constructor() {
@@ -460,8 +460,14 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
             // (e.g., { ui } or { runtime }) without dropping the other ones.
             extData = { ...extData, ...data };
         },
-        getExtData: async () => {
-            return extData;
+        updateExtData: async (updates) => {
+            if (!extData || typeof extData !== "object" || Array.isArray(extData)) {
+                extData = {};
+            }
+            for (const { path, value } of updates) {
+                const pathSegments = parseJsonPath(path);
+                setValueAtPathWithCreation(extData, pathSegments, value);
+            }
         },
         snapshot: async () => {
             const inputs = {};
@@ -482,14 +488,12 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
         },
         snapshotFull: async () => {
             const snap = await originalAdapter.snapshot();
-            const extData = await originalAdapter.getExtData();
             const env = graphRuntime?.getEnvironment?.() ?? {};
             const def = graphRuntime?.getGraphDef();
             return {
+                ...snap,
                 def,
                 environment: env,
-                inputs: snap.inputs,
-                outputs: snap.outputs,
                 extData,
             };
         },
@@ -555,9 +559,8 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
         update: async (def, options) => {
             if (!graphRuntime)
                 return;
-            const wasPaused = graphRuntime.isPaused();
-            if (options?.dry && !wasPaused)
-                graphRuntime.pause();
+            // Use requestPause for dry mode to temporarily pause without affecting base run mode
+            const releasePause = options?.dry ? graphRuntime.requestPause() : null;
             try {
                 graphRuntime.update(def, registry);
                 send({
@@ -568,16 +571,14 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
                 });
             }
             finally {
-                if (options?.dry && !wasPaused)
-                    graphRuntime.resume();
+                releasePause?.();
             }
         },
         setEnvironment: async (env, opts) => {
             if (!graphRuntime)
                 return;
-            const wasPaused = graphRuntime.isPaused();
-            if (opts?.dry && !wasPaused)
-                graphRuntime.pause();
+            // Use requestPause for dry mode to temporarily pause without affecting base run mode
+            const releasePause = opts?.dry ? graphRuntime.requestPause() : null;
             try {
                 if (opts?.merge) {
                     const current = graphRuntime.getEnvironment();
@@ -589,8 +590,7 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
                 }
             }
             finally {
-                if (opts?.dry && !wasPaused)
-                    graphRuntime.resume();
+                releasePause?.();
             }
         },
         setInputs: (nodeId, inputs, options) => {
@@ -618,7 +618,7 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
                 engine = undefined;
             }
             // Create new engine using shared factory
-            engine = new UnifiedEngine(graphRuntime, opts?.runMode);
+            engine = new LocalEngine(graphRuntime, opts?.runMode);
             engine.launch(opts?.invalidate);
         },
         setRunMode: (runMode) => {
@@ -688,7 +688,7 @@ async function createServerRuntimeAdapter(id, createRegistry, send, extensions)
         applyRegistry: wrapMethod("applyRegistry", originalAdapter.applyRegistry),
         build: wrapMethod("build", originalAdapter.build),
         setExtData: wrapMethod("setExtData", originalAdapter.setExtData),
-        getExtData: wrapMethod("getExtData", originalAdapter.getExtData),
+        updateExtData: wrapMethod("updateExtData", originalAdapter.updateExtData),
         snapshot: wrapMethod("snapshot", originalAdapter.snapshot),
         snapshotFull: wrapMethod("snapshotFull", originalAdapter.snapshotFull),
         applySnapshotFull: wrapMethod("applySnapshotFull", originalAdapter.applySnapshotFull),
@@ -767,13 +767,8 @@ class RemoteEngine {
             this.emit("stats", msg.payload);
         }
     }
-    launch(invalidate, runMode) {
-        this.transport.send({
-            message: {
-                type: "Launch",
-                payload: { runMode, invalidate },
-            },
-        });
+    launch() {
+        throw new Error("RemoteEngine.launch() is not supported. Use GraphLifecycleApi.launch() instead.");
     }
     setRunMode(runMode) {
         this.transport.send({
@@ -971,13 +966,11 @@ class RemoteGraphLifecycleApi {
             message: { type: "SetExtData", payload: data },
         });
     }
-    async getExtData() {
+    async updateExtData(updates) {
         const transport = await this.ensureConnected();
-        const res = await transport.request({
-            message: { type: "GetExtData" },
+        await transport.request({
+            message: { type: "UpdateExtData", payload: updates },
         });
-        const payload = res?.message || {};
-        return payload.extData || {};
     }
     async setViewport(viewport) {
         const transport = await this.ensureConnected();
@@ -1529,6 +1522,11 @@ class ServerCommandHandler {
                 ack();
                 break;
             }
+            case "UpdateExtData": {
+                await this.adapter.updateExtData(msg.payload);
+                ack();
+                break;
+            }
             case "Dispose": {
                 this.logCommand("Dispose", env);
                 await this.adapter.dispose();