@hasna/browser 0.3.7 → 0.3.8

package/dist/mcp/index.js

@@ -10773,7 +10773,8 @@ function startHAR(page) {
       },
       timings: { send: 0, wait: duration, receive: 0 }
     };
-    entries.push(entry);
+    if (entries.length < HAR_MAX_ENTRIES)
+      entries.push(entry);
   };
   const onRequestFailed = (req) => {
     requestStart.delete(req.url() + req.method());
@@ -10798,6 +10799,7 @@ function startHAR(page) {
     }
   };
 }
+var HAR_MAX_ENTRIES = 5000;
 var init_network = __esm(() => {
   init_network_log();
 });
@@ -11200,337 +11202,6 @@ var init_storage_state = __esm(() => {
   STATES_DIR = join8(getDataDir2(), "states");
 });
 
-// src/lib/session.ts
-var exports_session = {};
-__export(exports_session, {
-  setSessionPage: () => setSessionPage,
-  renameSession: () => renameSession2,
-  listSessions: () => listSessions2,
-  isBunSession: () => isBunSession,
-  isAutoGallery: () => isAutoGallery,
-  hasActiveHandle: () => hasActiveHandle,
-  getTokenBudget: () => getTokenBudget,
-  getSessionPage: () => getSessionPage,
-  getSessionEngine: () => getSessionEngine,
-  getSessionByName: () => getSessionByName2,
-  getSessionBunView: () => getSessionBunView,
-  getSessionBrowser: () => getSessionBrowser,
-  getSession: () => getSession2,
-  getDefaultSession: () => getDefaultSession,
-  getActiveSessions: () => getActiveSessions,
-  getActiveSessionForAgent: () => getActiveSessionForAgent2,
-  createSession: () => createSession2,
-  countActiveSessions: () => countActiveSessions2,
-  closeSession: () => closeSession2,
-  closeAllSessions: () => closeAllSessions,
-  browserPool: () => pool
-});
-function createBunProxy(view) {
-  return view;
-}
-async function createSession2(opts = {}) {
-  if (opts.cdpUrl) {
-    const { connectToExistingBrowser: connectToExistingBrowser2 } = await Promise.resolve().then(() => (init_cdp(), exports_cdp));
-    const cdpBrowser = await connectToExistingBrowser2(opts.cdpUrl);
-    const contexts = cdpBrowser.contexts();
-    const context = contexts.length > 0 ? contexts[0] : await cdpBrowser.newContext();
-    const pages = context.pages();
-    const page2 = pages.length > 0 ? pages[0] : await context.newPage();
-    const session2 = createSession({
-      engine: "cdp",
-      projectId: opts.projectId,
-      agentId: opts.agentId,
-      startUrl: page2.url(),
-      name: opts.name ?? "attached"
-    });
-    const cleanups2 = [];
-    if (opts.captureNetwork !== false) {
-      try {
-        cleanups2.push(enableNetworkLogging(page2, session2.id));
-      } catch {}
-    }
-    if (opts.captureConsole !== false) {
-      try {
-        cleanups2.push(enableConsoleCapture(page2, session2.id));
-      } catch {}
-    }
-    try {
-      cleanups2.push(setupDialogHandler(page2, session2.id));
-    } catch {}
-    handles.set(session2.id, { browser: cdpBrowser, bunView: null, page: page2, engine: "cdp", cleanups: cleanups2, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
-    return { session: session2, page: page2 };
-  }
-  const engine = opts.engine === "auto" || !opts.engine ? selectEngine(opts.useCase ?? "spa_navigate" /* SPA_NAVIGATE */, opts.engine) : opts.engine;
-  const resolvedEngine = engine === "auto" ? "playwright" : engine;
-  let browser = null;
-  let bunView = null;
-  let page;
-  if (resolvedEngine === "bun") {
-    if (!isBunWebViewAvailable()) {
-      console.warn("[browser] Bun.WebView requested but not available \u2014 falling back to playwright. Run: bun upgrade --canary");
-      browser = await launchPlaywright({ headless: opts.headless ?? true, viewport: opts.viewport, userAgent: opts.userAgent });
-      page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
-    } else {
-      bunView = new BunWebViewSession({
-        width: opts.viewport?.width ?? 1280,
-        height: opts.viewport?.height ?? 720,
-        profile: opts.name ?? undefined
-      });
-      if (opts.stealth) {}
-      page = createBunProxy(bunView);
-    }
-  } else if (resolvedEngine === "lightpanda") {
-    browser = await connectLightpanda();
-    const context = await browser.newContext({ viewport: opts.viewport ?? { width: 1280, height: 720 } });
-    page = await context.newPage();
-  } else {
-    browser = await pool.acquire(opts.headless ?? true);
-    if (opts.storageState) {
-      const { loadStatePath: loadStatePath2 } = await Promise.resolve().then(() => (init_storage_state(), exports_storage_state));
-      const statePath2 = loadStatePath2(opts.storageState);
-      if (statePath2) {
-        const context = await browser.newContext({
-          viewport: opts.viewport ?? { width: 1280, height: 720 },
-          userAgent: opts.userAgent,
-          storageState: statePath2
-        });
-        page = await context.newPage();
-      } else {
-        page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
-      }
-    } else {
-      page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
-    }
-  }
-  const sessionName = opts.name ?? (opts.startUrl ? (() => {
-    try {
-      return new URL(opts.startUrl).hostname;
-    } catch {
-      return;
-    }
-  })() : undefined);
-  const session = createSession({
-    engine: bunView ? "bun" : browser ? resolvedEngine : resolvedEngine,
-    projectId: opts.projectId,
-    agentId: opts.agentId,
-    startUrl: opts.startUrl,
-    name: sessionName
-  });
-  if (opts.stealth && !bunView) {
-    try {
-      await applyStealthPatches(page);
-    } catch {}
-  }
-  const cleanups = [];
-  if (!bunView) {
-    if (opts.captureNetwork !== false) {
-      try {
-        cleanups.push(enableNetworkLogging(page, session.id));
-      } catch {}
-    }
-    if (opts.captureConsole !== false) {
-      try {
-        cleanups.push(enableConsoleCapture(page, session.id));
-      } catch {}
-    }
-    try {
-      cleanups.push(setupDialogHandler(page, session.id));
-    } catch {}
-  } else {
-    if (opts.captureConsole !== false) {
-      try {
-        const { logConsoleMessage: logConsoleMessage2 } = await Promise.resolve().then(() => (init_console_log(), exports_console_log));
-        await bunView.addInitScript(`
-          (() => {
-            const orig = { log: console.log, warn: console.warn, error: console.error, debug: console.debug, info: console.info };
-            ['log','warn','error','debug','info'].forEach(level => {
-              console[level] = (...args) => {
-                orig[level](...args);
-              };
-            });
-          })()
-        `);
-      } catch {}
-    }
-  }
-  handles.set(session.id, { browser, bunView, page, engine: bunView ? "bun" : resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
-  if (opts.startUrl) {
-    try {
-      if (bunView) {
-        await bunView.goto(opts.startUrl);
-      } else {
-        await page.goto(opts.startUrl, { waitUntil: "domcontentloaded" });
-      }
-    } catch {}
-  }
-  return { session, page };
-}
-function getSessionPage(sessionId) {
-  const handle = handles.get(sessionId);
-  if (!handle)
-    throw new SessionNotFoundError(sessionId);
-  try {
-    if (handle.bunView) {
-      handle.bunView.url();
-    } else {
-      handle.page.url();
-    }
-  } catch {
-    handles.delete(sessionId);
-    throw new SessionNotFoundError(sessionId);
-  }
-  handle.lastActivity = Date.now();
-  return handle.page;
-}
-function getSessionBunView(sessionId) {
-  return handles.get(sessionId)?.bunView ?? null;
-}
-function isBunSession(sessionId) {
-  return handles.get(sessionId)?.engine === "bun";
-}
-function getSessionBrowser(sessionId) {
-  const handle = handles.get(sessionId);
-  if (!handle)
-    throw new SessionNotFoundError(sessionId);
-  if (!handle.browser)
-    throw new BrowserError("This session uses Bun.WebView (no Playwright browser)", "NO_PLAYWRIGHT_BROWSER");
-  return handle.browser;
-}
-function getSessionEngine(sessionId) {
-  const handle = handles.get(sessionId);
-  if (!handle)
-    throw new SessionNotFoundError(sessionId);
-  return handle.engine;
-}
-function hasActiveHandle(sessionId) {
-  return handles.has(sessionId);
-}
-function setSessionPage(sessionId, page) {
-  const handle = handles.get(sessionId);
-  if (!handle)
-    throw new SessionNotFoundError(sessionId);
-  handle.page = page;
-}
-async function closeSession2(sessionId) {
-  const handle = handles.get(sessionId);
-  if (handle) {
-    for (const cleanup of handle.cleanups) {
-      try {
-        cleanup();
-      } catch {}
-    }
-    if (handle.bunView) {
-      try {
-        await handle.bunView.close();
-      } catch {}
-    } else {
-      try {
-        await handle.page.context().close();
-      } catch {}
-      if (handle.browser)
-        pool.release(handle.browser);
-    }
-    handles.delete(sessionId);
-  }
-  return closeSession(sessionId);
-}
-function getSession2(sessionId) {
-  return getSession(sessionId);
-}
-function listSessions2(filter) {
-  return listSessions(filter);
-}
-function getActiveSessions() {
-  return listSessions({ status: "active" });
-}
-async function closeAllSessions() {
-  for (const [id] of handles) {
-    await closeSession2(id).catch(() => {});
-  }
-  await pool.destroyAll();
-}
-function getSessionByName2(name) {
-  return getSessionByName(name);
-}
-function renameSession2(id, name) {
-  return renameSession(id, name);
-}
-function getTokenBudget(sessionId) {
-  const handle = handles.get(sessionId);
-  return handle ? handle.tokenBudget : null;
-}
-function getActiveSessionForAgent2(agentId) {
-  const session = getActiveSessionForAgent(agentId);
-  if (!session)
-    return null;
-  const handle = handles.get(session.id);
-  if (!handle)
-    return null;
-  try {
-    if (handle.bunView)
-      handle.bunView.url();
-    else
-      handle.page.url();
-  } catch {
-    handles.delete(session.id);
-    return null;
-  }
-  return { session, page: handle.page };
-}
-function getDefaultSession() {
-  const session = getDefaultActiveSession();
-  if (!session)
-    return null;
-  const handle = handles.get(session.id);
-  if (!handle)
-    return null;
-  try {
-    if (handle.bunView)
-      handle.bunView.url();
-    else
-      handle.page.url();
-  } catch {
-    handles.delete(session.id);
-    return null;
-  }
-  return { session, page: handle.page };
-}
-function isAutoGallery(sessionId) {
-  return handles.get(sessionId)?.autoGallery ?? false;
-}
-function countActiveSessions2() {
-  return countActiveSessions();
-}
-var handles, pool, SESSION_TTL_MS, ttlInterval;
-var init_session = __esm(() => {
-  init_types();
-  init_types();
-  init_sessions();
-  init_playwright();
-  init_lightpanda();
-  init_bun_webview();
-  init_selector();
-  init_network();
-  init_console();
-  init_stealth();
-  init_dialogs();
-  handles = new Map;
-  pool = new BrowserPool(5);
-  SESSION_TTL_MS = parseInt(process.env["SESSION_TTL_MINUTES"] ?? "10", 10) * 60000;
-  ttlInterval = setInterval(async () => {
-    const now = Date.now();
-    for (const [id, handle] of handles) {
-      if (now - handle.lastActivity > SESSION_TTL_MS) {
-        try {
-          await closeSession2(id);
-        } catch {}
-      }
-    }
-  }, 60000);
-  if (ttlInterval.unref)
-    ttlInterval.unref();
-});
-
 // src/lib/snapshot.ts
 var exports_snapshot = {};
 __export(exports_snapshot, {
@@ -11881,6 +11552,7 @@ __export(exports_actions, {
   typeRef: () => typeRef,
   type: () => type,
   stopWatch: () => stopWatch,
+  stopAllWatchesForSession: () => stopAllWatchesForSession,
   selectRef: () => selectRef,
   selectOption: () => selectOption,
   scrollTo: () => scrollTo,
@@ -12048,238 +11720,601 @@ async function waitForSelector(page, selector, opts) {
     throw new ElementNotFoundError(selector);
   }
 }
-async function waitForNavigation(page, timeout = 30000) {
+async function waitForNavigation(page, timeout = 30000) {
+  try {
+    await page.waitForLoadState("domcontentloaded", { timeout });
+  } catch (err) {
+    throw new NavigationError("navigation", err instanceof Error ? err.message : String(err));
+  }
+}
+async function pressKey(page, key) {
+  await page.keyboard.press(key);
+}
+async function withRetry(fn, opts) {
+  const retries = opts?.retries ?? 2;
+  const delay = opts?.delay ?? 300;
+  const retryOn = opts?.retryOn ?? RETRYABLE_ERRORS;
+  let lastErr;
+  for (let attempt = 0;attempt <= retries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastErr = err;
+      const msg = err instanceof Error ? err.message : String(err);
+      const shouldRetry = retryOn.some((pattern) => msg.includes(pattern));
+      if (!shouldRetry || err instanceof ElementNotFoundError)
+        throw err;
+      if (attempt < retries)
+        await new Promise((r) => setTimeout(r, delay));
+    }
+  }
+  throw lastErr;
+}
+async function clickText(page, text, opts) {
+  await withRetry(async () => {
+    try {
+      await page.getByText(text, { exact: opts?.exact ?? false }).first().click({ timeout: opts?.timeout ?? 1e4 });
+    } catch (err) {
+      throw new BrowserError(`clickText: could not find or click text "${text}": ${err instanceof Error ? err.message : String(err)}`, "CLICK_TEXT_FAILED");
+    }
+  }, { retries: opts?.retries ?? 1 });
+}
+async function fillForm(page, fields, submitSelector, selfHeal = true) {
+  let filled = 0;
+  const errors2 = [];
+  const healedFields = [];
+  for (const [selector, value] of Object.entries(fields)) {
+    try {
+      let el = await page.$(selector);
+      if (!el && selfHeal) {
+        const result = await healSelector(page, selector);
+        if (result.found && result.locator) {
+          const handle = await result.locator.elementHandle();
+          if (handle) {
+            el = handle;
+            healedFields.push(selector);
+            const tagName2 = await result.locator.evaluate((e) => e.tagName.toLowerCase());
+            const inputType2 = await result.locator.evaluate((e) => e.type?.toLowerCase() ?? "text");
+            if (tagName2 === "select") {
+              await result.locator.selectOption(String(value));
+            } else if (tagName2 === "input" && (inputType2 === "checkbox" || inputType2 === "radio")) {
+              if (Boolean(value))
+                await result.locator.check();
+              else
+                await result.locator.uncheck();
+            } else {
+              await result.locator.fill(String(value));
+            }
+            filled++;
+            continue;
+          }
+        }
+        errors2.push(`${selector}: element not found`);
+        continue;
+      }
+      if (!el) {
+        errors2.push(`${selector}: element not found`);
+        continue;
+      }
+      const tagName = await el.evaluate((e) => e.tagName.toLowerCase());
+      const inputType = await el.evaluate((e) => e.type?.toLowerCase() ?? "text");
+      if (tagName === "select") {
+        await page.selectOption(selector, String(value));
+      } else if (tagName === "input" && (inputType === "checkbox" || inputType === "radio")) {
+        const checked = Boolean(value);
+        if (checked) {
+          await page.check(selector);
+        } else {
+          await page.uncheck(selector);
+        }
+      } else {
+        await page.fill(selector, String(value));
+      }
+      filled++;
+    } catch (err) {
+      errors2.push(`${selector}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  if (submitSelector) {
+    try {
+      await page.click(submitSelector);
+    } catch (submitErr) {
+      if (selfHeal) {
+        const result = await healSelector(page, submitSelector);
+        if (result.found && result.locator) {
+          await result.locator.click();
+          healedFields.push(submitSelector);
+        } else {
+          errors2.push(`submit(${submitSelector}): ${submitErr instanceof Error ? submitErr.message : String(submitErr)}`);
+        }
+      } else {
+        errors2.push(`submit(${submitSelector}): ${submitErr instanceof Error ? submitErr.message : String(submitErr)}`);
+      }
+    }
+  }
+  return { filled, errors: errors2, fields_attempted: Object.keys(fields).length, ...healedFields.length > 0 ? { healed_fields: healedFields } : {} };
+}
+async function waitForText(page, text, opts) {
+  const timeout = opts?.timeout ?? 1e4;
+  try {
+    await page.getByText(text, { exact: opts?.exact ?? false }).first().waitFor({ state: "visible", timeout });
+  } catch (err) {
+    throw new ElementNotFoundError(`text:"${text}"`);
+  }
+}
+function watchPage(page, opts) {
+  const id = `watch-${Date.now()}`;
+  const changes = [];
+  const intervalMs = opts?.intervalMs ?? 500;
+  const maxChanges = opts?.maxChanges ?? 50;
+  const interval = setInterval(async () => {
+    if (changes.length >= maxChanges)
+      return;
+    try {
+      const change = await page.evaluate((sel) => {
+        const el = sel ? document.querySelector(sel) : document.body;
+        return el ? `${new Date().toISOString()}:${el.textContent?.slice(0, 100)}` : null;
+      }, opts?.selector ?? null);
+      if (change && (changes.length === 0 || changes[changes.length - 1] !== change)) {
+        changes.push(change);
+      }
+    } catch {}
+  }, intervalMs);
+  activeWatches.set(id, { interval, changes });
+  return {
+    id,
+    stop: () => {
+      clearInterval(interval);
+      activeWatches.delete(id);
+    }
+  };
+}
+function getWatchChanges(watchId) {
+  return activeWatches.get(watchId)?.changes ?? [];
+}
+function stopWatch(watchId) {
+  const w = activeWatches.get(watchId);
+  if (w) {
+    clearInterval(w.interval);
+    activeWatches.delete(watchId);
+  }
+}
+function stopAllWatchesForSession(_sessionId) {
+  for (const [id, w] of activeWatches) {
+    clearInterval(w.interval);
+    activeWatches.delete(id);
+  }
+}
+async function clickRef(page, sessionId, ref, opts) {
+  try {
+    const locator = getRefLocator(page, sessionId, ref);
+    await locator.click({ timeout: opts?.timeout ?? 1e4 });
+  } catch (err) {
+    if (err instanceof Error && err.message.includes("Ref "))
+      throw new ElementNotFoundError(ref);
+    if (err instanceof Error && err.message.includes("No snapshot"))
+      throw new BrowserError(err.message, "NO_SNAPSHOT");
+    throw new BrowserError(`clickRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "CLICK_REF_FAILED");
+  }
+}
+async function typeRef(page, sessionId, ref, text, opts) {
+  try {
+    const locator = getRefLocator(page, sessionId, ref);
+    if (opts?.clear)
+      await locator.fill("", { timeout: opts.timeout ?? 1e4 });
+    await locator.pressSequentially(text, { delay: opts?.delay, timeout: opts?.timeout ?? 1e4 });
+  } catch (err) {
+    if (err instanceof Error && err.message.includes("Ref "))
+      throw new ElementNotFoundError(ref);
+    throw new BrowserError(`typeRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "TYPE_REF_FAILED");
+  }
+}
+async function fillRef(page, sessionId, ref, value, timeout = 1e4) {
+  try {
+    const locator = getRefLocator(page, sessionId, ref);
+    await locator.fill(value, { timeout });
+  } catch (err) {
+    if (err instanceof Error && err.message.includes("Ref "))
+      throw new ElementNotFoundError(ref);
+    throw new BrowserError(`fillRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "FILL_REF_FAILED");
+  }
+}
+async function selectRef(page, sessionId, ref, value, timeout = 1e4) {
+  try {
+    const locator = getRefLocator(page, sessionId, ref);
+    return await locator.selectOption(value, { timeout });
+  } catch (err) {
+    if (err instanceof Error && err.message.includes("Ref "))
+      throw new ElementNotFoundError(ref);
+    throw new BrowserError(`selectRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "SELECT_REF_FAILED");
+  }
+}
+async function checkRef(page, sessionId, ref, checked, timeout = 1e4) {
+  try {
+    const locator = getRefLocator(page, sessionId, ref);
+    if (checked)
+      await locator.check({ timeout });
+    else
+      await locator.uncheck({ timeout });
+  } catch (err) {
+    if (err instanceof Error && err.message.includes("Ref "))
+      throw new ElementNotFoundError(ref);
+    throw new BrowserError(`checkRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "CHECK_REF_FAILED");
+  }
+}
+async function hoverRef(page, sessionId, ref, timeout = 1e4) {
   try {
-    await page.waitForLoadState("domcontentloaded", { timeout });
+    const locator = getRefLocator(page, sessionId, ref);
+    await locator.hover({ timeout });
   } catch (err) {
-    throw new NavigationError("navigation", err instanceof Error ? err.message : String(err));
+    if (err instanceof Error && err.message.includes("Ref "))
+      throw new ElementNotFoundError(ref);
+    throw new BrowserError(`hoverRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "HOVER_REF_FAILED");
   }
 }
-async function pressKey(page, key) {
-  await page.keyboard.press(key);
+var RETRYABLE_ERRORS, activeWatches;
+var init_actions = __esm(() => {
+  init_types();
+  init_snapshot();
+  RETRYABLE_ERRORS = ["Timeout", "timeout", "navigation", "net::ERR", "Target closed"];
+  activeWatches = new Map;
+});
+
+// src/lib/session.ts
+var exports_session = {};
+__export(exports_session, {
+  setSessionPage: () => setSessionPage,
+  renameSession: () => renameSession2,
+  listSessions: () => listSessions2,
+  isBunSession: () => isBunSession,
+  isAutoGallery: () => isAutoGallery,
+  hasActiveHandle: () => hasActiveHandle,
+  getTokenBudget: () => getTokenBudget,
+  getSessionPage: () => getSessionPage,
+  getSessionEngine: () => getSessionEngine,
+  getSessionByName: () => getSessionByName2,
+  getSessionBunView: () => getSessionBunView,
+  getSessionBrowser: () => getSessionBrowser,
+  getSession: () => getSession2,
+  getDefaultSession: () => getDefaultSession,
+  getActiveSessions: () => getActiveSessions,
+  getActiveSessionForAgent: () => getActiveSessionForAgent2,
+  createSession: () => createSession2,
+  countActiveSessions: () => countActiveSessions2,
+  closeSession: () => closeSession2,
+  closeAllSessions: () => closeAllSessions,
+  browserPool: () => pool
+});
+function createBunProxy(view) {
+  return view;
 }
-async function withRetry(fn, opts) {
-  const retries = opts?.retries ?? 2;
-  const delay = opts?.delay ?? 300;
-  const retryOn = opts?.retryOn ?? RETRYABLE_ERRORS;
-  let lastErr;
-  for (let attempt = 0;attempt <= retries; attempt++) {
+async function createSession2(opts = {}) {
+  if (opts.cdpUrl) {
+    const { connectToExistingBrowser: connectToExistingBrowser2 } = await Promise.resolve().then(() => (init_cdp(), exports_cdp));
+    const cdpBrowser = await connectToExistingBrowser2(opts.cdpUrl);
+    const contexts = cdpBrowser.contexts();
+    const context = contexts.length > 0 ? contexts[0] : await cdpBrowser.newContext();
+    const pages = context.pages();
+    const page2 = pages.length > 0 ? pages[0] : await context.newPage();
+    const session2 = createSession({
+      engine: "cdp",
+      projectId: opts.projectId,
+      agentId: opts.agentId,
+      startUrl: page2.url(),
+      name: opts.name ?? "attached"
+    });
+    const cleanups2 = [];
+    if (opts.captureNetwork !== false) {
+      try {
+        cleanups2.push(enableNetworkLogging(page2, session2.id));
+      } catch {}
+    }
+    if (opts.captureConsole !== false) {
+      try {
+        cleanups2.push(enableConsoleCapture(page2, session2.id));
+      } catch {}
+    }
     try {
-      return await fn();
-    } catch (err) {
-      lastErr = err;
-      const msg = err instanceof Error ? err.message : String(err);
-      const shouldRetry = retryOn.some((pattern) => msg.includes(pattern));
-      if (!shouldRetry || err instanceof ElementNotFoundError)
-        throw err;
-      if (attempt < retries)
-        await new Promise((r) => setTimeout(r, delay));
+      cleanups2.push(setupDialogHandler(page2, session2.id));
+    } catch {}
+    handles.set(session2.id, { browser: cdpBrowser, bunView: null, page: page2, engine: "cdp", cleanups: cleanups2, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
+    return { session: session2, page: page2 };
+  }
+  const engine = opts.engine === "auto" || !opts.engine ? selectEngine(opts.useCase ?? "spa_navigate" /* SPA_NAVIGATE */, opts.engine) : opts.engine;
+  const resolvedEngine = engine === "auto" ? "playwright" : engine;
+  let browser = null;
+  let bunView = null;
+  let page;
+  if (resolvedEngine === "bun") {
+    if (!isBunWebViewAvailable()) {
+      console.warn("[browser] Bun.WebView requested but not available \u2014 falling back to playwright. Run: bun upgrade --canary");
+      browser = await launchPlaywright({ headless: opts.headless ?? true, viewport: opts.viewport, userAgent: opts.userAgent });
+      page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
+    } else {
+      bunView = new BunWebViewSession({
+        width: opts.viewport?.width ?? 1280,
+        height: opts.viewport?.height ?? 720,
+        profile: opts.name ?? undefined
+      });
+      if (opts.stealth) {}
+      page = createBunProxy(bunView);
+    }
+  } else if (resolvedEngine === "lightpanda") {
+    browser = await connectLightpanda();
+    const context = await browser.newContext({ viewport: opts.viewport ?? { width: 1280, height: 720 } });
+    page = await context.newPage();
+  } else {
+    browser = await pool.acquire(opts.headless ?? true);
+    if (opts.storageState) {
+      const { loadStatePath: loadStatePath2 } = await Promise.resolve().then(() => (init_storage_state(), exports_storage_state));
+      const statePath2 = loadStatePath2(opts.storageState);
+      if (statePath2) {
+        const context = await browser.newContext({
+          viewport: opts.viewport ?? { width: 1280, height: 720 },
+          userAgent: opts.userAgent,
+          storageState: statePath2
+        });
+        page = await context.newPage();
+      } else {
+        page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
+      }
+    } else {
+      page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
     }
   }
-  throw lastErr;
-}
-async function clickText(page, text, opts) {
-  await withRetry(async () => {
+  const sessionName = opts.name ?? (opts.startUrl ? (() => {
     try {
-      await page.getByText(text, { exact: opts?.exact ?? false }).first().click({ timeout: opts?.timeout ?? 1e4 });
-    } catch (err) {
-      throw new BrowserError(`clickText: could not find or click text "${text}": ${err instanceof Error ? err.message : String(err)}`, "CLICK_TEXT_FAILED");
+      return new URL(opts.startUrl).hostname;
+    } catch {
+      return;
     }
-  }, { retries: opts?.retries ?? 1 });
-}
-async function fillForm(page, fields, submitSelector, selfHeal = true) {
-  let filled = 0;
-  const errors2 = [];
-  const healedFields = [];
-  for (const [selector, value] of Object.entries(fields)) {
+  })() : undefined);
+  const session = createSession({
+    engine: bunView ? "bun" : browser ? resolvedEngine : resolvedEngine,
+    projectId: opts.projectId,
+    agentId: opts.agentId,
+    startUrl: opts.startUrl,
+    name: sessionName
+  });
+  if (opts.stealth && !bunView) {
     try {
-      let el = await page.$(selector);
-      if (!el && selfHeal) {
-        const result = await healSelector(page, selector);
-        if (result.found && result.locator) {
-          const handle = await result.locator.elementHandle();
-          if (handle) {
-            el = handle;
-            healedFields.push(selector);
-            const tagName2 = await result.locator.evaluate((e) => e.tagName.toLowerCase());
-            const inputType2 = await result.locator.evaluate((e) => e.type?.toLowerCase() ?? "text");
-            if (tagName2 === "select") {
-              await result.locator.selectOption(String(value));
-            } else if (tagName2 === "input" && (inputType2 === "checkbox" || inputType2 === "radio")) {
-              if (Boolean(value))
-                await result.locator.check();
-              else
-                await result.locator.uncheck();
-            } else {
-              await result.locator.fill(String(value));
-            }
-            filled++;
-            continue;
-          }
-        }
-        errors2.push(`${selector}: element not found`);
-        continue;
-      }
-      if (!el) {
-        errors2.push(`${selector}: element not found`);
-        continue;
-      }
-      const tagName = await el.evaluate((e) => e.tagName.toLowerCase());
-      const inputType = await el.evaluate((e) => e.type?.toLowerCase() ?? "text");
-      if (tagName === "select") {
-        await page.selectOption(selector, String(value));
-      } else if (tagName === "input" && (inputType === "checkbox" || inputType === "radio")) {
-        const checked = Boolean(value);
-        if (checked) {
-          await page.check(selector);
-        } else {
-          await page.uncheck(selector);
-        }
-      } else {
-        await page.fill(selector, String(value));
-      }
-      filled++;
-    } catch (err) {
-      errors2.push(`${selector}: ${err instanceof Error ? err.message : String(err)}`);
+      await applyStealthPatches(page);
+    } catch {}
+  }
+  const cleanups = [];
+  if (!bunView) {
+    if (opts.captureNetwork !== false) {
+      try {
+        cleanups.push(enableNetworkLogging(page, session.id));
+      } catch {}
+    }
+    if (opts.captureConsole !== false) {
+      try {
+        cleanups.push(enableConsoleCapture(page, session.id));
+      } catch {}
+    }
+    try {
+      cleanups.push(setupDialogHandler(page, session.id));
+    } catch {}
+  } else {
+    if (opts.captureConsole !== false) {
+      try {
+        const { logConsoleMessage: logConsoleMessage2 } = await Promise.resolve().then(() => (init_console_log(), exports_console_log));
+        await bunView.addInitScript(`
+          (() => {
+            const orig = { log: console.log, warn: console.warn, error: console.error, debug: console.debug, info: console.info };
+            ['log','warn','error','debug','info'].forEach(level => {
+              console[level] = (...args) => {
+                orig[level](...args);
+              };
+            });
+          })()
+        `);
+      } catch {}
     }
   }
-  if (submitSelector) {
+  handles.set(session.id, { browser, bunView, page, engine: bunView ? "bun" : resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
+  if (opts.startUrl) {
     try {
-      await page.click(submitSelector);
-    } catch (submitErr) {
-      if (selfHeal) {
-        const result = await healSelector(page, submitSelector);
-        if (result.found && result.locator) {
-          await result.locator.click();
-          healedFields.push(submitSelector);
-        } else {
-          errors2.push(`submit(${submitSelector}): ${submitErr instanceof Error ? submitErr.message : String(submitErr)}`);
-        }
+      if (bunView) {
+        await bunView.goto(opts.startUrl);
       } else {
-        errors2.push(`submit(${submitSelector}): ${submitErr instanceof Error ? submitErr.message : String(submitErr)}`);
+        await page.goto(opts.startUrl, { waitUntil: "domcontentloaded" });
       }
-    }
+    } catch {}
   }
-  return { filled, errors: errors2, fields_attempted: Object.keys(fields).length, ...healedFields.length > 0 ? { healed_fields: healedFields } : {} };
+  return { session, page };
 }
-async function waitForText(page, text, opts) {
-  const timeout = opts?.timeout ?? 1e4;
+function getSessionPage(sessionId) {
+  const handle = handles.get(sessionId);
+  if (!handle)
+    throw new SessionNotFoundError(sessionId);
   try {
-    await page.getByText(text, { exact: opts?.exact ?? false }).first().waitFor({ state: "visible", timeout });
-  } catch (err) {
-    throw new ElementNotFoundError(`text:"${text}"`);
+    if (handle.bunView) {
+      handle.bunView.url();
+    } else {
+      handle.page.url();
+    }
+  } catch {
+    handles.delete(sessionId);
+    throw new SessionNotFoundError(sessionId);
   }
+  handle.lastActivity = Date.now();
+  return handle.page;
 }
-function watchPage(page, opts) {
-  const id = `watch-${Date.now()}`;
-  const changes = [];
-  const intervalMs = opts?.intervalMs ?? 500;
-  const maxChanges = opts?.maxChanges ?? 50;
-  const interval = setInterval(async () => {
-    if (changes.length >= maxChanges)
-      return;
-    try {
-      const change = await page.evaluate((sel) => {
-        const el = sel ? document.querySelector(sel) : document.body;
-        return el ? `${new Date().toISOString()}:${el.textContent?.slice(0, 100)}` : null;
-      }, opts?.selector ?? null);
-      if (change && (changes.length === 0 || changes[changes.length - 1] !== change)) {
-        changes.push(change);
-      }
-    } catch {}
-  }, intervalMs);
-  activeWatches.set(id, { interval, changes });
-  return {
-    id,
-    stop: () => {
-      clearInterval(interval);
-      activeWatches.delete(id);
-    }
-  };
+function getSessionBunView(sessionId) {
+  return handles.get(sessionId)?.bunView ?? null;
 }
-function getWatchChanges(watchId) {
-  return activeWatches.get(watchId)?.changes ?? [];
+function isBunSession(sessionId) {
+  return handles.get(sessionId)?.engine === "bun";
 }
-function stopWatch(watchId) {
-  const w = activeWatches.get(watchId);
-  if (w) {
-    clearInterval(w.interval);
-    activeWatches.delete(watchId);
-  }
+function getSessionBrowser(sessionId) {
+  const handle = handles.get(sessionId);
+  if (!handle)
+    throw new SessionNotFoundError(sessionId);
+  if (!handle.browser)
+    throw new BrowserError("This session uses Bun.WebView (no Playwright browser)", "NO_PLAYWRIGHT_BROWSER");
+  return handle.browser;
 }
-async function clickRef(page, sessionId, ref, opts) {
-  try {
-    const locator = getRefLocator(page, sessionId, ref);
-    await locator.click({ timeout: opts?.timeout ?? 1e4 });
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("Ref "))
-      throw new ElementNotFoundError(ref);
-    if (err instanceof Error && err.message.includes("No snapshot"))
-      throw new BrowserError(err.message, "NO_SNAPSHOT");
-    throw new BrowserError(`clickRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "CLICK_REF_FAILED");
-  }
+function getSessionEngine(sessionId) {
+  const handle = handles.get(sessionId);
+  if (!handle)
+    throw new SessionNotFoundError(sessionId);
+  return handle.engine;
 }
-async function typeRef(page, sessionId, ref, text, opts) {
-  try {
-    const locator = getRefLocator(page, sessionId, ref);
-    if (opts?.clear)
-      await locator.fill("", { timeout: opts.timeout ?? 1e4 });
-    await locator.pressSequentially(text, { delay: opts?.delay, timeout: opts?.timeout ?? 1e4 });
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("Ref "))
-      throw new ElementNotFoundError(ref);
-    throw new BrowserError(`typeRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "TYPE_REF_FAILED");
-  }
+function hasActiveHandle(sessionId) {
+  return handles.has(sessionId);
 }
-async function fillRef(page, sessionId, ref, value, timeout = 1e4) {
-  try {
-    const locator = getRefLocator(page, sessionId, ref);
-    await locator.fill(value, { timeout });
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("Ref "))
-      throw new ElementNotFoundError(ref);
-    throw new BrowserError(`fillRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "FILL_REF_FAILED");
-  }
+function setSessionPage(sessionId, page) {
+  const handle = handles.get(sessionId);
+  if (!handle)
+    throw new SessionNotFoundError(sessionId);
+  handle.page = page;
 }
-async function selectRef(page, sessionId, ref, value, timeout = 1e4) {
+async function closeSession2(sessionId) {
+  const handle = handles.get(sessionId);
+  if (handle) {
+    for (const cleanup of handle.cleanups) {
+      try {
+        cleanup();
+      } catch {}
+    }
+    if (handle.bunView) {
+      try {
+        await handle.bunView.close();
+      } catch {}
+    } else {
+      try {
+        await handle.page.context().close();
+      } catch {}
+      if (handle.browser)
+        pool.release(handle.browser);
+    }
+    handles.delete(sessionId);
+  }
   try {
-    const locator = getRefLocator(page, sessionId, ref);
-    return await locator.selectOption(value, { timeout });
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("Ref "))
-      throw new ElementNotFoundError(ref);
-    throw new BrowserError(`selectRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "SELECT_REF_FAILED");
+    const { clearLastSnapshot: clearLastSnapshot2, clearSessionRefs: clearSessionRefs2 } = await Promise.resolve().then(() => (init_snapshot(), exports_snapshot));
+    clearLastSnapshot2(sessionId);
+    clearSessionRefs2(sessionId);
+  } catch {}
+  try {
+    const { stopAllWatchesForSession: stopAllWatchesForSession2 } = await Promise.resolve().then(() => (init_actions(), exports_actions));
+    stopAllWatchesForSession2(sessionId);
+  } catch {}
+  try {
+    const { clearDialogs: clearDialogs2 } = await Promise.resolve().then(() => (init_dialogs(), exports_dialogs));
+    clearDialogs2(sessionId);
+  } catch {}
+  return closeSession(sessionId);
+}
+function getSession2(sessionId) {
+  return getSession(sessionId);
+}
+function listSessions2(filter) {
+  return listSessions(filter);
+}
+function getActiveSessions() {
+  return listSessions({ status: "active" });
+}
+async function closeAllSessions() {
+  for (const [id] of handles) {
+    await closeSession2(id).catch(() => {});
   }
+  await pool.destroyAll();
 }
-async function checkRef(page, sessionId, ref, checked, timeout = 1e4) {
+function getSessionByName2(name) {
+  return getSessionByName(name);
+}
+function renameSession2(id, name) {
+  return renameSession(id, name);
+}
+function getTokenBudget(sessionId) {
+  const handle = handles.get(sessionId);
+  return handle ? handle.tokenBudget : null;
+}
+function getActiveSessionForAgent2(agentId) {
+  const session = getActiveSessionForAgent(agentId);
+  if (!session)
+    return null;
+  const handle = handles.get(session.id);
+  if (!handle)
+    return null;
   try {
-    const locator = getRefLocator(page, sessionId, ref);
-    if (checked)
-      await locator.check({ timeout });
+    if (handle.bunView)
+      handle.bunView.url();
     else
-      await locator.uncheck({ timeout });
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("Ref "))
-      throw new ElementNotFoundError(ref);
-    throw new BrowserError(`checkRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "CHECK_REF_FAILED");
+      handle.page.url();
+  } catch {
+    handles.delete(session.id);
+    return null;
   }
+  return { session, page: handle.page };
 }
-async function hoverRef(page, sessionId, ref, timeout = 1e4) {
+function getDefaultSession() {
+  const session = getDefaultActiveSession();
+  if (!session)
+    return null;
+  const handle = handles.get(session.id);
+  if (!handle)
+    return null;
   try {
-    const locator = getRefLocator(page, sessionId, ref);
-    await locator.hover({ timeout });
-  } catch (err) {
-    if (err instanceof Error && err.message.includes("Ref "))
-      throw new ElementNotFoundError(ref);
-    throw new BrowserError(`hoverRef ${ref} failed: ${err instanceof Error ? err.message : String(err)}`, "HOVER_REF_FAILED");
+    if (handle.bunView)
+      handle.bunView.url();
+    else
+      handle.page.url();
+  } catch {
+    handles.delete(session.id);
+    return null;
   }
+  return { session, page: handle.page };
 }
-var RETRYABLE_ERRORS, activeWatches;
-var init_actions = __esm(() => {
+function isAutoGallery(sessionId) {
+  return handles.get(sessionId)?.autoGallery ?? false;
+}
+function countActiveSessions2() {
+  return countActiveSessions();
+}
+var handles, pool, SESSION_TTL_MS, ttlInterval, DB_PRUNE_INTERVAL_MS, DB_RETENTION_HOURS = 24, dbPruneInterval;
+var init_session = __esm(() => {
   init_types();
-  init_snapshot();
-  RETRYABLE_ERRORS = ["Timeout", "timeout", "navigation", "net::ERR", "Target closed"];
-  activeWatches = new Map;
+  init_types();
+  init_sessions();
+  init_playwright();
+  init_lightpanda();
+  init_bun_webview();
+  init_selector();
+  init_network();
+  init_console();
+  init_stealth();
+  init_dialogs();
+  handles = new Map;
+  pool = new BrowserPool(5);
+  SESSION_TTL_MS = parseInt(process.env["SESSION_TTL_MINUTES"] ?? "10", 10) * 60000;
+  ttlInterval = setInterval(async () => {
+    const now = Date.now();
+    for (const [id, handle] of handles) {
+      if (now - handle.lastActivity > SESSION_TTL_MS) {
+        try {
+          await closeSession2(id);
+        } catch {}
+      }
+    }
+  }, 60000);
+  if (ttlInterval.unref)
+    ttlInterval.unref();
+  DB_PRUNE_INTERVAL_MS = 30 * 60000;
+  dbPruneInterval = setInterval(() => {
+    try {
+      const { getDatabase: getDatabase2 } = (init_schema(), __toCommonJS(exports_schema));
+      const db = getDatabase2();
+      const cutoff = new Date(Date.now() - DB_RETENTION_HOURS * 3600000).toISOString();
+      db.prepare("DELETE FROM network_log WHERE session_id IN (SELECT id FROM sessions WHERE status != 'active') AND timestamp < ?").run(cutoff);
+      db.prepare("DELETE FROM console_log WHERE session_id IN (SELECT id FROM sessions WHERE status != 'active') AND timestamp < ?").run(cutoff);
+      db.prepare("DELETE FROM snapshots WHERE session_id IN (SELECT id FROM sessions WHERE status != 'active') AND timestamp < ?").run(cutoff);
+    } catch {}
+  }, DB_PRUNE_INTERVAL_MS);
+  if (dbPruneInterval.unref)
+    dbPruneInterval.unref();
 });
 
 // src/lib/extractor.ts
@@ -28477,6 +28512,11 @@ async function rememberPage(url, facts, tags) {
       return;
     } catch {}
   }
+  if (inMemoryCache.size >= MEMORY_MAX_SIZE && !inMemoryCache.has(key)) {
+    const firstKey = inMemoryCache.keys().next().value;
+    if (firstKey)
+      inMemoryCache.delete(firstKey);
+  }
   inMemoryCache.set(key, {
     data: memory,
     expires: Date.now() + DEFAULT_TTL_HOURS * 60 * 60 * 1000
@@ -28506,9 +28546,18 @@ async function forgetPage(url) {
   const key = cacheKey(url);
   inMemoryCache.delete(key);
 }
-var MEMORY_KEY_PREFIX = "browser-page:", DEFAULT_TTL_HOURS = 24, inMemoryCache;
+var MEMORY_KEY_PREFIX = "browser-page:", DEFAULT_TTL_HOURS = 24, inMemoryCache, MEMORY_MAX_SIZE = 200, _memorySweeper;
 var init_page_memory = __esm(() => {
   inMemoryCache = new Map;
+  _memorySweeper = setInterval(() => {
+    const now2 = Date.now();
+    for (const [key, entry] of inMemoryCache) {
+      if (entry.expires <= now2)
+        inMemoryCache.delete(key);
+    }
+  }, 300000);
+  if (_memorySweeper.unref)
+    _memorySweeper.unref();
 });
 
 // node_modules/@hasna/conversations/dist/index.js
@@ -32972,6 +33021,11 @@ async function announceNavigation(url, sessionId, agentName = "browser-agent") {
       await sdk.sendMessage(SPACE_NAME, `\uD83C\uDF10 Navigating to ${hostname} (session: ${sessionId.slice(0, 8)})`);
     } catch {}
   }
+  if (activeNavigations.size >= NAV_MAX_SIZE && !activeNavigations.has(hostname)) {
+    const firstKey = activeNavigations.keys().next().value;
+    if (firstKey)
+      activeNavigations.delete(firstKey);
+  }
   activeNavigations.set(hostname, { agentName, timestamp: Date.now() });
 }
 async function checkDuplicate2(url) {
@@ -33007,10 +33061,19 @@ async function checkDuplicate2(url) {
   }
   return { is_duplicate: false };
 }
-var SPACE_NAME = "browser", DUPLICATE_WINDOW_MS, activeNavigations;
+var SPACE_NAME = "browser", DUPLICATE_WINDOW_MS, activeNavigations, NAV_MAX_SIZE = 200, _navSweeper;
 var init_coordination = __esm(() => {
   DUPLICATE_WINDOW_MS = 5 * 60 * 1000;
   activeNavigations = new Map;
+  _navSweeper = setInterval(() => {
+    const cutoff = Date.now() - DUPLICATE_WINDOW_MS;
+    for (const [key, entry] of activeNavigations) {
+      if (entry.timestamp < cutoff)
+        activeNavigations.delete(key);
+    }
+  }, 120000);
+  if (_navSweeper.unref)
+    _navSweeper.unref();
 });
 
 // node_modules/@hasna/todos/dist/index.js
@@ -38613,6 +38676,8 @@ Skill: ${task.skill}` : ""}`,
       };
     } catch {}
   }
+  if (inMemoryQueue.length >= QUEUE_MAX_SIZE)
+    inMemoryQueue.shift();
   const id = `btask-${Date.now()}`;
   const entry = { ...task, id, status: "pending", created_at: new Date().toISOString() };
   inMemoryQueue.push(entry);
@@ -38646,7 +38711,7 @@ async function completeBrowserTask(taskId, result) {
   if (idx >= 0)
     inMemoryQueue.splice(idx, 1);
 }
-var inMemoryQueue;
+var QUEUE_MAX_SIZE = 100, inMemoryQueue;
 var init_task_queue = __esm(() => {
   inMemoryQueue = [];
 });