testdriverai 7.9.32-test → 7.9.34-test

package/docs/_data/examples-manifest.json

@@ -2,16 +2,16 @@
   "$schema": "./examples-manifest.schema.json",
   "examples": {
     "assert.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451160f3ad36c01d6d2b6",
-      "lastUpdated": "2026-04-07T00:50:35.143Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e0c0ec56e77d2d2b48",
+      "lastUpdated": "2026-04-09T00:47:56.308Z"
     },
     "drag-and-drop.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42fc0ac3cc632a918b",
       "lastUpdated": "2026-03-03T00:32:25.275Z"
     },
     "exec-pwsh.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451080f3ad36c01d6d2aa",
-      "lastUpdated": "2026-04-07T00:35:19.961Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d1c0ec56e77d2d2b3c",
+      "lastUpdated": "2026-04-09T00:30:09.363Z"
     },
     "match-image.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
@@ -22,84 +22,84 @@
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4510a0f3ad36c01d6d2ab",
-      "lastUpdated": "2026-04-07T00:34:17.941Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d3c0ec56e77d2d2b3d",
+      "lastUpdated": "2026-04-09T00:29:07.375Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4510d0f3ad36c01d6d2ae",
-      "lastUpdated": "2026-04-07T00:35:24.405Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d6c0ec56e77d2d2b40",
+      "lastUpdated": "2026-04-09T00:30:14.179Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4510f0f3ad36c01d6d2af",
-      "lastUpdated": "2026-04-07T00:35:25.737Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d7c0ec56e77d2d2b41",
+      "lastUpdated": "2026-04-09T00:30:15.528Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451070f3ad36c01d6d2a9",
-      "lastUpdated": "2026-04-07T00:34:47.526Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d0c0ec56e77d2d2b3b",
+      "lastUpdated": "2026-04-09T00:29:36.485Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4510c0f3ad36c01d6d2ac",
-      "lastUpdated": "2026-04-07T00:40:22.703Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d5c0ec56e77d2d2b3e",
+      "lastUpdated": "2026-04-09T00:37:50.393Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451100f3ad36c01d6d2b0",
-      "lastUpdated": "2026-04-07T00:34:56.038Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d9c0ec56e77d2d2b42",
+      "lastUpdated": "2026-04-09T00:29:45.158Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451120f3ad36c01d6d2b1",
-      "lastUpdated": "2026-04-07T00:34:26.096Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2dbc0ec56e77d2d2b43",
+      "lastUpdated": "2026-04-09T00:29:14.938Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451130f3ad36c01d6d2b4",
-      "lastUpdated": "2026-04-07T00:34:59.210Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2dcc0ec56e77d2d2b46",
+      "lastUpdated": "2026-04-09T00:29:48.386Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451150f3ad36c01d6d2b5",
-      "lastUpdated": "2026-04-07T00:49:27.995Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2dec0ec56e77d2d2b47",
+      "lastUpdated": "2026-04-09T00:46:49.783Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451190f3ad36c01d6d2b8",
-      "lastUpdated": "2026-04-07T00:35:36.559Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e3c0ec56e77d2d2b4a",
+      "lastUpdated": "2026-04-09T00:30:27.053Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4511f0f3ad36c01d6d2bc",
-      "lastUpdated": "2026-04-07T00:55:05.452Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e8c0ec56e77d2d2b4e",
+      "lastUpdated": "2026-04-09T00:55:13.692Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4511b0f3ad36c01d6d2b9",
-      "lastUpdated": "2026-04-07T00:34:35.122Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e4c0ec56e77d2d2b4b",
+      "lastUpdated": "2026-04-09T00:29:24.528Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4511c0f3ad36c01d6d2ba",
-      "lastUpdated": "2026-04-07T00:35:39.320Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e5c0ec56e77d2d2b4c",
+      "lastUpdated": "2026-04-09T00:30:29.837Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d4511d0f3ad36c01d6d2bb",
-      "lastUpdated": "2026-04-07T00:34:37.946Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e7c0ec56e77d2d2b4d",
+      "lastUpdated": "2026-04-09T00:29:27.218Z"
     },
     "captcha-api.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698f7df69e27ce1528d7d087/698f7fb0d3b320ad547d9d44",
       "lastUpdated": "2026-02-13T19:55:05.951Z"
     },
     "element-not-found.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451200f3ad36c01d6d2bd",
-      "lastUpdated": "2026-04-07T00:35:43.573Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2eac0ec56e77d2d2b4f",
+      "lastUpdated": "2026-04-09T00:30:34.117Z"
     },
     "formatted-logging.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c873a714b73310c7839450",
       "lastUpdated": "2026-03-29T00:36:10.628Z"
     },
     "hover-text.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451230f3ad36c01d6d2bf",
