@midscene/computer 1.9.2-beta-20260608084200.0 → 1.9.2

package/dist/lib/cli.js

@@ -376,9 +376,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('computer:device');
+const warnDevice = (0, logger_namespaceObject.getDebug)('computer:device', {
+    console: true
+});
 const debugComputerInput = (0, logger_namespaceObject.getDebug)('computer:input', {
     console: true
 });
+const WINDOWS_UIPI_DOC_URL = 'https://midscenejs.com/computer-getting-started#windows-clicks-have-no-effect-on-some-apps';
 function resolvePackageRoot(helperName) {
     const require1 = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
     let pkgRoot = null;
@@ -418,6 +422,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = (0, external_node_fs_namespaceObject.statSync)(binPath);
+        if ((73 & st.mode) === 0) {
+            (0, external_node_fs_namespaceObject.chmodSync)(binPath, 493);
+            debugDevice('phased-scroll: restored executable bit on', binPath);
+        }
+    } catch (err) {
+        debugDevice('phased-scroll: chmod self-heal failed', err);
+    }
     phasedScrollBinaryPath = binPath;
     return binPath;
 }
@@ -545,9 +558,10 @@ function runPhasedScroll(direction, pixels, steps) {
         if (0 === res.status) return true;
         if (!phasedScrollExecWarned) {
             phasedScrollExecWarned = true;
-            console.warn(`[@midscene/computer] phased-scroll helper exited with status ${res.status}; falling back to keyboard/libnut. This usually means Accessibility permission has not been granted to the host process.`);
+            const hint = null === res.status ? `signal ${res.signal ?? 'unknown'}; the binary may not be executable (npm tarball extraction can drop the +x bit) or may be blocked by quarantine. Try: chmod +x "${bin}"` : 'this usually means Accessibility permission has not been granted to the host process (System Settings → Privacy & Security → Accessibility)';
+            console.warn(`[@midscene/computer] phased-scroll helper failed (exit=${res.status}, signal=${res.signal ?? 'none'}); falling back to keyboard/libnut. ${hint}`);
         }
-        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        debugDevice('phased-scroll exited non-zero', res.status, res.signal, res.error);
         return false;
     } catch (err) {
         if (!phasedScrollExecWarned) {
@@ -668,7 +682,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.2-beta-20260608084200.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -696,13 +710,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
         const deltaY = Math.abs(movedPos.y - targetY);
         if (deltaX > 5 || deltaY > 5) {
             const msg = `[HealthCheck] WARNING: Mouse control may not be working. Expected (${targetX}, ${targetY}), got (${movedPos.x}, ${movedPos.y}), delta=(${deltaX}, ${deltaY})`;
-            console.warn(msg);
-            debugDevice(msg);
-            if ('win32' === process.platform && !this.isRunningAsAdmin()) {
-                const hint = "Midscene is NOT running as Administrator. Windows blocks mouse/keyboard input to elevated (admin) applications from non-admin processes (UIPI). Please run your terminal or Node.js as Administrator and try again.";
-                console.error(`\n[HealthCheck] ${hint}\n`);
-                debugDevice(hint);
-            }
+            warnDevice(msg);
+        }
+        if ('win32' === process.platform && !this.isRunningAsAdmin()) {
+            const hint = [
+                'Heads-up: Midscene is not running as Administrator.',
+                'If clicks or key presses have no effect while the cursor still moves to the right position,',
+                `see the Windows permission troubleshooting guide: ${WINDOWS_UIPI_DOC_URL}`
+            ].join(' ');
+            warnDevice(`[HealthCheck] ${hint}`);
         }
         this.inputDriver.moveMouse(startPos.x, startPos.y);
         console.log(`[HealthCheck] Mouse restored to (${startPos.x}, ${startPos.y})`);
@@ -719,14 +735,16 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     isRunningAsAdmin() {
         if ('win32' !== process.platform) return false;
+        if (void 0 !== this.adminCheckCache) return this.adminCheckCache;
         try {
             (0, external_node_child_process_namespaceObject.execSync)('net session', {
                 stdio: 'pipe'
             });
-            return true;
+            this.adminCheckCache = true;
         } catch  {
-            return false;
+            this.adminCheckCache = false;
         }
+        return this.adminCheckCache;
     }
     async screenshotBase64() {
         if (this.destroyed) throw new Error('ComputerDevice has been destroyed');
@@ -971,6 +989,7 @@ Original error: ${lastRawMessage}`);
             debug: (message)=>debugDevice(message)
         }));
         device_define_property(this, "useAppleScript", void 0);
+        device_define_property(this, "adminCheckCache", void 0);
         device_define_property(this, "uri", void 0);
         device_define_property(this, "inputPrimitives", {
             pointer: {
@@ -1121,24 +1140,6 @@ function createPlatformActions() {
         })
     };
 }
-function normalizeRdpHost(host) {
-    const trimmed = host.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('[') && trimmed.endsWith(']') && trimmed.includes(':')) return trimmed.slice(1, -1);
-    return trimmed;
-}
-function formatRdpHost(host) {
-    const normalizedHost = normalizeRdpHost(host);
-    return normalizedHost.includes(':') ? `[${normalizedHost}]` : normalizedHost;
-}
-function formatRdpServerAddress(host, port) {
-    return `${formatRdpHost(host)}:${port}`;
-}
-function normalizeRdpConnectionConfig(config) {
-    return {
-        ...config,
-        host: normalizeRdpHost(config.host)
-    };
-}
 const external_node_events_namespaceObject = require("node:events");
 const external_node_readline_namespaceObject = require("node:readline");
 const platformBinaryMap = {
@@ -1194,7 +1195,7 @@ class HelperProcessRDPBackendClient {
         await this.ensureHelperStarted();
         const response = await this.send({
             type: 'connect',
-            config: normalizeRdpConnectionConfig(config)
+            config
         });
         if ('connected' !== response.type) throw new Error(`Expected connected response, got ${response.type}`);
         this.connected = true;
@@ -1468,10 +1469,9 @@ const DEFAULT_SCROLL_STEP_AMOUNT = 120;
 class RDPDevice {
     describe() {
         const port = this.options.port || 3389;
-        const server = formatRdpServerAddress(this.options.host, port);
         const username = this.options.username ? ` as ${this.options.username}` : '';
         const session = this.connectionInfo?.sessionId ? ` [session ${this.connectionInfo.sessionId}]` : '';
-        return `RDP Device ${server}${username}${session}`;
+        return `RDP Device ${this.options.host}:${port}${username}${session}`;
     }
     async connect() {
         this.throwIfDestroyed();
@@ -1511,11 +1511,10 @@ class RDPDevice {
                 call: async ()=>{
                     this.assertConnected();
                     const size = await this.size();
-                    const server = this.connectionInfo?.server || formatRdpServerAddress(this.options.host, this.options.port || 3389);
                     return [
                         {
                             id: this.connectionInfo?.sessionId || this.options.host,
-                            name: `RDP ${server} (${size.width}x${size.height})`,
+                            name: `RDP ${this.connectionInfo?.server || this.options.host} (${size.width}x${size.height})`,
                             primary: true
                         }
                     ];
@@ -1713,12 +1712,11 @@ class RDPDevice {
                 }
             }
         });
-        const normalizedOptions = normalizeRdpConnectionConfig(options);
         this.options = {
             port: 3389,
             securityProtocol: 'auto',
             ignoreCertificate: false,
-            ...normalizedOptions
+            ...options
         };
         this.backend = options.backend || createDefaultRDPBackendClient();
     }
@@ -1796,11 +1794,10 @@ function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
     if (extracted.host) {
         const { displayId: _d, headless: _h, ...rdpFields } = extracted;
-        const host = normalizeRdpHost(extracted.host);
         return {
             mode: 'rdp',
             ...rdpFields,
-            host
+            host: extracted.host
         };
     }
     return {
@@ -1816,15 +1813,15 @@ function shouldRetargetAgent(opts) {
 }
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
-        const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
+        const portSuffix = opts.port ? `:${opts.port}` : '';
         const userSuffix = opts.username ? ` as ${opts.username}` : '';
-        return ` via RDP (${target}${userSuffix})`;
+        return ` via RDP (${opts.host}${portSuffix}${userSuffix})`;
     }
     if (opts?.mode === 'local' && opts.displayId) return ` (Display: ${opts.displayId})`;
     return ' (Primary display)';
 }
 function getCliReportSessionTarget(opts) {
-    if (opts?.mode === 'rdp') return `rdp:${formatRdpHost(opts.host)}`;
+    if (opts?.mode === 'rdp') return `rdp:${opts.host}`;
     if (opts?.mode === 'local' && opts.displayId) return opts.displayId;
     return 'primary';
 }
@@ -1942,7 +1939,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 const tools = new ComputerMidsceneTools();
 (0, cli_namespaceObject.runToolsCLI)(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.2-beta-20260608084200.0",
+    version: "1.9.2",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -403,9 +403,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('computer:device');
+const warnDevice = (0, logger_namespaceObject.getDebug)('computer:device', {
+    console: true
+});
 const debugComputerInput = (0, logger_namespaceObject.getDebug)('computer:input', {
     console: true
 });
+const WINDOWS_UIPI_DOC_URL = 'https://midscenejs.com/computer-getting-started#windows-clicks-have-no-effect-on-some-apps';
 function resolvePackageRoot(helperName) {
     const require1 = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
     let pkgRoot = null;
@@ -445,6 +449,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = (0, external_node_fs_namespaceObject.statSync)(binPath);
+        if ((73 & st.mode) === 0) {
+            (0, external_node_fs_namespaceObject.chmodSync)(binPath, 493);
+            debugDevice('phased-scroll: restored executable bit on', binPath);
+        }
+    } catch (err) {
+        debugDevice('phased-scroll: chmod self-heal failed', err);
+    }
     phasedScrollBinaryPath = binPath;
     return binPath;
 }
@@ -572,9 +585,10 @@ function runPhasedScroll(direction, pixels, steps) {
         if (0 === res.status) return true;
         if (!phasedScrollExecWarned) {
             phasedScrollExecWarned = true;
-            console.warn(`[@midscene/computer] phased-scroll helper exited with status ${res.status}; falling back to keyboard/libnut. This usually means Accessibility permission has not been granted to the host process.`);
+            const hint = null === res.status ? `signal ${res.signal ?? 'unknown'}; the binary may not be executable (npm tarball extraction can drop the +x bit) or may be blocked by quarantine. Try: chmod +x "${bin}"` : 'this usually means Accessibility permission has not been granted to the host process (System Settings → Privacy & Security → Accessibility)';
+            console.warn(`[@midscene/computer] phased-scroll helper failed (exit=${res.status}, signal=${res.signal ?? 'none'}); falling back to keyboard/libnut. ${hint}`);
         }
-        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        debugDevice('phased-scroll exited non-zero', res.status, res.signal, res.error);
         return false;
     } catch (err) {
         if (!phasedScrollExecWarned) {
@@ -695,7 +709,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.2-beta-20260608084200.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -723,13 +737,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
         const deltaY = Math.abs(movedPos.y - targetY);
         if (deltaX > 5 || deltaY > 5) {
             const msg = `[HealthCheck] WARNING: Mouse control may not be working. Expected (${targetX}, ${targetY}), got (${movedPos.x}, ${movedPos.y}), delta=(${deltaX}, ${deltaY})`;
-            console.warn(msg);
-            debugDevice(msg);
-            if ('win32' === process.platform && !this.isRunningAsAdmin()) {
-                const hint = "Midscene is NOT running as Administrator. Windows blocks mouse/keyboard input to elevated (admin) applications from non-admin processes (UIPI). Please run your terminal or Node.js as Administrator and try again.";
-                console.error(`\n[HealthCheck] ${hint}\n`);
-                debugDevice(hint);
-            }
+            warnDevice(msg);
+        }
+        if ('win32' === process.platform && !this.isRunningAsAdmin()) {
+            const hint = [
+                'Heads-up: Midscene is not running as Administrator.',
+                'If clicks or key presses have no effect while the cursor still moves to the right position,',
+                `see the Windows permission troubleshooting guide: ${WINDOWS_UIPI_DOC_URL}`
+            ].join(' ');
+            warnDevice(`[HealthCheck] ${hint}`);
         }
         this.inputDriver.moveMouse(startPos.x, startPos.y);
         console.log(`[HealthCheck] Mouse restored to (${startPos.x}, ${startPos.y})`);
@@ -746,14 +762,16 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     isRunningAsAdmin() {
         if ('win32' !== process.platform) return false;
+        if (void 0 !== this.adminCheckCache) return this.adminCheckCache;
         try {
             (0, external_node_child_process_namespaceObject.execSync)('net session', {
                 stdio: 'pipe'
             });
-            return true;
+            this.adminCheckCache = true;
         } catch  {
-            return false;
+            this.adminCheckCache = false;
         }
+        return this.adminCheckCache;
     }
     async screenshotBase64() {
         if (this.destroyed) throw new Error('ComputerDevice has been destroyed');
@@ -998,6 +1016,7 @@ Original error: ${lastRawMessage}`);
             debug: (message)=>debugDevice(message)
         }));
         device_define_property(this, "useAppleScript", void 0);
