@hasna/browser 0.0.3 → 0.0.5

package/dist/cli/index.js

@@ -2121,6 +2121,12 @@ var init_types = __esm(() => {
 });
 
 // src/db/schema.ts
+var exports_schema = {};
+__export(exports_schema, {
+  resetDatabase: () => resetDatabase,
+  getDatabase: () => getDatabase,
+  getDataDir: () => getDataDir
+});
 import { Database } from "bun:sqlite";
 import { join } from "path";
 import { mkdirSync } from "fs";
@@ -2146,6 +2152,15 @@ function getDatabase(path) {
   runMigrations(_db);
   return _db;
 }
+function resetDatabase() {
+  if (_db) {
+    try {
+      _db.close();
+    } catch {}
+  }
+  _db = null;
+  _dbPath = null;
+}
 function runMigrations(db) {
   db.exec(`
     CREATE TABLE IF NOT EXISTS schema_migrations (
@@ -2313,7 +2328,14 @@ import { randomUUID } from "crypto";
 function createSession(data) {
   const db = getDatabase();
   const id = randomUUID();
-  db.prepare("INSERT INTO sessions (id, engine, project_id, agent_id, start_url, name) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.engine, data.projectId ?? null, data.agentId ?? null, data.startUrl ?? null, data.name ?? null);
+  let name = data.name ?? null;
+  if (name) {
+    const existing = db.query("SELECT id FROM sessions WHERE name = ?").get(name);
+    if (existing) {
+      name = `${name}-${id.slice(0, 6)}`;
+    }
+  }
+  db.prepare("INSERT INTO sessions (id, engine, project_id, agent_id, start_url, name) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.engine, data.projectId ?? null, data.agentId ?? null, data.startUrl ?? null, name);
   return getSession(id);
 }
 function getSessionByName(name) {
@@ -2493,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";
   }
@@ -2507,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",
@@ -2856,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();
@@ -2871,41 +3321,67 @@ 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 });
   }
+  const sessionName = opts.name ?? (opts.startUrl ? (() => {
+    try {
+      return new URL(opts.startUrl).hostname;
+    } catch {
+      return;
+    }
+  })() : undefined);
   const session = createSession({
-    engine: resolvedEngine,
+    engine: bunView ? "bun" : browser ? resolvedEngine : resolvedEngine,
     projectId: opts.projectId,
     agentId: opts.agentId,
     startUrl: opts.startUrl,
-    name: opts.name ?? (opts.startUrl ? new URL(opts.startUrl).hostname : undefined)
+    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 };
@@ -2915,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)
@@ -2936,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);
@@ -2969,6 +3462,7 @@ var init_session = __esm(() => {
   init_sessions();
   init_playwright();
   init_lightpanda();
+  init_bun_webview();
   init_selector();
   init_network();
   init_console();
@@ -2978,13 +3472,34 @@ var init_session = __esm(() => {
 });
 
 // src/lib/snapshot.ts
+var exports_snapshot = {};
+__export(exports_snapshot, {
+  takeSnapshot: () => takeSnapshot,
+  takeBunSnapshot: () => takeBunSnapshot,
+  setLastSnapshot: () => setLastSnapshot,
+  hasRefs: () => hasRefs,
+  getSessionRefs: () => getSessionRefs,
+  getRefLocator: () => getRefLocator,
+  getRefInfo: () => getRefInfo,
+  getLastSnapshot: () => getLastSnapshot,
+  diffSnapshots: () => diffSnapshots,
+  clearSessionRefs: () => clearSessionRefs,
+  clearLastSnapshot: () => clearLastSnapshot
+});
 function getLastSnapshot(sessionId) {
   return lastSnapshots.get(sessionId) ?? null;
 }
 function setLastSnapshot(sessionId, snapshot) {
   lastSnapshots.set(sessionId, snapshot);
 }
+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();
@@ -3086,6 +3601,21 @@ function getRefLocator(page, sessionId, ref) {
     throw new Error(`Ref ${ref} not found. Available refs: ${[...refMap.keys()].slice(0, 20).join(", ")}`);
   return page.getByRole(entry.role, { name: entry.name }).first();
 }
+function getRefInfo(sessionId, ref) {
+  const refMap = sessionRefMaps.get(sessionId);
+  if (!refMap)
+    return null;
+  return refMap.get(ref) ?? null;
+}
+function getSessionRefs(sessionId) {
+  return sessionRefMaps.get(sessionId) ?? null;
+}
+function clearSessionRefs(sessionId) {
+  sessionRefMaps.delete(sessionId);
+}
+function hasRefs(sessionId) {
+  return sessionRefMaps.has(sessionId) && (sessionRefMaps.get(sessionId)?.size ?? 0) > 0;
+}
 function refKey(info) {
   return `${info.role}::${info.name}`;
 }
@@ -3124,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;
@@ -3468,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) {
@@ -10112,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) {
@@ -10137,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") };
@@ -10156,27 +10761,45 @@ 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);
     }
     const originalSizeBytes = rawBuffer.length;
     let finalBuffer;
-    if (compress && format !== "png") {
-      finalBuffer = await compressBuffer(rawBuffer, format, quality ?? 82, maxWidth);
-    } else if (compress && format === "png") {
-      finalBuffer = await compressBuffer(rawBuffer, "png", quality ?? 9, maxWidth);
-    } else {
+    let compressed = true;
+    let fallback = false;
+    try {
+      if (compress && format !== "png") {
+        finalBuffer = await compressBuffer(rawBuffer, format, quality ?? 82, maxWidth);
+      } else if (compress && format === "png") {
+        finalBuffer = await compressBuffer(rawBuffer, "png", quality ?? 9, maxWidth);
+      } else {
+        finalBuffer = rawBuffer;
+        compressed = false;
+      }
+    } catch (sharpErr) {
+      fallback = true;
+      compressed = false;
       finalBuffer = rawBuffer;
     }
     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;
@@ -10198,7 +10821,8 @@ async function takeScreenshot(page, opts) {
       compressed_size_bytes: compressedSizeBytes,
       compression_ratio: compressionRatio,
       thumbnail_path: thumbnailPath,
-      thumbnail_base64: thumbnailBase64
+      thumbnail_base64: thumbnailBase64,
+      ...fallback ? { fallback: true, compressed: false } : {}
     };
     if (opts?.track !== false) {
       try {
@@ -10235,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",
@@ -14839,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() {
@@ -14863,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,
@@ -14898,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);
@@ -14987,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);
@@ -15020,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 {
@@ -15040,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");
@@ -15051,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()}`,
@@ -15149,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(() => {
@@ -15177,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,
@@ -15191,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();
@@ -15238,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;
@@ -15272,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 {
@@ -15298,7 +15922,8 @@ async function annotateScreenshot(page, sessionId) {
   const annotations = [];
   const labelToRef = {};
   let labelCounter = 1;
-  for (const [ref, info] of Object.entries(snapshot.refs)) {
+  const refsToAnnotate = Object.entries(snapshot.refs).slice(0, MAX_ANNOTATIONS);
+  for (const [ref, info] of refsToAnnotate) {
     try {
       const locator = page.getByRole(info.role, { name: info.name }).first();
       const box = await locator.boundingBox();
@@ -15337,7 +15962,7 @@ async function annotateScreenshot(page, sessionId) {
   const annotatedBuffer = await import_sharp3.default(rawBuffer).composite([{ input: Buffer.from(svg), top: 0, left: 0 }]).webp({ quality: 85 }).toBuffer();
   return { buffer: annotatedBuffer, annotations, labelToRef };
 }
-var import_sharp3;
+var import_sharp3, MAX_ANNOTATIONS = 40;
 var init_annotate = __esm(() => {
   init_snapshot();
   import_sharp3 = __toESM(require_lib(), 1);
@@ -15347,6 +15972,8 @@ var init_annotate = __esm(() => {
 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 join8 } from "path";
 function json(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
@@ -15358,7 +15985,7 @@ function err(e) {
     isError: true
   };
 }
-var networkLogCleanup, consoleCaptureCleanup, harCaptures, server, activeWatchHandles, transport;
+var _pkg, networkLogCleanup, consoleCaptureCleanup, harCaptures, server, activeWatchHandles, _startupToolCount, transport;
 var init_mcp = __esm(async () => {
   init_zod();
   init_session();
@@ -15382,6 +16009,7 @@ var init_mcp = __esm(async () => {
   init_dialogs();
   init_profiles();
   init_types();
+  _pkg = JSON.parse(readFileSync3(join8(import.meta.dir, "../../package.json"), "utf8"));
   networkLogCleanup = new Map;
   consoleCaptureCleanup = new Map;
   harCaptures = new Map;
@@ -15390,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(),
@@ -15436,23 +16064,71 @@ var init_mcp = __esm(async () => {
       return err(e);
     }
   });
-  server.tool("browser_navigate", "Navigate to a URL. Returns title + thumbnail + accessibility snapshot preview with refs.", { session_id: exports_external.string(), url: exports_external.string(), timeout: exports_external.number().optional().default(30000), auto_snapshot: exports_external.boolean().optional().default(true), auto_thumbnail: exports_external.boolean().optional().default(true) }, async ({ session_id, url, timeout, auto_snapshot, auto_thumbnail }) => {
+  server.tool("browser_navigate", "Navigate to a URL. Auto-detects redirects, auto-names session, returns compact refs + thumbnail.", {
+    session_id: exports_external.string(),
+    url: exports_external.string(),
+    timeout: exports_external.number().optional().default(30000),
+    auto_snapshot: exports_external.boolean().optional().default(true),
+    auto_thumbnail: exports_external.boolean().optional().default(true)
+  }, 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 result = { url, title, current_url };
+      const redirected = current_url !== url && current_url !== url + "/" && url !== current_url.replace(/\/$/, "");
+      let redirect_type;
+      if (redirected) {
+        try {
+          const reqHost = new URL(url).hostname;
+          const resHost = new URL(current_url).hostname;
+          const reqPath = new URL(url).pathname;
+          const resPath = new URL(current_url).pathname;
+          if (reqHost !== resHost)
+            redirect_type = "canonical";
+          else if (resPath.match(/\/[a-z]{2}-[a-z]{2}\//))
+            redirect_type = "geo";
+          else if (current_url.includes("login") || current_url.includes("signin"))
+            redirect_type = "auth";
+          else
+            redirect_type = "unknown";
+        } catch {}
+      }
+      try {
+        const session = getSession2(session_id);
+        if (!session.name) {
+          const hostname = new URL(current_url).hostname;
+          renameSession2(session_id, hostname);
+        }
+      } catch {}
+      const result = {
+        url,
+        title,
+        current_url,
+        redirected,
+        ...redirect_type ? { redirect_type } : {}
+      };
       if (auto_thumbnail) {
         try {
           const ss = await takeScreenshot(page, { maxWidth: 400, quality: 60, track: false, thumbnail: false });
           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);
-          result.snapshot_preview = snap.tree.slice(0, 3000);
+          setLastSnapshot(session_id, snap);
+          const refEntries = Object.entries(snap.refs).slice(0, 30);
+          result.snapshot_refs = refEntries.map(([ref, info]) => `${info.role}:${info.name.slice(0, 50)} [${ref}]`).join(", ");
           result.interactive_count = snap.interactive_count;
           result.has_errors = getConsoleLog(session_id, "error").length > 0;
         } catch {}
@@ -15558,7 +16234,7 @@ var init_mcp = __esm(async () => {
       return err(e);
     }
   });
-  server.tool("browser_check", "Check or uncheck a checkbox by ref or selector", { session_id: exports_external.string(), selector: exports_external.string().optional(), ref: exports_external.string().optional(), checked: exports_external.boolean() }, async ({ session_id, selector, ref, checked }) => {
+  server.tool("browser_toggle", "Check or uncheck a checkbox by ref or selector", { session_id: exports_external.string(), selector: exports_external.string().optional(), ref: exports_external.string().optional(), checked: exports_external.boolean() }, async ({ session_id, selector, ref, checked }) => {
     try {
       const page = getSessionPage(session_id);
       if (ref) {
@@ -15649,12 +16325,33 @@ var init_mcp = __esm(async () => {
       return err(e);
     }
   });
-  server.tool("browser_snapshot", "Get a structured accessibility snapshot with element refs (@e0, @e1...). Use refs in browser_click, browser_type, etc.", { session_id: exports_external.string() }, async ({ session_id }) => {
+  server.tool("browser_snapshot", "Get accessibility snapshot with element refs (@e0, @e1...). Use compact=true (default) for token-efficient output. Use refs in browser_click, browser_type, etc.", {
+    session_id: exports_external.string(),
+    compact: exports_external.boolean().optional().default(true),
+    max_refs: exports_external.number().optional().default(50),
+    full_tree: exports_external.boolean().optional().default(false)
+  }, async ({ session_id, compact, max_refs, full_tree }) => {
     try {
       const page = getSessionPage(session_id);
       const result = await takeSnapshot(page, session_id);
       setLastSnapshot(session_id, result);
-      return json({ snapshot: result.tree, refs: result.refs, interactive_count: result.interactive_count });
+      const refEntries = Object.entries(result.refs).slice(0, max_refs);
+      const limitedRefs = Object.fromEntries(refEntries);
+      const truncated = Object.keys(result.refs).length > max_refs;
+      if (compact && !full_tree) {
+        const compactRefs = refEntries.map(([ref, info]) => `${info.role}:${info.name.slice(0, 60)} [${ref}]${info.checked !== undefined ? ` checked=${info.checked}` : ""}${!info.enabled ? " disabled" : ""}`).join(`
+`);
+        return json({
+          snapshot_compact: compactRefs,
+          interactive_count: result.interactive_count,
+          shown_count: refEntries.length,
+          truncated,
+          refs: limitedRefs
+        });
+      }
+      const tree = full_tree ? result.tree : result.tree.slice(0, 5000) + (result.tree.length > 5000 ? `
+... (truncated \u2014 use full_tree=true for complete)` : "");
+      return json({ snapshot: tree, refs: limitedRefs, interactive_count: result.interactive_count, truncated });
     } catch (e) {
       return err(e);
     }
@@ -15933,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, {
@@ -16136,40 +16833,6 @@ var init_mcp = __esm(async () => {
       return err(e);
     }
   });
-  server.tool("browser_page_check", "One-call page summary: page info + console errors + performance metrics + thumbnail + accessibility snapshot preview. Replaces 4-5 separate tool calls.", { session_id: exports_external.string() }, async ({ session_id }) => {
-    try {
-      const page = getSessionPage(session_id);
-      const info = await getPageInfo(page);
-      const errors2 = getConsoleLog(session_id, "error");
-      info.has_console_errors = errors2.length > 0;
-      let perf = {};
-      try {
-        perf = await getPerformanceMetrics(page);
-      } catch {}
-      let thumbnail_base64 = "";
-      try {
-        const ss = await takeScreenshot(page, { maxWidth: 400, quality: 60, track: false, thumbnail: false });
-        thumbnail_base64 = ss.base64;
-      } catch {}
-      let snapshot_preview = "";
-      let interactive_count = 0;
-      try {
-        const snap = await takeSnapshot(page, session_id);
-        snapshot_preview = snap.tree.slice(0, 2000);
-        interactive_count = snap.interactive_count;
-      } catch {}
-      return json({
-        ...info,
-        error_count: errors2.length,
-        performance: perf,
-        thumbnail_base64: thumbnail_base64.length > 50000 ? "" : thumbnail_base64,
-        snapshot_preview,
-        interactive_count
-      });
-    } catch (e) {
-      return err(e);
-    }
-  });
   server.tool("browser_gallery_list", "List screenshot gallery entries with optional filters", {
     project_id: exports_external.string().optional(),
     session_id: exports_external.string().optional(),
@@ -16494,7 +17157,7 @@ var init_mcp = __esm(async () => {
           { tool: "browser_hover", description: "Hover over an element" },
           { tool: "browser_scroll", description: "Scroll the page" },
           { tool: "browser_select", description: "Select a dropdown option" },
-          { tool: "browser_check", description: "Check/uncheck a checkbox" },
+          { tool: "browser_toggle", description: "Check/uncheck a checkbox" },
           { tool: "browser_upload", description: "Upload a file to an input" },
           { tool: "browser_press_key", description: "Press a keyboard key" },
           { tool: "browser_wait", description: "Wait for a selector to appear" },
@@ -16514,9 +17177,10 @@ var init_mcp = __esm(async () => {
           { tool: "browser_evaluate", description: "Execute JavaScript in page context" }
         ],
         Capture: [
-          { tool: "browser_screenshot", description: "Take a screenshot (PNG/JPEG/WebP)" },
+          { tool: "browser_screenshot", description: "Take a screenshot (PNG/JPEG/WebP, annotate=true for labels)" },
           { tool: "browser_pdf", description: "Generate a PDF of the page" },
-          { tool: "browser_scroll_and_screenshot", description: "Scroll then screenshot in one call" }
+          { tool: "browser_scroll_and_screenshot", description: "Scroll then screenshot in one call" },
+          { tool: "browser_scroll_to_element", description: "Scroll element into view + screenshot" }
         ],
         Storage: [
           { tool: "browser_cookies_get", description: "Get cookies" },
@@ -16595,7 +17259,8 @@ var init_mcp = __esm(async () => {
           { tool: "browser_tab_close", description: "Close a tab by index" }
         ],
         Meta: [
-          { tool: "browser_page_check", description: "One-call page summary with diagnostics" },
+          { tool: "browser_check", description: "RECOMMENDED: One-call page summary with diagnostics" },
+          { tool: "browser_version", description: "Show running binary version and tool count" },
           { tool: "browser_help", description: "Show this help (all tools)" },
           { tool: "browser_snapshot_diff", description: "Diff current snapshot vs previous" },
           { tool: "browser_watch_start", description: "Watch page for DOM changes" },
@@ -16609,6 +17274,88 @@ var init_mcp = __esm(async () => {
       return err(e);
     }
   });
+  server.tool("browser_version", "Get the running browser MCP version, tool count, and environment info. Use this to verify which binary is active.", {}, async () => {
+    try {
+      const { getDataDir: getDataDir4 } = await Promise.resolve().then(() => (init_schema(), exports_schema));
+      const toolCount = Object.keys(server._registeredTools ?? {}).length;
+      return json({
+        version: _pkg.version,
+        mcp_tools_count: toolCount,
+        bun_version: Bun.version,
+        data_dir: getDataDir4(),
+        node_env: process.env["NODE_ENV"] ?? "production"
+      });
+    } catch (e) {
+      return err(e);
+    }
+  });
+  server.tool("browser_scroll_to_element", "Scroll an element into view (by ref or selector) then optionally take a screenshot of it. Replaces scroll + wait + screenshot pattern.", {
+    session_id: exports_external.string(),
+    selector: exports_external.string().optional(),
+    ref: exports_external.string().optional(),
+    screenshot: exports_external.boolean().optional().default(true),
+    wait_ms: exports_external.number().optional().default(200)
+  }, async ({ session_id, selector, ref, screenshot: doScreenshot, wait_ms }) => {
+    try {
+      const page = getSessionPage(session_id);
+      let locator;
+      if (ref) {
+        const { getRefLocator: getRefLocator2 } = await Promise.resolve().then(() => (init_snapshot(), exports_snapshot));
+        locator = getRefLocator2(page, session_id, ref);
+      } else if (selector) {
+        locator = page.locator(selector).first();
+      } else {
+        return err(new Error("Either ref or selector is required"));
+      }
+      await locator.scrollIntoViewIfNeeded();
+      await new Promise((r) => setTimeout(r, wait_ms));
+      const result = { scrolled: ref ?? selector };
+      if (doScreenshot) {
+        try {
+          const ss = await takeScreenshot(page, { selector, track: false });
+          ss.url = page.url();
+          if (ss.base64.length > 50000) {
+            ss.base64_truncated = true;
+            ss.base64 = ss.thumbnail_base64 ?? "";
+          }
+          result.screenshot = ss;
+        } catch {}
+      }
+      return json(result);
+    } catch (e) {
+      return err(e);
+    }
+  });
+  server.tool("browser_check", "RECOMMENDED FIRST CALL: one-shot page summary \u2014 url, title, errors, performance, thumbnail, refs. Replaces 4+ separate tool calls.", { session_id: exports_external.string() }, async ({ session_id }) => {
+    try {
+      const page = getSessionPage(session_id);
+      const info = await getPageInfo(page);
+      const errors2 = getConsoleLog(session_id, "error");
+      info.has_console_errors = errors2.length > 0;
+      let perf = {};
+      try {
+        perf = await getPerformanceMetrics(page);
+      } catch {}
+      let thumbnail_base64 = "";
+      try {
+        const ss = await takeScreenshot(page, { maxWidth: 400, quality: 60, track: false, thumbnail: false });
+        thumbnail_base64 = ss.base64.length > 50000 ? "" : ss.base64;
+      } catch {}
+      let snapshot_refs = "";
+      let interactive_count = 0;
+      try {
+        const snap = await takeSnapshot(page, session_id);
+        setLastSnapshot(session_id, snap);
+        interactive_count = snap.interactive_count;
+        snapshot_refs = Object.entries(snap.refs).slice(0, 30).map(([ref, i]) => `${i.role}:${i.name.slice(0, 50)} [${ref}]`).join(", ");
+      } catch {}
+      return json({ ...info, error_count: errors2.length, performance: perf, thumbnail_base64, snapshot_refs, interactive_count });
+    } catch (e) {
+      return err(e);
+    }
+  });
+  _startupToolCount = Object.keys(server._registeredTools ?? {}).length;
+  console.error(`@hasna/browser v${_pkg.version} \u2014 ${_startupToolCount} tools | data: ${(await Promise.resolve().then(() => (init_schema(), exports_schema))).getDataDir()}`);
   transport = new StdioServerTransport;
   await server.connect(transport);
 });
@@ -16651,7 +17398,7 @@ var init_snapshots = __esm(() => {
 
 // src/server/index.ts
 var exports_server = {};
-import { join as join7 } 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), {
@@ -16945,13 +17692,13 @@ var init_server = __esm(() => {
           const id = path.split("/")[3];
           return ok({ deleted: deleteDownload(id) });
         }
-        const dashboardDist = join7(import.meta.dir, "../../dashboard/dist");
+        const dashboardDist = join9(import.meta.dir, "../../dashboard/dist");
         if (existsSync4(dashboardDist)) {
-          const filePath = path === "/" ? join7(dashboardDist, "index.html") : join7(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(join7(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.", {
@@ -16993,10 +17740,10 @@ init_projects();
 init_recorder();
 init_recordings();
 init_lightpanda();
-import { readFileSync as readFileSync3 } from "fs";
-import { join as join8 } from "path";
+import { readFileSync as readFileSync4 } from "fs";
+import { join as join10 } from "path";
 import chalk from "chalk";
-var pkg = JSON.parse(readFileSync3(join8(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) => {