@testdriverai/agent 7.9.0 → 7.9.1-test

package/docs/v7/examples/findall-coffee-icons.mdx

@@ -0,0 +1,88 @@
+---
+title: "FindAll Coffee Icons"
+sidebarTitle: "Findall Coffee Icons"
+description: "TestDriver SDK - FindAll Coffee Icons Test Loads a random icon grid and uses findAll() to locate and click all 4 coffee cup icons."
+icon: "play"
+---
+
+## Overview
+
+TestDriver SDK - FindAll Coffee Icons Test Loads a random icon grid and uses findAll() to locate and click all 4 coffee cup icons
+
+Review the source code below to understand the implementation details and patterns used.
+
+## Live Test Run
+
+Watch this test execute in a real sandbox environment:
+
+{/* findall-coffee-icons.test.mjs output */}
+<iframe 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d03ae8a04db4b705cbf0/replay" 
+  width="100%" 
+  height="600" 
+  style={{ border: "1px solid #333", borderRadius: "8px" }}
+  allow="fullscreen"
+/>
+
+## Source Code
+
+```javascript title="findall-coffee-icons.test.mjs"
+/**
+ * TestDriver SDK - FindAll Coffee Icons Test
+ * Loads a random icon grid and uses findAll() to locate and click all 4 coffee cup icons
+ */
+
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "testdriverai/vitest/hooks";
+
+describe("FindAll Coffee Icons", () => {
+  it("should find and click all 4 coffee cup icons", async (context) => {
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP,
+      headless: true,
+    });
+
+    await testdriver.provision.chrome({
+      url: "https://v0-random-icon-grid.vercel.app/",
+    });
+
+    // Use findAll to locate all coffee cup icons on the page
+    const coffeeIcons = await testdriver.findAll("coffee cup icon, there are exactly 4 on the page");
+
+    // Log each icon's coordinates
+    console.log(`Found ${coffeeIcons.length} coffee icons:`);
+    coffeeIcons.forEach((icon, i) => {
+      console.log(`  Icon ${i + 1}: (${icon.x}, ${icon.y}) center=(${icon.centerX}, ${icon.centerY})`);
+    });
+
+    // Verify we found 3 or 4 coffee icons
+    expect(coffeeIcons.length).toBeGreaterThanOrEqual(3);
+    expect(coffeeIcons.length).toBeLessThanOrEqual(4);
+
+    // Click each coffee cup icon
+    for (const icon of coffeeIcons) {
+      await icon.click();
+    }
+
+    // Verify the selection count is displayed
+    await testdriver.assert("the page says 'Selected: 3 / 4' or 'Matched 4 of a kind!'");
+  });
+});
+```
+
+## Running This Example
+
+```bash
+# Clone the TestDriver repository
+git clone https://github.com/testdriverai/testdriverai
+
+# Install dependencies
+cd testdriverai
+npm install
+
+# Run this specific example
+npx vitest run examples/findall-coffee-icons.test.mjs
+```
+
+<Note>
+  Make sure you have `TD_API_KEY` set in your environment. Get one at [testdriver.ai](https://testdriver.ai).
+</Note>

package/docs/v7/examples/focus-window.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* focus-window.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d042e8a04db4b705cbf2/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d042e8a04db4b705cbf2/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -28,14 +28,13 @@ Watch this test execute in a real sandbox environment:
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../lib/vitest/hooks.mjs";
-import { getDefaults } from "./config.mjs";
+import { TestDriver } from "testdriverai/vitest/hooks";
 
 describe("Focus Window Test", () => {
   it.skip(
     "should click Microsoft Edge icon and focus Google Chrome",
     async (context) => {
-      const testdriver = TestDriver(context, { ...getDefaults(context), headless: true });
+      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP, headless: true });
       await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
       //

package/docs/v7/examples/hover-image.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* hover-image.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d0300201196437256cd3/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d0300201196437256cd3/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="hover-image.test.mjs" {40-42,47}
 /**
- * TestDriver SDK - Hover Image Test
+ * TestDriver SDK - Hover Image Test (Vitest)
+ * Converted from: testdriver/acceptance/hover-image.yaml
  */
 
 import { describe, expect, it } from "vitest";
@@ -50,7 +51,7 @@ async function performLogin(client, username = "standard_user") {
 
 describe("Hover Image Test", () => {
   it("should click on shopping cart icon and verify empty cart", async (context) => {
-    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP, redraw: false });
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
     
     // provision.chrome() automatically calls ready() and starts dashcam
     await testdriver.provision.chrome({

package/docs/v7/examples/hover-text-with-description.mdx

@@ -0,0 +1,104 @@
+---
+title: "Hover Text With Description Test"
+sidebarTitle: "Hover Text With Description"
+description: "TestDriver SDK - Hover Text With Description Test (Vitest) Converted from: testdriver/acceptance/hover-text-with-description.yaml."
+icon: "hand-pointer"
+mode: "wide"
+---
+
+## Overview
+
+TestDriver SDK - Hover Text With Description Test (Vitest) Converted from: testdriver/acceptance/hover-text-with-description.yaml
+
+Review the source code below to understand the implementation details and patterns used.
+
+## Live Test Run
+
+Watch this test execute in a real sandbox environment:
+
+{/* hover-text-with-description.test.mjs output */}
+<iframe 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d029c2e6e94933886764/replay" 
+  width="100%" 
+  height="600" 
+  style={{ border: "1px solid #333", borderRadius: "8px" }}
+  allow="fullscreen"
+/>
+
+## Source Code
+
+```javascript title="hover-text-with-description.test.mjs"
+/**
+ * TestDriver SDK - Hover Text With Description Test (Vitest)
+ * Converted from: testdriver/acceptance/hover-text-with-description.yaml
+ */
+
+import { describe, expect, it } from "vitest";
+import { TestDriver } from "testdriverai/vitest/hooks";
+
+/**
+ * Perform login flow for SauceLabs demo app
+ * @param {TestDriver} client - TestDriver client
+ * @param {string} username - Username (default: 'standard_user')
+ */
+async function performLogin(client, username = "standard_user") {
+  await client.focusApplication("Google Chrome");
+  const password = await client.extract("the password");
+  const usernameField = await client.find("username input");
+  await usernameField.click();
+  await client.type(username);
+  await client.pressKeys(["tab"]);
+  await client.type(password, { secret: true });
+  await client.pressKeys(["tab"]);
+  await client.pressKeys(["enter"]);
+}
+
+describe("Hover Text With Description Test", () => {
+  it("should add TestDriver Hat to cart and verify", async (context) => {
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP,
+      headless: true,
+    });
+    await testdriver.provision.chrome({
+      url: "http://testdriver-sandbox.vercel.app/login",
+    });
+
+    //
+    // Perform login first
+    await performLogin(testdriver);
+
+    // Click on "Add to Cart" under TestDriver Hat
+    const addToCartButton = await testdriver.find(
+      "Add to Cart, add to cart button under TestDriver Hat",
+    );
+    await addToCartButton.click();
+
+    // Click on the cart
+    const cartButton = await testdriver.find(
+      "Cart, cart button in the top right corner",
+    );
+    await cartButton.click();
+
+    // Assert the TestDriver Hat is in the cart
+    const result = await testdriver.assert("There is an item in the cart");
+    expect(result).toBeTruthy();
+  });
+});
+```
+
+## Running This Example
+
+```bash
+# Clone the TestDriver repository
+git clone https://github.com/testdriverai/testdriverai
+
+# Install dependencies
+cd testdriverai
+npm install
+
+# Run this specific example
+npx vitest run examples/hover-text-with-description.test.mjs
+```
+
+<Note>
+  Make sure you have `TD_API_KEY` set in your environment. Get one at [testdriver.ai](https://testdriver.ai).
+</Note>

package/docs/v7/examples/hover-text.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* hover-text.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d04b0201196437256ce6/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d04b0201196437256ce6/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="hover-text.test.mjs" {13-15,18-20}
 /**
- * TestDriver SDK - Hover Text Test
+ * TestDriver SDK - Hover Text Test (Vitest)
+ * Converted from: testdriver/acceptance/hover-text.yaml
  */
 
 import { describe, expect, it } from "vitest";
@@ -31,7 +32,7 @@ import { TestDriver } from "testdriverai/vitest/hooks";
 
 describe("Hover Text Test", () => {
   it("should click Sign In and verify error message", async (context) => {
-    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP });
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
     await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
 
     // Click on Sign In button using new find() API

package/docs/v7/examples/installer.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* installer.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d032c2e6e94933886769/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d032c2e6e94933886769/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="installer.test.mjs" {16-18}
 /**
- * TestDriver SDK - Installer Test
+ * TestDriver SDK - Installer Test (Vitest)
+ * Tests the provision.installer() method for downloading and installing apps
  */
 
 import { describe, expect, it } from "vitest";
@@ -35,7 +36,7 @@ describe("Provision Installer", () => {
   it.skipIf(!isLinux)(
     "should download and install a .deb package on Linux",
     async (context) => {
-      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP });
+      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
       
       // Install bat (a cat clone with syntax highlighting) using provision.installer
       const filePath = await testdriver.provision.installer({
@@ -53,7 +54,7 @@ describe("Provision Installer", () => {
   it.skipIf(!isLinux)(
     "should download a shell script and verify it exists",
     async (context) => {
-      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP });
+      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
       
       // Download a shell script (nvm installer)
       const filePath = await testdriver.provision.installer({

package/docs/v7/examples/launch-vscode-linux.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* launch-vscode-linux.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d02be8a04db4b705cbe5/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d02be8a04db4b705cbe5/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -22,10 +22,6 @@ Watch this test execute in a real sandbox environment:
 ## Source Code
 
 ```javascript title="launch-vscode-linux.test.mjs" {13,27-29}
-/**
- * TestDriver SDK - Launch VS Code Test
- */
-
 import { describe, expect, it } from "vitest";
 import { TestDriver } from "testdriverai/vitest/hooks";
 
@@ -35,7 +31,7 @@ describe("Launch VS Code on Linux", () => {
   it.skipIf(!isLinux)(
     "should launch VS Code on Debian/Ubuntu",
     async (context) => {
-      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP });
+      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
       
       // provision.vscode() automatically calls ready() and starts dashcam
       await testdriver.provision.vscode();
@@ -52,7 +48,7 @@ describe("Launch VS Code on Linux", () => {
   it.skipIf(!isLinux)(
     "should install and use a VS Code extension",
     async (context) => {
-      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP });
+      const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
       
       // Launch VS Code with the Prettier extension installed
       await testdriver.provision.vscode({

package/docs/v7/examples/match-image.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* match-image.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d0270201196437256ccf/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d0270201196437256ccf/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="match-image.test.mjs" {42}
 /**
- * TestDriver SDK - Match Image Test
+ * TestDriver SDK - Match Image Test (Vitest)
+ * Converted from: testdriver/acceptance/match-image.yaml
  */
 
 import path, { dirname } from "path";

package/docs/v7/examples/parse.mdx

@@ -0,0 +1,66 @@
+---
+title: "Parse Test"
+sidebarTitle: "Parse"
+description: "TestDriver SDK - Parse Test (Vitest) Opens Airbnb and runs the .parse() SDK command to analyze the screen."
+icon: "play"
+---
+
+## Overview
+
+TestDriver SDK - Parse Test (Vitest) Opens Airbnb and runs the .parse() SDK command to analyze the screen.
+
+Review the source code below to understand the implementation details and patterns used.
+
+## Live Test Run
+
+Watch this test execute in a real sandbox environment:
+
+{/* parse.test.mjs output */}
+<iframe 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d04d0201196437256ce7/replay" 
+  width="100%" 
+  height="600" 
+  style={{ border: "1px solid #333", borderRadius: "8px" }}
+  allow="fullscreen"
+/>
+
+## Source Code
+
+```javascript title="parse.test.mjs"
+/**
+ * TestDriver SDK - Parse Test (Vitest)
+ * Opens Airbnb and runs the .parse() SDK command to analyze the screen.
+ */
+
+import { describe, it } from "vitest";
+import { TestDriver } from "testdriverai/vitest/hooks";
+
+describe("Parse Test", () => {
+  it("should open Airbnb and parse the screen", async (context) => {
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP});
+    await testdriver.provision.chrome({ url: "https://www.airbnb.com" });
+
+    // The SDK automatically outputs elements as a formatted table
+    const result = await testdriver.parse();
+    console.log(`Found ${result.elements?.length || 0} elements`);
+  });
+});
+```
+
+## Running This Example
+
+```bash
+# Clone the TestDriver repository
+git clone https://github.com/testdriverai/testdriverai
+
+# Install dependencies
+cd testdriverai
+npm install
+
+# Run this specific example
+npx vitest run examples/parse.test.mjs
+```
+
+<Note>
+  Make sure you have `TD_API_KEY` set in your environment. Get one at [testdriver.ai](https://testdriver.ai).
+</Note>

package/docs/v7/examples/press-keys.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* press-keys.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d036058ffe89003c6ada/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d036058ffe89003c6ada/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="press-keys.test.mjs" {17,24,36}
 /**
- * TestDriver SDK - Press Keys Test
+ * TestDriver SDK - Press Keys Test (Vitest)
+ * Converted from: testdriver/acceptance/press-keys.yaml
  */
 
 import { describe, expect, it } from "vitest";
@@ -43,23 +44,16 @@ describe("Press Keys Test", () => {
     await testdriver.pressKeys(["ctrl", "t"]);
 
     // Poll for "Learn more" to appear
-    let learnMore = await testdriver.find("Learn more");
-    for (let i = 0; i < 10; i++) {
-      learnMore = await learnMore.find();
-      if (learnMore.found()) break;
-      await new Promise((resolve) => setTimeout(resolve, 500));
-    }
+    let imagesLink = await testdriver.find("Images", {timeout: 5000});
+
+    expect(imagesLink.found()).toBeTruthy();
 
     // Open DevTools
     await testdriver.pressKeys(["ctrl", "shift", "i"]);
 
     // Poll for "Elements" to appear
-    let elements = await testdriver.find("Elements");
-    for (let i = 0; i < 10; i++) {
-      elements = await elements.find();
-      if (elements.found()) break;
-      await new Promise((resolve) => setTimeout(resolve, 500));
-    }
+    let elements = await testdriver.find("Elements", {timeout: 5000});
+    expect(elements.found()).toBeTruthy();
 
     // Open another tab and navigate
     await testdriver.pressKeys(["ctrl", "t"]);

package/docs/v7/examples/scroll-keyboard.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* scroll-keyboard.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d03da0a3ef8239de474f/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d03da0a3ef8239de474f/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="scroll-keyboard.test.mjs" {26}
 /**
- * TestDriver SDK - Scroll Keyboard Test
+ * TestDriver SDK - Scroll Keyboard Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll-keyboard.yaml
  */
 
 import { describe, expect, it } from "vitest";
@@ -38,7 +39,7 @@ describe("Scroll Keyboard Test", () => {
     // Navigate to https://www.webhamster.com/
     await testdriver.focusApplication("Google Chrome");
     const urlBar = await testdriver.find(
-      "testdriver-sandbox.vercel.app/login, the URL in the omnibox showing the current page", {zoom: true}
+      "the URL in the omnibox", {zoom: true}
     );
     await urlBar.click();
     await testdriver.pressKeys(["ctrl", "a"]);

package/docs/v7/examples/scroll-until-image.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* scroll-until-image.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d03f0201196437256cda/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d03f0201196437256cda/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,8 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="scroll-until-image.test.mjs" {26}
 /**
- * TestDriver SDK - Scroll Until Image Test
+ * TestDriver SDK - Scroll Until Image Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll-until-image.yaml
  */
 
 import { describe, expect, it } from "vitest";

package/docs/v7/examples/scroll.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* scroll.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d043058ffe89003c6ae0/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d043058ffe89003c6ae0/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,10 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="scroll.test.mjs" {29}
 /**
- * TestDriver SDK - Scroll Test
+ * TestDriver SDK - Scroll Test (Vitest)
+ * Converted from: testdriver/acceptance/scroll.yaml
+ * 
+ * UPDATED: Now using chrome preset for automatic setup
  */
 
 import { describe, expect, it } from "vitest";
@@ -32,19 +35,8 @@ import { TestDriver } from "testdriverai/vitest/hooks";
 describe("Scroll Test", () => {
   it("should navigate and scroll down the page", async (context) => {
     const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP, headless: true });
-    await testdriver.provision.chrome({ url: 'http://testdriver-sandbox.vercel.app/login' });
+    await testdriver.provision.chrome({ url: 'https://www.webhamster.com/' });
 
-    // Give Chrome a moment to fully render the UI
-    await new Promise(resolve => setTimeout(resolve, 2000));
-
-    // Navigate to webhamster.com - just look for the domain, not the full path
-    const urlBar = await testdriver.find(
-      "testdriver-sandbox.vercel.app, the URL in the address bar",
-    );
-    await urlBar.click();
-    await testdriver.pressKeys(["ctrl", "a"]);
-    await testdriver.type("https://www.webhamster.com/");
-    await testdriver.pressKeys(["enter"]);
 
     // Wait for page to load and click heading
     const heading = await testdriver.find(

package/docs/v7/examples/type.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* type.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d034c2e6e9493388676c/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d034c2e6e9493388676c/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -22,10 +22,6 @@ Watch this test execute in a real sandbox environment:
 ## Source Code
 
 ```javascript title="type.test.mjs" {13}
-/**
- * TestDriver SDK - Type Test
- */
-
 import { describe, expect, it } from "vitest";
 import { TestDriver } from "testdriverai/vitest/hooks";
 

package/docs/v7/examples/windows-installer.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* windows-installer.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69c5d02ce8a04db4b705cbe9/replay" 
+  src="https://api.testdriver.ai/api/v1/testdriver/testcase/69c5d02ce8a04db4b705cbe9/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -23,7 +23,14 @@ Watch this test execute in a real sandbox environment:
 
 ```javascript title="windows-installer.test.mjs" {22-25}
 /**
- * TestDriver SDK - Windows Installer Example
+ * TestDriver SDK - Windows Installer Example (Vitest)
+ * 
+ * This example demonstrates how to download and install a Windows application
+ * using PowerShell commands, then launch and interact with it.
+ * 
+ * Based on the v6 GitButler provisioning workflow.
+ * 
+ * Run: TD_OS=windows vitest run examples/windows-installer.test.mjs
  */
 
 import { describe, it } from "vitest";
@@ -35,8 +42,7 @@ describe("Windows App Installation", () => {
     
   it.skipIf(isLinux)("should download, install, and launch GitButler on Windows", async (context) => {
     // Alternative approach using provision.installer helper
-    const testdriver = TestDriver(context, { 
-      ip: context.ip || process.env.TD_IP,
+    const testdriver = TestDriver(context, { ip: context.ip || process.env.TD_IP,
       os: 'windows'
     });
 

package/interfaces/vitest-plugin.mjs

@@ -412,9 +412,9 @@ export async function authenticateWithApiKey(apiKey, apiRoot) {
     if (response.status >= 500) {
       const serverError = new Error(
         data.message ||
-        `TestDriver API is currently unavailable (HTTP ${response.status}). Please try again later.`,
+        `An error occurred on the TestDriver server (HTTP ${response.status}). Please try again later.`,
       );
-      serverError.code = data.error || "API_UNAVAILABLE";
+      serverError.code = data.error || "SERVER_ERROR";
       serverError.isServerError = true;
       throw serverError;
     }

package/lib/core/Dashcam.js

@@ -369,6 +369,7 @@ class Dashcam {
     } else {
       // Linux/Mac with TD_API_ROOT
       this._log("debug", "Starting dashcam recording on Linux/Mac...");
+      const dashcamPath = await this._getDashcamPath();
       const titleArg = this.title
         ? ` --title="${this.title.replace(/"/g, '"')}"`
         : "";
@@ -376,10 +377,12 @@ class Dashcam {
       this.startTime = Date.now();
       await this.client.exec(
         shell,
-        `TD_API_ROOT="${apiRoot}" dashcam record${titleArg} >/dev/null 2>&1 &`,
+        `TD_API_ROOT="${apiRoot}" "${dashcamPath}" record${titleArg} >/dev/null 2>&1 &`,
         10000,
         process.env.TD_DEBUG == "true" ? false : true,
       );
+      // Give dashcam time to initialize and create its status file before marking as recording
+      await new Promise((resolve) => setTimeout(resolve, 3000));
       this._log("debug", "Dashcam recording started");
     }