+        device_define_property(this, "adminCheckCache", void 0);
         device_define_property(this, "uri", void 0);
         device_define_property(this, "inputPrimitives", {
             pointer: {
@@ -1149,24 +1168,6 @@ function createPlatformActions() {
     };
 }
 const agent_namespaceObject = require("@midscene/core/agent");
-function normalizeRdpHost(host) {
-    const trimmed = host.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('[') && trimmed.endsWith(']') && trimmed.includes(':')) return trimmed.slice(1, -1);
-    return trimmed;
-}
-function formatRdpHost(host) {
-    const normalizedHost = normalizeRdpHost(host);
-    return normalizedHost.includes(':') ? `[${normalizedHost}]` : normalizedHost;
-}
-function formatRdpServerAddress(host, port) {
-    return `${formatRdpHost(host)}:${port}`;
-}
-function normalizeRdpConnectionConfig(config) {
-    return {
-        ...config,
-        host: normalizeRdpHost(config.host)
-    };
-}
 const external_node_events_namespaceObject = require("node:events");
 const external_node_readline_namespaceObject = require("node:readline");
 const platformBinaryMap = {
@@ -1265,7 +1266,7 @@ class HelperProcessRDPBackendClient {
         await this.ensureHelperStarted();
         const response = await this.send({
             type: 'connect',
-            config: normalizeRdpConnectionConfig(config)
+            config
         });
         if ('connected' !== response.type) throw new Error(`Expected connected response, got ${response.type}`);
         this.connected = true;
@@ -1539,10 +1540,9 @@ const DEFAULT_SCROLL_STEP_AMOUNT = 120;
 class RDPDevice {
     describe() {
         const port = this.options.port || 3389;
-        const server = formatRdpServerAddress(this.options.host, port);
         const username = this.options.username ? ` as ${this.options.username}` : '';
         const session = this.connectionInfo?.sessionId ? ` [session ${this.connectionInfo.sessionId}]` : '';
-        return `RDP Device ${server}${username}${session}`;
+        return `RDP Device ${this.options.host}:${port}${username}${session}`;
     }
     async connect() {
         this.throwIfDestroyed();
@@ -1582,11 +1582,10 @@ class RDPDevice {
                 call: async ()=>{
                     this.assertConnected();
                     const size = await this.size();
-                    const server = this.connectionInfo?.server || formatRdpServerAddress(this.options.host, this.options.port || 3389);
                     return [
                         {
                             id: this.connectionInfo?.sessionId || this.options.host,
-                            name: `RDP ${server} (${size.width}x${size.height})`,
+                            name: `RDP ${this.connectionInfo?.server || this.options.host} (${size.width}x${size.height})`,
                             primary: true
                         }
                     ];
@@ -1784,12 +1783,11 @@ class RDPDevice {
                 }
             }
         });
-        const normalizedOptions = normalizeRdpConnectionConfig(options);
         this.options = {
             port: 3389,
             securityProtocol: 'auto',
             ignoreCertificate: false,
-            ...normalizedOptions
+            ...options
         };
         this.backend = options.backend || createDefaultRDPBackendClient();
     }
@@ -1869,11 +1867,10 @@ function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
     if (extracted.host) {
         const { displayId: _d, headless: _h, ...rdpFields } = extracted;
-        const host = normalizeRdpHost(extracted.host);
         return {
             mode: 'rdp',
             ...rdpFields,
-            host
+            host: extracted.host
         };
     }
     return {
@@ -1889,15 +1886,15 @@ function shouldRetargetAgent(opts) {
 }
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
-        const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
+        const portSuffix = opts.port ? `:${opts.port}` : '';
         const userSuffix = opts.username ? ` as ${opts.username}` : '';
-        return ` via RDP (${target}${userSuffix})`;
+        return ` via RDP (${opts.host}${portSuffix}${userSuffix})`;
     }
     if (opts?.mode === 'local' && opts.displayId) return ` (Display: ${opts.displayId})`;
     return ' (Primary display)';
 }
 function getCliReportSessionTarget(opts) {
-    if (opts?.mode === 'rdp') return `rdp:${formatRdpHost(opts.host)}`;
+    if (opts?.mode === 'rdp') return `rdp:${opts.host}`;
     if (opts?.mode === 'local' && opts.displayId) return opts.displayId;
     return 'primary';
 }
@@ -2014,7 +2011,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.9.2-beta-20260608084200.0";
+    const currentVersion = "1.9.2";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/mcp-server.js

@@ -390,9 +390,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = (0, logger_namespaceObject.getDebug)('computer:device');
+const warnDevice = (0, logger_namespaceObject.getDebug)('computer:device', {
+    console: true
+});
 const debugComputerInput = (0, logger_namespaceObject.getDebug)('computer:input', {
     console: true
 });
+const WINDOWS_UIPI_DOC_URL = 'https://midscenejs.com/computer-getting-started#windows-clicks-have-no-effect-on-some-apps';
 function resolvePackageRoot(helperName) {
     const require1 = (0, external_node_module_namespaceObject.createRequire)(__rslib_import_meta_url__);
     let pkgRoot = null;
@@ -432,6 +436,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = (0, external_node_fs_namespaceObject.statSync)(binPath);
+        if ((73 & st.mode) === 0) {
+            (0, external_node_fs_namespaceObject.chmodSync)(binPath, 493);
+            debugDevice('phased-scroll: restored executable bit on', binPath);
+        }
+    } catch (err) {
+        debugDevice('phased-scroll: chmod self-heal failed', err);
+    }
     phasedScrollBinaryPath = binPath;
     return binPath;
 }
@@ -559,9 +572,10 @@ function runPhasedScroll(direction, pixels, steps) {
         if (0 === res.status) return true;
         if (!phasedScrollExecWarned) {
             phasedScrollExecWarned = true;
-            console.warn(`[@midscene/computer] phased-scroll helper exited with status ${res.status}; falling back to keyboard/libnut. This usually means Accessibility permission has not been granted to the host process.`);
+            const hint = null === res.status ? `signal ${res.signal ?? 'unknown'}; the binary may not be executable (npm tarball extraction can drop the +x bit) or may be blocked by quarantine. Try: chmod +x "${bin}"` : 'this usually means Accessibility permission has not been granted to the host process (System Settings → Privacy & Security → Accessibility)';
+            console.warn(`[@midscene/computer] phased-scroll helper failed (exit=${res.status}, signal=${res.signal ?? 'none'}); falling back to keyboard/libnut. ${hint}`);
         }
-        debugDevice('phased-scroll exited non-zero', res.status, res.error);
+        debugDevice('phased-scroll exited non-zero', res.status, res.signal, res.error);
         return false;
     } catch (err) {
         if (!phasedScrollExecWarned) {
@@ -682,7 +696,7 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     async healthCheck() {
         console.log('[HealthCheck] Starting health check...');
-        console.log("[HealthCheck] @midscene/computer v1.9.2-beta-20260608084200.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -710,13 +724,15 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
         const deltaY = Math.abs(movedPos.y - targetY);
         if (deltaX > 5 || deltaY > 5) {
             const msg = `[HealthCheck] WARNING: Mouse control may not be working. Expected (${targetX}, ${targetY}), got (${movedPos.x}, ${movedPos.y}), delta=(${deltaX}, ${deltaY})`;
-            console.warn(msg);
-            debugDevice(msg);
-            if ('win32' === process.platform && !this.isRunningAsAdmin()) {
-                const hint = "Midscene is NOT running as Administrator. Windows blocks mouse/keyboard input to elevated (admin) applications from non-admin processes (UIPI). Please run your terminal or Node.js as Administrator and try again.";
-                console.error(`\n[HealthCheck] ${hint}\n`);
-                debugDevice(hint);
-            }
+            warnDevice(msg);
+        }
+        if ('win32' === process.platform && !this.isRunningAsAdmin()) {
+            const hint = [
+                'Heads-up: Midscene is not running as Administrator.',
+                'If clicks or key presses have no effect while the cursor still moves to the right position,',
+                `see the Windows permission troubleshooting guide: ${WINDOWS_UIPI_DOC_URL}`
+            ].join(' ');
+            warnDevice(`[HealthCheck] ${hint}`);
         }
         this.inputDriver.moveMouse(startPos.x, startPos.y);
         console.log(`[HealthCheck] Mouse restored to (${startPos.x}, ${startPos.y})`);
@@ -733,14 +749,16 @@ Available Displays: ${displays.length > 0 ? displays.map((d)=>d.name).join(', ')
     }
     isRunningAsAdmin() {
         if ('win32' !== process.platform) return false;
+        if (void 0 !== this.adminCheckCache) return this.adminCheckCache;
         try {
             (0, external_node_child_process_namespaceObject.execSync)('net session', {
                 stdio: 'pipe'
             });
-            return true;
+            this.adminCheckCache = true;
         } catch  {
-            return false;
+            this.adminCheckCache = false;
         }
+        return this.adminCheckCache;
     }
     async screenshotBase64() {
         if (this.destroyed) throw new Error('ComputerDevice has been destroyed');
@@ -985,6 +1003,7 @@ Original error: ${lastRawMessage}`);
             debug: (message)=>debugDevice(message)
         }));
         device_define_property(this, "useAppleScript", void 0);
+        device_define_property(this, "adminCheckCache", void 0);
         device_define_property(this, "uri", void 0);
         device_define_property(this, "inputPrimitives", {
             pointer: {
@@ -1135,24 +1154,6 @@ function createPlatformActions() {
         })
     };
 }
-function normalizeRdpHost(host) {
-    const trimmed = host.trim();
-    if (trimmed.length >= 2 && trimmed.startsWith('[') && trimmed.endsWith(']') && trimmed.includes(':')) return trimmed.slice(1, -1);
-    return trimmed;
-}
-function formatRdpHost(host) {
-    const normalizedHost = normalizeRdpHost(host);
-    return normalizedHost.includes(':') ? `[${normalizedHost}]` : normalizedHost;
-}
-function formatRdpServerAddress(host, port) {
-    return `${formatRdpHost(host)}:${port}`;
-}
-function normalizeRdpConnectionConfig(config) {
-    return {
-        ...config,
-        host: normalizeRdpHost(config.host)
-    };
-}
 const external_node_events_namespaceObject = require("node:events");
 const external_node_readline_namespaceObject = require("node:readline");
 const platformBinaryMap = {
@@ -1208,7 +1209,7 @@ class HelperProcessRDPBackendClient {
         await this.ensureHelperStarted();
         const response = await this.send({
             type: 'connect',
-            config: normalizeRdpConnectionConfig(config)
+            config
         });
         if ('connected' !== response.type) throw new Error(`Expected connected response, got ${response.type}`);
         this.connected = true;
@@ -1482,10 +1483,9 @@ const DEFAULT_SCROLL_STEP_AMOUNT = 120;
 class RDPDevice {
     describe() {
         const port = this.options.port || 3389;
-        const server = formatRdpServerAddress(this.options.host, port);
         const username = this.options.username ? ` as ${this.options.username}` : '';
         const session = this.connectionInfo?.sessionId ? ` [session ${this.connectionInfo.sessionId}]` : '';
-        return `RDP Device ${server}${username}${session}`;
+        return `RDP Device ${this.options.host}:${port}${username}${session}`;
     }
     async connect() {
         this.throwIfDestroyed();
@@ -1525,11 +1525,10 @@ class RDPDevice {
                 call: async ()=>{
                     this.assertConnected();
                     const size = await this.size();
-                    const server = this.connectionInfo?.server || formatRdpServerAddress(this.options.host, this.options.port || 3389);
                     return [
                         {
                             id: this.connectionInfo?.sessionId || this.options.host,
-                            name: `RDP ${server} (${size.width}x${size.height})`,
+                            name: `RDP ${this.connectionInfo?.server || this.options.host} (${size.width}x${size.height})`,
                             primary: true
                         }
                     ];
@@ -1727,12 +1726,11 @@ class RDPDevice {
                 }
             }
         });
-        const normalizedOptions = normalizeRdpConnectionConfig(options);
         this.options = {
             port: 3389,
             securityProtocol: 'auto',
             ignoreCertificate: false,
-            ...normalizedOptions
+            ...options
         };
         this.backend = options.backend || createDefaultRDPBackendClient();
     }
@@ -1812,11 +1810,10 @@ function adaptComputerInitArgs(extracted) {
     if (!extracted || 0 === Object.keys(extracted).length) return;
     if (extracted.host) {
         const { displayId: _d, headless: _h, ...rdpFields } = extracted;
-        const host = normalizeRdpHost(extracted.host);
         return {
             mode: 'rdp',
             ...rdpFields,
-            host
+            host: extracted.host
         };
     }
     return {
@@ -1832,15 +1829,15 @@ function shouldRetargetAgent(opts) {
 }
 function describeConnectTarget(opts) {
     if (opts?.mode === 'rdp') {
-        const target = opts.port ? formatRdpServerAddress(opts.host, opts.port) : formatRdpHost(opts.host);
+        const portSuffix = opts.port ? `:${opts.port}` : '';
         const userSuffix = opts.username ? ` as ${opts.username}` : '';
-        return ` via RDP (${target}${userSuffix})`;
+        return ` via RDP (${opts.host}${portSuffix}${userSuffix})`;
     }
     if (opts?.mode === 'local' && opts.displayId) return ` (Display: ${opts.displayId})`;
     return ' (Primary display)';
 }
 function getCliReportSessionTarget(opts) {
-    if (opts?.mode === 'rdp') return `rdp:${formatRdpHost(opts.host)}`;
+    if (opts?.mode === 'rdp') return `rdp:${opts.host}`;
     if (opts?.mode === 'local' && opts.displayId) return opts.displayId;
     return 'primary';
 }
@@ -1962,7 +1959,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.2-beta-20260608084200.0",
+            version: "1.9.2",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -78,6 +78,8 @@ export declare class ComputerDevice implements AbstractInterface {
      * to avoid focus issues with system overlays (e.g. Spotlight).
      */
     private useAppleScript;
+    /** Cached result of the elevation check; see isRunningAsAdmin(). */
+    private adminCheckCache?;
     uri?: string;
     readonly inputPrimitives: ComputerInputPrimitives;
     constructor(options?: ComputerDeviceOpt);
@@ -91,6 +93,10 @@ export declare class ComputerDevice implements AbstractInterface {
     /**
      * Check if the current process is running with Administrator privileges.
      * Uses "net session" which succeeds only when elevated.
+     *
+     * The result is cached because elevation cannot change during the process
+     * lifetime, and the underlying `execSync('net session')` is a blocking
+     * subprocess spawn that should not run on every connect / health check.
      */
     private isRunningAsAdmin;
     screenshotBase64(): Promise<string>;