@fusengine/browser-mcp 0.1.7 → 0.1.9

package/README.md

@@ -47,6 +47,13 @@ npx fuse-browser probe 'https://www.booking.com/searchresults.html?ss=Tokyo' \
 
 # Use the installed Chrome
 npx fuse-browser probe https://example.com --channel chrome
+
+# SEO rank tracking across many keywords (one session)
+npx fuse-browser serp-batch "agence web vevey" "création site web lausanne" \
+  --rank-domain fusengine.ch --serp-pages 2 --hl fr --gl ch
+
+# Responsive screenshots (saved PNGs) — works on localhost too
+npx fuse-browser shots http://localhost:8000 --viewports mobile,desktop,1280x720
 ```
 
 Sensitive actions (`pay`, `book`, `checkout`, `confirm`, …) are **blocked** unless
@@ -95,7 +102,7 @@ Supported: `FUSE_ENGINE`, `FUSE_CHANNEL`, `FUSE_CDP_ENDPOINT`, `FUSE_EXECUTABLE_
 | **Agentic** | `browser_snapshot` (indexed refs), `browser_act` (by ref + page diff), `browser_run` (multi-step plan) |
 | **Extract** | `browser_extract` (text/prices/hotels/challenges), `browser_extract_schema` (typed, by CSS selectors) |
 | **SERP** | `browser_serp_batch` — multi-query Google search in one session, per-query organic results + domain rank |
-| **Vision** | `browser_screenshot` (page or single element by `ref`) |
+| **Vision** | `browser_screenshot` (page, single element by `ref`, or responsive set via `viewport`/`viewports`) |
 
 Key agentic patterns:
 

package/dist/agent/shots.d.ts

@@ -0,0 +1,12 @@
+import { type ViewportInput } from "../engine/viewport.js";
+import type { ResolvedConfig } from "./config.js";
+/** One saved responsive screenshot. */
+export interface Shot {
+    viewport: string;
+    width: number;
+    height: number;
+    path: string;
+}
+/** Open `url`, screenshot it at each viewport, return the saved file paths. */
+export declare function captureShots(config: ResolvedConfig, url: string, viewports: ViewportInput[]): Promise<Shot[]>;
+//# sourceMappingURL=shots.d.ts.map

package/dist/agent/shots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shots.d.ts","sourceRoot":"","sources":["../../src/agent/shots.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,aAAa,EAAmB,MAAM,uBAAuB,CAAC;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,uCAAuC;AACvC,MAAM,WAAW,IAAI;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,wBAAsB,YAAY,CAChC,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,aAAa,EAAE,GACzB,OAAO,CAAC,IAAI,EAAE,CAAC,CAoBjB"}

package/dist/agent/shots.js

@@ -0,0 +1,35 @@
+/**
+ * Capture one page across several viewports, saving a PNG per viewport.
+ * Uses `setViewportSize` (CSS-responsive screenshot, not full device emulation).
+ * @module agent/shots
+ */
+import { join } from "node:path";
+import { selectEngineForConfig } from "../engine/registry.js";
+import { teardownOpened } from "../engine/teardown.js";
+import { resolveViewport } from "../engine/viewport.js";
+import { ensureDir, sha1 } from "../lib/fs.js";
+import { gotoWithRetry } from "../net/navigate.js";
+/** Open `url`, screenshot it at each viewport, return the saved file paths. */
+export async function captureShots(config, url, viewports) {
+    ensureDir(config.outputDir);
+    const runId = sha1(`${url}-shots`).slice(0, 10);
+    const opened = await selectEngineForConfig(config).open(config);
+    const page = opened.page ?? (await opened.context.newPage());
+    const shots = [];
+    try {
+        await gotoWithRetry(page, url, { waitUntil: "domcontentloaded", timeout: 30_000 }, config.retry);
+        for (const v of viewports) {
+            const size = resolveViewport(v);
+            await page.setViewportSize(size);
+            const name = typeof v === "string" ? v : `${size.width}x${size.height}`;
+            const path = join(config.outputDir, `${runId}-${name}.png`);
+            await page.screenshot({ path, fullPage: true });
+            shots.push({ viewport: name, width: size.width, height: size.height, path });
+        }
+    }
+    finally {
+        await teardownOpened(opened);
+    }
+    return shots;
+}
+//# sourceMappingURL=shots.js.map

