@testdriverai/agent 7.9.77-canary → 7.9.78-test

package/docs/_data/examples-manifest.json

@@ -2,18 +2,18 @@
   "$schema": "./examples-manifest.schema.json",
   "examples": {
     "assert.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02786954296f44f6409ddc",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a027fc316a06c9ad3ff7f4a?share=MlodtLbsUhHST0MlBz7PTA",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a027fc316a06c9ad3ff7f4a?share=MlodtLbsUhHST0MlBz7PTA&embed=true",
-      "lastUpdated": "2026-05-12T01:18:00.788Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a62d3fb50e9fd352c6501",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a0a69f85e84df6215f782f4?share=AaQZE9gfcazcIyAwZ54Dtg",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a0a69f85e84df6215f782f4?share=AaQZE9gfcazcIyAwZ54Dtg&embed=true",
+      "lastUpdated": "2026-05-18T01:23:09.954Z"
     },
     "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/6a02776d54296f44f6409d0b/6a02778654296f44f6409d0d",
-      "lastUpdated": "2026-05-12T00:56:42.999Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a61f2fb50e9fd352c6475",
+      "lastUpdated": "2026-05-18T01:02:42.315Z"
     },
     "match-image.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
@@ -24,92 +24,92 @@
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02779d54296f44f6409d2e",
-      "lastUpdated": "2026-05-12T00:43:09.588Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6208fb50e9fd352c64ab",
+      "lastUpdated": "2026-05-18T00:49:12.155Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a0277cc54296f44f6409d58",
-      "lastUpdated": "2026-05-12T00:57:49.057Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6234fb50e9fd352c64f2",
+      "lastUpdated": "2026-05-18T01:03:48.466Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a0277cd54296f44f6409d5b",
-      "lastUpdated": "2026-05-12T00:57:50.455Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6235fb50e9fd352c64f4",
+      "lastUpdated": "2026-05-18T01:03:49.902Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02778554296f44f6409d0c",
-      "lastUpdated": "2026-05-12T00:49:42.188Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a61f0fb50e9fd352c646e",
+      "lastUpdated": "2026-05-18T00:55:44.331Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a0277b454296f44f6409d2f",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a027d7916a06c9ad3ff7f3a?share=SQNzlyu0fDKhDP9hEnEJQ",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a027d7916a06c9ad3ff7f3a?share=SQNzlyu0fDKhDP9hEnEJQ&embed=true",
-      "lastUpdated": "2026-05-12T01:08:15.625Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a621dfb50e9fd352c64d5",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a0a67d35e84df6215f782e4?share=BZj28mmTsITtFqfMHy74Hw",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a0a67d35e84df6215f782e4?share=BZj28mmTsITtFqfMHy74Hw&embed=true",
+      "lastUpdated": "2026-05-18T01:14:01.776Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a0277e354296f44f6409d86",
-      "lastUpdated": "2026-05-12T00:51:16.367Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a624bfb50e9fd352c64f7",
+      "lastUpdated": "2026-05-18T00:57:17.705Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a0277f954296f44f6409d9a",
-      "lastUpdated": "2026-05-12T00:44:41.188Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6264fb50e9fd352c64fc",
+      "lastUpdated": "2026-05-18T00:50:44.205Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02783c54296f44f6409dd3",
-      "lastUpdated": "2026-05-12T00:52:46.240Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a62a5fb50e9fd352c64ff",
+      "lastUpdated": "2026-05-18T00:58:43.676Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02785254296f44f6409ddb",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a027f8016a06c9ad3ff7f48?share=pkMQtLSewS8SUNptOBLww",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a027f8016a06c9ad3ff7f48?share=pkMQtLSewS8SUNptOBLww&embed=true",
-      "lastUpdated": "2026-05-12T01:16:54.775Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a62bcfb50e9fd352c6500",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a0a69b95e84df6215f782f2?share=YxG4LqDBIszM8ed0axBXCw",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a0a69b95e84df6215f782f2?share=YxG4LqDBIszM8ed0axBXCw&embed=true",
+      "lastUpdated": "2026-05-18T01:22:07.432Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02789554296f44f6409de4",
-      "lastUpdated": "2026-05-12T01:01:10.622Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6302fb50e9fd352c6503",
+      "lastUpdated": "2026-05-18T01:07:11.127Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a0278b154296f44f6409dec",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a0280d716a06c9ad3ff7f50?share=UsKLNYYcQ8QC8p4YWEsuA",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a0280d716a06c9ad3ff7f50?share=UsKLNYYcQ8QC8p4YWEsuA&embed=true",
-      "lastUpdated": "2026-05-12T01:22:37.550Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a631efb50e9fd352c6507",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a0a6afe5e84df6215f782fa?share=OuQYCYU4nb44QRLS6JCejQ",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a0a6afe5e84df6215f782fa?share=OuQYCYU4nb44QRLS6JCejQ&embed=true",
+      "lastUpdated": "2026-05-18T01:27:32.768Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02789754296f44f6409de6",
-      "lastUpdated": "2026-05-12T00:47:19.249Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6304fb50e9fd352c6504",
+      "lastUpdated": "2026-05-18T00:53:24.479Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02789854296f44f6409de8",
-      "lastUpdated": "2026-05-12T01:01:13.617Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6305fb50e9fd352c6505",
+      "lastUpdated": "2026-05-18T01:07:14.174Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02789a54296f44f6409dea",
-      "lastUpdated": "2026-05-12T00:47:22.143Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6307fb50e9fd352c6506",
+      "lastUpdated": "2026-05-18T00:53:27.493Z"
     },
     "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/6a02776d54296f44f6409d0b/6a0278c954296f44f6409ded",
