testdriverai 7.11.70-test → 7.11.72-test

package/agent/lib/http.js

@@ -33,7 +33,7 @@ function getSentryTraceHeaders(sessionId) {
     if (typeof Sentry.getTraceData === "function") {
       const traceData = Sentry.getTraceData();
       if (traceData && traceData["sentry-trace"]) {
-        return traceData;
+        return { ...traceData };
       }
     }
   } catch (e) {

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/6a84f5551504d895610bbca1/6a84f56846eeed49c011dd38",
-      "lastUpdated": "2026-08-19T00:14:32.187Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798a278a75a86fc4b64f4",
+      "lastUpdated": "2026-08-21T00:15:30.566Z"
     },
     "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/6a84f5551504d895610bbca1/6a84f5581504d895610bbca4",
-      "lastUpdated": "2026-08-19T00:14:51.304Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a87989378a75a86fc4b64f1",
+      "lastUpdated": "2026-08-21T00:15:48.924Z"
     },
     "match-image.test.mjs": {
       "url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
@@ -22,78 +22,78 @@
       "lastUpdated": "2026-03-03T00:32:25.282Z"
     },
     "hover-text-with-description.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f55c46eeed49c011dd35",
-      "lastUpdated": "2026-08-19T00:14:54.264Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a879896b7cddebeab9bfbee",
+      "lastUpdated": "2026-08-21T00:15:51.746Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f55d1504d895610bbca5",
-      "lastUpdated": "2026-08-19T00:20:18.039Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a879898b7cddebeab9bfbef",
+      "lastUpdated": "2026-08-21T00:20:29.119Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f55e5834570b701a4866",
-      "lastUpdated": "2026-08-19T00:15:30.355Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798993062df0fb9b85595",
+      "lastUpdated": "2026-08-21T00:16:27.019Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f5561504d895610bbca3",
-      "lastUpdated": "2026-08-19T00:14:49.438Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798913062df0fb9b85592",
+      "lastUpdated": "2026-08-21T00:15:47.131Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f55a5834570b701a4864",
-      "lastUpdated": "2026-08-19T00:15:25.390Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a87989441d49e9ea55bd199",
+      "lastUpdated": "2026-08-21T00:16:21.995Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f5605834570b701a4867",
-      "lastUpdated": "2026-08-19T00:14:24.482Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a87989bb7cddebeab9bfbf0",
+      "lastUpdated": "2026-08-21T00:15:23.027Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f56246eeed49c011dd36",
-      "lastUpdated": "2026-08-19T00:14:26.478Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a87989d78a75a86fc4b64f3",
+      "lastUpdated": "2026-08-21T00:15:24.990Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f5641504d895610bbca8",
-      "lastUpdated": "2026-08-19T00:15:35.394Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a87989fb7cddebeab9bfbf2",
+      "lastUpdated": "2026-08-21T00:16:31.968Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f5661504d895610bbca9",
-      "replayUrl": "https://console-test.testdriver.ai/replay/6a84f82c1504d895610bbd4f?share=gvyKbIHOKiMqcVLAXfPhpg",
-      "embedUrl": "https://console-test.testdriver.ai/replay/6a84f82c1504d895610bbd4f?share=gvyKbIHOKiMqcVLAXfPhpg&embed=true",
-      "lastUpdated": "2026-08-19T00:26:25.444Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798a13062df0fb9b85597",
+      "replayUrl": "https://console-test.testdriver.ai/replay/6a879adf3062df0fb9b855fc?share=FFAdwAvK0aNJAa3xPOtWA",
+      "embedUrl": "https://console-test.testdriver.ai/replay/6a879adf3062df0fb9b855fc?share=FFAdwAvK0aNJAa3xPOtWA&embed=true",
+      "lastUpdated": "2026-08-21T00:25:08.572Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f56c5834570b701a4869",
-      "lastUpdated": "2026-08-19T00:15:42.176Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798a6b7cddebeab9bfbf4",
+      "lastUpdated": "2026-08-21T00:16:38.650Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f5721504d895610bbcac",
-      "lastUpdated": "2026-08-19T00:15:15.384Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798ac3062df0fb9b8559c",
+      "lastUpdated": "2026-08-21T00:16:12.199Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f56d1504d895610bbcaa",
-      "lastUpdated": "2026-08-19T00:14:37.902Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798a73062df0fb9b8559a",
+      "lastUpdated": "2026-08-21T00:15:35.988Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f56f46eeed49c011dd3a",
-      "lastUpdated": "2026-08-19T00:15:45.483Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798a93062df0fb9b8559b",
+      "lastUpdated": "2026-08-21T00:16:41.842Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f5701504d895610bbcab",
-      "lastUpdated": "2026-08-19T00:15:46.880Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798aa78a75a86fc4b64f6",
+      "lastUpdated": "2026-08-21T00:16:43.205Z"
     },
     "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/6a84f5551504d895610bbca1/6a84f5745834570b701a486a",
