@mindexec/cli 0.2.446 → 0.2.448

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.446",
+  "version": "0.2.448",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
@@ -16,16 +16,21 @@
     "codex-runtime.js",
     "codex-model-catalog.js",
     "port-guard.cjs",
-    "remote-fast/",
-    "wwwroot/",
-    "scripts/",
+    "remote-fast/",
+    "wwwroot/",
+    "electron/",
+    "scripts/",
     "tree-sitter-grammars/",
     "README.md"
   ],
-  "scripts": {
-    "start": "node launch-bridge.cjs",
-    "dev": "node launch-bridge.cjs --watch",
-    "test:syntax": "node --check server.js && node --check remote-hub.js && node --check lzo1x.js && node --check mode4-atlas.js && node --check mode4-atlas-worker.js && node --check codex-runtime.js && node --check codex-model-catalog.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs && node --check scripts/npm-fresh-install-smoke.mjs && node --check scripts/auth-session-smoke.mjs && node --check scripts/codex-model-catalog-smoke.mjs && node --check scripts/remote-hub-smoke.mjs && node --check scripts/remote-hub-scale-smoke.mjs && node --check scripts/remote-fleet-render-smoke.mjs && node --check scripts/remote-http-smoke.mjs && node --check scripts/remote-frame-ws-smoke.mjs && node --check scripts/remote-input-ws-smoke.mjs && node --check scripts/remote-agent-ws-smoke.mjs && node --check scripts/remote-agent-managed-smoke.mjs && node --check scripts/remote-registry-follower-smoke.mjs && node --check scripts/remote-agent-package-smoke.mjs && node --check scripts/remote-fast-live-rate-smoke.mjs && node --check scripts/remote-fast-mdm-browser-smoke.mjs",
+  "scripts": {
+    "start": "node launch-bridge.cjs",
+    "dev": "node launch-bridge.cjs --watch",
+    "desktop:start": "electron electron/main.cjs",
+    "desktop:build:win": "electron-builder --win --x64 --publish never",
+    "test:desktop": "node electron/source-smoke.mjs",
+    "test:desktop:win": "node electron/windows-package-smoke.mjs",
+    "test:syntax": "node --check server.js && node --check remote-hub.js && node --check lzo1x.js && node --check mode4-atlas.js && node --check mode4-atlas-worker.js && node --check codex-runtime.js && node --check codex-model-catalog.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check electron/main.cjs && node --check electron/source-smoke.mjs && node --check electron/windows-package-smoke.mjs && node --check scripts/setup-tree-sitter-grammars.mjs && node --check scripts/npm-fresh-install-smoke.mjs && node --check scripts/auth-session-smoke.mjs && node --check scripts/codex-model-catalog-smoke.mjs && node --check scripts/remote-hub-smoke.mjs && node --check scripts/remote-hub-scale-smoke.mjs && node --check scripts/remote-fleet-render-smoke.mjs && node --check scripts/remote-http-smoke.mjs && node --check scripts/remote-frame-ws-smoke.mjs && node --check scripts/remote-input-ws-smoke.mjs && node --check scripts/remote-agent-ws-smoke.mjs && node --check scripts/remote-agent-managed-smoke.mjs && node --check scripts/remote-registry-follower-smoke.mjs && node --check scripts/remote-agent-package-smoke.mjs && node --check scripts/remote-fast-live-rate-smoke.mjs && node --check scripts/remote-fast-mdm-browser-smoke.mjs",
     "test:codex-model-catalog": "node scripts/codex-model-catalog-smoke.mjs",
     "test:codex-model-catalog:live": "node scripts/codex-model-catalog-smoke.mjs --live",
     "test:auth": "node scripts/auth-session-smoke.mjs",
@@ -53,7 +58,7 @@
     "local",
     "ai"
   ],
-  "author": "",
+  "author": "lovecrdm77",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -63,7 +68,7 @@
   },
   "dependencies": {
     "@ffmpeg-installer/ffmpeg": "^1.1.0",
-    "@mindexec/remote": "^0.1.17",
+    "@mindexec/remote": "^0.1.18",
     "@openai/codex-sdk": "^0.144.1",
     "chokidar": "^3.6.0",
     "cors": "^2.8.5",
@@ -82,7 +87,62 @@
     "mindexec": "launch-bridge.cjs",
     "mind-bridge": "launch-bridge.cjs"
   },
