testdriverai 7.9.39-test → 7.9.41-test

package/agent/index.js

@@ -494,65 +494,89 @@ class TestDriverAgent extends EventEmitter2 {
       );
     }
 
-    try {
-      let response;
-
-      // "run" and "if" commands are special meta commands
-      // that change the flow of execution
-      if (command.command == "run") {
-        response = await this.embed(command.file, depth, pushToHistory);
-      } else if (command.command == "if") {
-        response = await this.iffy(
-          command.condition,
-          command.then,
-          command.else,
-          depth,
-        );
-      } else {
-        response = await this.commander.run(command, depth);
-      }
+    const sentry = require("../lib/sentry");
+    return sentry.withSpan(
+      {
+        name: `command.${commandName}`,
+        op: "command",
+        attributes: { "command.name": commandName, "command.depth": depth },
+      },
+      async (span) => {
+        try {
+          let response;
+
+          // "run" and "if" commands are special meta commands
+          // that change the flow of execution
+          if (command.command == "run") {
+            response = await this.embed(command.file, depth, pushToHistory);
+          } else if (command.command == "if") {
+            response = await this.iffy(
+              command.condition,
+              command.then,
+              command.else,
+              depth,
+            );
+          } else {
+            response = await this.commander.run(command, depth);
+          }
 
-      const endTime = Date.now();
-      const duration = endTime - startTime;
+          const endTime = Date.now();
+          const duration = endTime - startTime;
 
-      // Emit command success event with source mapping
-      this.emitter.emit(events.command.success, {
-        command: commandName,
-        depth,
-        data: command,
-        duration,
-        response,
-        timestamp: endTime,
-        sourcePosition: sourcePosition,
-      });
+          if (span) {
+            span.setStatus({ code: 1 }); // OK
+          }
 
-      // if the result of a command contains more commands, we perform the process again
-      if (response && typeof response === "string") {
-        return await this.actOnMarkdown(response, depth, false, false, false);
-      }
-    } catch (error) {
-      const endTime = Date.now();
-      const duration = endTime - startTime;
+          // Emit command success event with source mapping
+          this.emitter.emit(events.command.success, {
+            command: commandName,
+            depth,
+            data: command,
+            duration,
+            response,
+            timestamp: endTime,
+            sourcePosition: sourcePosition,
+          });
 
-      // Emit command error event with source mapping
-      this.emitter.emit(events.command.error, {
-        command: commandName,
-        depth,
-        data: command,
-        error: error.message,
-        duration,
-        timestamp: endTime,
-        sourcePosition: sourcePosition,
-      });
+          // if the result of a command contains more commands, we perform the process again
+          if (response && typeof response === "string") {
+            return await this.actOnMarkdown(
+              response,
+              depth,
+              false,
+              false,
+              false,
+            );
+          }
+        } catch (error) {
+          const endTime = Date.now();
+          const duration = endTime - startTime;
 
-      return await this.haveAIResolveError(
-        error,
-        yaml.dump({ commands: [yml] }),
-        depth,
-        true,
-        shouldSave,
-      );
-    }
+          if (span) {
+            span.setStatus({ code: 2, message: error.message });
+          }
+
+          // Emit command error event with source mapping
+          this.emitter.emit(events.command.error, {
+            command: commandName,
+            depth,
+            data: command,
+            error: error.message,
+            duration,
+            timestamp: endTime,
+            sourcePosition: sourcePosition,
+          });
+
+          return await this.haveAIResolveError(
+            error,
+            yaml.dump({ commands: [yml] }),
+            depth,
+            true,
+            shouldSave,
+          );
+        }
+      },
+    );
   }
 
   async executeCommands(

package/agent/lib/sandbox.js

@@ -1230,9 +1230,11 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         startTime: Date.now(),
       };
 
