cdp-mcp 0.2.1 → 0.4.0

package/dist/tools/storage.js

@@ -1,296 +0,0 @@
-import { z } from "zod";
-import { readFile, writeFile, rename, rm } from "node:fs/promises";
-import { randomBytes } from "node:crypto";
-import { requireSession } from "../session/state.js";
-import { ToolError } from "../util/errors.js";
-import { registerJsonTool } from "./_register.js";
-/**
- * Session-portability tools (issue #12 items 4, 5).
- *
- * Cookies go through CDP `Network.*` (NOT `document.cookie`) so HttpOnly
- * auth/session cookies — the whole reason to resume a session — round-trip.
- * localStorage is read/written via `Runtime.evaluate` (the `Storage.*` domain
- * is out of scope per AGENTS.md). The on-disk shape is the de-facto Playwright
- * `storageState` JSON so a flow can be handed to/from mainstream tooling.
- *
- * v1 localStorage scope is the **current page origin** only: localStorage is
- * origin-partitioned and CDP can only read/write it for a document that is
- * actually on that origin. Cookies (the load-bearing part for auth resume) are
- * captured/restored for all origins. Multi-origin localStorage restore would
- * require navigating to each origin first; origins in the file that don't match
- * the current page are reported in `origins_skipped` rather than silently lost.
- *
- * File read/write mirrors `screenshot path=`: no extra path filter — the
- * operator gate is the same `--allow-remote`/non-loopback rule (README §SSE).
- */
-const SENSITIVE_NAME = /(sess|sid|token|auth|csrf|xsrf|jwt|secret|api[-_]?key)/i;
-const sameSiteSchema = z.enum(["Strict", "Lax", "None"]);
-const storageStateSchema = z.object({
-    cookies: z
-        .array(z.object({
-        name: z.string(),
-        value: z.string(),
-        domain: z.string(),
-        path: z.string(),
-        expires: z.number().optional(),
-        httpOnly: z.boolean().optional(),
-        secure: z.boolean().optional(),
-        sameSite: sameSiteSchema.optional(),
-    }))
-        .default([]),
-    origins: z
-        .array(z.object({
-        origin: z.string(),
-        localStorage: z.array(z.object({ name: z.string(), value: z.string() })).default([]),
-    }))
-        .default([]),
-});
-const cookieParamSchema = z.object({
-    name: z.string(),
-    value: z.string(),
-    url: z.string().optional().describe("Cookie URL (provide this OR domain)."),
-    domain: z.string().optional(),
-    path: z.string().optional(),
-    secure: z.boolean().optional(),
-    httpOnly: z.boolean().optional(),
-    sameSite: sameSiteSchema.optional(),
-    expires: z.number().optional().describe("Expiry as seconds since epoch; omit for a session cookie."),
-});
-/**
- * Write `data` to `dest` at mode 0o600, overwrite-safe and TOCTOU-safe.
- *
- * The storage-state file holds plaintext cookie secrets, so the 0o600
- * postcondition must hold even on a shared, world-writable directory. Two traps:
- *  - Node's writeFile `mode` only applies when it *creates* the file, so writing
- *    straight to `dest` would leave an existing 0644 file world-readable.
- *  - A *predictable* temp path lets an attacker pre-create (or symlink) it at
- *    0644, so the secret gets written through their file and renamed into place.
- *
- * So: create a temp with an **unpredictable** same-directory suffix using
- * exclusive create (`flag: "wx"` ⇒ O_CREAT|O_EXCL — fails on any pre-existing
- * file and refuses to follow a symlink), which makes 0o600 a real creation-time
- * guarantee, then atomically rename it over the destination (same filesystem, so
- * the secret never exists at the destination path in a half-written/0644 state).
- * Retry on the astronomically-unlikely name collision.
- */
-async function writeSecretFileAtomic(dest, data) {
-    let lastErr;
-    for (let attempt = 0; attempt < 5; attempt++) {
-        const tmp = `${dest}.${randomBytes(8).toString("hex")}.tmp`;
-        try {
-            await writeFile(tmp, data, { flag: "wx", mode: 0o600 });
-        }
-        catch (e) {
-            if (e.code === "EEXIST") {
-                lastErr = e;
-                continue; // collision (or planted file/symlink) — try a fresh random name
-            }
-            throw e; // ENOENT (missing parent dir), EACCES, etc.
-        }
-        try {
-            await rename(tmp, dest);
-        }
-        catch (e) {
-            await rm(tmp, { force: true }).catch(() => { });
-            throw e;
-        }
-        return;
-    }
-    throw lastErr;
-}
-export function registerStorageTools(server) {
-    registerJsonTool(server, "export_storage_state", "Save the browser session (all cookies including HttpOnly, plus the current page origin's localStorage) to a JSON file in the de-facto Playwright storageState shape, so a flow can be resumed in a fresh session or handed to other tooling. The file preserves full cookie values (it exists to resume auth) — treat it as a secret. File write is gated by the same operator rule as screenshot path= / --allow-remote.", { path: z.string().describe("Absolute path to write the storageState JSON to.") }, async (input) => {
-        const s = requireSession();
-        const { cookies } = (await s.client.send("Network.getAllCookies"));
-        const probe = await s.client.send("Runtime.evaluate", {
-            expression: READ_ORIGIN_AND_LOCALSTORAGE,
-            returnByValue: true,
-        });
-        const probed = (probe.result?.value ?? { origin: "null", localStorage: [] });
-        const origins = probed.origin && probed.origin !== "null"
-            ? [{ origin: probed.origin, localStorage: probed.localStorage }]
-            : [];
-        const state = { cookies: cookies.map(cdpCookieToState), origins };
-        // The file holds full cookie values (incl. HttpOnly auth/session tokens) —
-        // the description says "treat it as a secret". writeSecretFileAtomic writes
-        // it 0o600 and overwrite-safe (see the helper for the threat model).
-        try {
-            await writeSecretFileAtomic(input.path, JSON.stringify(state, null, 2));
-        }
-        catch (e) {
-            if (e.code === "ENOENT") {
-                throw new ToolError("not_found", `could not write storage-state file (does the parent directory exist?): ${e.message}`);
-            }
-            throw e; // EACCES/EISDIR/etc. surface as internal_error via registerJsonTool
-        }
-        return { saved: input.path, cookies: state.cookies.length, origins: origins.length };
-    });
-    registerJsonTool(server, "load_storage_state", "Restore a session from a Playwright-shaped storageState JSON file: sets all cookies (no navigation needed), then restores localStorage for the entries whose origin matches the current page. Cookies are added on top of the existing jar (additive, not a clean-context replace), so prefer a fresh session for Playwright-equivalent semantics. Origins that don't match the current page are returned in origins_skipped (restoring them would require navigating there first). File read is gated by the same operator rule as screenshot path= / --allow-remote.", { path: z.string().describe("Absolute path to a storageState JSON file (as written by export_storage_state).") }, async (input) => {
-        const s = requireSession();
-        let raw;
-        try {
-            raw = await readFile(input.path, "utf8");
-        }
-        catch (e) {
-            if (e.code === "ENOENT") {
-                throw new ToolError("not_found", `could not read storage-state file: ${e.message}`);
-            }
-            throw e; // EACCES/EISDIR/etc. surface as internal_error rather than masquerading as not_found
-        }
-        let parsed;
-        try {
-            parsed = JSON.parse(raw);
-        }
-        catch {
-            throw new ToolError("invalid_arg", "storage-state file is not valid JSON");
-        }
-        const result = storageStateSchema.safeParse(parsed);
-        if (!result.success) {
-            throw new ToolError("invalid_arg", `storage-state file is not a valid storageState: ${result.error.message}`);
-        }
-        const state = result.data;
-        if (state.cookies.length > 0) {
-            await s.client.send("Network.setCookies", { cookies: state.cookies.map(stateCookieToCdp) });
-        }
-        const restore = await s.client.send("Runtime.evaluate", {
-            expression: restoreLocalStorageExpr(state.origins),
-            returnByValue: true,
-        });
-        const restored = (restore.result?.value ?? { restored: [], skipped: state.origins.map((o) => o.origin) });
-        return {
-            loaded: input.path,
-            cookies: state.cookies.length,
-            origins_restored: restored.restored,
-            origins_skipped: restored.skipped,
-        };
-    });
-    registerJsonTool(server, "get_cookies", "List cookies (via CDP, so HttpOnly cookies are included) with their flags. For safe printing, the VALUE of likely session/auth cookies is redacted (httpOnly cookies, or names matching sess/sid/token/auth/csrf/jwt/secret/api-key); only value_length is shown for those. Full values are obtainable only through export_storage_state.", {
-        urls: z
-            .array(z.string())
-            .optional()
-            .describe("Restrict to cookies visible to these URLs; omit for all cookies in the browser."),
-    }, async (input) => {
-        const s = requireSession();
-        const res = (input.urls && input.urls.length > 0
-            ? await s.client.send("Network.getCookies", { urls: input.urls })
-            : await s.client.send("Network.getAllCookies"));
-        return { cookies: res.cookies.map(redactForDisplay) };
-    });
-    registerJsonTool(server, "set_cookies", "Set one or more cookies in the browser cookie jar via CDP. Each cookie needs a url OR a domain. For restoring a saved session, prefer load_storage_state; this is the lower-level primitive.", { cookies: z.array(cookieParamSchema).describe("Cookies to set.") }, async (input) => {
-        const s = requireSession();
-        if (input.cookies.length === 0)
-            throw new ToolError("missing_arg", "cookies array is empty");
-        const missing = input.cookies.find((c) => !c.url && !c.domain);
-        if (missing)
-            throw new ToolError("missing_arg", `cookie '${missing.name}' needs a url or domain`);
-        // Normalize the session-cookie sentinel the same way load_storage_state
-        // does, so an exported `expires: -1` piped in here isn't sent as a 1969 expiry.
-        await s.client.send("Network.setCookies", {
-            cookies: input.cookies.map(withSessionExpiryOmitted),
-        });
-        return { set: input.cookies.length };
-    });
-}
-function cdpCookieToState(c) {
-    return {
-        name: c.name,
-        value: c.value,
-        domain: c.domain,
-        path: c.path,
-        // CDP uses -1 (or a missing field) for session cookies; Playwright too.
-        expires: typeof c.expires === "number" ? c.expires : -1,
-        httpOnly: !!c.httpOnly,
-        secure: !!c.secure,
-        // Playwright requires sameSite; CDP may omit it. Lax is the browser default.
-        sameSite: c.sameSite ?? "Lax",
-    };
-}
-/**
- * CDP's `Network.setCookies` reads `expires` as an absolute epoch-seconds
- * timestamp, so the session-cookie sentinel (`-1`, which `export_storage_state`
- * writes) must be dropped rather than forwarded — otherwise the cookie is set
- * already-expired (1969) and silently rejected. Shared by `load_storage_state`
- * and `set_cookies` so both restore paths normalize identically.
- */
-function withSessionExpiryOmitted(cookie) {
-    if (typeof cookie.expires === "number" && cookie.expires >= 0)
-        return cookie;
-    const copy = { ...cookie };
-    delete copy.expires;
-    return copy;
-}
-function stateCookieToCdp(c) {
-    const param = {
-        name: c.name,
-        value: c.value,
-        domain: c.domain,
-        path: c.path,
-        secure: !!c.secure,
-        httpOnly: !!c.httpOnly,
-        expires: c.expires,
-    };
-    if (c.sameSite)
-        param.sameSite = c.sameSite;
-    // -1 / undefined means a session cookie — omit expires entirely.
-    return withSessionExpiryOmitted(param);
-}
-function redactForDisplay(c) {
-    const redacted = !!c.httpOnly || SENSITIVE_NAME.test(c.name);
-    const out = {
-        name: c.name,
-        domain: c.domain,
-        path: c.path,
-        expires: typeof c.expires === "number" ? c.expires : -1,
-        httpOnly: !!c.httpOnly,
-        secure: !!c.secure,
-        sameSite: c.sameSite ?? null,
-        redacted,
-        value_length: (c.value ?? "").length,
-    };
-    if (!redacted)
-        out.value = c.value;
-    return out;
-}
-// ---------------------------------------------------------------------------
-// In-page expressions
-/** Read the current origin and its localStorage as { origin, localStorage:[{name,value}] }. */
-const READ_ORIGIN_AND_LOCALSTORAGE = String.raw `(() => {
-  const items = [];
-  try {
-    for (let i = 0; i < localStorage.length; i++) {
-      const k = localStorage.key(i);
-      if (k === null) continue;
-      const v = localStorage.getItem(k);
-      if (v === null) continue;
-      items.push({ name: k, value: v });
-    }
-  } catch (e) {}
-  return { origin: location.origin, localStorage: items };
-})()`;
-/**
- * For each origin in the file whose origin matches the current page, write its
- * localStorage entries; report which origins were restored vs skipped.
- */
-function restoreLocalStorageExpr(origins) {
-    return String.raw `(() => {
-    const origins = ${JSON.stringify(origins)};
-    const current = location.origin;
-    const restored = [];
-    const skipped = [];
-    for (const o of origins) {
-      if (o.origin !== current) {
-        skipped.push(o.origin);
-        continue;
-      }
-      // If any setItem throws (quota exceeded, storage disabled), report the
-      // origin as skipped rather than misleadingly claiming it was restored.
-      let ok = true;
-      for (const it of o.localStorage) {
-        try { localStorage.setItem(it.name, it.value); } catch (e) { ok = false; }
-      }
-      (ok ? restored : skipped).push(o.origin);
-    }
-    return { restored, skipped };
-  })()`;
-}
-//# sourceMappingURL=storage.js.map

