@mindexec/cli 0.2.457 → 0.2.459

package/desktop-workspace-state.cjs

@@ -0,0 +1,120 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const DESKTOP_WORKSPACE_STATE_VERSION = 1;
+
+function normalizeWorkspacePath(value) {
+  const candidate = String(value || '').trim();
+  return candidate ? path.resolve(candidate) : '';
+}
+
+function isExistingDirectory(candidatePath) {
+  if (!candidatePath) {
+    return false;
+  }
+
+  try {
+    return fs.statSync(candidatePath).isDirectory();
+  } catch {
+    return false;
+  }
+}
+
+function loadDesktopWorkspaceState(statePath) {
+  const resolvedStatePath = normalizeWorkspacePath(statePath);
+  if (!resolvedStatePath) {
+    return null;
+  }
+
+  try {
+    const payload = JSON.parse(fs.readFileSync(resolvedStatePath, 'utf8'));
+    const workspacePath = normalizeWorkspacePath(payload?.workspacePath);
+    if (Number(payload?.version) !== DESKTOP_WORKSPACE_STATE_VERSION || !workspacePath) {
+      return null;
+    }
+
+    return {
+      version: DESKTOP_WORKSPACE_STATE_VERSION,
+      workspacePath
+    };
+  } catch {
+    return null;
+  }
+}
+
+function resolveDesktopWorkspace(options = {}) {
+  const explicitWorkspace = normalizeWorkspacePath(options.explicitWorkspace);
+  if (explicitWorkspace) {
+    return {
+      workspacePath: explicitWorkspace,
+      source: 'explicit'
+    };
+  }
+
+  const savedState = loadDesktopWorkspaceState(options.statePath);
+  if (savedState && isExistingDirectory(savedState.workspacePath)) {
+    return {
+      workspacePath: savedState.workspacePath,
+      source: 'saved'
+    };
+  }
+
+  const fallbackWorkspace = normalizeWorkspacePath(options.fallbackWorkspace);
+  if (!fallbackWorkspace) {
+    throw new Error('A fallback desktop workspace is required.');
+  }
+
+  return {
+    workspacePath: fallbackWorkspace,
+    source: 'fallback'
+  };
+}
+
+function saveDesktopWorkspaceState(statePath, workspacePath) {
+  const resolvedStatePath = normalizeWorkspacePath(statePath);
+  if (!resolvedStatePath) {
+    return false;
+  }
+
+  const resolvedWorkspacePath = normalizeWorkspacePath(workspacePath);
+  if (!isExistingDirectory(resolvedWorkspacePath)) {
+    throw new Error(`Desktop workspace must be an existing directory: ${resolvedWorkspacePath || workspacePath}`);
+  }
+
+  fs.mkdirSync(path.dirname(resolvedStatePath), { recursive: true });
+  const payload = {
+    version: DESKTOP_WORKSPACE_STATE_VERSION,
+    workspacePath: resolvedWorkspacePath
+  };
+  const tempPath = `${resolvedStatePath}.${process.pid}.${Date.now()}.tmp`;
+
+  try {
+    fs.writeFileSync(tempPath, `${JSON.stringify(payload, null, 2)}\n`, {
+      encoding: 'utf8',
+      mode: 0o600
+    });
+    try {
+      fs.renameSync(tempPath, resolvedStatePath);
+    } catch (error) {
+      if (error?.code !== 'EEXIST' && error?.code !== 'EPERM' && error?.code !== 'ENOTEMPTY') {
+        throw error;
+      }
+
+      fs.rmSync(resolvedStatePath, { force: true });
+      fs.renameSync(tempPath, resolvedStatePath);
+    }
+  } finally {
+    fs.rmSync(tempPath, { force: true });
+  }
+
+  return true;
+}
+
+module.exports = {
+  DESKTOP_WORKSPACE_STATE_VERSION,
+  loadDesktopWorkspaceState,
+  resolveDesktopWorkspace,
+  saveDesktopWorkspaceState
+};

package/electron/main.cjs

@@ -6,6 +6,9 @@ const fs = require('fs');
 const http = require('http');
 const net = require('net');
 const path = require('path');