-      "lastUpdated": "2026-08-19T00:15:17.069Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798ae3062df0fb9b8559d",
+      "lastUpdated": "2026-08-21T00:16:13.841Z"
     },
     "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/6a84f5551504d895610bbca1/6a84f5765834570b701a486b",
-      "lastUpdated": "2026-08-19T00:15:18.750Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798afb7cddebeab9bfbf5",
+      "lastUpdated": "2026-08-21T00:16:15.554Z"
     },
     "no-provision.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7706a177a05bccd1cf",
@@ -138,12 +138,12 @@
       "lastUpdated": "2026-02-13T19:55:05.953Z"
     },
     "findall-coffee-icons.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f56a46eeed49c011dd39",
-      "lastUpdated": "2026-08-19T00:14:33.969Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798a43062df0fb9b85599",
+      "lastUpdated": "2026-08-21T00:15:32.294Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/6a84f5551504d895610bbca1/6a84f57746eeed49c011dd3b",
-      "lastUpdated": "2026-08-19T00:15:20.419Z"
+      "url": "https://console-test.testdriver.ai/runs/6a87988fb7cddebeab9bfbea/6a8798b178a75a86fc4b64f7",
+      "lastUpdated": "2026-08-21T00:16:17.187Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

package/docs/docs.json

@@ -41,6 +41,7 @@
                 ]
               },
               "/v7/what-is-testdriver",
