@hasna/browser 0.0.2 → 0.0.4

package/dist/mcp/v4.test.d.ts

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

package/dist/mcp/v4.test.d.ts.map

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

package/dist/server/index.js

@@ -6881,7 +6881,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 getSession(id) {
@@ -7072,6 +7079,273 @@ function selectEngine(useCase, explicit) {
   return preferred;
 }
 
+// src/db/network-log.ts
+init_schema();
+import { randomUUID as randomUUID2 } from "crypto";
+function logRequest(data) {
+  const db = getDatabase();
+  const id = randomUUID2();
+  db.prepare(`INSERT INTO network_log (id, session_id, method, url, status_code, request_headers,
+     response_headers, request_body, body_size, duration_ms, resource_type)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, data.session_id, data.method, data.url, data.status_code ?? null, data.request_headers ?? null, data.response_headers ?? null, data.request_body ?? null, data.body_size ?? null, data.duration_ms ?? null, data.resource_type ?? null);
+  return getNetworkRequest(id);
+}
+function getNetworkRequest(id) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM network_log WHERE id = ?").get(id) ?? null;
+}
+function getNetworkLog(sessionId) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM network_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
+}
+function clearNetworkLog(sessionId) {
+  const db = getDatabase();
+  db.prepare("DELETE FROM network_log WHERE session_id = ?").run(sessionId);
+}
+
+// src/lib/network.ts
+function enableNetworkLogging(page, sessionId) {
+  const requestStart = new Map;
+  const onRequest = (req) => {
+    requestStart.set(req.url(), Date.now());
+  };
+  const onResponse = (res) => {
+    const start = requestStart.get(res.url()) ?? Date.now();
+    const duration = Date.now() - start;
+    const req = res.request();
+    try {
+      logRequest({
+        session_id: sessionId,
+        method: req.method(),
+        url: res.url(),
+        status_code: res.status(),
+        request_headers: JSON.stringify(req.headers()),
+        response_headers: JSON.stringify(res.headers()),
+        body_size: res.headers()["content-length"] != null ? parseInt(res.headers()["content-length"]) : undefined,
+        duration_ms: duration,
+        resource_type: req.resourceType()
+      });
+    } catch {}
+  };
+  page.on("request", onRequest);
+  page.on("response", onResponse);
+  return () => {
+    page.off("request", onRequest);
+    page.off("response", onResponse);
+  };
+}
+function startHAR(page) {
+  const entries = [];
+  const requestStart = new Map;
+  const onRequest = (req) => {
+    requestStart.set(req.url() + req.method(), {
+      time: Date.now(),
+      method: req.method(),
+      headers: req.headers(),
+      postData: req.postData() ?? undefined
+    });
+  };
+  const onResponse = async (res) => {
+    const key = res.url() + res.request().method();
+    const start = requestStart.get(key);
+    if (!start)
+      return;
+    const duration = Date.now() - start.time;
+    const entry = {
+      startedDateTime: new Date(start.time).toISOString(),
+      time: duration,
+      request: {
+        method: start.method,
+        url: res.url(),
+        headers: Object.entries(start.headers).map(([name, value]) => ({ name, value })),
+        postData: start.postData ? { text: start.postData } : undefined
+      },
+      response: {
+        status: res.status(),
+        statusText: res.statusText(),
+        headers: Object.entries(res.headers()).map(([name, value]) => ({ name, value })),
+        content: {
+          size: parseInt(res.headers()["content-length"] ?? "0") || 0,
+          mimeType: res.headers()["content-type"] ?? "application/octet-stream"
+        }
+      },
+      timings: { send: 0, wait: duration, receive: 0 }
+    };
+    entries.push(entry);
+    requestStart.delete(key);
+  };
+  page.on("request", onRequest);
+  page.on("response", onResponse);
+  return {
+    entries,
+    stop: () => {
+      page.off("request", onRequest);
+      page.off("response", onResponse);
+      return {
+        log: {
+          version: "1.2",
+          creator: { name: "@hasna/browser", version: "0.0.1" },
+          entries
+        }
+      };
+    }
+  };
+}
+
+// src/db/console-log.ts
+init_schema();
+import { randomUUID as randomUUID3 } from "crypto";
+function logConsoleMessage(data) {
+  const db = getDatabase();
+  const id = randomUUID3();
+  db.prepare("INSERT INTO console_log (id, session_id, level, message, source, line_number) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.session_id, data.level, data.message, data.source ?? null, data.line_number ?? null);
+  return getConsoleMessage(id);
+}
+function getConsoleMessage(id) {
+  const db = getDatabase();
+  return db.query("SELECT * FROM console_log WHERE id = ?").get(id) ?? null;
+}
+function getConsoleLog(sessionId, level) {
+  const db = getDatabase();
+  if (level) {
+    return db.query("SELECT * FROM console_log WHERE session_id = ? AND level = ? ORDER BY timestamp ASC").all(sessionId, level);
+  }
+  return db.query("SELECT * FROM console_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
+}
+
+// src/lib/console.ts
+function enableConsoleCapture(page, sessionId) {
+  const onConsole = (msg) => {
+    const levelMap = {
+      log: "log",
+      warn: "warn",
+      error: "error",
+      debug: "debug",
+      info: "info",
+      warning: "warn"
+    };
+    const level = levelMap[msg.type()] ?? "log";
+    const location = msg.location();
+    try {
+      logConsoleMessage({
+        session_id: sessionId,
+        level,
+        message: msg.text(),
+        source: location.url || undefined,
+        line_number: location.lineNumber || undefined
+      });
+    } catch {}
+  };
+  page.on("console", onConsole);
+  return () => page.off("console", onConsole);
+}
+
+// src/lib/stealth.ts
+var REALISTIC_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36";
+var STEALTH_SCRIPT = `
+// \u2500\u2500 1. Remove navigator.webdriver flag \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+Object.defineProperty(navigator, 'webdriver', {
+  get: () => false,
+  configurable: true,
+});
+
+// \u2500\u2500 2. Override navigator.plugins to show typical Chrome plugins \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+Object.defineProperty(navigator, 'plugins', {
+  get: () => {
+    const plugins = [
+      { name: 'Chrome PDF Plugin', filename: 'internal-pdf-viewer', description: 'Portable Document Format', length: 1 },
+      { name: 'Chrome PDF Viewer', filename: 'mhjfbmdgcfjbbpaeojofohoefgiehjai', description: '', length: 1 },
+      { name: 'Native Client', filename: 'internal-nacl-plugin', description: '', length: 2 },
+    ];
+    // Mimic PluginArray interface
+    const pluginArray = Object.create(PluginArray.prototype);
+    plugins.forEach((p, i) => {
+      const plugin = Object.create(Plugin.prototype);
+      Object.defineProperties(plugin, {
+        name: { value: p.name, enumerable: true },
+        filename: { value: p.filename, enumerable: true },
+        description: { value: p.description, enumerable: true },
+        length: { value: p.length, enumerable: true },
+      });
+      pluginArray[i] = plugin;
+    });
+    Object.defineProperty(pluginArray, 'length', { value: plugins.length });
+    pluginArray.item = (i) => pluginArray[i] || null;
+    pluginArray.namedItem = (name) => plugins.find(p => p.name === name) ? pluginArray[plugins.findIndex(p => p.name === name)] : null;
+    pluginArray.refresh = () => {};
+    return pluginArray;
+  },
+  configurable: true,
+});
+
+// \u2500\u2500 3. Override navigator.languages \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+Object.defineProperty(navigator, 'languages', {
+  get: () => ['en-US', 'en'],
+  configurable: true,
+});
+
+// \u2500\u2500 4. Override chrome.runtime to appear like real Chrome \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+if (!window.chrome) {
+  window.chrome = {};
+}
+if (!window.chrome.runtime) {
+  window.chrome.runtime = {
+    connect: function() { return { onMessage: { addListener: function() {} }, postMessage: function() {} }; },
+    sendMessage: function() {},
+    onMessage: { addListener: function() {}, removeListener: function() {} },
+    id: undefined,
+  };
+}
+`;
+async function applyStealthPatches(page) {
+  await page.context().addInitScript(STEALTH_SCRIPT);
+  await page.context().setExtraHTTPHeaders({
+    "User-Agent": REALISTIC_USER_AGENT
+  });
+}
+
+// src/lib/dialogs.ts
+var pendingDialogs = new Map;
+var AUTO_DISMISS_MS = 5000;
+function setupDialogHandler(page, sessionId) {
+  const onDialog = (dialog) => {
+    const info = {
+      type: dialog.type(),
+      message: dialog.message(),
+      default_value: dialog.defaultValue(),
+      timestamp: new Date().toISOString()
+    };
+    const autoTimer = setTimeout(() => {
+      try {
+        dialog.dismiss().catch(() => {});
+      } catch {}
+      const list = pendingDialogs.get(sessionId);
+      if (list) {
+        const idx = list.findIndex((p) => p.dialog === dialog);
+        if (idx >= 0)
+          list.splice(idx, 1);
+        if (list.length === 0)
+          pendingDialogs.delete(sessionId);
+      }
+    }, AUTO_DISMISS_MS);
+    const pending = { dialog, info, autoTimer };
+    if (!pendingDialogs.has(sessionId)) {
+      pendingDialogs.set(sessionId, []);
+    }
+    pendingDialogs.get(sessionId).push(pending);
+  };
+  page.on("dialog", onDialog);
+  return () => {
+    page.off("dialog", onDialog);
+    const list = pendingDialogs.get(sessionId);
+    if (list) {
+      for (const p of list)
+        clearTimeout(p.autoTimer);
+      pendingDialogs.delete(sessionId);
+    }
+  };
+}
+
 // src/lib/session.ts
 var handles = new Map;
 async function createSession2(opts = {}) {
@@ -7094,17 +7368,44 @@ async function createSession2(opts = {}) {
       userAgent: opts.userAgent
     });
   }
+  let sessionName = opts.name ?? (opts.startUrl ? (() => {
+    try {
+      return new URL(opts.startUrl).hostname;
+    } catch {
+      return;
+    }
+  })() : undefined);
   const session = createSession({
     engine: resolvedEngine,
     projectId: opts.projectId,
     agentId: opts.agentId,
-    startUrl: opts.startUrl
+    startUrl: opts.startUrl,
+    name: sessionName
   });
-  handles.set(session.id, { browser, page, engine: resolvedEngine });
+  if (opts.stealth) {
+    try {
+      await applyStealthPatches(page);
+    } catch {}
+  }
+  const cleanups = [];
+  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(setupDialogHandler(page, session.id));
+  } catch {}
+  handles.set(session.id, { browser, page, engine: resolvedEngine, cleanups, tokenBudget: { total: 0, used: 0 } });
   if (opts.startUrl) {
     try {
       await page.goto(opts.startUrl, { waitUntil: "domcontentloaded" });
-    } catch (err) {}
+    } catch {}
   }
   return { session, page };
 }
@@ -7112,11 +7413,22 @@ function getSessionPage(sessionId) {
   const handle = handles.get(sessionId);
   if (!handle)
     throw new SessionNotFoundError(sessionId);
+  try {
+    handle.page.url();
+  } catch {
+    handles.delete(sessionId);
+    throw new SessionNotFoundError(sessionId);
+  }
   return handle.page;
 }
 async function closeSession2(sessionId) {
   const handle = handles.get(sessionId);
   if (handle) {
+    for (const cleanup of handle.cleanups) {
+      try {
+        cleanup();
+      } catch {}
+    }
     try {
       await handle.page.context().close();
     } catch {}
@@ -7133,6 +7445,12 @@ function listSessions2(filter) {
 
 // src/lib/actions.ts
 init_types();
+
+// src/lib/snapshot.ts
+var lastSnapshots = new Map;
+var sessionRefMaps = new Map;
+
+// src/lib/actions.ts
 async function click(page, selector, opts) {
   try {
     await page.click(selector, {
@@ -7264,7 +7582,7 @@ import { homedir as homedir2 } from "os";
 
 // src/db/gallery.ts
 init_schema();
-import { randomUUID as randomUUID2 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 function deserialize(row) {
   return {
     id: row.id,
@@ -7288,7 +7606,7 @@ function deserialize(row) {
 }
 function createEntry(data) {
   const db = getDatabase();
-  const id = randomUUID2();
+  const id = randomUUID4();
   db.prepare(`
     INSERT INTO gallery_entries
       (id, session_id, project_id, url, title, path, thumbnail_path, format,
@@ -7440,11 +7758,20 @@ async function takeScreenshot(page, opts) {
     }
     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;
@@ -7472,7 +7799,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 {
@@ -7508,119 +7836,6 @@ async function takeScreenshot(page, opts) {
   }
 }
 
-// src/db/network-log.ts
-init_schema();
-import { randomUUID as randomUUID3 } from "crypto";
-function logRequest(data) {
-  const db = getDatabase();
-  const id = randomUUID3();
-  db.prepare(`INSERT INTO network_log (id, session_id, method, url, status_code, request_headers,
-     response_headers, request_body, body_size, duration_ms, resource_type)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, data.session_id, data.method, data.url, data.status_code ?? null, data.request_headers ?? null, data.response_headers ?? null, data.request_body ?? null, data.body_size ?? null, data.duration_ms ?? null, data.resource_type ?? null);
-  return getNetworkRequest(id);
-}
-function getNetworkRequest(id) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM network_log WHERE id = ?").get(id) ?? null;
-}
-function getNetworkLog(sessionId) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM network_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
-}
-function clearNetworkLog(sessionId) {
-  const db = getDatabase();
-  db.prepare("DELETE FROM network_log WHERE session_id = ?").run(sessionId);
-}
-
-// src/lib/network.ts
-function enableNetworkLogging(page, sessionId) {
-  const requestStart = new Map;
-  const onRequest = (req) => {
-    requestStart.set(req.url(), Date.now());
-  };
-  const onResponse = (res) => {
-    const start = requestStart.get(res.url()) ?? Date.now();
-    const duration = Date.now() - start;
-    const req = res.request();
-    try {
-      logRequest({
-        session_id: sessionId,
-        method: req.method(),
-        url: res.url(),
-        status_code: res.status(),
-        request_headers: JSON.stringify(req.headers()),
-        response_headers: JSON.stringify(res.headers()),
-        body_size: res.headers()["content-length"] != null ? parseInt(res.headers()["content-length"]) : undefined,
-        duration_ms: duration,
-        resource_type: req.resourceType()
-      });
-    } catch {}
-  };
-  page.on("request", onRequest);
-  page.on("response", onResponse);
-  return () => {
-    page.off("request", onRequest);
-    page.off("response", onResponse);
-  };
-}
-function startHAR(page) {
-  const entries = [];
-  const requestStart = new Map;
-  const onRequest = (req) => {
-    requestStart.set(req.url() + req.method(), {
-      time: Date.now(),
-      method: req.method(),
-      headers: req.headers(),
-      postData: req.postData() ?? undefined
-    });
-  };
-  const onResponse = async (res) => {
-    const key = res.url() + res.request().method();
-    const start = requestStart.get(key);
-    if (!start)
-      return;
-    const duration = Date.now() - start.time;
-    const entry = {
-      startedDateTime: new Date(start.time).toISOString(),
-      time: duration,
-      request: {
-        method: start.method,
-        url: res.url(),
-        headers: Object.entries(start.headers).map(([name, value]) => ({ name, value })),
-        postData: start.postData ? { text: start.postData } : undefined
-      },
-      response: {
-        status: res.status(),
-        statusText: res.statusText(),
-        headers: Object.entries(res.headers()).map(([name, value]) => ({ name, value })),
-        content: {
-          size: parseInt(res.headers()["content-length"] ?? "0") || 0,
-          mimeType: res.headers()["content-type"] ?? "application/octet-stream"
-        }
-      },
-      timings: { send: 0, wait: duration, receive: 0 }
-    };
-    entries.push(entry);
-    requestStart.delete(key);
-  };
-  page.on("request", onRequest);
-  page.on("response", onResponse);
-  return {
-    entries,
-    stop: () => {
-      page.off("request", onRequest);
-      page.off("response", onResponse);
-      return {
-        log: {
-          version: "1.2",
-          creator: { name: "@hasna/browser", version: "0.0.1" },
-          entries
-        }
-      };
-    }
-  };
-}
-
 // src/engines/cdp.ts
 init_types();
 
@@ -7768,54 +7983,6 @@ async function getPerformanceMetrics(page) {
   };
 }
 
-// src/db/console-log.ts
-init_schema();
-import { randomUUID as randomUUID4 } from "crypto";
-function logConsoleMessage(data) {
-  const db = getDatabase();
-  const id = randomUUID4();
-  db.prepare("INSERT INTO console_log (id, session_id, level, message, source, line_number) VALUES (?, ?, ?, ?, ?, ?)").run(id, data.session_id, data.level, data.message, data.source ?? null, data.line_number ?? null);
-  return getConsoleMessage(id);
-}
-function getConsoleMessage(id) {
-  const db = getDatabase();
-  return db.query("SELECT * FROM console_log WHERE id = ?").get(id) ?? null;
-}
-function getConsoleLog(sessionId, level) {
-  const db = getDatabase();
-  if (level) {
-    return db.query("SELECT * FROM console_log WHERE session_id = ? AND level = ? ORDER BY timestamp ASC").all(sessionId, level);
-  }
-  return db.query("SELECT * FROM console_log WHERE session_id = ? ORDER BY timestamp ASC").all(sessionId);
-}
-
-// src/lib/console.ts
-function enableConsoleCapture(page, sessionId) {
-  const onConsole = (msg) => {
-    const levelMap = {
-      log: "log",
-      warn: "warn",
-      error: "error",
-      debug: "debug",
-      info: "info",
-      warning: "warn"
-    };
-    const level = levelMap[msg.type()] ?? "log";
-    const location = msg.location();
-    try {
-      logConsoleMessage({
-        session_id: sessionId,
-        level,
-        message: msg.text(),
-        source: location.url || undefined,
-        line_number: location.lineNumber || undefined
-      });
-    } catch {}
-  };
-  page.on("console", onConsole);
-  return () => page.off("console", onConsole);
-}
-
 // src/lib/crawler.ts
 init_types();
 

package/dist/types/index.d.ts

@@ -56,12 +56,16 @@ export interface SessionOptions {
     projectId?: string;
     agentId?: string;
     startUrl?: string;
+    name?: string;
     headless?: boolean;
     viewport?: {
         width: number;
         height: number;
     };
     userAgent?: string;
+    captureNetwork?: boolean;
+    captureConsole?: boolean;
+    stealth?: boolean;
 }
 export interface Snapshot {
     id: string;
@@ -344,6 +348,37 @@ export interface PDFResult {
     size_bytes: number;
     page_count?: number;
 }
+export interface RefInfo {
+    role: string;
+    name: string;
+    description?: string;
+    visible: boolean;
+    enabled: boolean;
+    value?: string;
+    checked?: boolean;
+}
+export interface SnapshotResult {
+    tree: string;
+    refs: Record<string, RefInfo>;
+    interactive_count: number;
+}
+export interface SnapshotDiff {
+    added: Array<{
+        ref: string;
+        info: RefInfo;
+    }>;
+    removed: Array<{
+        ref: string;
+        info: RefInfo;
+    }>;
+    modified: Array<{
+        ref: string;
+        before: RefInfo;
+        after: RefInfo;
+    }>;
+    url_changed: boolean;
+    title_changed: boolean;
+}
 export interface BrowserConfig {
     default_engine: BrowserEngine;
     headless: boolean;