@fusengine/browser-mcp 0.1.0

package/dist/engine/cdp-launch.d.ts

@@ -0,0 +1,11 @@
+/** Default macOS binary paths for common Chromium browsers. */
+export declare const KNOWN_BROWSERS: Record<string, string>;
+/**
+ * Spawn a browser binary with remote debugging, fully detached from the parent.
+ * Runs without a shell (no shell injection); `binary`/`userDataDir` are passed
+ * as native argv. The opened debug port is a local attack surface (see module).
+ */
+export declare function spawnBrowser(binary: string, port: number, userDataDir?: string): void;
+/** Poll http://localhost:PORT/json/version until it responds or retries run out. */
+export declare function waitForCdp(port: number, retries?: number, intervalMs?: number): Promise<string>;
+//# sourceMappingURL=cdp-launch.d.ts.map

package/dist/engine/cdp-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-launch.d.ts","sourceRoot":"","sources":["../../src/engine/cdp-launch.ts"],"names":[],"mappings":"AAcA,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMjD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAMrF;AAED,oFAAoF;AACpF,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe9F"}

package/dist/engine/cdp-launch.js

@@ -0,0 +1,54 @@
+/**
+ * Launch an installed browser with a remote-debugging port, detached, then
+ * poll its CDP endpoint until ready. Powers `browser_connect` so an agent can
+ * attach to the user's real browser (Chrome/Edge/Dia/Arc) without manual setup.
+ *
+ * SECURITY: opening a remote-debugging port binds a CDP server on localhost.
+ * Any local process can then connect and fully control the browser (read
+ * cookies/sessions, execute JS). Use a dedicated `userDataDir` for automation,
+ * never bind to 0.0.0.0, and treat the port as a local attack surface.
+ * @module engine/cdp-launch
+ */
+import { spawn } from "node:child_process";
+import { logger } from "../lib/logger.js";
+/** Default macOS binary paths for common Chromium browsers. */
+export const KNOWN_BROWSERS = {
+    dia: "/Applications/Dia.app/Contents/MacOS/Dia",
+    chrome: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    edge: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+    brave: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+    arc: "/Applications/Arc.app/Contents/MacOS/Arc",
+};
+/**
+ * Spawn a browser binary with remote debugging, fully detached from the parent.
+ * Runs without a shell (no shell injection); `binary`/`userDataDir` are passed
+ * as native argv. The opened debug port is a local attack surface (see module).
+ */
+export function spawnBrowser(binary, port, userDataDir) {
+    const args = [`--remote-debugging-port=${port}`, "--no-first-run", "--no-default-browser-check"];
+    if (userDataDir)
+        args.push(`--user-data-dir=${userDataDir}`);
+    const child = spawn(binary, args, { detached: true, stdio: "ignore" });
+    child.unref();
+    logger.info("spawned browser for CDP", { binary, port });
+}
+/** Poll http://localhost:PORT/json/version until it responds or retries run out. */
+export async function waitForCdp(port, retries = 25, intervalMs = 300) {
+    const url = `http://localhost:${port}/json/version`;
+    for (let i = 0; i < retries; i += 1) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 1_000);
+            const res = await fetch(url, { signal: controller.signal });
+            clearTimeout(timer);
+            if (res.ok)
+                return url.replace("/json/version", "");
+        }
+        catch {
+            /* not ready yet */
+        }
+        await new Promise((r) => setTimeout(r, intervalMs));
+    }
+    throw new Error(`CDP endpoint not ready on port ${port} after ${retries} attempts`);
+}
+//# sourceMappingURL=cdp-launch.js.map

