@testdriverai/mcp 7.11.5-test → 7.11.7-canary

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

@@ -125,6 +125,10 @@ const testdriver = new TestDriver(apiKey, options)
       Cache key for element finding operations. If provided, enables caching tied to this key.
     </ParamField>
     
+    <ParamField path="verify" type="boolean" default="false">
+      Global default for AI verification of located elements. When `true`, every `find()` runs a second AI check to confirm the returned coordinates actually match the requested element (catching hallucinated or incorrect positions), at the cost of extra latency. Can be overridden per call via `find(description, { verify: true | false })`.
+    </ParamField>
+    
     <ParamField path="dashcam" type="boolean" default="true">
       Enable or disable Dashcam video recording
     </ParamField>

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

@@ -54,7 +54,7 @@ const element = await testdriver.find(description, options)
     </ParamField>
     
     <ParamField path="verify" type="boolean" default={false}>
-      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency.
+      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency. Defaults to the global `verify` option set on the SDK constructor when not specified per call.
     </ParamField>
     
     <ParamField path="ai" type="object">

package/ai/skills/testdriver:client/SKILL.md

@@ -121,6 +121,10 @@ const testdriver = new TestDriver(apiKey, options)
       Cache key for element finding operations. If provided, enables caching tied to this key.
     </ParamField>
     
+    <ParamField path="verify" type="boolean" default="false">
+      Global default for AI verification of located elements. When `true`, every `find()` runs a second AI check to confirm the returned coordinates actually match the requested element (catching hallucinated or incorrect positions), at the cost of extra latency. Can be overridden per call via `find(description, { verify: true | false })`.
+    </ParamField>
+    
     <ParamField path="dashcam" type="boolean" default="true">
       Enable or disable Dashcam video recording
     </ParamField>

package/ai/skills/testdriver:find/SKILL.md

@@ -54,7 +54,7 @@ const element = await testdriver.find(description, options)
     </ParamField>
     
     <ParamField path="verify" type="boolean" default={false}>
-      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency.
+      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency. Defaults to the global `verify` option set on the SDK constructor when not specified per call.
     </ParamField>
     
     <ParamField path="ai" type="object">

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/6a4c4bd323dcc2e575ab5c0a/6a4c4cc58cd69b3fa8c8980f",
-      "lastUpdated": "2026-07-07T00:48:05.133Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5bb3e5d15d75eac0d7e",
+      "lastUpdated": "2026-07-15T00:35:07.257Z"
     },
     "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/6a4c4bd323dcc2e575ab5c0a/6a4c4bed8cd69b3fa8c897c7",
-      "lastUpdated": "2026-07-07T00:51:26.821Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d4e3823fc6a1246b8e52",
+      "lastUpdated": "2026-07-15T00:38:21.897Z"
     },
     "match-image.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
