@midscene/computer 1.9.2 → 1.9.3-beta-20260608125147.0

package/dist/es/cli.mjs

@@ -52,6 +52,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -230,13 +237,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -244,7 +255,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -252,14 +263,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -267,7 +278,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -656,7 +667,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");
+        console.log("[HealthCheck] @midscene/computer v1.9.3-beta-20260608125147.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -834,7 +845,7 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -843,7 +854,19 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        const point = this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -853,11 +876,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -865,9 +885,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -886,30 +905,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -1912,7 +1931,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
 const tools = new ComputerMidsceneTools();
 runToolsCLI(tools, 'midscene-computer', {
     stripPrefix: 'computer_',
-    version: "1.9.2",
+    version: "1.9.3-beta-20260608125147.0",
     extraCommands: createReportCliCommands()
 }).catch((e)=>{
     process.exit(reportCLIError(e));

package/dist/es/index.mjs

@@ -52,6 +52,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -230,13 +237,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -244,7 +255,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -252,14 +263,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -267,7 +278,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -656,7 +667,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");
+        console.log("[HealthCheck] @midscene/computer v1.9.3-beta-20260608125147.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -834,7 +845,7 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -843,7 +854,19 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        const point = this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -853,11 +876,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -865,9 +885,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -886,30 +905,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -1953,7 +1972,7 @@ class ComputerMidsceneTools extends BaseMidsceneTools {
     }
 }
 function version() {
-    const currentVersion = "1.9.2";
+    const currentVersion = "1.9.3-beta-20260608125147.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/es/mcp-server.mjs

@@ -52,6 +52,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -230,13 +237,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -244,7 +255,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -252,14 +263,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -267,7 +278,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -656,7 +667,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");
+        console.log("[HealthCheck] @midscene/computer v1.9.3-beta-20260608125147.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -834,7 +845,7 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -843,7 +854,19 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        const point = this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -853,11 +876,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -865,9 +885,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -886,30 +905,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -1916,7 +1935,7 @@ class ComputerMCPServer extends BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.2",
+            version: "1.9.3-beta-20260608125147.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/lib/cli.js

@@ -78,6 +78,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -256,13 +263,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -270,7 +281,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -278,14 +289,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -293,7 +304,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -682,7 +693,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");
+        console.log("[HealthCheck] @midscene/computer v1.9.3-beta-20260608125147.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -860,7 +871,7 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -869,7 +880,19 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        const point = this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -879,11 +902,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -891,9 +911,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -912,30 +931,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -1939,7 +1958,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",
+    version: "1.9.3-beta-20260608125147.0",
     extraCommands: (0, core_namespaceObject.createReportCliCommands)()
 }).catch((e)=>{
     process.exit((0, cli_namespaceObject.reportCLIError)(e));

package/dist/lib/index.js

@@ -105,6 +105,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -283,13 +290,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -297,7 +308,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -305,14 +316,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -320,7 +331,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -709,7 +720,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");
+        console.log("[HealthCheck] @midscene/computer v1.9.3-beta-20260608125147.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -887,7 +898,7 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -896,7 +907,19 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        const point = this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -906,11 +929,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -918,9 +938,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -939,30 +958,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -2011,7 +2030,7 @@ class ComputerMidsceneTools extends base_tools_namespaceObject.BaseMidsceneTools
 }
 const env_namespaceObject = require("@midscene/shared/env");
 function version() {
-    const currentVersion = "1.9.2";
+    const currentVersion = "1.9.3-beta-20260608125147.0";
     console.log(`@midscene/computer v${currentVersion}`);
     return currentVersion;
 }

package/dist/lib/mcp-server.js

@@ -92,6 +92,13 @@ class ComputerInputDriver {
     scrollMouse(x, y) {
         this.getLibnutOrThrow('scrollMouse').scrollMouse(x, y);
     }
+    async emitScrollDetents(dx, dy, detents, delayMs) {
+        this.assertActive('emitScrollDetents');
+        for(let i = 0; i < detents; i++){
+            this.scrollMouse(dx, dy);
+            if (i < detents - 1) await this.delay(delayMs);
+        }
+    }
     keyTap(key, modifiers) {
         const lib = this.getLibnutOrThrow('keyTap');
         if (void 0 !== modifiers) lib.keyTap(key, modifiers);
@@ -270,13 +277,17 @@ const CLICK_HOLD_DURATION = 100;
 const CLICK_FOCUS_SETTLE_DELAY = 120;
 const INPUT_FOCUS_DELAY = 300;
 const INPUT_CLEAR_DELAY = 150;
-const SCROLL_REPEAT_COUNT = 10;
 const SCROLL_STEP_DELAY = 100;
 const SCROLL_COMPLETE_DELAY = 500;
 const EDGE_SCROLL_TOTAL_PX = 50000;
 const EDGE_SCROLL_STEPS = 400;
 const PHASED_PIXELS_PER_STEP = 30;
 const PHASED_MIN_STEPS = 10;
+const LIBNUT_FALLBACK_PIXELS_PER_DETENT = 100;
+const LIBNUT_FALLBACK_TICK_DELAY_MS = 30;
+const LIBNUT_FALLBACK_MAX_DETENTS = 200;
+const LIBNUT_FALLBACK_DETENT_AMOUNT = 'win32' === process.platform ? 120 : 1;
+const LIBNUT_FALLBACK_EDGE_DETENTS = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(EDGE_SCROLL_TOTAL_PX / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
 const DEFAULT_SCROLL_VIEWPORT_RATIO = 0.7;
 const EDGE_SCROLL_SPEC = {
     scrollToTop: {
@@ -284,7 +295,7 @@ const EDGE_SCROLL_SPEC = {
         key: 'home',
         libnut: [
             0,
-            10
+            1
         ]
     },
     scrollToBottom: {
@@ -292,14 +303,14 @@ const EDGE_SCROLL_SPEC = {
         key: 'end',
         libnut: [
             0,
-            -10
+            -1
         ]
     },
     scrollToLeft: {
         direction: 'left',
         key: 'home',
         libnut: [
-            -10,
+            -1,
             0
         ]
     },
@@ -307,7 +318,7 @@ const EDGE_SCROLL_SPEC = {
         direction: 'right',
         key: 'end',
         libnut: [
-            10,
+            1,
             0
         ]
     }
@@ -696,7 +707,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");
+        console.log("[HealthCheck] @midscene/computer v1.9.3-beta-20260608125147.0");
         console.log('[HealthCheck] Taking screenshot...');
         const screenshotTimeout = 15000;
         let timeoutId;
@@ -874,7 +885,7 @@ Original error: ${lastRawMessage}`);
         });
         this.inputDriver.sendKey(key, modifiers);
     }
-    async performScroll(param) {
+    async moveMouseToScrollTarget(param) {
         if (param.locate) {
             const element = param.locate;
             const [x, y] = element.center;
@@ -883,7 +894,19 @@ Original error: ${lastRawMessage}`);
                 y
             });
             this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+            return;
         }
+        const screenSize = await this.size();
+        const point = this.toGlobalPoint({
+            x: screenSize.width / 2,
+            y: screenSize.height / 2
+        });
+        this.inputDriver.moveMouse(Math.round(point.x), Math.round(point.y));
+        await this.inputDriver.delay(MOUSE_MOVE_EFFECT_WAIT);
+        return screenSize;
+    }
+    async performScroll(param) {
+        let screenSize = await this.moveMouseToScrollTarget(param);
         const scrollType = param?.scrollType;
         const edgeSpec = scrollType && scrollType in EDGE_SCROLL_SPEC ? EDGE_SCROLL_SPEC[scrollType] : null;
         if (edgeSpec) {
@@ -893,11 +916,8 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const [dx, dy] = edgeSpec.libnut;
-            for(let i = 0; i < SCROLL_REPEAT_COUNT; i++){
-                this.inputDriver.scrollMouse(dx, dy);
-                await this.inputDriver.delay(SCROLL_STEP_DELAY);
-            }
+            const [ux, uy] = edgeSpec.libnut;
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, LIBNUT_FALLBACK_EDGE_DETENTS, LIBNUT_FALLBACK_TICK_DELAY_MS);
             return;
         }
         if ('singleAction' === scrollType || !scrollType) {
@@ -905,9 +925,8 @@ Original error: ${lastRawMessage}`);
             const isKnownDirection = 'up' === direction || 'down' === direction || 'left' === direction || 'right' === direction;
             const isHorizontal = 'left' === direction || 'right' === direction;
             let distance = param?.distance ?? void 0;
-            let screenSize;
             if (!distance) {
-                screenSize = await this.size();
+                screenSize ??= await this.size();
                 const base = isHorizontal ? screenSize.width : screenSize.height;
                 distance = Math.max(1, Math.round(base * DEFAULT_SCROLL_VIEWPORT_RATIO));
             }
@@ -926,30 +945,30 @@ Original error: ${lastRawMessage}`);
                 await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
                 return;
             }
-            const ticks = Math.ceil(distance / 100);
-            const directionMap = {
+            const detents = Math.min(LIBNUT_FALLBACK_MAX_DETENTS, Math.max(1, Math.ceil(distance / LIBNUT_FALLBACK_PIXELS_PER_DETENT)));
+            const directionUnit = {
                 up: [
                     0,
-                    ticks
+                    1
                 ],
                 down: [
                     0,
-                    -ticks
+                    -1
                 ],
                 left: [
-                    -ticks,
+                    -1,
                     0
                 ],
                 right: [
-                    ticks,
+                    1,
                     0
                 ]
             };
-            const [dx, dy] = directionMap[direction] || [
+            const [ux, uy] = directionUnit[direction] || [
                 0,
-                -ticks
+                -1
             ];
-            this.inputDriver.scrollMouse(dx, dy);
+            await this.inputDriver.emitScrollDetents(ux * LIBNUT_FALLBACK_DETENT_AMOUNT, uy * LIBNUT_FALLBACK_DETENT_AMOUNT, detents, LIBNUT_FALLBACK_TICK_DELAY_MS);
             await this.inputDriver.delay(SCROLL_COMPLETE_DELAY);
             return;
         }
@@ -1959,7 +1978,7 @@ class ComputerMCPServer extends mcp_namespaceObject.BaseMCPServer {
     constructor(toolsManager){
         super({
             name: '@midscene/computer-mcp',
-            version: "1.9.2",
+            version: "1.9.3-beta-20260608125147.0",
             description: 'Control the computer desktop using natural language commands'
         }, toolsManager);
     }

package/dist/types/index.d.ts

@@ -119,6 +119,7 @@ export declare class ComputerDevice implements AbstractInterface {
     private smartTypeString;
     private selectAllAndDelete;
     private pressKeyboardShortcut;
+    private moveMouseToScrollTarget;
     private performScroll;
     actionSpace(): DeviceAction<any>[];
     destroy(): Promise<void>;

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

@@ -71,6 +71,7 @@ declare class ComputerDevice implements AbstractInterface {
     private smartTypeString;
     private selectAllAndDelete;
     private pressKeyboardShortcut;
+    private moveMouseToScrollTarget;
     private performScroll;
     actionSpace(): DeviceAction<any>[];
     destroy(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@midscene/computer",
-  "version": "1.9.2",
+  "version": "1.9.3-beta-20260608125147.0",
   "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",
-    "@midscene/shared": "1.9.2"
+    "@midscene/core": "1.9.3-beta-20260608125147.0",
+    "@midscene/shared": "1.9.3-beta-20260608125147.0"
   },
   "optionalDependencies": {
     "node-mac-permissions": "2.5.0"