package/dist/engine/cdp-launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-launch.js","sourceRoot":"","sources":["../../src/engine/cdp-launch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAA2B;IACpD,GAAG,EAAE,0CAA0C;IAC/C,MAAM,EAAE,8DAA8D;IACtE,IAAI,EAAE,gEAAgE;IACtE,KAAK,EAAE,8DAA8D;IACrE,GAAG,EAAE,0CAA0C;CAChD,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,IAAY,EAAE,WAAoB;IAC7E,MAAM,IAAI,GAAG,CAAC,2BAA2B,IAAI,EAAE,EAAE,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;IACjG,IAAI,WAAW;QAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvE,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,OAAO,GAAG,EAAE,EAAE,UAAU,GAAG,GAAG;IAC3E,MAAM,GAAG,GAAG,oBAAoB,IAAI,eAAe,CAAC;IACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5D,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,GAAG,CAAC,EAAE;gBAAE,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;QACrB,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,UAAU,OAAO,WAAW,CAAC,CAAC;AACtF,CAAC"}

package/dist/engine/context.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Build the browser context options (identity, viewport, headers).
+ * @module engine/context
+ */
+import type { BrowserContextOptions } from "playwright";
+import type { ResolvedIdentity } from "../identity/resolve.js";
+/** Shared viewport/screen dimensions (context + visual observation). */
+export declare const VIEWPORT: {
+    readonly width: 1365;
+    readonly height: 900;
+};
+/** Assemble `newContext` options from the resolved identity. */
+export declare function buildContextOptions(identity: ResolvedIdentity, realisticProfile: boolean): BrowserContextOptions;
+//# sourceMappingURL=context.d.ts.map

package/dist/engine/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/engine/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wEAAwE;AACxE,eAAO,MAAM,QAAQ;;;CAAwC,CAAC;AAE9D,gEAAgE;AAChE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,EAAE,OAAO,GACxB,qBAAqB,CAevB"}

package/dist/engine/context.js

@@ -0,0 +1,22 @@
+import { REALISTIC_DESKTOP_UA } from "../identity/country-profiles.js";
+/** Shared viewport/screen dimensions (context + visual observation). */
+export const VIEWPORT = { width: 1365, height: 900 };
+/** Assemble `newContext` options from the resolved identity. */
+export function buildContextOptions(identity, realisticProfile) {
+    const opts = {
+        viewport: { ...VIEWPORT },
+        screen: { ...VIEWPORT },
+        deviceScaleFactor: 1,
+        isMobile: false,
+        hasTouch: false,
+        locale: identity.locale,
+        timezoneId: identity.timezoneId,
+        geolocation: identity.geolocation,
+        permissions: ["geolocation"],
+        extraHTTPHeaders: { "Accept-Language": identity.acceptLanguage },
+    };
+    if (realisticProfile)
+        opts.userAgent = REALISTIC_DESKTOP_UA;
+    return opts;
+}
+//# sourceMappingURL=context.js.map

package/dist/engine/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/engine/context.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,wEAAwE;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAW,CAAC;AAE9D,gEAAgE;AAChE,MAAM,UAAU,mBAAmB,CACjC,QAA0B,EAC1B,gBAAyB;IAEzB,MAAM,IAAI,GAA0B;QAClC,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE;QACzB,MAAM,EAAE,EAAE,GAAG,QAAQ,EAAE;QACvB,iBAAiB,EAAE,CAAC;QACpB,QAAQ,EAAE,KAAK;QACf,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,CAAC,aAAa,CAAC;QAC5B,gBAAgB,EAAE,EAAE,iBAAiB,EAAE,QAAQ,CAAC,cAAc,EAAE;KACjE,CAAC;IACF,IAAI,gBAAgB;QAAE,IAAI,CAAC,SAAS,GAAG,oBAAoB,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/launch.d.ts

@@ -0,0 +1,6 @@
+import type { BrowserType } from "playwright";
+import type { ResolvedConfig } from "../agent/config.js";
+import type { OpenedContext } from "../interfaces/engine.js";
+/** Launch the given engine (persistent or ephemeral) and return a ready context. */
+export declare function launchBrowser(browserType: BrowserType, config: ResolvedConfig): Promise<OpenedContext>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/engine/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/engine/launch.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AA+B7D,oFAAoF;AACpF,wBAAsB,aAAa,CACjC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,CAAC,CAiBxB"}

package/dist/engine/launch.js

