testdriverai 7.8.0-test.50 → 7.8.0-test.52

package/agent/lib/sandbox.js

@@ -29,7 +29,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       this._lastConnectParams = null;
       this._teamId = null;
       this._sandboxId = null;
-      this._disconnectedAt = null; // tracks when Ably connection dropped (for timeout extension on reconnect)
+      this._disconnectedAt = null; // tracks when Realtime connection dropped (for timeout extension on reconnect)
 
       // Rate limiting state for Ably publishes (Ably limits to 50 msg/sec per connection)
       this._publishLastTime = 0;
@@ -85,21 +85,21 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         suspendedRetryTimeout: 15000,     // retry from suspended every 15s (default 30s)
       });
 
-      logger.log(`[ably] Connecting as sdk-${this._sandboxId}...`);
+      logger.log(`[realtime] Connecting as sdk-${this._sandboxId}...`);
 
       await new Promise(function (resolve, reject) {
         self._ably.connection.on("connected", resolve);
         self._ably.connection.on("failed", function () {
-          reject(new Error("Ably connection failed"));
+          reject(new Error("Realtime connection failed"));
         });
         setTimeout(function () {
-          reject(new Error("Ably connection timeout"));
+          reject(new Error("Realtime connection timeout"));
         }, 30000);
       });
 
       this._sessionChannel = this._ably.channels.get(channelName);
 
