testdriverai 7.9.9-test → 7.9.11-test

package/agent/lib/sandbox.js

@@ -1283,12 +1283,12 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         var rate = (this._publishCount / windowElapsed) * 1000;
         var rateStr = rate.toFixed(1);
 
-        // Log rate - warning if approaching limit, debug otherwise
-        if (rate > 45) {
-          logger.warn("Ably publish rate: " + rateStr + " msg/sec (approaching 50/sec limit)");
-        } else if (process.env.VERBOSE || process.env.TD_DEBUG) {
-          logger.log("Ably publish rate: " + rateStr + " msg/sec");
-        }
+        // // Log rate - warning if approaching limit, debug otherwise
+        // if (rate > 45) {
+        //   logger.warn("Ably publish rate: " + rateStr + " msg/sec (approaching 50/sec limit)");
+        // } else if (process.env.VERBOSE || process.env.TD_DEBUG) {
+        //   logger.log("Ably publish rate: " + rateStr + " msg/sec");
+        // }
 
         // Reset window
         this._publishCount = 0;

package/ai/agents/testdriver.md

@@ -44,7 +44,7 @@ Use this agent when the user asks to:
 4. **⚠️ WRITE CODE IMMEDIATELY**: After EVERY successful action, append the generated code to the test file RIGHT AWAY. Do NOT wait until the end.
 5. **Verify Actions**: Use `check` after actions to verify they succeeded (for YOUR understanding only).
 6. **Add Assertions**: Use `assert` for test conditions that should be in the final test file.
-7. **⚠️ RUN THE TEST YOURSELF**: Use `vitest run <testFile> --reporter=dot` to run the test - do NOT tell the user to run it. Iterate until it passes. **NEVER use `npx vitest`** - always use `vitest` directly.
+7. **⚠️ RUN THE TEST YOURSELF**: Use `vitest run <testFile>` to run the test - do NOT tell the user to run it. Iterate until it passes. **NEVER use `npx vitest`** - always use `vitest` directly.
 8. **⚠️ SHARE THE TEST REPORT**: After EVERY test run, find the `TESTDRIVER_RUN_URL` in the output (e.g., `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...`) and share it with the user so they can view the recording and results.
 
 ## Prerequisites
@@ -315,11 +315,9 @@ assert({ assertion: "the dashboard is visible" })
 **⚠️ YOU must run the test - do NOT tell the user to run it. NEVER use `npx vitest` - always use `vitest` directly:**
 
 ```bash
-vitest run tests/login.test.mjs --reporter=dot
+vitest run tests/login.test.mjs
 ```
 
-**Always use `--reporter=dot`** for cleaner, more concise output that's easier to parse.
-
 Analyze the output, fix any issues, and iterate until the test passes.
 
 **⚠️ ALWAYS share the test report link with the user.** After each test run, look for `TESTDRIVER_RUN_URL` in the test output (e.g., `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...`) and share it with the user so they can view the recording and results. This is CRITICAL - users need to see the visual recording to understand test behavior.
@@ -568,8 +566,6 @@ await testdriver.pressKeys(["escape"]);
 
 // Now scroll
 await testdriver.scroll("down");
-await testdriver.scrollUntilText("Footer text");
-await testdriver.scrollUntilImage("Product image at bottom");
 
 // If scroll is not working, try using Page Down key directly
 await testdriver.pressKeys(["pagedown"]);
@@ -614,7 +610,7 @@ await testdriver.screenshot(1, false, true);
 ## Tips for Agents
 
 1. **⚠️ WRITE CODE IMMEDIATELY** - After EVERY successful MCP action, append the generated code to the test file RIGHT AWAY. Do NOT wait until the session ends.