-      "lastUpdated": "2026-05-12T01:01:58.349Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6334fb50e9fd352c6508",
+      "lastUpdated": "2026-05-18T01:08:01.612Z"
     },
     "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/6a02776d54296f44f6409d0b/6a0278f754296f44f6409df1",
-      "lastUpdated": "2026-05-12T00:48:55.475Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6364fb50e9fd352c650a",
+      "lastUpdated": "2026-05-18T00:55:00.064Z"
     },
     "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/6a02776d54296f44f6409d0b/6a0278df54296f44f6409dee",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a02819816a06c9ad3ff7f54?share=VLoWolQt0KUJtZAuoHaQ",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a02819816a06c9ad3ff7f54?share=VLoWolQt0KUJtZAuoHaQ&embed=true",
-      "lastUpdated": "2026-05-12T01:25:51.008Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a634dfb50e9fd352c6509",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a0a6bbf5e84df6215f782fe?share=EdDcVTwBw6TWT2QyoDOxYg",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a0a6bbf5e84df6215f782fe?share=EdDcVTwBw6TWT2QyoDOxYg&embed=true",
+      "lastUpdated": "2026-05-18T01:30:45.341Z"
     },
     "popup-loading.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698bc89f7140c3fa7daaca8d/698bca7f7140c3fa7daacbf7",
@@ -144,12 +144,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02787f54296f44f6409de1",
-      "lastUpdated": "2026-05-12T00:53:57.607Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a62ebfb50e9fd352c6502",
+      "lastUpdated": "2026-05-18T00:59:52.578Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a02776d54296f44f6409d0b/6a02790e54296f44f6409df3",
-      "lastUpdated": "2026-05-12T01:03:07.032Z"
+      "url": "https://console-test.testdriver.ai/runs/6a0a61dafb50e9fd352c6464/6a0a6379fb50e9fd352c650b",
+      "lastUpdated": "2026-05-18T01:09:07.859Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/changelog.mdx

@@ -110,7 +110,7 @@ This release includes all changes from v7.8.0-canary.4 with version bumps.
 ✨ New features
 
 - **[Cache API](/v7/cache)** — Speed up repeated test runs with screenshot-based caching. The system compares screenshots to cached results and reuses element positions when the screen hasn't changed, reducing AI calls.
-- **[Custom error classes](/v7/errors)** — New `ElementNotFoundError` and `AIError` classes with rich debugging info including screenshot paths, pixel diffs, and detailed messages.
+- **[Custom error classes](/v7/errors)** — New `ElementNotFoundError` class with rich debugging info including screenshot paths, pixel diffs, and detailed messages.
 - **[Events system](/v7/events)** — Listen to SDK lifecycle events with wildcard support via `testdriver.emitter`. Uses colon-delimited namespaces (e.g., `command:start`, `log:*`).
 - **[Provision API](/v7/provision)** — Launch browsers, desktop apps, VS Code, and Chrome extensions in your sandbox before tests run. Access via `testdriver.provision.*`.
 - **[Redraw detection](/v7/redraw)** — Wait for screens to stabilize after interactions using two-phase detection with pixel comparison and z-score analysis.

package/docs/v7/_drafts/best-practices.mdx

@@ -117,18 +117,6 @@ await button.click();
 
 ## Actions
 