@@ -22,88 +22,88 @@
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c1e287f1ae277c1ff81",
-      "lastUpdated": "2026-07-07T00:52:15.546Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5133e5d15d75eac0d2a",
+      "lastUpdated": "2026-07-15T00:39:07.525Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c208cd69b3fa8c897e1",
-      "lastUpdated": "2026-07-07T01:10:58.312Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5142274a992c42745e2",
+      "lastUpdated": "2026-07-15T00:57:11.884Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c228cd69b3fa8c897e2",
-      "lastUpdated": "2026-07-07T00:59:09.739Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5162274a992c42745e4",
+      "lastUpdated": "2026-07-15T00:46:13.121Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4beb8cd69b3fa8c897c4",
-      "lastUpdated": "2026-07-07T00:51:24.117Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d4e13e5d15d75eac0d1c",
+      "lastUpdated": "2026-07-15T00:38:19.595Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c068cd69b3fa8c897cd",
-      "lastUpdated": "2026-07-07T00:58:40.320Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d4fb2274a992c42745e0",
+      "lastUpdated": "2026-07-15T00:45:45.182Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c3b287f1ae277c1ff92",
-      "lastUpdated": "2026-07-07T00:45:47.106Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d52c823fc6a1246b8e58",
+      "lastUpdated": "2026-07-15T00:32:44.332Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c69287f1ae277c1ffa6",
-      "lastUpdated": "2026-07-07T00:46:33.274Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d55d3e5d15d75eac0d4e",
+      "lastUpdated": "2026-07-15T00:33:33.466Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4c948cd69b3fa8c89809",
-      "lastUpdated": "2026-07-07T01:01:04.253Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d58c2274a992c4274611",
+      "lastUpdated": "2026-07-15T00:48:10.956Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4cad287f1ae277c1ffac",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a4c53cf8cd69b3fa8c8986e?share=ynZ6gn7JlP9dW2rY2Oc5bQ",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a4c53cf8cd69b3fa8c8986e?share=ynZ6gn7JlP9dW2rY2Oc5bQ&embed=true",
-      "lastUpdated": "2026-07-07T01:18:15.316Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5a33e5d15d75eac0d77",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a56dc8e3e5d15d75eac0df0?share=ZM6rTCmGwCpC1YtUtOcbhw",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a56dc8e3e5d15d75eac0df0?share=ZM6rTCmGwCpC1YtUtOcbhw&embed=true",
+      "lastUpdated": "2026-07-15T01:04:19.595Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4cf5287f1ae277c1ffb7",
-      "lastUpdated": "2026-07-07T01:02:42.601Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5eb3e5d15d75eac0d8a",
+      "lastUpdated": "2026-07-15T00:49:44.110Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4d14287f1ae277c1ffc4",
-      "lastUpdated": "2026-07-07T00:56:13.586Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d6092274a992c427463d",
+      "lastUpdated": "2026-07-15T00:43:20.527Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4cf78cd69b3fa8c89821",
-      "lastUpdated": "2026-07-07T00:48:55.696Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5ec2274a992c4274634",
+      "lastUpdated": "2026-07-15T00:35:57.105Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4cf98cd69b3fa8c89823",
-      "lastUpdated": "2026-07-07T01:02:47.229Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5ee3e5d15d75eac0d8b",
+      "lastUpdated": "2026-07-15T00:49:48.454Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4cfb287f1ae277c1ffba",
-      "lastUpdated": "2026-07-07T01:02:49.037Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5f02274a992c4274636",
+      "lastUpdated": "2026-07-15T00:49:50.238Z"
     },
     "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/6a4c4bd323dcc2e575ab5c0a/6a4c4d2e287f1ae277c1ffc8",
-      "lastUpdated": "2026-07-07T00:56:37.711Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d61f2274a992c4274641",
+      "lastUpdated": "2026-07-15T00:43:45.295Z"
     },
     "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/6a4c4bd323dcc2e575ab5c0a/6a4c4d5d287f1ae277c1ffca",
-      "lastUpdated": "2026-07-07T00:57:25.538Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d64d2274a992c4274643",
+      "lastUpdated": "2026-07-15T00:44:32.621Z"
     },
     "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/6a4c4bd323dcc2e575ab5c0a/6a4c4d45287f1ae277c1ffc9",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a4c5611287f1ae277c20032?share=lPXDRHY7kw9LZU1GYzR1lA",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a4c5611287f1ae277c20032?share=lPXDRHY7kw9LZU1GYzR1lA&embed=true",