package/dist/agent/shots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shots.js","sourceRoot":"","sources":["../../src/agent/shots.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAsB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWnD,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAsB,EACtB,GAAW,EACX,SAA0B;IAE1B,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,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,KAAK,GAAW,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACjG,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YAChC,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACxE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC;YAC5D,MAAM,IAAI,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/bin/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /**
- * fuse-browser CLI entry point (`probe` subcommand).
+ * fuse-browser CLI entry point. Subcommands: `probe`, `serp-batch`.
  * @module bin/cli
  */
 import { parseArgs } from "node:util";
-import { BrowserAgent } from "../agent/browser-agent.js";
-import { compactReport } from "../agent/compact.js";
-import { GuardrailViolation } from "../lib/errors.js";
+import { runProbeCli } from "./probe-cli.js";
+import { runSerpBatch } from "./serp-batch-cli.js";
+import { runShots } from "./shots-cli.js";
 const { positionals, values } = parseArgs({
     allowPositionals: true,
     options: {
@@ -21,6 +21,10 @@ const { positionals, values } = parseArgs({
         "extract-serp": { type: "boolean" },
         "serp-pages": { type: "string" },
         "rank-domain": { type: "string" },
+        viewports: { type: "string" },
+        hl: { type: "string" },
+        gl: { type: "string" },
+        "delay-ms": { type: "string" },
         "human-mode": { type: "boolean" },
         approved: { type: "boolean" },
         replay: { type: "boolean" },
@@ -35,56 +39,19 @@ const { positionals, values } = parseArgs({
         fill: { type: "string", multiple: true },
     },
 });
-const [command, url] = positionals;
-if (command !== "probe" || !url) {
-    process.stderr.write("usage: fuse-browser probe <url> [--click TEXT] [--fill TARGET=VALUE] [--country US] [--headed] ...\n");
-    process.exit(1);
+const [command, ...rest] = positionals;
+const opts = values;
+if (command === "serp-batch") {
+    await runSerpBatch(rest, opts);
 }
-const actions = [];
-for (const item of (values.fill ?? [])) {
-    const eq = item.indexOf("=");
-    if (eq < 0) {
-        process.stderr.write("--fill must be TARGET=VALUE\n");
-        process.exit(1);
-    }
-    actions.push({ type: "fill", target: item.slice(0, eq), value: item.slice(eq + 1) });
+else if (command === "shots" && rest[0]) {
+    await runShots(rest[0], opts);
 }
-for (const target of (values.click ?? []))
-    actions.push({ type: "click", target });
-const agent = new BrowserAgent({
-    engine: values.engine,
-    countryCode: values.country,
-    currency: values.currency,
-    headless: !values.headed,
-    humanMode: Boolean(values["human-mode"]),
-    outputDir: values["output-dir"],
-    storageStatePath: values["storage-state"],
-    proxyUrl: values.proxy,
-    proxyMapPath: values["proxy-map"],
-    userDataDir: values["user-data-dir"],
-    replayEnabled: Boolean(values.replay),
-    siteMemoryDir: values["site-memory-dir"],
-});
-try {
-    const report = await agent.probe(url, {
-        actions,
-        humanApproved: Boolean(values.approved),
-        autoConsent: Boolean(values["auto-consent"]),
-        extractPrices: Boolean(values["extract-prices"]),
-        detectChallenges: Boolean(values["detect-challenges"]),
-        observeVisual: Boolean(values["observe-visual"]),
-        extractSerp: Boolean(values["extract-serp"]),
-        serpPages: values["serp-pages"] ? Number(values["serp-pages"]) : undefined,
-        rankDomain: values["rank-domain"],
-        waitMs: values["wait-ms"] ? Number(values["wait-ms"]) : 0,
-    });
-    process.stdout.write(`${JSON.stringify(compactReport(report), null, 2)}\n`);
+else if (command === "probe" && rest[0]) {
+    await runProbeCli(rest[0], opts);
 }
-catch (err) {
-    if (err instanceof GuardrailViolation) {
-        process.stderr.write(`BLOCKED: ${err.message}\n`);
-        process.exit(2);
-    }
-    throw err;
+else {
+    process.stderr.write("usage: fuse-browser probe <url> [...] | serp-batch <query...> --rank-domain <d> | shots <url> --viewports mobile,desktop\n");
+    process.exit(1);
 }
 //# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/dist/bin/probe-cli.d.ts

@@ -0,0 +1,5 @@
+type Values = Record<string, unknown>;
+/** Run the `probe` subcommand against `url`. */
+export declare function runProbeCli(url: string, values: Values): Promise<void>;
+export {};
+//# sourceMappingURL=probe-cli.d.ts.map

package/dist/bin/probe-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-cli.d.ts","sourceRoot":"","sources":["../../src/bin/probe-cli.ts"],"names":[],"mappings":"AAUA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAiBtC,gDAAgD;AAChD,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC5E"}

package/dist/bin/probe-cli.js

@@ -0,0 +1,62 @@
+/**
+ * `probe` subcommand handler: run one probe and print the compact report.
+ * @module bin/probe-cli
+ */
+import { BrowserAgent } from "../agent/browser-agent.js";
+import { compactReport } from "../agent/compact.js";
+import { GuardrailViolation } from "../lib/errors.js";
+const str = (v) => (typeof v === "string" ? v : undefined);
+function buildActions(values) {
+    const actions = [];
+    for (const item of values.fill ?? []) {
+        const eq = item.indexOf("=");
+        if (eq < 0) {
+            process.stderr.write("--fill must be TARGET=VALUE\n");
+            process.exit(1);
+        }
+        actions.push({ type: "fill", target: item.slice(0, eq), value: item.slice(eq + 1) });
+    }
+    for (const target of values.click ?? [])
+        actions.push({ type: "click", target });
+    return actions;
+}
+/** Run the `probe` subcommand against `url`. */
+export async function runProbeCli(url, values) {
+    const agent = new BrowserAgent({
+        engine: str(values.engine),
+        countryCode: str(values.country),
+        currency: str(values.currency),
+        headless: !values.headed,
+        humanMode: Boolean(values["human-mode"]),
+        outputDir: str(values["output-dir"]),
+        storageStatePath: str(values["storage-state"]),
+        proxyUrl: str(values.proxy),
+        proxyMapPath: str(values["proxy-map"]),
+        userDataDir: str(values["user-data-dir"]),
+        replayEnabled: Boolean(values.replay),
+        siteMemoryDir: str(values["site-memory-dir"]),
+    });
+    try {
+        const report = await agent.probe(url, {
+            actions: buildActions(values),
+            humanApproved: Boolean(values.approved),
+            autoConsent: Boolean(values["auto-consent"]),
+            extractPrices: Boolean(values["extract-prices"]),
+            detectChallenges: Boolean(values["detect-challenges"]),
+            observeVisual: Boolean(values["observe-visual"]),
+            extractSerp: Boolean(values["extract-serp"]),
+            serpPages: values["serp-pages"] ? Number(values["serp-pages"]) : undefined,
+            rankDomain: str(values["rank-domain"]),
+            waitMs: values["wait-ms"] ? Number(values["wait-ms"]) : 0,
+        });
+        process.stdout.write(`${JSON.stringify(compactReport(report), null, 2)}\n`);
+    }
+    catch (err) {
+        if (err instanceof GuardrailViolation) {
+            process.stderr.write(`BLOCKED: ${err.message}\n`);
+            process.exit(2);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=probe-cli.js.map

package/dist/bin/probe-cli.js.map

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

package/dist/bin/serp-batch-cli.d.ts

@@ -0,0 +1,5 @@
+type Values = Record<string, unknown>;
+/** Run the `serp-batch` subcommand over `queries`. */
+export declare function runSerpBatch(queries: string[], values: Values): Promise<void>;
+export {};
+//# sourceMappingURL=serp-batch-cli.d.ts.map

package/dist/bin/serp-batch-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serp-batch-cli.d.ts","sourceRoot":"","sources":["../../src/bin/serp-batch-cli.ts"],"names":[],"mappings":"AAQA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAGtC,sDAAsD;AACtD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnF"}

package/dist/bin/serp-batch-cli.js

@@ -0,0 +1,31 @@
+/**
+ * `serp-batch` subcommand handler: run several Google searches, print JSON rows.
+ * @module bin/serp-batch-cli
+ */
+import { resolveConfig } from "../agent/config.js";
+import { serpBatch } from "../agent/serp-batch.js";
+const str = (v) => (typeof v === "string" ? v : undefined);
+/** Run the `serp-batch` subcommand over `queries`. */
+export async function runSerpBatch(queries, values) {
+    if (queries.length === 0) {
+        process.stderr.write("serp-batch needs at least one query\n");
+        process.exit(1);
+    }
+    const config = resolveConfig({
+        engine: str(values.engine),
+        countryCode: str(values.country),
+        headless: !values.headed,
+        outputDir: str(values["output-dir"]),
+        proxyUrl: str(values.proxy),
+    });
+    const rows = await serpBatch(config, {
+        queries,
+        rankDomain: str(values["rank-domain"]),
+        pages: values["serp-pages"] ? Number(values["serp-pages"]) : undefined,
+        hl: str(values.hl),
+        gl: str(values.gl),
+        delayMs: values["delay-ms"] ? Number(values["delay-ms"]) : undefined,
+    });
+    process.stdout.write(`${JSON.stringify(rows, null, 2)}\n`);
+}
+//# sourceMappingURL=serp-batch-cli.js.map

package/dist/bin/serp-batch-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serp-batch-cli.js","sourceRoot":"","sources":["../../src/bin/serp-batch-cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAInD,MAAM,GAAG,GAAG,CAAC,CAAU,EAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAExF,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAiB,EAAE,MAAc;IAClE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAA2B;QACpD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM;QACxB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE;QACnC,OAAO;QACP,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;QACtE,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;KACrE,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/bin/shots-cli.d.ts

@@ -0,0 +1,5 @@
+type Values = Record<string, unknown>;
+/** Run the `shots` subcommand against `url`. */
+export declare function runShots(url: string, values: Values): Promise<void>;
+export {};
+//# sourceMappingURL=shots-cli.d.ts.map

package/dist/bin/shots-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shots-cli.d.ts","sourceRoot":"","sources":["../../src/bin/shots-cli.ts"],"names":[],"mappings":"AASA,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAiBtC,gDAAgD;AAChD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE"}

package/dist/bin/shots-cli.js

@@ -0,0 +1,33 @@
+/**
+ * `shots` subcommand handler: responsive screenshots saved to disk.
+ * @module bin/shots-cli
+ */
+import { resolveConfig } from "../agent/config.js";
+import { captureShots } from "../agent/shots.js";
+const str = (v) => (typeof v === "string" ? v : undefined);
+const PRESETS = ["mobile", "tablet", "desktop"];
+/** Parse a `--viewports` CSV ("mobile,desktop,1280x720") into viewport inputs. */
+function parseViewports(csv) {
+    return (csv ?? "mobile,desktop")
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean)
+        .map((p) => {
+        if (PRESETS.includes(p))
+            return p;
+        const [w, h] = p.split("x").map(Number);
+        return Number.isFinite(w) && Number.isFinite(h) ? { width: w, height: h } : "desktop";
+    });
+}
+/** Run the `shots` subcommand against `url`. */
+export async function runShots(url, values) {
+    const config = resolveConfig({
+        engine: str(values.engine),
+        countryCode: str(values.country),
+        headless: !values.headed,
+        outputDir: str(values["output-dir"]),
+    });
+    const shots = await captureShots(config, url, parseViewports(str(values.viewports)));
+    process.stdout.write(`${JSON.stringify(shots, null, 2)}\n`);
+}
+//# sourceMappingURL=shots-cli.js.map

package/dist/bin/shots-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shots-cli.js","sourceRoot":"","sources":["../../src/bin/shots-cli.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,MAAM,GAAG,GAAG,CAAC,CAAU,EAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACxF,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAEhD,kFAAkF;AAClF,SAAS,cAAc,CAAC,GAAuB;IAC7C,OAAO,CAAC,GAAG,IAAI,gBAAgB,CAAC;SAC7B,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAiB,EAAE;QACxB,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,CAAkB,CAAC;QACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAW,EAAE,MAAM,EAAE,CAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,CAAC,CAAC,CAAC;AACP,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,MAAc;IACxD,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAA2B;QACpD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC;QAChC,QAAQ,EAAE,CAAC,MAAM,CAAC,MAAM;QACxB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;KACrC,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/engine/viewport.d.ts

@@ -0,0 +1,28 @@
+/** Named device viewport presets (CSS pixels). */
+export declare const VIEWPORT_PRESETS: {
+    readonly mobile: {
+        readonly width: 390;
+        readonly height: 844;
+    };
+    readonly tablet: {
+        readonly width: 768;
+        readonly height: 1024;
+    };
+    readonly desktop: {
+        readonly width: 1365;
+        readonly height: 900;
+    };
+};
+/** A viewport: a preset name or an explicit size. */
+export type ViewportInput = keyof typeof VIEWPORT_PRESETS | {
+    width: number;
+    height: number;
+};
+/** Resolve a viewport input to concrete width/height. */
+export declare function resolveViewport(input: ViewportInput): {
+    width: number;
+    height: number;
+};
+/** Human label for a viewport (preset name or `WxH`). */
+export declare function viewportLabel(input: ViewportInput): string;
+//# sourceMappingURL=viewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../src/engine/viewport.ts"],"names":[],"mappings":"AAMA,kDAAkD;AAClD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAInB,CAAC;AAEX,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAGvF;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAG1D"}

package/dist/engine/viewport.js

@@ -0,0 +1,23 @@
+/**
+ * Viewport presets and resolution for responsive screenshots.
+ * @module engine/viewport
+ */
+import { VIEWPORT } from "./context.js";
+/** Named device viewport presets (CSS pixels). */
+export const VIEWPORT_PRESETS = {
+    mobile: { width: 390, height: 844 },
+    tablet: { width: 768, height: 1024 },
+    desktop: { width: VIEWPORT.width, height: VIEWPORT.height },
+};
+/** Resolve a viewport input to concrete width/height. */
+export function resolveViewport(input) {
+    if (typeof input === "string")
+        return { ...VIEWPORT_PRESETS[input] };
+    return { width: input.width, height: input.height };
+}
+/** Human label for a viewport (preset name or `WxH`). */
+export function viewportLabel(input) {
+    const { width, height } = resolveViewport(input);
+    return `${typeof input === "string" ? input : "custom"} ${width}x${height}`;
+}
+//# sourceMappingURL=viewport.js.map

package/dist/engine/viewport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../../src/engine/viewport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,kDAAkD;AAClD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IACnC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IACpC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE;CACnD,CAAC;AAKX,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,KAAoB;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;IACrE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,KAAoB;IAChD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;AAC9E,CAAC"}

package/dist/server/result.d.ts

@@ -9,4 +9,9 @@ export declare function jsonResult(payload: Record<string, unknown>): CallToolRe
 export declare function errorResult(message: string): CallToolResult;
 /** Image result (PNG base64) with an optional text note. */
 export declare function imageResult(base64: string, note?: string): CallToolResult;
+/** Several images (PNG base64), each preceded by a label note. No structuredContent. */
+export declare function multiImageResult(items: Array<{
+    base64: string;
+    note: string;
+}>): CallToolResult;
 //# sourceMappingURL=result.d.ts.map

package/dist/server/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/server/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAK3E;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAE3D;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAIzE"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/server/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,qCAAqC;AACrC,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAK3E;AAED,uCAAuC;AACvC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAE3D;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAIzE;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,cAAc,CAM/F"}

package/dist/server/result.js

@@ -15,4 +15,12 @@ export function imageResult(base64, note) {
     const text = note ? [{ type: "text", text: note }] : [];
     return { content: [image, ...text] };
 }
+/** Several images (PNG base64), each preceded by a label note. No structuredContent. */
+export function multiImageResult(items) {
+    const content = items.flatMap((it) => [
+        { type: "text", text: it.note },
+        { type: "image", data: it.base64, mimeType: "image/png" },
+    ]);
+    return { content };
+}
 //# sourceMappingURL=result.js.map

package/dist/server/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/server/result.ts"],"names":[],"mappings":"AAMA,qCAAqC;AACrC,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnE,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAa;IACvD,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/server/result.ts"],"names":[],"mappings":"AAMA,qCAAqC;AACrC,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACnE,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,IAAa;IACvD,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AACvC,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,KAA8C;IAC7E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QACpC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QACxC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE;KACnE,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

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

@@ -1,6 +1,6 @@
 /**
  * Screenshot tool: returns a PNG as MCP image content. Optionally targets a
- * single element by its snapshot `ref` (focused vision, fewer image tokens).
+ * single element by `ref`, or captures across one/several viewports (responsive).
  * @module server/tools/screenshot
  */
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

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

@@ -1 +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"}
+{"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;AAIzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAS/D,qCAAqC;AACrC,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CA0CxF"}

package/dist/server/tools/screenshot.js

@@ -1,13 +1,24 @@
 import { z } from "zod";
 import { REF_ATTRIBUTE } from "../../extraction/snapshot.js";
-import { errorResult, imageResult } from "../result.js";
+import { resolveViewport, viewportLabel } from "../../engine/viewport.js";
+import { errorResult, imageResult, multiImageResult } from "../result.js";
 import { withSession } from "./with-session.js";
+const VIEWPORT_SCHEMA = z.union([
+    z.enum(["mobile", "tablet", "desktop"]),
+    z.object({ width: z.number().int(), height: z.number().int() }),
+]);
 /** 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() },
+        description: "Capture the live page as PNG(s) for vision. Pass `ref` for one element, `viewport` for one size, or `viewports` (e.g. [\"mobile\",\"desktop\"]) for a responsive set.",
+        inputSchema: {
+            sessionId: z.string(),
+            fullPage: z.boolean().optional(),
+            ref: z.number().int().optional(),
+            viewport: VIEWPORT_SCHEMA.optional(),
+            viewports: z.array(VIEWPORT_SCHEMA).optional(),
+        },
     }, async (args) => {
         const a = args;
         return withSession(sessions, String(a.sessionId), async (s) => {
@@ -18,8 +29,22 @@ export function registerScreenshotTool(server, sessions) {
                 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()}`);
+            const fullPage = Boolean(a.fullPage);
+            const list = (Array.isArray(a.viewports) ? a.viewports : a.viewport ? [a.viewport] : []);
+            if (list.length === 0) {
+                const buffer = await s.page.screenshot({ fullPage });
+                return imageResult(buffer.toString("base64"), `screenshot of ${s.page.url()}`);
+            }
+            const original = s.page.viewportSize();
+            const shots = [];
+            for (const v of list) {
+                await s.page.setViewportSize(resolveViewport(v));
+                const buf = await s.page.screenshot({ fullPage });
+                shots.push({ base64: buf.toString("base64"), note: viewportLabel(v) });
+            }
+            if (original)
+                await s.page.setViewportSize(original);
+            return multiImageResult(shots);
         });
     });
 }

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/browser-mcp",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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",