-  "devDependencies": {
-    "tree-sitter-wasms": "^0.1.13"
-  }
-}
+  "devDependencies": {
+    "electron": "43.2.0",
+    "electron-builder": "26.15.3",
+    "tree-sitter-wasms": "^0.1.13"
+  },
+  "build": {
+    "appId": "com.mindexec.desktop",
+    "productName": "MindExec",
+    "copyright": "Copyright © 2026 lovecrdm77",
+    "asar": false,
+    "extraMetadata": {
+      "main": "electron/main.cjs"
+    },
+    "directories": {
+      "output": "../artifacts/electron"
+    },
+    "files": [
+      "*.js",
+      "*.cjs",
+      "*.json",
+      "electron/main.cjs",
+      "remote-fast/**/*",
+      "scripts/**/*",
+      "tree-sitter-grammars/**/*",
+      "wwwroot/**/*",
+      "node_modules/**/*"
+    ],
+    "win": {
+      "icon": "../MindExecution.Web/wwwroot/icon-512.png",
+      "executableName": "MindExec",
+      "target": [
+        {
+          "target": "nsis",
+          "arch": [
+            "x64"
+          ]
+        },
+        {
+          "target": "portable",
+          "arch": [
+            "x64"
+          ]
+        }
+      ]
+    },
+    "nsis": {
+      "artifactName": "MindExec-Setup-${version}-${arch}.${ext}",
+      "oneClick": false,
+      "perMachine": false,
+      "allowToChangeInstallationDirectory": true,
+      "createDesktopShortcut": true,
+      "createStartMenuShortcut": true,
+      "shortcutName": "MindExec"
+    },
+    "portable": {
+      "artifactName": "MindExec-Portable-${version}-${arch}.${ext}"
+    }
+  }
+}

package/remote-hub.js

@@ -2,7 +2,7 @@ import net from 'net';
 import os from 'os';
 import crypto from 'crypto';
 
-const DEFAULT_REMOTE_HUB_PORT = 5197;
+const DEFAULT_REMOTE_HUB_PORT = 5198;
 const DEFAULT_REMOTE_HUB_HOST = '0.0.0.0';
 const DEFAULT_HEARTBEAT_MS = 5000;
 const DEFAULT_AGENT_TASK_TIMEOUT_MS = 120000;

package/scripts/remote-fleet-render-smoke.mjs

@@ -435,7 +435,9 @@ function projectDevice(device) {
 
 async function loadCss3DManager() {
     const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const hotPathModulePath = path.resolve(__dirname, '../../MindExecution.Shared/wwwroot/js/mind-map-css3d-hotpath.js');
     const managerPath = path.resolve(__dirname, '../../MindExecution.Shared/wwwroot/js/mind-map-css3d-manager.js');
+    const hotPathSource = await fs.readFile(hotPathModulePath, 'utf8');
     const source = await fs.readFile(managerPath, 'utf8');
     const document = new MiniDocument();
     const objectUrlCalls = [];
@@ -558,11 +560,18 @@ async function loadCss3DManager() {
                 textOverlayInvalidations.push({ module, nodeId, reason, fallback: true });
             }
         },
+        MindExecRemoteCodecs: {
+            async decodeH264Frame(canvas, frame, onFrame) {
+                onFrame?.(canvas, frame);
+                return true;
+            }
+        },
         Promise
     };
     context.window = context;
     context.self = context;
 
