testdriverai 7.2.52 → 7.2.54

package/agent/lib/system.js

@@ -13,12 +13,18 @@ const createSystem = (emitter, sandbox, config) => {
     });
 
     if (!base64) {
-      console.error("Failed to take screenshot");
-    } else {
-      let image = Buffer.from(base64, "base64");
-      fs.writeFileSync(options.filename, image);
-      return { filename: options.filename };
+      throw new Error("Failed to take screenshot: sandbox returned empty data");
     }
+    
+    let image = Buffer.from(base64, "base64");
+    
+    // Verify we got actual image data (PNG header starts with these bytes)
+    if (image.length < 100) {
+      throw new Error(`Failed to take screenshot: received only ${image.length} bytes`);
+    }
+    
+    fs.writeFileSync(options.filename, image);
+    return { filename: options.filename };
   };
 
   let primaryDisplay = null;
@@ -57,6 +63,11 @@ const createSystem = (emitter, sandbox, config) => {
 
       // Load the screenshot image with Jimp
       let image = await Jimp.read(step1);
+      
+      // Validate the image was loaded correctly (not a 1x1 or tiny placeholder)
+      if (image.getWidth() < 10 || image.getHeight() < 10) {
+        throw new Error(`Screenshot appears corrupted: got ${image.getWidth()}x${image.getHeight()} pixels`);
+      }
 
       // Resize the image
       image.resize(

package/agents.md

@@ -151,7 +151,7 @@ element.found();              // check if found (boolean)
 **Use `screenshot()` liberally during development** to see exactly what the sandbox screen looks like. Screenshots are saved locally and organized by test file.
 
 ```javascript
-// Capture a screenshot - saved to .testdriverai/screenshots/<test-file>/
+// Capture a screenshot - saved to .testdriver/screenshots/<test-file>/
 const screenshotPath = await testdriver.screenshot();
 console.log('Screenshot saved to:', screenshotPath);
 
@@ -168,7 +168,7 @@ await testdriver.screenshot(1, false, true);
 
 **Screenshot file organization:**
 ```
-.testdriverai/
+.testdriver/
   screenshots/
     login.test/           # Folder per test file
       screenshot-1737633600000.png
@@ -443,7 +443,7 @@ console.log('Screenshot with mouse saved to: screenshot-with-mouse.png');
 4. **Log element properties** to understand what the AI sees
 5. **Use `assert()` with specific, descriptive natural language**
 6. **Start simple** - get one step working before adding more
-7. **Take screenshots liberally** - use `await testdriver.screenshot()` after key steps to debug what the sandbox actually shows. Check `.testdriverai/screenshots/<test-file>/` to review them.
+7. **Take screenshots liberally** - use `await testdriver.screenshot()` after key steps to debug what the sandbox actually shows. Check `.testdriver/screenshots/<test-file>/` to review them.
 8. **Always `await` async methods** - TestDriver will warn if you forget, but for TypeScript projects, add `@typescript-eslint/no-floating-promises` to your ESLint config to catch missing `await` at compile time:
    ```json
    // eslint.config.js (for TypeScript projects)

package/docs/v7/screenshot.mdx

@@ -35,10 +35,10 @@ const filePath = await testdriver.screenshot(scale, silent, mouse)
 
 ## File Organization
 
-Screenshots are automatically saved to `.testdriverai/screenshots/<test-file-name>/` in your project root:
+Screenshots are automatically saved to `.testdriver/screenshots/<test-file-name>/` in your project root:
 
 ```
-.testdriverai/
+.testdriver/
   screenshots/
     login.test/
       screenshot-1737633600000.png
@@ -136,11 +136,11 @@ describe("Login Flow", () => {
   </Accordion>
 
   <Accordion title="Add to .gitignore">
-    Add `.testdriverai/screenshots/` to your `.gitignore` to avoid committing screenshots to version control:
+    Add `.testdriver/screenshots/` to your `.gitignore` to avoid committing screenshots to version control:
     
     ```
     # .gitignore
-    .testdriverai/screenshots/
+    .testdriver/screenshots/
     ```
   </Accordion>
 </AccordionGroup>

package/package.json

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

package/sdk.d.ts

@@ -1136,14 +1136,14 @@ export default class TestDriverSDK {
   // Utility Methods
 
   /**
-   * Capture a screenshot of the current screen and save it to .testdriverai/screenshots
+   * Capture a screenshot of the current screen and save it to .testdriver/screenshots
    * @param scale - Scale factor for the screenshot (default: 1 = original size)
    * @param silent - Whether to suppress logging (default: false)
    * @param mouse - Whether to include mouse cursor (default: false)
    * @returns The file path where the screenshot was saved
    *
    * @example
-   * // Capture a screenshot (saves to .testdriverai/screenshots)
+   * // Capture a screenshot (saves to .testdriver/screenshots)
    * const screenshotPath = await client.screenshot();
    * console.log('Screenshot saved to:', screenshotPath);
    *

package/sdk.js

@@ -2118,7 +2118,7 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
     // Clean up screenshots folder for this test file before running
     if (this.testFile) {
       const testFileName = path.basename(this.testFile, path.extname(this.testFile));
-      const screenshotsDir = path.join(process.cwd(), ".testdriverai", "screenshots", testFileName);
+      const screenshotsDir = path.join(process.cwd(), ".testdriver", "screenshots", testFileName);
       if (fs.existsSync(screenshotsDir)) {
         fs.rmSync(screenshotsDir, { recursive: true, force: true });
       }
@@ -2791,8 +2791,8 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
     this._ensureConnected();
     const base64Data = await this.system.captureScreenBase64(scale, silent, mouse);
     
-    // Save to .testdriverai/screenshots/<test-file-name> directory
-    let screenshotsDir = path.join(process.cwd(), ".testdriverai", "screenshots");
+    // Save to .testdriver/screenshots/<test-file-name> directory
+    let screenshotsDir = path.join(process.cwd(), ".testdriver", "screenshots");
     if (this.testFile) {
       const testFileName = path.basename(this.testFile, path.extname(this.testFile));
       screenshotsDir = path.join(screenshotsDir, testFileName);