@nuanu-ai/agentbrowse 0.2.40 → 0.2.41

package/dist/commands/click-action-executor.d.ts

@@ -5,6 +5,7 @@ type ClickRetryOptions = {
     beforeRetry?: () => Promise<void>;
     guards?: ActionExecutionGuards;
     clickActivationStrategy?: ClickActivationStrategy;
+    focusStrategy?: 'iframe-only' | 'active-control';
 };
 export declare function applyEditableClickAction(page: Page, locator: Locator, attempts: string[], options?: ClickRetryOptions): Promise<boolean>;
 export declare function applyTriggerAction(page: Page, locator: Locator, attempts: string[], options?: ClickRetryOptions): Promise<boolean>;

package/dist/commands/click-action-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"click-action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/click-action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD,CAAC;AA2GF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB"}
+{"version":3,"file":"click-action-executor.d.ts","sourceRoot":"","sources":["../../src/commands/click-action-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,KAAK,iBAAiB,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,aAAa,CAAC,EAAE,aAAa,GAAG,gBAAgB,CAAC;CAClD,CAAC;AA0LF,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC,CAKlB"}

package/dist/commands/click-action-executor.js

@@ -1,21 +1,74 @@
 import { LOCATOR_CLICK_TIMEOUT_MS, dismissBlockingOverlay, looksLikeOverlayInterference, } from './action-executor-helpers.js';
 import { runActionExecutionGuard } from './action-execution-guards.js';
-async function handoffFocusFromActiveIframe(locator, attempts) {
-    const focused = await locator
-        .evaluate((element) => {
-        if (!(element instanceof HTMLElement)) {
-            return false;
-        }
-        const active = element.ownerDocument.activeElement;
-        if (!(active instanceof HTMLIFrameElement)) {
-            return false;
-        }
-        element.focus();
-        return element.ownerDocument.activeElement === element;
-    })
-        .catch(() => false);
-    if (focused) {
-        attempts.push('locator.focus.handoff-from-iframe');
+const DEFAULT_FOCUS_ALIGNMENT_RESULT = {
+    focused: false,
+    kind: null,
+};
+function normalizeFocusAlignmentResult(result) {
+    if (result === true) {
+        return {
+            focused: true,
+            kind: 'iframe',
+        };
+    }
+    if (!result || typeof result !== 'object') {
+        return DEFAULT_FOCUS_ALIGNMENT_RESULT;
+    }
+    const candidate = result;
+    const focused = candidate.focused === true;
+    if (!focused) {
+        return DEFAULT_FOCUS_ALIGNMENT_RESULT;
+    }
+    return {
+        focused: true,
+        kind: candidate.kind === 'iframe' || candidate.kind === 'control' ? candidate.kind : 'control',
+    };
+}
+async function alignTargetFocusBeforeClick(locator, attempts, focusStrategy) {
+    const focusProbeResult = await (focusStrategy === 'iframe-only'
+        ? locator.evaluate((element) => {
+            if (!(element instanceof HTMLElement)) {
+                return { focused: false, kind: null };
+            }
+            const active = element.ownerDocument.activeElement;
+            if (!(active instanceof HTMLElement) || active === element) {
+                return { focused: false, kind: null };
+            }
+            if (active === element.ownerDocument.body ||
+                active === element.ownerDocument.documentElement ||
+                !(active instanceof HTMLIFrameElement)) {
+                return { focused: false, kind: null };
+            }
+            element.focus();
+            return {
+                focused: element.ownerDocument.activeElement === element,
+                kind: 'iframe',
+            };
+        })
+        : locator.evaluate((element) => {
+            if (!(element instanceof HTMLElement)) {
+                return { focused: false, kind: null };
+            }
+            const active = element.ownerDocument.activeElement;
+            if (!(active instanceof HTMLElement) || active === element) {
+                return { focused: false, kind: null };
+            }
+            if (active === element.ownerDocument.body ||
+                active === element.ownerDocument.documentElement) {
+                return { focused: false, kind: null };
+            }
+            const kind = active instanceof HTMLIFrameElement ? 'iframe' : 'control';
+            element.focus();
+            return {
+                focused: element.ownerDocument.activeElement === element,
+                kind,
+            };
+        })).catch(() => DEFAULT_FOCUS_ALIGNMENT_RESULT);
+    const focusResult = normalizeFocusAlignmentResult(focusProbeResult);
+    if (focusResult.focused) {
+        attempts.push(focusResult.kind === 'iframe'
+            ? 'locator.focus.handoff-from-iframe'
+            : 'locator.focus.before-click');
     }
 }
 async function ensureLocatorRetryReady(locator, error, options) {
@@ -27,7 +80,7 @@ async function ensureLocatorRetryReady(locator, error, options) {
     }
 }
 async function applyClickSequence(page, locator, attempts, options) {
-    await handoffFocusFromActiveIframe(locator, attempts);
+    await alignTargetFocusBeforeClick(locator, attempts, options?.focusStrategy ?? 'iframe-only');
     if (options?.clickActivationStrategy === 'dom') {
         await runActionExecutionGuard(options?.guards, 'click.evaluate.primary');
         attempts.push('locator.evaluate.click.primary');
@@ -91,8 +144,14 @@ async function applyClickSequence(page, locator, attempts, options) {
     }
 }
 export async function applyEditableClickAction(page, locator, attempts, options) {
-    return applyClickSequence(page, locator, attempts, options);
+    return applyClickSequence(page, locator, attempts, {
+        ...options,
+        focusStrategy: options?.focusStrategy ?? 'iframe-only',
+    });
 }
 export async function applyTriggerAction(page, locator, attempts, options) {
-    return applyClickSequence(page, locator, attempts, options);
+    return applyClickSequence(page, locator, attempts, {
+        ...options,
+        focusStrategy: options?.focusStrategy ?? 'active-control',
+    });
 }

package/dist/solver/browser-launcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../src/solver/browser-launcher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAsB,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBjF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAuBF,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC,CAmExB;AAkUD,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,CAGV"}
+{"version":3,"file":"browser-launcher.d.ts","sourceRoot":"","sources":["../../src/solver/browser-launcher.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAsB,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAkBjF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAuBF,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,EACpB,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,aAAa,CAAC,CAmExB;AAkUD,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,EAAE,CAGV"}

package/dist/solver/browser-launcher.js

@@ -9,6 +9,8 @@ const enhancedPuppeteer = puppeteerExtra;
 const solverStealthPlugin = StealthPlugin();
 // Some iframe-backed checkout flows break when this evasion runs on a connected real Chrome.
 solverStealthPlugin.enabledEvasions.delete('iframe.contentWindow');
+// We already pin the browser UA at launch time; this evasion races popup teardown on CI.
+solverStealthPlugin.enabledEvasions.delete('user-agent-override');
 enhancedPuppeteer.use(solverStealthPlugin);
 const AUTO_CDP_PORT = 0;
 const CDP_DISCOVERY_TIMEOUT_MS = 30_000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuanu-ai/agentbrowse",
-  "version": "0.2.40",
+  "version": "0.2.41",
   "type": "module",
   "description": "Browser automation CLI for AI agents: control a CDP browser, observe UI surfaces, act on refs, extract data, capture screenshots, complete protected fills, and solve captchas",
   "keywords": [