@fusengine/browser-mcp 0.1.0

package/dist/server/tools/navigate.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { gotoWithRetry } from "../../net/navigate.js";
+import { jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+/** Register `browser_navigate`. */
+export function registerNavigateTool(server, sessions) {
+    server.registerTool("browser_navigate", {
+        title: "Navigate",
+        description: "Navigate a live session to a URL and return the resulting title.",
+        inputSchema: { sessionId: z.string(), url: z.string(), waitMs: z.number().int().optional() },
+    }, async (args) => {
+        const a = args;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            await gotoWithRetry(s.page, String(a.url), { waitUntil: "domcontentloaded", timeout: 30_000 });
+            try {
+                await s.page.waitForLoadState("networkidle", { timeout: 10_000 });
+            }
+            catch {
+                /* networkidle is best-effort */
+            }
+            if (a.waitMs)
+                await s.page.waitForTimeout(Number(a.waitMs));
+            return jsonResult({ url: s.page.url(), title: await s.page.title() });
+        });
+    });
+}
+//# sourceMappingURL=navigate.js.map

package/dist/server/tools/navigate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.js","sourceRoot":"","sources":["../../../src/server/tools/navigate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,mCAAmC;AACnC,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,QAAwB;IAC9E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,kEAAkE;QAC/E,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE;KAC7F,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,MAAM,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/F,IAAI,CAAC;gBACH,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;YACD,IAAI,CAAC,CAAC,MAAM;gBAAE,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5D,OAAO,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/probe.d.ts

@@ -0,0 +1,8 @@
+/**
+ * One-shot probe tools (parity with the original CLI/MCP).
+ * @module server/tools/probe
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register `browser_probe` and `browser_probe_html`. */
+export declare function registerProbeTools(server: McpServer): void;
+//# sourceMappingURL=probe.d.ts.map

package/dist/server/tools/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../src/server/tools/probe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyC1D"}

package/dist/server/tools/probe.js

@@ -0,0 +1,44 @@
+import { BrowserAgent } from "../../agent/browser-agent.js";
+import { compactReport } from "../../agent/compact.js";
+import { GuardrailViolation } from "../../lib/errors.js";
+import { toAgentOptions, toProbeOptions } from "../map-options.js";
+import { errorResult, jsonResult } from "../result.js";
+import { probeHtmlShape, probeShape } from "../schemas.js";
+/** Register `browser_probe` and `browser_probe_html`. */
+export function registerProbeTools(server) {
+    server.registerTool("browser_probe", {
+        title: "Browser probe",
+        description: "Open a real browser page and return text, screenshot path, network/console logs, optional prices, visual observation and challenge detection.",
+        inputSchema: probeShape,
+    }, async (args) => {
+        const raw = args;
+        const agent = new BrowserAgent(toAgentOptions(raw));
+        try {
+            const report = await agent.probe(String(raw.url), toProbeOptions(raw));
+            return jsonResult(compactReport(report));
+        }
+        catch (err) {
+            if (err instanceof GuardrailViolation)
+                return errorResult(err.message);
+            throw err;
+        }
+    });
+    server.registerTool("browser_probe_html", {
+        title: "Browser probe HTML",
+        description: "Probe an inline HTML fixture with the same engine. Useful for tests and dry-runs.",
+        inputSchema: probeHtmlShape,
+    }, async (args) => {
+        const raw = args;
+        const agent = new BrowserAgent(toAgentOptions(raw));
+        try {
+            const report = await agent.probeHtml(String(raw.html), toProbeOptions(raw));
+            return jsonResult(compactReport(report));
+        }
+        catch (err) {
+            if (err instanceof GuardrailViolation)
+                return errorResult(err.message);
+            throw err;
+        }
+    });
+}
+//# sourceMappingURL=probe.js.map

