@hasna/browser 0.3.8 → 0.4.1

package/dist/cli/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);
@@ -2177,11 +2156,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")
@@ -3211,10 +3190,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;
@@ -3224,19 +3203,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, types, Query, DatabaseError, escapeIdentifier, escapeLiteral, Result, TypeOverrides, defaults, esm_default, init_esm, init_adapter, util, objectUtil, ZodParsedType, getParsedType = (data) => {
   const t = typeof data;
@@ -12653,6 +12632,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")
@@ -12676,6 +12738,7 @@ var init_selector = __esm(() => {
   init_types();
   init_lightpanda();
   init_bun_webview();
+  init_tui();
   ENGINE_MAP = {
     ["scrape" /* SCRAPE */]: "bun",
     ["extract_links" /* EXTRACT_LINKS */]: "bun",
@@ -12686,6 +12749,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",
@@ -14055,7 +14119,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;
@@ -14081,6 +14145,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) {
@@ -14151,7 +14247,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) {
@@ -14221,7 +14317,7 @@ async function closeSession2(sessionId) {
       try {
         await handle.bunView.close();
       } catch {}
-    } else {
+    } else if (handle.tuiSession) {} else {
       try {
         await handle.page.context().close();
       } catch {}
@@ -14321,6 +14417,7 @@ var init_session = __esm(() => {
   init_lightpanda();
   init_bun_webview();
   init_selector();
+  init_tui();
   init_network();
   init_console();
   init_stealth();
@@ -27481,7 +27578,7 @@ var init_helpers = __esm(() => {
 // src/mcp/sessions.ts
 function register4(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_external2.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto"),
+    engine: exports_external2.enum(["playwright", "cdp", "lightpanda", "bun", "tui", "auto"]).optional().default("auto"),
     use_case: exports_external2.string().optional(),
     project_id: exports_external2.string().optional(),
     agent_id: exports_external2.string().optional(),
@@ -28710,6 +28807,40 @@ function register6(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_external2.string().optional(),
+    url1: exports_external2.string().describe("First URL to screenshot"),
+    url2: exports_external2.string().describe("Second URL to screenshot"),
+    threshold: exports_external2.number().optional().default(10).describe("Pixel difference threshold (0-255, default 10)"),
+    wait_ms: exports_external2.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);
+    }
+  });
 }
 var init_capture = __esm(() => {
   init_helpers();
@@ -31845,6 +31976,53 @@ function register7(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_external2.string().optional(),
+    lcp_ms: exports_external2.number().optional().describe("Largest Contentful Paint budget in ms (good: <2500)"),
+    fcp_ms: exports_external2.number().optional().describe("First Contentful Paint budget in ms (good: <1800)"),
+    cls: exports_external2.number().optional().describe("Cumulative Layout Shift budget (good: <0.1)"),
+    ttfb_ms: exports_external2.number().optional().describe("Time to First Byte budget in ms (good: <800)"),
+    dom_complete_ms: exports_external2.number().optional().describe("DOM complete budget in ms"),
+    load_event_ms: exports_external2.number().optional().describe("Load event budget in ms"),
+    js_heap_mb: exports_external2.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);
+    }
+  });
 }
 var init_network2 = __esm(() => {
   init_helpers();
@@ -32218,7 +32396,7 @@ function register8(server) {
     max_pages: exports_external2.number().optional().default(50),
     same_domain: exports_external2.boolean().optional().default(true),
     project_id: exports_external2.string().optional(),
-    engine: exports_external2.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto")
+    engine: exports_external2.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, {
@@ -32293,6 +32471,19 @@ function register8(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_external2.string().describe("ID of the recording to export"),
+    format: exports_external2.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);
+    }
+  });
 }
 var init_recordings2 = __esm(() => {
   init_helpers();
@@ -32386,7 +32577,7 @@ function register9(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_external2.string().describe("Script name"),
     session_id: exports_external2.string().optional(),
-    engine: exports_external2.enum(["playwright", "cdp", "lightpanda", "bun", "auto"]).optional().default("auto"),
+    engine: exports_external2.enum(["playwright", "cdp", "lightpanda", "bun", "tui", "auto"]).optional().default("auto"),
     variables: exports_external2.record(exports_external2.string()).optional().describe("Override script variables")
   }, async ({ name, session_id, engine, variables }) => {
     try {
@@ -32641,8 +32832,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:");
@@ -35756,13 +35947,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.
@@ -37285,11 +37476,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)
@@ -39274,10 +39465,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;
@@ -39287,7 +39478,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)
@@ -39302,19 +39493,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(() => {
@@ -41928,7 +42119,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;
@@ -46276,7 +46467,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,
@@ -47870,7 +48061,8 @@ function register10(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" },
@@ -47895,7 +48087,8 @@ function register10(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" },
@@ -47908,6 +48101,7 @@ function register10(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: [
@@ -49506,9 +49700,9 @@ ${entries.length} entries`));
   });
   program2.command("install-browser").description("Install a browser engine").option("--engine <engine>", "Engine to install: lightpanda|chromium", "chromium").action(async (opts) => {
     if (opts.engine === "chromium") {
-      const { execSync: execSync3 } = await import("child_process");
+      const { execSync: execSync4 } = await import("child_process");
       console.log(chalk4.gray("Installing Chromium via Playwright..."));
-      execSync3("bunx playwright install chromium", { stdio: "inherit" });
+      execSync4("bunx playwright install chromium", { stdio: "inherit" });
       console.log(chalk4.green("\u2713 Chromium installed"));
     } else if (opts.engine === "lightpanda") {
       console.log(chalk4.yellow("Lightpanda must be installed manually."));
@@ -49528,12 +49722,12 @@ ${entries.length} entries`));
       console.log(chalk4.gray(`  PID: ${status.pid}, Port: ${status.port}, Sessions: ${status.sessions ?? "?"}`));
       return;
     }
-    const { spawn: spawn2 } = await import("child_process");
+    const { spawn: spawn3 } = await import("child_process");
     const { writeFileSync: writeFileSync9, mkdirSync: mkdirSync17 } = await import("fs");
     const { dirname: dirname6 } = await import("path");
     const pidFile = getDaemonPidFile2();
     mkdirSync17(dirname6(pidFile), { recursive: true });
-    const child = spawn2(process.execPath, [import.meta.dir + "/../../server/index.js"], {
+    const child = spawn3(process.execPath, [import.meta.dir + "/../../server/index.js"], {
       detached: true,
       stdio: "ignore",
       env: { ...process.env, BROWSER_SERVER_PORT: opts.port }

package/dist/engines/selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/engines/selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA+B5C;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,aAAa,GACvB,aAAa,CAqBf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAOhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA0BnD"}
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../src/engines/selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAkC5C;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,aAAa,GACvB,aAAa,CAqBf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAQhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CA4BnD"}

package/dist/engines/tui.d.ts

@@ -0,0 +1,49 @@
+import { type ChildProcess } from "node:child_process";
+import type { Browser, Page } from "playwright";
+export interface TuiSession {
+    ttydProcess: ChildProcess;
+    port: number;
+    browser: Browser;
+    page: Page;
+}
+/**
+ * Check if ttyd is installed on this system.
+ */
+export declare function isTuiAvailable(): boolean;
+/**
+ * Launch a terminal app via ttyd and connect Playwright to it.
+ *
+ * @param command - The shell command to run (e.g. "htop", "npm start", "python app.py")
+ * @param options - Viewport and headless options
+ * @returns TuiSession with Playwright page connected to the ttyd web UI
+ */
+export declare function launchTui(command: string, options?: {
+    headless?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}): Promise<TuiSession>;
+/**
+ * Send keystrokes to the TUI app via the Playwright page.
+ * Types into the terminal's xterm.js input.
+ */
+export declare function sendKeys(page: Page, keys: string): Promise<void>;
+/**
+ * Send a special key (Enter, Escape, ArrowUp, etc.) to the TUI.
+ */
+export declare function sendSpecialKey(page: Page, key: string): Promise<void>;
+/**
+ * Get the visible text content from the terminal.
+ * Works with both canvas-based and DOM-based xterm.js renderers.
+ */
+export declare function getTerminalText(page: Page): Promise<string>;
+/**
+ * Wait for specific text to appear in the terminal output.
+ */
+export declare function waitForTerminalText(page: Page, text: string, timeoutMs?: number): Promise<boolean>;
+/**
+ * Close TUI session — kill ttyd and close Playwright.
+ */
+export declare function closeTui(session: TuiSession): Promise<void>;
+//# sourceMappingURL=tui.d.ts.map

package/dist/engines/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/engines/tui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAYhD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,YAAY,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAOxC;AAqCD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC,GACL,OAAO,CAAC,UAAU,CAAC,CAqDrB;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3E;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBjE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE"}

package/dist/engines/tui.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tui.test.d.ts.map

package/dist/engines/tui.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.test.d.ts","sourceRoot":"","sources":["../../src/engines/tui.test.ts"],"names":[],"mappings":""}