-2. **⚠️ RUN TESTS YOURSELF** - Do NOT tell the user to run tests. YOU must run the tests using `vitest run <testFile> --reporter=dot` (NEVER use `npx vitest` - it breaks the reporter). Always use `--reporter=dot` for cleaner output. Analyze the output and iterate until the test passes.
+2. **⚠️ RUN TESTS YOURSELF** - Do NOT tell the user to run tests. YOU must run the tests using `vitest run <testFile>` (NEVER use `npx vitest`). Analyze the output and iterate until the test passes.
 3. **⚠️ SHARE THE TEST REPORT URL** - After EVERY test run, find `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...` in the output and share it with the user. This is CRITICAL - users need to view the recording to understand what happened.
 3. **Screenshots are automatic** - TestDriver captures screenshots before/after every command by default. Each screenshot filename includes the line number (e.g., `001-click-before-L42-submit-button.png`) making it easy to trace issues.
 4. **⚠️ USE SCREENSHOT VIEWING FOR DEBUGGING** - When tests fail, use `list_local_screenshots` and `view_local_screenshot` MCP commands to see exactly what the UI looked like. The filenames tell you which line of code triggered each screenshot.

package/ai/skills/testdriver-find/SKILL.md

@@ -49,8 +49,8 @@ const element = await testdriver.find(description, options)
       - `"any"` — No wrapping, uses the description as-is (default behavior)
     </ParamField>
     
-    <ParamField path="zoom" type="boolean" default={true}>
-      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Enabled by default.
+    <ParamField path="zoom" type="boolean" default={false}>
+      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Disabled by default.
     </ParamField>
     
     <ParamField path="ai" type="object">
@@ -334,17 +334,17 @@ The `timeout` option:
 
 ## Zoom Mode
 
-Zoom mode is **enabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
+Zoom mode is **disabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
 
-To disable zoom for a specific find call, pass `zoom: false`:
+To enable zoom for a specific find call, pass `zoom: true`:
 
 ```javascript
-// Zoom is on by default — no option needed
-const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar');
+// Enable zoom for better precision in crowded UIs
+const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar', { zoom: true });
 await extensionsBtn.click();
 
-// Disable zoom for a specific call if needed
-const largeButton = await testdriver.find('big hero button', { zoom: false });
+// Without zoom (default)
+const largeButton = await testdriver.find('big hero button');
 ```
 
 ### How Zoom Mode Works
@@ -357,9 +357,9 @@ const largeButton = await testdriver.find('big hero button', { zoom: false });
 This two-phase approach gives the AI a higher-resolution view of the target area, improving accuracy when multiple similar elements are close together.
 
 <Tip>
-  You may want to disable zoom with `zoom: false` when:
-  - Targeting large, isolated elements where the extra precision isn't needed
-  - You want to speed up find calls in simple UIs
+  You may want to enable zoom with `zoom: true` when:
+  - Targeting small elements in crowded UIs with many similar elements
+  - You need extra precision for closely spaced UI elements
 </Tip>
 
 ## Cache Options

package/ai/skills/testdriver-performing-actions/SKILL.md

@@ -27,7 +27,6 @@ await testdriver.find('dropdown menu').hover();
 
 // Scrolling
 await testdriver.scroll('down', 500);
-await testdriver.scrollUntilText('Footer content');
 
 // Waiting
 await testdriver.wait(2000); // Wait 2 seconds for animation/state change

package/ai/skills/testdriver-screenshot/SKILL.md

@@ -153,7 +153,7 @@ Automatic screenshots are taken around these commands:
 - `find()` / `findAll()`
 - `click()` / `hover()` / `doubleClick()` / `rightClick()`
 - `type()` / `pressKeys()`
-- `scroll()` / `scrollUntilText()` / `scrollUntilImage()`
+- `scroll()`
 - `waitForText()` / `waitForImage()`
 - `focusApplication()`
 - `assert()` / `extract()` / `exec()`

package/ai/skills/testdriver-scroll/SKILL.md

@@ -35,8 +35,8 @@ await testdriver.scroll(direction, amount, method)
   Direction to scroll: `'up'`, `'down'`, `'left'`, `'right'`
 </ParamField>
 