@@ -0,0 +1,53 @@
+/**
+ * Shared launch logic (persistent or ephemeral context), engine-aware.
+ * Chromium-only options (args, channel) are NOT passed to Firefox/WebKit, which
+ * reject unknown Chromium flags (e.g. WebKit throws on `--no-sandbox`).
+ * @module engine/launch
+ */
+import { existsSync } from "node:fs";
+import { logger } from "../lib/logger.js";
+import { buildContextOptions } from "./context.js";
+import { isChromiumEngine } from "./loader.js";
+const CHROMIUM_ARGS = ["--no-sandbox", "--disable-blink-features=AutomationControlled"];
+/** Build LaunchOptions, applying Chromium-only fields only for Chromium engines. */
+function buildLaunchOptions(config) {
+    const opts = { headless: config.headless };
+    if (isChromiumEngine(config.engine)) {
+        opts.args = CHROMIUM_ARGS;
+        if (config.channel)
+            opts.channel = config.channel;
+    }
+    if (config.executablePath)
+        opts.executablePath = config.executablePath;
+    if (config.proxyUrl)
+        opts.proxy = { server: config.proxyUrl };
+    return opts;
+}
+const INSTALL_HINT = "Chromium is not installed. Run: npx patchright install chromium";
+/** Rethrow a launch failure with an actionable hint when the browser binary is missing. */
+function enrichLaunchError(err) {
+    const message = String(err?.message ?? err);
+    if (message.includes("Executable doesn't exist")) {
+        logger.error("browser binary missing", { hint: INSTALL_HINT });
+        throw new Error(`${INSTALL_HINT}\n${message}`);
+    }
+    throw err;
+}
+/** Launch the given engine (persistent or ephemeral) and return a ready context. */
+export async function launchBrowser(browserType, config) {
+    const launchOptions = buildLaunchOptions(config);
+    const contextOptions = buildContextOptions(config.identity, config.realisticProfile);
+    if (config.userDataDir) {
+        const context = await browserType
+            .launchPersistentContext(config.userDataDir, { ...launchOptions, ...contextOptions })
+            .catch(enrichLaunchError);
+        return { context, browser: null };
+    }
+    const browser = await browserType.launch(launchOptions).catch(enrichLaunchError);
+    if (config.storageStatePath && existsSync(config.storageStatePath)) {
+        contextOptions.storageState = config.storageStatePath;
+    }
+    const context = await browser.newContext(contextOptions);
+    return { context, browser };
+}
+//# sourceMappingURL=launch.js.map

package/dist/engine/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/engine/launch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,aAAa,GAAG,CAAC,cAAc,EAAE,+CAA+C,CAAC,CAAC;AAExF,oFAAoF;AACpF,SAAS,kBAAkB,CAAC,MAAsB;IAChD,MAAM,IAAI,GAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC1D,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACpD,CAAC;IACD,IAAI,MAAM,CAAC,cAAc;QAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;IACvE,IAAI,MAAM,CAAC,QAAQ;QAAE,IAAI,CAAC,KAAK,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,YAAY,GAAG,iEAAiE,CAAC;AAEvF,2FAA2F;AAC3F,SAAS,iBAAiB,CAAC,GAAY;IACrC,MAAM,OAAO,GAAG,MAAM,CAAE,GAAa,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC;IACvD,IAAI,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,KAAK,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,GAAY,CAAC;AACrB,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAwB,EACxB,MAAsB;IAEtB,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,cAAc,GAAG,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAErF,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,WAAW;aAC9B,uBAAuB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,GAAG,aAAa,EAAE,GAAG,cAAc,EAAE,CAAC;aACpF,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjF,IAAI,MAAM,CAAC,gBAAgB,IAAI,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACnE,cAAc,CAAC,YAAY,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACxD,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/engine/loader.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Browser engine loader. Resolves the Playwright/Patchright BrowserType for a
+ * given engine name. Patchright (stealth) is Chromium-only with a Playwright
+ * fallback; firefox/webkit come from Playwright.
+ * @module engine/loader
+ */
+import type { BrowserType } from "playwright";
+import type { EngineName } from "../interfaces/engine-types.js";
+/** True for engines backed by a Chromium browser (stealth/channel/CDP capable). */
+export declare function isChromiumEngine(engine: EngineName): boolean;
+/** Resolve the BrowserType (chromium/firefox/webkit) for the requested engine. */
+export declare function loadBrowserType(engine: EngineName): Promise<BrowserType>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/engine/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/engine/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED,kFAAkF;AAClF,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAa9E"}

