@hasna/browser 0.3.8 → 0.4.1

package/dist/mcp/index.js

@@ -6,60 +6,39 @@ var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toESMCache_node;
-var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
-  var canCache = mod != null && typeof mod === "object";
-  if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
-    var cached = cache.get(mod);
-    if (cached)
-      return cached;
-  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: __accessProp.bind(mod, key),
+        get: () => mod[key],
         enumerable: true
       });
-  if (canCache)
-    cache.set(mod, to);
   return to;
 };
+var __moduleCache = /* @__PURE__ */ new WeakMap;
 var __toCommonJS = (from) => {
-  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  var entry = __moduleCache.get(from), desc;
   if (entry)
     return entry;
   entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (var key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(entry, key))
-        __defProp(entry, key, {
-          get: __accessProp.bind(from, key),
-          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-        });
-  }
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
   __moduleCache.set(from, entry);
   return entry;
 };
-var __moduleCache;
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: __exportSetter.bind(all, name)
+      set: (newValue) => all[name] = () => newValue
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -143,11 +122,11 @@ import { homedir as homedir4 } from "os";
 import { join as join4 } from "path";
 import { join as join6, dirname } from "path";
 import { homedir as homedir5, platform } from "os";
-function __accessProp2(key) {
+function __accessProp(key) {
   return this[key];
 }
-function __exportSetter2(name, newValue) {
-  this[name] = __returnValue2.bind(null, newValue);
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
 }
 function translateSql(sql, dialect) {
   if (dialect === "sqlite")
@@ -1177,10 +1156,10 @@ class SyncProgressTracker {
     }
   }
 }
-var __create2, __getProtoOf2, __defProp2, __getOwnPropNames2, __hasOwnProp2, __toESMCache_node2, __toESMCache_esm2, __toESM2 = (mod, isNodeMode, target) => {
+var __create2, __getProtoOf2, __defProp2, __getOwnPropNames2, __hasOwnProp2, __toESMCache_node, __toESMCache_esm, __toESM2 = (mod, isNodeMode, target) => {
   var canCache = mod != null && typeof mod === "object";
   if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node2 ??= new WeakMap : __toESMCache_esm2 ??= new WeakMap;
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
     var cached = cache.get(mod);
     if (cached)
       return cached;
@@ -1190,19 +1169,19 @@ var __create2, __getProtoOf2, __defProp2, __getOwnPropNames2, __hasOwnProp2, __t
   for (let key of __getOwnPropNames2(mod))
     if (!__hasOwnProp2.call(to, key))
       __defProp2(to, key, {
-        get: __accessProp2.bind(mod, key),
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
   if (canCache)
     cache.set(mod, to);
   return to;
-}, __commonJS2 = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports), __returnValue2 = (v) => v, __export2 = (target, all) => {
+}, __commonJS2 = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports), __returnValue = (v) => v, __export2 = (target, all) => {
   for (var name in all)
     __defProp2(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: __exportSetter2.bind(all, name)
+      set: __exportSetter.bind(all, name)
     });
 }, __esm2 = (fn, res) => () => (fn && (res = fn(fn = 0)), res), __require2, require_postgres_array, require_arrayParser, require_postgres_date, require_mutable, require_postgres_interval, require_postgres_bytea, require_textParsers, require_pg_int8, require_binaryParsers, require_builtins, require_pg_types, require_defaults, require_utils, require_utils_legacy, require_utils_webcrypto, require_utils2, require_cert_signatures, require_sasl, require_type_overrides, require_pg_connection_string, require_connection_parameters, require_result, require_query, require_messages, require_buffer_writer, require_serializer, require_buffer_reader, require_parser, require_dist, require_empty, require_stream, require_connection, require_split2, require_helper, require_lib, require_client, require_pg_pool, require_query2, require_client2, require_lib2, import_lib, Client, Pool, Connection, types2, Query, DatabaseError, escapeIdentifier, escapeLiteral, Result, TypeOverrides, defaults, esm_default, init_esm, init_adapter, util3, objectUtil2, ZodParsedType2, getParsedType2 = (data) => {
   const t = typeof data;
@@ -10619,6 +10598,89 @@ var init_bun_webview = __esm(() => {
   };
 });
 