-      "lastUpdated": "2026-07-07T01:27:52.965Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d6352274a992c4274642",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a56df942274a992c42746d5?share=ONWSkyWjk3x2rtVjANyiA",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a56df942274a992c42746d5?share=ONWSkyWjk3x2rtVjANyiA&embed=true",
+      "lastUpdated": "2026-07-15T01:17:14.431Z"
     },
     "popup-loading.test.mjs": {
       "url": "https://console.testdriver.ai/runs/698bc89f7140c3fa7daaca8d/698bca7f7140c3fa7daacbf7",
@@ -138,12 +138,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4cdc8cd69b3fa8c89814",
-      "lastUpdated": "2026-07-07T00:48:28.615Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d5d32274a992c427462d",
+      "lastUpdated": "2026-07-15T00:35:31.546Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a4c4bd323dcc2e575ab5c0a/6a4c4d75287f1ae277c1ffcb",
-      "lastUpdated": "2026-07-07T00:57:49.215Z"
+      "url": "https://console-test.testdriver.ai/runs/6a56d4cad5a17ea4b9190265/6a56d6653e5d15d75eac0d95",
+      "lastUpdated": "2026-07-15T00:44:55.714Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/v7/client.mdx

@@ -126,6 +126,10 @@ const testdriver = new TestDriver(apiKey, options)
       Cache key for element finding operations. If provided, enables caching tied to this key.
     </ParamField>
     
+    <ParamField path="verify" type="boolean" default="false">
+      Global default for AI verification of located elements. When `true`, every `find()` runs a second AI check to confirm the returned coordinates actually match the requested element (catching hallucinated or incorrect positions), at the cost of extra latency. Can be overridden per call via `find(description, { verify: true | false })`.
+    </ParamField>
+    
     <ParamField path="dashcam" type="boolean" default="true">
       Enable or disable Dashcam video recording
     </ParamField>

package/docs/v7/examples/ai.mdx

@@ -17,7 +17,7 @@ Watch this test execute in a real sandbox environment:
 
 {/* ai.test.mjs output */}
 <iframe 
-  src="https://console-test.testdriver.ai/replay/6a4c5611287f1ae277c20032?share=lPXDRHY7kw9LZU1GYzR1lA&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a56df942274a992c42746d5?share=ONWSkyWjk3x2rtVjANyiA&embed=true" 
   width="100%" 
   height="600" 
   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/6a4c4cc58cd69b3fa8c8980f/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d5bb3e5d15d75eac0d7e/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/6a4c4beb8cd69b3fa8c897c4/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d4e13e5d15d75eac0d1c/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/6a4c4d2e287f1ae277c1ffc8/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d61f2274a992c4274641/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/6a4c4cdc8cd69b3fa8c89814/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d5d32274a992c427462d/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/6a4c4c3b287f1ae277c1ff92/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d52c823fc6a1246b8e58/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/6a4c4c1e287f1ae277c1ff81/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d5133e5d15d75eac0d2a/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/6a4c4d5d287f1ae277c1ffca/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d64d2274a992c4274643/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/6a4c4c69287f1ae277c1ffa6/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d55d3e5d15d75eac0d4e/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/6a4c4c068cd69b3fa8c897cd/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d4fb2274a992c42745e0/replay" 
   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/6a4c4d75287f1ae277c1ffcb/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d6653e5d15d75eac0d95/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/6a4c53cf8cd69b3fa8c8986e?share=ynZ6gn7JlP9dW2rY2Oc5bQ&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a56dc8e3e5d15d75eac0df0?share=ZM6rTCmGwCpC1YtUtOcbhw&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/6a4c4cf5287f1ae277c1ffb7/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d5eb3e5d15d75eac0d8a/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/6a4c4d14287f1ae277c1ffc4/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d6092274a992c427463d/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/6a4c4c948cd69b3fa8c89809/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a56d58c2274a992c4274611/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/docs/v7/find.mdx

@@ -55,7 +55,7 @@ const element = await testdriver.find(description, options)
     </ParamField>
     
     <ParamField path="verify" type="boolean" default={false}>
-      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency.
+      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency. Defaults to the global `verify` option set on the [SDK constructor](/v7/client) when not specified per call.
     </ParamField>
     
     <ParamField path="ai" type="object">

package/mcp-server/dist/core/actions.d.ts

@@ -18,7 +18,7 @@
  * mirroring how the stdio MCP server has always behaved.
  */
 import { SessionStartInputSchema, type SessionStartInput } from "../provision-types.js";
-import { type SessionState } from "../session.js";
+import { SessionManager, type SessionState } from "../session.js";
 export { SessionStartInputSchema, type SessionStartInput };
 export interface ActionImage {
     kind: "screenshot" | "cropped";
@@ -44,14 +44,75 @@ export declare class NoActiveSessionError extends Error {
     constructor(code: "NO_SESSION" | "SESSION_EXPIRED", message: string, expiredSessionId?: string);
 }
 /**
- * Optional adapter-supplied recovery hook. When the singleton SDK is missing or
- * stale at action time, {@link requireActiveSession} calls this to obtain the
- * params needed to rebuild the connection from the still-alive sandbox, then
- * reconnects before throwing NO_SESSION.
+ * The mutable state a single sandbox session needs: the live SDK handle, the
+ * element-ref map from `find`/`findall`, the "last screenshot" `check` diffs
+ * against, the adapter recovery hook, the in-flight reconnect promise, and the
+ * session-lifecycle manager.
+ *
+ * This used to be a bag of module-level singletons ("single sandbox per
+ * process"). That is correct for hosts that ARE one-session-per-process — eve
+ * (each durable turn is its own recycled process) and the stdio MCP server — but
+ * the Streamable-HTTP MCP server is one long-lived process serving *concurrent*
+ * clients, where shared singletons let one client's tool call read another
+ * client's sandbox. So the state moves into {@link CoreContext} and is resolved
+ * per async call via {@link als}.
+ */
+export interface CoreContext {
+    sdk: any;
+    lastScreenshotBase64: string | null;
+    reconnectResolver: ReconnectResolver | null;
+    /** In-flight reconnect, so concurrent actions in one context share one rebuild. */
+    reconnecting: Promise<void> | null;
+    /** Stored element instances from `find`/`findall`, addressable by ref. */
+    elementRefs: Map<string, {
+        element: any;
+        description: string;
+        coords: {
+            x: number;
+            y: number;
+            centerX: number;
+            centerY: number;
+        };
+    }>;
+    /** Session lifecycle for THIS context. */
+    sessions: SessionManager;
+    /**
+     * Opaque per-connection scratch space for adapters (e.g. the MCP server's
+     * image store). mcp-core doesn't read this; it just guarantees each isolated
+     * context gets its own object, so adapter-side per-connection state rides along
+     * with the same AsyncLocalStorage isolation instead of needing a second one.
+     */
+    adapter: Record<string, unknown>;
+}
+/** Build a fresh, empty context. Callers that want isolation mint one per connection. */
+export declare function createCoreContext(): CoreContext;
+/**
+ * Run `fn` with `context` as the active {@link CoreContext}, isolating every
+ * action's state (sdk, element refs, session, recovery hook) for the duration.
+ * The HTTP MCP server wraps each connection's request handling in this so
+ * concurrent clients never share a sandbox. Hosts that don't call this keep
+ * using {@link globalContext} exactly as before.
+ */
+export declare function runInContext<T>(context: CoreContext, fn: () => T): T;
+/** Build an isolated context whose SessionManager is its own (not the global). */
+export declare function createIsolatedContext(): CoreContext;
+/** The active context's adapter scratch space (see {@link CoreContext.adapter}). */
+export declare function getAdapterState(): Record<string, unknown>;
+/** The active context's current session (null when none). Adapters use this for
+ *  read-only lookups (e.g. the MCP server's testFile/expiry) that must resolve
+ *  the caller's own session, not a process-global one. */
+export declare function getCurrentSession(): SessionState | null;
+/** Time remaining (ms) on a session in the active context. */
+export declare function getSessionTimeRemaining(sessionId: string): number;
+/**
+ * Optional adapter-supplied recovery hook. When the SDK is missing or stale at
+ * action time, {@link requireActiveSession} calls this to obtain the params
+ * needed to rebuild the connection from the still-alive sandbox, then reconnects
+ * before throwing NO_SESSION.
  *
  * Why a hook instead of mcp-core owning the handle: the durable facts (sandbox
  * id, config) and the API key must survive a host process recycle, but this
- * module's globals do NOT — they reset on the very recycle we're recovering
+ * context's state does NOT — it resets on the very recycle we're recovering
  * from. So the *durable owner* (eve's per-session state) registers a resolver
  * that reads its own durable store and re-resolves the key per call. Hosts with
  * one long-lived process (stdio MCP server, CLI) register nothing: the resolver
@@ -60,7 +121,7 @@ export declare class NoActiveSessionError extends Error {
  *
  * The resolver returns `null` when it has nothing to recover from (no sandbox
  * provisioned this session), in which case we fall through to the normal throw.
- * It is re-registered each step by the adapter (module globals reset on recycle),
+ * It is re-registered each step by the adapter (context state resets on recycle),
  * so a stale closure can't outlive the process it was bound to.
  */
 export type ReconnectResolver = () => Promise<ReconnectParams | null>;