testdriverai 7.2.47 → 7.2.49

package/.github/workflows/acceptance-linux-scheduled.yaml

@@ -31,7 +31,7 @@ jobs:
 
     - name: Run Linux tests with Sentry Cron monitoring
       run: |
-        sentry-cli monitors run testdriver-linux-acceptance -- npx vitest run test/testdriver/*.test.mjs
+        sentry-cli monitors run testdriver-linux-acceptance -- npx vitest run examples/*.test.mjs
       env:
         SENTRY_DSN: ${{ secrets.SENTRY_DSN }}
         TD_API_KEY: ${{ secrets.TD_API_KEY }}

package/.github/workflows/acceptance.yaml

@@ -29,7 +29,7 @@ jobs:
       run: npm ci
     
     - name: Run Linux tests
-      run: npx vitest run test/testdriver/*.test.mjs
+      run: npx vitest run examples/*.test.mjs
       env:
         TD_API_KEY: ${{ secrets.TD_API_KEY }}
         TD_OS: linux
@@ -52,7 +52,7 @@ jobs:
     if: contains(github.event.pull_request.labels.*.name, 'test-windows')
     uses: ./.github/workflows/windows-self-hosted.yaml
     with:
-      test_pattern: 'test/testdriver/assert.test.mjs'
+      test_pattern: 'examples/assert.test.mjs'
     secrets:
       TD_API_KEY: ${{ secrets.TD_API_KEY }}
       TD_WEBSITE: ${{ secrets.TD_WEBSITE }}

package/.github/workflows/windows-self-hosted.yaml

@@ -7,7 +7,7 @@ on:
         description: 'Test file pattern to run'
         required: false
         type: string
-        default: 'test/testdriver/*.test.mjs'
+        default: 'examples/*.test.mjs'
     secrets:
       TD_API_KEY:
         required: true

package/README.md

@@ -11,7 +11,7 @@
 <br />
 <br />
   
-[🚀 **Quick Start**](#-quick-start) • [📖 **Documentation**](https://docs.testdriver.ai) • [💻 **Examples**](https://github.com/testdriverai/testdriverai/tree/main/test/testdriver) • [📖 **Pricing**](https://docs.testdriver.ai) • [💬 **Discord**](https://discord.com/invite/cWDFW8DzPm) • [🌐 **Website**](https://testdriver.ai)
+[🚀 **Quick Start**](#-quick-start) • [📖 **Documentation**](https://docs.testdriver.ai) • [💻 **Examples**](https://github.com/testdriverai/testdriverai/tree/main/examples) • [📖 **Pricing**](https://docs.testdriver.ai) • [💬 **Discord**](https://discord.com/invite/cWDFW8DzPm) • [🌐 **Website**](https://testdriver.ai)
 
 </div>
 
@@ -41,7 +41,7 @@ const result = await testdriver.assert(
 expect(result).toBeTruthy();
 ```
 
-[See Full Example](https://github.com/testdriverai/testdriverai/blob/main/test/testdriver/drag-and-drop.test.mjs) • [Browse All Examples](https://github.com/testdriverai/testdriverai/tree/main/test/testdriver)
+[See Full Example](https://github.com/testdriverai/testdriverai/blob/main/examples/drag-and-drop.test.mjs) • [Browse All Examples](https://github.com/testdriverai/testdriverai/tree/main/examples)
 
 ---
 

package/docs/TEST-GITHUB-COMMENTS.md

@@ -38,7 +38,7 @@
 
 ## What the Test Does
 
-The workflow runs `test/testdriver/assert.test.mjs` which:
+The workflow runs `examples/assert.test.mjs` which:
 - Provisions a Chrome browser
 - Navigates to https://saucedemo.com
 - Performs login actions
@@ -72,7 +72,7 @@ Skipped: 0 ⏭️
 
 | Status | Test | File | Duration | Replay |
 |--------|------|------|----------|--------|
-| ✅ | Assert Test | `test/testdriver/assert.test.mjs` | 25.3s | [🎥 View](https://console.testdriver.ai/replay/...) |
+| ✅ | Assert Test | `examples/assert.test.mjs` | 25.3s | [🎥 View](https://console.testdriver.ai/replay/...) |
 
 ## 🎥 Dashcam Replays
 

package/docs/v7/_drafts/plugin-migration.mdx

@@ -142,7 +142,7 @@ export default defineConfig({
 
 ### Test Helpers
 
-- ✅ **Removed**: `test/testdriver/setup/` folder (legacy helpers)
+- ✅ **Removed**: `examples/setup/` folder (legacy helpers)
   - Code moved to `lib/vitest/hooks.mjs` framework
   - Tests now use `TestDriver(context, options)` pattern directly
 

package/docs/v7/aws-setup.mdx

@@ -257,7 +257,7 @@ jobs:
         run: npm ci
 
       - name: Run Windows tests with self-hosted instances
-        run: npx vitest run test/testdriver/*.test.mjs
+        run: npx vitest run examples/*.test.mjs
         env:
           TD_API_KEY: ${{ secrets.TD_API_KEY }}
           TD_OS: windows

package/docs/v7/examples.mdx

@@ -1,5 +1,5 @@
 ---
 title: "Examples"
-url: "https://github.com/testdriverai/testdriverai/tree/main/test/testdriver"
+url: "https://github.com/testdriverai/testdriverai/tree/main/examples"
 icon: 'code'
 ---

package/{test/testdriver → examples}/ai.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("AI Test", () => {
   it("should use ai to search for testdriver on Google", async (context) => {

package/{test/testdriver → examples}/assert.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Assert Test", () => {
   it("should assert the testdriver login page shows", async (context) => {

package/{test/testdriver → examples}/chrome-extension.test.mjs

@@ -8,7 +8,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Chrome Extension Test", () => {
   it("should load hello-world Chrome extension from local path", async (context) => {
@@ -55,7 +55,7 @@ describe("Chrome Extension Test", () => {
     // 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");
+    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

package/{test/testdriver → examples}/drag-and-drop.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 const isLinux = (process.env.TD_OS || "linux") === "linux";
 

package/{test/testdriver → examples}/element-not-found.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Element Not Found Test", () => {
   it("should handle non-existent element gracefully without timing out", async (context) => {

package/{test/testdriver → examples}/exec-output.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe.skip("Exec Output Test", () => {
   it(

package/{test/testdriver → examples}/exec-pwsh.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe.skip("Exec PowerShell Test", () => {
   it(

package/{test/testdriver → examples}/focus-window.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Focus Window Test", () => {
   it.skip(

package/{test/testdriver → examples}/formatted-logging.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Formatted Logging Test", () => {
   it("should demonstrate formatted logs in dashcam replay", async (context) => {

package/{test/testdriver → examples}/hover-image.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 /**
  * Perform login flow for SauceLabs demo app

package/{test/testdriver → examples}/hover-text-with-description.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 /**
  * Perform login flow for SauceLabs demo app

package/{test/testdriver → examples}/hover-text.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Hover Text Test", () => {
   it("should click Sign In and verify error message", async (context) => {

package/{test/testdriver → examples}/installer.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 const isLinux = (process.env.TD_OS || "linux") === "linux";
 

package/{test/testdriver → examples}/launch-vscode-linux.test.mjs

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 const isLinux = (process.env.TD_OS || "linux") === "linux";
 

package/{test/testdriver → examples}/match-image.test.mjs

@@ -6,7 +6,7 @@
 import path, { dirname } from "path";
 import { fileURLToPath } from "url";
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 /**
  * Perform login flow for SauceLabs demo app

package/{test/testdriver → examples}/press-keys.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Press Keys Test", () => {
   it("should create tabs and navigate using keyboard shortcuts", async (context) => {

package/{test/testdriver → examples}/prompt.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe.skip("Prompt Test", () => {
   it("should execute AI-driven prompts", async (context) => {

package/{test/testdriver → examples}/scroll-keyboard.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Scroll Keyboard Test", () => {
   it("should navigate to webhamster.com and scroll with keyboard", async (context) => {

package/{test/testdriver → examples}/scroll-until-image.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Scroll Until Image Test", () => {
   it.skip("should scroll until brown colored house image appears", async (context) => {

package/{test/testdriver → examples}/scroll-until-text.test.mjs

@@ -4,7 +4,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 /**
  * Perform login flow for SauceLabs demo app

package/{test/testdriver → examples}/scroll.test.mjs

@@ -6,7 +6,7 @@
  */
 
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Scroll Test", () => {
   it("should navigate and scroll down the page", async (context) => {

package/{test/testdriver → examples}/type.test.mjs

@@ -1,5 +1,5 @@
 import { describe, expect, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 describe("Type Test", () => {
   it("should enter standard_user in username field", async (context) => {

package/{test/testdriver → examples}/windows-installer.test.mjs

@@ -10,7 +10,7 @@
  */
 
 import { describe, it } from "vitest";
-import { TestDriver } from "../../lib/vitest/hooks.mjs";
+import { TestDriver } from "../lib/vitest/hooks.mjs";
 
 const isLinux = (process.env.TD_OS || "linux") === "linux";
 

package/package.json

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

package/test/manual/reconnect-provision.test.mjs

@@ -8,8 +8,8 @@
  * Run reconnect-signin.test.mjs within 2 minutes of this test completing.
  * 
  * Usage:
- *   1. npm test -- test/testdriver/reconnect-provision.test.mjs
- *   2. (within 2 minutes) npm test -- test/testdriver/reconnect-signin.test.mjs
+ *   1. npm test -- examples/reconnect-provision.test.mjs
+ *   2. (within 2 minutes) examples/reconnect-signin.test.mjs
  */
 
 import { afterAll, describe, expect, it } from "vitest";

package/testdriver-plugin/skills/actions/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: actions
+description: Perform actions in TestDriver tests. Use when clicking, typing, pressing keys, scrolling, hovering, dragging, or interacting with UI elements.
+---
+
+# Performing Actions
+
+Read these docs:
+- `node_modules/testdriverai/docs/v7/click.mdx`
+- `node_modules/testdriverai/docs/v7/type.mdx`
+- `node_modules/testdriverai/docs/v7/press-keys.mdx`
+- `node_modules/testdriverai/docs/v7/scroll.mdx`
+- `node_modules/testdriverai/docs/v7/hover.mdx`
+- `node_modules/testdriverai/docs/v7/double-click.mdx`
+- `node_modules/testdriverai/docs/v7/right-click.mdx`
+- `node_modules/testdriverai/docs/v7/mouse-down.mdx`
+- `node_modules/testdriverai/docs/v7/mouse-up.mdx`
+
+## Click Actions
+
+```javascript
+const element = await testdriver.find("button");
+await element.click();
+await element.doubleClick();
+await element.rightClick();
+await element.hover();
+```
+
+## Typing
+
+```javascript
+await testdriver.find("Email input").click();
+await testdriver.type("user@example.com");
+```
+
+### Clear before typing
+```javascript
+await testdriver.find("Search input").click();
+await testdriver.pressKeys(["ctrl", "a"]);
+await testdriver.type("new search term");
+```
+
+## Keyboard Input
+
+```javascript
+await testdriver.pressKeys(["enter"]);
+await testdriver.pressKeys(["tab"]);
+await testdriver.pressKeys(["escape"]);
+await testdriver.pressKeys(["ctrl", "a"]);  // Select all
+await testdriver.pressKeys(["ctrl", "c"]);  // Copy
+await testdriver.pressKeys(["ctrl", "v"]);  // Paste
+await testdriver.pressKeys(["alt", "f4"]);  // Close (Windows)
+await testdriver.pressKeys(["cmd", "q"]);   // Quit (macOS)
+```
+
+## Scrolling
+
+```javascript
+await testdriver.scroll("down");
+await testdriver.scroll("up");
+await testdriver.scrollUntilText("Footer content");
+await testdriver.scrollUntilImage("Product image at bottom");
+```
+
+## Drag and Drop
+
+```javascript
+const source = await testdriver.find("Draggable item");
+const target = await testdriver.find("Drop zone");
+await source.mouseDown();
+await target.hover();
+await target.mouseUp();
+```
+
+## Execute Code in Sandbox
+
+```javascript
+// JavaScript (browser)
+const title = await testdriver.exec("js", "return document.title", 5000);
+
+// Shell (Linux)
+await testdriver.exec("sh", "ls -la", 5000);
+
+// PowerShell (Windows)
+await testdriver.exec("pwsh", "Get-Date", 5000);
+```
+
+## Examples
+
+- `node_modules/testdriverai/examples/type.test.mjs`
+- `node_modules/testdriverai/examples/press-keys.test.mjs`
+- `node_modules/testdriverai/examples/scroll.test.mjs`
+- `node_modules/testdriverai/examples/drag-and-drop.test.mjs`

package/testdriver-plugin/skills/assertions/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: assertions
+description: Make assertions in TestDriver tests. Use when verifying UI state, checking visual conditions, or validating test outcomes with natural language.
+---
+
+# Making Assertions
+
+Read: `node_modules/testdriverai/docs/v7/assert.mdx`
+Read: `node_modules/testdriverai/docs/v7/making-assertions.mdx`
+
+## Basic Usage
+
+```javascript
+const result = await testdriver.assert("the dashboard is visible");
+expect(result).toBeTruthy();
+```
+
+## Writing Good Assertions
+
+**Be specific:**
+```javascript
+// ✅ Good
+await testdriver.assert("the login button is visible in the header");
+await testdriver.assert("user's name 'John' appears in the profile section");
+await testdriver.assert("error message 'Invalid email' is displayed");
+
+// ❌ Vague
+await testdriver.assert("button visible");
+await testdriver.assert("it worked");
+```
+
+**Describe what you see:**
+```javascript
+await testdriver.assert("the settings panel is open on the right side");
+await testdriver.assert("a green success checkmark appears next to the form");
+await testdriver.assert("the page shows 'Welcome back, John'");
+```
+
+**Include context:**
+```javascript
+await testdriver.assert("the shopping cart shows 3 items");
+await testdriver.assert("the price total is $99.99");
+await testdriver.assert("the submit button is disabled");
+```
+
+## Common Patterns
+
+### After navigation
+```javascript
+await testdriver.find("Settings link").click();
+const result = await testdriver.assert("Settings page is displayed");
+expect(result).toBeTruthy();
+```
+
+### Form validation
+```javascript
+await testdriver.find("Submit button").click();
+const hasError = await testdriver.assert("email validation error is shown");
+expect(hasError).toBeTruthy();
+```
+
+### State changes
+```javascript
+await testdriver.find("Toggle switch").click();
+const isOn = await testdriver.assert("the toggle is now in the ON position");
+expect(isOn).toBeTruthy();
+```
+
+### Negative assertions
+```javascript
+const noError = await testdriver.assert("no error messages are visible");
+expect(noError).toBeTruthy();
+```
+
+## Examples
+
+See `node_modules/testdriverai/examples/assert.test.mjs`

package/testdriver-plugin/skills/caching/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: caching
+description: Understand TestDriver element caching. Use when optimizing test speed, managing cache keys, or troubleshooting cached element issues.
+---
+
+# Element Caching
+
+Read: `node_modules/testdriverai/docs/v7/caching.mdx`
+
+## How Caching Works
+
+TestDriver caches element locations to speed up subsequent test runs. When you `find()` an element, the result is stored and reused in future runs.
+
+## Cache Options
+
+```javascript
+const testdriver = TestDriver(context, {
+  cache: true,           // Enable caching (default: true)
+  cacheKey: 'my-test',   // Custom cache key
+});
+```
+
+## When to Use Custom Cache Keys
+
+Use different cache keys when:
+- Testing different pages/states with similar elements
+- Running tests in different environments
+- Elements have different positions in different contexts
+
+```javascript
+// Login page test
+const testdriver = TestDriver(context, { cacheKey: 'login-page' });
+
+// Dashboard test
+const testdriver = TestDriver(context, { cacheKey: 'dashboard' });
+```
+
+## Disabling Cache
+
+Disable caching when:
+- Elements frequently change position
+- Debugging element detection issues
+- Dynamic content that varies between runs
+
+```javascript
+const testdriver = TestDriver(context, { cache: false });
+```
+
+## Cache Invalidation
+
+The cache is automatically invalidated when:
+- Element is not found at cached location
+- Test fails due to element mismatch
+- Cache key changes
+
+## Troubleshooting
+
+**Element found at wrong position?**
+- Try disabling cache: `cache: false`
+- Use a different cache key
+- The UI may have changed since last run
+
+**Tests slower than expected?**
+- Ensure caching is enabled
+- Use consistent cache keys
+- Cache builds up over successful runs