package/dist/engine/loader.js

@@ -0,0 +1,24 @@
+import { logger } from "../lib/logger.js";
+/** True for engines backed by a Chromium browser (stealth/channel/CDP capable). */
+export function isChromiumEngine(engine) {
+    return engine === "patchright" || engine === "playwright";
+}
+/** Resolve the BrowserType (chromium/firefox/webkit) for the requested engine. */
+export async function loadBrowserType(engine) {
+    if (engine === "patchright") {
+        try {
+            const mod = (await import("patchright"));
+            return mod.chromium;
+        }
+        catch (err) {
+            logger.warn("patchright unavailable, falling back to playwright chromium", { err: String(err) });
+        }
+    }
+    const pw = await import("playwright");
+    if (engine === "firefox")
+        return pw.firefox;
+    if (engine === "webkit")
+        return pw.webkit;
+    return pw.chromium;
+}
+//# sourceMappingURL=loader.js.map

package/dist/engine/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/engine/loader.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,MAAM,KAAK,YAAY,IAAI,MAAM,KAAK,YAAY,CAAC;AAC5D,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAkB;IACtD,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAyC,CAAC;YACjF,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,6DAA6D,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IACD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,OAAO,CAAC;IAC5C,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,QAAQ,CAAC;AACrB,CAAC"}

package/dist/engine/patchright-engine.d.ts

@@ -0,0 +1,4 @@
+import type { BrowserEngine } from "../interfaces/engine.js";
+/** Engine backed by Patchright (falls back to Playwright if unavailable). */
+export declare const patchrightEngine: BrowserEngine;
+//# sourceMappingURL=patchright-engine.d.ts.map

package/dist/engine/patchright-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchright-engine.d.ts","sourceRoot":"","sources":["../../src/engine/patchright-engine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,yBAAyB,CAAC;AAI5E,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,EAAE,aAK9B,CAAC"}

package/dist/engine/patchright-engine.js

@@ -0,0 +1,10 @@
+import { launchBrowser } from "./launch.js";
+import { loadBrowserType } from "./loader.js";
+/** Engine backed by Patchright (falls back to Playwright if unavailable). */
+export const patchrightEngine = {
+    name: "patchright",
+    async open(config) {
+        return launchBrowser(await loadBrowserType("patchright"), config);
+    },
+};
+//# sourceMappingURL=patchright-engine.js.map

package/dist/engine/patchright-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patchright-engine.js","sourceRoot":"","sources":["../../src/engine/patchright-engine.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,IAAI,EAAE,YAAY;IAClB,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,OAAO,aAAa,CAAC,MAAM,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF,CAAC"}

package/dist/engine/playwright-engine.d.ts

@@ -0,0 +1,8 @@
+import type { BrowserEngine } from "../interfaces/engine.js";
+/** Engine backed by the official Playwright Chromium. */
+export declare const playwrightEngine: BrowserEngine;
+/** Engine backed by Playwright Firefox (Gecko). No stealth, no CDP/channel. */
+export declare const firefoxEngine: BrowserEngine;
+/** Engine backed by Playwright WebKit (Safari engine). No stealth, no CDP/channel. */
+export declare const webkitEngine: BrowserEngine;
+//# sourceMappingURL=playwright-engine.d.ts.map

package/dist/engine/playwright-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-engine.d.ts","sourceRoot":"","sources":["../../src/engine/playwright-engine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,yBAAyB,CAAC;AAI5E,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,aAK9B,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,aAAa,EAAE,aAK3B,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,YAAY,EAAE,aAK1B,CAAC"}

package/dist/engine/playwright-engine.js

