@testdriverai/mcp 7.10.0-canary.0 → 7.10.1-test

package/docs/v7/scroll.mdx

@@ -27,21 +27,21 @@ Scroll the page or active element in any direction using mouse wheel or keyboard
 ## Syntax
 
 ```javascript
-await testdriver.scroll(direction, amount, method)
+await testdriver.scroll(direction, options)
 ```
 
 ## Parameters
 
 <ParamField path="direction" type="string" default="down">
-  Direction to scroll: `'up'`, `'down'`, `'left'`, `'right'`
+  Direction to scroll: `'up'`, `'down'`
 </ParamField>
 
-<ParamField path="amount" type="number" default="300">
-  Amount to scroll in pixels
-</ParamField>
-
-<ParamField path="method" type="string" default="mouse">
-  Scroll method: `'mouse'` or `'keyboard'`
+<ParamField path="options" type="object">
+  <Expandable title="properties">
+    <ParamField path="amount" type="number" default="300">
+      Amount to scroll in pixels
+    </ParamField>
+  </Expandable>
 </ParamField>
 
 ## Returns
@@ -56,95 +56,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', { amount: 5 });
 
 // Scroll up
 await testdriver.scroll('up');
 
-// Scroll up 200 pixels
-await testdriver.scroll('up', 200);
+// Scroll up 2 clicks
+await testdriver.scroll('up', { amount: 2 });
 ```
 
 ### Horizontal Scrolling
 
 ```javascript
 // Scroll right
-await testdriver.scroll('right', 300);
+await testdriver.scroll('right', { amount: 3 });
 
 // Scroll left
-await testdriver.scroll('left', 300);
+await testdriver.scroll('left', { amount: 3 });
 ```
 
 ### Scroll Methods
 
 ```javascript