-### Use Descriptive Prompts
-
-```javascript
-// ❌ Generic
-await testdriver.ai('login');
-
-// ✅ Specific steps
-await testdriver.ai('click the username field and type user@example.com');
-await testdriver.ai('click the password field and type password123');
-await testdriver.ai('click the blue submit button');
-```
-
 ### Chain Actions
 
 ```javascript

package/docs/v7/_drafts/configuration.mdx

@@ -205,18 +205,6 @@ const { testdriver, dashcam } = await electron(context, {
 
 ## Cache Configuration
 
-### Prompt Cache
-
-Configure AI prompt caching:
-
-```javascript
-// Disable prompt cache globally
-process.env.TD_NO_PROMPT_CACHE = 'true';
-
-// Per call
-await testdriver.ai('click button', false); // bypass cache
-```
-
 ### Selector Cache
 
 Configure element location caching:

package/docs/v7/_drafts/faq.mdx

@@ -116,21 +116,13 @@ Features:
 
 ### How does caching work?
 
-Two types of caching:
-
-**1. Prompt Cache** - Caches AI-generated commands locally
-```javascript
-await testdriver.ai('click button'); // AI call
-await testdriver.ai('click button'); // Uses cache
-```
-
-**2. Selector Cache** - Caches element locations on server
+**Selector Cache** - Caches element locations on server
 ```javascript
 await testdriver.find('button'); // AI vision
 await testdriver.find('button'); // Cache hit (95%+ similar UI)
 ```
 
-See [caching guide](/v7/guides/caching-ai) for details.
+See [caching guide](/v7/caching) for details.
 
 ### Can I test responsive designs?
 

package/docs/v7/_drafts/troubleshooting.mdx

@@ -331,11 +331,8 @@ test('slow test', async () => {
 
 **2. Optimize test:**
 ```javascript
-// Use faster actions
+// Use explicit actions
 await testdriver.find('button').then(el => el.click());
