testdriverai 7.4.4 → 7.5.0

package/.github/copilot-instructions.md

@@ -670,7 +670,7 @@ await testdriver.screenshot(1, false, true);
 3. **⚠️ SHARE THE TEST REPORT URL** - After EVERY test run, find `TESTDRIVER_RUN_URL=https://console.testdriver.ai/runs/...` in the output and share it with the user. This is CRITICAL - users need to view the recording to understand what happened.
 3. **Screenshots are automatic** - TestDriver captures screenshots before/after every command by default. Each screenshot filename includes the line number (e.g., `001-click-before-L42-submit-button.png`) making it easy to trace issues.
 4. **⚠️ USE SCREENSHOT VIEWING FOR DEBUGGING** - When tests fail, use `list_local_screenshots` and `view_local_screenshot` MCP commands to see exactly what the UI looked like. The filenames tell you which line of code triggered each screenshot.
-5. **⚠️ NEVER USE `.wait()`** - Do NOT use any `.wait()` method. Instead, use `find()` with a `timeout` option to poll for elements, or use `assert()` / `check()` to verify state. Explicit waits are flaky and slow.
+5. **Use `wait()` for simple delays** - Use `await testdriver.wait(ms)` when you need a pause (e.g., after actions, for animations). For waiting for specific elements, prefer `find()` with a `timeout` option.
 6. **Use MCP tools for development** - Build tests interactively with visual feedback
 7. **Always check `sdk.d.ts`** for method signatures and types when debugging generated tests
 8. **Look at test samples** in `node_modules/testdriverai/test` for working examples

package/.github/skills/testdriver:performing-actions/SKILL.md

@@ -29,6 +29,9 @@ await testdriver.find('dropdown menu').hover();
 await testdriver.scroll('down', 500);
 await testdriver.scrollUntilText('Footer content');
 
+// Waiting
+await testdriver.wait(2000); // Wait 2 seconds for animation/state change
+
 // Extracting information from screen
 const price = await testdriver.extract('the total price');
 const orderNumber = await testdriver.extract('the order confirmation number');

package/.github/skills/testdriver:waiting-for-elements/SKILL.md

@@ -70,3 +70,19 @@ const testdriver = TestDriver(context, {
   }
 });
 ```
+
+## Simple Delays with `wait()`
+
+For simple pauses — waiting for animations, transitions, or state changes after an action — use `wait()`:
+
+```javascript
+// Wait for an animation to complete
+await testdriver.find('menu toggle').click();
+await testdriver.wait(2000);
+
+// Wait for a page transition to settle
+await testdriver.find('next page button').click();
+await testdriver.wait(1000);
+```
+
+For waiting for specific **elements** to appear, prefer `find()` with a `timeout` option. Use `wait()` only for simple time-based pauses.

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [7.4.5](https://github.com/testdriverai/testdriverai/compare/v7.3.43...v7.4.5) (2026-02-27)
+
+
+
 ## [7.3.44](https://github.com/testdriverai/testdriverai/compare/v7.3.43...v7.3.44) (2026-02-26)
 
 

package/agent/events.js

@@ -101,11 +101,18 @@ const events = {
     sent: "sandbox:sent",
     received: "sandbox:received",
     progress: "sandbox:progress",
+    file: "sandbox:file",
   },
   redraw: {
     status: "redraw:status",
     complete: "redraw:complete",
   },
+  exec: {
+    output: "exec:output",
+  },
+  runner: {
+    log: "runner:log",
+  },
   exit: "exit",
 };
 

package/agent/index.js

@@ -1686,6 +1686,7 @@ ${regression}
         resolution: this.config.TD_RESOLUTION,
         ci: this.config.CI,
         ip: this.ip,
+        instanceId: this.instanceId || undefined,
       });
 
       // Store connection params for reconnection
@@ -1748,28 +1749,34 @@ ${regression}
           " " +
           theme.cyan(`new sandbox...`),
       );
-      // We don't have resiliency/retries baked in, so let's at least give it 1 attempt
-      // to see if that fixes the issue.
-      let newSandbox = await this.createNewSandbox().catch(() => {
-        this.emitter.emit(
-          events.log.narration,
-          theme.dim(`double-checking sandbox availability`),
-        );
-        return this.createNewSandbox();
-      });
+      let newSandbox = await this.createNewSandbox();
 
       // Extract the sandbox ID from the newly created sandbox
       this.sandboxId =
         newSandbox?.sandbox?.sandboxId || newSandbox?.sandbox?.instanceId;
 
-      let instance = await this.connectToSandboxDirect(
-        this.sandboxId,
-        true, // always persist by default
-        this.keepAlive, // pass keepAlive TTL
-      );
-      this.instance = instance;
-      await this.renderSandbox(instance, headless);
-      await this.runLifecycle("provision");
+      // E2B sandboxes return a url directly from create — no separate
+      // connect step needed (the API proxies commands via Ably).
+      if (newSandbox?.sandbox?.url) {
+        this.sandbox.setConnectionParams({
+          sandboxId: this.sandboxId,
+          persist: true,
+          keepAlive: this.keepAlive,
+        });
+        this.emitter.emit(events.sandbox.connected);
+        this.instance = newSandbox.sandbox;
+        await this.renderSandbox(this.instance, headless);
+        await this.runLifecycle("provision");
+      } else {
+        let instance = await this.connectToSandboxDirect(
+          this.sandboxId,
+          true, // always persist by default
+          this.keepAlive, // pass keepAlive TTL
+        );
+        this.instance = instance;
+        await this.renderSandbox(instance, headless);
+        await this.runLifecycle("provision");
+      }
     }
   }