+              "/v7/agent",
               {
                 "group": "Deployment",
                 "icon": "server",

package/docs/v7/agent.mdx

@@ -0,0 +1,100 @@
+---
+title: "The TestDriver Agent"
+sidebarTitle: "Agent"
+description: "How the TestDriver agent behaves on GitHub issues, pull requests, and @mentions"
+icon: "robot"
+---
+
+The TestDriver agent is an AI teammate that lives in your GitHub repository. It's
+**code review that runs your app** — instead of only reading a diff and guessing
+what might break, it starts a real sandbox, drives the real app, and reports what
+actually happens.
+
+## Scope: it only builds and maintains tests
+
+The agent is focused. The one thing it does is **write, debug, fix, and maintain
+automated tests** with TestDriver, and review pull requests by writing and running
+a test against the change. It will politely decline off-scope work — it won't edit
+your application code, fix product bugs, answer unrelated programming questions, or
+act as a general coding assistant.
+
+## How it behaves depends on the surface
+
+The agent reacts to three different GitHub surfaces, and its behavior is
+noticeably different on each.
+
+| Surface | Trigger | What it does |
+|---------|---------|--------------|
+| **Pull request opened** | Automatic (no mention) | Silent, evidence-based **code review** |
+| **Issue opened** | Automatic (no mention) | **Onboarding / test-building** |
+| **@mention** (issue or PR) | You mention the bot | Interactive, chatty conversation |
+
+## Pull requests — automatic code review
+
+When a pull request is **opened**, the agent reviews it automatically — nobody has
+to ask.
+
+- **The review is the deliverable, not chatter.** An automatic review is
+  unsolicited, so the agent stays quiet while it works and posts a **single review
+  comment** at the end rather than scattering inline threads across the diff or
+  narrating each step.
+- **It runs the change when it can.** Its default first move is to start a session,
+  work out what the PR changes from a user's point of view, and write and run a
+  TestDriver test that exercises exactly that. A bug it *watched happen* is far
+  more valuable than one it inferred.
+- **Findings are labeled by how they were found.** Each finding is marked
+  `observed` (proven by actually running the change) or `suspected` (reasoned out
+  from reading the diff). If the installation isn't signed in to TestDriver, the
+  agent can't run anything, so it reviews by reading and marks every finding
+  `suspected`.
+- **It focuses on real bugs.** Logic errors, regressions, broken edge cases,
+  mishandled errors — not style, naming, or "consider extracting this."
+- **Zero findings is a good review.** If the change looks correct, it says so in a
+  sentence. If there's nothing worth reviewing (only lockfiles, generated files, or
+  formatting), it posts nothing at all.
+- **It comments, it never blocks.** The review is always a `COMMENT` — it never
+  approves and never requests changes, so it can't gate a merge.
+
+It also fires a native GitHub **Check Run** for the PR's TestDriver suite, and
+re-runs that check on every push (not a full re-review — push more commits and
+@mention the agent if you want it to review again).
+
+<Note>
+  The agent never reviews its own pull requests. PRs opened by the bot are skipped,
+  so it won't wake itself up to review the tests it just committed.
+</Note>
+
+## Issues — onboarding and test building
+
+When an issue is **opened**, the agent treats it as a cue to help you build a test.
+
+- **If the issue describes a task**, it acts on the request — writing or debugging
+  the test you asked for.
+- **If the issue is empty**, it introduces itself, explains that it writes and
+  debugs computer-use tests, and walks you through signing in to TestDriver and
+  creating your first test.
+- **It finishes by opening a pull request** with the test it wrote.
+
+## @mentions — interactive conversation
+
+Mentioning the bot (on either an issue or a PR) starts a **solicited**, interactive
+turn. Because you asked directly, the agent is chatty: it posts progress updates,
+shows you screenshots of what's happening in the sandbox, and answers follow-ups in
+the thread.
+
+On a PR, an @mention overrides the silent auto-review behavior — you'll see the full
+play-by-play instead of just the final review comment.
+
+You can also manage the agent from a comment:
+
+- **`@bot logout`** (or "sign out") revokes the installation's shared TestDriver
+  sign-in and tears down the live sandbox, so the next mention will prompt whoever
+  responds to sign in again.
+
+## Signing in
+
+Reading a diff needs nothing, but **running** the app needs a TestDriver session,
+which requires the installation to be signed in. Sign-in state doesn't decide
+*whether* the agent reviews — it decides *how good* the review gets. A signed-out
+install still gets its bugs caught from reading the code; signing in upgrades
+findings from `suspected` to `observed`.

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/6a84f56846eeed49c011dd38/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798a278a75a86fc4b64f4/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/6a84f5561504d895610bbca3/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798913062df0fb9b85592/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/6a84f5745834570b701a486a/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798ae3062df0fb9b8559d/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/6a84f56a46eeed49c011dd39/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798a43062df0fb9b85599/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/6a84f5605834570b701a4867/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a87989bb7cddebeab9bfbf0/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/6a84f55c46eeed49c011dd35/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a879896b7cddebeab9bfbee/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/6a84f5765834570b701a486b/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798afb7cddebeab9bfbf5/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/6a84f56246eeed49c011dd36/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a87989d78a75a86fc4b64f3/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/6a84f55a5834570b701a4864/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a87989441d49e9ea55bd199/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/6a84f57746eeed49c011dd3b/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798b178a75a86fc4b64f7/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/6a84f82c1504d895610bbd4f?share=gvyKbIHOKiMqcVLAXfPhpg&embed=true" 
+  src="https://console-test.testdriver.ai/replay/6a879adf3062df0fb9b855fc?share=FFAdwAvK0aNJAa3xPOtWA&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/6a84f56c5834570b701a4869/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798a6b7cddebeab9bfbf4/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/6a84f5721504d895610bbcac/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a8798ac3062df0fb9b8559c/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/6a84f5641504d895610bbca8/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a87989fb7cddebeab9bfbf2/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/package.json

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