@fusengine/browser-mcp 0.1.0

package/dist/session/session.js

@@ -0,0 +1,51 @@
+import { attachListeners } from "../agent/network.js";
+import { selectEngineForConfig } from "../engine/registry.js";
+/** Open a new live session with listeners attached. */
+export async function openSession(id, config, ttlMs) {
+    const opened = await selectEngineForConfig(config).open(config);
+    const page = opened.page ?? (await opened.context.newPage());
+    const logs = attachListeners(page);
+    const now = Date.now();
+    return {
+        id,
+        context: opened.context,
+        browser: opened.browser,
+        page,
+        config,
+        logs,
+        connected: opened.connected ?? false,
+        createdAt: now,
+        expiresAt: now + ttlMs,
+    };
+}
+/**
+ * Close a session. For launched browsers, close context + browser. For a CDP
+ * attach (`connected`), only drop the link — never close the user's browser
+ * or its default context.
+ */
+export async function closeSession(session) {
+    if (session.connected) {
+        try {
+            await session.browser?.close();
+        }
+        catch {
+            /* ignore: detaching from a user browser */
+        }
+        return;
+    }
+    try {
+        await session.context.close();
+    }
+    catch {
+        /* ignore */
+    }
+    if (session.browser) {
+        try {
+            await session.browser.close();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,eAAe,EAAmB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAe9D,uDAAuD;AACvD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAU,EACV,MAAsB,EACtB,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,EAAE;QACF,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI;QACJ,MAAM;QACN,IAAI;QACJ,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;QACpC,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG,GAAG,KAAK;KACvB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAoB;IACrD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/state/dom-signature.d.ts

@@ -0,0 +1,8 @@
+/**
+ * DOM signature: stable fingerprint of content + interactive elements.
+ * @module state/dom-signature
+ */
+import type { Page } from "playwright";
+/** Compute a SHA-1 fingerprint of the current DOM state. */
+export declare function domSignature(page: Page): Promise<string>;
+//# sourceMappingURL=dom-signature.d.ts.map

package/dist/state/dom-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-signature.d.ts","sourceRoot":"","sources":["../../src/state/dom-signature.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAUvC,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9D"}

package/dist/state/dom-signature.js

@@ -0,0 +1,13 @@
+import { evalScript } from "../lib/evaluate.js";
+import { sha1 } from "../lib/fs.js";
+const SIGNATURE_SCRIPT = `() => JSON.stringify({
+  text: document.body?.innerText || '',
+  buttons: [...document.querySelectorAll('button,a,input,select,textarea')]
+    .map(el => [el.tagName, el.innerText, el.value, el.getAttribute('aria-label'), el.id, el.className])
+})`;
+/** Compute a SHA-1 fingerprint of the current DOM state. */
+export async function domSignature(page) {
+    const raw = await evalScript(page, SIGNATURE_SCRIPT);
+    return sha1(raw);
+}
+//# sourceMappingURL=dom-signature.js.map

package/dist/state/dom-signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-signature.js","sourceRoot":"","sources":["../../src/state/dom-signature.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,MAAM,gBAAgB,GAAG;;;;GAItB,CAAC;AAEJ,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAU;IAC3C,MAAM,GAAG,GAAG,MAAM,UAAU,CAAS,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AACnB,CAAC"}

package/dist/state/realtime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Wait for real-time stabilization after an action.
+ * @module state/realtime
+ */
+import type { Page } from "playwright";
+/**
+ * Wait until JS mutations settle (2 identical ticks) or the max delay elapses.
+ * A full navigation is handled without failing the mission.
+ */
+export declare function waitForRealtimeSettle(page: Page, totalMs?: number, intervalMs?: number): Promise<void>;
+//# sourceMappingURL=realtime.d.ts.map

package/dist/state/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../src/state/realtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAavC;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,IAAI,EACV,OAAO,SAAQ,EACf,UAAU,SAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/state/realtime.js

@@ -0,0 +1,34 @@
+import { domSignature } from "./dom-signature.js";
+/** Recompute the DOM signature, surviving a full navigation. */
+async function safeSignature(page) {
+    try {
+        return await domSignature(page);
+    }
+    catch {
+        await page.waitForLoadState("domcontentloaded", { timeout: 10_000 });
+        return domSignature(page);
+    }
+}
+/**
+ * Wait until JS mutations settle (2 identical ticks) or the max delay elapses.
+ * A full navigation is handled without failing the mission.
+ */
+export async function waitForRealtimeSettle(page, totalMs = 2_500, intervalMs = 150) {
+    let last = await safeSignature(page);
+    let stableTicks = 0;
+    const deadline = Date.now() + totalMs;
+    while (Date.now() < deadline) {
+        await page.waitForTimeout(intervalMs);
+        const current = await safeSignature(page);
+        if (current === last) {
+            stableTicks += 1;
+            if (stableTicks >= 2)
+                return;
+        }
+        else {
+            stableTicks = 0;
+            last = current;
+        }
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/dist/state/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../../src/state/realtime.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,gEAAgE;AAChE,KAAK,UAAU,aAAa,CAAC,IAAU;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACrE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAU,EACV,OAAO,GAAG,KAAK,EACf,UAAU,GAAG,GAAG;IAEhB,IAAI,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,WAAW,IAAI,CAAC,CAAC;YACjB,IAAI,WAAW,IAAI,CAAC;gBAAE,OAAO;QAC/B,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,CAAC,CAAC;YAChB,IAAI,GAAG,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/state/replay.d.ts

@@ -0,0 +1,4 @@
+import type { Page } from "playwright";
+/** Capture a replay screenshot; returns the path or null if disabled/failed. */
+export declare function captureReplayScreenshot(page: Page, dir: string, enabled: boolean, runId: string, index: number, phase: "before" | "after"): Promise<string | null>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/state/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/state/replay.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGvC,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,GAAG,OAAO,GACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB"}

package/dist/state/replay.js

@@ -0,0 +1,21 @@
+/**
+ * Replay: before/after screenshots for each action.
+ * @module state/replay
+ */
+import { join } from "node:path";
+import { ensureDir } from "../lib/fs.js";
+/** Capture a replay screenshot; returns the path or null if disabled/failed. */
+export async function captureReplayScreenshot(page, dir, enabled, runId, index, phase) {
+    if (!enabled)
+        return null;
+    ensureDir(dir);
+    const path = join(dir, `${runId}-${String(index).padStart(2, "0")}-${phase}.png`);
+    try {
+        await page.screenshot({ path, fullPage: true });
+        return path;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/state/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../../src/state/replay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAU,EACV,GAAW,EACX,OAAgB,EAChB,KAAa,EACb,KAAa,EACb,KAAyB;IAEzB,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,SAAS,CAAC,GAAG,CAAC,CAAC;IACf,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAClF,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/state/site-memory.d.ts

@@ -0,0 +1,35 @@
+import type { ActionResult } from "../interfaces/types.js";
+/** Stored entry for a successful action. */
+export interface MemoryEntry {
+    strategy: string;
+    lastOkAt: number;
+    target?: string;
+    type?: string;
+}
+/** A site's memory contents. */
+export interface SiteMemory {
+    site: string;
+    actions: Record<string, MemoryEntry>;
+}
+/** Stable site key derived from the host (or "data" for data: URLs). */
+export declare function siteKey(url: string): string;
+/** Memory file path for a given URL. */
+export declare function siteMemoryFilePath(dir: string, url: string): string;
+/** Load a site's memory (empty structure if absent/unreadable). */
+export declare function loadSiteMemory(dir: string, url: string): SiteMemory;
+/** Memory key for an action (only click/fill are memorized). */
+export declare function actionMemoryKey(action: {
+    type?: string;
+    target?: string;
+}): string | null;
+/** Return the stored entry matching an action, if any. */
+export declare function rememberedAction(memory: SiteMemory, action: {
+    type?: string;
+    target?: string;
+}): MemoryEntry | null;
+/** Persist the winning strategy of an action; returns true if written. */
+export declare function rememberActionStrategy(dir: string, url: string, action: {
+    type?: string;
+    target?: string;
+}, result: ActionResult): boolean;
+//# sourceMappingURL=site-memory.d.ts.map

package/dist/state/site-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-memory.d.ts","sourceRoot":"","sources":["../../src/state/site-memory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACtC;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS3C;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAInE;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAGzF;AAED,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,WAAW,GAAG,IAAI,CAGpB;AAED,0EAA0E;AAC1E,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,MAAM,EAAE,YAAY,GACnB,OAAO,CAYT"}

package/dist/state/site-memory.js

@@ -0,0 +1,56 @@
+/**
+ * Per-site memory: reuse winning action strategies across runs.
+ * @module state/site-memory
+ */
+import { join } from "node:path";
+import { readJsonSafe, writeJson } from "../lib/fs.js";
+/** Stable site key derived from the host (or "data" for data: URLs). */
+export function siteKey(url) {
+    if (url.startsWith("data:"))
+        return "data";
+    let host = "";
+    try {
+        host = new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        host = "";
+    }
+    return host.replace(/[^a-z0-9.-]+/g, "-") || "unknown";
+}
+/** Memory file path for a given URL. */
+export function siteMemoryFilePath(dir, url) {
+    return join(dir, `${siteKey(url)}.json`);
+}
+/** Load a site's memory (empty structure if absent/unreadable). */
+export function loadSiteMemory(dir, url) {
+    const fallback = { site: siteKey(url), actions: {} };
+    const data = readJsonSafe(siteMemoryFilePath(dir, url), fallback);
+    return { site: data.site ?? siteKey(url), actions: data.actions ?? {} };
+}
+/** Memory key for an action (only click/fill are memorized). */
+export function actionMemoryKey(action) {
+    if (action.type !== "click" && action.type !== "fill")
+        return null;
+    return `${action.type}:${action.target ?? ""}`;
+}
+/** Return the stored entry matching an action, if any. */
+export function rememberedAction(memory, action) {
+    const key = actionMemoryKey(action);
+    return key ? (memory.actions[key] ?? null) : null;
+}
+/** Persist the winning strategy of an action; returns true if written. */
+export function rememberActionStrategy(dir, url, action, result) {
+    const key = actionMemoryKey(action);
+    if (!key || !result.strategy)
+        return false;
+    const memory = loadSiteMemory(dir, url);
+    memory.actions[key] = {
+        strategy: result.strategy,
+        lastOkAt: Math.floor(Date.now() / 1000),
+        target: action.target,
+        type: action.type,
+    };
+    writeJson(siteMemoryFilePath(dir, url), memory);
+    return true;
+}
+//# sourceMappingURL=site-memory.js.map

package/dist/state/site-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-memory.js","sourceRoot":"","sources":["../../src/state/site-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAgBvD,wEAAwE;AACxE,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;AACzD,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,GAAW;IACzD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,GAAW;IACrD,MAAM,QAAQ,GAAe,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACjE,MAAM,IAAI,GAAG,YAAY,CAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACvF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;AAC1E,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,eAAe,CAAC,MAA0C;IACxE,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;AACjD,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,gBAAgB,CAC9B,MAAkB,EAClB,MAA0C;IAE1C,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,GAAW,EACX,MAA0C,EAC1C,MAAoB;IAEpB,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG;QACpB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;IACF,SAAS,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@fusengine/browser-mcp",
+  "version": "0.1.0",
+  "description": "MCP server + CLI giving AI agents a real, stealth browser (Patchright/Playwright) — per-country identity, self-healing actions, snapshots, multi-step plans, structured extraction, CDP attach.",
+  "license": "MIT",
+  "author": "Fusengine",
+  "homepage": "https://github.com/fusengine/fuse-browser#readme",
+  "repository": { "type": "git", "url": "git+https://github.com/fusengine/fuse-browser.git" },
+  "bugs": { "url": "https://github.com/fusengine/fuse-browser/issues" },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "browser-automation",
+    "playwright",
+    "patchright",
+    "stealth",
+    "web-scraping",
+    "cli",
+    "typescript"
+  ],
+  "type": "module",
+  "publishConfig": { "access": "public" },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "fuse-browser": "dist/bin/cli.js",
+    "browser-mcp": "dist/bin/mcp.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scripts/postinstall.mjs",
+    "proxies.example.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.mjs",
+    "prepublishOnly": "npm run build",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "bun test tests/unit",
+    "test:integration": "node --test --import tsx tests/integration/mcp.test.ts tests/integration/probe.test.ts tests/integration/snapshot.test.ts tests/integration/run.test.ts tests/integration/extract-schema.test.ts",
+    "browsers": "patchright install chromium",
+    "mcp": "node --import tsx src/bin/mcp.ts",
+    "cli": "node --import tsx src/bin/cli.ts"
+  },
+  "trustedDependencies": [
+    "patchright",
+    "playwright"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "patchright": "^1.60.1",
+    "playwright": "^1.60.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  }
+}

package/proxies.example.json

@@ -0,0 +1,9 @@
+{
+  "CH": "http://user:password@ch-proxy.example:8080",
+  "US": "http://user:password@us-proxy.example:8080",
+  "GB": "http://user:password@gb-proxy.example:8080",
+  "FR": "http://user:password@fr-proxy.example:8080",
+  "DE": "http://user:password@de-proxy.example:8080",
+  "JP": "http://user:password@jp-proxy.example:8080",
+  "AE": "http://user:password@ae-proxy.example:8080"
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,24 @@
+/**
+ * Soft post-install: attempt to download the Chromium binary so the package
+ * works out of the box. Never fails the install (CI / offline safe) and can be
+ * skipped with PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 or FUSE_SKIP_BROWSER_DOWNLOAD=1.
+ */
+import { execSync } from "node:child_process";
+
+const skip =
+  process.env.PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD || process.env.FUSE_SKIP_BROWSER_DOWNLOAD;
+
+if (skip) {
+  console.log("[fuse-browser] Skipping Chromium download (skip env set).");
+  process.exit(0);
+}
+
+try {
+  console.log("[fuse-browser] Installing Chromium (patchright)…");
+  execSync("npx --no-install patchright install chromium", { stdio: "inherit" });
+  console.log("[fuse-browser] Chromium ready.");
+} catch (err) {
+  console.warn(`[fuse-browser] Chromium auto-install failed (non-fatal): ${err?.message ?? err}`);
+  console.warn("[fuse-browser] Install manually: npx patchright install chromium");
+  process.exit(0);
+}