testdriverai 7.5.26 → 7.6.0-test.0

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

@@ -687,6 +687,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 +697,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 +732,7 @@ registerAppTool(server, "find", {
             element: elementInfo,
             ref: elementRef,
             croppedImageResourceUri,
+            screenshotResourceUri,
             duration,
         }, generatedCode);
     }
@@ -786,6 +802,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 +812,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 +841,7 @@ registerAppTool(server, "findall", {
             refs,
             elements: elementInfos,
             croppedImageResourceUri,
+            screenshotResourceUri,
             duration,
         }, generatedCode);
     }
@@ -1029,6 +1061,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 +1070,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 +1092,7 @@ registerAppTool(server, "find_and_click", {
                 action: "find_and_click",
                 error: "Element not found",
                 croppedImageResourceUri,
+                screenshotResourceUri,
                 duration
             });
         }
@@ -1372,9 +1420,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

@@ -867,6 +867,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 +876,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 +917,7 @@ registerAppTool(
           element: elementInfo,
           ref: elementRef,
           croppedImageResourceUri,
+          screenshotResourceUri,
           duration,
         },
         generatedCode
@@ -988,6 +1002,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 +1011,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 +1046,7 @@ registerAppTool(
           refs,
           elements: elementInfos,
           croppedImageResourceUri,
+          screenshotResourceUri,
           duration,
         },
         generatedCode
@@ -1317,6 +1345,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 +1353,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 +1379,7 @@ registerAppTool(
             action: "find_and_click",
             error: "Element not found", 
             croppedImageResourceUri,
+            screenshotResourceUri,
             duration 
           }
         );
@@ -1760,9 +1802,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.0",
   "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;

package/sdk.js

@@ -1402,7 +1402,7 @@ function normalizeRedrawOptions(opts) {
  * @typedef {'up' | 'down' | 'left' | 'right'} ScrollDirection
  * @typedef {'keyboard' | 'mouse'} ScrollMethod
  * @typedef {'ai' | 'turbo'} TextMatchMethod
- * @typedef {'js' | 'pwsh'} ExecLanguage
+ * @typedef {'sh' | 'pwsh'} ExecLanguage
  * @typedef {'\\t' | '\n' | '\r' | ' ' | '!' | '"' | '#' | '$' | '%' | '&' | "'" | '(' | ')' | '*' | '+' | ',' | '-' | '.' | '/' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | ':' | ';' | '<' | '=' | '>' | '?' | '@' | '[' | '\\' | ']' | '^' | '_' | '`' | 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z' | '{' | '|' | '}' | '~' | 'accept' | 'add' | 'alt' | 'altleft' | 'altright' | 'apps' | 'backspace' | 'browserback' | 'browserfavorites' | 'browserforward' | 'browserhome' | 'browserrefresh' | 'browsersearch' | 'browserstop' | 'capslock' | 'clear' | 'convert' | 'ctrl' | 'ctrlleft' | 'ctrlright' | 'decimal' | 'del' | 'delete' | 'divide' | 'down' | 'end' | 'enter' | 'esc' | 'escape' | 'execute' | 'f1' | 'f10' | 'f11' | 'f12' | 'f13' | 'f14' | 'f15' | 'f16' | 'f17' | 'f18' | 'f19' | 'f2' | 'f20' | 'f21' | 'f22' | 'f23' | 'f24' | 'f3' | 'f4' | 'f5' | 'f6' | 'f7' | 'f8' | 'f9' | 'final' | 'fn' | 'hanguel' | 'hangul' | 'hanja' | 'help' | 'home' | 'insert' | 'junja' | 'kana' | 'kanji' | 'launchapp1' | 'launchapp2' | 'launchmail' | 'launchmediaselect' | 'left' | 'modechange' | 'multiply' | 'nexttrack' | 'nonconvert' | 'num0' | 'num1' | 'num2' | 'num3' | 'num4' | 'num5' | 'num6' | 'num7' | 'num8' | 'num9' | 'numlock' | 'pagedown' | 'pageup' | 'pause' | 'pgdn' | 'pgup' | 'playpause' | 'prevtrack' | 'print' | 'printscreen' | 'prntscrn' | 'prtsc' | 'prtscr' | 'return' | 'right' | 'scrolllock' | 'select' | 'separator' | 'shift' | 'shiftleft' | 'shiftright' | 'sleep' | 'space' | 'stop' | 'subtract' | 'tab' | 'up' | 'volumedown' | 'volumemute' | 'volumeup' | 'win' | 'winleft' | 'winright' | 'yen' | 'command' | 'option' | 'optionleft' | 'optionright'} KeyboardKey
  */
 
@@ -2864,6 +2864,9 @@ CAPTCHA_SOLVER_EOF`,
       sandboxId: this.instance?.instanceId,
     });
 
+    // Log environment info (non-blocking, skip on stable)
+    this._logEnvironmentInfo();
+
     return this.instance;
   }
 
@@ -2892,8 +2895,10 @@ CAPTCHA_SOLVER_EOF`,
 
     // Always close the sandbox WebSocket connection to clean up resources
     // This ensures we don't leave orphaned connections even if connect() failed
+    // Must be awaited so presence.leave() completes before we return —
+    // otherwise the concurrency counter on the API stays stale.
     if (this.sandbox && typeof this.sandbox.close === "function") {
-      this.sandbox.close();
+      await this.sandbox.close();
     }
 
     // Remove all event listeners on the emitter to release references
@@ -3801,6 +3806,46 @@ CAPTCHA_SOLVER_EOF`,
    * Set up logging for the SDK
    * @private
    */
+  /**
+   * Log environment info (version, API URL, git commit) after connect.
+   * Fires asynchronously so it never blocks the test.
+   * Suppressed when the API reports the "stable" channel.
+   * @private
+   */
+  _logEnvironmentInfo() {
+    const apiRoot = this.config?.TD_API_ROOT || 'unknown';
+    const sdkVersion = require('./package.json').version;
+    const http = apiRoot.startsWith('https') ? require('https') : require('http');
+
+    const url = apiRoot + '/api/entrance/version';
+    const req = http.get(url, { timeout: 5000 }, (res) => {
+      let data = '';
+      res.on('data', (chunk) => { data += chunk; });
+      res.on('end', () => {
+        try {
+          const info = JSON.parse(data);
+          if (info.channel === 'stable') return; // don't show on stable
+          const commit = info.commit || 'unknown';
+          const shortCommit = commit.substring(0, 7);
+          const commitUrl = commit !== 'unknown'
+            ? `https://github.com/testdriverai/mono/commit/${commit}`
+            : null;
+          const lines = [
+            '',
+            `  TestDriver SDK v${sdkVersion}`,
+            `  API: ${apiRoot} (${info.channel || 'unknown'} v${info.version || '?'})`,
+            commitUrl
+              ? `  Commit: ${shortCommit} → ${commitUrl}`
+              : `  Commit: ${shortCommit}`,
+            '',
+          ];
+          console.log(lines.join('\n'));
+        } catch (_) { /* ignore parse errors */ }
+      });
+    });
+    req.on('error', () => { /* ignore network errors */ });
+  }
+
   _setupLogging() {
     // Track the last fatal error message to throw on exit
     let lastFatalError = null;