cdp-mcp 0.2.1 → 0.4.0

package/dist/locator.js

@@ -1,176 +0,0 @@
-/**
- * Canonical `LocatorSpec` contract for cdp-mcp.
- *
- * This module is the single source of truth for the structured element-locator
- * shape that `locate`, `wait_for`, and the form-driving tools accept. It is
- * deliberately **side-effect free** and depends only on `zod`, so external
- * consumers can import it (via `cdp-mcp/contract`) to produce and validate specs
- * without pulling in the CLI/server. Tool code re-imports these symbols rather
- * than redefining them, so the published contract can never silently drift from
- * what the tools actually accept.
- */
-import { z } from "zod";
-/**
- * Error thrown by {@link normalizeLocator} / {@link parseLocator} for an invalid
- * spec. `code` mirrors the cdp-mcp tool error codes so tool handlers can re-wrap it
- * structurally: `"missing_arg"` when a spec is under-specified for its strategy,
- * `"invalid_locator"` for an unsupported strategy.
- */
-export class LocatorError extends Error {
-    code;
-    constructor(message, code = "missing_arg") {
-        super(message);
-        this.name = "LocatorError";
-        this.code = code;
-    }
-}
-/** The locator strategies cdp-mcp understands. `css` is the default when a selector is given. */
-export const locatorBySchema = z.enum([
-    "css",
-    "text",
-    "role",
-    "test_id",
-    "testId",
-    "label",
-    "placeholder",
-    "name",
-]);
-/**
- * The raw Zod shape for a LocatorSpec. Spread into tool input schemas
- * (`{ ...locatorShape, ... }`) so the field docs stay identical everywhere.
- */
-export const locatorShape = {
-    by: locatorBySchema.optional().describe("Locator strategy. Omit when passing selector/css for a CSS lookup."),
-    selector: z.string().optional().describe("CSS selector. Equivalent to by=css."),
-    css: z.string().optional().describe("CSS selector. Equivalent to selector."),
-    text: z.string().optional().describe("Text to match for by=text."),
-    role: z.string().optional().describe("ARIA/implicit role for by=role, e.g. button, link, textbox."),
-    name: z.string().optional().describe("Accessible name, field name, or fallback value depending on the locator strategy."),
-    test_id: z.string().optional().describe("Value for data-testid, data-test-id, or data-test."),
-    // Both snake_case (`test_id`) and camelCase (`testId`) are accepted so callers
-    // can use whichever matches their convention; `normalizeLocator` /
-    // `serializeLocator` fold them to the canonical `test_id`. Likewise `name` is a
-    // cross-strategy fallback that gets folded into the strategy-specific field.
-    testId: z.string().optional().describe("CamelCase alias for test_id."),
-    label: z.string().optional().describe("Label text for by=label."),
-    placeholder: z.string().optional().describe("Placeholder text for by=placeholder."),
-    exact: z.boolean().optional().describe("Default false: substring match for text/name-like fields."),
-};
-/** A standalone `ZodObject` for a LocatorSpec — external consumers can `.parse()`/`.safeParse()`. */
-export const locatorSchema = z.object(locatorShape);
-/**
- * Validate and canonicalize a spec: infer `by` from selector/css, enforce the
- * required field for the chosen strategy, and fold the `name` fallback into the
- * strategy-specific field. Throws {@link LocatorError} on an under-specified spec.
- */
-export function normalizeLocator(input) {
-    const by = input.by ?? (input.selector || input.css ? "css" : undefined);
-    if (!by)
-        throw new LocatorError("by is required unless selector/css is supplied");
-    switch (by) {
-        case "css": {
-            const selector = input.selector ?? input.css;
-            if (!selector)
-                throw new LocatorError("selector or css is required for by=css");
-            return { ...input, by, selector };
-        }
-        case "role":
-            if (!input.role)
-                throw new LocatorError("role is required for by=role");
-            return { ...input, by };
-        case "text":
-            if (!input.text && !input.name)
-                throw new LocatorError("text or name is required for by=text");
-            return { ...input, by, text: input.text ?? input.name };
-        case "test_id":
-        case "testId": {
-            const testId = input.test_id ?? input.testId ?? input.name;
-            if (!testId)
-                throw new LocatorError(`test_id, testId, or name is required for by=${by}`);
-            return { ...input, by, test_id: testId };
-        }
-        case "label": {
-            const label = input.label ?? input.name;
-            if (!label)
-                throw new LocatorError("label or name is required for by=label");
-            return { ...input, by, label };
-        }
-        case "placeholder": {
-            const placeholder = input.placeholder ?? input.name;
-            if (!placeholder)
-                throw new LocatorError("placeholder or name is required for by=placeholder");
-            return { ...input, by, placeholder };
-        }
-        case "name":
-            if (!input.name)
-                throw new LocatorError("name is required for by=name");
-            return { ...input, by };
-        default: {
-            // Compile-time exhaustiveness: if `locatorBySchema` gains a strategy and a
-            // case here is missed, `by` is no longer `never` and this fails to build
-            // (pairs with `noFallthroughCasesInSwitch`).
-            const _exhaustive = by;
-            throw new LocatorError(`unsupported locator strategy: ${String(_exhaustive)}`, "invalid_locator");
-        }
-    }
-}
-/** Validate an unknown value as a LocatorSpec (shape + strategy requirements). */
-export function parseLocator(input) {
-    return normalizeLocator(locatorSchema.parse(input));
-}
-/**
- * Serialize a LocatorSpec to a stable, normalized JSON string. Equivalent specs
- * serialize identically regardless of which alias the caller used — e.g.
- * `{ css: ".x" }` and `{ selector: ".x" }` both yield `{"by":"css","selector":".x"}`
- * — so the output is safe to use as a cache key or for equality checks.
- */
-export function serializeLocator(spec) {
-    return JSON.stringify(canonicalLocator(spec));
-}
-/**
- * Reduce a spec to only its canonical fields, in a fixed key order, dropping
- * alias inputs (`css`, `testId`, and the cross-strategy `name` fallback). This is
- * what makes {@link serializeLocator} stable across equivalent inputs — the raw
- * `normalizeLocator` result still carries whichever aliases the caller passed.
- */
-function canonicalLocator(spec) {
-    const n = normalizeLocator(spec);
-    const out = {};
-    switch (n.by) {
-        case "css":
-            out.by = "css";
-            out.selector = n.selector;
-            break;
-        case "role":
-            out.by = "role";
-            out.role = n.role;
-            if (n.name !== undefined)
-                out.name = n.name;
-            break;
-        case "text":
-            out.by = "text";
-            out.text = n.text;
-            break;
-        case "test_id":
-        case "testId":
-            out.by = "test_id";
-            out.test_id = n.test_id;
-            break;
-        case "label":
-            out.by = "label";
-            out.label = n.label;
-            break;
-        case "placeholder":
-            out.by = "placeholder";
-            out.placeholder = n.placeholder;
-            break;
-        case "name":
-            out.by = "name";
-            out.name = n.name;
-            break;
-    }
-    if (n.exact !== undefined)
-        out.exact = n.exact;
-    return out;
-}
-//# sourceMappingURL=locator.js.map

