testdriverai 7.2.63 → 7.2.64

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [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)
 
 

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,15 +441,12 @@ 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,
+    });
 
     // Use log.log (not markdown.static) so output goes through console spy to sandbox
     this.emitter.emit(events.log.log, response.data);
@@ -878,7 +880,7 @@ commands:
     currentTask,
     dry = false,
     validateAndLoop = false,
-    shouldSave = true
+    shouldSave = true,
   ) {
     // Check if execution has been stopped
     if (this.stopped) {
@@ -901,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);
 
@@ -1626,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)
@@ -1648,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,
@@ -1663,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;
     }
@@ -1690,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,
@@ -1757,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"));
       }
     }
 
@@ -1802,7 +1795,7 @@ ${regression}
         theme.dim(`using recent sandbox: ${recentId}`),
       );
       this.sandboxId = recentId;
-      
+
       try {
         let instance = await this.connectToSandboxDirect(
           this.sandboxId,
@@ -1850,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.
@@ -1869,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
@@ -2002,7 +2000,6 @@ ${regression}
   }
 
   async renderSandbox(instance, headless = false) {
-
     if (!headless) {
       let url;
 
@@ -2056,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) {
@@ -2070,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: {...} }
@@ -2112,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;
       }
 
@@ -2139,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() : {},
     });
 
@@ -2153,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/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.63",
+  "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

@@ -1247,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
    *
@@ -1256,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(
@@ -1269,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

@@ -3434,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();
@@ -3464,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;
 
@@ -3531,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
@@ -3539,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);
   }
 }