@hasna/browser 0.0.3 → 0.0.5

package/dist/mcp/index.js

@@ -30,6 +30,12 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
 // 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";
@@ -55,6 +61,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 (
@@ -252,13 +267,34 @@ var init_console_log = __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();
@@ -360,6 +396,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}`;
 }
@@ -398,6 +449,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;
@@ -6833,7 +6949,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();
@@ -6872,7 +6989,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);
@@ -10855,6 +10972,10 @@ var coerce = {
   date: (arg) => ZodDate.create({ ...arg, coerce: true })
 };
 var NEVER = INVALID;
+// src/mcp/index.ts
+import { readFileSync as readFileSync3 } from "fs";
+import { join as join8 } from "path";
+
 // src/types/index.ts
 class BrowserError extends Error {
   code;
@@ -10922,7 +11043,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) {
@@ -11092,14 +11220,413 @@ async function connectLightpanda(port) {
   }
 }
 
+// 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;
+}
+
+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
 var 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",
@@ -11113,6 +11640,14 @@ 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";
   }
@@ -11404,12 +11939,30 @@ async function handleDialog(sessionId, action, promptText) {
 
 // src/lib/session.ts
 var handles = new Map;
+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();
@@ -11419,41 +11972,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 };
@@ -11463,13 +12042,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)
@@ -11484,12 +12073,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);
@@ -11825,9 +12421,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) {
@@ -11918,9 +12524,9 @@ async function getPageInfo(page) {
 
 // src/lib/screenshot.ts
 var import_sharp = __toESM(require_lib(), 1);
-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";
 
 // src/db/gallery.ts
 init_schema();
@@ -12066,13 +12672,13 @@ function getGalleryStats(projectId) {
 
 // src/lib/screenshot.ts
 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) {
@@ -12087,7 +12693,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") };
@@ -12106,27 +12712,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;
@@ -12148,7 +12772,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 {
@@ -12185,12 +12810,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",
@@ -12713,16 +13338,16 @@ init_console_log();
 
 // src/lib/downloads.ts
 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 metaPath(filePath) {
@@ -12734,7 +13359,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,
@@ -12769,7 +13394,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);
@@ -12854,9 +13479,9 @@ function detectType(filename) {
 
 // src/lib/gallery-diff.ts
 var import_sharp2 = __toESM(require_lib(), 1);
-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);
@@ -12887,10 +13512,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 {
@@ -12906,9 +13531,9 @@ async function diffImages(path1, path2) {
 init_snapshot();
 
 // 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");
@@ -12917,12 +13542,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()}`,
@@ -13014,23 +13639,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(() => {
@@ -13042,11 +13667,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,
@@ -13056,13 +13681,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();
@@ -13103,24 +13728,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;
@@ -13137,7 +13762,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 {
@@ -13149,6 +13774,7 @@ function deleteProfile(name) {
 }
 
 // src/mcp/index.ts
+var _pkg = JSON.parse(readFileSync3(join8(import.meta.dir, "../../package.json"), "utf8"));
 var networkLogCleanup = new Map;
 var consoleCaptureCleanup = new Map;
 var harCaptures = new Map;
@@ -13168,7 +13794,7 @@ var server = new McpServer({
   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(),
@@ -13214,23 +13840,71 @@ server.tool("browser_session_close", "Close a browser session", { session_id: ex
     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 {}
@@ -13336,7 +14010,7 @@ server.tool("browser_select", "Select a dropdown option by ref or selector", { s
     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) {
@@ -13427,12 +14101,33 @@ server.tool("browser_find", "Find elements matching a selector and return their
     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);
   }
@@ -13711,7 +14406,7 @@ server.tool("browser_crawl", "Crawl a URL recursively and return discovered page
   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, {
@@ -13914,40 +14609,6 @@ server.tool("browser_watch_stop", "Stop a DOM change watcher", { watch_id: expor
     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(),
@@ -14272,7 +14933,7 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { 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" },
@@ -14292,9 +14953,10 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { 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" },
@@ -14373,7 +15035,8 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { 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" },
@@ -14387,5 +15050,87 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
     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);
+  }
+});
+var _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()}`);
 var transport = new StdioServerTransport;
 await server.connect(transport);