package/dist/locator.js.map

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

package/dist/server.d.ts

@@ -1,2 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export declare function buildServer(): McpServer;

package/dist/server.js

@@ -1,41 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { registerSessionTools } from "./tools/session.js";
-import { registerNavTools } from "./tools/nav.js";
-import { registerSourceTools } from "./tools/source.js";
-import { registerBreakpointTools } from "./tools/breakpoints.js";
-import { registerExecutionTools } from "./tools/execution.js";
-import { registerInspectTools } from "./tools/inspect.js";
-import { registerConsoleTools } from "./tools/console.js";
-import { registerNetworkTools } from "./tools/network.js";
-import { registerDomTools } from "./tools/dom.js";
-import { registerFormTools } from "./tools/forms.js";
-import { registerStorageTools } from "./tools/storage.js";
-export function buildServer() {
-    const server = new McpServer({
-        name: "cdp-mcp",
-        version: "0.1.2",
-    });
-    registerSessionTools(server);
-    registerNavTools(server);
-    registerSourceTools(server);
-    registerBreakpointTools(server);
-    registerExecutionTools(server);
-    registerInspectTools(server);
-    registerConsoleTools(server);
-    registerNetworkTools(server);
-    registerDomTools(server);
-    registerFormTools(server);
-    registerStorageTools(server);
-    // The SDK advertises `tools: { listChanged: true }` as soon as any tool is
-    // registered, but never emits the matching notification on its own. Some
-    // clients (e.g. GitHub Copilot CLI over SSE) gate their first `tools/list`
-    // call on receiving a `notifications/tools/list_changed` and otherwise wait
-    // forever — registering zero tools. Emit it once, right after the client's
-    // `initialized` (so the transport is connected and the client is ready).
-    // Harmless for clients that already fetch eagerly. See issue #1.
-    server.server.oninitialized = () => {
-        server.sendToolListChanged();
-    };
-    return server;
-}
-//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,4EAA4E;IAC5E,2EAA2E;IAC3E,yEAAyE;IACzE,iEAAiE;IACjE,MAAM,CAAC,MAAM,CAAC,aAAa,GAAG,GAAG,EAAE;QACjC,MAAM,CAAC,mBAAmB,EAAE,CAAC;IAC/B,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/session/browser.d.ts