package/dist/server/tools/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../../src/server/tools/probe.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3D,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,+IAA+I;QACjJ,WAAW,EAAE,UAAU;KACxB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;YACvE,OAAO,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB;gBAAE,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE,cAAc;KAC5B,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,IAA+B,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5E,OAAO,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,kBAAkB;gBAAE,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvE,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/run.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `browser_run`: execute a multi-step plan in one call (navigate/act/wait/extract),
+ * stopping at the first failed step. Reduces LLM round-trips.
+ * @module server/tools/run
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_run`. */
+export declare function registerRunTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=run.d.ts.map

package/dist/server/tools/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/server/tools/run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM/D,8BAA8B;AAC9B,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAyBjF"}

package/dist/server/tools/run.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { runSteps } from "../../agent/run-steps.js";
+import { preflight } from "../../guardrails/preflight.js";
+import { errorResult, jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+const stepSchema = z.object({ type: z.string() }).catchall(z.unknown());
+/** Register `browser_run`. */
+export function registerRunTool(server, sessions) {
+    server.registerTool("browser_run", {
+        title: "Run multi-step plan",
+        description: "Execute an ordered list of steps (navigate, click, fill, scroll, press, select, wait_for, extract) in one call. Stops at the first failed step. Sensitive actions need humanApproved.",
+        inputSchema: {
+            sessionId: z.string(),
+            steps: z.array(stepSchema),
+            humanApproved: z.boolean().optional(),
+        },
+    }, async (args) => {
+        const a = args;
+        const steps = a.steps ?? [];
+        const pf = preflight(steps, Boolean(a.humanApproved));
+        if (!pf.allowed)
+            return errorResult(`Action blocked: ${pf.reason}: ${pf.blockedActions.join(", ")}`);
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const results = await runSteps(s.page, steps, s.config.humanMode);
+            const ok = results.every((r) => r.ok) && results.length === steps.length;
+            return jsonResult({ ok, steps: results, url: s.page.url() });
+        });
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/server/tools/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/server/tools/run.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAgB,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAExE,8BAA8B;AAC9B,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,QAAwB;IACzE,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,uLAAuL;QACzL,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;YAC1B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACtC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,MAAM,KAAK,GAAI,CAAC,CAAC,KAAmB,IAAI,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,EAAE,CAAC,OAAO;YAAE,OAAO,WAAW,CAAC,mBAAmB,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrG,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAClE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC;YACzE,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/screenshot.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Screenshot tool: returns a PNG as MCP image content. Optionally targets a
+ * single element by its snapshot `ref` (focused vision, fewer image tokens).
+ * @module server/tools/screenshot
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_screenshot`. */
+export declare function registerScreenshotTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=screenshot.d.ts.map

package/dist/server/tools/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/server/tools/screenshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,qCAAqC;AACrC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAuBxF"}

package/dist/server/tools/screenshot.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { REF_ATTRIBUTE } from "../../extraction/snapshot.js";
+import { errorResult, imageResult } from "../result.js";
+import { withSession } from "./with-session.js";
+/** Register `browser_screenshot`. */
+export function registerScreenshotTool(server, sessions) {
+    server.registerTool("browser_screenshot", {
+        title: "Screenshot",
+        description: "Capture the live page as a PNG for vision. Pass `ref` (from browser_snapshot) to capture only that element instead of the page.",
+        inputSchema: { sessionId: z.string(), fullPage: z.boolean().optional(), ref: z.number().int().optional() },
+    }, async (args) => {
+        const a = args;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            if (typeof a.ref === "number") {
+                const locator = s.page.locator(`[${REF_ATTRIBUTE}="${a.ref}"]`).first();
+                if ((await locator.count()) === 0)
+                    return errorResult("ref_not_found");
+                const buf = await locator.screenshot({ timeout: 5_000 });
+                return imageResult(buf.toString("base64"), `element ref=${a.ref}`);
+            }
+            const buffer = await s.page.screenshot({ fullPage: Boolean(a.fullPage) });
+            return imageResult(buffer.toString("base64"), `screenshot of ${s.page.url()}`);
+        });
+    });
+}
+//# sourceMappingURL=screenshot.js.map

