@midscene/computer 1.9.2-beta-20260608092543.0 → 1.9.2

package/dist/es/cli.mjs

@@ -4,7 +4,7 @@ import { getDebug } from "@midscene/shared/logger";
 import { BaseMidsceneTools } from "@midscene/shared/mcp/base-tools";
 import { Agent } from "@midscene/core/agent";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve as external_node_path_resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -350,9 +350,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+const warnDevice = getDebug('computer:device', {
+    console: true
+});
 const debugComputerInput = 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 require = createRequire(import.meta.url);
     let pkgRoot = null;
@@ -392,6 +396,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = statSync(binPath);
+        if ((73 & st.mode) === 0) {
+            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;
 }
@@ -519,9 +532,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) {
@@ -642,7 +656,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-20260608092543.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -670,13 +684,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})`);
@@ -693,14 +709,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 {
             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');
@@ -945,6 +963,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: {
@@ -1893,7 +1912,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.2-beta-20260608092543.0",
+    version: "1.9.2",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -1,5 +1,5 @@
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve as external_node_path_resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -350,9 +350,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+const warnDevice = getDebug('computer:device', {
+    console: true
+});
 const debugComputerInput = 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 require = createRequire(import.meta.url);
     let pkgRoot = null;
@@ -392,6 +396,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = statSync(binPath);
+        if ((73 & st.mode) === 0) {
+            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;
 }
@@ -519,9 +532,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) {
@@ -642,7 +656,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-20260608092543.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -670,13 +684,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})`);
@@ -693,14 +709,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 {
             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');
@@ -945,6 +963,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: {
@@ -1934,7 +1953,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.9.2-beta-20260608092543.0";
+    const currentVersion = "1.9.2";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -1,7 +1,7 @@
 import { BaseMCPServer, createMCPServerLauncher } from "@midscene/shared/mcp";
 import { Agent } from "@midscene/core/agent";
 import { execFileSync, execSync, spawn, spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { chmodSync, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, resolve as external_node_path_resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -350,9 +350,13 @@ async function getLibnut() {
     }
 }
 const debugDevice = getDebug('computer:device');
+const warnDevice = getDebug('computer:device', {
+    console: true
+});
 const debugComputerInput = 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 require = createRequire(import.meta.url);
     let pkgRoot = null;
@@ -392,6 +396,15 @@ function getPhasedScrollBinary() {
         phasedScrollBinaryPath = null;
         return null;
     }
+    try {
+        const st = statSync(binPath);
+        if ((73 & st.mode) === 0) {
+            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;
 }
@@ -519,9 +532,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) {
@@ -642,7 +656,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-20260608092543.0");
+        console.log("[HealthCheck] @midscene/computer v1.9.2");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -670,13 +684,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})`);
@@ -693,14 +709,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 {
             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');
@@ -945,6 +963,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: {
@@ -1897,7 +1916,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.2-beta-20260608092543.0",
+            version: "1.9.2",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

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-20260608092543.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: {
@@ -1920,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-20260608092543.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-20260608092543.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: {
@@ -1992,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-20260608092543.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-20260608092543.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: {
@@ -1940,7 +1959,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.2-beta-20260608092543.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>;

package/dist/types/mcp-server.d.ts

@@ -30,6 +30,8 @@ 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);
@@ -43,6 +45,10 @@ 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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.9.2-beta-20260608092543.0",
+  "version": "1.9.2",
   "description": "Midscene.js Computer Desktop Automation",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "@computer-use/libnut": "^4.2.0",
     "clipboardy": "^4.0.0",
     "screenshot-desktop": "^1.15.3",
-    "@midscene/core": "1.9.2-beta-20260608092543.0",
-    "@midscene/shared": "1.9.2-beta-20260608092543.0"
+    "@midscene/core": "1.9.2",
+    "@midscene/shared": "1.9.2"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"