@@ -1,29 +0,0 @@
-export interface LaunchArgs {
-    url?: string;
-    headless?: boolean;
-    userDataDir?: string;
-    args?: string[];
-    chromePath?: string;
-    sandbox?: boolean;
-}
-export interface AttachArgs {
-    port?: number;
-    host?: string;
-    targetFilter?: {
-        type?: string;
-        urlIncludes?: string;
-    };
-}
-export declare function launchChrome(opts?: LaunchArgs): Promise<{
-    targetId: string;
-    url: string;
-}>;
-export declare function attachChrome(opts?: AttachArgs): Promise<{
-    targetId: string;
-    url: string;
-}>;
-export declare function closeSession(): Promise<void>;
-export declare function switchTarget(targetId: string): Promise<{
-    targetId: string;
-    url: string;
-}>;

package/dist/session/browser.js

@@ -1,409 +0,0 @@
-import { mkdirSync } from "node:fs";
-import CDP from "chrome-remote-interface";
-import { launch } from "chrome-launcher";
-import { sessionState, ROOT_SESSION_KEY } from "./state.js";
-import { attachScriptListener } from "../sourcemap/loader.js";
-import { mapCdpToOriginal } from "../sourcemap/store.js";
-import { alreadySession } from "../util/errors.js";
-import { previewRemoteObject } from "../util/format.js";
-import { log } from "../util/log.js";
-import { snapUserDataDir } from "../util/browser-resolve.js";
-const DEFAULT_PORT = 9222;
-export async function launchChrome(opts = {}) {
-    if (sessionState.client)
-        throw alreadySession();
-    // chrome-launcher manages --remote-debugging-port itself: it picks an
-    // unused port, adds the flag, and polls it. Passing our own
-    // --remote-debugging-port=0 in chromeFlags appears AFTER chrome-launcher's,
-    // and since Chrome honors the last occurrence, Chrome picks an ephemeral
-    // port written to DevToolsActivePort while chrome-launcher polls its own
-    // (stale) port → ECONNREFUSED on every connect. Don't pass it; let
-    // chrome-launcher own port selection. `runningChrome.port` then reflects
-    // the actual port Chrome is listening on. (Codex blocker review on PR #11.)
-    // Sandbox decision: an explicit `sandbox` arg from the caller always wins.
-    // When the caller omits it, fall back to the CDP_SANDBOX env (default off);
-    // "true" or "1" enable it (matching the eval runner's EVAL_SANDBOX parsing).
-    // This lets a host with a working sandbox path opt a whole run into
-    // sandbox-on (e.g. the L4 eval runner via EVAL_SANDBOX → CDP_SANDBOX)
-    // without prompt-injecting every launch_chrome call. Unset env → false →
-    // the --no-sandbox automation default (unchanged). Explicit `sandbox: false`
-    // still forces --no-sandbox even if the env is set.
-    const sandboxEnv = process.env.CDP_SANDBOX;
-    const useSandbox = opts.sandbox ?? (sandboxEnv === "true" || sandboxEnv === "1");
-    const userArgs = opts.args ?? [];
-    const userAlreadyDisabled = userArgs.includes("--no-sandbox");
-    // A caller can request the sandbox AND still pass --no-sandbox in args; the
-    // userArgs spread re-adds it last, so Chromium ends up unsandboxed despite the
-    // request. Warn rather than silently dropping the sandbox.
-    if (useSandbox && userAlreadyDisabled) {
-        log.warn("launch_chrome: sandbox requested but --no-sandbox is in args; the flag wins and the sandbox stays OFF");
-    }
-    // Snap-confinement auto-profile. When the effective Chrome path (explicit
-    // chromePath, or CHROME_PATH env that chrome-launcher will pick up) is
-    // under /snap/ AND the caller didn't already specify userDataDir, derive
-    // the snap-confined profile path so chrome-launcher doesn't hand snap-
-    // Chromium a /tmp/... profile that snap confinement rejects (debug port
-    // never opens; chrome-launcher's startup-port poll ECONNREFUSEs). Mirrors
-    // the L3 globalSetup logic in test/e2e/setup/global.ts so the L4 eval
-    // harness (which steers chrome-launcher via CHROME_PATH) and direct
-    // launch_chrome callers inherit the same workaround without making the
-    // agent responsible for it. (Codex review on PR #24.)
-    const effectiveChromePath = opts.chromePath ?? process.env.CHROME_PATH;
-    const autoUserDataDir = !opts.userDataDir && effectiveChromePath?.startsWith("/snap/")
-        ? snapUserDataDir(effectiveChromePath)
-        : undefined;
-    if (autoUserDataDir) {
-        mkdirSync(autoUserDataDir, { recursive: true });
-    }
-    const launchOpts = {
-        startingUrl: opts.url ?? "about:blank",
-        chromeFlags: [
-            ...(opts.headless ? ["--headless=new"] : []),
-            ...(!useSandbox && !userAlreadyDisabled ? ["--no-sandbox"] : []),
-            ...userArgs,
-        ],
-        ...(opts.userDataDir
-            ? { userDataDir: opts.userDataDir }
-            : autoUserDataDir
-                ? { userDataDir: autoUserDataDir }
-                : {}),
-        ...(opts.chromePath ? { chromePath: opts.chromePath } : {}),
-    };
-    const chrome = await launch(launchOpts);
-    sessionState.chrome = chrome;
-    sessionState.chromePort = chrome.port;
-    log.info("launched chrome", { port: chrome.port, pid: chrome.pid, sandbox: useSandbox });
-    // Pick the first page target.
-    const targets = await waitForFirstPage(chrome.port);
-    const target = targets[0];
-    await connectToTarget(chrome.port, target.id);
-    return { targetId: target.id, url: target.url };
-}
-export async function attachChrome(opts = {}) {
-    if (sessionState.client)
-        throw alreadySession();
-    const port = opts.port ?? DEFAULT_PORT;
-    sessionState.chromePort = port;
-    sessionState.attached = true;
-    const targets = await CDP.List({ port, host: opts.host });
-    const wantType = opts.targetFilter?.type;
-    const wantUrl = opts.targetFilter?.urlIncludes;
-    const filtered = targets.filter((t) => {
-        // When a type filter is supplied, it is authoritative. Otherwise default
-        // to "page" targets (the common debugging case).
-        if (wantType) {
-            if (t.type !== wantType)
-                return false;
-        }
-        else if (t.type !== "page") {
-            return false;
-        }
-        if (wantUrl && !t.url.includes(wantUrl))
-            return false;
-        return true;
-    });
-    if (filtered.length === 0) {
-        throw new Error(`No matching targets on the running Chrome (filter type=${wantType ?? "page"}, urlIncludes=${wantUrl ?? "*"})`);
-    }
-    const target = filtered[0];
-    await connectToTarget(port, target.id, opts.host);
-    log.info("attached to chrome", { port, targetId: target.id, url: target.url });
-    return { targetId: target.id, url: target.url };
-}
-async function waitForFirstPage(port) {
-    const deadline = Date.now() + 5000;
-    while (Date.now() < deadline) {
-        try {
-            const list = await CDP.List({ port });
-            const pages = list.filter((t) => t.type === "page");
-            if (pages.length > 0)
-                return pages;
-        }
-        catch {
-            // Chrome may not be ready yet
-        }
-        await new Promise((r) => setTimeout(r, 100));
-    }
-    throw new Error("Chrome did not expose any page targets within 5s");
-}
-async function connectToTarget(port, targetId, host) {
-    const client = await CDP({ port, host, target: targetId });
-    sessionState.client = client;
-    sessionState.currentTargetId = targetId;
-    // Wire root-target handlers and Target.attachedToTarget BEFORE setAutoAttach
-    // — Chrome immediately enumerates pre-existing eligible children (workers,
-    // OOPIFs, service workers) inline with the setAutoAttach response. If the
-    // listener is registered after, those attachedToTarget events are dropped.
-    wireDomainHandlers(client, undefined);
-    const onAttached = (params) => {
-        void onChildAttached(client, params);
-    };
-    const onDetached = (params) => {
-        detachSession(client, params.sessionId);
-    };
-    client.on("Target.attachedToTarget", onAttached);
-    client.on("Target.detachedFromTarget", onDetached);
-    client.on("disconnect", () => log.warn("CDP disconnect"));
-    await enableDomains(client, undefined);
-    try {
-        await client.Target.setAutoAttach({
-            autoAttach: true,
-            waitForDebuggerOnStart: false,
-            flatten: true,
-        });
-    }
-    catch (e) {
-        log.warn("Target.setAutoAttach failed", { error: String(e) });
-    }
-}
-async function onChildAttached(client, params) {
-    const sessionId = params.sessionId;
-    log.debug("child target attached", { sessionId, type: params.targetInfo.type, url: params.targetInfo.url });
-    try {
-        wireDomainHandlers(client, sessionId);
-        await enableDomains(client, sessionId);
-        await client.Target.setAutoAttach({ autoAttach: true, waitForDebuggerOnStart: false, flatten: true }, sessionId);
-        // Inherit pause-on-exceptions setting so child sessions honor it from
-        // birth, not only if the user re-issues the tool after they attach.
-        if (sessionState.pauseOnExceptions !== "none") {
-            try {
-                await client.Debugger.setPauseOnExceptions({ state: sessionState.pauseOnExceptions }, sessionId);
-            }
-            catch (e) {
-                log.warn("failed to apply pauseOnExceptions to child", { sessionId, error: String(e) });
-            }
-        }
-    }
-    catch (e) {
-        log.warn("failed to enable child target", { sessionId, error: String(e) });
-    }
-}
-function detachSession(client, sessionId) {
-    log.debug("child target detached", { sessionId });
-    // Remove every event handler we registered for this sub-session and drop
-    // its scripts from the store — those scriptIds are now invalid.
-    const handlers = sessionState.sessionHandlers.get(sessionId);
-    if (handlers) {
-        for (const { event, handler } of handlers) {
-            client.removeListener(event, handler);
-        }
-        sessionState.sessionHandlers.delete(sessionId);
-    }
-    // Drop scripts owned by this session so stale scriptIds don't survive.
-    for (const sc of sessionState.scripts.all()) {
-        if (sc.sessionId === sessionId)
-            sessionState.scripts.remove(sc.scriptId, sc.sessionId);
-    }
-}
-async function enableDomains(client, sessionId) {
-    // The full debugger surface needs these. Some are no-ops on workers but harmless.
-    const swallow = (p) => p.then(() => { }, () => { });
-    await swallow(client.Runtime.enable(sessionId));
-    await swallow(client.Debugger.enable({}, sessionId));
-    await swallow(client.Page.enable(sessionId));
-    await swallow(client.DOM.enable({}, sessionId));
-    await swallow(client.Network.enable({}, sessionId));
-}
-function wireDomainHandlers(client, sessionId) {
-    // The strict gate: only process events from THIS session. The original
-    // implementation used `if (sessionId && eventSessionId !== sessionId)`,
-    // which is vacuously false when sessionId is undefined (the root) —
-    // making the root handler process every child session's events too.
-    const own = (eventSessionId) => eventSessionId === sessionId;
-    const registered = [];
-    const reg = (event, handler) => {
-        client.on(event, handler);
-        registered.push({ event, handler });
-    };
-    // Source-map / Debugger.scriptParsed
-    const scriptHandler = attachScriptListener(client, sessionState.scripts, sessionId);
-    registered.push({ event: "Debugger.scriptParsed", handler: scriptHandler });
-    const onPaused = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        sessionState.pause.onPaused({
-            reason: params.reason,
-            data: params.data,
-            hitBreakpoints: params.hitBreakpoints,
-            callFrames: params.callFrames,
-            asyncStackTrace: params.asyncStackTrace,
-            sessionId: eventSessionId,
-            pausedAt: Date.now(),
-        });
-        log.debug("paused", { reason: params.reason, hit: params.hitBreakpoints });
-    };
-    reg("Debugger.paused", onPaused);
-    const onResumed = (_p, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        sessionState.pause.onResumed();
-    };
-    reg("Debugger.resumed", onResumed);
-    const onConsoleApi = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        pushConsoleFromApi(sessionState, params, eventSessionId);
-    };
-    reg("Runtime.consoleAPICalled", onConsoleApi);
-    const onException = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        pushConsoleFromException(sessionState, params, eventSessionId);
-    };
-    reg("Runtime.exceptionThrown", onException);
-    // Predicate that matches an entry by (requestId, sessionId). CDP requestIds
-    // are scoped per Network agent — two iframes can both emit requestId="123" —
-    // so the predicate must include sessionId to avoid cross-session collisions
-    // in RingBuffer.update.
-    const matchEntry = (requestId) => (e) => e.requestId === requestId && e.sessionId === sessionId;
-    const onRequest = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        sessionState.network.push({
-            requestId: params.requestId,
-            ts: Date.now(),
-            url: params.request.url,
-            method: params.request.method,
-            resourceType: params.type,
-            ...(sessionId ? { sessionId } : {}),
-        });
-    };
-    reg("Network.requestWillBeSent", onRequest);
-    const onResponse = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        sessionState.network.update(matchEntry(params.requestId), {
-            status: params.response.status,
-            statusText: params.response.statusText,
-            mimeType: params.response.mimeType,
-            fromCache: params.response.fromDiskCache || params.response.fromPrefetchCache,
-        });
-    };
-    reg("Network.responseReceived", onResponse);
-    const onLoadingFinished = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        // Use the entry's own ts (set at requestWillBeSent) to compute duration.
-        const existing = sessionState.network.query({ filter: matchEntry(params.requestId), limit: 1 }).pop();
-        sessionState.network.update(matchEntry(params.requestId), {
-            ...(existing ? { durationMs: Date.now() - existing.ts } : {}),
-            finished: true,
-        });
-    };
-    reg("Network.loadingFinished", onLoadingFinished);
-    const onLoadingFailed = (params, eventSessionId) => {
-        if (!own(eventSessionId))
-            return;
-        // Symmetric with onLoadingFinished: time-to-failure (DNS error, connect
-        // refused, RST, abort, …) is useful for latency/anomaly analysis. Without
-        // this, duration_ms is `number | undefined` purely as a function of
-        // success vs. failure in the same call to get_network_requests.
-        const existing = sessionState.network.query({ filter: matchEntry(params.requestId), limit: 1 }).pop();
-        sessionState.network.update(matchEntry(params.requestId), {
-            ...(existing ? { durationMs: Date.now() - existing.ts } : {}),
-            failureReason: params.errorText,
-            finished: true,
-        });
-    };
-    reg("Network.loadingFailed", onLoadingFailed);
-    sessionState.sessionHandlers.set(sessionId ?? ROOT_SESSION_KEY, registered);
-}
-function pushConsoleFromApi(s, params, sessionId) {
-    // Two formatting modes:
-    //   - String args render as raw text (no surrounding quotes, no \n→\\n
-    //     escapes) — matches how DevTools / Node / every log shipper renders
-    //     console.log("Server started"). previewRemoteObject would
-    //     JSON.stringify them, which is right for REPL/evaluate output but
-    //     wrong for console buffering.
-    //   - Everything else (numbers, objects, arrays, functions, …) goes
-    //     through previewRemoteObject so {foo:1} keeps its shape.
-    const renderArg = (a) => a.type === "string" ? (a.value ?? "") : previewRemoteObject(a);
-    const text = params.args.length === 0
-        ? "(no args)"
-        : params.args.map(renderArg).join(" ");
-    const top = params.stackTrace?.callFrames?.[0];
-    const mapped = top ? mapCdpToOriginal(s.scripts, {
-        scriptId: top.scriptId,
-        lineNumber: top.lineNumber,
-        columnNumber: top.columnNumber,
-    }, sessionId) : null;
-    s.console.push({
-        ts: Date.now(),
-        level: mapApiLevel(params.type),
-        text,
-        source: "console-api",
-        ...(top?.url ? { url: top.url } : {}),
-        ...(top ? { lineNumber: top.lineNumber, columnNumber: top.columnNumber } : {}),
-        ...(mapped ? { mappedFile: mapped.file, mappedLine: mapped.line, mappedColumn: mapped.column } : {}),
-        ...(params.stackTrace ? { stack: params.stackTrace } : {}),
-    });
-}
-function pushConsoleFromException(s, params, sessionId) {
-    const det = params.exceptionDetails;
-    const top = det.stackTrace?.callFrames?.[0];
-    const mapped = top ? mapCdpToOriginal(s.scripts, {
-        scriptId: top.scriptId,
-        lineNumber: top.lineNumber,
-        columnNumber: top.columnNumber,
-    }, sessionId) : null;
-    const text = (det.exception?.description ?? det.exception?.value ?? det.text) + "";
-    s.console.push({
-        ts: Date.now(),
-        level: "error",
-        text,
-        source: "runtime-exception",
-        ...(top?.url ? { url: top.url } : { url: det.url }),
-        ...(top ? { lineNumber: top.lineNumber, columnNumber: top.columnNumber } : { lineNumber: det.lineNumber, columnNumber: det.columnNumber }),
-        ...(mapped ? { mappedFile: mapped.file, mappedLine: mapped.line, mappedColumn: mapped.column } : {}),
-        ...(det.stackTrace ? { stack: det.stackTrace } : {}),
-    });
-}
-function mapApiLevel(t) {
-    switch (t) {
-        case "warning":
-            return "warn";
-        case "error":
-            return "error";
-        case "debug":
-            return "debug";
-        case "info":
-            return "info";
-        case "trace":
-            return "trace";
-        case "log":
-        default:
-            return "log";
-    }
-}
-export async function closeSession() {
-    await sessionState.close();
-}
-// Switch to a different target on the same browser without tearing down the
-// chrome process. Used by select_target.
-export async function switchTarget(targetId) {
-    if (!sessionState.client)
-        throw new Error("No active session");
-    const port = sessionState.chromePort;
-    const attached = sessionState.attached;
-    const chrome = sessionState.chrome;
-    try {
-        await sessionState.client.close().catch(() => { });
-    }
-    catch {
-        /* ignore */
-    }
-    sessionState.client = null;
-    sessionState.currentTargetId = null;
-    sessionState.pause.reset();
-    sessionState.scripts.clear();
-    sessionState.breakpoints.clear();
-    sessionState.sessionHandlers.clear();
-    sessionState.chromePort = port;
-    sessionState.attached = attached;
-    sessionState.chrome = chrome;
-    await connectToTarget(port, targetId);
-    const list = await CDP.List({ port });
-    const t = list.find((x) => x.id === targetId);
-    return { targetId, url: t?.url ?? "" };
-}
-//# sourceMappingURL=browser.js.map