-
-// Instead of
-await testdriver.ai('click the button');
 ```
 
 ### Tests Fail in CI

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://console-test.testdriver.ai/replay/6a02819816a06c9ad3ff7f54?share=VLoWolQt0KUJtZAuoHaQ&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a0a6bbf5e84df6215f782fe?share=EdDcVTwBw6TWT2QyoDOxYg&embed=true" 
   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://console-test.testdriver.ai/replay/6a027fc316a06c9ad3ff7f4a?share=MlodtLbsUhHST0MlBz7PTA&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a0a69f85e84df6215f782f4?share=AaQZE9gfcazcIyAwZ54Dtg&embed=true" 
   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/6a02778554296f44f6409d0c/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a61f0fb50e9fd352c646e/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

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/6a0278c954296f44f6409ded/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a6334fb50e9fd352c6508/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/6a02787f54296f44f6409de1/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a62ebfb50e9fd352c6502/replay" 
   width="100%" 
   height="600" 
   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/6a0277e354296f44f6409d86/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a624bfb50e9fd352c64f7/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/6a02779d54296f44f6409d2e/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a6208fb50e9fd352c64ab/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/6a0278f754296f44f6409df1/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a6364fb50e9fd352c650a/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/6a0277f954296f44f6409d9a/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a6264fb50e9fd352c64fc/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://console-test.testdriver.ai/replay/6a027d7916a06c9ad3ff7f3a?share=SQNzlyu0fDKhDP9hEnEJQ&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a0a67d35e84df6215f782e4?share=BZj28mmTsITtFqfMHy74Hw&embed=true" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/examples/parse.mdx

@@ -18,7 +18,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/6a02790e54296f44f6409df3/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a6379fb50e9fd352c650b/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://console-test.testdriver.ai/replay/6a027f8016a06c9ad3ff7f48?share=pkMQtLSewS8SUNptOBLww&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a0a69b95e84df6215f782f2?share=YxG4LqDBIszM8ed0axBXCw&embed=true" 
   width="100%" 
   height="390" 
   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/6a02789554296f44f6409de4/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a6302fb50e9fd352c6503/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://console-test.testdriver.ai/replay/6a0280d716a06c9ad3ff7f50?share=UsKLNYYcQ8QC8p4YWEsuA&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a0a6afe5e84df6215f782fa?share=OuQYCYU4nb44QRLS6JCejQ&embed=true" 
   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/6a02783c54296f44f6409dd3/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a0a62a5fb50e9fd352c64ff/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/package.json

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

package/docs/v7/_drafts/caching-ai.mdx

@@ -1,215 +0,0 @@
----
-title: "AI Prompt Caching"
-sidebarTitle: "AI Caching"
-description: "How TestDriver caches AI-generated YAML commands for faster tests"
-icon: "bolt"
----
-
-## Overview
-
-The Prompt Cache stores AI-generated YAML commands locally, so repeated `.ai()` calls with the same prompt skip the AI entirely.
-
-This provides:
-- ⚡ **Instant execution** - No AI call needed
-- 💰 **Cost savings** - Reduces API usage
-- 🔌 **Offline testing** - Works without network
-- 🎯 **Deterministic** - Same prompt = same commands
-
-## How It Works
-
-<Steps>
-  <Step title="First Call">
-    ```javascript
-    await testdriver.ai('click the submit button');
-    ```
-    
-    - Sends prompt + screenshot to AI
-    - Receives YAML commands
-    - Saves to `.testdriver/.cache/{prompt-hash}.yaml`
-  </Step>
-  
-  <Step title="Subsequent Calls">
-    ```javascript
-    await testdriver.ai('click the submit button');
-    ```
-    
-    - Checks cache first
-    - Finds matching cached YAML
-    - Uses cached commands (no AI call)
-    - Shows `(using cached response)` in output
-  </Step>
-</Steps>
-
-## Cache Location
-
-Cached prompts are stored locally in your project:
-
-```
-.testdriver/
-  .cache/
-    click-the-submit-button-a1b2c3d4.yaml
-    find-login-form-e5f6a7b8.yaml
-    verify-dashboard-c9d0e1f2.yaml
-```
-
-Files are named using:
-- Sanitized prompt (first 50 chars, alphanumeric)
-- MD5 hash of full prompt for uniqueness
-
-## Cache Matching
-
-The prompt cache uses **exact text matching**:
-- Case-insensitive comparison
-- Whitespace trimmed
-- No screenshot comparison
-
-```javascript
-// These all match the same cache entry:
-await testdriver.ai('click the submit button');
-await testdriver.ai('CLICK THE SUBMIT BUTTON');
-await testdriver.ai('  click the submit button  ');
-
-// This creates a new cache entry:
-await testdriver.ai('click the submit btn'); // Different text
-```
-
-## Disabling Prompt Cache
-
-Bypass the cache for a specific call:
-
-```javascript
-// Force fresh AI call, bypass cache
-await testdriver.ai('click the submit button', false);
-
-// These use cache (default)
-await testdriver.ai('click the submit button');
-await testdriver.ai('click the submit button', true);
-```
-
-## Clearing Prompt Cache
-
-Clear all cached prompts:
-
-```bash
-rm -rf .testdriver/.cache/*.yaml
-```
-
-Or programmatically:
-
-```javascript
-const promptCache = require('testdriverai/agent/lib/cache.js');
-promptCache.clearCache();
-```
-
-## Usage Examples
-
-### Basic Caching
-
-```javascript
-import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
-
-test('login flow', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com/login'
-  });
-  
-  // First call: AI generates commands, saves to cache
-  await testdriver.ai('click the login button');
-  
-  // Run test again - uses cache (instant)
-  // Look for: "(using cached response)" in output
-});
-```
-
-### Bypassing Cache
-
-```javascript
-test('always fresh', async (context) => {
-  const { testdriver } = await chrome(context, { url });
-  
-  // Always get fresh AI response
-  await testdriver.ai('analyze the current state', false);
-});
-```
-
-## Best Practices
-
-### 1. Use Consistent Prompts
-
-```javascript
-// ✅ Good - consistent prompt
-await testdriver.ai('fill out the login form');
-await testdriver.ai('fill out the login form'); // Cache hit
-
-// ❌ Bad - different prompts
-await testdriver.ai('fill out the login form');
-await testdriver.ai('complete the login form'); // Cache miss
-```
-
-### 2. Clear Cache When Test Logic Changes
-
-If you update your test prompts, clear the cache:
-
-```bash
-rm -rf .testdriver/.cache/*.yaml
-```
-
-### 3. Don't Commit Cache to Git
-
-Add to `.gitignore`:
-
-```gitignore
-.testdriver/.cache/
-```
-
-### 4. Version Control Consideration
-
-While you _can_ commit cached prompts for team consistency, it's generally not recommended because:
-- AI responses may improve over time
-- Different team members may need different cached results
-- Cache files can become stale
-
-## Cache Storage Details
-
-| Property | Value |
-|----------|-------|
-| Location | Local (`.testdriver/.cache/`) |
-| Persistence | Until manually cleared |
-| Scope | Per-project |
-| Matching | Exact prompt text (case-insensitive) |
-| Expiration | Never |
-
-## Troubleshooting
-
-### Cache Not Working
-
-Check:
-1. Prompts match exactly (case-insensitive)
-2. `.testdriver/.cache/` directory exists and is writable
-3. `TD_NO_PROMPT_CACHE` environment variable is not set
-
-### Stale Cache Data
-
-If AI responses seem outdated:
-
-```bash
-# Clear all cached prompts
-rm -rf .testdriver/.cache/*.yaml
-```
-
-Or clear specific prompts:
-
-```bash
-# Find cache files
-ls -la .testdriver/.cache/
-
-# Delete specific cache file
-rm .testdriver/.cache/click-the-submit-button-*.yaml
-```
-
-## See Also
-
-- [Selector Caching](/v7/guides/caching-selectors) - Cache element locations
-- [`.ai()` Method](/v7/api/ai) - AI command generation
-- [Vitest Integration](/v7/guides/vitest) - Testing with TestDriver

package/docs/v7/_drafts/caching.mdx

@@ -1,366 +0,0 @@
----
-title: "Caching Prompts"
-sidebarTitle: "Caching Prompts"
-description: "How TestDriver caches AI responses and element locations for faster tests"
-icon: "bolt"
----
-
-## Overview
-
-TestDriver uses two types of caching to dramatically speed up your tests and reduce AI costs:
-
-1. **Prompt Cache** - Caches AI-generated commands (`.ai()` responses)
-2. **Selector Cache** - Caches element locations (`.find()` results)
-
-Both caches are enabled by default and work automatically.
-
-## Prompt Cache
-
-The Prompt Cache stores AI-generated YAML commands locally, so repeated `.ai()` calls with the same prompt skip the AI entirely.
-
-### How It Works
-
-<Steps>
-  <Step title="First Call">
-    ```javascript
-    await testdriver.ai('click the submit button');
-    ```
-    
-    - Sends prompt + screenshot to AI
-    - Receives YAML commands
-    - Saves to `.testdriver/.cache/{prompt-hash}.yaml`
-  </Step>
-  
-  <Step title="Subsequent Calls">
-    ```javascript
-    await testdriver.ai('click the submit button');
-    ```
-    
-    - Checks cache first
-    - Finds matching cached YAML
-    - Uses cached commands (no AI call)
-    - Shows `(using cached response)` in output
-  </Step>
-</Steps>
-
-### Cache Location
-
-Cached prompts are stored locally:
-
-```
-.testdriver/
-  .cache/
-    click-the-submit-button-a1b2c3d4.yaml
-    find-login-form-e5f6a7b8.yaml
-    verify-dashboard-c9d0e1f2.yaml
-```
-
-Files are named using:
-- Sanitized prompt (first 50 chars, alphanumeric)
-- MD5 hash of full prompt for uniqueness
-
-### Disabling Prompt Cache
-
-Bypass the cache for a specific call:
-
-```javascript
-// Force fresh AI call, bypass cache
-await testdriver.ai('click the submit button', false);
-
-// These use cache (default)
-await testdriver.ai('click the submit button');
-await testdriver.ai('click the submit button', true);
-```
-
-### Clearing Prompt Cache
-
-Clear all cached prompts:
-
-```bash
-rm -rf .testdriver/.cache/*.yaml
-```
-
-Or programmatically:
-
-```javascript
-const promptCache = require('testdriverai/agent/lib/cache.js');
-promptCache.clearCache();
-```
-
-### Benefits
-
-- ⚡ **Instant execution** - No AI call needed
-- 💰 **Cost savings** - Reduces API usage
-- 🔌 **Offline testing** - Works without network
-- 🎯 **Deterministic** - Same prompt = same commands
-
-## Selector Cache
-
-The Selector Cache stores element locations on the server, so `.find()` calls can skip the AI vision analysis.
-
-### How It Works
-
-```mermaid
-sequenceDiagram
-    participant Test as Your Test
-    participant SDK as TestDriver SDK
-    participant API as TestDriver API
-    participant AI as Claude Vision
-    participant Cache as Selector Cache DB
-
-    Test->>SDK: testdriver.find('submit button')
-    SDK->>API: POST /locate (screenshot + prompt)
-    
-    API->>Cache: Check for matching cache entry
-    
-    alt Cache Hit (95%+ similar screenshot)
-        Cache-->>API: Return cached coordinates
-        API-->>SDK: {x, y, cacheHit: true}
-        SDK-->>Test: Element found (instant)
-    else Cache Miss
-        API->>AI: Analyze screenshot
-        AI-->>API: Element coordinates
-        API->>Cache: Save new cache entry
-        API-->>SDK: {x, y, cacheHit: false}
-        SDK-->>Test: Element found
-    end
-```
-
-### Cache Matching Strategy
-
-The selector cache uses a three-tier matching system:
-
-1. **Exact Hash Match** (Fastest)
-   - Perceptual hash comparison
-   - Same screenshot = instant match
-   - 0% difference threshold
-
-2. **Pixel Diff Match** (Fast)
-   - 80%+ perceptual hash similarity
-   - Pixel-by-pixel comparison
-   - Default 5% difference threshold (95% similarity)
-   - Configurable per call
-
-3. **Template Match** (Fallback)
-   - Edge detection + template matching
-   - Finds visually similar UI elements
-   - 75%+ confidence threshold
-
-### Viewing Cache Entries
-
-View all cached selectors at [console.testdriver.ai](https://console.testdriver.ai)
-
-The console shows:
-- Cached screenshots with green circles on found elements
-- Original prompts
-- Hit count (how many times cache was used)
-- Similarity scores
-- Cache age and last accessed time
-
-### Controlling Cache Threshold
-
-Adjust similarity threshold per call:
-
-```javascript
-// Default: 95% similarity (5% difference allowed)
-await testdriver.find('submit button');
-
-// Stricter: 99% similarity (1% difference allowed)
-await testdriver.find('submit button', { threshold: 0.01 });
-
-// More lenient: 90% similarity (10% difference allowed)
-await testdriver.find('submit button', { threshold: 0.10 });
-
-// Disable cache: force fresh AI analysis
-await testdriver.find('submit button', { threshold: -1 });
-```
-
-### Cache Filtering
-
-The selector cache automatically filters by:
-
-- **Prompt** - Exact text match (case-insensitive)
-- **Team** - Your team ID
-- **OS** - Operating system (if specified)
-- **Resolution** - Screen resolution (if specified)
-- **Time Window** - Last 7 days by default
-
-### Cache Statistics
-
-Each cache entry tracks:
-
-- **Hit Count** - Number of times cache was used
-- **Last Hit** - When cache was last accessed
-- **Similarity** - Percentage match to original
-- **Created At** - When entry was created
-- **Element Type** - button, input, link, etc.
-- **Element Bounds** - Bounding box coordinates
-
-### Benefits
-
-- ⚡ **Up to 10x faster** - Skip AI vision analysis
-- 💰 **Lower AI costs** - Fewer vision API calls
-- 🎯 **Consistent results** - Same UI = same coordinates
-- 📊 **Metrics tracking** - See cache hit rates in console
-
-## Cache Behavior Examples
-
-### Prompt Cache Example
-
-```javascript
-import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
-
-test('login flow', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://myapp.com/login'
-  });
-  
-  // First call: AI generates commands, saves to cache
-  await testdriver.ai('click the login button');
-  
-  // Run test again - uses cache (instant)
-  // Look for: "(using cached response)" in output
-});
-```
-
-### Selector Cache Example
-
-```javascript
-import { test } from 'vitest';
-import { chrome } from 'testdriverai/presets';
-
-test('find element', async (context) => {
-  const { testdriver } = await chrome(context, {
-    url: 'https://example.com'
-  });
-  
-  // First call: AI vision analysis, saves to cache
-  const button = await testdriver.find('More information link');
-  console.log('Cache hit:', button.cacheHit); // false
-  
-  // Second call: uses cache (instant)
-  const button2 = await testdriver.find('More information link');
-  console.log('Cache hit:', button2.cacheHit); // true
-});
-```
-
-### Dynamic Threshold Example
-
-```javascript
-test('strict vs lenient matching', async (context) => {
-  const { testdriver } = await chrome(context, { url });
-  
-  // Strict: 99% similarity required
-  const elem1 = await testdriver.find('button', { threshold: 0.01 });
-  
-  // Lenient: 90% similarity acceptable
-  const elem2 = await testdriver.find('button', { threshold: 0.10 });
-  
-  // Bypass cache entirely
-  const elem3 = await testdriver.find('button', { threshold: -1 });
-});
-```
-
-## Best Practices
-
-### 1. Use Consistent Prompts
-
-```javascript
-// ✅ Good - consistent prompt
-await testdriver.find('submit button');
-await testdriver.find('submit button'); // Cache hit
-
-// ❌ Bad - different prompts
-await testdriver.find('submit button');
-await testdriver.find('the submit button'); // Cache miss
-```
-
-### 2. Clear Cache When UI Changes
-
-If your UI changes significantly, clear the cache:
-
-```bash
-# Clear prompt cache
-rm -rf .testdriver/.cache/*.yaml
-
-# Clear selector cache
-# Use console.testdriver.ai to delete entries
-```
-
-### 3. Use Appropriate Thresholds
-
-```javascript
-// Stable UI: strict threshold
-await testdriver.find('logo', { threshold: 0.01 });
-
-// Dynamic UI: lenient threshold
-await testdriver.find('news feed item', { threshold: 0.10 });
-
-// Always fresh: disable cache
-await testdriver.find('timestamp', { threshold: -1 });
-```
-
-### 4. Monitor Cache Performance
-
-Check [console.testdriver.ai](https://console.testdriver.ai) regularly to:
-- See cache hit rates
-- Identify frequently used selectors
-- Remove stale cache entries
-- Optimize threshold settings
-
-## Cache Storage
-
-| Cache Type | Location | Persistence |
-|------------|----------|-------------|
-| Prompt Cache | Local (`.testdriver/.cache/`) | Until manually cleared |
-| Selector Cache | Server (MongoDB + S3) | 7 days default |
-
-## Important Notes
-
-### Prompt Cache
-
-- Cache keys are **prompt text only** (no screenshot comparison)
-- Case-insensitive, trimmed matching
-- Safe to commit to version control (but not recommended)
-- Never expires automatically
-
-### Selector Cache
-
-- Cache matches by **screenshot similarity** + prompt
-- Platform-specific (OS, resolution)
-- Team-scoped (your cache entries only)
-- 7-day rolling window by default
-
-## Troubleshooting
-
-### Prompt Cache Not Working
-
-Check:
-1. Prompts match exactly (case-insensitive)
-2. `.testdriver/.cache/` directory exists and is writable
-3. `TD_NO_PROMPT_CACHE` environment variable is not set
-
-### Selector Cache Not Working
-
-Check:
-1. Threshold isn't too strict (try 0.10 for 90% similarity)
-2. Screenshot hasn't changed significantly
-3. OS/resolution matches cached entry
-4. Cache entry isn't older than 7 days
-
-### Stale Cache Data
-
-Clear prompt cache:
-```bash
-rm -rf .testdriver/.cache/*.yaml
-```
-
-Delete selector cache entries at [console.testdriver.ai](https://console.testdriver.ai)
-
-## See Also
-
-- [Console Dashboard](https://console.testdriver.ai) - View and manage selector cache
-- [`.ai()` Method](/v7/api/ai) - AI command generation
-- [`.find()` Method](/v7/api/find) - Element location
-- [Vitest Integration](/v7/guides/vitest) - Testing with TestDriver

package/docs/v7/_drafts/prompt-cache.mdx

@@ -1,200 +0,0 @@
-# Prompt Cache System
-
-## Overview
-
-The TestDriver SDK includes automatic caching of `.ai()` responses. When you use the SDK to execute natural language prompts, the YAML commands generated by the AI are cached locally to improve performance and reduce API calls.
-
-**Caching is enabled by default** and can be controlled per-call using the `cache` parameter.
-
-## How It Works
-
-1. **First Call**: When you call `.ai('click the submit button')` for the first time:
-
-   - The SDK sends the prompt and screenshot to the API
-   - The API returns YAML commands in markdown format
-   - The response is cached to `.testdriver/.cache/{prompt-hash}.yaml`
-
-2. **Subsequent Calls**: When you call `.ai('click the submit button')` again:
-
-   - The SDK checks the cache first
-   - If found, it uses the cached YAML instead of calling the API
-   - You'll see `(using cached response)` in the output
-
-3. **Disable Caching**: Pass `false` as the second parameter:
-   - `.ai('click the submit button', false)` bypasses the cache
-   - Forces a fresh API call and updates the cache
-
-## Cache Location
-
-Cached responses are stored in:
-
-```
-.testdriver/.cache/
-```
-
-Files are named using a combination of:
-
-- Sanitized prompt (first 50 chars, alphanumeric only)
-- MD5 hash of the full prompt for uniqueness
-
-Example:
-
-```
-.testdriver/.cache/click-the-submit-button-a1b2c3d4e5f6.yaml
-```
-
-## Benefits
-
-- **Faster execution**: No API call needed for repeated prompts
-- **Cost savings**: Reduces API usage for repeated operations
-- **Offline testing**: Can rerun tests without network access
-- **Deterministic tests**: Same prompt always produces same commands
-
-## Disabling Cache
-
-To disable caching for a specific `.ai()` call, pass `false` as the second parameter:
-
-```javascript
-// Force fresh API call, bypass cache
-await client.ai("click the submit button", false);
-```
-
-Caching is **enabled by default** (equivalent to passing `true`):
-
-```javascript
-// These are equivalent
-await client.ai("click the submit button");
-await client.ai("click the submit button", true);
-```
-
-## Clearing Cache
-
-To clear all cached prompts:
-
-```bash
-rm -rf .testdriver/.cache/*.yaml
-```
-
-Or programmatically:
-
-```javascript
-const promptCache = require("testdriverai/agent/lib/cache.js");
-promptCache.clearCache();
-```
-
-## Usage Examples
-
-### Basic Usage (Automatic Caching)
-
-```javascript
-const TestDriver = require("testdriverai");
-
-const client = new TestDriver(process.env.TD_API_KEY);
-await client.connect();
-
-// First call - makes API request and caches
-await client.ai("click the login button");
-
-// Second call - uses cache (instant)
-await client.ai("click the login button");
-
-// Force fresh API call, bypass cache
-await client.ai("click the login button", false);
-```
-
-### Check Cache Status
-
-```javascript
-const promptCache = require("testdriverai/agent/lib/cache.js");
-
-// Check if a prompt is cached
-if (promptCache.hasCache("click the login button")) {
-  console.log("This prompt is cached");
-}
-
-// Get cache statistics
-const stats = promptCache.getCacheStats();
-console.log(`Cached prompts: ${stats.count}`);
-console.log(`Files: ${stats.files}`);
-```
-
-### Read Cached YAML
-
-```javascript
-const promptCache = require("testdriverai/agent/lib/cache.js");
-
-const yaml = promptCache.readCache("click the login button");
-if (yaml) {
-  console.log("Cached YAML:", yaml);
-}
-```
-
-### Manual Cache Control
-
-```javascript
-const promptCache = require("testdriverai/agent/lib/cache.js");
-
-// Write to cache manually
-promptCache.writeCache("custom prompt", yamlContent);
-
-// Clear entire cache
-promptCache.clearCache();
-
-// Get cache path for a prompt
-const path = promptCache.getCachePath("my prompt");
-console.log(`Cache file: ${path}`);
-```
-
-## Important Notes
-
-1. **Prompt Matching**: Cache keys are based on the exact prompt text (case-insensitive, trimmed)
-
-   - `'Click the button'` and `'click the button'` will match
-   - `'Click the button'` and `'Click the button '` will match (trailing space trimmed)
-   - `'Click button'` and `'Click the button'` will NOT match
-
-2. **No Screenshot Comparison**: The cache does NOT compare screenshots
-
-   - Cached responses assume the UI state is similar
-   - Use different prompts if the UI state has changed significantly
-
-3. **Manual Cache Management**: The cache never expires automatically
-
-   - Clear it periodically if needed
-   - Delete specific files if a prompt's behavior should change
-
-4. **Version Compatibility**: Cache files are plain YAML
-   - Compatible across TestDriver versions
-   - Safe to commit to version control (though not recommended)
-
-## Testing
-
-Run the test suite to verify caching:
-
-```bash
-node test-prompt-cache.js
-```
-
-This will:
-
-- Make an initial `.ai()` call that caches the response
-- Make a second `.ai()` call that uses the cache
-- Show cache statistics and file locations
-
-## Troubleshooting
-
-### Cache not being used
-
-- Check that prompts match exactly (case-insensitive)
-- Verify `TD_NO_PROMPT_CACHE` is not set
-- Check `.testdriver/.cache/` directory exists and is writable
-
-### Stale cache data
-
-- Clear the cache directory
-- Or delete specific cached prompt files
-
-### Permission errors
-
-- Ensure `.testdriver/.cache/` is writable
-- Check file system permissions