testdriverai 7.5.25 → 7.5.26

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+## 7.5.26 (2026-03-11)
+
+## ✨ Features
+
+- Add stable and canary deployment channels for better release management [API] (50347881)
+- Add version API endpoint to provide deployment channel information [API] (50347881)
+- Add new AI skill for waiting operations in test automation [SDK] (50347881)
+- Add customer testimonials section to marketing site (50347881)
+- Add contact and demo pages to marketing site (50347881)
+- Add user limit checking for team invitations [API] (50347881)
+- Improve test analytics dashboard with enhanced data visualization [Web] (50347881)
+- Improve test case management interface with better filtering and search [Web] (50347881)
+- Improve test run detail view with more comprehensive information [Web] (50347881)
+- Add PostHog analytics integration for better user tracking (50347881)
+
+## 🐛 Bug Fixes
+
+- Fix network logs screenshot filename in marketing assets (50347881)
+- Improve invite validation flow for team management [API] (50347881)
+
+## 🔧 Maintenance
+
+- Update pricing configuration with shared pricing data structure (50347881)
+- Enhance release workflow to support dual-branch publishing (50347881)
+- Update environment configuration for stable and canary deployments (50347881)
+- Improve sandbox agent error handling and logging [Runner] (50347881)
+- Update SDK examples with better configuration handling [SDK] (50347881)
+- Enhance debugger interface with improved styling [SDK] (50347881)
+
 ## 7.5.25 (2026-03-09)
 
 ## 🐛 Bug Fixes

package/agent/index.js

@@ -1918,12 +1918,12 @@ ${regression}
       const encodedData = Buffer.from(JSON.stringify(data)).toString("base64");
 
       // Build debugger URL — hosted on S3 (v7-vnc bucket)
-      const debuggerBase = process.env.TD_DEBUGGER_BASE_URL || "https://v7-vnc.s3.us-east-2.amazonaws.com";
-      const urlToOpen = `${debuggerBase}/index.html?data=${encodedData}`;
+      const debuggerBase = process.env.TD_DEBUGGER_BASE_URL || "http://v7-vnc.s3.us-east-2.amazonaws.com";
+      // URL-encode the base64 data to handle +, /, = characters safely
+      const urlToOpen = `${debuggerBase}/index.html?data=${encodeURIComponent(encodedData)}`;
 
       // Check preview mode from CLI options (SDK passes it directly)
       const previewMode = (this.cliArgs.options && this.cliArgs.options.preview) || this.config.TD_PREVIEW || "browser";
-      console.log("[DEBUG renderSandbox] preview:", previewMode);
 
       if (previewMode === "ide") {
         // Send session to VS Code extension via HTTP

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

@@ -369,7 +369,7 @@ You can customize the AMI to include additional software or configurations:
   <Step title="Connect via RDP">
     Use the default credentials:
     - **Username**: `testdriver`
-    - **Password**: `changemeABC123`
+    - **Password**: `wwv9uJ0sqlulbN3`
   </Step>
   
   <Step title="Change the Password">

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

@@ -0,0 +1,50 @@
+---
+name: testdriver:wait
+description: Pause the execution of the script for a specified duration.
+---
+<!-- Generated from wait.mdx. DO NOT EDIT. -->
+
+## Description
+
+The `wait` method pauses test execution for a specified number of milliseconds before continuing. This is useful for adding delays between actions, waiting for animations to complete, or pausing for state changes to settle.
+
+## Syntax
+
+```javascript
+await testdriver.wait(timeout);
+```
+
+## Arguments
+
+| Argument  | Type     | Default | Description                           |
+| --------- | -------- | ------- | ------------------------------------- |
+| `timeout` | `number` | `3000`  | The duration in milliseconds to wait. |
+
+## Examples
+
+```javascript
+// Wait 2 seconds for an animation to complete
+await testdriver.find('submit button').click();
+await testdriver.wait(2000);
+
+// Wait 5 seconds
+await testdriver.wait(5000);
+
+// Wait with default timeout (3 seconds)
+await testdriver.wait();
+```
+
+## Best Practices
+
+- **Use for simple delays** — waiting for animations, transitions, or state changes after an action.
+- **Avoid for element waiting** — if you're waiting for a specific element to appear, use `find()` with a `timeout` option instead:
+  ```javascript
+  // ✅ Better for waiting for elements
+  const element = await testdriver.find('success message', { timeout: 30000 });
+
+  // ❌ Don't do this for element waiting
+  await testdriver.wait(5000);
+  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.

package/ai/skills/testdriver-waiting-for-elements/SKILL.md

@@ -85,4 +85,6 @@ await testdriver.find('next page button').click();
 await testdriver.wait(1000);
 ```
 
-For waiting for specific **elements** to appear, prefer `find()` with a `timeout` option. Use `wait()` only for simple time-based pauses.
+<Note>
+  For waiting for specific **elements** to appear, prefer `find()` with a `timeout` option. Use `wait()` only for simple time-based pauses.
+</Note>

package/debugger/index.html

@@ -354,8 +354,21 @@
           console.error("Error parsing data:", e);
         }
       }