-      if (message.type === "output") {
-        p.catch(function () { });
-      }
+      // Prevent unhandled rejections from late Ably responses that arrive
+      // after the caller has moved on (e.g. test retry, cleanup). The await
+      // chain still receives the rejection; this just marks the promise as
+      // "handled" so Node does not emit unhandledRejection.
+      p.catch(function () { });
 
       this._throttledPublish(this._sessionChannel, "command", message)
         .then(function () {
@@ -1467,6 +1469,18 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       this.authenticated = false;
       this.instance = null;
       this._lastConnectParams = null;
+
+      // Reject all pending promises so active callers get a clear error
+      // instead of hanging forever. The safety .catch() in _sendAbly()
+      // ensures these rejections never surface as unhandled.
+      var pendingIds = Object.keys(this.ps);
+      var closedError = new Error('Sandbox connection closed');
+      for (var i = 0; i < pendingIds.length; i++) {
+        var entry = this.ps[pendingIds[i]];
+        if (entry && typeof entry.reject === 'function') {
+          try { entry.reject(closedError); } catch (_) { /* already settled */ }
+        }
+      }
       this.ps = {};
     }
 

package/agent/lib/sdk.js

@@ -1,5 +1,6 @@
 const { events } = require("../events");
 const { getSentryTraceHeaders } = require("./http");
+const sentry = require("../../lib/sentry");
 
 // get the version from package.json
 const { version } = require("../../package.json");
@@ -20,6 +21,7 @@ const DEFAULT_RETRY_CONFIG = {
     'ENOTFOUND',
     'ENETUNREACH',
     'ERR_NETWORK',
+    'ERR_BAD_RESPONSE',
     'ECONNABORTED',
     'EPIPE',
     'EAI_AGAIN',
@@ -35,14 +37,7 @@ const DEFAULT_RETRY_CONFIG = {
  * @returns {boolean} Whether the request should be retried
  */
 function isRetryableError(error, config = DEFAULT_RETRY_CONFIG) {
-  // Network-level errors (no response received)
-  if (!error.response) {
-    return config.retryableNetworkCodes.includes(error.code);
-  }
-  
-  // HTTP status code based retries
-  const status = error.response?.status;
-  return config.retryableStatusCodes.includes(status);
+  return true;
 }
 
 /**
@@ -102,6 +97,18 @@ async function withRetry(fn, options = {}) {
       
       const delayMs = calculateRetryDelay(attempt, error, config);
       
+      // Log retry errors to Sentry for visibility
+      sentry.captureException(error, {
+        tags: { phase: 'retry', attempt: attempt + 1 },
+        extra: {
+          maxRetries: config.maxRetries,
+          delayMs,
+          code: error.code,
+          status: error.response?.status,
+          url: error.config?.url?.replace(/X-Amz-\w+=[\w%]+/g, 'X-Amz-***=REDACTED'),
+        },
+      });
+
       // Call onRetry callback if provided
       if (options.onRetry) {
         options.onRetry(attempt + 1, error, delayMs);

package/agent/lib/system.js

@@ -46,7 +46,7 @@ const createSystem = (emitter, sandbox, config) => {
         timeout: 10000,
       }),
       {
-        retryConfig: { maxRetries: 5, baseDelayMs: 1000 },
+        retryConfig: { maxRetries: 3, baseDelayMs: 1000 },
       },
     );
 

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/69d6f2cec0ec56e77d2d2b3a/69d6f2e0c0ec56e77d2d2b48",
-      "lastUpdated": "2026-04-09T00:47:56.308Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84576d5b12767ca15e3d2",
+      "lastUpdated": "2026-04-10T00:51:33.963Z"
     },
     "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/69d6f2cec0ec56e77d2d2b3a/69d6f2d1c0ec56e77d2d2b3c",
-      "lastUpdated": "2026-04-09T00:30:09.363Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84560d5b12767ca15e3c6",
+      "lastUpdated": "2026-04-10T00:35:14.640Z"
     },
     "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/69d6f2cec0ec56e77d2d2b3a/69d6f2d3c0ec56e77d2d2b3d",
-      "lastUpdated": "2026-04-09T00:29:07.375Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84563d5b12767ca15e3c7",
+      "lastUpdated": "2026-04-10T00:33:38.923Z"
     },
     "windows-installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d6c0ec56e77d2d2b40",
-      "lastUpdated": "2026-04-09T00:30:14.179Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84568d5b12767ca15e3ca",
+      "lastUpdated": "2026-04-10T00:35:21.576Z"
     },
     "exec-output.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d7c0ec56e77d2d2b41",
-      "lastUpdated": "2026-04-09T00:30:15.528Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8456ad5b12767ca15e3cb",
+      "lastUpdated": "2026-04-10T00:35:23.589Z"
     },
     "chrome-extension.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d0c0ec56e77d2d2b3b",
-      "lastUpdated": "2026-04-09T00:29:36.485Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8455ed5b12767ca15e3c5",
+      "lastUpdated": "2026-04-10T00:34:24.409Z"
     },
     "launch-vscode-linux.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d5c0ec56e77d2d2b3e",
-      "lastUpdated": "2026-04-09T00:37:50.393Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84565d5b12767ca15e3c8",
+      "lastUpdated": "2026-04-10T00:41:22.597Z"
     },
     "hover-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2d9c0ec56e77d2d2b42",
-      "lastUpdated": "2026-04-09T00:29:45.158Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8456cd5b12767ca15e3cc",
+      "lastUpdated": "2026-04-10T00:34:37.536Z"
     },
     "installer.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2dbc0ec56e77d2d2b43",
-      "lastUpdated": "2026-04-09T00:29:14.938Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8456fd5b12767ca15e3cd",
+      "lastUpdated": "2026-04-10T00:33:50.808Z"
     },
     "type.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2dcc0ec56e77d2d2b46",
-      "lastUpdated": "2026-04-09T00:29:48.386Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84572d5b12767ca15e3d0",
+      "lastUpdated": "2026-04-10T00:34:42.548Z"
     },
     "press-keys.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2dec0ec56e77d2d2b47",
-      "lastUpdated": "2026-04-09T00:46:49.783Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84574d5b12767ca15e3d1",
+      "lastUpdated": "2026-04-10T00:50:25.456Z"
     },
     "scroll-keyboard.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e3c0ec56e77d2d2b4a",
-      "lastUpdated": "2026-04-09T00:30:27.053Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8457bd5b12767ca15e3d4",
+      "lastUpdated": "2026-04-10T00:35:39.270Z"
     },
     "scroll.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e8c0ec56e77d2d2b4e",
-      "lastUpdated": "2026-04-09T00:55:13.692Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84584d5b12767ca15e3d8",
+      "lastUpdated": "2026-04-10T00:56:48.320Z"
     },
     "scroll-until-image.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e4c0ec56e77d2d2b4b",
-      "lastUpdated": "2026-04-09T00:29:24.528Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8457dd5b12767ca15e3d5",
+      "lastUpdated": "2026-04-10T00:34:06.264Z"
     },
     "prompt.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e5c0ec56e77d2d2b4c",
-      "lastUpdated": "2026-04-09T00:30:29.837Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84580d5b12767ca15e3d6",
+      "lastUpdated": "2026-04-10T00:35:44.027Z"
     },
     "focus-window.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2e7c0ec56e77d2d2b4d",
-      "lastUpdated": "2026-04-09T00:29:27.218Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84582d5b12767ca15e3d7",
+      "lastUpdated": "2026-04-10T00:34:10.512Z"
     },
     "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/69d6f2cec0ec56e77d2d2b3a/69d6f2eac0ec56e77d2d2b4f",
-      "lastUpdated": "2026-04-09T00:30:34.117Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84587d5b12767ca15e3d9",
+      "lastUpdated": "2026-04-10T00:35:49.919Z"
     },
     "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/69d6f2cec0ec56e77d2d2b3a/69d6f2edc0ec56e77d2d2b51",
-      "lastUpdated": "2026-04-09T00:29:33.199Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8458bd5b12767ca15e3db",
+      "lastUpdated": "2026-04-10T00:34:19.364Z"
     },
     "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/69d6f2cec0ec56e77d2d2b3a/69d6f2ebc0ec56e77d2d2b50",
-      "lastUpdated": "2026-04-09T00:58:39.073Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84589d5b12767ca15e3da",
+      "lastUpdated": "2026-04-10T01:00:48.870Z"
     },
     "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/69d6f2cec0ec56e77d2d2b3a/69d6f2e1c0ec56e77d2d2b49",
-      "lastUpdated": "2026-04-09T00:29:52.990Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d84579d5b12767ca15e3d3",
+      "lastUpdated": "2026-04-10T00:34:49.549Z"
     },
     "parse.test.mjs": {
-      "url": "https://console-test.testdriver.ai/runs/69d6f2cec0ec56e77d2d2b3a/69d6f2eec0ec56e77d2d2b52",
-      "lastUpdated": "2026-04-09T00:30:38.622Z"
+      "url": "https://console-test.testdriver.ai/runs/69d8455cd5b12767ca15e3c4/69d8458ed5b12767ca15e3dc",
+      "lastUpdated": "2026-04-10T00:35:56.788Z"
     },
     "flake-diffthreshold-001.test.mjs": {
       "url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",

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/69d6f2ebc0ec56e77d2d2b50/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84589d5b12767ca15e3da/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/69d6f2e0c0ec56e77d2d2b48/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84576d5b12767ca15e3d2/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/69d6f2d0c0ec56e77d2d2b3b/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8455ed5b12767ca15e3c5/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/69d6f2eac0ec56e77d2d2b4f/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84587d5b12767ca15e3d9/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/69d6f2d7c0ec56e77d2d2b41/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8456ad5b12767ca15e3cb/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/69d6f2d1c0ec56e77d2d2b3c/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84560d5b12767ca15e3c6/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/69d6f2e1c0ec56e77d2d2b49/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84579d5b12767ca15e3d3/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/69d6f2e7c0ec56e77d2d2b4d/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84582d5b12767ca15e3d7/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/69d6f2d9c0ec56e77d2d2b42/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8456cd5b12767ca15e3cc/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/69d6f2d3c0ec56e77d2d2b3d/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84563d5b12767ca15e3c7/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/69d6f2edc0ec56e77d2d2b51/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8458bd5b12767ca15e3db/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/69d6f2dbc0ec56e77d2d2b43/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8456fd5b12767ca15e3cd/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/69d6f2d5c0ec56e77d2d2b3e/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84565d5b12767ca15e3c8/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/69d6f2eec0ec56e77d2d2b52/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8458ed5b12767ca15e3dc/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/69d6f2dec0ec56e77d2d2b47/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84574d5b12767ca15e3d1/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/69d6f2e5c0ec56e77d2d2b4c/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84580d5b12767ca15e3d6/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/69d6f2e3c0ec56e77d2d2b4a/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8457bd5b12767ca15e3d4/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/69d6f2e4c0ec56e77d2d2b4b/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d8457dd5b12767ca15e3d5/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/69d6f2e8c0ec56e77d2d2b4e/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84584d5b12767ca15e3d8/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/69d6f2dcc0ec56e77d2d2b46/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84572d5b12767ca15e3d0/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/69d6f2d6c0ec56e77d2d2b40/replay" 
+  src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/69d84568d5b12767ca15e3ca/replay" 
   width="100%" 
   height="390" 
   style={{ border: "1px solid #333", borderRadius: "8px" }}

package/lib/sentry.js

@@ -414,6 +414,18 @@ function startTransaction(name, op = "cli") {
   return Sentry.startSpan({ name, op });
 }
 
+/**
+ * Execute a callback within a Sentry performance span.
+ * If Sentry is not enabled, the callback is executed directly.
+ * @param {Object} options - Span options ({ name, op, attributes })
+ * @param {Function} callback - Async callback receiving the span
+ * @returns {Promise<*>} Result of the callback
+ */
+async function withSpan(options, callback) {
+  if (!isEnabled()) return callback(null);
+  return Sentry.startSpan(options, callback);
+}
+
 /**
  * Flush pending events before process exit
  * @param {number} timeout - Timeout in milliseconds
@@ -436,5 +448,6 @@ module.exports = {
   getTraceId,
   attachLogListeners,
   startTransaction,
+  withSpan,
   flush,
 };

package/package.json

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