@@ -0,0 +1,24 @@
+import { launchBrowser } from "./launch.js";
+import { loadBrowserType } from "./loader.js";
+/** Engine backed by the official Playwright Chromium. */
+export const playwrightEngine = {
+    name: "playwright",
+    async open(config) {
+        return launchBrowser(await loadBrowserType("playwright"), config);
+    },
+};
+/** Engine backed by Playwright Firefox (Gecko). No stealth, no CDP/channel. */
+export const firefoxEngine = {
+    name: "firefox",
+    async open(config) {
+        return launchBrowser(await loadBrowserType("firefox"), config);
+    },
+};
+/** Engine backed by Playwright WebKit (Safari engine). No stealth, no CDP/channel. */
+export const webkitEngine = {
+    name: "webkit",
+    async open(config) {
+        return launchBrowser(await loadBrowserType("webkit"), config);
+    },
+};
+//# sourceMappingURL=playwright-engine.js.map

package/dist/engine/playwright-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-engine.js","sourceRoot":"","sources":["../../src/engine/playwright-engine.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,yDAAyD;AACzD,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,IAAI,EAAE,YAAY;IAClB,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,OAAO,aAAa,CAAC,MAAM,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,IAAI,EAAE,SAAS;IACf,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,OAAO,aAAa,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC;CACF,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,IAAI,EAAE,QAAQ;IACd,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,OAAO,aAAa,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;CACF,CAAC"}

package/dist/engine/registry.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Engine registry: choose the browser engine for a resolved config.
+ * A `cdpEndpoint` forces the CDP attach engine regardless of `engine`.
+ * @module engine/registry
+ */
+import type { ResolvedConfig } from "../agent/config.js";
+import type { BrowserEngine } from "../interfaces/engine.js";
+import type { EngineName } from "../interfaces/engine-types.js";
+/** Select the launch engine for `name`, defaulting to Patchright (stealth). */
+export declare function selectEngine(name: EngineName): BrowserEngine;
+/** Select the engine for a config: CDP attach if `cdpEndpoint`, else launch. */
+export declare function selectEngineForConfig(config: ResolvedConfig): BrowserEngine;
+//# sourceMappingURL=registry.d.ts.map

package/dist/engine/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/engine/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAYhE,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAE5D;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,CAE3E"}

package/dist/engine/registry.js

@@ -0,0 +1,18 @@
+import { cdpEngine } from "./cdp-engine.js";
+import { patchrightEngine } from "./patchright-engine.js";
+import { firefoxEngine, playwrightEngine, webkitEngine } from "./playwright-engine.js";
+const ENGINES = {
+    playwright: playwrightEngine,
+    patchright: patchrightEngine,
+    firefox: firefoxEngine,
+    webkit: webkitEngine,
+};
+/** Select the launch engine for `name`, defaulting to Patchright (stealth). */
+export function selectEngine(name) {
+    return ENGINES[name] ?? patchrightEngine;
+}
+/** Select the engine for a config: CDP attach if `cdpEndpoint`, else launch. */
+export function selectEngineForConfig(config) {
+    return config.cdpEndpoint ? cdpEngine : selectEngine(config.engine);
+}
+//# sourceMappingURL=registry.js.map

package/dist/engine/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/engine/registry.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvF,MAAM,OAAO,GAAsC;IACjD,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,gBAAgB;IAC5B,OAAO,EAAE,aAAa;IACtB,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC;AAC3C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC"}

package/dist/extraction/challenges.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Detection of anti-bot and authentication challenges.
+ * @module extraction/challenges
+ */
+import type { Page } from "playwright";
+import type { Challenges } from "../interfaces/extraction.js";
+/** Combine DOM and text signals to detect captcha, Cloudflare, login, OTP. */
+export declare function detectChallenges(page: Page, text: string): Promise<Challenges>;
+//# sourceMappingURL=challenges.d.ts.map

package/dist/extraction/challenges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenges.d.ts","sourceRoot":"","sources":["../../src/extraction/challenges.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAiB9D,8EAA8E;AAC9E,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBpF"}

package/dist/extraction/challenges.js

