@mindexec/cli 0.2.444 → 0.2.446

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.444",
+  "version": "0.2.446",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
@@ -25,7 +25,7 @@
   "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 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",
+    "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",
     "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",
@@ -71,10 +71,13 @@
     "ffmpeg-static": "^5.3.0",
     "multer": "^2.2.0",
     "playwright-core": "^1.53.0",
-    "sharp": "^0.33.2",
+    "sharp": "^0.35.3",
     "web-tree-sitter": "^0.22.6",
     "ws": "^8.16.0"
   },
+  "overrides": {
+    "body-parser": "1.20.6"
+  },
   "bin": {
     "mindexec": "launch-bridge.cjs",
     "mind-bridge": "launch-bridge.cjs"

package/remote-hub.js

@@ -212,6 +212,30 @@ function getSupportedRemoteFrameModeProfiles() {
         .map(serializeRemoteFrameModeProfile);
 }
 
+function resolveDeviceRemoteFrameMode(device, requestedMode, fallbackMode = DEFAULT_REMOTE_FRAME_MODE) {
+    const requested = normalizeRemoteFrameMode(requestedMode, fallbackMode);
+    if (device?.frameModesAdvertised === false) {
+        return normalizeRemoteFrameMode(device?.frameProtocol?.defaultMode, DEFAULT_REMOTE_FRAME_MODE);
+    }
+
+    const supportedModes = new Set(
+        (Array.isArray(device?.frameModes) ? device.frameModes : [])
+            .filter(profile => profile?.implemented !== false)
+            .map(profile => normalizeRemoteFrameMode(profile?.mode || profile?.frameMode || profile?.profile, ''))
+            .filter(Boolean));
+
+    if (supportedModes.size === 0 || supportedModes.has(requested)) {
+        return requested;
+    }
+
+    const deviceDefault = normalizeRemoteFrameMode(device?.frameProtocol?.defaultMode, fallbackMode);
+    if (supportedModes.has(deviceDefault)) {
+        return deviceDefault;
+    }
+
+    return supportedModes.values().next().value || normalizeRemoteFrameMode(fallbackMode);
+}
+
 function buildRemoteFrameProtocolDescriptor() {
     return {
         protocol: REMOTE_FRAME_PROTOCOL,
@@ -1125,6 +1149,12 @@ export function createRemoteHub(options = {}) {
     const taskBatches = new Map();
     const sockets = new Map();
     const allSockets = new Set();
+    const sideChannelSockets = {
+        input: new Map(),
+        frame: new Map(),
+        audio: new Map(),
+        file: new Map()
+    };
     const duplicateDeviceLogAt = new Map();
     let server = null;
     let started = false;
@@ -1523,6 +1553,9 @@ export function createRemoteHub(options = {}) {
 
     function closeExistingDeviceSocket(deviceId, nextSessionId) {
         const existing = devices.get(deviceId);
+        for (const channel of Object.keys(sideChannelSockets)) {
+            closeSideChannel(existing, channel, 'replaced-by-new-session');
+        }
         if (!existing?.socket || existing.socket.destroyed) {
             return;
         }
@@ -1537,6 +1570,37 @@ export function createRemoteHub(options = {}) {
         existing.socket.destroy();
     }
 
+    function closeSideChannel(device, channel, reason = `${channel}-socket-closed`) {
+        const socketKey = `${channel}Socket`;
+        const socket = device?.[socketKey];
+        if (!socket) return;
+        device[socketKey] = null;
+        sideChannelSockets[channel]?.delete(socket);
+        try {
+            writeJsonLine(socket, { type: 'disconnect', channel, reason });
+        } catch {
+            // Best-effort notice before closing the side channel.
+        }
+        try {
+            socket.destroy?.();
+        } catch {
+            // Ignore close failures.
+        }
+    }
+
+    function detachSideChannel(socket, channel, reason = `${channel}-socket-closed`) {
+        const channelMap = sideChannelSockets[channel];
+        const deviceId = channelMap?.get(socket);
+        channelMap?.delete(socket);
+        if (!deviceId) return;
+        const device = devices.get(deviceId);
+        const socketKey = `${channel}Socket`;
+        if (!device || device[socketKey] !== socket) return;
+        device[socketKey] = null;
+        device[`${channel}LastSeenAt`] = new Date().toISOString();
+        emitRemoteEvent(`Remote${channel[0].toUpperCase()}${channel.slice(1)}SocketDisconnected`, device, { reason });
+    }
+
     function getDeviceActivityMs(device) {
         return Math.max(
             Date.parse(device?.lastSeenAt || '') || 0,
@@ -1841,6 +1905,7 @@ export function createRemoteHub(options = {}) {
             protocolVersion: Number.isFinite(Number(hello.protocolVersion)) ? Math.max(1, Math.floor(Number(hello.protocolVersion))) : 1,
             frameProtocol: frameProtocol || buildRemoteFrameProtocolDescriptor(),
             frameModes: frameModes.length > 0 ? frameModes : getSupportedRemoteFrameModeProfiles(),
+            frameModesAdvertised: frameModes.length > 0,
             capabilities,
             connected: true,
             connectedAt: now,
@@ -1853,6 +1918,10 @@ export function createRemoteHub(options = {}) {
             status: {},
             latestThumbnail: null,
             latestLiveFrame: null,
+            inputSocket: null,
+            frameSocket: null,
+            audioSocket: null,
+            fileSocket: null,
             recentFramePayloads: {
                 thumbnail: [],
                 live: []
@@ -1885,6 +1954,40 @@ export function createRemoteHub(options = {}) {
         return device;
     }
 
+    function attachSideChannel(socket, hello, channel) {
+        const deviceId = normalizeDeviceId(hello.deviceId);
+        const device = devices.get(deviceId);
+        if (!device || !device.connected || !device.socket || device.socket.destroyed) {
+            writeJsonLine(socket, { type: 'error', error: 'device-not-connected' });
+            socket.destroy();
+            return null;
+        }
+
+        closeSideChannel(device, channel, `replaced-by-new-${channel}-socket`);
+        const now = new Date().toISOString();
+        device[`${channel}Socket`] = socket;
+        device[`${channel}ConnectedAt`] = now;
+        device[`${channel}LastSeenAt`] = now;
+        sideChannelSockets[channel].set(socket, deviceId);
+        writeJsonLine(socket, {
+            type: 'welcome',
+            channel,
+            protocol: REMOTE_AGENT_PROTOCOL,
+            protocolVersion: REMOTE_PROTOCOL_VERSION,
+            sessionId: device.sessionId,
+            deviceId,
+            ...(channel === 'frame'
+                ? {
+                    frameProtocol: buildRemoteFrameProtocolDescriptor(),
+                    frameModes: getSupportedRemoteFrameModeProfiles()
+                }
+                : {}),
+            serverTime: now
+        });
+        emitRemoteEvent(`Remote${channel[0].toUpperCase()}${channel.slice(1)}SocketConnected`, device);
+        return device;
+    }
+
     function detachSocket(socket, reason = 'socket-closed') {
         const deviceId = sockets.get(socket);
         sockets.delete(socket);
@@ -1906,6 +2009,9 @@ export function createRemoteHub(options = {}) {
             device.activeLiveStream.stoppedAt = device.disconnectedAt;
             device.activeLiveStream.stopReason = reason;
         }
+        for (const channel of Object.keys(sideChannelSockets)) {
+            closeSideChannel(device, channel, reason);
+        }
         failAllPendingTasks(device, 'device-disconnected');
         logWarn('remote', `device disconnected ${device.deviceName} (${deviceId}): ${reason}`);
         emitRemoteEvent('RemoteDeviceDisconnected', device, { reason });
@@ -2570,6 +2676,16 @@ export function createRemoteHub(options = {}) {
                 return;
             }
 
+            const channel = safeString(message.channel || message.Channel, 40).toLowerCase();
+            if (Object.hasOwn(sideChannelSockets, channel)) {
+                const device = attachSideChannel(socket, message, channel);
+                if (!device) return;
+                state.authenticated = true;
+                state.device = device;
+                state.sideChannel = channel;
+                return;
+            }
+
             const device = attachDevice(socket, message);
             if (!device) {
                 return;
@@ -2586,6 +2702,17 @@ export function createRemoteHub(options = {}) {
             return;
         }
 
+        if (state.sideChannel) {
+            device[`${state.sideChannel}LastSeenAt`] = new Date().toISOString();
+            if (state.sideChannel === 'input' && message.type === 'input.error') {
+                emitRemoteEvent('RemoteInputError', device, {
+                    inputSeq: Number(message.inputSeq || 0) || 0,
+                    error: safeString(message.error, 600) || 'remote-input-failed'
+                });
+            }
+            return;
+        }
+
         device.counters.messagesReceived += 1;
         device.lastSeenAt = new Date().toISOString();
 
@@ -2698,7 +2825,11 @@ export function createRemoteHub(options = {}) {
         const detach = reason => {
             allSockets.delete(socket);
             clearTimeout(helloTimer);
-            detachSocket(socket, reason);
+            if (state.sideChannel) {
+                detachSideChannel(socket, state.sideChannel, reason);
+            } else {
+                detachSocket(socket, reason);
+            }
         };
 
         socket.onCloseMessage = reason => detach(reason || 'websocket-closed');
@@ -2867,12 +2998,20 @@ export function createRemoteHub(options = {}) {
         socket.on('close', () => {
             allSockets.delete(socket);
             clearTimeout(helloTimer);
-            detachSocket(socket);
+            if (state.sideChannel) {
+                detachSideChannel(socket, state.sideChannel);
+            } else {
+                detachSocket(socket);
+            }
         });
         socket.on('error', err => {
             allSockets.delete(socket);
             clearTimeout(helloTimer);
-            detachSocket(socket, err?.message || 'socket-error');
+            if (state.sideChannel) {
+                detachSideChannel(socket, state.sideChannel, err?.message || 'socket-error');
+            } else {
+                detachSocket(socket, err?.message || 'socket-error');
+            }
         });
     }
 
@@ -2936,6 +3075,7 @@ export function createRemoteHub(options = {}) {
         }
 
         sockets.clear();
+        Object.values(sideChannelSockets).forEach(channelMap => channelMap.clear());
         if (!server) {
             started = false;
             return;
@@ -3058,10 +3198,29 @@ export function createRemoteHub(options = {}) {
             return { ok: false, error: 'missing-input-type' };
         }
 
+        const inputSocket = device.inputSocket;
+        if (inputSocket && !inputSocket.destroyed) {
+            const sent = writeJsonLine(inputSocket, {
+                type: 'input.control',
+                payload: {
+                    ...normalized,
+                    hubForwardedAtEpochMs: Date.now(),
+                    issuedAt: normalized.issuedAt || new Date().toISOString()
+                }
+            });
+            if (sent) {
+                device.counters.commandsSent += 1;
+                device.inputLastSeenAt = new Date().toISOString();
+                return { ok: true, inputSocket: true };
+            }
+            detachSideChannel(inputSocket, 'input', 'input-socket-write-failed');
+        }
+
         return sendCommand(deviceId, {
             command: 'input.control',
             payload: {
                 ...normalized,
+                hubForwardedAtEpochMs: Date.now(),
                 issuedAt: normalized.issuedAt || new Date().toISOString()
             }
         });
@@ -3285,7 +3444,10 @@ export function createRemoteHub(options = {}) {
             const now = new Date().toISOString();
             const streamId = safeString(options.streamId, 128) || `live-${Date.now()}`;
             const streamPurpose = safeString(options.streamPurpose, 32).toLowerCase();
-            const requestedMode = options.mode || (streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo');
+            const requestedMode = resolveDeviceRemoteFrameMode(
+                device,
+                options.mode || (streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo'),
+                streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo');
             const fps = clampNumber(options.fps, 1, 30, streamPurpose === 'control' ? 30 : 20);
             const commandId = safeString(options.commandId, 128) || crypto.randomUUID();
             const transfer = buildRemoteFrameTransferDescriptor(requestedMode, streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo');
@@ -3342,7 +3504,10 @@ export function createRemoteHub(options = {}) {
         const now = new Date().toISOString();
         const streamId = safeString(options.streamId, 128) || `live-${Date.now()}`;
         const streamPurpose = safeString(options.streamPurpose, 32).toLowerCase();
-        const requestedMode = options.mode || (streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo');
+        const requestedMode = resolveDeviceRemoteFrameMode(
+            device,
+            options.mode || (streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo'),
+            streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo');
         const fps = clampNumber(options.fps, 1, 30, streamPurpose === 'control' ? 30 : 20);
         const commandId = safeString(options.commandId, 128) || crypto.randomUUID();
         const transfer = buildRemoteFrameTransferDescriptor(requestedMode, streamPurpose === 'control' ? 'mode3-h264-hw' : 'mode2-lzo');

package/scripts/remote-fast-live-rate-smoke.mjs

@@ -293,6 +293,7 @@ async function main() {
         const live = await fetchJson(`${hostBridge.baseUrl}/api/remote/devices/${encodeURIComponent(device.deviceId)}/live/start`, {
             method: 'POST',
             body: JSON.stringify({
+                mode: 'remote-fast',
                 fps: REQUESTED_FPS,
                 maxWidth: 960,
                 maxHeight: 540,

package/server.js

@@ -2751,16 +2751,16 @@ function buildRemoteFrameBinaryPacket(frameEvent) {
         timestampUs: Number.isFinite(Number(frame.timestampUs)) ? Number(frame.timestampUs) : 0,
         durationUs: Number.isFinite(Number(frame.durationUs)) ? Number(frame.durationUs) : 0,
         streamFrameSeq: Number.isFinite(Number(frame.streamFrameSeq)) ? Number(frame.streamFrameSeq) : 0,
-        commandId: frame.commandId || ''
-        ,layoutVersion: Number(frame.layoutVersion || 0) || 0
-        ,atlasComposeMs: Number(frame.atlasComposeMs || 0) || 0
-        ,atlasPoolStarved: Number(frame.atlasPoolStarved || 0) || 0
-        ,atlasReadyTiles: Number(frame.atlasReadyTiles || 0) || 0
-        ,atlasTileCount: Number(frame.atlasTileCount || 0) || 0
-        ,hardwareEncoder: frame.hardwareEncoder || ''
-        ,platformProfile: frame.platformProfile || ''
-        ,workerGeneration: Number(frame.workerGeneration || 0) || 0
-        ,encoderGeneration: Number(frame.encoderGeneration || 0) || 0
+        commandId: frame.commandId || '',
+        layoutVersion: Number(frame.layoutVersion || 0) || 0,
+        atlasComposeMs: Number(frame.atlasComposeMs || 0) || 0,
+        atlasPoolStarved: Number(frame.atlasPoolStarved || 0) || 0,
+        atlasReadyTiles: Number(frame.atlasReadyTiles || 0) || 0,
+        atlasTileCount: Number(frame.atlasTileCount || 0) || 0,
+        hardwareEncoder: frame.hardwareEncoder || '',
+        platformProfile: frame.platformProfile || '',
+        workerGeneration: Number(frame.workerGeneration || 0) || 0,
+        encoderGeneration: Number(frame.encoderGeneration || 0) || 0
     };
     const metaBuffer = Buffer.from(JSON.stringify(metadata), 'utf8');
     const header = Buffer.allocUnsafe(4);
@@ -4354,7 +4354,7 @@ function appendRemoteAgentOutput(stream, chunk, stateConnectionKey = '') {
     const text = chunk.toString();
     const key = stream === 'stderr' ? 'stderrTail' : 'stdoutTail';
     remoteAgentState[key] = String((remoteAgentState[key] || '') + text).slice(-REMOTE_AGENT_STDIO_TAIL_CHARS);
-    if (/Connected to RemoteHub/i.test(text)) {
+    if (/Connected to (?:RemoteHub|LiveDesk Hub)/i.test(text)) {
         remoteAgentState.ready = true;
         remoteAgentState.connectedAt = new Date().toISOString();
         remoteAgentState.needsReconnect = false;
@@ -5222,7 +5222,7 @@ function appendRemoteAgentAttemptOutput(attempt, stream, chunk) {
     const text = chunk.toString();
     const key = stream === 'stderr' ? 'stderrTail' : 'stdoutTail';
     attempt.state[key] = String((attempt.state[key] || '') + text).slice(-REMOTE_AGENT_STDIO_TAIL_CHARS);
-    if (/Connected to RemoteHub/i.test(text)) {
+    if (/Connected to (?:RemoteHub|LiveDesk Hub)/i.test(text)) {
         attempt.state.ready = true;
         attempt.state.connectedAt = new Date().toISOString();
         attempt.state.needsReconnect = false;

package/wwwroot/_content/MindExecution.Shared/js/mind-map-css3d-manager.js

@@ -44,6 +44,7 @@
     const NODE_VIEW_HOST_HYBRID = 'hybrid';
     const NODE_VIEW_RENDERER_VERSION = 'shared-node-view-v1';
     const CSS3D_ONLY_NODE_RENDERING = true;
+    const NATIVE_TEXT_SELECTION_CONTENT_SELECTORS = '.node-response, .code-body, .text-content, .markdown-body, .csv-table-scroll, .csv-table-cell, textarea, .map-node-memo__title, .map-node-memo__body, .map-node-memo__body-view, .map-node-memo__body-view *';
     const CSV_TABLE_MAX_RENDER_ROWS = 500;
     const CSV_TABLE_MAX_RENDER_COLUMNS = 80;
     const REMOTE_FLEET_DISPLAY_NAME = 'Multi Desktop Monitor';
@@ -826,6 +827,19 @@
                 cursor: grab;
             }
 
+            .css3d-resolution-wrapper.is-text-selection-owner .node-response,
+            .css3d-resolution-wrapper.is-text-selection-owner .code-body,
+            .css3d-resolution-wrapper.is-text-selection-owner .text-content,
+            .css3d-resolution-wrapper.is-text-selection-owner .markdown-body,
+            .css3d-resolution-wrapper.is-text-selection-owner .csv-table-scroll,
+            .css3d-resolution-wrapper.is-text-selection-owner textarea,
+            .css3d-resolution-wrapper.is-text-selection-owner .map-node-memo__title,
+            .css3d-resolution-wrapper.is-text-selection-owner .map-node-memo__body,
+            .css3d-resolution-wrapper.is-text-selection-owner .map-node-memo__body-view {
+                user-select: text !important;
+                -webkit-user-select: text !important;
+            }
+
             .css3d-resolution-wrapper.node-type-image,
             .css3d-resolution-wrapper.node-type-video,
             .css3d-resolution-wrapper.node-type-embed,
@@ -5160,6 +5174,38 @@
         return activeId === String(nodeId || '').trim();
     }
 
+    function setNativeTextSelectionOwnerClass(module, nodeId = null) {
+        if (!module) return false;
+        const nextId = String(nodeId || '').trim();
+        const previousId = String(module._nativeTextSelectionOwnerNodeId || '').trim();
+        if (previousId === nextId) return true;
+
+        const getWrapper = id => {
+            const entry = id ? module.nodeObjectsById?.get?.(id) : null;
+            return entry?.cssObject?.element?.closest?.('.css3d-resolution-wrapper')
+                || entry?.cssObject?.element
+                || null;
+        };
+        const previousWrapper = getWrapper(previousId);
+        previousWrapper?.classList?.remove?.('is-text-selection-owner');
+        if (previousWrapper?.querySelectorAll) {
+            previousWrapper.querySelectorAll(NATIVE_TEXT_SELECTION_CONTENT_SELECTORS).forEach(element => {
+                element.style.userSelect = 'none';
+                element.style.webkitUserSelect = 'none';
+            });
+        }
+        const nextWrapper = getWrapper(nextId);
+        nextWrapper?.classList?.add?.('is-text-selection-owner');
+        if (nextWrapper?.querySelectorAll) {
+            nextWrapper.querySelectorAll(NATIVE_TEXT_SELECTION_CONTENT_SELECTORS).forEach(element => {
+                element.style.userSelect = 'text';
+                element.style.webkitUserSelect = 'text';
+            });
+        }
+        module._nativeTextSelectionOwnerNodeId = nextId || null;
+        return true;
+    }
+
     function activateNativeTextSelectionSource(module, nodeId) {
         const id = String(nodeId || '').trim();
         if (!module || !id) {
@@ -5167,6 +5213,7 @@
         }
 
         module._nativeTextSelectionSourceNodeId = id;
+        setNativeTextSelectionOwnerClass(module, id);
         ensureTextOverlaySourceVisible(module, id);
         return true;
     }
@@ -5179,6 +5226,7 @@
         }
 
         module._nativeTextSelectionSourceNodeId = null;
+        setNativeTextSelectionOwnerClass(module, null);
         return true;
     }
 
@@ -14923,6 +14971,7 @@
     const remoteFleetHostLeaseTimers = new Map();
     const remoteFleetLocalHostTargets = new Map();
     const remoteFleetBinaryFrameSessions = new Map();
+    const remoteFleetAtlasSessions = new Map();
     const remoteFleetLatestBinaryFrames = new Map();
     const remoteFleetFrameBlobCache = new Map();
     let remoteFleetBridgeStatusPromise = null;
@@ -15137,6 +15186,7 @@
         closeRemoteFleetControlNodeSession(bodyView, 'clear');
         if (options.keepBinaryFrameSocket !== true) {
             releaseRemoteFleetBinaryFrameSocket(bodyView);
+            releaseRemoteFleetAtlasSocket(bodyView);
         }
         if (bodyView._remoteFleetLiveRefreshTimer) {
             clearInterval(bodyView._remoteFleetLiveRefreshTimer);
@@ -15252,6 +15302,17 @@
         return url.toString();
     }
 
+    function buildRemoteFleetAtlasWsUrl(status) {
+        const baseUrl = String(status?.__remoteFleetBridgeBaseUrl || window.location?.origin || '').trim();
+        const path = String(status?.remoteAtlasWsPath || '/api/remote/atlas/ws').trim() || '/api/remote/atlas/ws';
+        if (!baseUrl) return '';
+        const url = new URL(path, baseUrl);
+        url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+        const bridgeToken = String(status?.bridgeToken || '').trim();
+        if (bridgeToken) url.searchParams.set('token', bridgeToken);
+        return url.toString();
+    }
+
     async function parseRemoteFleetBinaryFrameMessage(data) {
         let buffer = null;
         if (data instanceof ArrayBuffer) {
@@ -15923,6 +15984,100 @@
         }
     }
 
+    function paintRemoteFleetAtlasFrame(session, frame) {
+        const atlasCanvas = session?.atlasCanvas;
+        const tiles = Array.isArray(session?.layout?.tiles) ? session.layout.tiles : [];
+        if (!atlasCanvas || tiles.length === 0) return;
+        const targets = new Set();
+        session.bodies.forEach(body => getRemoteFleetFramePatchTargets(body).forEach(target => targets.add(target)));
+        const tileByDevice = new Map(tiles.map(tile => [String(tile.deviceId || '').trim(), tile]));
+        targets.forEach(target => {
+            target.querySelectorAll('[data-remote-fleet-device-preview]').forEach(preview => {
+                const tile = tileByDevice.get(String(preview.dataset.deviceId || '').trim());
+                if (!tile) return;
+                const canvas = ensureRemoteFleetFrameCanvas(preview);
+                const width = Math.max(1, Number(tile.width || 0) | 0);
+                const height = Math.max(1, Number(tile.height || 0) | 0);
+                canvas.width = width;
+                canvas.height = height;
+                const context = canvas.getContext('2d', { alpha: false, desynchronized: true });
+                context?.drawImage(atlasCanvas, Number(tile.x || 0), Number(tile.y || 0), width, height, 0, 0, width, height);
+                canvas.style.display = 'block';
+                const image = preview.querySelector?.('img[data-remote-fleet-frame-image="true"]');
+                if (image) image.style.display = 'none';
+                preview.dataset.remoteFleetFrameKind = 'live';
+                preview.dataset.remoteFleetFrameSeq = String(frame.frameSeq || 0);
+                preview.dataset.remoteFleetFrameUrl = '';
+                preview.dataset.remoteFleetHasFrame = 'true';
+            });
+        });
+        window.RuntimeTrace?.emit?.('remote.atlas.painted', { nodeId: session.nodeId, frameSeq: frame.frameSeq || 0, tiles: tiles.length });
+    }
+
+    function startRemoteFleetAtlasSocket(bodyView, getDeviceIds, options = {}) {
+        const nodeId = String(bodyView?.dataset?.nodeId || '').trim();
+        if (!nodeId || typeof WebSocket !== 'function') return false;
+        let session = remoteFleetAtlasSessions.get(nodeId);
+        if (!session) {
+            session = { nodeId, bodies: new Set(), ws: null, wsOpening: false, getDeviceIds: null, layout: null, atlasCanvas: document.createElement('canvas'), fallbackStarted: false };
+            remoteFleetAtlasSessions.set(nodeId, session);
+        }
+        session.bodies.add(bodyView);
+        session.getDeviceIds = getDeviceIds;
+        session.options = { fps: 20, width: Number(options.width || 1920) || 1920, height: Number(options.height || 1080) || 1080, tileWidth: Number(options.tileWidth || 320) || 320, tileHeight: Number(options.tileHeight || 180) || 180 };
+        const fallback = () => {
+            if (session.fallbackStarted) return;
+            session.fallbackStarted = true;
+            try { session.ws?.close?.(); } catch { /* encoder failure fallback */ }
+            session.bodies.forEach(body => startRemoteFleetBinaryFrameSocket(body, session.getDeviceIds, { autoStartLive: true, fps: 20, maxWidth: 960, maxHeight: 540, quality: 60, mode: 'mode2-lzo', streamPurpose: 'wall' }));
+            window.RuntimeTrace?.emit?.('remote.atlas.fallback', { nodeId: session.nodeId, mode: 'mode2-lzo' });
+        };
+        session.fallback = fallback;
+        if (session.ws || session.wsOpening) return true;
+        session.wsOpening = true;
+        getRemoteFleetBridgeStatusForFrames().then(status => {
+            const wsUrl = buildRemoteFleetAtlasWsUrl(status);
+            if (!wsUrl) throw new Error('remote-atlas-ws-url-unavailable');
+            const ws = new WebSocket(wsUrl);
+            session.ws = ws;
+            ws.binaryType = 'arraybuffer';
+            ws.onopen = () => {
+                session.wsOpening = false;
+                ws.send(JSON.stringify({ type: 'configure', deviceIds: getRemoteFleetBinaryFrameDeviceIds(session), fps: 20, width: session.options.width, height: session.options.height, tileWidth: session.options.tileWidth, tileHeight: session.options.tileHeight }));
+                window.RuntimeTrace?.emit?.('remote.atlas.wsOpen', { nodeId: session.nodeId });
+            };
+            ws.onmessage = event => {
+                if (typeof event.data === 'string') {
+                    try {
+                        const payload = JSON.parse(event.data);
+                        if (payload?.type === 'Mode4AtlasLayout') session.layout = payload;
+                        if (payload?.type === 'Mode4AtlasStatus' && (payload.state === 'error' || payload.error)) fallback();
+                    } catch { /* ignore status text */ }
+                    return;
+                }
+                parseRemoteFleetBinaryFrameMessage(event.data).then(frame => {
+                    if (!frame || String(frame.frameMode || frame.mode || '').toLowerCase() !== 'mode4-h264-atlas') return;
+                    session.atlasCanvas.width = Number(frame.width || session.options.width) || session.options.width;
+                    session.atlasCanvas.height = Number(frame.height || session.options.height) || session.options.height;
+                    window.MindExecRemoteCodecs?.decodeH264Frame?.(session.atlasCanvas, frame, () => paintRemoteFleetAtlasFrame(session, frame));
+                }).catch(() => undefined);
+            };
+            ws.onerror = () => { fallback(); try { ws.close(); } catch {} };
+            ws.onclose = () => { session.wsOpening = false; if (session.ws === ws) session.ws = null; if (!session.fallbackStarted) fallback(); };
+        }).catch(error => { session.wsOpening = false; fallback(); window.RuntimeTrace?.emit?.('remote.atlas.wsOpenFailed', { nodeId, error: error?.message || String(error || '') }); });
+        return true;
+    }
+
+    function releaseRemoteFleetAtlasSocket(bodyView) {
+        const nodeId = String(bodyView?.dataset?.nodeId || '').trim();
+        const session = nodeId ? remoteFleetAtlasSessions.get(nodeId) : null;
+        if (!session) return;
+        session.bodies.delete(bodyView);
+        if (session.bodies.size > 0) return;
+        try { session.ws?.close?.(); } catch {}
+        remoteFleetAtlasSessions.delete(nodeId);
+    }
+
     function startRemoteFleetBinaryFrameSocket(bodyView, getDeviceIds, options = {}) {
         const nodeId = String(bodyView?.dataset?.nodeId || '').trim();
         if (!nodeId || typeof WebSocket !== 'function') {
@@ -20712,22 +20867,20 @@
             || hasActiveLiveStream
             || (autoMonitorState && hasVisibleFrameTarget);
         if (shouldUseBinaryFrameSocket) {
-            const binaryFrameSocketStarted = startRemoteFleetBinaryFrameSocket(bodyView, () => {
+            const atlasSocketStarted = startRemoteFleetAtlasSocket(bodyView, () => {
                 const liveIds = getVisibleLiveFrameDeviceIds();
                 return liveIds.length > 0 ? liveIds : getVisibleFrameDeviceIds();
             }, {
-                autoStartLive: true,
                 fps: REMOTE_FLEET_MONITOR_LIVE_FPS,
-                maxWidth: 960,
-                maxHeight: 540,
-                quality: 60,
-                mode: 'mode2-lzo',
-                streamPurpose: 'wall'
+                width: 1920,
+                height: 1080,
+                tileWidth: 320,
+                tileHeight: 180
             });
-            if (!binaryFrameSocketStarted) {
+            if (!atlasSocketStarted) {
                 window.RuntimeTrace?.emit?.('remote.frame.wsUnavailable', {
                     nodeId,
-                    reason: 'binary-frame-socket-not-started'
+                    reason: 'atlas-frame-socket-not-started'
                 });
                 ensureVisibleRemoteFleetLiveStreams().catch(error => {
                     window.RuntimeTrace?.emit?.('remote.live.autoStartFailed', {
@@ -20738,7 +20891,7 @@
             } else {
                 window.RuntimeTrace?.emit?.('remote.live.wsAutoStartRequested', {
                     nodeId,
-                    transport: 'ws-binary',
+                    transport: 'ws-atlas-h264',
                     fps: REMOTE_FLEET_MONITOR_LIVE_FPS,
                     visibleFrameTargets: visibleFrameDeviceIds.length,
                     visibleLiveTargets: getVisibleLiveFrameDeviceIds().length
@@ -20758,6 +20911,7 @@
             }, REMOTE_FLEET_LIVE_REFRESH_MS);
         } else {
             releaseRemoteFleetBinaryFrameSocket(bodyView);
+            releaseRemoteFleetAtlasSocket(bodyView);
             if (autoMonitorState && hasMonitorTargets) {
                 startRemoteFleetFrameLoop(bodyView, REMOTE_FLEET_THUMBNAIL_FRAME_REFRESH_MS, () => refreshRemoteFleetVisibleFrames(true));
                 startRemoteFleetMonitorRefreshTimer(REMOTE_FLEET_MONITOR_REFRESH_MS, 'visible-devices');
@@ -25016,6 +25170,7 @@
     window.MindMapCss3DManager = {
         activateSelectableTextOverlay: activateSelectableTextOverlay,
         activateNativeTextSelectionSource: activateNativeTextSelectionSource,
+        setNativeTextSelectionOwnerClass: setNativeTextSelectionOwnerClass,
         beginNodeEditingOverlay: beginNodeEditingOverlay,
         bindMemoWheelRouting: bindMemoWheelRouting,
         bindNoteEditingWheelZoom: bindNoteEditingWheelZoom,