-      "lastUpdated": "2026-04-07T00:34:43.883Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2edc0ec56e77d2d2b51",
+      "lastUpdated": "2026-04-09T00:29:33.199Z"
     },
     "no-provision.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7706a177a05bccd1cf",
       "lastUpdated": "2026-03-03T00:32:25.279Z"
     },
     "ai.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451220f3ad36c01d6d2be",
-      "lastUpdated": "2026-04-07T00:58:09.203Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2ebc0ec56e77d2d2b50",
+      "lastUpdated": "2026-04-09T00:58:39.073Z"
     },
     "popup-loading.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698bc89f7140c3fa7daaca8d/698bca7f7140c3fa7daacbf7",
@@ -134,12 +134,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451180f3ad36c01d6d2b7",
-      "lastUpdated": "2026-04-07T00:35:03.801Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e1c0ec56e77d2d2b49",
+      "lastUpdated": "2026-04-09T00:29:52.990Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d451050f3ad36c01d6d2a8/69d451250f3ad36c01d6d2c0",
-      "lastUpdated": "2026-04-07T00:35:48.118Z"
+      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2eec0ec56e77d2d2b52",
+      "lastUpdated": "2026-04-09T00:30:38.622Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/v7/debugging-with-screenshots.mdx

@@ -329,6 +329,20 @@ Understanding the directory structure helps with efficient screenshot viewing:
 - All screenshots are PNG format
 - Disable automatic screenshots with `autoScreenshots: false` if needed
 
+## Interaction List Sidebar (Source of Truth)
+
+When viewing a test run in the TestDriver console, the **interaction list sidebar** displays a screenshot for each interaction call (find, click, type, assert, etc.). These screenshots show exactly what was on the screen at the time each interaction was executed.
+
+<Note>
+  **The sidebar screenshots are the source of truth.** If a test is behaving unexpectedly, check the screenshot attached to the specific interaction in the sidebar — it shows precisely what the AI saw when making its decision. This is more reliable than inferring screen state from test logs or local screenshots alone.
+</Note>
+
+Use the interaction list to:
+- **Verify what the AI saw** — confirm the correct page/state was visible when `find()` or `assert()` ran
+- **Debug misclicks** — see whether the target element was actually on screen
+- **Identify timing issues** — spot cases where the UI hadn't finished loading before an interaction fired
+- **Compare runs** — review interaction screenshots across multiple runs to catch flaky behavior
+
 ## Integration with Test Development
 
 ### During MCP Interactive Development

package/docs/v7/examples/ai.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* ai.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451220f3ad36c01d6d2be/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2ebc0ec56e77d2d2b50/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/assert.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* assert.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451160f3ad36c01d6d2b6/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e0c0ec56e77d2d2b48/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/chrome-extension.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* chrome-extension.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451070f3ad36c01d6d2a9/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d0c0ec56e77d2d2b3b/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}
@@ -76,7 +76,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", {zoom: true});
+    const extensionsButton = await testdriver.find("The extensions button in the Chrome toolbar", {zoom: true, verify: true});
     await extensionsButton.click();
 
     // Look for the hello world extension in the extensions menu

package/docs/v7/examples/element-not-found.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* element-not-found.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451200f3ad36c01d6d2bd/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2eac0ec56e77d2d2b4f/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/exec-output.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* exec-output.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d4510f0f3ad36c01d6d2af/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d7c0ec56e77d2d2b41/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/exec-pwsh.mdx

@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* exec-pwsh.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451080f3ad36c01d6d2aa/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d1c0ec56e77d2d2b3c/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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

@@ -18,7 +18,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* findall-coffee-icons.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451180f3ad36c01d6d2b7/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e1c0ec56e77d2d2b49/replay" 
   width="100%" 
   height="600" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d4511d0f3ad36c01d6d2bb/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e7c0ec56e77d2d2b4d/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d451100f3ad36c01d6d2b0/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d9c0ec56e77d2d2b42/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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

@@ -18,7 +18,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* hover-text-with-description.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d4510a0f3ad36c01d6d2ab/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d3c0ec56e77d2d2b3d/replay" 
   width="100%" 
   height="600" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d451230f3ad36c01d6d2bf/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2edc0ec56e77d2d2b51/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d451120f3ad36c01d6d2b1/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2dbc0ec56e77d2d2b43/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d4510c0f3ad36c01d6d2ac/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d5c0ec56e77d2d2b3e/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/parse.mdx

@@ -17,7 +17,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* parse.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d451250f3ad36c01d6d2c0/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2eec0ec56e77d2d2b52/replay" 
   width="100%" 
   height="600" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d451150f3ad36c01d6d2b5/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2dec0ec56e77d2d2b47/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/prompt.mdx

@@ -17,7 +17,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* prompt.test.mjs output */}
 <iframe 