package/dist/tools/storage.js.map

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

package/dist/util/browser-resolve.d.ts

@@ -1,19 +0,0 @@
-export type BrowserChoice = "chromium" | "chrome";
-export interface ResolvedBrowser {
-    /** Absolute path to the Chrome/Chromium executable. */
-    binaryPath: string;
-    /** Which logical browser this binary represents. */
-    choice: BrowserChoice;
-    /** True when the binary is snap-confined (/snap/bin/* on Linux). Triggers
-     *  the user-data-dir workaround in launch_chrome. */
-    snapConfined: boolean;
-    /** Diagnostic — which resolution step produced this. */
-    source: "CDP_TEST_BROWSER_PATH" | "which-chromium" | "playwright-cache" | "chrome-launcher-default";
-}
-export declare function getBrowserChoice(): BrowserChoice;
-export declare function resolveBrowser(choice?: BrowserChoice): ResolvedBrowser;
-/** True when the given binary is the snap-marker returned by step 4. */
-export declare function isChromeLauncherDefault(b: ResolvedBrowser): boolean;
-/** Determine the user-data-dir for snap-confined Chromium. Snap confinement
- *  rejects /tmp/... paths; only ~/snap/<app>/current/ is writable. */
-export declare function snapUserDataDir(binaryPath: string): string;