-      logger.log(`[ably] Channel initialized: ${channelName}`);
+      logger.log(`[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(`[ably] Entered presence on session channel (sandbox=${this._sandboxId})`);
+        logger.log(`[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(`[ably] Received response: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
+        logger.log(`[realtime] Received response: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
 
         if (message.type === "sandbox.progress") {
           emitter.emit(events.sandbox.progress, {
@@ -178,7 +178,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             }).join(', ')
             : 'none';
           logger.warn(
-            '[ably] No pending promise for requestId=' + (message.requestId || 'null') +
+            '[realtime] No pending promise for requestId=' + (message.requestId || 'null') +
             ' | response type=' + (message.type || 'unknown') +
             ' | error=' + (message.error ? (message.errorMessage || 'true') : 'false') +
             ' | currently pending: [' + pendingSummary + ']'
@@ -193,7 +193,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             ? ((Date.now() - pendingEntry.startTime) / 1000).toFixed(1) + 's'
             : '?';
           logger.warn(
-            '[ably] Promise REJECTED: requestId=' + message.requestId +
+            '[realtime] Promise REJECTED: requestId=' + message.requestId +
             ' | type=' + (pendingMessage ? pendingMessage.type : 'unknown') +
             ' | age=' + pendingAge +
             ' | error=' + (message.errorMessage || 'Sandbox error')
@@ -213,7 +213,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
               ? ((Date.now() - resolveEntry.startTime) / 1000).toFixed(1) + 's'
               : '?';
             logger.log(
-              '[ably] Promise RESOLVED: requestId=' + message.requestId +
+              '[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(`[ably] Received file: type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
+        logger.log(`[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(`[ably][stats] connection=${connState} | sandbox=${this._sandboxId} | pending=${pending} | channel=${chState}`);
+        logger.log(`[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(`[ably][stats]   pending: requestId=${rid} | type=${type} | age=${ageSec}s`);
+            logger.log(`[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("[ably] Connection: disconnected - will auto-reconnect");
+        logger.log("[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("[ably] Connection: reconnected");
+        logger.log("[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.
@@ -291,7 +291,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
           var pendingIds = Object.keys(self.ps);
           if (pendingIds.length > 0) {
             logger.log(
-              '[ably] Extending ' + pendingIds.length + ' pending timeout(s) by ' +
+              '[realtime] Extending ' + pendingIds.length + ' pending timeout(s) by ' +
               disconnectionDurationMs + 'ms after disconnection'
             );
             for (var i = 0; i < pendingIds.length; i++) {
@@ -305,14 +305,14 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       });
 
       this._ably.connection.on("suspended", function () {
-        logger.warn("[ably] Connection: suspended - connection lost for extended period, will keep retrying");
+        logger.warn("[realtime] Connection: suspended - connection lost for extended period, will keep retrying");
       });
 
       this._ably.connection.on("failed", function () {
-        logger.error("[ably] Connection: failed");
+        logger.error("[realtime] Connection: failed");
         self.apiSocketConnected = false;
         self.instanceSocketConnected = false;
-        emitter.emit(events.error.sandbox, "Ably connection failed");
+        emitter.emit(events.error.sandbox, "Realtime connection failed");
       });
 
       // ─── Channel discontinuity detection ──────────────────────────────
@@ -326,7 +326,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         var reasonMsg = reason ? (reason.message || reason.code || String(reason)) : '';
 
         if (current === 'attached' && stateChange.resumed === false && previous === 'attached') {
-          logger.warn('[ably] Channel DISCONTINUITY detected (resumed=false)' + (reasonMsg ? ' — ' + reasonMsg : ''));
+          logger.warn('[realtime] Channel DISCONTINUITY detected (resumed=false)' + (reasonMsg ? ' — ' + reasonMsg : ''));
           emitter.emit(events.sandbox.progress, {
             step: 'discontinuity',
             message: 'Recovering missed messages after connection interruption...',
@@ -353,7 +353,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
         var entry = subs[i];
         if (!entry.sub) continue;
         try {
-          logger.log('[ably] Discontinuity recovery: fetching historyBeforeSubscribe for ' + entry.name + '...');
+          logger.log('[realtime] Discontinuity recovery: fetching historyBeforeSubscribe for ' + entry.name + '...');
           var page = await entry.sub.historyBeforeSubscribe({ limit: 100 });
           var recovered = 0;
           while (page) {
@@ -363,25 +363,25 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
               recovered++;
               try {
                 if (entry.handler) {
-                  logger.log('[ably] Replaying recovered ' + entry.name + ' message (requestId=' + (page.items[j].data && page.items[j].data.requestId || 'none') + ')');
+                  logger.log('[realtime] Replaying recovered ' + entry.name + ' message (requestId=' + (page.items[j].data && page.items[j].data.requestId || 'none') + ')');
                   entry.handler(page.items[j]);
                 }
               } catch (replayErr) {
-                logger.error('[ably] Error replaying recovered message: ' + (replayErr.message || replayErr));
+                logger.error('[realtime] Error replaying recovered message: ' + (replayErr.message || replayErr));
               }
             }
             page = page.hasNext() ? await page.next() : null;
           }
           totalRecovered += recovered;
-          logger.log('[ably] Discontinuity recovery: replayed ' + recovered + ' ' + entry.name + ' message(s) from gap');
+          logger.log('[realtime] Discontinuity recovery: replayed ' + recovered + ' ' + entry.name + ' message(s) from gap');
         } catch (err) {
-          logger.error('[ably] Discontinuity recovery failed for ' + entry.name + ': ' + (err.message || err));
+          logger.error('[realtime] Discontinuity recovery failed for ' + entry.name + ': ' + (err.message || err));
         }
       }
       if (totalRecovered > 0) {
-        logger.warn('[ably] Recovered and replayed ' + totalRecovered + ' message(s) that were missed during connection interruption');
+        logger.warn('[realtime] Recovered and replayed ' + totalRecovered + ' message(s) that were missed during connection interruption');
       } else {
-        logger.log('[ably] Discontinuity recovery: no missed messages found');
+        logger.log('[realtime] Discontinuity recovery: no missed messages found');
       }
     }
 
@@ -809,7 +809,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             function onFailed() {
               clearTimeout(timer);
               self._ably.connection.off("connected", onConnected);
-              reject(new Error("Ably connection failed while waiting to send"));
+              reject(new Error("Realtime connection failed while waiting to send"));
             }
             self._ably.connection.once("connected", onConnected);
             self._ably.connection.once("failed", onFailed);
@@ -881,7 +881,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
             return rid + '(' + (e && e.message ? e.message.type : '?') + ', ' + age + ')';
           }).join(', ');
           logger.error(
-            '[ably] Promise TIMEOUT: requestId=' + requestId +
+            '[realtime] Promise TIMEOUT: requestId=' + requestId +
             ' | type=' + message.type +
             ' | timeout=' + timeout + 'ms' +
             ' | all pending: [' + pendingSummary + ']'
@@ -930,7 +930,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
           timeoutId = setTimeout(timeoutFn, newRemaining);
           if (timeoutId.unref) timeoutId.unref();
           logger.log(
-            '[ably] Extended timeout for requestId=' + requestId +
+            '[realtime] Extended timeout for requestId=' + requestId +
             ' by ' + disconnectionDurationMs + 'ms (new remaining: ' + Math.round(newRemaining / 1000) + 's)'
           );
         },
@@ -1002,7 +1002,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       }
 
       return channel.publish(eventName, message).then(function () {
-        logger.log(`[ably] Published: channel=${channel.name.split(':').pop()}, event=${eventName}, type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
+        logger.log(`[realtime] Published: channel=${channel.name.split(':').pop()}, event=${eventName}, type=${message.type || 'unknown'} (requestId=${message.requestId || 'none'})`);
       });
     }
 
@@ -1132,7 +1132,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       // Send end-session control message to runner before disconnecting
       if (this._sessionChannel && this._ably?.connection?.state === 'connected') {
         try {
-          logger.log('[ably] Publishing control: type=end-session');
+          logger.log('[realtime] Publishing control: type=end-session');
           await this._sessionChannel.publish('control', { type: 'end-session' });
         } catch (e) {
           // Ignore - best effort
@@ -1142,7 +1142,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       // Leave presence on session channel
       if (this._sessionChannel) {
         try {
-          logger.log('[ably] Leaving presence on session channel');
+          logger.log('[realtime] Leaving presence on session channel');
           await this._sessionChannel.presence.leave();
         } catch (e) {
           // ignore - best effort, Ably will auto-leave on disconnect
@@ -1150,7 +1150,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
       }
 
       try {
-        logger.log('[ably] Detaching session channel');
+        logger.log('[realtime] Detaching session channel');
         if (this._sessionChannel) {
           await this._sessionChannel.detach();
         }
@@ -1160,7 +1160,7 @@ const createSandbox = function (emitter, analytics, sessionInstance) {
 
       if (this._ably) {
         try {
-          logger.log('[ably] Closing Ably connection');
+          logger.log('[realtime] Closing Realtime connection');
           this._ably.close();
         } catch (e) {
           /* ignore */

package/ai/skills/testdriver-find/SKILL.md

@@ -49,8 +49,8 @@ const element = await testdriver.find(description, options)
       - `"any"` — No wrapping, uses the description as-is (default behavior)
     </ParamField>
     
-    <ParamField path="zoom" type="boolean" default={false}>
-      Enable two-phase zoom mode for better precision in crowded UIs with many similar elements.
+    <ParamField path="zoom" type="boolean" default={true}>
+      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Enabled by default.
     </ParamField>
     
     <ParamField path="ai" type="object">
@@ -332,14 +332,19 @@ The `timeout` option:
 - Returns the element (check `element.found()` if not throwing on failure)
 - Set to `0` to disable polling and make a single attempt
 
-## Zoom Mode for Crowded UIs
+## Zoom Mode
 
-When dealing with many similar icons or elements clustered together (like browser toolbars), enable `zoom` mode for better precision:
+Zoom mode is **enabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
+
+To disable zoom for a specific find call, pass `zoom: false`:
 
 ```javascript
-// Enable zoom for better precision in crowded UIs
-const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar', { zoom: true });
+// Zoom is on by default — no option needed
+const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar');
 await extensionsBtn.click();
+
+// Disable zoom for a specific call if needed
+const largeButton = await testdriver.find('big hero button', { zoom: false });
 ```
 
 ### How Zoom Mode Works
@@ -352,22 +357,11 @@ await extensionsBtn.click();
 This two-phase approach gives the AI a higher-resolution view of the target area, improving accuracy when multiple similar elements are close together.
 
 <Tip>
-  Use `zoom: true` when:
-  - Clicking small icons in toolbars
-  - Selecting from a grid of similar items
-  - Targeting elements in dense UI areas
-  - The default locate is clicking the wrong similar element
-  - You get an AI verification rejection like "The crosshair is located in the empty space of the browser's tab bar/title bar area" — this means the initial locate was imprecise and zoom will help the AI pinpoint the correct element
+  You may want to disable zoom with `zoom: false` when:
+  - Targeting large, isolated elements where the extra precision isn't needed
+  - You want to speed up find calls in simple UIs
 </Tip>
 
-```javascript
-// Without zoom - may click wrong icon in toolbar
-const icon = await testdriver.find('settings icon');
-
-// With zoom - better precision for crowded areas
-const icon = await testdriver.find('settings icon', { zoom: true });
-```
-
 ## Cache Options
 
 Control caching behavior to optimize performance, especially when using dynamic variables in prompts.

package/docs/v7/find.mdx

@@ -50,8 +50,8 @@ const element = await testdriver.find(description, options)
       - `"any"` — No wrapping, uses the description as-is (default behavior)
     </ParamField>
     
-    <ParamField path="zoom" type="boolean" default={false}>
-      Enable two-phase zoom mode for better precision in crowded UIs with many similar elements.
+    <ParamField path="zoom" type="boolean" default={true}>
+      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Enabled by default.
     </ParamField>
     
     <ParamField path="ai" type="object">
@@ -333,14 +333,19 @@ The `timeout` option:
 - Returns the element (check `element.found()` if not throwing on failure)
 - Set to `0` to disable polling and make a single attempt
 
-## Zoom Mode for Crowded UIs
+## Zoom Mode
 
-When dealing with many similar icons or elements clustered together (like browser toolbars), enable `zoom` mode for better precision:
+Zoom mode is **enabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
+
+To disable zoom for a specific find call, pass `zoom: false`:
 
 ```javascript
-// Enable zoom for better precision in crowded UIs
-const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar', { zoom: true });
+// Zoom is on by default — no option needed
+const extensionsBtn = await testdriver.find('extensions puzzle icon in Chrome toolbar');
 await extensionsBtn.click();
+
+// Disable zoom for a specific call if needed
+const largeButton = await testdriver.find('big hero button', { zoom: false });
 ```
 
 ### How Zoom Mode Works
@@ -353,22 +358,11 @@ await extensionsBtn.click();
 This two-phase approach gives the AI a higher-resolution view of the target area, improving accuracy when multiple similar elements are close together.
 
 <Tip>
-  Use `zoom: true` when:
-  - Clicking small icons in toolbars
-  - Selecting from a grid of similar items
-  - Targeting elements in dense UI areas
-  - The default locate is clicking the wrong similar element
-  - You get an AI verification rejection like "The crosshair is located in the empty space of the browser's tab bar/title bar area" — this means the initial locate was imprecise and zoom will help the AI pinpoint the correct element
+  You may want to disable zoom with `zoom: false` when:
+  - Targeting large, isolated elements where the extra precision isn't needed
+  - You want to speed up find calls in simple UIs
 </Tip>
 
-```javascript
-// Without zoom - may click wrong icon in toolbar
-const icon = await testdriver.find('settings icon');
-
-// With zoom - better precision for crowded areas
-const icon = await testdriver.find('settings icon', { zoom: true });
-```
-
 ## Cache Options
 
 Control caching behavior to optimize performance, especially when using dynamic variables in prompts.

package/package.json

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

package/sdk.js

@@ -481,7 +481,7 @@ class Element {
       let cacheKey = null;
       let cacheThreshold = null;
       let perCommandThresholds = null; // Per-command { screen, element } override
-      let zoom = false; // Default to disabled, enable with zoom: true
+      let zoom = true; // Default to enabled
       let perCommandAi = null; // Per-command AI config override
 
       let minConfidence = null; // Minimum confidence threshold
@@ -494,8 +494,8 @@ class Element {
         // New: options is an object with cacheKey and/or cacheThreshold
         cacheKey = options.cacheKey || null;
         cacheThreshold = options.cacheThreshold ?? null;
-        // zoom defaults to false unless explicitly set to true
-        zoom = options.zoom === true;
+        // zoom defaults to true unless explicitly set to false
+        zoom = options.zoom !== false;
         // Minimum confidence threshold: fail find if AI confidence is below this value
         minConfidence = options.confidence ?? null;
         // Element type hint for prompt wrapping