+// src/engines/tui.ts
+import { execSync as execSync2, spawn as spawn2 } from "child_process";
+function isTuiAvailable() {
+  try {
+    execSync2("which ttyd", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findAvailablePort(startPort) {
+  let port = startPort;
+  for (let i = 0;i < 100; i++) {
+    try {
+      const resp = await fetch(`http://localhost:${port}`);
+      port++;
+    } catch {
+      return port;
+    }
+  }
+  throw new BrowserError("No available port found for ttyd", "TUI_PORT_EXHAUSTED");
+}
+async function waitForTtyd(port, timeoutMs = 1e4) {
+  const start = Date.now();
+  while (Date.now() - start < timeoutMs) {
+    try {
+      const resp = await fetch(`http://localhost:${port}`);
+      if (resp.ok || resp.status === 200)
+        return;
+    } catch {}
+    await new Promise((r) => setTimeout(r, 150));
+  }
+  throw new BrowserError(`ttyd did not start within ${timeoutMs}ms`, "TUI_TIMEOUT");
+}
+async function launchTui(command, options = {}) {
+  if (!isTuiAvailable()) {
+    throw new BrowserError("ttyd not found \u2014 install with: brew install ttyd", "TUI_NOT_AVAILABLE");
+  }
+  const port = await findAvailablePort(nextPort);
+  nextPort = port + 1;
+  const ttydProcess = spawn2("ttyd", ["--writable", "--port", String(port), "/bin/sh", "-c", command], {
+    stdio: "ignore",
+    detached: false
+  });
+  ttydProcess.on("error", (err) => {
+    console.error(`[tui] ttyd process error: ${err.message}`);
+  });
+  try {
+    await waitForTtyd(port);
+    const viewport = options.viewport ?? { width: 1280, height: 720 };
+    const browser = await launchPlaywright({
+      headless: options.headless ?? true,
+      viewport
+    });
+    const page = await getPage(browser, { viewport });
+    await page.goto(`http://localhost:${port}`, {
+      waitUntil: "domcontentloaded"
+    });
+    await page.waitForSelector(".xterm-screen", { timeout: 1e4 });
+    return { ttydProcess, port, browser, page };
+  } catch (err) {
+    ttydProcess.kill();
+    throw err;
+  }
+}
+async function closeTui(session) {
+  try {
+    await session.page.close();
+  } catch {}
+  try {
+    await session.browser.close();
+  } catch {}
+  try {
+    session.ttydProcess.kill("SIGTERM");
+  } catch {}
+}
+var DEFAULT_TTYD_PORT_START = 7780, nextPort;
+var init_tui = __esm(() => {
+  init_types();
+  init_playwright();
+  nextPort = DEFAULT_TTYD_PORT_START;
+});
+
 // src/engines/selector.ts
 function selectEngine(useCase, explicit) {
   if (explicit && explicit !== "auto")
@@ -10642,6 +10704,7 @@ var init_selector = __esm(() => {
   init_types();
   init_lightpanda();
   init_bun_webview();
+  init_tui();
   ENGINE_MAP = {
     ["scrape" /* SCRAPE */]: "bun",
     ["extract_links" /* EXTRACT_LINKS */]: "bun",
@@ -10652,6 +10715,7 @@ var init_selector = __esm(() => {
     ["auth_flow" /* AUTH_FLOW */]: "playwright",
     ["multi_tab" /* MULTI_TAB */]: "playwright",
     ["record_replay" /* RECORD_REPLAY */]: "playwright",
+    ["terminal_test" /* TERMINAL_TEST */]: "tui",
     ["network_monitor" /* NETWORK_MONITOR */]: "cdp",
     ["har_capture" /* HAR_CAPTURE */]: "cdp",
     ["perf_profile" /* PERF_PROFILE */]: "cdp",
@@ -12017,7 +12081,7 @@ async function createSession2(opts = {}) {
     try {
       cleanups2.push(setupDialogHandler(page2, session2.id));
     } catch {}
-    handles.set(session2.id, { browser: cdpBrowser, bunView: null, page: page2, engine: "cdp", cleanups: cleanups2, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
+    handles.set(session2.id, { browser: cdpBrowser, bunView: null, tuiSession: null, page: page2, engine: "cdp", cleanups: cleanups2, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
     return { session: session2, page: page2 };
   }
   const engine = opts.engine === "auto" || !opts.engine ? selectEngine(opts.useCase ?? "spa_navigate" /* SPA_NAVIGATE */, opts.engine) : opts.engine;
@@ -12043,6 +12107,38 @@ async function createSession2(opts = {}) {
     browser = await connectLightpanda();
     const context = await browser.newContext({ viewport: opts.viewport ?? { width: 1280, height: 720 } });
     page = await context.newPage();
+  } else if (resolvedEngine === "tui") {
+    const command = opts.startUrl ?? "bash";
+    const tuiSess = await launchTui(command, {
+      headless: opts.headless ?? true,
+      viewport: opts.viewport
+    });
+    browser = tuiSess.browser;
+    page = tuiSess.page;
+    const session2 = createSession({
+      engine: "tui",
+      projectId: opts.projectId,
+      agentId: opts.agentId,
+      startUrl: opts.startUrl,
+      name: opts.name ?? "tui"
+    });
+    const cleanups2 = [];
+    cleanups2.push(() => closeTui(tuiSess));
+    if (opts.captureNetwork !== false) {
+      try {
+        cleanups2.push(enableNetworkLogging(page, session2.id));
+      } catch {}
+    }
+    if (opts.captureConsole !== false) {
+      try {
+        cleanups2.push(enableConsoleCapture(page, session2.id));
+      } catch {}
+    }
+    try {
+      cleanups2.push(setupDialogHandler(page, session2.id));
+    } catch {}
+    handles.set(session2.id, { browser, bunView: null, tuiSession: tuiSess, page, engine: "tui", cleanups: cleanups2, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
+    return { session: session2, page };
   } else {
     browser = await pool.acquire(opts.headless ?? true);
     if (opts.storageState) {
@@ -12113,7 +12209,7 @@ async function createSession2(opts = {}) {
       } catch {}
     }
   }
-  handles.set(session.id, { browser, bunView, page, engine: bunView ? "bun" : resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
+  handles.set(session.id, { browser, bunView, tuiSession: null, page, engine: bunView ? "bun" : resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 }, lastActivity: Date.now(), autoGallery: opts.autoGallery ?? false });
   if (opts.startUrl) {
     try {
       if (bunView) {
@@ -12183,7 +12279,7 @@ async function closeSession2(sessionId) {
       try {
         await handle.bunView.close();
       } catch {}
-    } else {
+    } else if (handle.tuiSession) {} else {
       try {
         await handle.page.context().close();
       } catch {}
@@ -12283,6 +12379,7 @@ var init_session = __esm(() => {
   init_lightpanda();
   init_bun_webview();
   init_selector();
+  init_tui();
   init_network();
   init_console();
   init_stealth();
@@ -19396,6 +19493,63 @@ var init_agents2 = __esm(() => {
   init_agents();
 });
 
+// src/lib/gallery-diff.ts
+var exports_gallery_diff = {};
+__export(exports_gallery_diff, {
+  diffImages: () => diffImages
+});
+import { join as join11 } from "path";
+import { mkdirSync as mkdirSync9 } from "fs";
+async function diffImages(path1, path2) {
+  const img1 = import_sharp2.default(path1);
+  const img2 = import_sharp2.default(path2);
+  const [meta1, meta2] = await Promise.all([img1.metadata(), img2.metadata()]);
+  const w = Math.min(meta1.width ?? 1280, meta2.width ?? 1280);
+  const h = Math.min(meta1.height ?? 720, meta2.height ?? 720);
+  const [raw1, raw2] = await Promise.all([
+    import_sharp2.default(path1).resize(w, h, { fit: "fill" }).raw().toBuffer(),
+    import_sharp2.default(path2).resize(w, h, { fit: "fill" }).raw().toBuffer()
+  ]);
+  const totalPixels = w * h;
+  const channels = 3;
+  const diffBuffer = Buffer.alloc(raw1.length);
+  let changedPixels = 0;
+  for (let i = 0;i < raw1.length; i += channels) {
+    const dr = Math.abs(raw1[i] - raw2[i]);
+    const dg = Math.abs(raw1[i + 1] - raw2[i + 1]);
+    const db = Math.abs(raw1[i + 2] - raw2[i + 2]);
+    const diff = (dr + dg + db) / 3;
+    if (diff > 10) {
+      changedPixels++;
+      diffBuffer[i] = 255;
+      diffBuffer[i + 1] = 0;
+      diffBuffer[i + 2] = 0;
+    } else {
+      diffBuffer[i] = Math.round(raw1[i] * 0.4);
+      diffBuffer[i + 1] = Math.round(raw1[i + 1] * 0.4);
+      diffBuffer[i + 2] = Math.round(raw1[i + 2] * 0.4);
+    }
+  }
+  const dataDir = getDataDir2();
+  const diffDir = join11(dataDir, "diffs");
+  mkdirSync9(diffDir, { recursive: true });
+  const diffPath = join11(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 {
+    diff_path: diffPath,
+    diff_base64: diffImageBuffer.toString("base64"),
+    changed_pixels: changedPixels,
+    total_pixels: totalPixels,
+    changed_percent: changedPixels / totalPixels * 100
+  };
+}
+var import_sharp2;
+var init_gallery_diff = __esm(() => {
+  init_schema();
+  import_sharp2 = __toESM(require_lib3(), 1);
+});
+
 // src/lib/profiles.ts
 var exports_profiles = {};
 __export(exports_profiles, {
@@ -24010,8 +24164,8 @@ import { join as join33 } from "path";
 import { existsSync as existsSync43, mkdirSync as mkdirSync4, readFileSync as readFileSync33, writeFileSync as writeFileSync33 } from "fs";
 import { homedir as homedir33 } from "os";
 import { join as join43 } from "path";
-function __exportSetter3(name, newValue) {
-  this[name] = __returnValue3.bind(null, newValue);
+function __exportSetter2(name, newValue) {
+  this[name] = __returnValue2.bind(null, newValue);
 }
 function isInMemoryDb(path) {
   return path === ":memory:" || path.startsWith("file::memory:");
@@ -27125,13 +27279,13 @@ function clearActiveModel() {
   delete config.activeModel;
   writeConfig(config);
 }
-var __defProp3, __returnValue3 = (v) => v, __export3 = (target, all) => {
+var __defProp3, __returnValue2 = (v) => v, __export3 = (target, all) => {
   for (var name in all)
     __defProp3(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: __exportSetter3.bind(all, name)
+      set: __exportSetter2.bind(all, name)
     });
 }, __esm3 = (fn, res) => () => (fn && (res = fn(fn = 0)), res), exports_database, MIGRATIONS, _db2 = null, init_database, AgentConflictError, EntityNotFoundError, MemoryNotFoundError, DuplicateMemoryError, MemoryExpiredError, InvalidScopeError, VersionConflictError, MemoryConflictError, OPENAI_EMBED_URL = "https://api.openai.com/v1/embeddings", EMBED_MODEL = "text-embedding-3-small", EMBED_DIMENSIONS = 1536, REDACTED = "[REDACTED]", SECRET_PATTERNS, _idCounter = 0, hookRegistry, INSTRUCTION_PATTERNS, PROMOTIONAL_PATTERNS, RECALL_PROMOTE_THRESHOLD = 3, CONFLICT_WINDOW_MS, MEMORY_WRITE_TTL = 30, MemoryLockConflictError, sessionFocus, STOP_WORDS, DEFAULT_CONFIG, VALID_SCOPES, VALID_CATEGORIES, defaultSyncAgents, DEFAULT_AUTO_MEMORY_CONFIG, MEMORY_EXTRACTION_SYSTEM_PROMPT = `You are a precise memory extraction engine for an AI agent.
 Given text, extract facts worth remembering as structured JSON.
@@ -28654,11 +28808,11 @@ import { randomUUID as randomUUID22 } from "crypto";
 import { readFileSync as readFileSync24, writeFileSync as writeFileSync7, mkdirSync as mkdirSync34 } from "fs";
 import { join as join44, dirname as dirname24 } from "path";
 import { homedir as homedir42 } from "os";
-function __accessProp3(key) {
+function __accessProp2(key) {
   return this[key];
 }
-function __exportSetter4(name, newValue) {
-  this[name] = __returnValue4.bind(null, newValue);
+function __exportSetter3(name, newValue) {
+  this[name] = __returnValue3.bind(null, newValue);
 }
 function getDbPath3() {
   if (process.env.CONVERSATIONS_DB_PATH)
@@ -30643,10 +30797,10 @@ function getGraphStats() {
     map[r.relation] = r.c;
   return { total_edges: total, by_relation: map };
 }
-var __create3, __getProtoOf3, __defProp4, __getOwnPropNames3, __getOwnPropDesc2, __hasOwnProp3, __toESMCache_node3, __toESMCache_esm3, __toESM3 = (mod, isNodeMode, target) => {
+var __create3, __getProtoOf3, __defProp4, __getOwnPropNames3, __getOwnPropDesc2, __hasOwnProp3, __toESMCache_node2, __toESMCache_esm2, __toESM3 = (mod, isNodeMode, target) => {
   var canCache = mod != null && typeof mod === "object";
   if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node3 ??= new WeakMap : __toESMCache_esm3 ??= new WeakMap;
+    var cache = isNodeMode ? __toESMCache_node2 ??= new WeakMap : __toESMCache_esm2 ??= new WeakMap;
     var cached = cache.get(mod);
     if (cached)
       return cached;
@@ -30656,7 +30810,7 @@ var __create3, __getProtoOf3, __defProp4, __getOwnPropNames3, __getOwnPropDesc2,
   for (let key of __getOwnPropNames3(mod))
     if (!__hasOwnProp3.call(to, key))
       __defProp4(to, key, {
-        get: __accessProp3.bind(mod, key),
+        get: __accessProp2.bind(mod, key),
         enumerable: true
       });
   if (canCache)
@@ -30671,19 +30825,19 @@ var __create3, __getProtoOf3, __defProp4, __getOwnPropNames3, __getOwnPropDesc2,
     for (var key of __getOwnPropNames3(from))
       if (!__hasOwnProp3.call(entry, key))
         __defProp4(entry, key, {
-          get: __accessProp3.bind(from, key),
+          get: __accessProp2.bind(from, key),
           enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable
         });
   }
   __moduleCache2.set(from, entry);
   return entry;
-}, __moduleCache2, __commonJS3 = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports), __returnValue4 = (v) => v, __export4 = (target, all) => {
+}, __moduleCache2, __commonJS3 = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports), __returnValue3 = (v) => v, __export4 = (target, all) => {
   for (var name in all)
     __defProp4(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: __exportSetter4.bind(all, name)
+      set: __exportSetter3.bind(all, name)
     });
 }, exports_db, db = null, init_db = () => {}, require_react_development, require_react, cachedConfig = null, configLoadedAt = 0, CONFIG_CACHE_MS = 1e4, import_react, AGENT_NAMES, AGENT_ID_FILE, cachedAutoName = null, ONLINE_THRESHOLD_SECONDS = 60, CONFLICT_THRESHOLD_SECONDS, DEFAULT_LOCK_EXPIRY_MS, STALE_HEARTBEAT_SECONDS, STOPWORDS;
 var init_dist4 = __esm(() => {
@@ -33297,7 +33451,7 @@ import { existsSync as existsSync62 } from "fs";
 import { join as join62 } from "path";
 import { readFileSync as readFileSync43, statSync as statSync22 } from "fs";
 import { relative as relative2, resolve as resolve23, join as join72 } from "path";
-import { execSync as execSync2 } from "child_process";
+import { execSync as execSync3 } from "child_process";
 
 class TodosClient {
   baseUrl;
@@ -37645,7 +37799,7 @@ function parseGitHubUrl(url) {
   return { owner: match[1], repo: match[2], number: parseInt(match[3], 10) };
 }
 function fetchGitHubIssue(owner, repo, number) {
-  const json2 = execSync2(`gh api repos/${owner}/${repo}/issues/${number}`, { encoding: "utf-8", timeout: 15000 });
+  const json2 = execSync3(`gh api repos/${owner}/${repo}/issues/${number}`, { encoding: "utf-8", timeout: 15000 });
   const data = JSON.parse(json2);
   return {
     number: data.number,
@@ -43483,57 +43637,9 @@ function detectType(filename) {
   };
   return map[ext] ?? "file";
 }
-// src/lib/gallery-diff.ts
-init_schema();
-var import_sharp2 = __toESM(require_lib3(), 1);
-import { join as join11 } from "path";
-import { mkdirSync as mkdirSync9 } from "fs";
-async function diffImages(path1, path2) {
-  const img1 = import_sharp2.default(path1);
-  const img2 = import_sharp2.default(path2);
-  const [meta1, meta2] = await Promise.all([img1.metadata(), img2.metadata()]);
-  const w = Math.min(meta1.width ?? 1280, meta2.width ?? 1280);
-  const h = Math.min(meta1.height ?? 720, meta2.height ?? 720);
-  const [raw1, raw2] = await Promise.all([
-    import_sharp2.default(path1).resize(w, h, { fit: "fill" }).raw().toBuffer(),
-    import_sharp2.default(path2).resize(w, h, { fit: "fill" }).raw().toBuffer()
-  ]);
-  const totalPixels = w * h;
-  const channels = 3;
-  const diffBuffer = Buffer.alloc(raw1.length);
-  let changedPixels = 0;
-  for (let i = 0;i < raw1.length; i += channels) {
-    const dr = Math.abs(raw1[i] - raw2[i]);
-    const dg = Math.abs(raw1[i + 1] - raw2[i + 1]);
-    const db = Math.abs(raw1[i + 2] - raw2[i + 2]);
-    const diff = (dr + dg + db) / 3;
-    if (diff > 10) {
-      changedPixels++;
-      diffBuffer[i] = 255;
-      diffBuffer[i + 1] = 0;
-      diffBuffer[i + 2] = 0;
-    } else {
-      diffBuffer[i] = Math.round(raw1[i] * 0.4);
-      diffBuffer[i + 1] = Math.round(raw1[i + 1] * 0.4);
-      diffBuffer[i + 2] = Math.round(raw1[i + 2] * 0.4);
-    }
-  }
-  const dataDir = getDataDir2();
-  const diffDir = join11(dataDir, "diffs");
-  mkdirSync9(diffDir, { recursive: true });
-  const diffPath = join11(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 {
-    diff_path: diffPath,
-    diff_base64: diffImageBuffer.toString("base64"),
-    changed_pixels: changedPixels,
-    total_pixels: totalPixels,
-    changed_percent: changedPixels / totalPixels * 100
-  };
-}
 
 // src/mcp/helpers.ts
+init_gallery_diff();
 init_snapshot();
 
 // src/lib/files-integration.ts
@@ -43710,7 +43816,7 @@ function resolveSessionId(sessionId) {
 // src/mcp/sessions.ts
 function register(server) {
   server.tool("browser_session_create", "Create a new browser session. If agent_id is set and already has an active session, returns the existing one (use force_new to override). If session_id is omitted on other tools, the single active session is auto-selected. Use cdp_url to attach to an already-running Chrome instance.", {
-    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto"),
+    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "tui", "auto"]).optional().default("auto"),
     use_case: exports_external.string().optional(),
     project_id: exports_external.string().optional(),
     agent_id: exports_external.string().optional(),
@@ -44782,6 +44888,40 @@ function register3(server) {
       return err(e);
     }
   });
+  server.tool("browser_diff", "Visual diff between two URLs or a URL and a gallery entry. Screenshots both, returns a pixel diff image highlighting changes in red.", {
+    session_id: exports_external.string().optional(),
+    url1: exports_external.string().describe("First URL to screenshot"),
+    url2: exports_external.string().describe("Second URL to screenshot"),
+    threshold: exports_external.number().optional().default(10).describe("Pixel difference threshold (0-255, default 10)"),
+    wait_ms: exports_external.number().optional().default(1000).describe("Wait time after navigation before screenshot (ms)")
+  }, async ({ session_id, url1, url2, threshold, wait_ms }) => {
+    try {
+      const sid = resolveSessionId(session_id);
+      const page = getSessionPage(sid);
+      await page.goto(url1, { waitUntil: "domcontentloaded" });
+      await new Promise((r) => setTimeout(r, wait_ms));
+      const ss1 = await takeScreenshot(page, { maxWidth: 1280, compress: true, track: false });
+      await page.goto(url2, { waitUntil: "domcontentloaded" });
+      await new Promise((r) => setTimeout(r, wait_ms));
+      const ss2 = await takeScreenshot(page, { maxWidth: 1280, compress: true, track: false });
+      const { diffImages: diffImages2 } = await Promise.resolve().then(() => (init_gallery_diff(), exports_gallery_diff));
+      const diff = await diffImages2(ss1.path, ss2.path);
+      logEvent(sid, "diff", { url1, url2, changed_percent: diff.changed_percent });
+      return json({
+        url1,
+        url2,
+        changed_pixels: diff.changed_pixels,
+        total_pixels: diff.total_pixels,
+        changed_percent: Math.round(diff.changed_percent * 100) / 100,
+        diff_path: diff.diff_path,
+        diff_base64: diff.diff_base64.length > 50000 ? undefined : diff.diff_base64,
+        screenshot1_path: ss1.path,
+        screenshot2_path: ss2.path
+      });
+    } catch (e) {
+      return err(e);
+    }
+  });
 }
 
 // src/mcp/network.ts
@@ -45126,6 +45266,53 @@ function register4(server) {
       return err(e);
     }
   });
+  server.tool("browser_performance_budget", "Check page performance against a budget. Set thresholds for LCP, FCP, CLS, TTFB, DOM complete, and load event. Returns pass/fail per metric with actual values.", {
+    session_id: exports_external.string().optional(),
+    lcp_ms: exports_external.number().optional().describe("Largest Contentful Paint budget in ms (good: <2500)"),
+    fcp_ms: exports_external.number().optional().describe("First Contentful Paint budget in ms (good: <1800)"),
+    cls: exports_external.number().optional().describe("Cumulative Layout Shift budget (good: <0.1)"),
+    ttfb_ms: exports_external.number().optional().describe("Time to First Byte budget in ms (good: <800)"),
+    dom_complete_ms: exports_external.number().optional().describe("DOM complete budget in ms"),
+    load_event_ms: exports_external.number().optional().describe("Load event budget in ms"),
+    js_heap_mb: exports_external.number().optional().describe("JS heap size budget in MB")
+  }, async ({ session_id, lcp_ms, fcp_ms, cls, ttfb_ms, dom_complete_ms, load_event_ms, js_heap_mb }) => {
+    try {
+      const sid = resolveSessionId(session_id);
+      const page = getSessionPage(sid);
+      const metrics = await getPerformanceMetrics(page);
+      const checks = [];
+      let allPassed = true;
+      const check = (name, budget, actual) => {
+        if (budget === undefined)
+          return;
+        const passed = actual !== undefined && actual <= budget;
+        if (!passed)
+          allPassed = false;
+        checks.push({ metric: name, budget, actual, passed });
+      };
+      check("lcp", lcp_ms, metrics.lcp);
+      check("fcp", fcp_ms, metrics.fcp);
+      check("cls", cls, metrics.cls);
+      check("ttfb", ttfb_ms, metrics.ttfb);
+      check("dom_complete", dom_complete_ms, metrics.dom_complete);
+      check("load_event", load_event_ms, metrics.load_event);
+      if (js_heap_mb !== undefined && metrics.js_heap_size_used !== undefined) {
+        const heapMb = metrics.js_heap_size_used / (1024 * 1024);
+        const passed = heapMb <= js_heap_mb;
+        if (!passed)
+          allPassed = false;
+        checks.push({ metric: "js_heap_mb", budget: js_heap_mb, actual: Math.round(heapMb * 100) / 100, passed });
+      }
+      return json({
+        passed: allPassed,
+        checks,
+        metrics,
+        url: page.url()
+      });
+    } catch (e) {
+      return err(e);
+    }
+  });
 }
 
 // src/mcp/recordings.ts
@@ -45225,7 +45412,7 @@ function register5(server) {
     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", "bun", "auto"]).optional().default("auto")
+    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "tui", "auto"]).optional().default("auto")
   }, async ({ url, max_depth, max_pages, same_domain, project_id, engine }) => {
     try {
       const result = await crawl(url, {
@@ -45300,6 +45487,19 @@ function register5(server) {
       return err(e);
     }
   });
+  server.tool("browser_record_export", "Export a recording as a Playwright test (.spec.ts), Puppeteer script, or JSON. Returns the generated code as text.", {
+    recording_id: exports_external.string().describe("ID of the recording to export"),
+    format: exports_external.enum(["playwright", "puppeteer", "json"]).optional().default("playwright").describe("Export format")
+  }, async ({ recording_id, format }) => {
+    try {
+      const { exportRecording: exportRecording2 } = await Promise.resolve().then(() => (init_recorder(), exports_recorder));
+      const code = exportRecording2(recording_id, format);
+      const ext = format === "json" ? ".json" : format === "playwright" ? ".spec.ts" : ".js";
+      return json({ format, filename: `recording-${recording_id}${ext}`, code });
+    } catch (e) {
+      return err(e);
+    }
+  });
 }
 
 // src/mcp/scripts.ts
@@ -45307,7 +45507,7 @@ function register6(server) {
   server.tool("browser_script_run", "Run a saved script asynchronously. Returns run_id immediately \u2014 poll with browser_script_status for step-by-step progress. Scripts combine browser actions + connector calls + AI reasoning. Works with any engine (Bun.WebView, Playwright, CDP).", {
     name: exports_external.string().describe("Script name"),
     session_id: exports_external.string().optional(),
-    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto"),
+    engine: exports_external.enum(["playwright", "cdp", "lightpanda", "bun", "tui", "auto"]).optional().default("auto"),
     variables: exports_external.record(exports_external.string()).optional().describe("Override script variables")
   }, async ({ name, session_id, engine, variables }) => {
     try {
@@ -45712,7 +45912,8 @@ function register7(server) {
           { 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_to_element", description: "Scroll element into view + screenshot" }
+          { tool: "browser_scroll_to_element", description: "Scroll element into view + screenshot" },
+          { tool: "browser_diff", description: "Visual diff between two URLs \u2014 highlights changes in red" }
         ],
         Storage: [
           { tool: "browser_cookies_get", description: "Get cookies" },
@@ -45737,7 +45938,8 @@ function register7(server) {
           { tool: "browser_intercept_clear", description: "Remove all response intercepts" }
         ],
         Performance: [
-          { tool: "browser_performance", description: "Get performance metrics" }
+          { tool: "browser_performance", description: "Get performance metrics" },
+          { tool: "browser_performance_budget", description: "Check perf against budget thresholds (LCP, FCP, CLS, TTFB)" }
         ],
         Console: [
           { tool: "browser_console_log", description: "Get console messages" },
@@ -45750,6 +45952,7 @@ function register7(server) {
           { tool: "browser_record_step", description: "Add a step to recording" },
           { tool: "browser_record_stop", description: "Stop and save recording" },
           { tool: "browser_record_replay", description: "Replay a recorded sequence" },
+          { tool: "browser_record_export", description: "Export recording as Playwright test, Puppeteer script, or JSON" },
           { tool: "browser_recordings_list", description: "List all recordings" }
         ],
         Auth: [