-<ParamField path="amount" type="number" default="300">
-  Amount to scroll in pixels
+<ParamField path="amount" type="number" default="3">
+  Amount to scroll in clicks (scroll wheel units). Each click is roughly 100px in a browser.
 </ParamField>
 
 <ParamField path="method" type="string" default="mouse">
@@ -55,95 +55,34 @@ await testdriver.scroll(direction, amount, method)
 // Scroll down (default)
 await testdriver.scroll();
 
-// Scroll down 500 pixels
-await testdriver.scroll('down', 500);
+// Scroll down 5 clicks
+await testdriver.scroll('down', 5);
 
 // Scroll up
 await testdriver.scroll('up');
 
-// Scroll up 200 pixels
-await testdriver.scroll('up', 200);
+// Scroll up 2 clicks
+await testdriver.scroll('up', 2);
 ```
 
 ### Horizontal Scrolling
 
 ```javascript
 // Scroll right
-await testdriver.scroll('right', 300);
+await testdriver.scroll('right', 3);
 
 // Scroll left
-await testdriver.scroll('left', 300);
+await testdriver.scroll('left', 3);
 ```
 
 ### Scroll Methods
 
 ```javascript
-// Mouse wheel scroll (smooth, pixel-precise)
-await testdriver.scroll('down', 300, 'mouse');
+// Mouse wheel scroll (smooth)
+await testdriver.scroll('down', 3, 'mouse');
 
 // Keyboard scroll (uses Page Down/Up, more compatible)
-await testdriver.scroll('down', 300, 'keyboard');
-```
-
-## Scroll Until Found
-
-### scrollUntilText()
-
-Scroll until specific text appears on screen.
-
-```javascript
-await testdriver.scrollUntilText(text, direction, maxDistance, textMatchMethod, method, invert)
-```
-
-**Parameters:**
-- `text` (string) - Text to find
-- `direction` (string) - Scroll direction (default: `'down'`)
-- `maxDistance` (number) - Max pixels to scroll (default: 10000)
-- `textMatchMethod` (string) - `'turbo'` or `'ai'` (default: `'turbo'`)
-- `method` (string) - `'keyboard'` or `'mouse'` (default: `'keyboard'`)
-- `invert` (boolean) - Scroll until text disappears (default: false)
-
-**Examples:**
-```javascript
-// Scroll down until "Contact Us" appears
-await testdriver.scrollUntilText('Contact Us');
-
-// Scroll up to find text
-await testdriver.scrollUntilText('Header', 'up');
-
-// Scroll until text disappears
-await testdriver.scrollUntilText('Loading...', 'down', 5000, 'turbo', 'keyboard', true);
-
-// Use AI matching for fuzzy text
-await testdriver.scrollUntilText('footer content', 'down', 10000, 'ai');
-```
-
-### scrollUntilImage()
-
-Scroll until a visual element appears.
-
-```javascript
-await testdriver.scrollUntilImage(description, direction, maxDistance, method, path, invert)
-```
-
-**Parameters:**
-- `description` (string) - Description of the image/element
-- `direction` (string) - Scroll direction (default: `'down'`)
-- `maxDistance` (number) - Max pixels to scroll (default: 10000)
-- `method` (string) - `'keyboard'` or `'mouse'` (default: `'keyboard'`)
-- `path` (string | null) - Path to image template (optional)
-- `invert` (boolean) - Scroll until image disappears (default: false)
-
-**Examples:**
-```javascript
-// Scroll until visual element appears
-await testdriver.scrollUntilImage('red subscribe button');
-
-// Scroll using image template
-await testdriver.scrollUntilImage('', 'down', 10000, 'keyboard', './footer-logo.png');
-
-// Scroll until image disappears
-await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', null, true);
+await testdriver.scroll('down', 3, 'keyboard');
 ```
 
 ## Best Practices
@@ -162,7 +101,7 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
   // await testdriver.find('page background').click();
   
   // Now scroll will work properly
-  await testdriver.scroll('down', 300);
+  await testdriver.scroll('down', 3);
   
   // If scroll still doesn't work, use Page Down directly
   // await testdriver.pressKeys(['pagedown']);
@@ -174,80 +113,27 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
   
   ```javascript
   // For web pages, mouse scroll is usually smoother
