testdriverai 7.1.0 → 7.1.2

package/.env.example

@@ -0,0 +1,2 @@
+TD_API_KEY=
+TD_API_ROOT=

package/.github/workflows/linux-tests.yml

@@ -0,0 +1,28 @@
+name: Linux Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run Linux tests
+      run: npx vitest run test/testdriver/assert.test.mjs
+      env:
+        TD_API_KEY: ${{ secrets.TD_API_KEY }}

package/agent/index.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 // disable depreciation warnings
 process.removeAllListeners("warning");
 
@@ -226,13 +224,12 @@ class TestDriverAgent extends EventEmitter2 {
       this.emitter.emit(events.error.fatal, errorContext);
     } else {
       this.emitter.emit(
-        events.error.fatal,
-        theme.red("Fatal Error") + `\n${error}`,
+        events.error.fatal,error,
       );
     }
 
     if (skipPostrun) {
-      this.exit(true);
+      return await this.exit(true);
     } else {
       try {
         await this.summarize(error.message);
@@ -1711,28 +1708,12 @@ ${regression}
     this.emitter.emit(events.log.log, `${inputFile} (end)`);
   }
 
-  // Returns the path to the sandbox file (project-local first, then global)
-  getSandboxFilePath(preferProjectLocal = true) {
-    const projectLocalFile = path.join(process.cwd(), ".testdriver-sandbox.json");
-    const globalFile = path.join(os.homedir(), ".testdriverai-last-sandbox");
-    
-    if (preferProjectLocal) {
-      // For reading: check project-local first, then global
-      if (fs.existsSync(projectLocalFile)) {
-        return projectLocalFile;
-      }
-      if (fs.existsSync(globalFile)) {
-        return globalFile;
-      }
-      // For writing: default to project-local
-      return projectLocalFile;
-    }
-    return globalFile;
-  }
-
   // Returns sandboxId to use (either from file if recent, or null)
   getRecentSandboxId() {
-    const lastSandboxFile = this.getSandboxFilePath(true);
+    const lastSandboxFile = path.join(
+      os.homedir(),
+      ".testdriverai-last-sandbox",
+    );
 
     if (fs.existsSync(lastSandboxFile)) {
       try {
@@ -1778,8 +1759,10 @@ ${regression}
   }
 
   saveLastSandboxId(sandboxId, osType = "linux") {
-    // Save to project-local .testdriver-sandbox.json
-    const projectLocalFile = path.join(process.cwd(), ".testdriver-sandbox.json");
+    const lastSandboxFile = path.join(
+      os.homedir(),
+      ".testdriverai-last-sandbox",
+    );
     try {
       const sandboxInfo = {
         sandboxId: sandboxId,
@@ -1788,7 +1771,7 @@ ${regression}
         instanceType: this.sandboxInstance || null,
         timestamp: new Date().toISOString(),
       };
-      fs.writeFileSync(projectLocalFile, JSON.stringify(sandboxInfo, null, 2), {
+      fs.writeFileSync(lastSandboxFile, JSON.stringify(sandboxInfo), {
         encoding: "utf-8",
       });
     } catch {
@@ -1797,16 +1780,13 @@ ${regression}
   }
 
   clearRecentSandboxId() {
-    // Clear project-local file first, then global
-    const projectLocalFile = path.join(process.cwd(), ".testdriver-sandbox.json");
-    const globalFile = path.join(os.homedir(), ".testdriverai-last-sandbox");
-    
+    const lastSandboxFile = path.join(
+      os.homedir(),
+      ".testdriverai-last-sandbox",
+    );
     try {
-      if (fs.existsSync(projectLocalFile)) {
-        fs.unlinkSync(projectLocalFile);
-      }
-      if (fs.existsSync(globalFile)) {
-        fs.unlinkSync(globalFile);
+      if (fs.existsSync(lastSandboxFile)) {
+        fs.unlinkSync(lastSandboxFile);
       }
     } catch {
       // ignore errors
@@ -1862,9 +1842,6 @@ ${regression}
     await this.connectToSandboxService();
 
     const recentId = createNew ? null : this.getRecentSandboxId();
-    
-    // Track whether we reconnected to an existing sandbox or created a new one
-    this.isReconnected = false;
 
     // Set sandbox ID for reconnection (only if not creating new and recent ID exists)
     if (this.ip) {
@@ -1878,7 +1855,6 @@ ${regression}
       this.emitter.emit(events.sandbox.connected);
 
       this.instance = instance.instance;
-      this.isReconnected = false; // Direct IP is considered new
       await this.renderSandbox(this.instance, headless);
       await this.newSession();
       await this.runLifecycle("provision");
@@ -1899,7 +1875,6 @@ ${regression}
         );
 
         this.instance = instance;
-        this.isReconnected = true; // Successfully reconnected to existing sandbox
 
         await this.renderSandbox(instance, headless);
         await this.newSession();
@@ -1932,7 +1907,6 @@ ${regression}
         );
 
         this.instance = instance;
-        this.isReconnected = true; // Successfully reconnected to existing sandbox
 
         await this.renderSandbox(instance, headless);
         await this.newSession();
@@ -1949,7 +1923,6 @@ ${regression}
     
     // Create new sandbox (either because createNew is true, or no existing sandbox to connect to)
     if (!this.instance) {
-      this.isReconnected = false; // Creating new sandbox
       this.emitter.emit(
         events.log.narration,
         theme.dim(`creating new sandbox...`),
@@ -2186,7 +2159,7 @@ Please check your network connection, TD_API_KEY, or the service status.`,
       type: "create",
       resolution: this.config.TD_RESOLUTION,
       ci: this.config.CI,
-      os: this.sandboxOs || "windows",
+      os: this.sandboxOs || "linux",
     };
 
     // Add AMI and instance type if specified

package/agent/interface.js

@@ -69,7 +69,7 @@ function createCommandDefinitions(agent) {
         os: Flags.string({
           description: "Operating system for the sandbox (windows or linux)",
           options: ["windows", "linux"],
-          default: "windows",
+          default: "linux",
         }),
       },
       handler: async (args, flags) => {
@@ -246,7 +246,7 @@ function createCommandDefinitions(agent) {
         os: Flags.string({
           description: "Operating system for the sandbox (windows or linux)",
           options: ["windows", "linux"],
-          default: "windows",
+          default: "linux",
         }),
       },
       handler: async (args, flags) => {
@@ -254,6 +254,17 @@ function createCommandDefinitions(agent) {
         await agent.generate(flags.count || 3, args.prompt);
       },
     },
+
+    init: {
+      description: "Initialize a new TestDriver project with Vitest SDK examples",
+      args: {},
+      flags: {},
+      handler: async () => {
+        // This handler is special - it doesn't need an agent instance
+        // It just scaffolds files, so it will be handled by the CLI command
+        throw new Error("Init mode should be handled by CLI interface");
+      },
+    },
   };
 }
 

package/agent/lib/commands.js

@@ -81,7 +81,7 @@ const createCommands = (
   config,
   sessionInstance,
   getCurrentFilePath,
-  redrawThreshold = 0.1,
+  redrawThreshold = 0.01,
   getDashcamElapsedTime = null,
 ) => {
   // Create SDK instance with emitter, config, and session

package/agent/lib/redraw.js

@@ -8,7 +8,7 @@ const DEFAULT_REDRAW_OPTIONS = {
   enabled: true,           // Master switch to enable/disable redraw detection
   screenRedraw: true,      // Enable screen redraw detection
   networkMonitor: true,    // Enable network activity monitoring
-  diffThreshold: 0.1,      // Percentage threshold for screen diff (0.1 = 0.1%)
+  diffThreshold: 0.01,     // Percentage threshold for screen diff (0.01 = 0.01%)
 };
 
 // Factory function that creates redraw functionality with the provided system instance

package/agent/lib/sandbox.js

@@ -123,8 +123,8 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
         this.socket.on("open", async () => {
           this.apiSocketConnected = true;
 
-          setInterval(() => {
-            if (this.socket.readyState === WebSocket.OPEN) {
+          this.heartbeat = setInterval(() => {
+            if (this.socket && this.socket.readyState === WebSocket.OPEN) {
               this.socket.ping();
             }
           }, 5000);
@@ -175,6 +175,34 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
         });
       });
     }
+
+    /**
+     * Close the WebSocket connection and clean up resources
+     */
+    close() {
+      if (this.heartbeat) {
+        clearInterval(this.heartbeat);
+        this.heartbeat = null;
+      }
+      
+      if (this.socket) {
+        try {
+          this.socket.close();
+        } catch (err) {
+          // Ignore close errors
+        }
+        this.socket = null;
+      }
+      
+      this.apiSocketConnected = false;
+      this.instanceSocketConnected = false;
+      this.authenticated = false;
+      this.instance = null;
+      
+      // Silently clear pending promises without rejecting
+      // (rejecting causes unhandled promise rejections during cleanup)
+      this.ps = {};
+    }
   }
 
   return new Sandbox();

package/agent/lib/valid-version.js

@@ -1,9 +1,9 @@
 const semver = require("semver");
-const package = require("../../package.json");
+const packageJson = require("../../package.json");
 
 // Function to check if the new version's minor version is >= current version's minor version
 module.exports = (inputVersion) => {
-  const currentParsed = semver.parse(package.version);
+  const currentParsed = semver.parse(packageJson.version);
   const inputParsed = semver.parse(inputVersion.replace("v", ""));
 
   if (!currentParsed || !inputParsed) {

package/debugger/index.html

@@ -8,7 +8,7 @@
       rel="stylesheet"
     />
     <link rel="icon" type="image/png" href="icon.png" />
-    <title>TestDriver</title>
+    <title>TestDriver - Debugger</title>
     <style>
       body {
         background-color: #111;

package/docs/docs.json

@@ -17,121 +17,7 @@
         "tab": "Computer-Use SDK",
         "versions": [
           {
-            "version": "7.0.0 (SDK)",
-            "groups": [
-              {
-                "group": "Getting Started",
-                "pages": [
-                  "/v7/getting-started/quickstart",
-                  {
-                    "group": "Configuration",
-                    "icon": "gear",
-                    "pages": [
-                      "/v7/getting-started/configuration",
-                      {
-                        "group": "Platforms",
-                        "icon": "server",
-                        "pages": [
-                          "/v7/platforms/linux",
-                          "/v7/platforms/windows",
-                          "/v7/platforms/macos"
-                        ]
-                      }
-                    ]
-                  }
-                ]
-              },
-              {
-                "group": "Examples",
-                "icon": "code",
-                "pages": [
-                  "/v7/presets/chrome",
-                  "/v7/presets/chrome-extension",
-                  "/v7/presets/vscode",
-                  "/v7/presets/electron"
-                ]
-              },
-              {
-                "group": "Interactions",
-                "icon": "bolt",
-                "pages": [
-                  "/v7/api/find",
-                  "/v7/api/ai",
-                  "/v7/api/click",
-                  "/v7/api/doubleClick",
-                  "/v7/api/rightClick",
-                  "/v7/api/hover",
-                  "/v7/api/mouseDown",
-                  "/v7/api/mouseUp",
-                  "/v7/api/type",
-                  "/v7/api/pressKeys",
-                  "/v7/api/scroll",
-                  "/v7/api/focusApplication",
-                  "/v7/api/assert",
-                  "/v7/api/exec"
-                ]
-              },
-              {
-                "group": "Core Concepts",
-                "icon": "book",
-                "pages": [
-                  "/v7/api/client",
-                  "/v7/api/sandbox",
-                  "/v7/api/elements",
-                  "/v7/api/dashcam",
-                  "/v7/api/assertions"
-                ]
-              },
-              {
-                "group": "Progressive APIs",
-                "icon": "layer-group",
-                "pages": [
-                  "/v7/progressive-apis/PROGRESSIVE_DISCLOSURE",
-                  "/v7/progressive-apis/PROVISION",
-                  "/v7/progressive-apis/HOOKS"
-                ]
-              },
-            
-              {
-                "group": "Guides",
-                "icon": "book-open",
-                "pages": [
-                  "/v7/guides/vitest",
-                  "/v7/guides/vitest-plugin",
-                  "/v7/guides/debugging",
-                  "/v7/guides/best-practices",
-                  "/v7/guides/troubleshooting",
-                  "/v7/guides/faq",
-                  {
-                    "group": "Caching",
-                    "icon": "bolt",
-                    "pages": [
-                      "/v7/guides/caching-ai",
-                      "/v7/guides/caching-selectors"
-                    ]
-                  },
-                  {
-                    "group": "CI/CD Integration",
-                    "icon": "arrows-spin",
-                    "pages": [
-                      "/v7/guides/ci-cd/overview",
-                      "/v7/guides/ci-cd/github-actions",
-                      "/v7/guides/ci-cd/gitlab",
-                      "/v7/guides/ci-cd/circleci",
-                      "/v7/guides/ci-cd/jenkins",
-                      "/v7/guides/ci-cd/azure",
-                      "/v7/guides/ci-cd/travis"
-                    ]
-                  },
-                  "/v7/guides/performance",
-                  "/v7/guides/self-hosting",
-                  "/v7/guides/migration"
-                ]
-              }
-            ]
-          },
-          {
-            "version": "6.X.X (YAML)",
+            "version": "v6 (YAML)",
             "groups": [
               {
                 "group": "Overview",
@@ -303,18 +189,93 @@
                 ]
               }
             ]
+          },
+          {
+            "version": "v7 (JS Beta)",
+            "groups": [
+              {
+                "group": "Overview",
+                "icon": "circle-info",
+                "pages": [
+                  "/v7/overview/what-is-testdriver",
+                  {
+                    "group": "Features",
+                    "icon": "star",
+                    "pages": [
+                      "/v7/features/easy-to-write",
+                      "/v7/features/fast",
+                      "/v7/features/stable",
+                      "/v7/features/scalable",
+                      "/v7/features/ai-native",
+                      "/v7/features/powerful",
+                      "/v7/features/observable",
+                      "/v7/features/enterprise"
+                    ]
+                  }
+                ]
+              },
+              {
+                "group": "Getting Started",
+                "icon": "rocket",
+                "pages": [
+                  "/v7/getting-started/installation",
+                  "/v7/getting-started/writing-tests",
+                  "/v7/getting-started/generating-tests",
+                  "/v7/getting-started/running-and-debugging",
+                  "/v7/getting-started/setting-up-in-ci"
+                ]
+              },
+              {
+                "group": "Examples",
+                "icon": "code",
+                "pages": [
+                  "/v7/presets/chrome",
+                  "/v7/presets/chrome-extension",
+                  "/v7/presets/vscode",
+                  "/v7/presets/electron",
+                  "/v7/presets/webapp"
+                ]
+              },
+              {
+                "group": "API Reference",
+                "icon": "book",
+                "pages": [
+                  "/v7/api/client",
+                  "/v7/api/sandbox",
+                  {
+                    "group": "Interactions",
+                    "icon": "bolt",
+                    "pages": [
+                      "/v7/api/find",
+                      "/v7/api/elements",
+                      "/v7/api/click",
+                      "/v7/api/doubleClick",
+                      "/v7/api/rightClick",
+                      "/v7/api/hover",
+                      "/v7/api/mouseDown",
+                      "/v7/api/mouseUp",
+                      "/v7/api/type",
+                      "/v7/api/pressKeys",
+                      "/v7/api/scroll",
+                      "/v7/api/focusApplication"
+                    ]
+                  },
+                  {
+                    "group": "AI & Assertions",
+                    "icon": "wand-magic-sparkles",
+                    "pages": [
+                      "/v7/api/act",
+                      "/v7/api/assert",
+                      "/v7/api/assertions"
+                    ]
+                  },
+                  "/v7/api/exec",
+                  "/v7/api/dashcam"
+                ]
+              }
+            ]
           }
         ]
-      },
-      {
-        "tab": "Playwright SDK",
-        "pages": ["v7/playwright"]
-      },
-      {
-        "tab": "Playwright Studio"
-      },
-      {
-        "tab": "Dashcam CLI"
       }
     ]
   },
@@ -352,16 +313,64 @@
   },
   "redirects": [
     {
-      "source": "/guides/github-actions",
-      "destination": "/action/setup"
+      "source": "/overview/:slug*",
+      "destination": "/v6/overview/:slug*"
+    },
+    {
+      "source": "/features/:slug*",
+      "destination": "/v6/features/:slug*"
+    },
+    {
+      "source": "/account/:slug*",
+      "destination": "/v6/account/:slug*"
+    },
+    {
+      "source": "/cli/:slug*",
+      "destination": "/v6/cli/:slug*"
+    },
+    {
+      "source": "/interactive/:slug*",
+      "destination": "/v6/interactive/:slug*"
+    },
+    {
+      "source": "/getting-started/:slug*",
+      "destination": "/v6/getting-started/:slug*"
+    },
+    {
+      "source": "/apps/:slug*",
+      "destination": "/v6/apps/:slug*"
+    },
+    {
+      "source": "/scenarios/:slug*",
+      "destination": "/v6/scenarios/:slug*"
+    },
+    {
+      "source": "/integrations/:slug*",
+      "destination": "/v6/integrations/:slug*"
+    },
+    {
+      "source": "/guide/:slug*",
+      "destination": "/v6/guide/:slug*"
+    },
+    {
+      "source": "/action/:slug*",
+      "destination": "/v6/action/:slug*"
+    },
+    {
+      "source": "/importing/:slug*",
+      "destination": "/v6/importing/:slug*"
+    },
+    {
+      "source": "/exporting/:slug*",
+      "destination": "/v6/exporting/:slug*"
     },
     {
-      "source": "/reference/test-steps",
-      "destination": "/features/selectorless"
+      "source": "/bugs/:slug*",
+      "destination": "/v6/bugs/:slug*"
     },
     {
-      "source": "/guides/debugging-test-runs",
-      "destination": "/getting-started/editing"
+      "source": "/commands/:slug*",
+      "destination": "/v6/commands/:slug*"
     }
   ],
   "integrations": {

package/docs/v6/getting-started/self-hosting.mdx

@@ -46,7 +46,7 @@ The setup process involves three main steps:
   <Tip>
     Be sure to run `aws configure` with your credentials
   </Tip>
-- Access to the TestDriver AMI (Golden Image is `ami-055cd47506a2f39bb`)\
+- Access to the TestDriver AMI (Golden Image is `ami-086b5b4b86d78987c`)\
   [Contact us with your preferred AWS Region for access](https://form.typeform.com/to/UECf9rDx?typeform-source=testdriver.ai).
 - A GitHub repository for committing your tests & workflow.
 
@@ -244,7 +244,7 @@ Configure these secrets in your GitHub repository:
 | `AWS_REGION`             | AWS Region                          | `us-east-2`                                                  |
 | `AWS_SECRET_ACCESS_KEY`  | AWS secret key                      | `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`                   |
 | `AWS_LAUNCH_TEMPLATE_ID` | Launch template from CloudFormation | `lt-07c53ce8349b958d1`                                       |
-| `AMI_ID`                 | TestDriver AMI ID                   | `ami-085f872ca0cd80fed`                                      |
+| `AMI_ID`                 | TestDriver AMI ID                   | `ami-086b5b4b86d78987c`                                      |
 | `TD_API_KEY`             | TestDriver API key                  | Your API key from [the dashboard](https://app.testdriver.ai) |
 
 ## AMI Customization
@@ -291,6 +291,7 @@ Before doing anything else, change the default password:
 
 1. Open PowerShell on the instance
 2. Run the password rotation script:
+
    ```powershell
    C:\testdriver\RotateLocalPasswords.ps1
    ```