+    vm.runInNewContext(hotPathSource, context, { filename: hotPathModulePath });
     vm.runInNewContext(source, context, { filename: managerPath });
     return {
         manager: context.window.MindMapCss3DManager,
@@ -584,6 +593,15 @@ function wait(ms = 0) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
 
+async function waitFor(predicate, timeoutMs = 500, intervalMs = 10) {
+    const deadline = Date.now() + Math.max(1, Number(timeoutMs || 500));
+    while (Date.now() < deadline) {
+        if (predicate()) return true;
+        await wait(intervalMs);
+    }
+    return predicate();
+}
+
 function encodeRemoteBinaryFrame(metadata, payload = new Uint8Array([0xff, 0xd8, 0xff, 0xd9])) {
     const metaBytes = new TextEncoder().encode(JSON.stringify(metadata));
     const payloadBytes = payload instanceof Uint8Array ? payload : new Uint8Array(payload);
@@ -598,7 +616,7 @@ function encodeRemoteBinaryFrame(metadata, payload = new Uint8Array([0xff, 0xd8,
 
 function buildMonitorNode(devices, hubStatus, latestTaskBatch = null, recentTaskBatches = [], lastError = '', nodeId = 'remote-fleet-render-smoke') {
     const connected = devices.filter(device => device.Connected).length;
-    const endpoint = hubStatus.agentEndpoint || '127.0.0.1:5197';
+    const endpoint = hubStatus.agentEndpoint || '127.0.0.1:5198';
     const pairToken = hubStatus.pairToken || 'render-smoke-token';
     const hostTargetState = hubStatus.hostTargetActive
         ? (hubStatus.hostTargetNodeId === nodeId ? 'hosting' : 'other-monitor')
@@ -665,7 +683,7 @@ function createRemoteFleetTemplateShell(document, focusDeviceId = '', nodeId = '
 }
 
 function buildDeviceNode(device, hubStatus) {
-    const endpoint = hubStatus.agentEndpoint || '127.0.0.1:5197';
+    const endpoint = hubStatus.agentEndpoint || '127.0.0.1:5198';
     return {
         id: 'remote-device-render-smoke',
         contentType: 'memo',
@@ -1060,6 +1078,13 @@ try {
         binaryDrawCalls.some(call => call.op === 'clearRect' || call.op === 'fillRect'),
         false,
         'binary Blob frame paint must not clear/fill the canvas before drawing');
+    assert.ok(
+        Number(moduleRef._forceUpdateFrames || 0) >= 2,
+        'binary live frame commits must wake the passive MDM CSS3D frame loop');
+    assert.equal(moduleRef._lastAnimationWakeReason, 'remote-live-css3d-frame');
+    assert.ok(
+        diagnostics.runtimeTrace.some(event => event.type === 'remote.frame.css3dWake'),
+        'binary live frame commits must trace the MDM CSS3D wake path');
     const binaryCanvasBeforeRerender = binaryCanvas;
 
     const liveOverlayCard = document.createElement('div');
@@ -1073,12 +1098,28 @@ try {
     moduleRef._lastAnimationWakeReason = '';
 
     await wait(20);
-    const liveWs = diagnostics.webSocketConnections[0];
-    assert.ok(liveWs, 'expected MDM render to open the binary frame WebSocket');
-    assert.equal(liveWs.readyState, 1, 'binary frame WebSocket should be open before rerender');
+    const liveWs = diagnostics.webSocketConnections.find(connection =>
+        String(connection?.url || '').includes('/api/remote/atlas/ws'));
+    assert.ok(
+        liveWs,
+        `expected MDM render to open the Mode 4 Atlas WebSocket: ${diagnostics.webSocketConnections.map(connection => connection.url).join(', ')}`
+    );
+    assert.equal(liveWs.readyState, 1, 'Mode 4 Atlas WebSocket should be open before rerender');
     const wsCountBeforeRerender = diagnostics.webSocketConnections.length;
     const wsCloseCountBeforeRerender = liveWs.closeCount;
     const websocketFrameSeq = 10001;
+    liveWs.onmessage?.({
+        data: JSON.stringify({
+            type: 'Mode4AtlasLayout',
+            tiles: [{
+                deviceId: patchTarget.DeviceId,
+                x: 0,
+                y: 0,
+                width: 64,
+                height: 36
+            }]
+        })
+    });
     liveWs.onmessage?.({
         data: new Blob([encodeRemoteBinaryFrame({
             type: 'remote.frame.binary',
@@ -1088,36 +1129,36 @@ try {
             streamId: 'render-smoke-ws-live',
             contentHash: `render-smoke-ws-live-${websocketFrameSeq}`,
             mimeType: 'image/jpeg',
+            frameMode: 'mode4-h264-atlas',
             width: 64,
             height: 36,
             capturedAt: new Date().toISOString(),
             receivedAt: new Date().toISOString()
         })])
     });
-    await wait(30);
+    await waitFor(
+        () => patchPreview.dataset.remoteFleetFrameSeq === String(websocketFrameSeq)
+    );
     assert.equal(
         patchPreview.dataset.remoteFleetFrameSeq,
         String(websocketFrameSeq),
         JSON.stringify(diagnostics.runtimeTrace.slice(-12)));
-    await wait(10);
-    assert.ok(
-        Number(moduleRef._forceUpdateFrames || 0) >= 2,
-        'binary live frame commits must wake the passive MDM CSS3D frame loop');
-    assert.equal(moduleRef._lastAnimationWakeReason, 'remote-live-css3d-frame');
     assert.ok(
-        diagnostics.runtimeTrace.some(event => event.type === 'remote.frame.css3dWake'),
-        'binary live frame commits must trace the MDM CSS3D wake path');
+        diagnostics.runtimeTrace.some(event =>
+            event.type === 'remote.atlas.painted' &&
+            Number(event.frameSeq || 0) === websocketFrameSeq),
+        'Mode 4 Atlas frame must paint its configured device tile');
 
     manager.renderRemoteFleetMonitorForTest(bodyView, buildMonitorNode(devices, hub.getStatus({ includeSecrets: true }), latestTaskBatch, recentTaskBatches));
     await wait(30);
     assert.equal(
         liveWs.closeCount,
         wsCloseCountBeforeRerender,
-        'MDM rerender must not close the active binary frame WebSocket');
+        'MDM rerender must not close the active Mode 4 Atlas WebSocket');
     assert.equal(
         diagnostics.webSocketConnections.length,
         wsCountBeforeRerender,
-        'MDM rerender must reuse the active binary frame WebSocket instead of opening a replacement');
+        'MDM rerender must reuse the active Mode 4 Atlas WebSocket instead of opening a replacement');
     const rerenderedPatchPreview = bodyView
         .querySelector(`article[data-device-id="${patchTarget.DeviceId}"]`)
         ?.querySelector('[data-remote-fleet-device-preview="tile"]');
@@ -1148,15 +1189,11 @@ try {
         .querySelector(`article[data-device-id="${patchTarget.DeviceId}"]`)
         ?.querySelector('[data-remote-fleet-device-preview="tile"]');
     assert.ok(otherBoardPatchPreview);
-    assert.equal(
-        otherBoardPatchPreview.dataset.remoteFleetFrameSeq,
-        String(websocketFrameSeq),
-        'a different-board MDM should prime from the device-global latest binary frame cache');
-    assert.equal(
-        otherBoardPatchPreview.querySelector('canvas[data-remote-fleet-frame-canvas="true"]')?.style.display,
-        'block');
+    assert.ok(
+        diagnostics.webSocketConnections.length > wsCountBeforeRerender,
+        'a different-board MDM must own a separate Mode 4 Atlas session');
     assert.ok(diagnostics.runtimeTrace.some(event =>
-        (event.type === 'remote.frame.wsCachePrimed' || event.type === 'remote.frame.surfaceCachePrimed')
+        event.type === 'remote.atlas.wsOpen'
         && event.nodeId === otherBoardNodeId));
     otherBoardShell.remove();
 
@@ -1260,18 +1297,17 @@ try {
             }
         })
         .filter(Boolean);
-    const autoLiveSubscribe = subscribeMessages.find(message =>
-        message.type === 'subscribe'
-        && message.nodeId === 'remote-fleet-render-smoke'
-        && message.autoStartLive === true);
+    const atlasConfigure = subscribeMessages.find(message =>
+        message.type === 'configure');
     assert.ok(diagnostics.fetchCalls.some(call => call.url.includes('/api/status?remoteFrames=ws')));
-    assert.ok(diagnostics.webSocketConnections.length >= 1, 'expected MDM render to open binary frame WebSocket');
-    assert.ok(autoLiveSubscribe, 'expected MDM render to subscribe with autoStartLive over WebSocket');
-    assert.equal(autoLiveSubscribe.fps, 12);
-    assert.equal(autoLiveSubscribe.maxWidth, 960);
-    assert.equal(autoLiveSubscribe.maxHeight, 540);
-    assert.equal(autoLiveSubscribe.quality, 60);
-    assert.ok(autoLiveSubscribe.deviceIds.length > 1, 'expected visible connected devices in WS subscription');
+    assert.ok(diagnostics.webSocketConnections.length >= 1, 'expected MDM render to open Mode 4 Atlas WebSocket');
+    assert.ok(atlasConfigure, 'expected MDM render to configure the Mode 4 Atlas WebSocket');
+    assert.equal(atlasConfigure.fps, 20);
+    assert.equal(atlasConfigure.width, 1920);
+    assert.equal(atlasConfigure.height, 1080);
+    assert.equal(atlasConfigure.tileWidth, 320);
+    assert.equal(atlasConfigure.tileHeight, 180);
+    assert.ok(atlasConfigure.deviceIds.length > 1, 'expected visible connected devices in Atlas configuration');
     assert.ok(diagnostics.runtimeTrace.some(event => event.type === 'remote.live.wsAutoStartRequested'));
     assert.equal(liveStartCalls.length, 0, 'WebSocket live path must not call DotNet live-start fallback');
     await wait(320);
@@ -1373,10 +1409,12 @@ try {
             && message.type === 'subscribe'
             && message.nodeId === 'remote-device-render-smoke'
             && message.autoStartLive === true
-            && message.fps === 20
+            && message.fps === 30
+            && message.mode === 'mode3-h264-hw'
+            && message.streamPurpose === 'control'
             && Array.isArray(message.deviceIds)
             && message.deviceIds.includes(focusedDevice.DeviceId));
-    assert.ok(deviceControlSubscribe, 'RemoteFleetDevice node should subscribe to 20fps binary frames');
+    assert.ok(deviceControlSubscribe, 'RemoteFleetDevice node should subscribe to 30fps Mode 3 control frames');
     const deviceControlWs = diagnostics.webSocketConnections
         .filter(ws => ws.url.includes('/api/remote/frames/ws'))
         .at(-1);

package/scripts/remote-hub-smoke.mjs

@@ -22,6 +22,13 @@ function wait(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }
 
+const defaultHub = createRemoteHub({
+    env: {
+        MINDEXEC_REMOTE_HUB: '0'
+    }
+});
+assert.equal(defaultHub.getStatus().port, 5198, 'MindExecution RemoteHub must not reuse the LiveDesk 5197 port');
+
 async function waitFor(predicate, timeoutMs = 3000) {
     const startedAt = Date.now();
     while (Date.now() - startedAt < timeoutMs) {

package/wwwroot/_content/MindExecution.Shared/js/background-themes.js

@@ -302,10 +302,8 @@
         themeGroup.userData.localSnapGridStyle = options.localSnapGridStyle || 'line';
         themeGroup.userData.localSnapGridRadiusPx = 500;
         themeGroup.userData.themeAlias = options.themeAlias || 'LocalSnapGrid';
+        themeGroup.userData.localSnapGridBackgroundColor = options.backgroundColor;
         themeGroup.animate = () => { };
-        if (scene && options.backgroundColor !== undefined) {
-            scene.background = new THREE.Color(options.backgroundColor);
-        }
         return setThemeAnimationMode(themeGroup, THEME_ANIMATION_MODE.None);
     }