-  await testdriver.scroll('down', 300, 'mouse');
+  await testdriver.scroll('down', 3, 'mouse');
   
   // For desktop apps or when mouse doesn't work
-  await testdriver.scroll('down', 300, 'keyboard');
-  ```
-</Check>
-
-<Check>
-  **Use scrollUntil for dynamic content**
-  
-  ```javascript
-  // Instead of guessing scroll amount
-  await testdriver.scrollUntilText('Load More button');
-  
-  const loadMoreBtn = await testdriver.find('Load More button');
-  await loadMoreBtn.click();
-  ```
-</Check>
-
-<Check>
-  **Set reasonable max distance**
-  
-  ```javascript
-  // Avoid infinite scrolling
-  await testdriver.scrollUntilText('Footer', 'down', 5000); // Max 5000px
+  await testdriver.scroll('down', 3, 'keyboard');
   ```
 </Check>
 
 <Warning>
   **Keyboard scroll uses Page Down/Up**
   
-  Keyboard scrolling typically moves by one "page" at a time, which may be more than the specified pixel amount. It's more compatible but less precise than mouse scrolling.
+  Keyboard scrolling typically moves by one "page" at a time, which may be more than the specified click amount. It's more compatible but less precise than mouse scrolling.
 </Warning>
 
 ## Use Cases
 
 <AccordionGroup>
-  <Accordion title="Navigate to Footer">
-    ```javascript
-    // Scroll to bottom of page
-    await testdriver.scrollUntilText('Contact Us');
-    
-    const contactLink = await testdriver.find('Contact Us link');
-    await contactLink.click();
-    ```
-  </Accordion>
-  
-  <Accordion title="Load More Results">
-    ```javascript
-    // Scroll to load more button
-    await testdriver.scrollUntilText('Load More');
-    
-    const loadBtn = await testdriver.find('Load More button');
-    await loadBtn.click();
-    
-    await new Promise(r => setTimeout(r, 2000));
-    ```
-  </Accordion>
-  
-  <Accordion title="Find Element in Long List">
-    ```javascript
-    // Scroll through list to find item
-    await testdriver.scrollUntilText('Product #42');
-    
-    const product = await testdriver.find('Product #42');
-    await product.click();
-    ```
-  </Accordion>
-  
   <Accordion title="Infinite Scroll">
     ```javascript
     // Scroll multiple times for infinite scroll
     for (let i = 0; i < 5; i++) {
-      await testdriver.scroll('down', 500);
+      await testdriver.scroll('down', 5);
       await new Promise(r => setTimeout(r, 1000)); // Wait for load
     }
     ```
@@ -256,7 +142,7 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
   <Accordion title="Horizontal Gallery">
     ```javascript
     // Navigate horizontal carousel
-    await testdriver.scroll('right', 300);
+    await testdriver.scroll('right', 3);
     await new Promise(r => setTimeout(r, 500));
     
     const nextImage = await testdriver.find('next image in carousel');
