browserclaw 0.5.1 → 0.5.3

package/dist/index.cjs

@@ -841,6 +841,7 @@ async function connectBrowser(cdpUrl, authToken) {
         return connected;
       } catch (err) {
         lastErr = err;
+        if ((err instanceof Error ? err.message : String(err)).includes("rate limit")) break;
         await new Promise((r) => setTimeout(r, 250 + attempt * 250));
       }
     }
@@ -866,6 +867,55 @@ async function disconnectBrowser() {
   if (cur) await cur.browser.close().catch(() => {
   });
 }
+async function tryTerminateExecutionViaCdp(cdpUrl, targetId) {
+  const httpBase = normalizeCdpHttpBaseForJsonEndpoints(cdpUrl);
+  const ctrl = new AbortController();
+  const t = setTimeout(() => ctrl.abort(), 2e3);
+  let targets;
+  try {
+    const res = await fetch(`${httpBase}/json/list`, { signal: ctrl.signal });
+    if (!res.ok) return;
+    targets = await res.json();
+  } catch {
+    return;
+  } finally {
+    clearTimeout(t);
+  }
+  if (!Array.isArray(targets)) return;
+  const target = targets.find((entry) => String(entry?.id ?? "").trim() === targetId);
+  const wsUrl = String(target?.webSocketDebuggerUrl ?? "").trim();
+  if (!wsUrl) return;
+  await new Promise((resolve2) => {
+    let done = false;
+    const finish = () => {
+      if (done) return;
+      done = true;
+      clearTimeout(timer);
+      try {
+        ws.close();
+      } catch {
+      }
+      resolve2();
+    };
+    const timer = setTimeout(finish, 2e3);
+    let ws;
+    try {
+      ws = new WebSocket(wsUrl);
+    } catch {
+      finish();
+      return;
+    }
+    ws.onopen = () => {
+      try {
+        ws.send(JSON.stringify({ id: 1, method: "Runtime.terminateExecution" }));
+      } catch {
+      }
+      setTimeout(finish, 300);
+    };
+    ws.onerror = () => finish();
+    ws.onclose = () => finish();
+  });
+}
 async function forceDisconnectPlaywrightForTarget(opts) {
   const normalized = normalizeCdpUrl(opts.cdpUrl);
   const cur = cached;
@@ -874,23 +924,8 @@ async function forceDisconnectPlaywrightForTarget(opts) {
   connectingByUrl.delete(normalized);
   const targetId = opts.targetId?.trim() || "";
   if (targetId) {
-    try {
-      const pages = await getAllPages(cur.browser);
-      for (const page of pages) {
-        const tid = await pageTargetId(page).catch(() => null);
-        if (tid === targetId) {
-          const session = await page.context().newCDPSession(page);
-          try {
-            await session.send("Runtime.terminateExecution");
-          } finally {
-            await session.detach().catch(() => {
-            });
-          }
-          break;
-        }
-      }
-    } catch {
-    }
+    await tryTerminateExecutionViaCdp(normalized, targetId).catch(() => {
+    });
   }
   cur.browser.close().catch(() => {
   });
@@ -922,33 +957,37 @@ async function findPageByTargetId(browser, targetId, cdpUrl) {
     }
     if (tid && tid === targetId) return page;
   }
-  if (!resolvedViaCdp && pages.length === 1) {
-    return pages[0];
-  }
   if (cdpUrl) {
     try {
       const listUrl = `${normalizeCdpHttpBaseForJsonEndpoints(cdpUrl)}/json/list`;
       const headers = {};
       if (cached?.authToken) headers["Authorization"] = `Bearer ${cached.authToken}`;
-      const response = await fetch(listUrl, { headers });
-      if (response.ok) {
-        const targets = await response.json();
-        const target = targets.find((t) => t.id === targetId);
-        if (target) {
-          const urlMatch = pages.filter((p) => p.url() === target.url);
-          if (urlMatch.length === 1) return urlMatch[0];
-          if (urlMatch.length > 1) {
-            const sameUrlTargets = targets.filter((t) => t.url === target.url);
-            if (sameUrlTargets.length === urlMatch.length) {
-              const idx = sameUrlTargets.findIndex((t) => t.id === targetId);
-              if (idx >= 0 && idx < urlMatch.length) return urlMatch[idx];
+      const ctrl = new AbortController();
+      const t = setTimeout(() => ctrl.abort(), 2e3);
+      try {
+        const response = await fetch(listUrl, { headers, signal: ctrl.signal });
+        if (response.ok) {
+          const targets = await response.json();
+          const target = targets.find((entry) => entry.id === targetId);
+          if (target) {
+            const urlMatch = pages.filter((p) => p.url() === target.url);
+            if (urlMatch.length === 1) return urlMatch[0];
+            if (urlMatch.length > 1) {
+              const sameUrlTargets = targets.filter((entry) => entry.url === target.url);
+              if (sameUrlTargets.length === urlMatch.length) {
+                const idx = sameUrlTargets.findIndex((entry) => entry.id === targetId);
+                if (idx >= 0 && idx < urlMatch.length) return urlMatch[idx];
+              }
             }
           }
         }
+      } finally {
+        clearTimeout(t);
       }
     } catch {
     }
   }
+  if (!resolvedViaCdp && pages.length === 1) return pages[0];
   return null;
 }
 async function getPageForTargetId(opts) {
@@ -1312,6 +1351,35 @@ async function snapshotRole(opts) {
   const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
   ensurePageState(page);
   const sourceUrl = page.url();
+  if (opts.refsMode === "aria") {
+    if (opts.selector?.trim() || opts.frameSelector?.trim()) {
+      throw new Error("refs=aria does not support selector/frame snapshots yet.");
+    }
+    const maybe = page;
+    if (!maybe._snapshotForAI) {
+      throw new Error("refs=aria requires Playwright _snapshotForAI support.");
+    }
+    const result = await maybe._snapshotForAI({ timeout: 5e3, track: "response" });
+    const built2 = buildRoleSnapshotFromAiSnapshot(String(result?.full ?? ""), opts.options);
+    storeRoleRefsForTarget({
+      page,
+      cdpUrl: opts.cdpUrl,
+      targetId: opts.targetId,
+      refs: built2.refs,
+      mode: "aria"
+    });
+    return {
+      snapshot: built2.snapshot,
+      refs: built2.refs,
+      stats: getRoleSnapshotStats(built2.snapshot, built2.refs),
+      untrusted: true,
+      contentMeta: {
+        sourceUrl,
+        contentType: "browser-snapshot",
+        capturedAt: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    };
+  }
   const frameSelector = opts.frameSelector?.trim() || "";
   const selector = opts.selector?.trim() || "";
   const locator = frameSelector ? selector ? page.frameLocator(frameSelector).locator(selector) : page.frameLocator(frameSelector).locator(":root") : selector ? page.locator(selector) : page.locator(":root");
@@ -1323,7 +1391,7 @@ async function snapshotRole(opts) {
     targetId: opts.targetId,
     refs: built.refs,
     frameSelector: frameSelector || void 0,
-    mode: opts.refsMode ?? "role"
+    mode: "role"
   });
   return {
     snapshot: built.snapshot,
@@ -1411,7 +1479,7 @@ var InvalidBrowserNavigationUrlError = class extends Error {
   }
 };
 function withBrowserNavigationPolicy(ssrfPolicy) {
-  return { ssrfPolicy };
+  return ssrfPolicy ? { ssrfPolicy } : {};
 }
 var NETWORK_NAVIGATION_PROTOCOLS = /* @__PURE__ */ new Set(["http:", "https:"]);
 var SAFE_NON_NETWORK_URLS = /* @__PURE__ */ new Set(["about:blank"]);
@@ -1524,6 +1592,14 @@ function extractEmbeddedIpv4FromIpv6(v6, opts) {
       return true;
     }
   }
+  if (parts[0] === 0 && parts[1] === 0 && parts[2] === 0 && parts[3] === 0 && parts[4] === 65535 && parts[5] === 0) {
+    const ip4str = `${parts[6] >> 8 & 255}.${parts[6] & 255}.${parts[7] >> 8 & 255}.${parts[7] & 255}`;
+    try {
+      return isBlockedSpecialUseIpv4Address(ipaddr__namespace.IPv4.parse(ip4str), opts);
+    } catch {
+      return true;
+    }
+  }
   if (parts[0] === 0 && parts[1] === 0 && parts[2] === 0 && parts[3] === 0 && parts[4] === 0 && parts[5] === 0) {
     const ip4str = `${parts[6] >> 8 & 255}.${parts[6] & 255}.${parts[7] >> 8 & 255}.${parts[7] & 255}`;
     try {
@@ -1840,6 +1916,13 @@ function requiresInspectableBrowserNavigationRedirects(ssrfPolicy) {
 }
 
 // src/actions/interaction.ts
+var MAX_CLICK_DELAY_MS = 5e3;
+function resolveBoundedDelayMs(value, label, maxMs) {
+  const normalized = Math.floor(value ?? 0);
+  if (!Number.isFinite(normalized) || normalized < 0) throw new Error(`${label} must be >= 0`);
+  if (normalized > maxMs) throw new Error(`${label} exceeds maximum of ${maxMs}ms`);
+  return normalized;
+}
 async function clickViaPlaywright(opts) {
   const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
   ensurePageState(page);
@@ -1847,6 +1930,11 @@ async function clickViaPlaywright(opts) {
   const locator = refLocator(page, opts.ref);
   const timeout = normalizeTimeoutMs(opts.timeoutMs, 8e3, 6e4);
   try {
+    const delayMs = resolveBoundedDelayMs(opts.delayMs, "click delayMs", MAX_CLICK_DELAY_MS);
+    if (delayMs > 0) {
+      await locator.hover({ timeout });
+      await new Promise((resolve2) => setTimeout(resolve2, delayMs));
+    }
     if (opts.doubleClick) {
       await locator.dblclick({ timeout, button: opts.button, modifiers: opts.modifiers });
     } else {
@@ -2157,12 +2245,14 @@ async function resizeViewportViaPlaywright(opts) {
 }
 
 // src/actions/wait.ts
+var MAX_WAIT_TIME_MS = 3e4;
 async function waitForViaPlaywright(opts) {
   const page = await getPageForTargetId({ cdpUrl: opts.cdpUrl, targetId: opts.targetId });
   ensurePageState(page);
   const timeout = normalizeTimeoutMs(opts.timeoutMs, 2e4);
   if (typeof opts.timeMs === "number" && Number.isFinite(opts.timeMs)) {
-    await page.waitForTimeout(Math.max(0, opts.timeMs));
+    const bounded = Math.max(0, Math.min(MAX_WAIT_TIME_MS, Math.floor(opts.timeMs)));
+    await page.waitForTimeout(bounded);
   }
   if (opts.text) {
     await page.getByText(opts.text).first().waitFor({ state: "visible", timeout });
@@ -2851,6 +2941,7 @@ var CrawlPage = class {
       doubleClick: opts?.doubleClick,
       button: opts?.button,
       modifiers: opts?.modifiers,
+      delayMs: opts?.delayMs,
       timeoutMs: opts?.timeoutMs
     });
   }