package/dist/util/browser-resolve.js

@@ -1,263 +0,0 @@
-// Shared Chromium/Chrome resolver used by BOTH the L3 e2e suite
-// (test/e2e/setup/browser-path.ts re-exports from here) AND the L4 eval
-// harness (evals/harness/runner.ts imports resolveBrowser() and feeds
-// the result into the spawned MCP server via CHROME_PATH). Single
-// resolution path so both layers cannot test against different
-// protocol versions — the intent already documented in
-// docs/test-eval-plan.md §L3 *Production code change required for
-// chromePath* and §L3 *CI matrix* ("the same helper is reused by the
-// eval harness").
-//
-// Resolution order (fail-fast — never silently fall back to chrome-
-// launcher's auto-detection, because that's how the wrong browser ends
-// up running and tests pass against the wrong protocol revision):
-//   1. CDP_TEST_BROWSER_PATH env — explicit override, used by CI after
-//      `npx playwright install --with-deps chromium`. Wins everything.
-//   2. `which chromium` (Linux/macOS) / `where chromium.exe` (Windows) —
-//      local dev path. Catches both /snap/bin/chromium and the apt
-//      /usr/bin/chromium symlink.
-//   3. Playwright bundled cache — ~/.cache/ms-playwright/chromium-*/
-//      chrome-linux/chrome (Linux), ~/Library/Caches/ms-playwright/...
-//      (macOS), %LOCALAPPDATA%\ms-playwright\... (Windows). Handy after
-//      a fresh `npx playwright install`.
-//   4. CDP_TEST_BROWSER=chrome — chrome-launcher's default detection.
-//   5. Fail with an actionable install hint.
-import { execSync } from "node:child_process";
-import { existsSync, readdirSync, realpathSync, statSync } from "node:fs";
-import { homedir, platform } from "node:os";
-import { join } from "node:path";
-export function getBrowserChoice() {
-    const env = process.env.CDP_TEST_BROWSER?.toLowerCase();
-    if (env === "chrome")
-        return "chrome";
-    if (env === "chromium" || env === undefined || env === "")
-        return "chromium";
-    throw new Error(`CDP_TEST_BROWSER must be 'chromium' or 'chrome' (got '${env}'). Default is 'chromium'.`);
-}
-export function resolveBrowser(choice = getBrowserChoice()) {
-    // Step 1 — explicit override wins.
-    const override = process.env.CDP_TEST_BROWSER_PATH;
-    if (override) {
-        if (!existsSync(override)) {
-            throw new Error(`CDP_TEST_BROWSER_PATH='${override}' does not exist. Unset it or install the binary.`);
-        }
-        return {
-            binaryPath: override,
-            choice,
-            snapConfined: override.startsWith("/snap/"),
-            source: "CDP_TEST_BROWSER_PATH",
-        };
-    }
-    // Step 2 — system-installed chromium (Linux/macOS via `which`, Windows via
-    // `where`). Skip when choice is 'chrome' — Chrome detection is delegated to
-    // chrome-launcher's defaults in step 4.
-    //
-    // On darwin we additionally skip the deprecated Homebrew cask `chromium`
-    // wrapper at /opt/homebrew/bin/chromium (and any path whose realpath
-    // resolves into /opt/homebrew/Caskroom/chromium/). That wrapper points
-    // at an unsigned .app Gatekeeper rejects as "damaged" — it launches
-    // successfully but the debug port never opens, so chrome-launcher's
-    // startup-port poll ECONNREFUSEs. The same gap is precisely what the
-    // §macOS arm64 entry in docs/known-chromium-gaps.md documents; skipping
-    // it here is what makes that entry's "resolveBrowser picks it up
-    // automatically" claim actually true for users who tried the cask first
-    // before reading the doc. Cask deprecation removal is scheduled
-    // 2026-09-01; once removed this skip becomes a no-op.
-    if (choice === "chromium") {
-        const sys = findOnPath("chromium") ?? findOnPath("chromium-browser");
-        if (sys && !isBrewCaskChromium(sys)) {
-            return {
-                binaryPath: sys,
-                choice,
-                snapConfined: sys.startsWith("/snap/"),
-                source: "which-chromium",
-            };
-        }
-    }
-    // Step 3 — Playwright's bundled cache. Used in CI after
-    // `npx playwright install`; also useful locally when the system chromium
-    // isn't installed.
-    const pw = findPlaywrightChromium();
-    if (pw && choice === "chromium") {
-        return {
-            binaryPath: pw,
-            choice,
-            snapConfined: false,
-            source: "playwright-cache",
-        };
-    }
-    // Step 4 — Chrome stable, only when explicitly requested. We don't return a
-    // path here; the caller forwards `undefined` to chrome-launcher, which runs
-    // its own detection. This is intentionally NOT used as a silent fallback
-    // for chromium because the protocol revision can diverge.
-    if (choice === "chrome") {
-        // chrome-launcher uses its own which() — we just signal it should take
-        // over by returning the marker path "chrome-launcher-default". Both
-        // callers strip this back to undefined before forwarding the path: L3
-        // global setup at test/e2e/setup/global.ts skips `chromePath` entirely,
-        // and the L4 runner at evals/harness/runner.ts omits CHROME_PATH from
-        // the subprocess env via isChromeLauncherDefault().
-        return {
-            binaryPath: "chrome-launcher-default",
-            choice,
-            snapConfined: false,
-            source: "chrome-launcher-default",
-        };
-    }
-    // Step 5 — actionable failure.
-    const isArm = process.arch === "arm64";
-    const installHint = isArm
-        ? "sudo apt-get install chromium-browser  # OR: npx playwright install chromium"
-        : "sudo snap install chromium  OR  sudo apt-get install chromium-browser  OR  npx playwright install chromium";
-    throw new Error(`Could not resolve a Chromium binary for the e2e suite.\n` +
-        `Tried (in order): CDP_TEST_BROWSER_PATH env, which chromium, Playwright cache.\n` +
-        `Install Chromium (${installHint}) or set CDP_TEST_BROWSER_PATH explicitly.`);
-}
-// Detect the deprecated Homebrew cask `chromium` wrapper on darwin. Returns
-// true for both the well-known /opt/homebrew/bin/chromium path and any path
-// whose realpath resolves into /opt/homebrew/Caskroom/chromium/ (covers
-// future brew layout shifts where the wrapper lives elsewhere but the
-// Caskroom prefix stays put). Never true off darwin.
-function isBrewCaskChromium(binaryPath) {
-    if (platform() !== "darwin")
-        return false;
-    if (binaryPath === "/opt/homebrew/bin/chromium")
-        return true;
-    try {
-        const resolved = realpathSync(binaryPath);
-        return resolved.startsWith("/opt/homebrew/Caskroom/chromium/");
-    }
-    catch {
-        return false;
-    }
-}
-function findOnPath(cmd) {
-    try {
-        const which = platform() === "win32" ? "where" : "which";
-        const out = execSync(`${which} ${cmd}`, { stdio: ["ignore", "pipe", "ignore"] })
-            .toString()
-            .split(/\r?\n/)
-            .find((line) => line.trim().length > 0);
-        if (!out)
-            return null;
-        const path = out.trim();
-        return existsSync(path) ? path : null;
-    }
-    catch {
-        return null;
-    }
-}
-function findPlaywrightChromium() {
-    const candidates = playwrightCacheDirs();
-    for (const dir of candidates) {
-        if (!existsSync(dir))
-            continue;
-        let entries;
-        try {
-            entries = readdirSync(dir);
-        }
-        catch {
-            continue;
-        }
-        // Filter to chromium-* / chromium-headless-shell-* — pick the highest-
-        // numbered revision (newest install).
-        const chromiums = entries
-            .filter((e) => e.startsWith("chromium-") && !e.startsWith("chromium-headless-shell-"))
-            .map((e) => ({ name: e, full: join(dir, e) }))
-            .filter((e) => {
-            try {
-                return statSync(e.full).isDirectory();
-            }
-            catch {
-                return false;
-            }
-        })
-            .sort((a, b) => b.name.localeCompare(a.name));
-        for (const c of chromiums) {
-            const exe = pickPlaywrightExe(c.full);
-            if (exe)
-                return exe;
-        }
-    }
-    return null;
-}
-function playwrightCacheDirs() {
-    const home = homedir();
-    const plat = platform();
-    if (plat === "linux")
-        return [join(home, ".cache", "ms-playwright")];
-    if (plat === "darwin")
-        return [join(home, "Library", "Caches", "ms-playwright")];
-    if (plat === "win32") {
-        const local = process.env.LOCALAPPDATA ?? join(home, "AppData", "Local");
-        return [join(local, "ms-playwright")];
-    }
-    return [join(home, ".cache", "ms-playwright")];
-}
-function pickPlaywrightExe(chromiumDir) {
-    // Layout, per Playwright's install layout:
-    //   Linux:   chromium-<rev>/chrome-linux/chrome
-    //   macOS:   chromium-<rev>/chrome-mac/Chromium.app/Contents/MacOS/Chromium
-    //   Windows: chromium-<rev>/chrome-win/chrome.exe
-    const plat = platform();
-    // Playwright's layout varies by version/arch (Chrome-for-Testing renamed
-    // some folders ~Playwright 1.40+):
-    //   Linux x86_64:  chromium-<rev>/chrome-linux/chrome     (older)
-    //                  chromium-<rev>/chrome-linux64/chrome   (CfT, newer)
-    //   Linux ARM64:   chromium-<rev>/chrome-linux/chrome     (ARM64 unchanged)
-    //                  chromium-<rev>/chrome-linux-arm64/chrome (rare variant)
-    //   macOS x86_64:  chromium-<rev>/chrome-mac/Chromium.app/...                       (older)
-    //                  chromium-<rev>/chrome-mac-x64/Google Chrome for Testing.app/...  (CfT, newer)
-    //   macOS arm64:   chromium-<rev>/chrome-mac-arm/Chromium.app/...                   (older)
-    //                  chromium-<rev>/chrome-mac-arm64/Google Chrome for Testing.app/...(CfT, newer)
-    //   Windows:       chromium-<rev>/chrome-win/chrome.exe   (older)
-    //                  chromium-<rev>/chrome-win64/chrome.exe (newer)
-    // Codex blocker review on PR #11 flagged the missing chrome-linux64
-    // candidate — modern Playwright on ubuntu-latest landed in CfT layout
-    // and the resolver step exited 1 before the test runner started.
-    // The mac-arm64 CfT candidates were added while validating
-    // set_breakpoint idempotency on darwin-arm64, where Playwright
-    // v1223+ installs to chrome-mac-arm64/Google Chrome
-    // for Testing.app/Contents/MacOS/Google Chrome for Testing.
-    const candidates = plat === "win32"
-        ? [
-            join(chromiumDir, "chrome-win64", "chrome.exe"),
-            join(chromiumDir, "chrome-win", "chrome.exe"),
-        ]
-        : plat === "darwin"
-            ? [
-                // CfT-renamed layouts first (Playwright 1.40+ / chromium revisions
-                // ~v1200+). `existsSync` makes the order forgiving — try newer
-                // first so we don't accidentally pick an older sibling layout
-                // when both happen to be present.
-                join(chromiumDir, "chrome-mac-arm64", "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing"),
-                join(chromiumDir, "chrome-mac-x64", "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing"),
-                // Older Chromium.app-branded layouts.
-                join(chromiumDir, "chrome-mac", "Chromium.app", "Contents", "MacOS", "Chromium"),
-                join(chromiumDir, "chrome-mac-arm", "Chromium.app", "Contents", "MacOS", "Chromium"),
-            ]
-            : [
-                join(chromiumDir, "chrome-linux", "chrome"),
-                join(chromiumDir, "chrome-linux64", "chrome"),
-                join(chromiumDir, "chrome-linux-arm64", "chrome"),
-            ];
-    for (const c of candidates) {
-        if (existsSync(c))
-            return c;
-    }
-    return null;
-}
-/** True when the given binary is the snap-marker returned by step 4. */
-export function isChromeLauncherDefault(b) {
-    return b.source === "chrome-launcher-default";
-}
-/** Determine the user-data-dir for snap-confined Chromium. Snap confinement
- *  rejects /tmp/... paths; only ~/snap/<app>/current/ is writable. */
-export function snapUserDataDir(binaryPath) {
-    // Parse the snap app name out of the binary path. /snap/bin/chromium ->
-    // 'chromium'; /snap/firefox/current/firefox -> 'firefox'.
-    const match = binaryPath.match(/\/snap\/(?:bin\/)?([^/]+)/);
-    const app = match?.[1] ?? "chromium";
-    return join(homedir(), "snap", app, "current", "cdp-mcp-test-profile");
-}
-//# sourceMappingURL=browser-resolve.js.map