package/dist/server/tools/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/server/tools/screenshot.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qCAAqC;AACrC,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,QAAwB;IAChF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,iIAAiI;QACnI,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE;KAC3G,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxE,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC;oBAAE,OAAO,WAAW,CAAC,eAAe,CAAC,CAAC;gBACvE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;gBACzD,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1E,OAAO,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/session.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Session lifecycle tools: open / status / close.
+ * @module server/tools/session
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_open`, `browser_status`, `browser_close`. */
+export declare function registerSessionTools(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=session.d.ts.map

package/dist/server/tools/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/server/tools/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM/D,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAuCtF"}

package/dist/server/tools/session.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { resolveConfig } from "../../agent/config.js";
+import { buildIdentity } from "../../identity/identity.js";
+import { toAgentOptions } from "../map-options.js";
+import { jsonResult } from "../result.js";
+import { agentOptionShape } from "../schemas.js";
+import { withSession } from "./with-session.js";
+/** Register `browser_open`, `browser_status`, `browser_close`. */
+export function registerSessionTools(server, sessions) {
+    server.registerTool("browser_open", { title: "Open browser session", description: "Open a persistent browser session and return its id.", inputSchema: agentOptionShape }, async (args) => {
+        const config = resolveConfig(toAgentOptions(args));
+        const s = await sessions.open(config);
+        const identity = buildIdentity({
+            identity: config.identity,
+            realisticProfile: config.realisticProfile,
+            userDataDir: config.userDataDir,
+            proxyUrl: config.proxyUrl,
+            proxySource: config.proxySource,
+        });
+        return jsonResult({ sessionId: s.id, expiresAt: s.expiresAt, identity });
+    });
+    server.registerTool("browser_status", { title: "Session status", description: "Status of one session (sessionId) or all sessions.", inputSchema: { sessionId: z.string().optional() } }, async (args) => {
+        const id = args.sessionId;
+        if (!id) {
+            return jsonResult({
+                sessions: sessions.list().map((s) => ({ sessionId: s.id, url: s.page.url(), expiresAt: s.expiresAt })),
+            });
+        }
+        return withSession(sessions, id, async (s) => jsonResult({ sessionId: s.id, url: s.page.url(), createdAt: s.createdAt, expiresAt: s.expiresAt }));
+    });
+    server.registerTool("browser_close", { title: "Close session", description: "Close a browser session by id.", inputSchema: { sessionId: z.string() } }, async (args) => jsonResult({ closed: await sessions.close(String(args.sessionId)) }));
+}
+//# sourceMappingURL=session.js.map

package/dist/server/tools/session.js.map

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

package/dist/server/tools/snapshot.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Snapshot + act-by-ref tools: the agentic targeting layer.
+ * `browser_snapshot` returns indexed interactive elements (each with a `ref`);
+ * `browser_act` executes an action on a chosen `ref` (or text fallback) and
+ * returns a diff of what changed on the page (added/removed/text/url).
+ * @module server/tools/snapshot
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_snapshot` and `browser_act`. */
+export declare function registerSnapshotTools(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/server/tools/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/server/tools/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAiB/D,qDAAqD;AACrD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CA6CvF"}

package/dist/server/tools/snapshot.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import { actByRef } from "../../actions/act-by-ref.js";
+import { smartClick } from "../../actions/smart-click.js";
+import { smartFill } from "../../actions/smart-fill.js";
+import { captureSnapshot } from "../../extraction/snapshot.js";
+import { diffSnapshots } from "../../extraction/snapshot-diff.js";
+import { errorResult, jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+const KIND = z.enum(["click", "fill", "select"]);
+/** Run the chosen action (by ref or text fallback). */
+async function runAct(page, a, human) {
+    const kind = a.kind;
+    const value = a.value ? String(a.value) : "";
+    if (typeof a.ref === "number")
+        return actByRef(page, a.ref, kind, value);
+    if (typeof a.target !== "string")
+        return null;
+    return kind === "fill"
+        ? smartFill(page, a.target, value, "", human)
+        : smartClick(page, a.target, "", human);
+}
+/** Register `browser_snapshot` and `browser_act`. */
+export function registerSnapshotTools(server, sessions) {
+    server.registerTool("browser_snapshot", {
+        title: "Snapshot",
+        description: "Return the indexed interactive elements of the live page. Each element gets a stable `ref` to use with browser_act for deterministic targeting.",
+        inputSchema: { sessionId: z.string() },
+    }, async (args) => {
+        const a = args;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const elements = await captureSnapshot(s.page);
+            return jsonResult({ url: s.page.url(), count: elements.length, elements });
+        });
+    });
+    server.registerTool("browser_act", {
+        title: "Act on element",
+        description: "Execute click/fill/select on an element by `ref` (from browser_snapshot) or by `target` text. Returns a diff of what changed (added/removed/text/url).",
+        inputSchema: {
+            sessionId: z.string(),
+            kind: KIND,
+            ref: z.number().int().optional(),
+            target: z.string().optional(),
+            value: z.string().optional(),
+        },
+    }, async (args) => {
+        const a = args;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const before = await captureSnapshot(s.page);
+            const urlBefore = s.page.url();
+            const result = await runAct(s.page, a, s.config.humanMode);
+            if (!result)
+                return errorResult("browser_act requires either `ref` or `target`");
+            const after = await captureSnapshot(s.page);
+            const diff = diffSnapshots(before, after, s.page.url() !== urlBefore);
+            return jsonResult({ result, url: s.page.url(), diff });
+        });
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/server/tools/snapshot.js.map

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

package/dist/server/tools/wait.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `browser_wait_for`: semantic wait on a live session (text/selector/url/gone).
+ * @module server/tools/wait
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionManager } from "../../session/manager.js";
+/** Register `browser_wait_for`. */
+export declare function registerWaitTool(server: McpServer, sessions: SessionManager): void;
+//# sourceMappingURL=wait.d.ts.map

