testdriverai 7.8.0-test.53 → 7.8.0-test.54

package/agent/lib/logger.js

@@ -7,6 +7,7 @@
  */
 
 const useStderr = process.env.TD_STDIO === 'stderr';
+const isDebug = process.env.DEBUG === 'true';
 
 /**
  * Log a message - uses stdout by default, stderr if TD_STDIO=stderr
@@ -40,6 +41,19 @@ function warn(...args) {
   }
 }
 
+/**
+ * Log a debug message - only outputs when DEBUG=true
+ * @param {...any} args - Arguments to log
+ */
+function debug(...args) {
+  if (!isDebug) return;
+  if (useStderr) {
+    console.error(...args);
+  } else {
+    console.log(...args);
+  }
+}
+
 /**
  * Check if logger is configured to use stderr
  * @returns {boolean}
@@ -50,6 +64,7 @@ function isStderrMode() {
 
 module.exports = {
   log,
+  debug,
   error,
   warn,
   isStderrMode,

package/agent/lib/sandbox.js

@@ -85,7 +85,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         suspendedRetryTimeout: 15000,     // retry from suspended every 15s (default 30s)
       });
 
-      logger.log(`[realtime] Connecting as sdk-${this._sandboxId}...`);
+      logger.debug(`[realtime] Connecting as sdk-${this._sandboxId}...`);
 
       await new Promise(function (resolve, reject) {
         self._ably.connection.on("connected", resolve);
@@ -99,7 +99,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
 
       this._sessionChannel = this._ably.channels.get(channelName);
 
-      logger.log(`[realtime] Channel initialized: ${channelName}`);
+      logger.debug(`[realtime] Channel initialized: ${channelName}`);
 
       // Enter presence on the session channel so the API can count connected SDK clients
       try {
@@ -107,7 +107,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
           sandboxId: this._sandboxId,
           connectedAt: Date.now(),
         });
-        logger.log(`[realtime] Entered presence on session channel (sandbox=${this._sandboxId})`);
+        logger.debug(`[realtime] Entered presence on session channel (sandbox=${this._sandboxId})`);
       } catch (e) {
         // Non-fatal — presence is used for concurrency counting, not critical path
         logger.warn("Failed to enter presence on session channel: " + (e.message || e));
@@ -118,7 +118,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         var message = msg.data;
         if (!message) return;
 
-        logger.log(`[realtime] Received response: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
+        logger.debug(`[realtime] Received response: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
 
         if (message.type === "sandbox.progress") {
           emitter.emit(events.sandbox.progress, {
@@ -212,7 +212,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             var resolveAge = resolveEntry.startTime
               ? ((Date.now() - resolveEntry.startTime) / 1000).toFixed(1) + 's'
               : '?';
-            logger.log(
+            logger.debug(
               '[realtime] Promise RESOLVED: requestId=' + message.requestId +
               ' | type=' + (resolveEntry.message ? resolveEntry.message.type : 'unknown') +
               ' | age=' + resolveAge
@@ -241,7 +241,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       this._onFileMsg = function (msg) {
         var message = msg.data;
         if (!message) return;
-        logger.log(`[realtime] Received file: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
+        logger.debug(`[realtime] Received file: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
         if (message.requestId && self.ps[message.requestId]) {
           emitter.emit(events.sandbox.received);
           self.ps[message.requestId].resolve(message);
@@ -260,7 +260,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         const chState = this._sessionChannel ? this._sessionChannel.state : 'null';
         const pendingIds = Object.keys(this.ps);
         const pending = pendingIds.length;
-        logger.log(`[realtime][stats] connection=${connState} | sandbox=${this._sandboxId} | pending=${pending} | channel=${chState}`);
+        logger.debug(`[realtime][stats] connection=${connState} | sandbox=${this._sandboxId} | pending=${pending} | channel=${chState}`);
         if (pending > 0) {
           const now = Date.now();
           for (const rid of pendingIds) {
@@ -268,20 +268,20 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             if (!entry) continue;
             const type = entry.message ? entry.message.type : 'unknown';
             const ageSec = ((now - (entry.startTime || now)) / 1000).toFixed(1);
-            logger.log(`[realtime][stats]   pending: requestId=${rid} | type=${type} | age=${ageSec}s`);
+            logger.debug(`[realtime][stats]   pending: requestId=${rid} | type=${type} | age=${ageSec}s`);
           }
         }
       }, 10000);
       if (this._statsInterval.unref) this._statsInterval.unref();
 
       this._ably.connection.on("disconnected", function () {
-        logger.log("[realtime] Connection: disconnected - will auto-reconnect");
+        logger.debug("[realtime] Connection: disconnected - will auto-reconnect");
         self._disconnectedAt = Date.now();
       });
 
       this._ably.connection.on("connected", function () {
         // Log reconnection so the user knows the blip was recovered
-        logger.log("[realtime] Connection: reconnected");
+        logger.debug("[realtime] Connection: reconnected");
         // Extend any pending command timeouts by the disconnection duration so
         // commands whose timer was counting down while the connection was down
         // don't get incorrectly timed out.
@@ -290,7 +290,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
           self._disconnectedAt = null;
           var pendingIds = Object.keys(self.ps);
           if (pendingIds.length > 0) {
-            logger.log(
+            logger.debug(
               '[realtime] Extending ' + pendingIds.length + ' pending timeout(s) by ' +
               disconnectionDurationMs + 'ms after disconnection'
             );
@@ -353,7 +353,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         var entry = subs[i];
         if (!entry.sub) continue;
         try {
-          logger.log('[realtime] Discontinuity recovery: fetching historyBeforeSubscribe for ' + entry.name + '...');
+          logger.debug('[realtime] Discontinuity recovery: fetching historyBeforeSubscribe for ' + entry.name + '...');
           var page = await entry.sub.historyBeforeSubscribe({ limit: 100 });
           var recovered = 0;
           while (page) {
@@ -363,7 +363,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
               recovered++;
               try {
                 if (entry.handler) {
-                  logger.log('[realtime] Replaying recovered ' + entry.name + ' message (requestId=' + (page.items[j].data && page.items[j].data.requestId || 'none') + ')');
+                  logger.debug('[realtime] Replaying recovered ' + entry.name + ' message (requestId=' + (page.items[j].data && page.items[j].data.requestId || 'none') + ')');
                   entry.handler(page.items[j]);
                 }
               } catch (replayErr) {
@@ -373,7 +373,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             page = page.hasNext() ? await page.next() : null;
           }
           totalRecovered += recovered;
-          logger.log('[realtime] Discontinuity recovery: replayed ' + recovered + ' ' + entry.name + ' message(s) from gap');
+          logger.debug('[realtime] Discontinuity recovery: replayed ' + recovered + ' ' + entry.name + ' message(s) from gap');
         } catch (err) {
           logger.error('[realtime] Discontinuity recovery failed for ' + entry.name + ': ' + (err.message || err));
         }
@@ -381,7 +381,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       if (totalRecovered > 0) {
         logger.warn('[realtime] Recovered and replayed ' + totalRecovered + ' message(s) that were missed during connection interruption');
       } else {
-        logger.log('[realtime] Discontinuity recovery: no missed messages found');
+        logger.debug('[realtime] Discontinuity recovery: no missed messages found');
       }
     }
 
@@ -1019,7 +1019,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       }
 
       return channel.publish(eventName, message).then(function () {
-        logger.log(`[realtime] Published: channel=${channel.name.split(':').pop()}, event=${eventName}, type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
+        logger.debug(`[realtime] Published: channel=${channel.name.split(':').pop()}, event=${eventName}, type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
       });
     }
 

package/package.json

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