testdriverai 7.5.26 → 7.6.0-test.1

package/interfaces/vitest-plugin.mjs

@@ -9,6 +9,7 @@ import { setTestRunInfo } from "./shared-test-state.mjs";
 
 // Use createRequire to import CommonJS modules without esbuild processing
 const require = createRequire(import.meta.url);
+const channelConfig = require("../channel.json");
 
 // Import Sentry for error reporting
 const Sentry = require("@sentry/node");
@@ -763,7 +764,7 @@ export default function testDriverPlugin(options = {}) {
   pluginState.apiRoot =
     options.apiRoot ||
     process.env.TD_API_ROOT ||
-    "https://api.testdriver.ai";
+    channelConfig.channels[channelConfig.active];
   pluginState.ciProvider = detectCI();
   pluginState.gitInfo = getGitInfo();
 
@@ -822,7 +823,7 @@ class TestDriverReporter {
     pluginState.apiRoot =
       this.options.apiRoot ||
       process.env.TD_API_ROOT ||
-      "https://api.testdriver.ai";
+      channelConfig.channels[channelConfig.active];
     logger.debug("API key from options:", !!this.options.apiKey);
     logger.debug("API key from env (at onInit):", !!process.env.TD_API_KEY);
     logger.debug("API root from options:", this.options.apiRoot);
@@ -1258,6 +1259,26 @@ function getConsoleUrl(apiRoot) {
     return `http://localhost:3001`;
   }
 
+  // Render PR previews: map API service to Web service
+  // canary-api-pr-123.onrender.com -> canary-web-pr-123.onrender.com
+  // testdriver-api-i4m4-pr-123.onrender.com -> web-i4m4-pr-123.onrender.com
+  const renderPrMatch = apiRoot.match(/https:\/\/([\w-]+)-api(-[\w]+)?(-pr-\d+)?\.onrender\.com/);
+  if (renderPrMatch) {
+    const [, prefix, suffix, prSuffix] = renderPrMatch;
+    // Map API naming to Web naming:
+    // canary-api -> canary-web
+    // testdriver-api-i4m4 -> web-i4m4
+    let webPrefix;
+    if (prefix === 'testdriver' && suffix) {
+      // testdriver-api-i4m4 -> web-i4m4
+      webPrefix = 'web' + suffix;
+    } else {
+      // canary-api -> canary-web
+      webPrefix = prefix + '-web';
+    }
+    return `https://${webPrefix}${prSuffix || ''}.onrender.com`;
+  }
+
   // Other tunnels or unknown hosts: return as-is
   return apiRoot;
 }

package/lib/core/Dashcam.js

@@ -80,8 +80,9 @@ class Dashcam {
    * @private
    */
   _getApiRoot() {
+    const channelConfig = require("../../channel.json");
     return (
-      this.client.config?.TD_API_ROOT || "https://api.testdriver.ai"
+      this.client.config?.TD_API_ROOT || channelConfig.channels[channelConfig.active]
     );
   }
 
@@ -91,7 +92,7 @@ class Dashcam {
    * @param {string} apiRoot - The API root URL
    * @returns {string} The corresponding console URL
    */
-  static getConsoleUrl(apiRoot = "https://api.testdriver.ai") {
+  static getConsoleUrl(apiRoot = (() => { const c = require("../../channel.json"); return c.channels[c.active]; })()) {
     // Allow explicit override via env (e.g. VITE_DOMAIN from .env)
     if (process.env.VITE_DOMAIN) return process.env.VITE_DOMAIN;
 
@@ -110,6 +111,26 @@ class Dashcam {
       return "http://localhost:3001";
     }
 
+    // Render PR previews: map API service to Web service
+    // canary-api-pr-123.onrender.com -> canary-web-pr-123.onrender.com
+    // testdriver-api-i4m4-pr-123.onrender.com -> web-i4m4-pr-123.onrender.com
+    const renderPrMatch = apiRoot.match(/https:\/\/([\w-]+)-api(-[\w]+)?(-pr-\d+)?\.onrender\.com/);
+    if (renderPrMatch) {
+      const [, prefix, suffix, prSuffix] = renderPrMatch;
+      // Map API naming to Web naming:
+      // canary-api -> canary-web
+      // testdriver-api-i4m4 -> web-i4m4
+      let webPrefix;
+      if (prefix === 'testdriver' && suffix) {
+        // testdriver-api-i4m4 -> web-i4m4
+        webPrefix = 'web' + suffix;
+      } else {
+        // canary-api -> canary-web
+        webPrefix = prefix + '-web';
+      }
+      return `https://${webPrefix}${prSuffix || ''}.onrender.com`;
+    }
+
     // Cloudflare tunnels, custom domains, etc.: the web console is served
     // from the same origin as the API, so return apiRoot as-is.
     return apiRoot;

package/lib/init-project.js

@@ -337,40 +337,80 @@ jobs:
       progress("⊘ GitHub workflow already exists");
     }
 
-    // 6. Create VSCode MCP config
-    const vscodeDir = path.join(targetDir, ".vscode");
-    if (!fs.existsSync(vscodeDir)) {
-      fs.mkdirSync(vscodeDir, { recursive: true });
-    }
+    // 6. Setup MCP configuration
+    // When triggered from VS Code extension, create .vscode/mcp.json silently
+    // When triggered from CLI, use interactive add-mcp for user to select their MCP client
+    const isVscodeInit = process.env.TD_INIT_SOURCE === "vscode";
+
+    if (isVscodeInit) {
+      // VS Code extension: create .vscode/mcp.json directly
+      const vscodeDir = path.join(targetDir, ".vscode");
+      if (!fs.existsSync(vscodeDir)) {
+        fs.mkdirSync(vscodeDir, { recursive: true });
+      }
 
-    const mcpConfigFile = path.join(vscodeDir, "mcp.json");
-    if (!fs.existsSync(mcpConfigFile)) {
-      const mcpConfig = {
-        inputs: [
-          {
-            type: "promptString",
-            id: "testdriver-api-key",
-            description: "TestDriver API Key From https://console.testdriver.ai/team",
-            password: true,
-          },
-        ],
-        servers: {
-          testdriver: {
-            command: "npx",
-            args: ["-p", "testdriverai", "testdriverai-mcp"],
-            env: {
-              TD_API_KEY: "${input:testdriver-api-key}",
+      const mcpConfigFile = path.join(vscodeDir, "mcp.json");
+      if (!fs.existsSync(mcpConfigFile)) {
+        const mcpConfig = {
+          inputs: [
+            {
+              type: "promptString",
+              id: "testdriver-api-key",
+              description: "TestDriver API Key From https://console.testdriver.ai/team",
+              password: true,
+            },
+          ],
+          servers: {
+            testdriver: {
+              command: "npx",
+              args: ["-p", "testdriverai", "testdriverai-mcp"],
+              env: {
+                TD_API_KEY: "${input:testdriver-api-key}",
+              },
             },
           },
-        },
-      };
-      fs.writeFileSync(mcpConfigFile, JSON.stringify(mcpConfig, null, 2) + "\n");
-      progress("✓ Created MCP config: .vscode/mcp.json");
+        };
+        fs.writeFileSync(mcpConfigFile, JSON.stringify(mcpConfig, null, 2) + "\n");
+        progress("✓ Created MCP config: .vscode/mcp.json");
+      } else {
+        progress("⊘ MCP config already exists");
+      }
     } else {
-      progress("⊘ MCP config already exists");
+      // CLI: use add-mcp for interactive MCP client selection
+      progress("🔧 Setting up MCP integration...");
+      try {
+        const addMcpResult = require("child_process").spawnSync(
+          "npx",
+          [
+            "add-mcp",
+            "testdriver",
+            "--command",
+            "npx -p testdriverai testdriverai-mcp",
+            "--env",
+            "TD_API_KEY",
+          ],
+          {
+            cwd: targetDir,
+            stdio: "inherit", // Pass through stdin/stdout for interactive prompts
+            shell: process.platform === "win32",
+          }
+        );
+
+        if (addMcpResult.status === 0) {
+          progress("✓ MCP configured via add-mcp");
+        } else if (addMcpResult.status !== null) {
+          progress("⚠ MCP setup skipped or failed - you can run 'npx add-mcp testdriver' later");
+        }
+      } catch (err) {
+        progress("⚠ Could not run add-mcp - you can run 'npx add-mcp testdriver' later");
+      }
     }
 
     // 7. Create VSCode extensions recommendations
+    const vscodeDir = path.join(targetDir, ".vscode");
+    if (!fs.existsSync(vscodeDir)) {
+      fs.mkdirSync(vscodeDir, { recursive: true });
+    }
     const extensionsFile = path.join(vscodeDir, "extensions.json");
     if (!fs.existsSync(extensionsFile)) {
       const extensionsConfig = {

package/lib/vitest/hooks.mjs

@@ -22,6 +22,7 @@ import TestDriverSDK from "../../sdk.js";
 
 // Use createRequire to import CommonJS modules
 const require = createRequire(import.meta.url);
+const channelConfig = require("../../channel.json");
 
 /**
  * Minimum required Vitest major version
@@ -255,7 +256,7 @@ async function uploadLogsToReplay(client, dashcamUrl) {
     }
 
     // Use the SDK's configured API root (matches what the SDK uses for all other API calls)
-    const apiRoot = client.config?.TD_API_ROOT || process.env.TD_API_ROOT || "https://api.testdriver.ai";
+    const apiRoot = client.config?.TD_API_ROOT || process.env.TD_API_ROOT || channelConfig.channels[channelConfig.active];
 
     console.log(`[TestDriver] Uploading logs for replay ${replayId} to ${apiRoot}...`);
 

package/mcp-server/README.md

@@ -11,9 +11,19 @@ MCP server that enables AI agents to iteratively build TestDriver tests with vis
 
 ## Installation
 
-### Via npx (Recommended)
+### Quick Install (Recommended)
 
-No installation needed! Just configure your MCP client to use npx:
+Use `add-mcp` to automatically configure TestDriver for your MCP client:
+
+```bash
+npx add-mcp testdriver
+```
+
+This will prompt you to select your MCP client (VS Code, Cursor, Claude Desktop, etc.) and configure it automatically.
+
+### Manual Configuration
+
+If you prefer to configure manually, add the following to your MCP config file:
 
 ```json
 {

package/mcp-server/dist/codegen.js

@@ -141,7 +141,7 @@ export function generateActionCode(action, args, result) {
             return `const assertResult = await testdriver.assert("${escapeString(assertion)}");\nexpect(assertResult).toBeTruthy();`;
         }
         case "exec": {
-            const language = args.language || "js";
+            const language = args.language || "sh";
             const code = args.code;
             const timeout = args.timeout;
             if (code.includes("\n")) {

package/mcp-server/dist/server.mjs

@@ -23,9 +23,11 @@ import { sessionManager } from "./session.js";
 // Sentry
 // =============================================================================
 // Read version from main package.json (../../package.json from mcp-server/dist/)
-const packageJsonPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
-const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+const sdkRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+const packageJson = JSON.parse(fs.readFileSync(path.join(sdkRoot, "package.json"), "utf-8"));
 const version = packageJson.version || "1.0.0";
+const channelConfig = JSON.parse(fs.readFileSync(path.join(sdkRoot, "channel.json"), "utf-8"));
+const releaseChannel = channelConfig.active || "dev";
 const isSentryEnabled = () => {
     if (process.env.TD_TELEMETRY === "false") {
         return false;
@@ -37,7 +39,7 @@ if (isSentryEnabled()) {
     Sentry.init({
         dsn: process.env.SENTRY_DSN ||
             "https://452bd5a00dbd83a38ee8813e11c57694@o4510262629236736.ingest.us.sentry.io/4510480443637760",
-        environment: "mcp",
+        environment: releaseChannel,
         release: version,
         sampleRate: 1.0,
         tracesSampleRate: 1.0,
@@ -687,6 +689,7 @@ registerAppTool(server, "find", {
         const duration = Date.now() - startTime;
         // Store cropped image for resource serving (instead of inline data URL)
         let croppedImageResourceUri;
+        let screenshotResourceUri;
         const croppedImage = rawResponse.croppedImage;
         if (croppedImage) {
             const imageData = croppedImage.startsWith('data:')
@@ -696,6 +699,20 @@ registerAppTool(server, "find", {
             // Remove croppedImage from response to avoid context bloat
             delete rawResponse.croppedImage;
         }
+        else if (!found) {
+            // Element not found and no cropped image - capture a fresh screenshot
+            // so the user can see what's currently visible on screen
+            try {
+                const screenshotBase64 = await sdk.agent.system.captureScreenBase64(1, false, true);
+                if (screenshotBase64) {
+                    screenshotResourceUri = storeImage(screenshotBase64, "screenshot");
+                    logger.debug("find: Captured screenshot for not-found state");
+                }
+            }
+            catch (e) {
+                logger.warn("find: Failed to capture screenshot for not-found state", { error: String(e) });
+            }
+        }
         // Remove extractedText and pixelDiffImage from response to reduce context bloat
         delete rawResponse.extractedText;
         delete rawResponse.pixelDiffImage;
@@ -717,6 +734,7 @@ registerAppTool(server, "find", {
             element: elementInfo,
             ref: elementRef,
             croppedImageResourceUri,
+            screenshotResourceUri,
             duration,
         }, generatedCode);
     }
@@ -786,6 +804,7 @@ registerAppTool(server, "findall", {
         const duration = Date.now() - startTime;
         // Store cropped image for resource serving (instead of inline data URL)
         let croppedImageResourceUri;
+        let screenshotResourceUri;
         const croppedImage = rawResponse.croppedImage;
         if (croppedImage) {
             const imageData = croppedImage.startsWith('data:')
@@ -795,6 +814,20 @@ registerAppTool(server, "findall", {
             // Remove croppedImage from response to avoid context bloat
             delete rawResponse.croppedImage;
         }
+        else if (count === 0) {
+            // No elements found and no cropped image - capture a fresh screenshot
+            // so the user can see what's currently visible on screen
+            try {
+                const screenshotBase64 = await sdk.agent.system.captureScreenBase64(1, false, true);
+                if (screenshotBase64) {
+                    screenshotResourceUri = storeImage(screenshotBase64, "screenshot");
+                    logger.debug("findall: Captured screenshot for not-found state");
+                }
+            }
+            catch (e) {
+                logger.warn("findall: Failed to capture screenshot for not-found state", { error: String(e) });
+            }
+        }
         // Remove extractedText and pixelDiffImage from response to reduce context bloat
         delete rawResponse.extractedText;
         delete rawResponse.pixelDiffImage;
@@ -810,6 +843,7 @@ registerAppTool(server, "findall", {
             refs,
             elements: elementInfos,
             croppedImageResourceUri,
+            screenshotResourceUri,
             duration,
         }, generatedCode);
     }
@@ -1029,6 +1063,7 @@ registerAppTool(server, "find_and_click", {
             const duration = Date.now() - startTime;
             // Store cropped image (screenshot) for resource serving
             let croppedImageResourceUri;
+            let screenshotResourceUri;
             const croppedImage = rawResponse.croppedImage;
             if (croppedImage) {
                 const imageData = croppedImage.startsWith('data:')
@@ -1037,6 +1072,20 @@ registerAppTool(server, "find_and_click", {
                 croppedImageResourceUri = storeImage(imageData, "screenshot");
                 delete rawResponse.croppedImage;
             }
+            else {
+                // No cropped image - capture a fresh screenshot so the user can see
+                // what's currently visible on screen when element was not found
+                try {
+                    const screenshotBase64 = await sdk.agent.system.captureScreenBase64(1, false, true);
+                    if (screenshotBase64) {
+                        screenshotResourceUri = storeImage(screenshotBase64, "screenshot");
+                        logger.debug("find_and_click: Captured screenshot for not-found state");
+                    }
+                }
+                catch (e) {
+                    logger.warn("find_and_click: Failed to capture screenshot for not-found state", { error: String(e) });
+                }
+            }
             // Remove extractedText and pixelDiffImage from response to reduce context bloat
             delete rawResponse.extractedText;
             delete rawResponse.pixelDiffImage;
@@ -1045,6 +1094,7 @@ registerAppTool(server, "find_and_click", {
                 action: "find_and_click",
                 error: "Element not found",
                 croppedImageResourceUri,
+                screenshotResourceUri,
                 duration
             });
         }
@@ -1372,9 +1422,9 @@ You can optionally provide a reference image URI to compare against a previous s
 });
 // Exec
 server.registerTool("exec", {
-    description: "Execute code in the sandbox (JavaScript, shell, or PowerShell)",
+    description: "Execute shell or PowerShell commands in the sandbox",
     inputSchema: z.object({
-        language: z.enum(["js", "sh", "pwsh"]).default("js"),
+        language: z.enum(["sh", "pwsh"]).default("sh"),
         code: z.string().describe("Code to execute"),
         timeout: z.number().default(30000).describe("Timeout in ms"),
     }),

package/mcp-server/src/codegen.ts

@@ -161,7 +161,7 @@ export function generateActionCode(
     }
 
     case "exec": {
-      const language = (args.language as string) || "js";
+      const language = (args.language as string) || "sh";
       const code = args.code as string;
       const timeout = args.timeout as number | undefined;
       

package/mcp-server/src/server.ts

@@ -30,9 +30,11 @@ import { sessionManager, type SessionState } from "./session.js";
 // =============================================================================
 
 // Read version from main package.json (../../package.json from mcp-server/dist/)
-const packageJsonPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
-const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+const sdkRoot = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+const packageJson = JSON.parse(fs.readFileSync(path.join(sdkRoot, "package.json"), "utf-8"));
 const version = packageJson.version || "1.0.0";
+const channelConfig = JSON.parse(fs.readFileSync(path.join(sdkRoot, "channel.json"), "utf-8"));
+const releaseChannel = channelConfig.active || "dev";
 
 const isSentryEnabled = () => {
   if (process.env.TD_TELEMETRY === "false") {
@@ -47,7 +49,7 @@ if (isSentryEnabled()) {
     dsn:
       process.env.SENTRY_DSN ||
       "https://452bd5a00dbd83a38ee8813e11c57694@o4510262629236736.ingest.us.sentry.io/4510480443637760",
-    environment: "mcp",
+    environment: releaseChannel,
     release: version,
     sampleRate: 1.0,
     tracesSampleRate: 1.0,
@@ -867,6 +869,7 @@ registerAppTool(
       
       // Store cropped image for resource serving (instead of inline data URL)
       let croppedImageResourceUri: string | undefined;
+      let screenshotResourceUri: string | undefined;
       const croppedImage = rawResponse.croppedImage;
       if (croppedImage) {
         const imageData = croppedImage.startsWith('data:') 
@@ -875,6 +878,18 @@ registerAppTool(
         croppedImageResourceUri = storeImage(imageData, "cropped");
         // Remove croppedImage from response to avoid context bloat
         delete rawResponse.croppedImage;
+      } else if (!found) {
+        // Element not found and no cropped image - capture a fresh screenshot
+        // so the user can see what's currently visible on screen
+        try {
+          const screenshotBase64 = await sdk.agent.system.captureScreenBase64(1, false, true);
+          if (screenshotBase64) {
+            screenshotResourceUri = storeImage(screenshotBase64, "screenshot");
+            logger.debug("find: Captured screenshot for not-found state");
+          }
+        } catch (e) {
+          logger.warn("find: Failed to capture screenshot for not-found state", { error: String(e) });
+        }
       }
       
       // Remove extractedText and pixelDiffImage from response to reduce context bloat
@@ -904,6 +919,7 @@ registerAppTool(
           element: elementInfo,
           ref: elementRef,
           croppedImageResourceUri,
+          screenshotResourceUri,
           duration,
         },
         generatedCode
@@ -988,6 +1004,7 @@ registerAppTool(
       
       // Store cropped image for resource serving (instead of inline data URL)
       let croppedImageResourceUri: string | undefined;
+      let screenshotResourceUri: string | undefined;
       const croppedImage = rawResponse.croppedImage;
       if (croppedImage) {
         const imageData = croppedImage.startsWith('data:') 
@@ -996,6 +1013,18 @@ registerAppTool(
         croppedImageResourceUri = storeImage(imageData, "cropped");
         // Remove croppedImage from response to avoid context bloat
         delete rawResponse.croppedImage;
+      } else if (count === 0) {
+        // No elements found and no cropped image - capture a fresh screenshot
+        // so the user can see what's currently visible on screen
+        try {
+          const screenshotBase64 = await sdk.agent.system.captureScreenBase64(1, false, true);
+          if (screenshotBase64) {
+            screenshotResourceUri = storeImage(screenshotBase64, "screenshot");
+            logger.debug("findall: Captured screenshot for not-found state");
+          }
+        } catch (e) {
+          logger.warn("findall: Failed to capture screenshot for not-found state", { error: String(e) });
+        }
       }
       
       // Remove extractedText and pixelDiffImage from response to reduce context bloat
@@ -1019,6 +1048,7 @@ registerAppTool(
           refs,
           elements: elementInfos,
           croppedImageResourceUri,
+          screenshotResourceUri,
           duration,
         },
         generatedCode
@@ -1317,6 +1347,7 @@ registerAppTool(
         
         // Store cropped image (screenshot) for resource serving
         let croppedImageResourceUri: string | undefined;
+        let screenshotResourceUri: string | undefined;
         const croppedImage = rawResponse.croppedImage;
         if (croppedImage) {
           const imageData = croppedImage.startsWith('data:') 
@@ -1324,6 +1355,18 @@ registerAppTool(
             : croppedImage;
           croppedImageResourceUri = storeImage(imageData, "screenshot");
           delete rawResponse.croppedImage;
+        } else {
+          // No cropped image - capture a fresh screenshot so the user can see
+          // what's currently visible on screen when element was not found
+          try {
+            const screenshotBase64 = await sdk.agent.system.captureScreenBase64(1, false, true);
+            if (screenshotBase64) {
+              screenshotResourceUri = storeImage(screenshotBase64, "screenshot");
+              logger.debug("find_and_click: Captured screenshot for not-found state");
+            }
+          } catch (e) {
+            logger.warn("find_and_click: Failed to capture screenshot for not-found state", { error: String(e) });
+          }
         }
         
         // Remove extractedText and pixelDiffImage from response to reduce context bloat
@@ -1338,6 +1381,7 @@ registerAppTool(
             action: "find_and_click",
             error: "Element not found", 
             croppedImageResourceUri,
+            screenshotResourceUri,
             duration 
           }
         );
@@ -1760,9 +1804,9 @@ You can optionally provide a reference image URI to compare against a previous s
 server.registerTool(
   "exec",
   {
-    description: "Execute code in the sandbox (JavaScript, shell, or PowerShell)",
+    description: "Execute shell or PowerShell commands in the sandbox",
     inputSchema: z.object({
-      language: z.enum(["js", "sh", "pwsh"]).default("js"),
+      language: z.enum(["sh", "pwsh"]).default("sh"),
       code: z.string().describe("Code to execute"),
       timeout: z.number().default(30000).describe("Timeout in ms"),
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.5.26",
+  "version": "7.6.0-test.1",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "types": "sdk.d.ts",
@@ -47,7 +47,11 @@
     "bundle": "node build.mjs",
     "test": "mocha test/*",
     "test:sdk": "vitest run",
-    "test:sdk:windows": "TEST_PLATFORM=windows vitest run",
+    "test:sdk:dev": "vitest run --project dev",
+    "test:sdk:staging": "vitest run --project staging",
+    "test:sdk:canary": "vitest run --project canary",
+    "test:sdk:stable": "vitest run --project stable",
+    "test:sdk:windows": "TD_OS=windows vitest run",
     "test:sdk:mac": "TEST_PLATFORM=mac vitest run",
     "test:sdk:linux": "TEST_PLATFORM=linux vitest run",
     "test:sdk:watch": "vitest",

package/sdk.d.ts

@@ -13,7 +13,7 @@ export type ClickAction =
 export type ScrollDirection = "up" | "down" | "left" | "right";
 export type ScrollMethod = "keyboard" | "mouse";
 export type TextMatchMethod = "ai" | "turbo";
-export type ExecLanguage = "js" | "pwsh" | "sh";
+export type ExecLanguage = "sh" | "pwsh";
 /**
  * Preview mode for live test visualization
  * - "browser": Opens debugger in default browser (default)
@@ -218,7 +218,7 @@ export type KeyboardKey =
   | "optionright";
 
 export interface TestDriverOptions {
-  /** API endpoint URL (default: 'https://v6.testdriver.ai') */
+  /** API endpoint URL (default depends on release channel: latest → 'https://api.testdriver.ai') */
   apiRoot?: string;
   /** Sandbox resolution (default: '1366x768') */
   resolution?: string;