package/dist/server/tools/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/server/tools/wait.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CA8BlF"}

package/dist/server/tools/wait.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { waitForCondition } from "../../actions/wait-for.js";
+import { jsonResult } from "../result.js";
+import { withSession } from "./with-session.js";
+/** Register `browser_wait_for`. */
+export function registerWaitTool(server, sessions) {
+    server.registerTool("browser_wait_for", {
+        title: "Wait for condition",
+        description: "Wait until a condition holds: text appears, selector visible, selector gone, or URL contains a substring. Use instead of fixed delays.",
+        inputSchema: {
+            sessionId: z.string(),
+            text: z.string().optional(),
+            selector: z.string().optional(),
+            gone: z.string().optional(),
+            urlContains: z.string().optional(),
+            timeoutMs: z.number().int().optional(),
+        },
+    }, async (args) => {
+        const a = args;
+        return withSession(sessions, String(a.sessionId), async (s) => {
+            const result = await waitForCondition(s.page, {
+                text: a.text,
+                selector: a.selector,
+                gone: a.gone,
+                urlContains: a.urlContains,
+                timeoutMs: a.timeoutMs,
+            });
+            return jsonResult({ result, url: s.page.url() });
+        });
+    });
+}
+//# sourceMappingURL=wait.js.map

package/dist/server/tools/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../../src/server/tools/wait.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,mCAAmC;AACnC,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,QAAwB;IAC1E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,wIAAwI;QAC1I,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;SACvC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,IAA+B,CAAC;QAC1C,OAAO,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YAC5D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC5C,IAAI,EAAE,CAAC,CAAC,IAA0B;gBAClC,QAAQ,EAAE,CAAC,CAAC,QAA8B;gBAC1C,IAAI,EAAE,CAAC,CAAC,IAA0B;gBAClC,WAAW,EAAE,CAAC,CAAC,WAAiC;gBAChD,SAAS,EAAE,CAAC,CAAC,SAA+B;aAC7C,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/with-session.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared helper: resolve a session or return an error result.
+ * @module server/tools/with-session
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { SessionManager } from "../../session/manager.js";
+import type { SessionData } from "../../session/session.js";
+/** Run `fn` with the resolved session, or return an error result if missing. */
+export declare function withSession(sessions: SessionManager, id: string, fn: (session: SessionData) => Promise<CallToolResult>): Promise<CallToolResult>;
+//# sourceMappingURL=with-session.d.ts.map

package/dist/server/tools/with-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-session.d.ts","sourceRoot":"","sources":["../../../src/server/tools/with-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,gFAAgF;AAChF,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,GACpD,OAAO,CAAC,cAAc,CAAC,CASzB"}

package/dist/server/tools/with-session.js

@@ -0,0 +1,16 @@
+import { SessionNotFoundError } from "../../lib/errors.js";
+import { errorResult } from "../result.js";
+/** Run `fn` with the resolved session, or return an error result if missing. */
+export async function withSession(sessions, id, fn) {
+    let session;
+    try {
+        session = sessions.get(id);
+    }
+    catch (err) {
+        if (err instanceof SessionNotFoundError)
+            return errorResult(err.message);
+        throw err;
+    }
+    return fn(session);
+}
+//# sourceMappingURL=with-session.js.map

package/dist/server/tools/with-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-session.js","sourceRoot":"","sources":["../../../src/server/tools/with-session.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,QAAwB,EACxB,EAAU,EACV,EAAqD;IAErD,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,oBAAoB;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzE,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC"}