+const workspaceState = require('../desktop-workspace-state.cjs');
+
+const { resolveDesktopWorkspace } = workspaceState;
 
 const DEFAULT_BRIDGE_PORT = 5147;
 const DEFAULT_REMOTE_HUB_PORT = 5198;
@@ -20,6 +23,7 @@ let requestedExitCode = 0;
 let activeBridgePort = DEFAULT_BRIDGE_PORT;
 let activeRemoteHubPort = DEFAULT_REMOTE_HUB_PORT;
 let activeWorkspace = '';
+let desktopWorkspaceStatePath = '';
 
 function resolveDesktopIconPath() {
   const iconPath = path.resolve(__dirname, '..', 'wwwroot', 'icon-512.png');
@@ -121,6 +125,7 @@ function spawnBundledBridge(packageRoot) {
       ELECTRON_RUN_AS_NODE: '1',
       MINDEXEC_DESKTOP: '1',
       MINDEXEC_NO_OPEN: '1',
+      MINDEXEC_DESKTOP_WORKSPACE_STATE_PATH: desktopWorkspaceStatePath,
       WORKSPACE_PATH: activeWorkspace,
       BRIDGE_PORT: String(activeBridgePort),
       REMOTE_HUB_PORT: String(activeRemoteHubPort)
@@ -180,15 +185,21 @@ async function prepareBundledRuntime() {
     'RemoteHub',
     activeBridgePort
   );
-  activeWorkspace = path.resolve(
-    process.env.MINDEXEC_DESKTOP_WORKSPACE
-      || process.env.WORKSPACE_PATH
-      || path.join(app.getPath('documents'), 'MindExecution')
+  desktopWorkspaceStatePath = path.resolve(
+    process.env.MINDEXEC_DESKTOP_WORKSPACE_STATE_PATH
+      || path.join(app.getPath('userData'), 'workspace-state.json')
   );
+  const workspaceResolution = resolveDesktopWorkspace({
+    explicitWorkspace: process.env.MINDEXEC_DESKTOP_WORKSPACE || process.env.WORKSPACE_PATH,
+    statePath: desktopWorkspaceStatePath,
+    fallbackWorkspace: path.join(app.getPath('documents'), 'MindExecution')
+  });
+  activeWorkspace = workspaceResolution.workspacePath;
 
   fs.mkdirSync(activeWorkspace, { recursive: true });
   appendDesktopLog(
-    `Starting bundled runtime: bridge=${activeBridgePort}, remoteHub=${activeRemoteHubPort}, workspace=${activeWorkspace}`
+    `Starting bundled runtime: bridge=${activeBridgePort}, remoteHub=${activeRemoteHubPort}, ` +
+    `workspace=${activeWorkspace}, workspaceSource=${workspaceResolution.source}`
   );
   spawnBundledBridge(packageRoot);
   return waitForBundledBridge();
@@ -203,7 +214,7 @@ function createMainWindow() {
     minHeight: 640,
     show: !hiddenSmokeMode,
     autoHideMenuBar: true,
-    backgroundColor: '#0b1020',
+    backgroundColor: '#f8fafc',
     title: 'MindExec',
     icon: resolveDesktopIconPath(),
     webPreferences: {

package/electron/source-smoke.mjs

@@ -8,12 +8,14 @@ const electronDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(electronDirectory, '..');
 const packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
 const mainSource = fs.readFileSync(path.join(electronDirectory, 'main.cjs'), 'utf8');
+const serverSource = fs.readFileSync(path.join(packageRoot, 'server.js'), 'utf8');
 
 assert.equal(packageJson.build?.appId, 'com.mindexec.desktop', 'Stable desktop appId is required.');
 assert.equal(packageJson.build?.productName, 'MindExec', 'Desktop product name changed unexpectedly.');
 assert.equal(packageJson.build?.extraMetadata?.main, 'electron/main.cjs', 'Packaged Electron entry point is missing.');
 assert.equal(packageJson.build?.asar, false, 'Bundled runtime executables require an unpacked app directory.');
 assert.ok(packageJson.files?.includes('electron/'), 'The npm package must include the Electron source contract.');
+assert.ok(packageJson.files?.includes('desktop-workspace-state.cjs'), 'The npm package must include desktop workspace state.');
 assert.match(packageJson.scripts?.['desktop:build:win'] || '', /electron-builder/, 'Windows build script is missing.');
 assert.match(packageJson.scripts?.['test:desktop:win'] || '', /windows-package-smoke/, 'Packaged smoke test is missing.');
 
@@ -27,6 +29,21 @@ assert.ok(fs.existsSync(builderIconPath), `Electron builder icon is missing: ${b
 const builderIconMetadata = await sharp(builderIconPath).metadata();
 assert.equal(builderIconMetadata.width, 1024, 'Electron builder icon must be 1024px wide.');
 assert.equal(builderIconMetadata.height, 1024, 'Electron builder icon must be 1024px tall.');
+assert.equal(builderIconMetadata.hasAlpha, true, 'Electron builder icon must preserve transparency.');
+const { data: builderIconPixels, info: builderIconInfo } = await sharp(builderIconPath)
+  .ensureAlpha()
+  .raw()
+  .toBuffer({ resolveWithObject: true });
+const builderIconCornerAlpha = [
+  builderIconPixels[3],
+  builderIconPixels[(builderIconInfo.width - 1) * 4 + 3],
+  builderIconPixels[(builderIconInfo.height - 1) * builderIconInfo.width * 4 + 3],
+  builderIconPixels[(builderIconInfo.width * builderIconInfo.height - 1) * 4 + 3]
+];
+assert.ok(
+  builderIconCornerAlpha.every((alpha) => alpha === 0),
+  'Electron builder icon must have fully transparent corners.'
+);
 
 const targets = packageJson.build?.win?.target || [];
 assert.ok(targets.some((target) => target.target === 'nsis'), 'NSIS target is required.');
@@ -43,6 +60,10 @@ assert.doesNotMatch(mainSource, /adopted|probeBridge/, 'Electron must not adopt
 assert.match(mainSource, /MINDEXEC_DESKTOP_SMOKE_RESULT/, 'Packaged runtime smoke contract is missing.');
 assert.match(mainSource, /icon:\s*resolveDesktopIconPath\(\)/, 'Electron windows must use the packaged MindExec icon.');
 assert.match(mainSource, /app\.setAppUserModelId\(DESKTOP_APP_ID\)/, 'Windows taskbar identity must use the stable app id.');
+assert.match(mainSource, /resolveDesktopWorkspace/, 'Electron startup must restore the last desktop workspace.');
+assert.match(mainSource, /MINDEXEC_DESKTOP_WORKSPACE_STATE_PATH/, 'Electron must share its workspace state path with LocalBridge.');
+assert.match(serverSource, /saveDesktopWorkspaceState\(DESKTOP_WORKSPACE_STATE_PATH, resolvedPath\)/,
+  'A successful desktop workspace switch must be saved for the next launch.');
 
 console.log(JSON.stringify({
   ok: true,

package/electron/windows-package-smoke.mjs

@@ -5,6 +5,9 @@ import net from 'node:net';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import desktopWorkspaceState from '../desktop-workspace-state.cjs';
+
+const { saveDesktopWorkspaceState } = desktopWorkspaceState;
 
 const electronDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.resolve(electronDirectory, '..');
@@ -85,9 +88,11 @@ function canBind(port) {
 const bridgePort = await reservePort();
 const remoteHubPort = await reservePort();
 const smokeRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mindexec-electron-smoke-'));
-const workspace = path.join(smokeRoot, 'workspace');
+const workspace = path.join(smokeRoot, 'saved-workspace');
 const resultPath = path.join(smokeRoot, 'result.json');
+const workspaceStatePath = path.join(smokeRoot, 'workspace-state.json');
 fs.mkdirSync(workspace, { recursive: true });
+saveDesktopWorkspaceState(workspaceStatePath, workspace);
 
 let child;
 try {
@@ -97,7 +102,7 @@ try {
       ...process.env,
       MINDEXEC_DESKTOP_SMOKE: '1',
       MINDEXEC_DESKTOP_SMOKE_RESULT: resultPath,
-      MINDEXEC_DESKTOP_WORKSPACE: workspace,
+      MINDEXEC_DESKTOP_WORKSPACE_STATE_PATH: workspaceStatePath,
       MINDEXEC_NO_OPEN: '1',
       BRIDGE_PORT: String(bridgePort),
       REMOTE_HUB_PORT: String(remoteHubPort)
@@ -123,6 +128,7 @@ try {
   assert.equal(result.runtimeMode, 'bundled', 'Electron did not use its bundled runtime.');
   assert.equal(result.bridgePort, bridgePort, 'Packaged shell did not use the requested Bridge port.');
   assert.equal(result.remoteHubPort, remoteHubPort, 'Packaged shell did not use the requested RemoteHub port.');
+  assert.equal(path.resolve(result.workspace), path.resolve(workspace), 'Packaged Electron did not restore the saved workspace.');
 
   const exitCode = await waitForExit(child, 15_000);
   assert.equal(exitCode, 0, `Packaged Electron smoke exited with code ${exitCode}.`);

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.457",
+  "version": "0.2.459",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
   "files": [
     "start-bridge.bat",
     "start-bridge.sh",
-    "launch-bridge.cjs",
-    "server.js",
+    "launch-bridge.cjs",
+    "desktop-workspace-state.cjs",
+    "server.js",
     "remote-hub.js",
     "lzo1x.js",
     "mode4-atlas.js",
@@ -28,9 +29,9 @@
     "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": "node electron/source-smoke.mjs && node scripts/desktop-workspace-state-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/codex-sdk-runtime-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: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 desktop-workspace-state.cjs && node --check electron/main.cjs && node --check electron/source-smoke.mjs && node --check electron/windows-package-smoke.mjs && node --check scripts/desktop-workspace-state-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/codex-sdk-runtime-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-sdk": "node scripts/codex-sdk-runtime-smoke.mjs",
     "test:codex-sdk:live": "node scripts/codex-sdk-runtime-smoke.mjs --live",
     "test:codex-sdk:live-tools": "node scripts/codex-sdk-runtime-smoke.mjs --live-tools",

package/scripts/desktop-workspace-state-smoke.mjs

@@ -0,0 +1,81 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import desktopWorkspaceState from '../desktop-workspace-state.cjs';
+
+const {
+  loadDesktopWorkspaceState,
+  resolveDesktopWorkspace,
+  saveDesktopWorkspaceState
+} = desktopWorkspaceState;
+
+const smokeRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mindexec-workspace-state-'));
+const savedWorkspace = path.join(smokeRoot, 'saved-workspace');
+const explicitWorkspace = path.join(smokeRoot, 'explicit-workspace');
+const fallbackWorkspace = path.join(smokeRoot, 'fallback-workspace');
+const missingWorkspace = path.join(smokeRoot, 'missing-workspace');
+const statePath = path.join(smokeRoot, 'profile', 'workspace-state.json');
+
+fs.mkdirSync(savedWorkspace, { recursive: true });
+fs.mkdirSync(explicitWorkspace, { recursive: true });
+fs.mkdirSync(fallbackWorkspace, { recursive: true });
+
+try {
+  assert.equal(saveDesktopWorkspaceState('', savedWorkspace), false, 'Non-desktop runtimes must remain a no-op.');
+  assert.equal(saveDesktopWorkspaceState(statePath, savedWorkspace), true);
+  assert.deepEqual(loadDesktopWorkspaceState(statePath), {
+    version: 1,
+    workspacePath: path.resolve(savedWorkspace)
+  });
+
+  assert.equal(saveDesktopWorkspaceState(statePath, explicitWorkspace), true);
+  assert.equal(loadDesktopWorkspaceState(statePath)?.workspacePath, path.resolve(explicitWorkspace),
+    'Changing folders must replace the prior desktop workspace state.');
+  assert.equal(saveDesktopWorkspaceState(statePath, savedWorkspace), true);
+
+  assert.deepEqual(resolveDesktopWorkspace({
+    statePath,
+    fallbackWorkspace
+  }), {
+    workspacePath: path.resolve(savedWorkspace),
+    source: 'saved'
+  });
+
+  assert.deepEqual(resolveDesktopWorkspace({
+    explicitWorkspace,
+    statePath,
+    fallbackWorkspace
+  }), {
+    workspacePath: path.resolve(explicitWorkspace),
+    source: 'explicit'
+  });
+
+  fs.writeFileSync(statePath, `${JSON.stringify({ version: 1, workspacePath: missingWorkspace })}\n`, 'utf8');
+  assert.deepEqual(resolveDesktopWorkspace({
+    statePath,
+    fallbackWorkspace
+  }), {
+    workspacePath: path.resolve(fallbackWorkspace),
+    source: 'fallback'
+  });
+  assert.equal(fs.existsSync(missingWorkspace), false, 'A deleted saved workspace must not be recreated.');
+
+  fs.writeFileSync(statePath, '{broken json', 'utf8');
+  assert.deepEqual(resolveDesktopWorkspace({
+    statePath,
+    fallbackWorkspace
+  }), {
+    workspacePath: path.resolve(fallbackWorkspace),
+    source: 'fallback'
+  });
+
+  console.log(JSON.stringify({
+    ok: true,
+    restoredWorkspace: path.resolve(savedWorkspace),
+    invalidSavedWorkspaceFallsBack: true,
+    explicitWorkspaceWins: true
+  }));
+} finally {
+  fs.rmSync(smokeRoot, { recursive: true, force: true });
+}

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

@@ -1020,9 +1020,8 @@ try {
     const patchCard = Array.from(cards).find(card => card.dataset.deviceId === patchTarget.DeviceId);
     const patchPreview = patchCard?.querySelector('[data-remote-fleet-device-preview="tile"]');
     assert.ok(patchPreview);
-    const patchKind = String(patchPreview.dataset.remoteFleetFrameKind || '').toLowerCase() === 'live'
-        ? 'live'
-        : 'thumbnail';
+    assert.notEqual(patchPreview.dataset.remoteFleetFrameKind, 'live');
+    const patchKind = 'thumbnail';
     const patchUrl = `/api/remote/devices/${encodeURIComponent(patchTarget.DeviceId)}/${patchKind}?token=render-smoke-frame&seq=9999`;
     const patchCount = manager.applyRemoteFleetFramePatchesForTest(bodyView, [{
         deviceId: patchTarget.DeviceId,
@@ -1047,168 +1046,13 @@ try {
     assert.equal(patchPreview.querySelector('img[data-remote-fleet-frame-image="true"]')?.dataset.remoteFleetFrameUrl, patchUrl);
     assert.equal(patchPreview.querySelector('[data-remote-fleet-frame-badge="true"]'), null);
 
-    const objectUrlCountBeforeBinary = diagnostics.objectUrlCalls.length;
-    const imageBitmapCountBeforeBinary = diagnostics.imageBitmapCalls.length;
-    const drawCountBeforeBinary = document.canvasDrawCalls.length;
-    const binaryPatchCount = manager.applyRemoteFleetFramePatchesForTest(bodyView, [{
-        deviceId: patchTarget.DeviceId,
-        kind: 'live',
-        frameSeq: 10000,
-        frameUrl: '',
-        streamId: 'render-smoke-binary-live',
-        contentHash: 'render-smoke-binary-live-10000',
-        receivedAt: new Date().toISOString(),
-        _remoteFleetPayloadBlob: new Blob([new Uint8Array([0xff, 0xd8, 0xff, 0xd9])], { type: 'image/jpeg' }),
-        _remoteFleetBinaryFrame: true
-    }]);
-    assert.equal(binaryPatchCount, 1);
-    await wait(20);
-    const binaryCanvas = patchPreview.querySelector('canvas[data-remote-fleet-frame-canvas="true"]');
-    const binaryImage = patchPreview.querySelector('img[data-remote-fleet-frame-image="true"]');
-    assert.equal(patchPreview.dataset.remoteFleetFrameKind, 'live');
-    assert.equal(patchPreview.dataset.remoteFleetFrameSeq, '10000');
-    assert.equal(binaryCanvas?.dataset.remoteFleetFrameSeq, '10000');
-    assert.equal(binaryCanvas?.style.display, 'block');
-    assert.equal(binaryImage?.style.display, 'none');
-    assert.equal(diagnostics.imageBitmapCalls.length, imageBitmapCountBeforeBinary + 1);
-    assert.equal(diagnostics.objectUrlCalls.length, objectUrlCountBeforeBinary);
-    const binaryDrawCalls = document.canvasDrawCalls.slice(drawCountBeforeBinary);
-    assert.ok(
-        binaryDrawCalls.some(call => call.op === 'drawImage'),
-        'expected binary Blob frame to draw directly to canvas');
-    assert.equal(
-        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');
-    liveOverlayCard.dataset.nodeId = 'remote-fleet-render-smoke';
-    liveOverlayCard.dataset.sourceKind = 'live';
-    liveOverlayCard.dataset.liveInteractive = 'true';
-    liveOverlayCard.style.display = 'block';
-    moduleRef._textOverlayV2State.cards.set('selection:remote-fleet-render-smoke', liveOverlayCard);
-    moduleRef._forceUpdateFrames = 0;
-    moduleRef._animationWakeCount = 0;
-    moduleRef._lastAnimationWakeReason = '';
-
-    await wait(20);
-    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',
-            deviceId: patchTarget.DeviceId,
-            kind: 'live',
-            frameSeq: websocketFrameSeq,
-            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 waitFor(
-        () => patchPreview.dataset.remoteFleetFrameSeq === String(websocketFrameSeq)
-    );
-    assert.equal(
-        patchPreview.dataset.remoteFleetFrameSeq,
-        String(websocketFrameSeq),
-        JSON.stringify(diagnostics.runtimeTrace.slice(-12)));
-    assert.ok(
-        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 Mode 4 Atlas WebSocket');
-    assert.equal(
-        diagnostics.webSocketConnections.length,
-        wsCountBeforeRerender,
-        '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"]');
-    assert.ok(rerenderedPatchPreview);
-    assert.equal(rerenderedPatchPreview.dataset.remoteFleetFrameSeq, String(websocketFrameSeq));
-    const rerenderedPatchCanvas = rerenderedPatchPreview.querySelector('canvas[data-remote-fleet-frame-canvas="true"]');
-    assert.equal(rerenderedPatchCanvas?.style.display, 'block');
-    assert.equal(
-        rerenderedPatchCanvas,
-        binaryCanvasBeforeRerender,
-        'MDM rerender should reuse the already-painted canvas instead of flashing a blank replacement');
-
-    const otherBoardNodeId = 'remote-fleet-render-smoke-other-board';
-    const { nodeShell: otherBoardShell, bodyView: otherBoardBodyView } =
-        createRemoteFleetTemplateShell(document, focusedDevice.DeviceId, otherBoardNodeId);
-    document.body.appendChild(otherBoardShell);
-    manager.renderRemoteFleetMonitorForTest(
-        otherBoardBodyView,
-        buildMonitorNode(
-            devices,
-            hub.getStatus({ includeSecrets: true }),
-            latestTaskBatch,
-            recentTaskBatches,
-            '',
-            otherBoardNodeId));
-    await wait(30);
-    const otherBoardPatchPreview = otherBoardBodyView
-        .querySelector(`article[data-device-id="${patchTarget.DeviceId}"]`)
-        ?.querySelector('[data-remote-fleet-device-preview="tile"]');
-    assert.ok(otherBoardPatchPreview);
-    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.atlas.wsOpen'
-        && event.nodeId === otherBoardNodeId));
-    otherBoardShell.remove();
-
     const controlCard = bodyView.querySelector(`article[data-device-id="${patchTarget.DeviceId}"]`);
     assert.ok(controlCard);
     controlCard.dispatchEvent({ type: 'dblclick', button: 0 });
     await wait(30);
     assert.equal(document.body.querySelector('[data-remote-fleet-control-popup="true"]'), null);
-    const addControlNodeCall = dotNetCalls.find(call =>
-        call.methodName === 'AddRemoteFleetDeviceNodeFromJs'
-        && call.args[0] === 'remote-fleet-render-smoke'
-        && call.args[1] === patchTarget.DeviceId);
-    assert.ok(addControlNodeCall, 'double-clicking a screen tile should create a remote workstation canvas node');
+    const addControlNodeCall = dotNetCalls.find(call => call.methodName === 'AddRemoteFleetDeviceNodeFromJs');
+    assert.equal(addControlNodeCall, undefined, 'MDM thumbnails must not create an expanded device node');
 
     const alternateDevice = devices.find(device =>
         device.Connected === true
@@ -1224,10 +1068,20 @@ try {
     assert.equal(selectedAfterClick?.querySelector('[data-remote-fleet-selected-indicator="true"]'), null);
     const livePanel = bodyView.querySelector('[data-remote-fleet-live-panel="true"]');
     assert.equal(livePanel, null);
-    assert.ok(bodyView.querySelector('[data-remote-fleet-action="task-visible"]'));
+    assert.ok(bodyView.querySelector('[data-remote-fleet-action="task-selected"]'));
     assert.ok(bodyView.querySelector('[data-remote-fleet-action="task-connected"]'));
     assert.ok(bodyView.querySelector('[data-remote-fleet-task-input="true"]'));
     assert.ok(bodyView.querySelector('[data-remote-fleet-ai-toggle="true"]'));
+    const selectedTaskInput = bodyView.querySelector('[data-remote-fleet-task-input="true"]');
+    const selectedTaskButton = bodyView.querySelector('[data-remote-fleet-action="task-selected"]');
+    selectedTaskInput.value = 'Inspect Git status and report the result.';
+    selectedTaskButton.dispatchEvent({ type: 'click' });
+    await wait(20);
+    const selectedTaskCall = dotNetCalls.find(call =>
+        call.methodName === 'DispatchRemoteFleetTaskFromJs'
+        && call.args[0] === 'remote-fleet-render-smoke'
+        && call.args[1] === alternateDevice.DeviceId);
+    assert.ok(selectedTaskCall, 'selected thumbnail must target its agent command');
     assert.equal(bodyView.textContent.includes('all devices, no paging'), false);
     assert.equal(bodyView.textContent.includes('Host: Inactive'), false);
     assert.equal(bodyView.textContent.includes('No screen'), false);
@@ -1290,28 +1144,17 @@ try {
     await wait(20);
     const liveStartCalls = dotNetCalls
         .filter(call => call.methodName === 'StartRemoteFleetLiveStreamFromJs');
-    const subscribeMessages = diagnostics.webSocketSends
-        .map(send => {
-            try {
-                return JSON.parse(send.payload);
-            } catch {
-                return null;
-            }
-        })
-        .filter(Boolean);
-    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 Mode 4 Atlas WebSocket');
-    assert.ok(atlasConfigure, 'expected MDM render to configure the Mode 4 Atlas WebSocket');
-    assert.equal(atlasConfigure.fps, 2);
-    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');
+    assert.equal(liveStartCalls.length, 0, 'thumbnail-only MDM must not start live streams');
+    assert.equal(
+        diagnostics.webSocketConnections.some(connection =>
+            String(connection?.url || '').includes('/api/remote/atlas/ws')
+            || String(connection?.url || '').includes('/api/remote/frames/ws')),
+        false,
+        'thumbnail-only MDM must not open live frame WebSockets');
+    assert.equal(
+        diagnostics.fetchCalls.some(call => call.url.includes('/api/status?remoteFrames=ws')),
+        false,
+        'thumbnail-only MDM must not initialize live-frame transport');
     await wait(320);
     assert.ok(dotNetCalls.some(call => call.methodName === 'RefreshRemoteFleetMonitorNodeFromJs'));
     assert.equal(bodyView.dataset.remoteFleetTaskFollowKey, 'render-smoke-batch');
@@ -1321,9 +1164,9 @@ try {
     assert.ok(feedback);
 
     assert.ok(bodyView.querySelector('[data-remote-fleet-ai-toggle="true"]'));
-    assert.equal(dotNetCalls.some(call =>
-        call.methodName === 'DispatchRemoteFleetTaskBatchFromJs'
-        || call.methodName === 'DispatchRemoteFleetTaskFromJs'), false);
+    assert.ok(dotNetCalls.some(call =>
+        call.methodName === 'DispatchRemoteFleetTaskFromJs'
+        && call.args[1] === alternateDevice.DeviceId));
 
     const { nodeShell: emptyShell, bodyView: emptyBody } = createRemoteFleetTemplateShell(document);
     document.body.appendChild(emptyShell);