+      // Demo mode: use mock data if no data param provided (for local dev)
       if (!parsedData || !parsedData.url) {
-        alert("Missing or invalid data parameter.");
+        const isLocalDev = window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1";
+        if (isLocalDev) {
+          console.log("[Debugger] No data param — using demo mode");
+          parsedData = {
+            url: "about:blank",
+            resolution: [1366, 768],
+            testFile: "demo-test.mjs",
+            os: "linux",
+            token: null,
+          };
+        } else {
+          alert("Missing or invalid data parameter.");
+        }
       }
 
       // Elements
@@ -402,9 +415,13 @@
         : "TestDriver";
       document.title = `${testFileName} - Debugger`;
 
-      // Embed the VNC URL in the iframe
+      // Embed the VNC URL in the iframe with token
       iframe.style.display = "block";
-      iframe.src = parsedData.url;
+      const vncUrl = new URL(parsedData.url);
+      if (parsedData.token) {
+        vncUrl.searchParams.set("token", parsedData.token);
+      }
+      iframe.src = vncUrl.toString();
 
       // Hide loading screen once iframe loads
       iframe.addEventListener("load", () => {

package/docs/docs.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://mintlify.com/docs.json",
-  "theme": "aspen",
+  "theme": "willow",
   "name": "TestDriver",
   "colors": {
     "primary": "#b3d334",

package/docs/v7/aws-setup.mdx

@@ -370,7 +370,7 @@ You can customize the AMI to include additional software or configurations:
   <Step title="Connect via RDP">
     Use the default credentials:
     - **Username**: `testdriver`
-    - **Password**: `changemeABC123`
+    - **Password**: `wwv9uJ0sqlulbN3`
   </Step>
   
   <Step title="Change the Password">

package/examples/config.mjs

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

package/examples/no-provision.test.mjs

@@ -1,24 +1,31 @@
 /**
- * TestDriver SDK - Assert Test (Vitest)
- * Converted from: testdriver/acceptance/assert.yaml
+ * TestDriver SDK - No-Provision Test with Dashcam (Vitest)
+ * 
+ * Demonstrates manual dashcam control without using provision methods.
+ * When not using provision.chrome(), provision.vscode(), etc., you need
+ * to manually start and stop dashcam recording.
  */
 
-import { describe, expect, it } from "vitest";
+import { describe, it } from "vitest";
 import { TestDriver } from "../lib/vitest/hooks.mjs";
 import { getDefaults } from "./config.mjs";
 
-describe("Assert Test", () => {
-  it("should assert the testdriver login page shows", async (context) => {
+describe("No-Provision with Dashcam", () => {
+  it("should record dashcam while asserting desktop is visible", async (context) => {
     const testdriver = TestDriver(context, { ...getDefaults(context) });
 
-    await testdriver.wait(10000)
+    // Start dashcam recording manually (provision methods do this automatically)
+    await testdriver.dashcam.start();
     
-    // Assert the TestDriver.ai Sandbox login page is displayed
-    const result = await testdriver.assert(
-      "A desktop is visible",
-    );
+    await testdriver.exec('sh', 'gedit >/dev/null 2>&1 &'); // Example command to keep the test running for a bit
 
-    expect(result).toBeTruthy();
+    await testdriver.assert('untitled document is visible');
+
+    // Stop dashcam and get the recording URL
+    const dashcamUrl = await testdriver.dashcam.stop();
+    if (dashcamUrl) {
+      console.log(`🎥 Dashcam recording: ${dashcamUrl}`);
+    }
   });
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.5.25",
+  "version": "7.5.26",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "types": "sdk.d.ts",

package/sdk.js

@@ -1871,6 +1871,8 @@ class TestDriverSDK {
           "--no-first-run",
           "--no-experiments",
           "--disable-infobars",
+          "--disable-features=StartupBrowserCreator",
+          "--disable-features=ChromeWhatsNewUI",
           `--user-data-dir=${userDataDir}`,
         );