package/dist/session/manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Session lifecycle manager with per-session TTL cleanup and a concurrent cap.
+ * @module session/manager
+ */
+import type { ResolvedConfig } from "../agent/config.js";
+import { type SessionData } from "./session.js";
+/** Options for the session manager. */
+export interface SessionManagerOptions {
+    /** Idle TTL before a session is auto-closed (ms). */
+    ttlMs?: number;
+    /** Maximum concurrent live sessions (guards against OOM). */
+    maxSessions?: number;
+}
+/** Holds live sessions and closes them on TTL expiry or shutdown. */
+export declare class SessionManager {
+    private readonly sessions;
+    private readonly timers;
+    private readonly ttlMs;
+    private readonly maxSessions;
+    private counter;
+    constructor(opts?: SessionManagerOptions);
+    /**
+     * Open a new session and schedule its TTL cleanup.
+     * @throws {SessionLimitError} when the concurrent cap is reached.
+     */
+    open(config: ResolvedConfig): Promise<SessionData>;
+    /** Get a session (refreshing its TTL) or throw if missing. */
+    get(id: string): SessionData;
+    /** Refresh a session's TTL. */
+    touch(id: string): void;
+    private schedule;
+    /** Close and remove a session; returns false if it did not exist. */
+    close(id: string): Promise<boolean>;
+    /** Close every session (used on shutdown). */
+    closeAll(): Promise<void>;
+    /** Snapshot of currently open sessions. */
+    list(): SessionData[];
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/session/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/session/manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAA6B,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3E,uCAAuC;AACvC,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,GAAE,qBAA0B;IAK5C;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAUxD,8DAA8D;IAC9D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW;IAO5B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOvB,OAAO,CAAC,QAAQ;IAQhB,qEAAqE;IAC/D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAazC,8CAA8C;IACxC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,2CAA2C;IAC3C,IAAI,IAAI,WAAW,EAAE;CAGtB"}

package/dist/session/manager.js

@@ -0,0 +1,76 @@
+import { SessionLimitError, SessionNotFoundError } from "../lib/errors.js";
+import { sha1 } from "../lib/fs.js";
+import { closeSession, openSession } from "./session.js";
+/** Holds live sessions and closes them on TTL expiry or shutdown. */
+export class SessionManager {
+    sessions = new Map();
+    timers = new Map();
+    ttlMs;
+    maxSessions;
+    counter = 0;
+    constructor(opts = {}) {
+        this.ttlMs = opts.ttlMs ?? 300_000;
+        this.maxSessions = opts.maxSessions ?? 8;
+    }
+    /**
+     * Open a new session and schedule its TTL cleanup.
+     * @throws {SessionLimitError} when the concurrent cap is reached.
+     */
+    async open(config) {
+        if (this.sessions.size >= this.maxSessions)
+            throw new SessionLimitError(this.maxSessions);
+        this.counter += 1;
+        const id = sha1(`${config.outputDir}-${Date.now()}-${this.counter}`).slice(0, 12);
+        const session = await openSession(id, config, this.ttlMs);
+        this.sessions.set(id, session);
+        this.schedule(id);
+        return session;
+    }
+    /** Get a session (refreshing its TTL) or throw if missing. */
+    get(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            throw new SessionNotFoundError(id);
+        this.touch(id);
+        return session;
+    }
+    /** Refresh a session's TTL. */
+    touch(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            return;
+        session.expiresAt = Date.now() + this.ttlMs;
+        this.schedule(id);
+    }
+    schedule(id) {
+        const existing = this.timers.get(id);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => void this.close(id), this.ttlMs);
+        timer.unref?.();
+        this.timers.set(id, timer);
+    }
+    /** Close and remove a session; returns false if it did not exist. */
+    async close(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            return false;
+        this.sessions.delete(id);
+        const timer = this.timers.get(id);
+        if (timer) {
+            clearTimeout(timer);
+            this.timers.delete(id);
+        }
+        await closeSession(session);
+        return true;
+    }
+    /** Close every session (used on shutdown). */
+    async closeAll() {
+        await Promise.allSettled([...this.sessions.keys()].map((id) => this.close(id)));
+    }
+    /** Snapshot of currently open sessions. */
+    list() {
+        return [...this.sessions.values()];
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/session/manager.js.map

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

package/dist/session/session.d.ts

@@ -0,0 +1,28 @@
+/**
+ * A live browser session: a context + page kept alive between MCP calls.
+ * @module session/session
+ */
+import type { Browser, BrowserContext, Page } from "playwright";
+import type { ResolvedConfig } from "../agent/config.js";
+import { type NetworkLog } from "../agent/network.js";
+/** Live session state. */
+export interface SessionData {
+    id: string;
+    context: BrowserContext;
+    browser: Browser | null;
+    page: Page;
+    config: ResolvedConfig;
+    logs: NetworkLog;
+    connected: boolean;
+    createdAt: number;
+    expiresAt: number;
+}
+/** Open a new live session with listeners attached. */
+export declare function openSession(id: string, config: ResolvedConfig, ttlMs: number): Promise<SessionData>;
+/**
+ * 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 declare function closeSession(session: SessionData): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session/session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGvE,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,wBAAsB,WAAW,CAC/B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtE"}