@@ -0,0 +1,24 @@
+import { evalScript } from "../lib/evaluate.js";
+const DOM_FLAGS_SCRIPT = `() => ({
+  recaptcha: Boolean(document.querySelector('.g-recaptcha, iframe[src*="recaptcha"]')),
+  turnstile: Boolean(document.querySelector('input[name="cf-turnstile-response"], iframe[src*="turnstile"]')),
+  hcaptcha: Boolean(document.querySelector('.h-captcha, iframe[src*="hcaptcha"]')),
+  password: Boolean(document.querySelector('input[type="password"]')),
+})`;
+/** Combine DOM and text signals to detect captcha, Cloudflare, login, OTP. */
+export async function detectChallenges(page, text) {
+    const lowered = text.toLowerCase();
+    const flags = await evalScript(page, DOM_FLAGS_SCRIPT);
+    const captcha = Boolean(flags.recaptcha || flags.hcaptcha || lowered.includes("captcha") || lowered.includes("i'm not a robot"));
+    return {
+        captcha,
+        turnstile: Boolean(flags.turnstile || lowered.includes("turnstile")),
+        hcaptcha: Boolean(flags.hcaptcha || lowered.includes("hcaptcha")),
+        cloudflare: lowered.includes("checking if the site connection is secure") || lowered.includes("cloudflare"),
+        login: Boolean(flags.password || lowered.includes("sign in") || lowered.includes("log in")),
+        otp: lowered.includes("one-time") ||
+            lowered.includes("verification code") ||
+            lowered.includes("code de vérification"),
+    };
+}
+//# sourceMappingURL=challenges.js.map

package/dist/extraction/challenges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenges.js","sourceRoot":"","sources":["../../src/extraction/challenges.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,gBAAgB,GAAG;;;;;GAKtB,CAAC;AASJ,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU,EAAE,IAAY;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,UAAU,CAAW,IAAI,EAAE,gBAAgB,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CACrB,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CACxG,CAAC;IACF,OAAO;QACL,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACpE,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACjE,UAAU,EACR,OAAO,CAAC,QAAQ,CAAC,2CAA2C,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QACjG,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3F,GAAG,EACD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC5B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACrC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/extraction/hotel-offers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Hotel offers aggregation from visible page text (Google Hotels style).
+ * @module extraction/hotel-offers
+ */
+import type { HotelOffers } from "../interfaces/extraction.js";
+/**
+ * Extract the headline offer (before "All options") and the list of offers
+ * (each block terminated by "Visit site"), plus the best total.
+ */
+export declare function extractHotelOffers(text: string): HotelOffers;
+//# sourceMappingURL=hotel-offers.d.ts.map

package/dist/extraction/hotel-offers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotel-offers.d.ts","sourceRoot":"","sources":["../../src/extraction/hotel-offers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,6BAA6B,CAAC;AA0B3E;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAoC5D"}

package/dist/extraction/hotel-offers.js

