testdriverai 7.2.62 → 7.2.64

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [7.2.64](https://github.com/testdriverai/testdriverai/compare/v7.2.63...v7.2.64) (2026-02-02)
+
+
+
+## [7.2.63](https://github.com/testdriverai/testdriverai/compare/v7.2.62...v7.2.63) (2026-01-30)
+
+
+
 ## [7.2.62](https://github.com/testdriverai/testdriverai/compare/v7.2.61...v7.2.62) (2026-01-30)
 
 

package/agent/index.js

@@ -110,8 +110,8 @@ class TestDriverAgent extends EventEmitter2 {
     this.sandbox = createSandbox(this.emitter, this.analytics, this.session);
 
     // Attach Sentry log listeners to capture CLI logs as breadcrumbs
-      const sentry = require("../lib/sentry");
-      sentry.attachLogListeners(this.emitter);
+    const sentry = require("../lib/sentry");
+    sentry.attachLogListeners(this.emitter);
 
     // Set the OS for the sandbox to use
     this.sandbox.os = this.sandboxOs;
@@ -191,7 +191,14 @@ class TestDriverAgent extends EventEmitter2 {
   // allows us to save the current state, run lifecycle hooks, and track analytics
   async exit(failed = true, shouldSave = false, shouldRunPostrun = false) {
     const { formatter } = require("../sdk-log-formatter.js");
-    this.emitter.emit(events.log.narration, formatter.getPrefix("disconnect") + " " + theme.yellow.bold("Exiting") + theme.dim("..."), true);
+    this.emitter.emit(
+      events.log.narration,
+      formatter.getPrefix("disconnect") +
+        " " +
+        theme.yellow.bold("Exiting") +
+        theme.dim("..."),
+      true,
+    );
 
     // Clean up redraw interval
     if (this.redraw && this.redraw.cleanup) {
@@ -240,9 +247,7 @@ class TestDriverAgent extends EventEmitter2 {
     if (errorContext) {
       this.emitter.emit(events.error.fatal, errorContext);
     } else {
-      this.emitter.emit(
-        events.error.fatal,error,
-      );
+      this.emitter.emit(events.error.fatal, error);
     }
 
     if (skipPostrun) {
@@ -436,17 +441,15 @@ class TestDriverAgent extends EventEmitter2 {
     let mousePosition = await this.system.getMousePosition();
     let activeWindow = await this.system.activeWin();
 
-    let response = await this.sdk.req(
-      "check",
-      {
-        tasks: this.tasks,
-        images,
-        mousePosition,
-        activeWindow,
-      }
-    );
+    let response = await this.sdk.req("check", {
+      tasks: this.tasks,
+      images,
+      mousePosition,
+      activeWindow,
+    });
 
-    this.emitter.emit(events.log.markdown.static, response.data);
+    // Use log.log (not markdown.static) so output goes through console spy to sandbox
+    this.emitter.emit(events.log.log, response.data);
 
     this.lastScreenshot = thisScreenshot;
 
@@ -877,7 +880,7 @@ commands:
     currentTask,
     dry = false,
     validateAndLoop = false,
-    shouldSave = true
+    shouldSave = true,
   ) {
     // Check if execution has been stopped
     if (this.stopped) {
@@ -900,15 +903,12 @@ commands:
 
     this.lastScreenshot = await this.system.captureScreenBase64();
 
-    let message = await this.sdk.req(
-      "input",
-      {
-        input: currentTask,
-        mousePosition: await this.system.getMousePosition(),
-        activeWindow: await this.system.activeWin(),
-        image: this.lastScreenshot,
-      }
-    );
+    let message = await this.sdk.req("input", {
+      input: currentTask,
+      mousePosition: await this.system.getMousePosition(),
+      activeWindow: await this.system.activeWin(),
+      image: this.lastScreenshot,
+    });
 
     this.emitter.emit(events.log.log, message.data);
 
@@ -1625,8 +1625,8 @@ ${regression}
 
   // Returns the path to the last sandbox file
   getLastSandboxFilePath() {
-    const testdriverDir = path.join(process.cwd(), '.testdriver');
-    return path.join(testdriverDir, 'last-sandbox');
+    const testdriverDir = path.join(process.cwd(), ".testdriver");
+    return path.join(testdriverDir, "last-sandbox");
   }
 
   // Returns full sandbox info from last-sandbox file (no timeout - let API validate)
@@ -1647,7 +1647,7 @@ ${regression}
 
         return {
           sandboxId: sandboxInfo.sandboxId || sandboxInfo.instanceId || null,
-          os: sandboxInfo.os || 'linux',
+          os: sandboxInfo.os || "linux",
           ami: sandboxInfo.ami || null,
           instanceType: sandboxInfo.instanceType || null,
           timestamp: sandboxInfo.timestamp || null,
@@ -1662,7 +1662,7 @@ ${regression}
   // Returns sandboxId to use if AMI/instance type match current requirements
   getRecentSandboxId() {
     const sandboxInfo = this.getLastSandboxId();
-    
+
     if (!sandboxInfo || !sandboxInfo.sandboxId) {
       return null;
     }
@@ -1689,13 +1689,13 @@ ${regression}
   saveLastSandboxId(sandboxId, osType = "linux") {
     const lastSandboxFile = this.getLastSandboxFilePath();
     const testdriverDir = path.dirname(lastSandboxFile);
-    
+
     try {
       // Ensure .testdriver directory exists
       if (!fs.existsSync(testdriverDir)) {
         fs.mkdirSync(testdriverDir, { recursive: true });
       }
-      
+
       const sandboxInfo = {
         sandboxId: sandboxId,
         os: osType,
@@ -1756,15 +1756,9 @@ ${regression}
       // Also clear this.sandboxId to prevent reconnection attempts
       this.sandboxId = null;
       if (!this.config.CI && !this.newSandbox) {
-        this.emitter.emit(
-          events.log.log,
-          theme.dim("--`new` flag detected, will create a new sandbox"),
-        );
+        this.emitter.emit(events.log.log, theme.dim("Creating a new sandbox"));
       } else if (this.newSandbox) {
-        this.emitter.emit(
-          events.log.log,
-          theme.dim("--new-sandbox flag detected, will create a new sandbox"),
-        );
+        this.emitter.emit(events.log.log, theme.dim("Creating a new sandbox"));
       }
     }
 
@@ -1801,7 +1795,7 @@ ${regression}
         theme.dim(`using recent sandbox: ${recentId}`),
       );
       this.sandboxId = recentId;
-      
+
       try {
         let instance = await this.connectToSandboxDirect(
           this.sandboxId,
@@ -1849,13 +1843,17 @@ ${regression}
         console.error("Failed to reconnect to sandbox:", error);
       }
     }
-    
+
     // Create new sandbox (either because createNew is true, or no existing sandbox to connect to)
     if (!this.instance) {
       const { formatter } = require("../sdk-log-formatter.js");
       this.emitter.emit(
         events.log.narration,
-        formatter.getPrefix("connect") + " " + theme.green.bold("Creating") + " " + theme.cyan(`new sandbox...`),
+        formatter.getPrefix("connect") +
+          " " +
+          theme.green.bold("Creating") +
+          " " +
+          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.
@@ -1868,11 +1866,12 @@ ${regression}
       });
 
       // Extract the sandbox ID from the newly created sandbox
-      this.sandboxId = newSandbox?.sandbox?.sandboxId || newSandbox?.sandbox?.instanceId;
-      
+      this.sandboxId =
+        newSandbox?.sandbox?.sandboxId || newSandbox?.sandbox?.instanceId;
+
       // Use the configured sandbox OS type
       this.saveLastSandboxId(this.sandboxId, this.sandboxOs);
-      
+
       let instance = await this.connectToSandboxDirect(
         this.sandboxId,
         true, // always persist by default
@@ -2001,7 +2000,6 @@ ${regression}
   }
 
   async renderSandbox(instance, headless = false) {
-
     if (!headless) {
       let url;
 
@@ -2055,7 +2053,13 @@ Please check your network connection, TD_API_KEY, or the service status.`,
     }
 
     const { formatter } = require("../sdk-log-formatter.js");
-    this.emitter.emit(events.log.narration, formatter.getPrefix("connect") + " " + theme.green.bold("Authenticating") + theme.dim("..."));
+    this.emitter.emit(
+      events.log.narration,
+      formatter.getPrefix("connect") +
+        " " +
+        theme.green.bold("Authenticating") +
+        theme.dim("..."),
+    );
     let ableToAuth = await this.sandbox.auth(this.config.TD_API_KEY);
 
     if (!ableToAuth) {
@@ -2069,7 +2073,14 @@ Please check your network connection, TD_API_KEY, or the service status.`,
 
   async connectToSandboxDirect(sandboxId, persist = false, keepAlive = null) {
     const { formatter } = require("../sdk-log-formatter.js");
-    this.emitter.emit(events.log.narration, formatter.getPrefix("connect") + " " + theme.green.bold("Connecting") + " " + theme.cyan(`to sandbox...`));
+    this.emitter.emit(
+      events.log.narration,
+      formatter.getPrefix("connect") +
+        " " +
+        theme.green.bold("Connecting") +
+        " " +
+        theme.cyan(`to sandbox...`),
+    );
     let reply = await this.sandbox.connect(sandboxId, persist, keepAlive);
 
     // reply includes { success, url, sandbox: {...} }
@@ -2111,15 +2122,18 @@ Please check your network connection, TD_API_KEY, or the service status.`,
       let response = await this.sandbox.send(sandboxConfig, 60000 * 8);
 
       // Check if queued (all slots in use)
-      if (response.type === 'create.queued') {
+      if (response.type === "create.queued") {
         this.emitter.emit(
           events.log.narration,
-          formatter.getPrefix("queue") + " " + theme.yellow.bold("Waiting") + " " +
-          theme.dim(response.message),
+          formatter.getPrefix("queue") +
+            " " +
+            theme.yellow.bold("Waiting") +
+            " " +
+            theme.dim(response.message),
         );
 
         // Wait then retry
-        await new Promise(resolve => setTimeout(resolve, retryDelay));
+        await new Promise((resolve) => setTimeout(resolve, retryDelay));
         continue;
       }
 
@@ -2138,10 +2152,14 @@ Please check your network connection, TD_API_KEY, or the service status.`,
     // should be start of new session
     // If sandbox is connected, get system info; otherwise pass empty objects
     const isSandboxConnected = this.sandbox.apiSocketConnected;
-    
+
     const sessionRes = await this.sdk.req("session/start", {
-      systemInformationOsInfo: isSandboxConnected ? await this.system.getSystemInformationOsInfo() : {},
-      mousePosition: isSandboxConnected ? await this.system.getMousePosition() : {},
+      systemInformationOsInfo: isSandboxConnected
+        ? await this.system.getSystemInformationOsInfo()
+        : {},
+      mousePosition: isSandboxConnected
+        ? await this.system.getMousePosition()
+        : {},
       activeWindow: isSandboxConnected ? await this.system.activeWin() : {},
     });
 
@@ -2152,7 +2170,7 @@ Please check your network connection, TD_API_KEY, or the service status.`,
     }
 
     this.session.set(sessionRes.data.id);
-    
+
     // Set Sentry session trace context for distributed tracing
     // This links CLI errors/logs to the same trace as API calls
     try {

package/agent/lib/sandbox.js

@@ -10,14 +10,14 @@ const { events } = require("../events");
  */
 function getSentryTraceHeaders(sessionId) {
   if (!sessionId) return {};
-  
+
   // Same logic as API: derive trace ID from session ID
-  const traceId = crypto.createHash('md5').update(sessionId).digest('hex');
-  const spanId = crypto.randomBytes(8).toString('hex');
-  
+  const traceId = crypto.createHash("md5").update(sessionId).digest("hex");
+  const spanId = crypto.randomBytes(8).toString("hex");
+
   return {
-    'sentry-trace': `${traceId}-${spanId}-1`,
-    'baggage': `sentry-trace_id=${traceId},sentry-sample_rate=1.0,sentry-sampled=true`
+    "sentry-trace": `${traceId}-${spanId}-1`,
+    baggage: `sentry-trace_id=${traceId},sentry-sample_rate=1.0,sentry-sampled=true`,
   };
 }
 
@@ -36,6 +36,11 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
       this.os = null; // Store OS value to send with every message
       this.sessionInstance = sessionInstance; // Store session instance to include in messages
       this.traceId = null; // Sentry trace ID for debugging
+      this.reconnectAttempts = 0;
+      this.maxReconnectAttempts = 5;
+      this.intentionalDisconnect = false;
+      this.apiRoot = null;
+      this.apiKey = null;
     }
 
     /**
@@ -90,12 +95,16 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
         });
 
         const requestId = message.requestId;
-        
+
         // Set up timeout to prevent hanging requests
         const timeoutId = setTimeout(() => {
           if (this.ps[requestId]) {
             delete this.ps[requestId];
-            rejectPromise(new Error(`Sandbox message '${message.type}' timed out after ${timeout}ms`));
+            rejectPromise(
+              new Error(
+                `Sandbox message '${message.type}' timed out after ${timeout}ms`,
+              ),
+            );
           }
         }, timeout);
 
@@ -115,12 +124,13 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
 
         return p;
       }
-      
+
       // Return a rejected promise if socket is not available
-      return Promise.reject(new Error('Sandbox socket not connected'));
+      return Promise.reject(new Error("Sandbox socket not connected"));
     }
 
     async auth(apiKey) {
+      this.apiKey = apiKey;
       let reply = await this.send({
         type: "authenticate",
         apiKey,
@@ -128,15 +138,17 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
 
       if (reply.success) {
         this.authenticated = true;
-        
+
         // Log and store the Sentry trace ID for debugging
         if (reply.traceId) {
           this.traceId = reply.traceId;
-          console.log('');
+          console.log("");
           console.log(`🔗 View Trace:`);
-          console.log(`https://testdriver.sentry.io/explore/traces/trace/${reply.traceId}`);
+          console.log(
+            `https://testdriver.sentry.io/explore/traces/trace/${reply.traceId}`,
+          );
         }
-        
+
         emitter.emit(events.sandbox.authenticated, { traceId: reply.traceId });
         return true;
       }
@@ -161,24 +173,58 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
       }
     }
 
+    async handleConnectionLoss() {
+      if (this.intentionalDisconnect) return;
+
+      if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+        const errorMsg =
+          "Unable to reconnect to TestDriver sandbox after multiple attempts. Please check your internet connection.";
+        emitter.emit(events.error.sandbox, errorMsg);
+        console.error(errorMsg);
+        return;
+      }
+
+      this.reconnectAttempts++;
+      const delay = Math.min(1000 * 2 ** (this.reconnectAttempts - 1), 30000);
+
+      console.log(
+        `[Sandbox] Connection lost. Reconnecting in ${delay}ms... (Attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts})`,
+      );
+
+      setTimeout(async () => {
+        try {
+          await this.boot(this.apiRoot);
+          if (this.apiKey) {
+            await this.auth(this.apiKey);
+          }
+          console.log("[Sandbox] Reconnected successfully.");
+        } catch (e) {
+          // Ignore error here as the boot's error handler will trigger handleConnectionLoss again
+        }
+      }, delay);
+    }
+
     async boot(apiRoot) {
+      if (apiRoot) this.apiRoot = apiRoot;
       return new Promise((resolve, reject) => {
         // Get session ID for Sentry trace headers
         const sessionId = this.sessionInstance?.get();
-        
+
         if (!sessionId) {
-          console.warn('[Sandbox] No session ID available at boot time - Sentry tracing will not be available');
+          console.warn(
+            "[Sandbox] No session ID available at boot time - Sentry tracing will not be available",
+          );
         }
-        
+
         const sentryHeaders = getSentryTraceHeaders(sessionId);
 
         // Build WebSocket URL with Sentry trace headers as query params
         const wsUrl = new URL(apiRoot.replace("https://", "wss://"));
-        if (sentryHeaders['sentry-trace']) {
-          wsUrl.searchParams.set('sentry-trace', sentryHeaders['sentry-trace']);
+        if (sentryHeaders["sentry-trace"]) {
+          wsUrl.searchParams.set("sentry-trace", sentryHeaders["sentry-trace"]);
         }
-        if (sentryHeaders['baggage']) {
-          wsUrl.searchParams.set('baggage', sentryHeaders['baggage']);
+        if (sentryHeaders["baggage"]) {
+          wsUrl.searchParams.set("baggage", sentryHeaders["baggage"]);
         }
 
         this.socket = new WebSocket(wsUrl.toString());
@@ -189,6 +235,7 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
           // Emit a clear error event for API key issues
           reject();
           this.apiSocketConnected = false;
+          this.handleConnectionLoss();
         });
 
         this.socket.on("error", (err) => {
@@ -197,10 +244,13 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
           clearInterval(this.heartbeat);
           emitter.emit(events.error.sandbox, err);
           this.apiSocketConnected = false;
-          throw err;
+          this.handleConnectionLoss();
+          // We don't throw here to avoid crashing the process, let reconnection handle it
+          reject(err);
         });
 
         this.socket.on("open", async () => {
+          this.reconnectAttempts = 0;
           this.apiSocketConnected = true;
 
           this.heartbeat = setInterval(() => {
@@ -216,7 +266,7 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
           let message = JSON.parse(raw);
 
           // Handle progress messages (no requestId needed)
-          if (message.type === 'sandbox.progress') {
+          if (message.type === "sandbox.progress") {
             emitter.emit(events.sandbox.progress, {
               step: message.step,
               message: message.message,
@@ -250,11 +300,12 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
      * Close the WebSocket connection and clean up resources
      */
     close() {
+      this.intentionalDisconnect = true;
       if (this.heartbeat) {
         clearInterval(this.heartbeat);
         this.heartbeat = null;
       }
-      
+
       if (this.socket) {
         try {
           this.socket.close();
@@ -263,12 +314,12 @@ const createSandbox = (emitter, analytics, sessionInstance) => {
         }
         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 = {};

package/docs/v7/_drafts/provision.mdx

@@ -27,6 +27,7 @@ describe('My Test Suite', () => {
 - `provision.vscode()` - Launch VS Code with optional extensions
 - `provision.installer()` - Download and install applications
 - `provision.electron()` - Launch Electron applications
+- `provision.dashcam()` - Initialize Dashcam recording with logging
 
 ---
 
@@ -248,6 +249,66 @@ it('should launch Electron app', async (context) => {
 
 ---
 
+## provision.dashcam()
+
+Initialize Dashcam recording with logging. Use this when you want to start Dashcam recording without launching a specific application (e.g., for custom application launches or testing scenarios).
+
+```javascript
+await testdriver.provision.dashcam({
+  logPath: '/tmp/myapp.log',
+  logName: 'My Application Log',
+  title: 'Custom Test Recording'
+});
+```
+
+**Options:**
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `logPath` | string | auto-generated | Path to log file to track |
+| `logName` | string | `'TestDriver Log'` | Display name for the log |
+| `webLogs` | boolean | `true` | Enable web log tracking |
+| `title` | string | - | Custom title for the recording |
+
+**Example - Basic Recording:**
+
+```javascript
+it('should record a custom application test', async (context) => {
+  const testdriver = TestDriver(context, ());
+  
+  // Start Dashcam recording
+  await testdriver.provision.dashcam();
+  
+  // Launch your custom application
+  await testdriver.exec('sh', './my-custom-app.sh &', 10000);
+  
+  // Interact with the application
+  await testdriver.find('main window').click();
+  
+  const result = await testdriver.assert('Application is running');
+  expect(result).toBeTruthy();
+});
+```
+
+**Example - Custom Log File:**
+
+```javascript
+it('should record with custom log file', async (context) => {
+  const testdriver = TestDriver(context, ());
+  
+  // Start Dashcam with custom log tracking
+  await testdriver.provision.dashcam({
+    logPath: '/var/log/myapp/application.log',
+    logName: 'My App Logs',
+    title: 'Custom App Test'
+  });
+  
+  // Your test code here
+  await testdriver.exec('sh', 'myapp --start', 30000);
+});
+```
+
+---
+
 ## How Provision Methods Work
 
 When you call a provision method:

package/lib/core/Dashcam.js

@@ -112,7 +112,7 @@ class Dashcam {
       shell,
       "npm prefix -g",
       40000,
-      false,
+      process.env.DEBUG == "true" ? false : true,
     );
 
     if (this.client.os === "windows") {
@@ -140,7 +140,7 @@ class Dashcam {
         shell,
         `$env:TD_API_ROOT="${apiRoot}"; & "${dashcamPath}" auth ${key}`,
         120000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Auth output:", authOutput);
     } else {
@@ -149,7 +149,7 @@ class Dashcam {
         shell,
         `TD_API_ROOT="${apiRoot}" dashcam auth ${key}`,
         120000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Auth output:", authOutput);
     }
@@ -173,7 +173,7 @@ class Dashcam {
         shell,
         `New-Item -ItemType File -Path "${path}" -Force`,
         10000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Create log file output:", createFileOutput);
 
@@ -182,19 +182,24 @@ class Dashcam {
         shell,
         `$env:TD_API_ROOT="${apiRoot}"; & "${dashcamPath}" logs --add --type=file --file="${path}" --name="${name}"`,
         120000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Add log tracking output:", addLogOutput);
     } else {
       // Create log file
-      await this.client.exec(shell, `touch ${path}`, 10000, false);
+      await this.client.exec(
+        shell,
+        `touch ${path}`,
+        10000,
+        process.env.DEBUG == "true" ? false : true,
+      );
 
       // Add log tracking with TD_API_ROOT
       const addLogOutput = await this.client.exec(
         shell,
         `TD_API_ROOT="${apiRoot}" dashcam logs --add --type=file --file="${path}" --name="${name}"`,
         10000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Add log tracking output:", addLogOutput);
     }
@@ -216,7 +221,7 @@ class Dashcam {
         shell,
         `$env:TD_API_ROOT="${apiRoot}"; & "${dashcamPath}" logs --add --type=application --application="${application}" --name="${name}"`,
         120000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Add application log tracking output:", addLogOutput);
     } else {
@@ -224,7 +229,7 @@ class Dashcam {
         shell,
         `TD_API_ROOT="${apiRoot}" dashcam logs --add --type=application --application="${application}" --name="${name}"`,
         10000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Add application log tracking output:", addLogOutput);
     }
@@ -246,7 +251,7 @@ class Dashcam {
         shell,
         `$env:TD_API_ROOT="${apiRoot}"; & "${dashcamPath}" logs --add --type=web --pattern="${pattern}" --name="${name}"`,
         120000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Add web log tracking output:", addLogOutput);
     } else {
@@ -254,7 +259,7 @@ class Dashcam {
         shell,
         `TD_API_ROOT="${apiRoot}" dashcam logs --add --type=web --pattern="${pattern}" --name="${name}"`,
         10000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Add web log tracking output:", addLogOutput);
     }
@@ -310,7 +315,7 @@ class Dashcam {
         shell,
         startScript,
         10000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Start-Process output:", startOutput);
 
@@ -320,7 +325,7 @@ class Dashcam {
         shell,
         `Get-Content "${outputFile}" -ErrorAction SilentlyContinue`,
         10000,
-        false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Dashcam record output:", dashcamOutput);
 
@@ -339,6 +344,8 @@ class Dashcam {
       await this.client.exec(
         shell,
         `TD_API_ROOT="${apiRoot}" dashcam record${titleArg} >/dev/null 2>&1 &`,
+        10000,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Dashcam recording started");
     }
@@ -382,7 +389,7 @@ class Dashcam {
         shell,
         `$env:TD_API_ROOT="${apiRoot}"; & "${dashcamPath}" stop`,
         300000,
-        process.env.DEBUG == "true" ? true : false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Dashcam stop command output:", output);
     } else {
@@ -392,7 +399,7 @@ class Dashcam {
         shell,
         `TD_API_ROOT="${apiRoot}" "${dashcamPath}" stop`,
         300000,
-        process.env.DEBUG == "true" ? true : false,
+        process.env.DEBUG == "true" ? false : true,
       );
       this._log("debug", "Dashcam command output:", output);
     }

package/lib/vitest/setup-aws.mjs

@@ -114,12 +114,10 @@ function cleanupAllInstances() {
 // Register cleanup handlers for various exit scenarios
 process.on("exit", cleanupAllInstances);
 process.on("SIGINT", () => {
-  console.log("\n[TestDriver] Received SIGINT, cleaning up instances...");
   cleanupAllInstances();
   // Don't call process.exit here - let the signal handler do its job
 });
 process.on("SIGTERM", () => {
-  console.log("\n[TestDriver] Received SIGTERM, cleaning up instances...");
   cleanupAllInstances();
   // Don't call process.exit here - let the signal handler do its job
 });
@@ -142,14 +140,6 @@ beforeEach(async (context) => {
     return;
   }
 
-  // Verify required parameters are available
-  if (process.env.TD_OS === "windows") {
-    console.log(
-      "[TestDriver] startup check: TWOCAPTCHA_API_KEY is " +
-        (process.env.TWOCAPTCHA_API_KEY ? "REQUIRED" : "MISSING"),
-    );
-  }
-
   if (!process.env.AWS_LAUNCH_TEMPLATE_ID || !process.env.AMI_ID) {
     throw new Error(
       "[TestDriver] TD_OS=windows requires AWS_LAUNCH_TEMPLATE_ID and AMI_ID environment variables",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.2.62",
+  "version": "7.2.64",
   "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

@@ -769,6 +769,18 @@ export interface ProvisionElectronOptions {
   args?: string[];
 }
 
+/** Options for provision.dashcam */
+export interface ProvisionDashcamOptions {
+  /** Path to log file (auto-generated if not provided) */
+  logPath?: string;
+  /** Display name for the log (default: 'TestDriver Log') */
+  logName?: string;
+  /** Enable web log tracking (default: true) */
+  webLogs?: boolean;
+  /** Custom title for the recording */
+  title?: string;
+}
+
 /** Provision API for launching applications */
 export interface ProvisionAPI {
   /**
@@ -801,6 +813,12 @@ export interface ProvisionAPI {
    * @param options - Electron launch options
    */
   electron(options: ProvisionElectronOptions): Promise<void>;
+
+  /**
+   * Initialize Dashcam recording with logging
+   * @param options - Dashcam options
+   */
+  dashcam(options?: ProvisionDashcamOptions): Promise<void>;
 }
 
 /** Dashcam API for screen recording */
@@ -1229,6 +1247,7 @@ export default class TestDriverSDK {
   // AI Methods (Exploratory Loop)
 
   /**
+   * @deprecated Use ai() instead
    * Execute a natural language task using AI
    * This is the SDK equivalent of the CLI's exploratory loop
    *
@@ -1238,11 +1257,11 @@ export default class TestDriverSDK {
    *
    * @example
    * // Simple execution
-   * await client.act('Click the submit button');
+   * await client.ai('Click the submit button');
    *
    * @example
    * // With validation loop
-   * const result = await client.act('Fill out the contact form', { validateAndLoop: true });
+   * const result = await client.ai('Fill out the contact form', { validateAndLoop: true });
    * console.log(result); // AI's final assessment
    */
   act(
@@ -1251,7 +1270,6 @@ export default class TestDriverSDK {
   ): Promise<string | void>;
 
   /**
-   * @deprecated Use act() instead
    * Execute a natural language task using AI
    *
    * @param task - Natural language description of what to do

package/sdk.js

@@ -1506,64 +1506,7 @@ class TestDriverSDK {
           await this._dashcam.addWebLog("**", "Web Logs");
         }
 
-        // Set up Chrome profile with preferences
         const shell = this.os === "windows" ? "pwsh" : "sh";
-        const userDataDir =
-          this.os === "windows"
-            ? "C:\\Users\\testdriver\\AppData\\Local\\TestDriver\\Chrome"
-            : "/tmp/testdriver-chrome-profile";
-
-        // Create user data directory and Default profile directory
-        const defaultProfileDir =
-          this.os === "windows"
-            ? `${userDataDir}\\Default`
-            : `${userDataDir}/Default`;
-
-        const createDirCmd =
-          this.os === "windows"
-            ? `New-Item -ItemType Directory -Path "${defaultProfileDir}" -Force | Out-Null`
-            : `mkdir -p "${defaultProfileDir}"`;
-
-        await this.exec(shell, createDirCmd, 60000, true);
-
-        // Write Chrome preferences
-        const chromePrefs = {
-          credentials_enable_service: false,
-          profile: {
-            password_manager_enabled: false,
-            default_content_setting_values: {},
-          },
-          signin: {
-            allowed: false,
-          },
-          sync: {
-            requested: false,
-            first_setup_complete: true,
-            sync_all_os_types: false,
-          },
-          autofill: {
-            enabled: false,
-          },
-          local_state: {
-            browser: {
-              has_seen_welcome_page: true,
-            },
-          },
-        };
-
-        const prefsPath =
-          this.os === "windows"
-            ? `${defaultProfileDir}\\Preferences`
-            : `${defaultProfileDir}/Preferences`;
-
-        const prefsJson = JSON.stringify(chromePrefs, null, 2);
-        const writePrefCmd =
-          this.os === "windows"
-            ? // Use compact JSON and [System.IO.File]::WriteAllText to avoid Set-Content hanging issues
-              `[System.IO.File]::WriteAllText("${prefsPath}", '${JSON.stringify(chromePrefs).replace(/'/g, "''")}')`
-            : `cat > "${prefsPath}" << 'EOF'\n${prefsJson}\nEOF`;
-
-        await this.exec(shell, writePrefCmd, 60000, true);
 
         // Build Chrome launch command
         const chromeArgs = [];
@@ -1575,7 +1518,6 @@ class TestDriverSDK {
           "--no-first-run",
           "--no-experiments",
           "--disable-infobars",
-          `--user-data-dir=${userDataDir}`,
         );
 
         // Add remote debugging port for captcha solving support
@@ -1788,64 +1730,6 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
           await this._dashcam.addWebLog("**", "Web Logs");
         }
 
-        // Set up Chrome profile with preferences
-        const userDataDir =
-          this.os === "windows"
-            ? "C:\\Users\\testdriver\\AppData\\Local\\TestDriver\\Chrome"
-            : "/tmp/testdriver-chrome-profile";
-
-        // Create user data directory and Default profile directory
-        const defaultProfileDir =
-          this.os === "windows"
-            ? `${userDataDir}\\Default`
-            : `${userDataDir}/Default`;
-
-        const createDirCmd =
-          this.os === "windows"
-            ? `New-Item -ItemType Directory -Path "${defaultProfileDir}" -Force | Out-Null`
-            : `mkdir -p "${defaultProfileDir}"`;
-
-        await this.exec(shell, createDirCmd, 60000, true);
-
-        // Write Chrome preferences
-        const chromePrefs = {
-          credentials_enable_service: false,
-          profile: {
-            password_manager_enabled: false,
-            default_content_setting_values: {},
-          },
-          signin: {
-            allowed: false,
-          },
-          sync: {
-            requested: false,
-            first_setup_complete: true,
-            sync_all_os_types: false,
-          },
-          autofill: {
-            enabled: false,
-          },
-          local_state: {
-            browser: {
-              has_seen_welcome_page: true,
-            },
-          },
-        };
-
-        const prefsPath =
-          this.os === "windows"
-            ? `${defaultProfileDir}\\Preferences`
-            : `${defaultProfileDir}/Preferences`;
-
-        const prefsJson = JSON.stringify(chromePrefs, null, 2);
-        const writePrefCmd =
-          this.os === "windows"
-            ? // Use compact JSON and [System.IO.File]::WriteAllText to avoid Set-Content hanging issues
-              `[System.IO.File]::WriteAllText("${prefsPath}", '${JSON.stringify(chromePrefs).replace(/'/g, "''")}')`
-            : `cat > "${prefsPath}" << 'EOF'\n${prefsJson}\nEOF`;
-
-        await this.exec(shell, writePrefCmd, 60000, true);
-
         // Build Chrome launch command
         const chromeArgs = [];
         if (maximized) chromeArgs.push("--start-maximized");
@@ -1856,7 +1740,6 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
           "--no-experiments",
           "--disable-infobars",
           "--disable-features=ChromeLabs",
-          `--user-data-dir=${userDataDir}`,
         );
 
         // Add remote debugging port for captcha solving support
@@ -2160,6 +2043,58 @@ with zipfile.ZipFile(io.BytesIO(zip_data)) as zf:
 
         await this.focusApplication("Electron");
       },
+
+      /**
+       * Initialize Dashcam recording with logging
+       * @param {Object} options - Dashcam options
+       * @param {string} [options.logPath] - Path to log file (auto-generated if not provided)
+       * @param {string} [options.logName='TestDriver Log'] - Display name for the log
+       * @param {boolean} [options.webLogs=true] - Enable web log tracking
+       * @param {string} [options.title] - Custom title for the recording
+       * @returns {Promise<void>}
+       */
+      dashcam: async (options = {}) => {
+        const {
+          logPath,
+          logName = "TestDriver Log",
+          webLogs = true,
+          title,
+        } = options;
+
+        // Ensure dashcam is available
+        if (!this._dashcam) {
+          console.warn(
+            "[provision.dashcam] Dashcam is not available. Skipping.",
+          );
+          return;
+        }
+
+        // Set custom title if provided
+        if (title) {
+          this._dashcam.setTitle(title);
+        }
+
+        // Add file log tracking
+        const actualLogPath =
+          logPath ||
+          (this.os === "windows"
+            ? "C:\\Users\\testdriver\\testdriver.log"
+            : "/tmp/testdriver.log");
+
+        await this._dashcam.addFileLog(actualLogPath, logName);
+
+        // Add web log tracking if enabled
+        if (webLogs) {
+          await this._dashcam.addWebLog("**", "Web Logs");
+        }
+
+        // Start recording if not already recording
+        if (!(await this._dashcam.isRecording())) {
+          await this._dashcam.start();
+        }
+
+        console.log("[provision.dashcam] ✅ Dashcam recording started");
+      },
     };
 
     // Wrap all provision methods with reconnect check using Proxy
@@ -3499,28 +3434,28 @@ CAPTCHA_SOLVER_EOF`,
    *
    * @example
    * // Simple execution
-   * const result = await client.act('Click the submit button');
+   * const result = await client.ai('Click the submit button');
    * console.log(result.success); // true
    *
    * @example
    * // With custom retry limit
-   * const result = await client.act('Fill out the contact form', { tries: 10 });
+   * const result = await client.ai('Fill out the contact form', { tries: 10 });
    * console.log(`Completed in ${result.tries} tries`);
    *
    * @example
    * // Handle failures
    * try {
-   *   await client.act('Complete the checkout process', { tries: 3 });
+   *   await client.ai('Complete the checkout process', { tries: 3 });
    * } catch (error) {
    *   console.log(`Failed after ${error.tries} tries: ${error.message}`);
    * }
    */
-  async act(task, options = {}) {
+  async ai(task, options = {}) {
     this._ensureConnected();
 
     const { tries = 7 } = options;
 
-    this.analytics.track("sdk.act", { task, tries });
+    this.analytics.track("sdk.ai", { task, tries });
 
     const { events } = require("./agent/events.js");
     const startTime = Date.now();
@@ -3529,7 +3464,7 @@ CAPTCHA_SOLVER_EOF`,
     const originalCheckLimit = this.agent.checkLimit;
     this.agent.checkLimit = tries;
 
-    // Reset check count for this act() call
+    // Reset check count for this ai() call
     const originalCheckCount = this.agent.checkCount;
     this.agent.checkCount = 0;
 
@@ -3596,7 +3531,7 @@ CAPTCHA_SOLVER_EOF`,
   }
 
   /**
-   * @deprecated Use act() instead
+   * @deprecated Use ai() instead
    * Execute a natural language task using AI
    *
    * @param {string} task - Natural language description of what to do
@@ -3604,8 +3539,8 @@ CAPTCHA_SOLVER_EOF`,
    * @param {number} [options.tries=7] - Maximum number of check/retry attempts
    * @returns {Promise<ActResult>} Result object with success status and details
    */
-  async ai(task, options) {
-    return await this.act(task, options);
+  async act(task, options) {
+    return await this.ai(task, options);
   }
 }