@hasna/browser 0.1.1 → 0.2.0

package/dist/lib/daemon-client.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Daemon client — connects to a running browser daemon via HTTP.
+ * Falls back to null if no daemon is running.
+ */
+export declare function getDaemonPidFile(): string;
+export declare function getDaemonPort(): number;
+export declare function isDaemonRunning(): boolean;
+export declare function getDaemonPid(): number | null;
+export declare function getDaemonStatus(): Promise<{
+    running: boolean;
+    pid: number | null;
+    port: number;
+    sessions?: number;
+    uptime_ms?: number;
+}>;
+//# sourceMappingURL=daemon-client.d.ts.map

package/dist/lib/daemon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-client.d.ts","sourceRoot":"","sources":["../../src/lib/daemon-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,wBAAgB,gBAAgB,IAAI,MAAM,CAAqB;AAC/D,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,eAAe,IAAI,OAAO,CASzC;AAED,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAO5C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAY9I"}

package/dist/mcp/index.js

@@ -33001,6 +33001,25 @@ server.tool("browser_session_close", "Close a browser session", { session_id: ex
     return err(e);
   }
 });
+server.tool("browser_session_fork", "Fork a session: create a new session with the same auth state (cookies, storage) and URL as an existing one. Like git branch for browser sessions.", { source_session_id: exports_external.string(), name: exports_external.string().optional() }, async ({ source_session_id, name }) => {
+  try {
+    const sourcePage = getSessionPage(source_session_id);
+    const sourceUrl = sourcePage.url();
+    const tempName = `_fork_${Date.now()}`;
+    const { saveStateFromPage: saveStateFromPage2 } = await Promise.resolve().then(() => (init_storage_state(), exports_storage_state));
+    await saveStateFromPage2(sourcePage, tempName);
+    const { session, page } = await createSession2({
+      storageState: tempName,
+      startUrl: sourceUrl,
+      name: name ?? `fork-of-${source_session_id.slice(0, 8)}`
+    });
+    const { deleteState: deleteState2 } = await Promise.resolve().then(() => (init_storage_state(), exports_storage_state));
+    deleteState2(tempName);
+    return json({ forked_session: session, source_url: sourceUrl });
+  } catch (e) {
+    return err(e);
+  }
+});
 server.tool("browser_session_timeline", "Get chronological action log for a session", { session_id: exports_external.string().optional(), limit: exports_external.number().optional().default(50) }, async ({ session_id, limit }) => {
   try {
     const sid = resolveSessionId(session_id);
@@ -33594,6 +33613,52 @@ server.tool("browser_har_stop", "Stop HAR capture and return the HAR data", { se
     return err(e);
   }
 });
+server.tool("browser_intercept_response", "Intercept and modify API responses for testing. Mock data, simulate errors, add latency.", {
+  session_id: exports_external.string().optional(),
+  url_pattern: exports_external.string().describe("URL pattern to intercept (e.g. '**/api/users*')"),
+  action: exports_external.enum(["mock", "delay", "error"]).describe("What to do with matched requests"),
+  mock_body: exports_external.string().optional().describe("Response body for mock action"),
+  mock_content_type: exports_external.string().optional().default("application/json"),
+  status_code: exports_external.number().optional().default(200).describe("HTTP status code (for mock/error)"),
+  delay_ms: exports_external.number().optional().default(3000).describe("Delay in ms (for delay action)")
+}, async ({ session_id, url_pattern, action, mock_body, mock_content_type, status_code, delay_ms }) => {
+  try {
+    const sid = resolveSessionId(session_id);
+    const page = getSessionPage(sid);
+    await page.route(url_pattern, async (route) => {
+      if (action === "mock") {
+        await route.fulfill({
+          status: status_code,
+          contentType: mock_content_type,
+          body: mock_body ?? "{}"
+        });
+      } else if (action === "error") {
+        await route.fulfill({
+          status: status_code ?? 500,
+          contentType: "application/json",
+          body: JSON.stringify({ error: "Intercepted error", status: status_code })
+        });
+      } else if (action === "delay") {
+        await new Promise((r) => setTimeout(r, delay_ms));
+        await route.continue();
+      }
+    });
+    logEvent(sid, "intercept_set", { url_pattern, action, status_code });
+    return json({ intercepted: true, url_pattern, action });
+  } catch (e) {
+    return err(e);
+  }
+});
+server.tool("browser_intercept_clear", "Remove all response intercepts from a session", { session_id: exports_external.string().optional() }, async ({ session_id }) => {
+  try {
+    const sid = resolveSessionId(session_id);
+    const page = getSessionPage(sid);
+    await page.unrouteAll({ behavior: "ignoreErrors" });
+    return json({ cleared: true });
+  } catch (e) {
+    return err(e);
+  }
+});
 server.tool("browser_performance", "Get performance metrics for the current page", { session_id: exports_external.string().optional() }, async ({ session_id }) => {
   try {
     const sid = resolveSessionId(session_id);
@@ -33626,6 +33691,50 @@ server.tool("browser_performance_deep", "Deep performance analysis: Web Vitals,
     return err(e);
   }
 });
+server.tool("browser_accessibility_audit", "Run accessibility audit on the page. Injects axe-core and returns violations grouped by severity (critical, serious, moderate, minor).", { session_id: exports_external.string().optional(), selector: exports_external.string().optional().describe("Scope audit to a specific element") }, async ({ session_id, selector }) => {
+  try {
+    const sid = resolveSessionId(session_id);
+    const page = getSessionPage(sid);
+    await page.evaluate(`
+        if (!window.axe) {
+          const script = document.createElement('script');
+          script.src = 'https://cdnjs.cloudflare.com/ajax/libs/axe-core/4.10.2/axe.min.js';
+          document.head.appendChild(script);
+          await new Promise((resolve, reject) => {
+            script.onload = resolve;
+            script.onerror = reject;
+          });
+        }
+      `);
+    await new Promise((r) => setTimeout(r, 500));
+    const results = await page.evaluate((sel) => {
+      const opts = {};
+      if (sel)
+        opts.include = [sel];
+      return window.axe.run(opts.include ? { include: [sel] } : document).then((r) => ({
+        violations: r.violations.map((v) => ({
+          id: v.id,
+          impact: v.impact,
+          description: v.description,
+          help: v.help,
+          helpUrl: v.helpUrl,
+          nodes_count: v.nodes.length,
+          selectors: v.nodes.slice(0, 3).map((n) => n.target?.[0] ?? "")
+        })),
+        passes: r.passes.length,
+        violations_count: r.violations.length,
+        incomplete: r.incomplete.length
+      }));
+    }, selector);
+    const byImpact = { critical: 0, serious: 0, moderate: 0, minor: 0 };
+    for (const v of results.violations) {
+      byImpact[v.impact] = (byImpact[v.impact] || 0) + 1;
+    }
+    return json({ ...results, by_impact: byImpact, score: Math.max(0, 100 - results.violations_count * 5) });
+  } catch (e) {
+    return err(e);
+  }
+});
 server.tool("browser_console_log", "Get captured console messages for a session", { session_id: exports_external.string().optional(), level: exports_external.enum(["log", "warn", "error", "debug", "info"]).optional() }, async ({ session_id, level }) => {
   try {
     const sid = resolveSessionId(session_id);
@@ -34027,6 +34136,61 @@ server.tool("browser_find_visual", "Find an element using AI vision when selecto
     return err(e);
   }
 });
+server.tool("browser_wait_for_idle", "Wait until no network requests are in-flight for a specified duration. Essential for SPAs that load data after navigation.", {
+  session_id: exports_external.string().optional(),
+  idle_time: exports_external.number().optional().default(2000).describe("How long (ms) network must be idle to consider page loaded"),
+  timeout: exports_external.number().optional().default(30000).describe("Max wait time (ms) before giving up")
+}, async ({ session_id, idle_time, timeout }) => {
+  try {
+    const sid = resolveSessionId(session_id);
+    const page = getSessionPage(sid);
+    const t0 = Date.now();
+    let lastActivity = Date.now();
+    let pending = 0;
+    const onRequest = () => {
+      pending++;
+      lastActivity = Date.now();
+    };
+    const onResponse = () => {
+      pending = Math.max(0, pending - 1);
+      if (pending === 0)
+        lastActivity = Date.now();
+    };
+    const onFailed = () => {
+      pending = Math.max(0, pending - 1);
+      if (pending === 0)
+        lastActivity = Date.now();
+    };
+    page.on("request", onRequest);
+    page.on("response", onResponse);
+    page.on("requestfailed", onFailed);
+    try {
+      await new Promise((resolve4, reject) => {
+        const check = () => {
+          const now3 = Date.now();
+          if (now3 - t0 > timeout) {
+            reject(new Error(`Timeout after ${timeout}ms (${pending} requests still pending)`));
+            return;
+          }
+          if (pending === 0 && now3 - lastActivity >= idle_time) {
+            resolve4();
+            return;
+          }
+          setTimeout(check, 100);
+        };
+        check();
+      });
+    } finally {
+      page.removeListener("request", onRequest);
+      page.removeListener("response", onResponse);
+      page.removeListener("requestfailed", onFailed);
+    }
+    const waited_ms = Date.now() - t0;
+    return json({ idle: true, waited_ms, pending_requests: 0 });
+  } catch (e) {
+    return err(e);
+  }
+});
 server.tool("browser_wait_for_text", "Wait until specific text appears on the page", { session_id: exports_external.string().optional(), text: exports_external.string(), timeout: exports_external.number().optional().default(1e4), exact: exports_external.boolean().optional().default(false) }, async ({ session_id, text, timeout, exact }) => {
   try {
     const sid = resolveSessionId(session_id);
@@ -34494,7 +34658,8 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { tool: "browser_back", description: "Navigate back in history" },
         { tool: "browser_forward", description: "Navigate forward in history" },
         { tool: "browser_reload", description: "Reload the current page" },
-        { tool: "browser_wait_for_navigation", description: "Wait for URL change after action" }
+        { tool: "browser_wait_for_navigation", description: "Wait for URL change after action" },
+        { tool: "browser_wait_for_idle", description: "Wait for network idle (no pending requests)" }
       ],
       Interaction: [
         { tool: "browser_click", description: "Click element by ref or selector" },
@@ -34547,7 +34712,9 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { tool: "browser_network_log", description: "Get captured network requests" },
         { tool: "browser_network_intercept", description: "Add a network interception rule" },
         { tool: "browser_har_start", description: "Start HAR capture" },
-        { tool: "browser_har_stop", description: "Stop HAR capture and get data" }
+        { tool: "browser_har_stop", description: "Stop HAR capture and get data" },
+        { tool: "browser_intercept_response", description: "Mock/delay/error API responses for testing" },
+        { tool: "browser_intercept_clear", description: "Remove all response intercepts" }
       ],
       Performance: [
         { tool: "browser_performance", description: "Get performance metrics" }
@@ -34630,6 +34797,7 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { tool: "browser_session_untag", description: "Remove a tag from a session" },
         { tool: "browser_session_stats", description: "Get session stats and token usage" },
         { tool: "browser_session_timeline", description: "Get chronological action log" },
+        { tool: "browser_session_fork", description: "Fork a session (same auth state + URL)" },
         { tool: "browser_tab_new", description: "Open a new tab" },
         { tool: "browser_tab_list", description: "List all open tabs" },
         { tool: "browser_tab_switch", description: "Switch to a tab by index" },
@@ -34641,6 +34809,7 @@ server.tool("browser_help", "Show all available browser tools grouped by categor
         { tool: "browser_help", description: "Show this help (all tools)" },
         { tool: "browser_detect_env", description: "Detect environment (prod/dev/staging/local)" },
         { tool: "browser_performance_deep", description: "Deep performance: resources, third-party, DOM, memory" },
+        { tool: "browser_accessibility_audit", description: "Run axe-core accessibility audit with severity breakdown" },
         { tool: "browser_snapshot_diff", description: "Diff current snapshot vs previous" },
         { tool: "browser_watch_start", description: "Watch page for DOM changes" },
         { tool: "browser_watch_get_changes", description: "Get captured DOM changes" },

package/dist/server/index.js

@@ -9142,6 +9142,7 @@ async function diffImages(path1, path2) {
 
 // src/server/index.ts
 var PORT = parseInt(process.env["BROWSER_SERVER_PORT"] ?? "7030");
+var startTime = Date.now();
 var CORS_HEADERS = {
   "Access-Control-Allow-Origin": "*",
   "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, OPTIONS",
@@ -9185,6 +9186,14 @@ var server = Bun.serve({
       return new Response(null, { status: 204, headers: CORS_HEADERS });
     }
     try {
+      if (path === "/health" && method === "GET") {
+        const activeSessions = listSessions2({ status: "active" });
+        return ok({
+          status: "ok",
+          active_sessions: activeSessions.length,
+          uptime_ms: Date.now() - startTime
+        });
+      }
       if (path === "/api/sessions" && method === "GET") {
         const status = url.searchParams.get("status");
         const projectId = url.searchParams.get("project_id") ?? undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/browser",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "General-purpose browser agent toolkit — Playwright, Chrome DevTools Protocol, Lightpanda with auto engine selection. CLI + MCP + REST + SDK.",
   "type": "module",
   "main": "dist/index.js",