-  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d4511c0f3ad36c01d6d2ba/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e5c0ec56e77d2d2b4c/replay" 
   width="100%" 
   height="600" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d451190f3ad36c01d6d2b8/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e3c0ec56e77d2d2b4a/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d4511b0f3ad36c01d6d2b9/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e4c0ec56e77d2d2b4b/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d4511f0f3ad36c01d6d2bc/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2e8c0ec56e77d2d2b4e/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d451130f3ad36c01d6d2b4/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2dcc0ec56e77d2d2b46/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/69d4510d0f3ad36c01d6d2ae/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d6f2d6c0ec56e77d2d2b40/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/find.mdx

@@ -367,6 +367,39 @@ This two-phase approach gives the AI a higher-resolution view of the target area
   - You need extra precision for closely spaced UI elements
 </Tip>
 
+## Verify Mode
+
+Verify mode is **disabled by default**. When enabled, a second AI call checks that the coordinates returned by `find()` actually correspond to the requested element, catching hallucinated or incorrect positions.
+
+```javascript
+// Enable verification for critical interactions
+const deleteBtn = await testdriver.find('delete account button', { verify: true });
+await deleteBtn.click();
+```
+
+### How Verify Mode Works
+
+1. **Phase 1**: AI locates the element and returns coordinates
+2. **Phase 2**: A second AI call examines the screenshot at those coordinates to confirm the element matches the description
+3. **Result**: If verification fails, the find is retried or marked as not found
+
+### Combining Zoom and Verify
+
+For maximum accuracy, enable both `zoom` and `verify` together. This is useful for critical interactions where clicking the wrong element could cause cascading failures:
+
+```javascript
+// Maximum accuracy: zoom for precision + verify to catch hallucinations
+const element = await testdriver.find('small cancel icon next to the subscription', {
+  zoom: true,
+  verify: true,
+});
+await element.click();
+```
+
+<Warning>
+  Both `zoom` and `verify` add extra AI calls per `find()` invocation, which increases latency and API usage. When both are enabled, each find may make up to 3 AI calls. **Rate limiting may occur** if many find calls use these options in rapid succession. Use them selectively for critical interactions rather than on every find call.
+</Warning>
+
 ## Cache Options
 
 Control caching behavior to optimize performance, especially when using dynamic variables in prompts.

package/examples/chrome-extension.test.mjs

@@ -53,7 +53,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", {zoom: true});
+    const extensionsButton = await testdriver.find("The extensions button in the Chrome toolbar", {zoom: true, verify: true});
     await extensionsButton.click();
 
     // Look for the hello world extension in the extensions menu

package/package.json

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

package/setup/aws/spawn-runner.sh

@@ -145,17 +145,38 @@ done
 echo "Installing runner..."
 
 # Determine environment and version
-TD_CHANNEL="${TD_CHANNEL:-stable}"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-SDK_PKG_JSON="${SCRIPT_DIR}/../../../sdk/package.json"
+# SDK package.json — works both from monorepo (sdk/setup/aws/) and npm install (setup/aws/)
+SDK_PKG_JSON="${SCRIPT_DIR}/../../package.json"
 RUNNER_DIR="${SCRIPT_DIR}/../../../runner"
 
+# Derive channel from TD_CHANNEL env, or from the SDK version's prerelease tag
+# (mirrors sdk/lib/resolve-channel.js logic)
+if [ -z "${TD_CHANNEL:-}" ]; then
+  if [ -f "$SDK_PKG_JSON" ]; then
+    SDK_VERSION=$(jq -r '.version' "$SDK_PKG_JSON")
+    # Extract prerelease tag: "7.6.0-canary.5" → "canary", "7.6.0" → ""
+    PRE_TAG=$(echo "$SDK_VERSION" | sed -n 's/^[0-9]*\.[0-9]*\.[0-9]*-\([a-z]*\).*/\1/p')
+    if [ -n "$PRE_TAG" ] && echo "$PRE_TAG" | grep -qE '^(dev|test|canary|stable)$'; then
+      TD_CHANNEL="$PRE_TAG"
+      echo "Channel derived from SDK version ($SDK_VERSION): $TD_CHANNEL"
+    else
+      TD_CHANNEL="stable"
+      echo "SDK version $SDK_VERSION has no prerelease tag, defaulting to: $TD_CHANNEL"
+    fi
+  else
+    TD_CHANNEL="stable"
+    echo "SDK package.json not found, defaulting channel to: $TD_CHANNEL"
+  fi
+fi
+echo "Using channel: $TD_CHANNEL"
+
 if [ -f "$SDK_PKG_JSON" ]; then
   RUNNER_VERSION=$(jq -r '.version' "$SDK_PKG_JSON")
   echo "Runner version from SDK: $RUNNER_VERSION"
 else
   RUNNER_VERSION="$TD_CHANNEL"
-  echo "SDK package.json not found, using env tag: $RUNNER_VERSION"
+  echo "SDK package.json not found, using channel as runner version: $RUNNER_VERSION"
 fi
 
 if [ "$TD_CHANNEL" = "dev" ]; then