-// Mouse wheel scroll (smooth, pixel-precise)
-await testdriver.scroll('down', 300, '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);
+// Mouse wheel scroll (default)
+await testdriver.scroll('down', { amount: 3 });
 
-// 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);
+// For keyboard-based scrolling, use pressKeys instead
+await testdriver.pressKeys(['pagedown']);
 ```
 
 ## Best Practices
@@ -163,7 +102,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');
   
   // If scroll still doesn't work, use Page Down directly
   // await testdriver.pressKeys(['pagedown']);
@@ -171,84 +110,31 @@ await testdriver.scrollUntilImage('loading spinner', 'down', 5000, 'keyboard', n
 </Check>
 
 <Check>
-  **Choose the right scroll method**
-  
-  ```javascript
-  // For web pages, mouse scroll is usually smoother
-  await testdriver.scroll('down', 300, 'mouse');
-  
-  // For desktop apps or when mouse doesn't work
-  await testdriver.scroll('down', 300, 'keyboard');
-  ```
-</Check>
-
-<Check>
-  **Use scrollUntil for dynamic content**
+  **Control scroll distance with the options object**
   
   ```javascript
-  // Instead of guessing scroll amount
-  await testdriver.scrollUntilText('Load More button');
+  // For web pages, mouse scroll works well
+  await testdriver.scroll('down', { amount: 3 });
   
-  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
+  // For desktop apps or when mouse doesn't work, use keyboard
+  await testdriver.pressKeys(['pagedown']);
   ```
 </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', { amount: 5 });
       await new Promise(r => setTimeout(r, 1000)); // Wait for load
     }
     ```
@@ -257,7 +143,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', { amount: 3 });
     await new Promise(r => setTimeout(r, 500));
     
     const nextImage = await testdriver.find('next image in carousel');
@@ -288,8 +174,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', { amount: 5 });
     
     // Click footer link
     const privacyLink = await testdriver.find('Privacy Policy link');
@@ -303,29 +189,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', { amount: 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/docs/v7/wait.mdx

@@ -49,4 +49,4 @@ await testdriver.wait();
   const element = await testdriver.find('success message');
   ```
 - Avoid excessively long timeouts to keep tests efficient.
-- Use sparingly — TestDriver's [redraw detection](/v7/waiting-for-elements) automatically waits for screen and network stability after each action.
+- Use sparingly — TestDriver's [redraw detection](/v7/performing-actions#waiting-for-dynamic-content) automatically waits for screen and network stability after each action.

package/examples/chrome-extension.test.mjs

@@ -52,18 +52,35 @@ describe("Chrome Extension Test", () => {
     // The hello-world extension adds a puzzle piece icon to the toolbar
     // When clicked, it shows a popup with "Hello Extensions"
 
-    // Click on the extensions button (puzzle piece icon) in Chrome toolbar
-    const extensionsButton = await testdriver.find("The extensions button in the Chrome toolbar", {zoom: true});
-    await extensionsButton.click();
-
-    // Look for the hello world extension in the extensions menu
-    const helloExtension = await testdriver.find("Hello Extensions extension in the extensions dropdown");
-    await helloExtension.click();
-
-    await testdriver.wait(2000); // wait for the popup to open
-
-    // Verify the extension popup shows "Hello Extensions" text
-    const popupResult = await testdriver.assert("a popup shows with the text 'Hello Extensions'");
+    // Retry opening the extension popup and verifying it up to 3 times
+    let popupResult;
+    let lastError;
+    for (let attempt = 1; attempt <= 3; attempt++) {
+      try {
+        // Click on the extensions button (puzzle piece icon) in Chrome toolbar
+        const extensionsButton = await testdriver.find("The extensions button in the Chrome toolbar", {zoom: true, verify: true, timeout: 10000});
+        await extensionsButton.click();
+
+        // Look for the hello world extension in the extensions menu
+        const helloExtension = await testdriver.find("Hello Extensions extension in the extensions dropdown", {zoom: true, verify: true, timeout: 10000});
+        await helloExtension.click();
+
+        await testdriver.wait(2000); // wait for the popup to open
+
+        // Verify the extension popup shows "Hello Extensions" text
+        popupResult = await testdriver.assert("a popup shows with the text 'Hello Extensions'");
+        if (popupResult) break;
+      } catch (err) {
+        lastError = err;
+        console.log(`Attempt ${attempt} failed:`, err.message);
+      }
+      if (attempt < 3) {
+        // Dismiss any open popup/menu before retrying
+        await testdriver.pressKeys(["escape"]);
+        await testdriver.wait(1000);
+      }
+    }
+    if (!popupResult && lastError) throw lastError;
     expect(popupResult).toBeTruthy();
   });
 

package/examples/config.mjs

@@ -1,5 +1,5 @@
 export const getDefaults = (context) => ({
   ip: context.ip || process.env.TD_IP,
-  redraw: { enabled: false },
   preview: 'web',
+  cache: 'false'
 });

package/examples/launch-vscode-linux.test.mjs

@@ -22,34 +22,34 @@ describe("Launch VS Code on Linux", () => {
     },
   );
 
-  it.skipIf(!isLinux)(
-    "should install and use a VS Code extension",
-    async (context) => {
-      const testdriver = TestDriver(context, { ...getDefaults(context) });
+  // it.skipIf(!isLinux)(
+  //   "should install and use a VS Code extension",
+  //   async (context) => {
+  //     const testdriver = TestDriver(context, { ...getDefaults(context) });
       
-      // Launch VS Code with the Prettier extension installed
-      await testdriver.provision.vscode({
-        extensions: ["esbenp.prettier-vscode"],
-      });
+  //     // Launch VS Code with the Prettier extension installed
+  //     await testdriver.provision.vscode({
+  //       extensions: ["esbenp.prettier-vscode"],
+  //     });
 
-      const vsCodeWindow = await testdriver.find(
-        "Visual Studio Code window",
-        { timeout: 60000 }
-      );
+  //     const vsCodeWindow = await testdriver.find(
+  //       "Visual Studio Code window",
+  //       { timeout: 60000 }
+  //     );
 
-      expect(vsCodeWindow.found()).toBeTruthy();
+  //     expect(vsCodeWindow.found()).toBeTruthy();
 
-      // Open the extensions panel to verify Prettier is installed
-      await testdriver.pressKeys(["ctrl", "shift", "x"]);
+  //     // Open the extensions panel to verify Prettier is installed
+  //     await testdriver.pressKeys(["ctrl", "shift", "x"]);
       
-      // Wait for extensions panel to open
-      await new Promise((resolve) => setTimeout(resolve, 2000));
-
-      // Assert that Prettier extension is visible in the installed extensions
-      const prettierVisible = await testdriver.assert(
-        "Prettier extension is visible in the extensions panel or sidebar",
-      );
-      expect(prettierVisible).toBeTruthy();
-    },
-  );
+  //     // Wait for extensions panel to open
+  //     await new Promise((resolve) => setTimeout(resolve, 2000));
+
+  //     // Assert that Prettier extension is visible in the installed extensions
+  //     const prettierVisible = await testdriver.assert(
+  //       "Prettier extension is visible in the extensions panel or sidebar",
+  //     );
+  //     expect(prettierVisible).toBeTruthy();
+  //   },
+  // );
 });

package/interfaces/cli/commands/init.js

@@ -1,6 +1,7 @@
 const BaseCommand = require("../lib/base.js");
 const { createCommandDefinitions } = require("../../../agent/interface.js");
 const { initProject } = require("../../../lib/init-project.js");
+const { CLIENTS, detectClients } = require("../../../lib/install-clients.js");
 const fs = require("fs");
 const path = require("path");
 const chalk = require("chalk");
@@ -22,13 +23,24 @@ const POLL_TIMEOUT = 900000; // 15 minutes
  */
 class InitCommand extends BaseCommand {
   async run() {
-    await this.parse(InitCommand);
+    const { flags } = await this.parse(InitCommand);
 
     console.log(chalk.cyan("\n🚀 Initializing TestDriver project...\n"));
 
     // Prompt for API key first
     const apiKey = await this.promptForApiKey();
 
+    // Determine which AI clients to wire up: from --client flag, or interactively.
+    let clients;
+    if (flags.client) {
+      clients = flags.client
+        .split(",")
+        .map((c) => c.trim())
+        .filter(Boolean);
+    } else {
+      clients = await this.promptForClients();
+    }
+
     // Helper to print progress messages with appropriate colors
     const printProgress = (msg) => {
       if (msg.startsWith("✓")) {
@@ -47,6 +59,10 @@ class InitCommand extends BaseCommand {
       targetDir: process.cwd(),
       apiKey: apiKey,
       skipInstall: false,
+      // --no-sample-test sets flags["sample-test"] to false
+      skipSampleTest: flags["sample-test"] === false,
+      clients: clients && clients.length ? clients : undefined,
+      channel: channelConfig.active,
       onProgress: printProgress,
     });
 
@@ -159,6 +175,72 @@ class InitCommand extends BaseCommand {
     }
   }
 
+  /**
+   * Prompt the user to select which AI clients to install TestDriver into.
+   * Returns an array of client ids (possibly empty).
+   * @returns {Promise<string[]>}
+   */
+  async promptForClients() {
+    const ids = Object.keys(CLIENTS);
+    const detected = new Set(detectClients(process.cwd()));
+
+    // Non-interactive stdin (CI, piped input, no TTY): don't prompt — fall back
+    // to detected clients so init can still scaffold all files unattended.
+    if (!process.stdin.isTTY) {
+      return [...detected];
+    }
+
+    console.log(chalk.cyan("\n  Which AI clients should TestDriver be installed into?\n"));
+    ids.forEach((id, i) => {
+      const c = CLIENTS[id];
+      const tag = detected.has(id) ? chalk.green(" (detected)") : "";
+      const web = c.type === "web" ? chalk.gray(" — web, manual steps") : "";
+      console.log(`  ${chalk.cyan(i + 1)}. ${c.label}${tag}${web}`);
+    });
+    console.log(`  ${chalk.cyan("a")}. All of the above`);
+    console.log(
+      chalk.gray(
+        "\n  Enter numbers separated by commas (e.g. 1,3), 'a' for all, or press Enter to skip.\n",
+      ),
+    );
+
+    const answer = await new Promise((resolve) => {
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+      });
+      // Default to detected clients if any, else skip.
+      const defaultHint = detected.size
+        ? ` [${[...detected].map((d) => ids.indexOf(d) + 1).join(",")}]`
+        : "";
+      let answered = false;
+      rl.question(`  Select clients${defaultHint}: `, (a) => {
+        answered = true;
+        rl.close();
+        resolve(a.trim());
+      });
+      // If stdin closes (EOF) before a line is entered, the question callback
+      // never fires — resolve empty so init doesn't hang.
+      rl.on("close", () => {
+        if (!answered) resolve("");
+      });
+    });
+
+    if (!answer) {
+      // Enter pressed: use detected clients if any, otherwise none.
+      return [...detected];
+    }
+    if (answer.toLowerCase() === "a" || answer.toLowerCase() === "all") {
+      return ["all"];
+    }
+    const selected = answer
+      .split(",")
+      .map((s) => parseInt(s.trim(), 10))
+      .filter((n) => Number.isInteger(n) && n >= 1 && n <= ids.length)
+      .map((n) => ids[n - 1]);
+    return selected;
+  }
+
   /**
    * Browser-based login flow using device code
    * @returns {Promise<string>} The API key
@@ -411,7 +493,7 @@ class InitCommand extends BaseCommand {
     console.log("  2. Use AI agents to write tests:");
     console.log(chalk.gray("     Open VSCode/Cursor and use @testdriver agent\n"));
     console.log("  3. MCP server configured:");
-    console.log(chalk.gray("     TestDriver tools available via MCP in .vscode/mcp.json\n"));
+    console.log(chalk.gray("     TestDriver tools are now available in your selected AI client(s)\n"));
     console.log(
       "  4. For CI/CD, add TD_API_KEY to your GitHub repository secrets",
     );