@@ -287,8 +173,8 @@ describe('Scrolling', () => {
   it('should scroll to find elements', async () => {
     await testdriver.focusApplication('Google Chrome');
     
-    // Scroll to footer
-    await testdriver.scrollUntilText('Contact Information');
+    // Scroll down the page
+    await testdriver.scroll('down', 5);
     
     // Click footer link
     const privacyLink = await testdriver.find('Privacy Policy link');
@@ -302,29 +188,13 @@ describe('Scrolling', () => {
     
     // Scroll multiple times to load content
     for (let i = 0; i < 3; i++) {
-      await testdriver.scroll('down', 500);
+      await testdriver.scroll('down', 5);
       await new Promise(r => setTimeout(r, 1500)); // Wait for load
     }
     
     // Verify content loaded
     await testdriver.assert('more than 10 items are visible');
   });
-
-  it('should scroll until loading completes', async () => {
-    // Scroll until loading spinner disappears
-    await testdriver.scrollUntilImage(
-      'loading spinner', 
-      'down', 
-      5000, 
-      'keyboard', 
-      null, 
-      true // invert - wait for it to disappear
-    );
-    
-    // Now interact with loaded content
-    const firstResult = await testdriver.find('first search result');
-    await firstResult.click();
-  });
 });
 ```
 

package/ai/skills/testdriver-test-writer/SKILL.md

@@ -392,8 +392,6 @@ await element.click();
 
 ```javascript
 await testdriver.scroll("down");
-await testdriver.scrollUntilText("Footer text");
-await testdriver.scrollUntilImage("Product image at bottom");
 ```
 
 ### Executing Code in Sandbox

package/ai/skills/testdriver-testdriver/SKILL.md

@@ -34,7 +34,7 @@ Use this agent when the user asks to:
 4. **⚠️ WRITE CODE IMMEDIATELY**: After EVERY successful action, append the generated code to the test file RIGHT AWAY. Do NOT wait until the end.
 5. **Verify Actions**: Use `check` after actions to verify they succeeded (for YOUR understanding only).
 6. **Add Assertions**: Use `assert` for test conditions that should be in the final test file.
-7. **⚠️ RUN THE TEST YOURSELF**: Use `vitest run <testFile> --reporter=dot` to run the test - do NOT tell the user to run it. Iterate until it passes. **NEVER use `npx vitest`** - always use `vitest` directly.
+7. **⚠️ RUN THE TEST YOURSELF**: Use `vitest run <testFile>` to run the test - do NOT tell the user to run it. Iterate until it passes. **NEVER use `npx vitest`** - always use `vitest` directly.
 8. **⚠️ SHARE THE TEST REPORT**: After EVERY test run, find the `TESTDRIVER_RUN_URL` in the output (e.g., `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...`) and share it with the user so they can view the recording and results.
 
 ## Prerequisites
@@ -305,11 +305,9 @@ assert({ assertion: "the dashboard is visible" })
 **⚠️ YOU must run the test - do NOT tell the user to run it. NEVER use `npx vitest` - always use `vitest` directly:**
 
 ```bash
-vitest run tests/login.test.mjs --reporter=dot
+vitest run tests/login.test.mjs
 ```
 
-**Always use `--reporter=dot`** for cleaner, more concise output that's easier to parse.
-
 Analyze the output, fix any issues, and iterate until the test passes.
 
 **⚠️ ALWAYS share the test report link with the user.** After each test run, look for `TESTDRIVER_RUN_URL` in the test output (e.g., `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...`) and share it with the user so they can view the recording and results. This is CRITICAL - users need to see the visual recording to understand test behavior.
@@ -558,8 +556,6 @@ await testdriver.pressKeys(["escape"]);
 
 // Now scroll
 await testdriver.scroll("down");
-await testdriver.scrollUntilText("Footer text");
-await testdriver.scrollUntilImage("Product image at bottom");
 
 // If scroll is not working, try using Page Down key directly
 await testdriver.pressKeys(["pagedown"]);
@@ -604,7 +600,7 @@ await testdriver.screenshot(1, false, true);
 ## Tips for Agents
 
 1. **⚠️ WRITE CODE IMMEDIATELY** - After EVERY successful MCP action, append the generated code to the test file RIGHT AWAY. Do NOT wait until the session ends.
-2. **⚠️ RUN TESTS YOURSELF** - Do NOT tell the user to run tests. YOU must run the tests using `vitest run <testFile> --reporter=dot` (NEVER use `npx vitest` - it breaks the reporter). Always use `--reporter=dot` for cleaner output. Analyze the output and iterate until the test passes.
+2. **⚠️ RUN TESTS YOURSELF** - Do NOT tell the user to run tests. YOU must run the tests using `vitest run <testFile>` (NEVER use `npx vitest`). Analyze the output and iterate until the test passes.
 3. **⚠️ SHARE THE TEST REPORT URL** - After EVERY test run, find `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...` in the output and share it with the user. This is CRITICAL - users need to view the recording to understand what happened.
 3. **Screenshots are automatic** - TestDriver captures screenshots before/after every command by default. Each screenshot filename includes the line number (e.g., `001-click-before-L42-submit-button.png`) making it easy to trace issues.
 4. **⚠️ USE SCREENSHOT VIEWING FOR DEBUGGING** - When tests fail, use `list_local_screenshots` and `view_local_screenshot` MCP commands to see exactly what the UI looked like. The filenames tell you which line of code triggered each screenshot.

package/docs/_data/examples-manifest.json

@@ -2,16 +2,16 @@
   "$schema": "./examples-manifest.schema.json",
   "examples": {
     "assert.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb166df6a1c5774e8059ab",
-      "lastUpdated": "2026-03-31T00:53:17.643Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f7248d4e274f31c128",
+      "lastUpdated": "2026-04-02T00:49:48.926Z"
     },
     "drag-and-drop.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42fc0ac3cc632a918b",
       "lastUpdated": "2026-03-03T00:32:25.275Z"
     },
     "exec-pwsh.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb165ef6a1c5774e80599f",
-      "lastUpdated": "2026-03-31T00:34:42.693Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e1248d4e274f31c11c",
+      "lastUpdated": "2026-04-02T00:33:08.610Z"
     },
     "match-image.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
@@ -22,84 +22,84 @@
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1660f6a1c5774e8059a0",
-      "lastUpdated": "2026-03-31T00:33:36.228Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e4248d4e274f31c11d",
+      "lastUpdated": "2026-04-02T00:31:31.665Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1663f6a1c5774e8059a3",
-      "lastUpdated": "2026-03-31T00:34:47.170Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e8248d4e274f31c120",
+      "lastUpdated": "2026-04-02T00:33:15.383Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1665f6a1c5774e8059a4",
-      "lastUpdated": "2026-03-31T00:34:48.538Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8eb248d4e274f31c121",
+      "lastUpdated": "2026-04-02T00:33:18.021Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb165df6a1c5774e80599e",
-      "lastUpdated": "2026-03-31T00:34:07.368Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8df248d4e274f31c11b",
+      "lastUpdated": "2026-04-02T00:32:16.921Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1662f6a1c5774e8059a1",
-      "lastUpdated": "2026-03-31T00:40:26.271Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8e6248d4e274f31c11e",
+      "lastUpdated": "2026-04-02T00:38:43.485Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1666f6a1c5774e8059a5",
-      "lastUpdated": "2026-03-31T00:34:17.480Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8ed248d4e274f31c122",
+      "lastUpdated": "2026-04-02T00:32:29.925Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1668f6a1c5774e8059a6",
-      "lastUpdated": "2026-03-31T00:33:44.335Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f0248d4e274f31c123",
+      "lastUpdated": "2026-04-02T00:31:43.411Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb166af6a1c5774e8059a9",
-      "lastUpdated": "2026-03-31T00:34:20.745Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f2248d4e274f31c126",
+      "lastUpdated": "2026-04-02T00:32:35.729Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb166cf6a1c5774e8059aa",
-      "lastUpdated": "2026-03-31T00:51:20.389Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8f5248d4e274f31c127",
+      "lastUpdated": "2026-04-02T00:48:38.124Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1671f6a1c5774e8059ad",
-      "lastUpdated": "2026-03-31T00:34:59.681Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8fc248d4e274f31c12a",
+      "lastUpdated": "2026-04-02T00:33:33.877Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1677f6a1c5774e8059b1",
-      "lastUpdated": "2026-03-31T00:57:48.346Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb905248d4e274f31c12e",
+      "lastUpdated": "2026-04-02T00:56:49.118Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1672f6a1c5774e8059ae",
-      "lastUpdated": "2026-03-31T00:33:54.647Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8fe248d4e274f31c12b",
+      "lastUpdated": "2026-04-02T00:31:58.929Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1674f6a1c5774e8059af",
-      "lastUpdated": "2026-03-31T00:35:02.499Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb900248d4e274f31c12c",
+      "lastUpdated": "2026-04-02T00:33:38.547Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1675f6a1c5774e8059b0",
-      "lastUpdated": "2026-03-31T00:33:57.527Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb902248d4e274f31c12d",
+      "lastUpdated": "2026-04-02T00:32:03.120Z"
     },
     "captcha-api.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698f7df69e27ce1528d7d087/698f7fb0d3b320ad547d9d44",
       "lastUpdated": "2026-02-13T19:55:05.951Z"
     },
     "element-not-found.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb1678f6a1c5774e8059b2",
-      "lastUpdated": "2026-03-31T00:35:06.837Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb907248d4e274f31c12f",
+      "lastUpdated": "2026-04-02T00:33:44.522Z"
     },
     "formatted-logging.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c873a714b73310c7839450",
       "lastUpdated": "2026-03-29T00:36:10.628Z"
     },
     "hover-text.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb167bf6a1c5774e8059b4",
-      "lastUpdated": "2026-03-31T00:34:03.859Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb90c248d4e274f31c131",
+      "lastUpdated": "2026-04-02T00:32:11.939Z"
     },
     "no-provision.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7706a177a05bccd1cf",
       "lastUpdated": "2026-03-03T00:32:25.279Z"
     },
     "ai.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb167af6a1c5774e8059b3",
-      "lastUpdated": "2026-03-31T01:00:46.789Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb90a248d4e274f31c130",
+      "lastUpdated": "2026-04-02T01:00:30.163Z"
     },
     "popup-loading.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698bc89f7140c3fa7daaca8d/698bca7f7140c3fa7daacbf7",
@@ -134,12 +134,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb166ff6a1c5774e8059ac",
-      "lastUpdated": "2026-03-31T00:34:26.048Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb8fa248d4e274f31c129",
+      "lastUpdated": "2026-04-02T00:32:43.247Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69cb165bf6a1c5774e80599d/69cb167df6a1c5774e8059b5",
-      "lastUpdated": "2026-03-31T00:35:11.393Z"
+      "url": "https://console-test.testdriver.ai/runs/69cdb8dd248d4e274f31c11a/69cdb90e248d4e274f31c132",
+      "lastUpdated": "2026-04-02T00:33:51.354Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/snippets/tests/scroll-yaml.mdx

@@ -14,7 +14,7 @@ steps:
       - command: press-keys
         keys:
           - enter
-  - prompt: scroll down with the mouse 1000 pixels
+  - prompt: scroll down with the mouse 10 clicks
     commands:
       - command: hover-text
         text: "HTML: HyperText Markup Language"
@@ -22,7 +22,7 @@ steps:
         action: click
       - command: scroll
         direction: down
-        amount: 1000
+        amount: 10
   - prompt: assert the page is scrolled
     commands:
       - command: assert

package/docs/v6/commands/scroll-until-image.mdx

@@ -22,7 +22,7 @@ The `scroll-until-image` command is used to scroll the screen in a specified dir
 | :-----------: | :-------: | :---------------------------------------------------------------------------------------------------------------------- |
 | `description` | `string`  | A description of the image and what it represents.                                                                      |
 |  `direction`  | `string`  | (Optional) The direction to scroll. Available directions are: `up`, `down`, `left`, `right`. Defaults to `down`.        |
-|  `distance`   | `number`  | (Optional) The maximum number of pixels to scroll before giving up. Default is `10000`.                                 |
+|  `distance`   | `number`  | (Optional) The maximum number of scroll clicks before giving up. Default is `100`.                                 |
 |   `method`    | `string`  | (Optional) The method to use to scroll the page. Available methods are: `mouse` and `keyboard`. Defaults to `keyboard`. |
 |    `path`     | `string`  | (Optional) The relative path to the image file that needs to be matched on the screen.                                  |
 |   `invert`    | `boolean` | (Optional) If set to `true`, the command will scroll until the specified image is NOT detected. Default is `false`.     |