@@ -0,0 +1,63 @@
+import { parseSinglePrice } from "./prices.js";
+const STOP_MARKERS = ["top things", "prices are currently", "show price range", "nearby places"];
+/** Build an offer from a block of lines (provider + best price). */
+function offerFromChunk(chunk) {
+    const prices = chunk.map(parseSinglePrice).filter((p) => p !== null);
+    if (prices.length === 0)
+        return null;
+    const price = prices.reduce((a, b) => (b.amount < a.amount ? b : a));
+    const providerLines = chunk.filter((line) => !parseSinglePrice(line) &&
+        !line.startsWith(",") &&
+        !line.toLowerCase().includes("save ") &&
+        !line.toLowerCase().includes("free cancellation"));
+    let provider;
+    if (providerLines.length >= 2 && providerLines[1]?.toLowerCase() === "official site") {
+        provider = `${providerLines[0]} Official site`;
+    }
+    else {
+        provider = providerLines[0] ?? "unknown";
+    }
+    return { provider, currency: price.currency, amount: price.amount };
+}
+/**
+ * Extract the headline offer (before "All options") and the list of offers
+ * (each block terminated by "Visit site"), plus the best total.
+ */
+export function extractHotelOffers(text) {
+    const lines = text
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    const allOptionsIndex = lines.includes("All options") ? lines.indexOf("All options") : lines.length;
+    let headline = null;
+    for (const line of lines.slice(0, allOptionsIndex)) {
+        const price = parseSinglePrice(line);
+        if (price) {
+            headline = price;
+            break;
+        }
+    }
+    const options = [];
+    if (allOptionsIndex < lines.length) {
+        let chunk = [];
+        for (const line of lines.slice(allOptionsIndex + 1)) {
+            if (STOP_MARKERS.some((m) => line.toLowerCase().includes(m)))
+                break;
+            if (line === "Visit site") {
+                const offer = offerFromChunk(chunk);
+                if (offer)
+                    options.push(offer);
+                chunk = [];
+            }
+            else if (line.startsWith("View more options")) {
+                break;
+            }
+            else {
+                chunk.push(line);
+            }
+        }
+    }
+    const bestTotal = options.length > 0 ? options.reduce((a, b) => (b.amount < a.amount ? b : a)) : null;
+    return { headline, options, bestTotal };
+}
+//# sourceMappingURL=hotel-offers.js.map

package/dist/extraction/hotel-offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotel-offers.js","sourceRoot":"","sources":["../../src/extraction/hotel-offers.ts"],"names":[],"mappings":"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"}

package/dist/extraction/main-text.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read the page's MAIN content text, excluding duplicated nav/menu/footer.
+ * Targets the main landmark first (structural filter — survives hidden mobile
+ * menus that innerText would otherwise include), falling back to <body>.
+ * @module extraction/main-text
+ */
+import type { Page } from "playwright";
+/**
+ * Return the trimmed innerText of the first matching main-content landmark,
+ * or the whole body if none is present.
+ */
+export declare function mainText(page: Page, timeout?: number): Promise<string>;
+//# sourceMappingURL=main-text.d.ts.map

package/dist/extraction/main-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-text.d.ts","sourceRoot":"","sources":["../../src/extraction/main-text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAU3E"}

package/dist/extraction/main-text.js

@@ -0,0 +1,20 @@
+/** Main-content selectors, most to least specific; `body` is the fallback. */
+const MAIN_SELECTORS = ["main", "[role=main]", "article"];
+/**
+ * Return the trimmed innerText of the first matching main-content landmark,
+ * or the whole body if none is present.
+ */
+export async function mainText(page, timeout = 3_000) {
+    for (const selector of MAIN_SELECTORS) {
+        const loc = page.locator(selector).first();
+        try {
+            if ((await loc.count()) > 0)
+                return await loc.innerText({ timeout });
+        }
+        catch {
+            /* try the next selector */
+        }
+    }
+    return page.locator("body").innerText({ timeout });
+}
+//# sourceMappingURL=main-text.js.map

package/dist/extraction/main-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-text.js","sourceRoot":"","sources":["../../src/extraction/main-text.ts"],"names":[],"mappings":"AAQA,8EAA8E;AAC9E,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAU,EAAE,OAAO,GAAG,KAAK;IACxD,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC;gBAAE,OAAO,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/extraction/prices.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Multi-currency visible price extraction from page text.
+ * @module extraction/prices
+ */
+import type { Price } from "../interfaces/extraction.js";
+/** Normalize a raw amount: float when it has decimals, otherwise integer (separators stripped). */
+export declare function normaliseAmount(raw: string): number;
+/**
+ * Extract visible prices, skipping ranges (e.g. "20–30") and irrelevant lines
+ * (restaurant, parking…). Deduplicates by currency+amount.
+ */
+export declare function extractPrices(text: string): Price[];
+/** First price of a line, or null. */
+export declare function parseSinglePrice(line: string): {
+    currency: string;
+    amount: number;
+} | null;
+//# sourceMappingURL=prices.d.ts.map

package/dist/extraction/prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.d.ts","sourceRoot":"","sources":["../../src/extraction/prices.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAuCzD,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAmBnD;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI1F"}