@hasna/browser 0.0.4 → 0.0.5

package/dist/cli/index.js

@@ -2515,11 +2515,420 @@ var init_lightpanda = __esm(() => {
   LIGHTPANDA_BINARY = process.env["LIGHTPANDA_BINARY"] ?? "lightpanda";
 });
 
+// src/engines/bun-webview.ts
+import { join as join2 } from "path";
+import { mkdirSync as mkdirSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+function isBunWebViewAvailable() {
+  return typeof globalThis.Bun !== "undefined" && typeof globalThis.Bun.WebView !== "undefined";
+}
+function getProfileDir(profileName) {
+  const base = process.env["BROWSER_DATA_DIR"] ?? join2(homedir2(), ".browser");
+  const dir = join2(base, "profiles", profileName);
+  mkdirSync2(dir, { recursive: true });
+  return dir;
+}
+var BunWebViewSession;
+var init_bun_webview = __esm(() => {
+  BunWebViewSession = class BunWebViewSession {
+    view;
+    _sessionId;
+    _eventListeners = new Map;
+    constructor(opts = {}) {
+      if (!isBunWebViewAvailable()) {
+        throw new Error("Bun.WebView is not available. Install Bun canary: bun upgrade --canary");
+      }
+      const BunWebView = globalThis.Bun.WebView;
+      const constructorOpts = {
+        width: opts.width ?? 1280,
+        height: opts.height ?? 720
+      };
+      if (opts.profile) {
+        constructorOpts.dataStore = { directory: getProfileDir(opts.profile) };
+      } else {
+        constructorOpts.dataStore = "ephemeral";
+      }
+      if (opts.onConsole) {
+        constructorOpts.console = opts.onConsole;
+      }
+      this.view = new BunWebView(constructorOpts);
+      this.view.onNavigated = (url) => {
+        this._emit("navigated", url);
+      };
+      this.view.onNavigationFailed = (error) => {
+        this._emit("navigationfailed", error);
+      };
+    }
+    async goto(url, opts) {
+      await this.view.navigate(url);
+      await new Promise((r) => setTimeout(r, 200));
+    }
+    async goBack() {
+      await this.view.goBack();
+    }
+    async goForward() {
+      await this.view.goForward();
+    }
+    async reload() {
+      await this.view.reload();
+    }
+    async evaluate(fnOrExpr, ...args) {
+      let expr;
+      if (typeof fnOrExpr === "function") {
+        const serializedArgs = args.map((a) => JSON.stringify(a)).join(", ");
+        expr = `(${fnOrExpr.toString()})(${serializedArgs})`;
+      } else {
+        expr = fnOrExpr;
+      }
+      return this.view.evaluate(expr);
+    }
+    async screenshot(opts) {
+      const uint8 = await this.view.screenshot();
+      return Buffer.from(uint8);
+    }
+    async click(selector, opts) {
+      await this.view.click(selector, opts ? { button: opts.button } : undefined);
+    }
+    async type(selector, text, opts) {
+      try {
+        await this.view.click(selector);
+      } catch {}
+      await this.view.type(text);
+    }
+    async fill(selector, value) {
+      await this.view.evaluate(`
+      (() => {
+        const el = document.querySelector(${JSON.stringify(selector)});
+        if (el) { el.value = ''; el.dispatchEvent(new Event('input')); }
+      })()
+    `);
+      await this.type(selector, value);
+    }
+    async press(key, opts) {
+      await this.view.press(key, opts);
+    }
+    async scroll(direction, amount) {
+      const dx = direction === "left" ? -amount : direction === "right" ? amount : 0;
+      const dy = direction === "up" ? -amount : direction === "down" ? amount : 0;
+      await this.view.scroll(dx, dy);
+    }
+    async scrollIntoView(selector) {
+      await this.view.scrollTo(selector);
+    }
+    async hover(selector) {
+      try {
+        await this.view.scrollTo(selector);
+      } catch {}
+    }
+    async resize(width, height) {
+      await this.view.resize(width, height);
+    }
+    async $(selector) {
+      const exists = await this.view.evaluate(`!!document.querySelector(${JSON.stringify(selector)})`);
+      if (!exists)
+        return null;
+      return {
+        textContent: async () => this.view.evaluate(`document.querySelector(${JSON.stringify(selector)})?.textContent ?? null`)
+      };
+    }
+    async $$(selector) {
+      const count = await this.view.evaluate(`document.querySelectorAll(${JSON.stringify(selector)}).length`);
+      return Array.from({ length: count }, (_, i) => ({
+        textContent: async () => this.view.evaluate(`document.querySelectorAll(${JSON.stringify(selector)})[${i}]?.textContent ?? null`)
+      }));
+    }
+    async inputValue(selector) {
+      return this.view.evaluate(`document.querySelector(${JSON.stringify(selector)})?.value ?? ''`);
+    }
+    async isChecked(selector) {
+      return this.view.evaluate(`!!(document.querySelector(${JSON.stringify(selector)})?.checked)`);
+    }
+    async isVisible(selector) {
+      return this.view.evaluate(`
+      (() => {
+        const el = document.querySelector(${JSON.stringify(selector)});
+        if (!el) return false;
+        const style = window.getComputedStyle(el);
+        return style.display !== 'none' && style.visibility !== 'hidden' && el.offsetWidth > 0;
+      })()
+    `);
+    }
+    async isEnabled(selector) {
+      return this.view.evaluate(`!(document.querySelector(${JSON.stringify(selector)})?.disabled)`);
+    }
+    async selectOption(selector, value) {
+      await this.view.evaluate(`
+      (() => {
+        const el = document.querySelector(${JSON.stringify(selector)});
+        if (el) {
+          el.value = ${JSON.stringify(value)};
+          el.dispatchEvent(new Event('change'));
+        }
+      })()
+    `);
+      return [value];
+    }
+    async check(selector) {
+      await this.view.evaluate(`
+      (() => {
+        const el = document.querySelector(${JSON.stringify(selector)});
+        if (el && !el.checked) { el.checked = true; el.dispatchEvent(new Event('change')); }
+      })()
+    `);
+    }
+    async uncheck(selector) {
+      await this.view.evaluate(`
+      (() => {
+        const el = document.querySelector(${JSON.stringify(selector)});
+        if (el && el.checked) { el.checked = false; el.dispatchEvent(new Event('change')); }
+      })()
+    `);
+    }
+    async setInputFiles(selector, files) {
+      throw new Error("File upload not supported in Bun.WebView engine. Use engine: 'playwright' instead.");
+    }
+    getByRole(role, opts) {
+      const name = opts?.name?.toString() ?? "";
+      const selector = name ? `[role="${role}"][aria-label*="${name}"], ${role}[aria-label*="${name}"]` : `[role="${role}"], ${role}`;
+      return {
+        click: (clickOpts) => this.click(selector, clickOpts),
+        fill: (value) => this.fill(selector, value),
+        check: () => this.check(selector),
+        uncheck: () => this.uncheck(selector),
+        isVisible: () => this.isVisible(selector),
+        textContent: () => this.view.evaluate(`document.querySelector(${JSON.stringify(selector)})?.textContent ?? null`),
+        inputValue: () => this.inputValue(selector),
+        first: () => ({
+          click: (clickOpts) => this.click(selector, clickOpts),
+          fill: (value) => this.fill(selector, value),
+          textContent: () => this.view.evaluate(`document.querySelector(${JSON.stringify(selector)})?.textContent ?? null`),
+          isVisible: () => this.isVisible(selector),
+          hover: () => this.hover(selector),
+          boundingBox: async () => null,
+          scrollIntoViewIfNeeded: () => this.scrollIntoView(selector),
+          evaluate: (fn) => this.view.evaluate(`(${fn.toString()})(document.querySelector(${JSON.stringify(selector)}))`),
+          waitFor: (opts2) => {
+            return new Promise((resolve, reject) => {
+              const timeout = opts2?.timeout ?? 1e4;
+              const start = Date.now();
+              const check = async () => {
+                const visible = await this.isVisible(selector);
+                if (visible)
+                  return resolve();
+                if (Date.now() - start > timeout)
+                  return reject(new Error(`Timeout waiting for ${selector}`));
+                setTimeout(check, 100);
+              };
+              check();
+            });
+          }
+        }),
+        count: async () => {
+          const count = await this.view.evaluate(`document.querySelectorAll(${JSON.stringify(selector)}).length`);
+          return count;
+        },
+        nth: (n) => ({
+          click: (clickOpts) => this.click(selector, clickOpts),
+          textContent: () => this.view.evaluate(`document.querySelectorAll(${JSON.stringify(selector)})[${n}]?.textContent ?? null`),
+          isVisible: () => this.isVisible(selector)
+        })
+      };
+    }
+    getByText(text, opts) {
+      const selector = opts?.exact ? `*:is(button, a, span, div, p, h1, h2, h3, h4, label)` : "*";
+      return {
+        first: () => ({
+          click: async (clickOpts) => {
+            await this.view.evaluate(`
+            (() => {
+              const text = ${JSON.stringify(text)};
+              const all = document.querySelectorAll('*');
+              for (const el of all) {
+                if (el.children.length === 0 && el.textContent?.trim() === text) {
+                  el.click(); return;
+                }
+              }
+              for (const el of all) {
+                if (el.textContent?.includes(text)) { el.click(); return; }
+              }
+            })()
+          `);
+          },
+          waitFor: (waitOpts) => {
+            const timeout = waitOpts?.timeout ?? 1e4;
+            return new Promise((resolve, reject) => {
+              const start = Date.now();
+              const check = async () => {
+                const found = await this.view.evaluate(`document.body?.textContent?.includes(${JSON.stringify(text)})`);
+                if (found)
+                  return resolve();
+                if (Date.now() - start > timeout)
+                  return reject(new Error(`Timeout: text "${text}" not found`));
+                setTimeout(check, 100);
+              };
+              check();
+            });
+          }
+        })
+      };
+    }
+    locator(selector) {
+      return {
+        click: (opts) => this.click(selector, opts),
+        fill: (value) => this.fill(selector, value),
+        scrollIntoViewIfNeeded: () => this.scrollIntoView(selector),
+        first: () => this.getByRole("*").first(),
+        evaluate: (fn) => this.view.evaluate(`(${fn.toString()})(document.querySelector(${JSON.stringify(selector)}))`),
+        waitFor: (opts) => {
+          const timeout = opts?.timeout ?? 1e4;
+          return new Promise((resolve, reject) => {
+            const start = Date.now();
+            const check = async () => {
+              const exists = await this.view.evaluate(`!!document.querySelector(${JSON.stringify(selector)})`);
+              if (exists)
+                return resolve();
+              if (Date.now() - start > timeout)
+                return reject(new Error(`Timeout: ${selector}`));
+              setTimeout(check, 100);
+            };
+            check();
+          });
+        }
+      };
+    }
+    url() {
+      return this.view.url;
+    }
+    async title() {
+      return this.view.title || await this.evaluate("document.title");
+    }
+    viewportSize() {
+      return { width: 1280, height: 720 };
+    }
+    async waitForLoadState(state, opts) {
+      await new Promise((r) => setTimeout(r, 200));
+    }
+    async waitForURL(pattern, opts) {
+      const timeout = opts?.timeout ?? 30000;
+      const start = Date.now();
+      while (Date.now() - start < timeout) {
+        const url = this.view.url;
+        const matches = pattern instanceof RegExp ? pattern.test(url) : url.includes(pattern);
+        if (matches)
+          return;
+        await new Promise((r) => setTimeout(r, 100));
+      }
+      throw new Error(`Timeout waiting for URL to match ${pattern}`);
+    }
+    async waitForSelector(selector, opts) {
+      const timeout = opts?.timeout ?? 1e4;
+      const start = Date.now();
+      while (Date.now() - start < timeout) {
+        const exists = await this.view.evaluate(`!!document.querySelector(${JSON.stringify(selector)})`);
+        if (exists)
+          return;
+        await new Promise((r) => setTimeout(r, 100));
+      }
+      throw new Error(`Timeout waiting for ${selector}`);
+    }
+    async setContent(html) {
+      await this.view.navigate(`data:text/html,${encodeURIComponent(html)}`);
+      await new Promise((r) => setTimeout(r, 100));
+    }
+    async content() {
+      return this.view.evaluate("document.documentElement.outerHTML");
+    }
+    async addInitScript(script) {
+      const expr = typeof script === "function" ? `(${script.toString()})()` : script;
+      await this.view.evaluate(expr);
+    }
+    keyboard = {
+      press: (key) => this.view.press(key)
+    };
+    context() {
+      return {
+        close: async () => {
+          await this.close();
+        },
+        newPage: async () => {
+          throw new Error("Multi-tab not supported in Bun.WebView. Use engine: 'playwright'");
+        },
+        cookies: async () => [],
+        addCookies: async (_) => {},
+        clearCookies: async () => {},
+        newCDPSession: async () => {
+          throw new Error("CDP session via context not available in Bun.WebView. Use view.cdp() when shipped.");
+        },
+        route: async (_pattern, _handler) => {
+          throw new Error("Network interception not supported in Bun.WebView. Use engine: 'cdp' or 'playwright'.");
+        },
+        unrouteAll: async () => {},
+        pages: () => [],
+        addInitScript: async (script) => {
+          await this.addInitScript(script);
+        }
+      };
+    }
+    on(event, handler) {
+      if (!this._eventListeners.has(event))
+        this._eventListeners.set(event, []);
+      this._eventListeners.get(event).push(handler);
+      return this;
+    }
+    off(event, handler) {
+      const listeners = this._eventListeners.get(event) ?? [];
+      this._eventListeners.set(event, listeners.filter((l) => l !== handler));
+      return this;
+    }
+    _emit(event, ...args) {
+      for (const handler of this._eventListeners.get(event) ?? []) {
+        try {
+          handler(...args);
+        } catch {}
+      }
+    }
+    async pdf(_opts) {
+      throw new Error("PDF generation not supported in Bun.WebView. Use engine: 'playwright'.");
+    }
+    coverage = {
+      startJSCoverage: async () => {},
+      stopJSCoverage: async () => [],
+      startCSSCoverage: async () => {},
+      stopCSSCoverage: async () => []
+    };
+    setSessionId(id) {
+      this._sessionId = id;
+    }
+    getSessionId() {
+      return this._sessionId;
+    }
+    getNativeView() {
+      return this.view;
+    }
+    async close() {
+      try {
+        await this.view.close();
+      } catch {}
+    }
+    [Symbol.asyncDispose]() {
+      return this.close();
+    }
+  };
+});
+
 // src/engines/selector.ts
 function selectEngine(useCase, explicit) {
   if (explicit && explicit !== "auto")
     return explicit;
   const preferred = ENGINE_MAP[useCase];
+  if (preferred === "bun") {
+    if (isBunWebViewAvailable())
+      return "bun";
+    if (useCase === "scrape" /* SCRAPE */ || useCase === "extract_links" /* EXTRACT_LINKS */ || useCase === "status_check" /* STATUS_CHECK */) {
+      return isLightpandaAvailable() ? "lightpanda" : "playwright";
+    }
+    return "playwright";
+  }
   if (preferred === "lightpanda" && !isLightpandaAvailable()) {
     return "playwright";
   }
@@ -2529,13 +2938,14 @@ var ENGINE_MAP;
 var init_selector = __esm(() => {
   init_types();
   init_lightpanda();
+  init_bun_webview();
   ENGINE_MAP = {
-    ["scrape" /* SCRAPE */]: "lightpanda",
-    ["extract_links" /* EXTRACT_LINKS */]: "lightpanda",
-    ["status_check" /* STATUS_CHECK */]: "lightpanda",
+    ["scrape" /* SCRAPE */]: "bun",
+    ["extract_links" /* EXTRACT_LINKS */]: "bun",
+    ["status_check" /* STATUS_CHECK */]: "bun",
+    ["screenshot" /* SCREENSHOT */]: "bun",
+    ["spa_navigate" /* SPA_NAVIGATE */]: "bun",
     ["form_fill" /* FORM_FILL */]: "playwright",
-    ["spa_navigate" /* SPA_NAVIGATE */]: "playwright",
-    ["screenshot" /* SCREENSHOT */]: "playwright",
     ["auth_flow" /* AUTH_FLOW */]: "playwright",
     ["multi_tab" /* MULTI_TAB */]: "playwright",
     ["record_replay" /* RECORD_REPLAY */]: "playwright",
@@ -2878,12 +3288,30 @@ var init_dialogs = __esm(() => {
 });
 
 // src/lib/session.ts
+function createBunProxy(view) {
+  return view;
+}
 async function createSession2(opts = {}) {
   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;
+  let browser = null;
+  let bunView = null;
   let page;
-  if (resolvedEngine === "lightpanda") {
+  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();
@@ -2893,12 +3321,9 @@ async function createSession2(opts = {}) {
       viewport: opts.viewport,
       userAgent: opts.userAgent
     });
-    page = await getPage(browser, {
-      viewport: opts.viewport,
-      userAgent: opts.userAgent
-    });
+    page = await getPage(browser, { viewport: opts.viewport, userAgent: opts.userAgent });
   }
-  let sessionName = opts.name ?? (opts.startUrl ? (() => {
+  const sessionName = opts.name ?? (opts.startUrl ? (() => {
     try {
       return new URL(opts.startUrl).hostname;
     } catch {
@@ -2906,35 +3331,57 @@ async function createSession2(opts = {}) {
     }
   })() : undefined);
   const session = createSession({
-    engine: resolvedEngine,
+    engine: bunView ? "bun" : browser ? resolvedEngine : resolvedEngine,
     projectId: opts.projectId,
     agentId: opts.agentId,
     startUrl: opts.startUrl,
     name: sessionName
   });
-  if (opts.stealth) {
+  if (opts.stealth && !bunView) {
     try {
       await applyStealthPatches(page);
     } catch {}
   }
   const cleanups = [];
-  if (opts.captureNetwork !== false) {
-    try {
-      cleanups.push(enableNetworkLogging(page, session.id));
-    } catch {}
-  }
-  if (opts.captureConsole !== false) {
+  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(enableConsoleCapture(page, session.id));
+      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 {}
+    }
   }
-  try {
-    cleanups.push(setupDialogHandler(page, session.id));
-  } catch {}
-  handles.set(session.id, { browser, page, engine: resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 } });
+  handles.set(session.id, { browser, bunView, page, engine: bunView ? "bun" : resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 } });
   if (opts.startUrl) {
     try {
-      await page.goto(opts.startUrl, { waitUntil: "domcontentloaded" });
+      if (bunView) {
+        await bunView.goto(opts.startUrl);
+      } else {
+        await page.goto(opts.startUrl, { waitUntil: "domcontentloaded" });
+      }
     } catch {}
   }
   return { session, page };
@@ -2944,13 +3391,23 @@ function getSessionPage(sessionId) {
   if (!handle)
     throw new SessionNotFoundError(sessionId);
   try {
-    handle.page.url();
+    if (handle.bunView) {
+      handle.bunView.url();
+    } else {
+      handle.page.url();
+    }
   } catch {
     handles.delete(sessionId);
     throw new SessionNotFoundError(sessionId);
   }
   return handle.page;
 }
+function getSessionBunView(sessionId) {
+  return handles.get(sessionId)?.bunView ?? null;
+}
+function isBunSession(sessionId) {
+  return handles.get(sessionId)?.engine === "bun";
+}
 function setSessionPage(sessionId, page) {
   const handle = handles.get(sessionId);
   if (!handle)
@@ -2965,12 +3422,19 @@ async function closeSession2(sessionId) {
         cleanup();
       } catch {}
     }
-    try {
-      await handle.page.context().close();
-    } catch {}
-    try {
-      await closeBrowser(handle.browser);
-    } catch {}
+    if (handle.bunView) {
+      try {
+        await handle.bunView.close();
+      } catch {}
+    } else {
+      try {
+        await handle.page.context().close();
+      } catch {}
+      try {
+        if (handle.browser)
+          await closeBrowser(handle.browser);
+      } catch {}
+    }
     handles.delete(sessionId);
   }
   return closeSession(sessionId);
@@ -2998,6 +3462,7 @@ var init_session = __esm(() => {
   init_sessions();
   init_playwright();
   init_lightpanda();
+  init_bun_webview();
   init_selector();
   init_network();
   init_console();
@@ -3010,6 +3475,7 @@ var init_session = __esm(() => {
 var exports_snapshot = {};
 __export(exports_snapshot, {
   takeSnapshot: () => takeSnapshot,
+  takeBunSnapshot: () => takeBunSnapshot,
   setLastSnapshot: () => setLastSnapshot,
   hasRefs: () => hasRefs,
   getSessionRefs: () => getSessionRefs,
@@ -3030,6 +3496,10 @@ function clearLastSnapshot(sessionId) {
   lastSnapshots.delete(sessionId);
 }
 async function takeSnapshot(page, sessionId) {
+  const isBunView = typeof page.getNativeView === "function" || typeof page.bunView !== "undefined";
+  if (isBunView) {
+    return takeBunSnapshot(page, sessionId);
+  }
   let ariaTree;
   try {
     ariaTree = await page.locator("body").ariaSnapshot();
@@ -3184,6 +3654,71 @@ function diffSnapshots(before, after) {
   const title_changed = before.tree !== after.tree && (added.length > 0 || removed.length > 0 || modified.length > 0);
   return { added, removed, modified, url_changed, title_changed };
 }
+async function takeBunSnapshot(page, sessionId) {
+  const refs = {};
+  const refMap = new Map;
+  let refCounter = 0;
+  const lines = [];
+  try {
+    const elements = await page.evaluate(`
+      (() => {
+        const SELECTOR = 'a[href], button, input:not([type=hidden]), select, textarea, [role=button], [role=link], [role=checkbox], [role=combobox], [role=menuitem], [role=tab], [role=option]';
+        const els = Array.from(document.querySelectorAll(SELECTOR));
+        return els.slice(0, 100).map(el => {
+          const tag = el.tagName.toLowerCase();
+          const inputType = el.getAttribute('type') ?? '';
+          let role = el.getAttribute('role') || (['a'].includes(tag) ? 'link' : ['button'].includes(tag) ? 'button' : ['input'].includes(tag) ? (inputType === 'checkbox' ? 'checkbox' : inputType === 'radio' ? 'radio' : 'textbox') : ['select'].includes(tag) ? 'combobox' : ['textarea'].includes(tag) ? 'textbox' : tag);
+          const name = (el.getAttribute('aria-label') || el.textContent?.trim() || el.getAttribute('placeholder') || el.getAttribute('title') || el.getAttribute('value') || el.id || '').slice(0, 80);
+          const enabled = !el.disabled && !el.getAttribute('disabled');
+          const style = window.getComputedStyle(el);
+          const visible = style.display !== 'none' && style.visibility !== 'hidden' && el.offsetWidth > 0;
+          const checked = el.type === 'checkbox' || el.type === 'radio' ? el.checked : undefined;
+          const value = ['input', 'select', 'textarea'].includes(tag) && el.type !== 'checkbox' && el.type !== 'radio' ? el.value : undefined;
+          const selector = el.id ? '#' + el.id : (el.getAttribute('aria-label') ? '[aria-label="' + el.getAttribute('aria-label') + '"]' : tag);
+          return { role, name, enabled, visible, checked, value, selector };
+        }).filter(e => e.visible && e.name);
+      })()
+    `);
+    const pageTitle = await page.evaluate("document.title");
+    const pageUrl = typeof page.url === "function" ? page.url() : "";
+    lines.push(`# ${pageTitle || "Page"} (${pageUrl})`);
+    for (const el of elements) {
+      if (!el.name)
+        continue;
+      const ref = `@e${refCounter}`;
+      refCounter++;
+      refs[ref] = {
+        role: el.role,
+        name: el.name,
+        visible: el.visible,
+        enabled: el.enabled,
+        value: el.value,
+        checked: el.checked
+      };
+      refMap.set(ref, { role: el.role, name: el.name, locatorSelector: el.selector });
+      const extras = [];
+      if (el.checked !== undefined)
+        extras.push(`checked=${el.checked}`);
+      if (!el.enabled)
+        extras.push("disabled");
+      if (el.value && el.value !== el.name)
+        extras.push(`value="${el.value.slice(0, 30)}"`);
+      const extrasStr = extras.length ? ` (${extras.join(", ")})` : "";
+      lines.push(`${el.role} "${el.name}" [${ref}]${extrasStr}`);
+    }
+  } catch (err) {
+    lines.push(`# (snapshot error: ${err instanceof Error ? err.message : String(err)})`);
+  }
+  if (sessionId) {
+    sessionRefMaps.set(sessionId, refMap);
+  }
+  return {
+    tree: lines.join(`
+`),
+    refs,
+    interactive_count: refCounter
+  };
+}
 var lastSnapshots, sessionRefMaps, INTERACTIVE_ROLES;
 var init_snapshot = __esm(() => {
   lastSnapshots = new Map;
@@ -3528,9 +4063,19 @@ async function getLinks(page, baseUrl) {
   }, baseUrl ?? page.url());
 }
 async function getTitle(page) {
+  if (typeof page.getNativeView === "function") {
+    const nativeView = page.getNativeView();
+    const t = nativeView?.title;
+    return typeof t === "string" && t ? t : "";
+  }
   return page.title();
 }
 async function getUrl(page) {
+  if (typeof page.getNativeView === "function") {
+    const nativeView = page.getNativeView();
+    const u = nativeView?.url;
+    return typeof u === "string" ? u : "";
+  }
   return page.url();
 }
 async function findElements(page, selector) {
@@ -10172,17 +10717,17 @@ var init_gallery = __esm(() => {
 });
 
 // src/lib/screenshot.ts
-import { join as join2 } from "path";
-import { mkdirSync as mkdirSync2 } from "fs";
-import { homedir as homedir2 } from "os";
+import { join as join3 } from "path";
+import { mkdirSync as mkdirSync3 } from "fs";
+import { homedir as homedir3 } from "os";
 function getDataDir2() {
-  return process.env["BROWSER_DATA_DIR"] ?? join2(homedir2(), ".browser");
+  return process.env["BROWSER_DATA_DIR"] ?? join3(homedir3(), ".browser");
 }
 function getScreenshotDir(projectId) {
-  const base = join2(getDataDir2(), "screenshots");
+  const base = join3(getDataDir2(), "screenshots");
   const date = new Date().toISOString().split("T")[0];
-  const dir = projectId ? join2(base, projectId, date) : join2(base, date);
-  mkdirSync2(dir, { recursive: true });
+  const dir = projectId ? join3(base, projectId, date) : join3(base, date);
+  mkdirSync3(dir, { recursive: true });
   return dir;
 }
 async function compressBuffer(raw, format, quality, maxWidth) {
@@ -10197,7 +10742,7 @@ async function compressBuffer(raw, format, quality, maxWidth) {
   }
 }
 async function generateThumbnail(raw, dir, stem) {
-  const thumbPath = join2(dir, `${stem}.thumb.webp`);
+  const thumbPath = join3(dir, `${stem}.thumb.webp`);
   const thumbBuffer = await import_sharp.default(raw).resize({ width: 200, withoutEnlargement: true }).webp({ quality: 70, effort: 3 }).toBuffer();
   await Bun.write(thumbPath, thumbBuffer);
   return { path: thumbPath, base64: thumbBuffer.toString("base64") };
@@ -10216,11 +10761,20 @@ async function takeScreenshot(page, opts) {
       type: "png"
     };
     let rawBuffer;
+    const isBunView = typeof page.getNativeView === "function";
     if (opts?.selector) {
-      const el = await page.$(opts.selector);
-      if (!el)
-        throw new BrowserError(`Element not found: ${opts.selector}`, "ELEMENT_NOT_FOUND");
-      rawBuffer = await el.screenshot(rawOpts);
+      if (isBunView) {
+        const uint8 = await page.screenshot();
+        rawBuffer = Buffer.from(uint8 instanceof Uint8Array ? uint8 : await uint8);
+      } else {
+        const el = await page.$(opts.selector);
+        if (!el)
+          throw new BrowserError(`Element not found: ${opts.selector}`, "ELEMENT_NOT_FOUND");
+        rawBuffer = await el.screenshot(rawOpts);
+      }
+    } else if (isBunView) {
+      const uint8 = await page.screenshot();
+      rawBuffer = Buffer.from(uint8 instanceof Uint8Array ? uint8 : await uint8);
     } else {
       rawBuffer = await page.screenshot(rawOpts);
     }
@@ -10245,7 +10799,7 @@ async function takeScreenshot(page, opts) {
     const compressedSizeBytes = finalBuffer.length;
     const compressionRatio = originalSizeBytes > 0 ? compressedSizeBytes / originalSizeBytes : 1;
     const ext = format;
-    const screenshotPath = opts?.path ?? join2(dir, `${stem}.${ext}`);
+    const screenshotPath = opts?.path ?? join3(dir, `${stem}.${ext}`);
     await Bun.write(screenshotPath, finalBuffer);
     let thumbnailPath;
     let thumbnailBase64;
@@ -10305,12 +10859,12 @@ async function takeScreenshot(page, opts) {
 }
 async function generatePDF(page, opts) {
   try {
-    const base = join2(getDataDir2(), "pdfs");
+    const base = join3(getDataDir2(), "pdfs");
     const date = new Date().toISOString().split("T")[0];
-    const dir = opts?.projectId ? join2(base, opts.projectId, date) : join2(base, date);
-    mkdirSync2(dir, { recursive: true });
+    const dir = opts?.projectId ? join3(base, opts.projectId, date) : join3(base, date);
+    mkdirSync3(dir, { recursive: true });
     const timestamp = Date.now();
-    const pdfPath = opts?.path ?? join2(dir, `${timestamp}.pdf`);
+    const pdfPath = opts?.path ?? join3(dir, `${timestamp}.pdf`);
     const buffer = await page.pdf({
       path: pdfPath,
       format: opts?.format ?? "A4",
@@ -14909,16 +15463,16 @@ __export(exports_downloads, {
   cleanStaleDownloads: () => cleanStaleDownloads
 });
 import { randomUUID as randomUUID9 } from "crypto";
-import { join as join3, basename, extname } from "path";
-import { mkdirSync as mkdirSync3, existsSync, readdirSync, statSync, unlinkSync, copyFileSync, writeFileSync, readFileSync } from "fs";
-import { homedir as homedir3 } from "os";
+import { join as join4, basename, extname } from "path";
+import { mkdirSync as mkdirSync4, existsSync, readdirSync, statSync, unlinkSync, copyFileSync, writeFileSync, readFileSync } from "fs";
+import { homedir as homedir4 } from "os";
 function getDataDir3() {
-  return process.env["BROWSER_DATA_DIR"] ?? join3(homedir3(), ".browser");
+  return process.env["BROWSER_DATA_DIR"] ?? join4(homedir4(), ".browser");
 }
 function getDownloadsDir(sessionId) {
-  const base = join3(getDataDir3(), "downloads");
-  const dir = sessionId ? join3(base, sessionId) : base;
-  mkdirSync3(dir, { recursive: true });
+  const base = join4(getDataDir3(), "downloads");
+  const dir = sessionId ? join4(base, sessionId) : base;
+  mkdirSync4(dir, { recursive: true });
   return dir;
 }
 function ensureDownloadsDir() {
@@ -14933,7 +15487,7 @@ function saveToDownloads(buffer, filename, opts) {
   const ext = extname(filename) || "";
   const stem = basename(filename, ext);
   const uniqueName = `${stem}-${id.slice(0, 8)}${ext}`;
-  const filePath = join3(dir, uniqueName);
+  const filePath = join4(dir, uniqueName);
   writeFileSync(filePath, buffer);
   const meta = {
     id,
@@ -14968,7 +15522,7 @@ function listDownloads(sessionId) {
     for (const entry of entries) {
       if (entry.endsWith(".meta.json"))
         continue;
-      const full = join3(d, entry);
+      const full = join4(d, entry);
       const stat = statSync(full);
       if (stat.isDirectory()) {
         scanDir(full);
@@ -15057,9 +15611,9 @@ var exports_gallery_diff = {};
 __export(exports_gallery_diff, {
   diffImages: () => diffImages
 });
-import { join as join4 } from "path";
-import { mkdirSync as mkdirSync4 } from "fs";
-import { homedir as homedir4 } from "os";
+import { join as join5 } from "path";
+import { mkdirSync as mkdirSync5 } from "fs";
+import { homedir as homedir5 } from "os";
 async function diffImages(path1, path2) {
   const img1 = import_sharp2.default(path1);
   const img2 = import_sharp2.default(path2);
@@ -15090,10 +15644,10 @@ async function diffImages(path1, path2) {
       diffBuffer[i + 2] = Math.round(raw1[i + 2] * 0.4);
     }
   }
-  const dataDir = process.env["BROWSER_DATA_DIR"] ?? join4(homedir4(), ".browser");
-  const diffDir = join4(dataDir, "diffs");
-  mkdirSync4(diffDir, { recursive: true });
-  const diffPath = join4(diffDir, `diff-${Date.now()}.webp`);
+  const dataDir = process.env["BROWSER_DATA_DIR"] ?? join5(homedir5(), ".browser");
+  const diffDir = join5(dataDir, "diffs");
+  mkdirSync5(diffDir, { recursive: true });
+  const diffPath = join5(diffDir, `diff-${Date.now()}.webp`);
   const diffImageBuffer = await import_sharp2.default(diffBuffer, { raw: { width: w, height: h, channels } }).webp({ quality: 85 }).toBuffer();
   await Bun.write(diffPath, diffImageBuffer);
   return {
@@ -15110,9 +15664,9 @@ var init_gallery_diff = __esm(() => {
 });
 
 // src/lib/files-integration.ts
-import { join as join5 } from "path";
-import { mkdirSync as mkdirSync5, copyFileSync as copyFileSync2 } from "fs";
-import { homedir as homedir5 } from "os";
+import { join as join6 } from "path";
+import { mkdirSync as mkdirSync6, copyFileSync as copyFileSync2 } from "fs";
+import { homedir as homedir6 } from "os";
 async function persistFile(localPath, opts) {
   try {
     const mod = await import("@hasna/files");
@@ -15121,12 +15675,12 @@ async function persistFile(localPath, opts) {
       return { id: ref.id, path: ref.path ?? localPath, permanent: true, provider: "open-files" };
     }
   } catch {}
-  const dataDir = process.env["BROWSER_DATA_DIR"] ?? join5(homedir5(), ".browser");
+  const dataDir = process.env["BROWSER_DATA_DIR"] ?? join6(homedir6(), ".browser");
   const date = new Date().toISOString().split("T")[0];
-  const dir = join5(dataDir, "persistent", date);
-  mkdirSync5(dir, { recursive: true });
+  const dir = join6(dataDir, "persistent", date);
+  mkdirSync6(dir, { recursive: true });
   const filename = localPath.split("/").pop() ?? "file";
-  const targetPath = join5(dir, filename);
+  const targetPath = join6(dir, filename);
   copyFileSync2(localPath, targetPath);
   return {
     id: `local-${Date.now()}`,
@@ -15219,23 +15773,23 @@ async function closeTab(page, index) {
 }
 
 // src/lib/profiles.ts
-import { mkdirSync as mkdirSync6, existsSync as existsSync3, readdirSync as readdirSync2, rmSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join as join6 } from "path";
-import { homedir as homedir6 } from "os";
+import { mkdirSync as mkdirSync7, existsSync as existsSync3, readdirSync as readdirSync2, rmSync, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join7 } from "path";
+import { homedir as homedir7 } from "os";
 function getProfilesDir() {
-  const dataDir = process.env["BROWSER_DATA_DIR"] ?? join6(homedir6(), ".browser");
-  const dir = join6(dataDir, "profiles");
-  mkdirSync6(dir, { recursive: true });
+  const dataDir = process.env["BROWSER_DATA_DIR"] ?? join7(homedir7(), ".browser");
+  const dir = join7(dataDir, "profiles");
+  mkdirSync7(dir, { recursive: true });
   return dir;
 }
-function getProfileDir(name) {
-  return join6(getProfilesDir(), name);
+function getProfileDir2(name) {
+  return join7(getProfilesDir(), name);
 }
 async function saveProfile(page, name) {
-  const dir = getProfileDir(name);
-  mkdirSync6(dir, { recursive: true });
+  const dir = getProfileDir2(name);
+  mkdirSync7(dir, { recursive: true });
   const cookies = await page.context().cookies();
-  writeFileSync2(join6(dir, "cookies.json"), JSON.stringify(cookies, null, 2));
+  writeFileSync2(join7(dir, "cookies.json"), JSON.stringify(cookies, null, 2));
   let localStorage2 = {};
   try {
     localStorage2 = await page.evaluate(() => {
@@ -15247,11 +15801,11 @@ async function saveProfile(page, name) {
       return result;
     });
   } catch {}
-  writeFileSync2(join6(dir, "storage.json"), JSON.stringify(localStorage2, null, 2));
+  writeFileSync2(join7(dir, "storage.json"), JSON.stringify(localStorage2, null, 2));
   const savedAt = new Date().toISOString();
   const url = page.url();
   const meta = { saved_at: savedAt, url };
-  writeFileSync2(join6(dir, "meta.json"), JSON.stringify(meta, null, 2));
+  writeFileSync2(join7(dir, "meta.json"), JSON.stringify(meta, null, 2));
   return {
     name,
     saved_at: savedAt,
@@ -15261,13 +15815,13 @@ async function saveProfile(page, name) {
   };
 }
 function loadProfile(name) {
-  const dir = getProfileDir(name);
+  const dir = getProfileDir2(name);
   if (!existsSync3(dir)) {
     throw new Error(`Profile not found: ${name}`);
   }
-  const cookiesPath = join6(dir, "cookies.json");
-  const storagePath = join6(dir, "storage.json");
-  const metaPath2 = join6(dir, "meta.json");
+  const cookiesPath = join7(dir, "cookies.json");
+  const storagePath = join7(dir, "storage.json");
+  const metaPath2 = join7(dir, "meta.json");
   const cookies = existsSync3(cookiesPath) ? JSON.parse(readFileSync2(cookiesPath, "utf8")) : [];
   const localStorage2 = existsSync3(storagePath) ? JSON.parse(readFileSync2(storagePath, "utf8")) : {};
   let savedAt = new Date().toISOString();
@@ -15308,24 +15862,24 @@ function listProfiles() {
     if (!entry.isDirectory())
       continue;
     const name = entry.name;
-    const profileDir = join6(dir, name);
+    const profileDir = join7(dir, name);
     let savedAt = "";
     let url;
     let cookieCount = 0;
     let storageKeyCount = 0;
     try {
-      const metaPath2 = join6(profileDir, "meta.json");
+      const metaPath2 = join7(profileDir, "meta.json");
       if (existsSync3(metaPath2)) {
         const meta = JSON.parse(readFileSync2(metaPath2, "utf8"));
         savedAt = meta.saved_at ?? "";
         url = meta.url;
       }
-      const cookiesPath = join6(profileDir, "cookies.json");
+      const cookiesPath = join7(profileDir, "cookies.json");
       if (existsSync3(cookiesPath)) {
         const cookies = JSON.parse(readFileSync2(cookiesPath, "utf8"));
         cookieCount = Array.isArray(cookies) ? cookies.length : 0;
       }
-      const storagePath = join6(profileDir, "storage.json");
+      const storagePath = join7(profileDir, "storage.json");
       if (existsSync3(storagePath)) {
         const storage = JSON.parse(readFileSync2(storagePath, "utf8"));
         storageKeyCount = Object.keys(storage).length;
@@ -15342,7 +15896,7 @@ function listProfiles() {
   return profiles.sort((a, b) => b.saved_at.localeCompare(a.saved_at));
 }
 function deleteProfile(name) {
-  const dir = getProfileDir(name);
+  const dir = getProfileDir2(name);
   if (!existsSync3(dir))
     return false;
   try {
@@ -15419,7 +15973,7 @@ var exports_mcp = {};
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { readFileSync as readFileSync3 } from "fs";
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 function json(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
@@ -15455,7 +16009,7 @@ var init_mcp = __esm(async () => {
   init_dialogs();
   init_profiles();
   init_types();
-  _pkg = JSON.parse(readFileSync3(join7(import.meta.dir, "../../package.json"), "utf8"));
+  _pkg = JSON.parse(readFileSync3(join8(import.meta.dir, "../../package.json"), "utf8"));
   networkLogCleanup = new Map;
   consoleCaptureCleanup = new Map;
   harCaptures = new Map;
@@ -15464,7 +16018,7 @@ var init_mcp = __esm(async () => {
     version: "0.0.1"
   });
   server.tool("browser_session_create", "Create a new browser session with the specified engine", {
-    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "auto"]).optional().default("auto"),
+    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto"),
     use_case: exports_external.string().optional(),
     project_id: exports_external.string().optional(),
     agent_id: exports_external.string().optional(),
@@ -15519,7 +16073,13 @@ var init_mcp = __esm(async () => {
   }, async ({ session_id, url, timeout, auto_snapshot, auto_thumbnail }) => {
     try {
       const page = getSessionPage(session_id);
-      await navigate(page, url, timeout);
+      if (isBunSession(session_id)) {
+        const bunView = getSessionBunView(session_id);
+        await bunView.goto(url, { timeout });
+        await new Promise((r) => setTimeout(r, 500));
+      } else {
+        await navigate(page, url, timeout);
+      }
       const title = await getTitle(page);
       const current_url = await getUrl(page);
       const redirected = current_url !== url && current_url !== url + "/" && url !== current_url.replace(/\/$/, "");
@@ -15560,6 +16120,9 @@ var init_mcp = __esm(async () => {
           result.thumbnail_base64 = ss.base64.length > 50000 ? "" : ss.base64;
         } catch {}
       }
+      if (isBunSession(session_id) && auto_snapshot) {
+        await new Promise((r) => setTimeout(r, 200));
+      }
       if (auto_snapshot) {
         try {
           const snap = await takeSnapshot(page, session_id);
@@ -16067,7 +16630,7 @@ var init_mcp = __esm(async () => {
     max_pages: exports_external.number().optional().default(50),
     same_domain: exports_external.boolean().optional().default(true),
     project_id: exports_external.string().optional(),
-    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "auto"]).optional().default("auto")
+    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto")
   }, async ({ url, max_depth, max_pages, same_domain, project_id, engine }) => {
     try {
       const result = await crawl(url, {
@@ -16835,7 +17398,7 @@ var init_snapshots = __esm(() => {
 
 // src/server/index.ts
 var exports_server = {};
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 import { existsSync as existsSync4 } from "fs";
 function ok(data, status = 200) {
   return new Response(JSON.stringify(data), {
@@ -17129,13 +17692,13 @@ var init_server = __esm(() => {
           const id = path.split("/")[3];
           return ok({ deleted: deleteDownload(id) });
         }
-        const dashboardDist = join8(import.meta.dir, "../../dashboard/dist");
+        const dashboardDist = join9(import.meta.dir, "../../dashboard/dist");
         if (existsSync4(dashboardDist)) {
-          const filePath = path === "/" ? join8(dashboardDist, "index.html") : join8(dashboardDist, path);
+          const filePath = path === "/" ? join9(dashboardDist, "index.html") : join9(dashboardDist, path);
           if (existsSync4(filePath)) {
             return new Response(Bun.file(filePath), { headers: CORS_HEADERS });
           }
-          return new Response(Bun.file(join8(dashboardDist, "index.html")), { headers: CORS_HEADERS });
+          return new Response(Bun.file(join9(dashboardDist, "index.html")), { headers: CORS_HEADERS });
         }
         if (path === "/" || path === "") {
           return new Response("@hasna/browser REST API running. Dashboard not built.", {
@@ -17178,9 +17741,9 @@ init_recorder();
 init_recordings();
 init_lightpanda();
 import { readFileSync as readFileSync4 } from "fs";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 import chalk from "chalk";
-var pkg = JSON.parse(readFileSync4(join9(import.meta.dir, "../../package.json"), "utf8"));
+var pkg = JSON.parse(readFileSync4(join10(import.meta.dir, "../../package.json"), "utf8"));
 var program2 = new Command;
 program2.name("browser").description("@hasna/browser \u2014 general-purpose browser agent CLI").version(pkg.version);
 program2.command("navigate <url>").description("Navigate to a URL and optionally take a screenshot").option("--engine <engine>", "Browser engine: playwright|cdp|lightpanda|auto", "auto").option("--screenshot", "Take a screenshot after navigation").option("--extract", "Extract page text after navigation").option("--headless", "Run in headless mode (default: true)", true).action(async (url, opts) => {