package/dist/util/browser-resolve.js.map

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

package/dist/util/errors.d.ts

@@ -1,7 +0,0 @@
-export declare class ToolError extends Error {
-    code: string;
-    constructor(code: string, message: string);
-}
-export declare const noSession: () => ToolError;
-export declare const notPaused: () => ToolError;
-export declare const alreadySession: () => ToolError;

package/dist/util/errors.js

@@ -1,12 +0,0 @@
-export class ToolError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.code = code;
-        this.name = "ToolError";
-    }
-}
-export const noSession = () => new ToolError("no_session", "No browser session. Call launch_chrome or attach_chrome first.");
-export const notPaused = () => new ToolError("not_paused", "Operation requires the debugger to be paused. Set a breakpoint and call wait_for_pause.");
-export const alreadySession = () => new ToolError("already_session", "A session is already active. Call close_session before opening a new one.");
-//# sourceMappingURL=errors.js.map

package/dist/util/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACf;IAAnB,YAAmB,IAAY,EAAE,OAAe;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,SAAI,GAAJ,IAAI,CAAQ;QAE7B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,IAAI,SAAS,CACX,YAAY,EACZ,gEAAgE,CACjE,CAAC;AAEJ,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAC5B,IAAI,SAAS,CACX,YAAY,EACZ,yFAAyF,CAC1F,CAAC;AAEJ,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CACjC,IAAI,SAAS,CACX,iBAAiB,EACjB,2EAA2E,CAC5E,CAAC"}