cdp-mcp 0.1.0

package/dist/session/browser.js

@@ -0,0 +1,394 @@
+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.)
+    const useSandbox = opts.sandbox === true;
+    const userArgs = opts.args ?? [];
+    const userAlreadyDisabled = userArgs.includes("--no-sandbox");
+    // 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 });
+    // 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

package/dist/session/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/session/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,GAAG,MAAM,yBAAyB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAsD,MAAM,iBAAiB,CAAC;AAE7F,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAmC,MAAM,YAAY,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAiC7D,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAmB,EAAE;IAItD,IAAI,YAAY,CAAC,MAAM;QAAE,MAAM,cAAc,EAAE,CAAC;IAChD,sEAAsE;IACtE,4DAA4D;IAC5D,4EAA4E;IAC5E,yEAAyE;IACzE,yEAAyE;IACzE,mEAAmE;IACnE,yEAAyE;IACzE,4EAA4E;IAC5E,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IACjC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC9D,0EAA0E;IAC1E,uEAAuE;IACvE,yEAAyE;IACzE,uEAAuE;IACvE,wEAAwE;IACxE,0EAA0E;IAC1E,sEAAsE;IACtE,oEAAoE;IACpE,uEAAuE;IACvE,sDAAsD;IACtD,MAAM,mBAAmB,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvE,MAAM,eAAe,GACnB,CAAC,IAAI,CAAC,WAAW,IAAI,mBAAmB,EAAE,UAAU,CAAC,QAAQ,CAAC;QAC5D,CAAC,CAAC,eAAe,CAAC,mBAAmB,CAAC;QACtC,CAAC,CAAC,SAAS,CAAC;IAChB,IAAI,eAAe,EAAE,CAAC;QACpB,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,UAAU,GAAkB;QAChC,WAAW,EAAE,IAAI,CAAC,GAAG,IAAI,aAAa;QACtC,WAAW,EAAE;YACX,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,QAAQ;SACZ;QACD,GAAG,CAAC,IAAI,CAAC,WAAW;YAClB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE;YACnC,CAAC,CAAC,eAAe;gBACf,CAAC,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE;gBAClC,CAAC,CAAC,EAAE,CAAC;QACT,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAEpE,8BAA8B;IAC9B,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAC3B,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAmB,EAAE;IAItD,IAAI,YAAY,CAAC,MAAM;QAAE,MAAM,cAAc,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;IACvC,YAAY,CAAC,UAAU,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,QAAQ,GAAG,IAAI,CAAC;IAE7B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;IAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACpC,yEAAyE;QACzE,iDAAiD;QACjD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;QACxC,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,0DAA0D,QAAQ,IAAI,MAAM,iBAAiB,OAAO,IAAI,GAAG,GAAG,CAC/G,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;IAC5B,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YACpD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB,EAAE,IAAa;IAC1E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,CAAC,eAAe,GAAG,QAAQ,CAAC;IAExC,6EAA6E;IAC7E,2EAA2E;IAC3E,0EAA0E;IAC1E,2EAA2E;IAC3E,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,CAAC,MAA6C,EAAE,EAAE;QACnE,KAAK,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,MAA+C,EAAE,EAAE;QACrE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC,CAAC;IACF,MAAM,CAAC,EAAE,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,CAAC,2BAA2B,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAE1D,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC;YAChC,UAAU,EAAE,IAAI;YAChB,sBAAsB,EAAE,KAAK;YAC7B,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAgD,EAChD,MAA6C;IAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5G,IAAI,CAAC;QACH,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACtC,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,MAAM,CAAC,aAAa,CAC/B,EAAE,UAAU,EAAE,IAAI,EAAE,sBAAsB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAClE,SAAS,CACV,CAAC;QACF,sEAAsE;QACtE,oEAAoE;QACpE,IAAI,YAAY,CAAC,iBAAiB,KAAK,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,iBAAiB,EAAE,EAAE,SAAS,CAAC,CAAC;YACnG,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,MAAgD,EAChD,SAAiB;IAEjB,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAClD,yEAAyE;IACzE,gEAAgE;IAChE,MAAM,QAAQ,GAAG,YAAY,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7D,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,QAAQ,EAAE,CAAC;YACzC,MAA0E,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC7G,CAAC;QACD,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IACD,uEAAuE;IACvE,KAAK,MAAM,EAAE,IAAI,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5C,IAAI,EAAE,CAAC,SAAS,KAAK,SAAS;YAAE,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,MAAgD,EAChD,SAA6B;IAE7B,kFAAkF;IAClF,MAAM,OAAO,GAAG,CAAC,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,MAAM,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAChD,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,kBAAkB,CACzB,MAAgD,EAChD,SAA6B;IAE7B,uEAAuE;IACvE,wEAAwE;IACxE,oEAAoE;IACpE,oEAAoE;IACpE,MAAM,GAAG,GAAG,CAAC,cAAkC,EAAE,EAAE,CAAC,cAAc,KAAK,SAAS,CAAC;IACjF,MAAM,UAAU,GAAmB,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,KAAa,EAAE,OAAiC,EAAE,EAAE;QAC/D,MAAM,CAAC,EAAE,CAAC,KAAY,EAAE,OAAc,CAAC,CAAC;QACxC,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,qCAAqC;IACrC,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpF,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IAE5E,MAAM,QAAQ,GAAG,CAAC,MAAqC,EAAE,cAAuB,EAAE,EAAE;QAClF,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,SAAS,EAAE,cAAc;YACzB,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;IACF,GAAG,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAEjC,MAAM,SAAS,GAAG,CAAC,EAAW,EAAE,cAAuB,EAAE,EAAE;QACzD,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;IACjC,CAAC,CAAC;IACF,GAAG,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;IAEnC,MAAM,YAAY,GAAG,CAAC,MAA8C,EAAE,cAAuB,EAAE,EAAE;QAC/F,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3D,CAAC,CAAC;IACF,GAAG,CAAC,0BAA0B,EAAE,YAAY,CAAC,CAAC;IAE9C,MAAM,WAAW,GAAG,CAAC,MAA6C,EAAE,cAAuB,EAAE,EAAE;QAC7F,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC;IACF,GAAG,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;IAE5C,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,wBAAwB;IACxB,MAAM,UAAU,GAAG,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,CAA4C,EAAE,EAAE,CACzF,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC;IAEzD,MAAM,SAAS,GAAG,CAAC,MAA+C,EAAE,cAAuB,EAAE,EAAE;QAC7F,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACd,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG;YACvB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC7B,YAAY,EAAE,MAAM,CAAC,IAAI;YACzB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,2BAA2B,EAAE,SAAS,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,CAAC,MAA8C,EAAE,cAAuB,EAAE,EAAE;QAC7F,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YACxD,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;YAC9B,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAClC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,IAAI,MAAM,CAAC,QAAQ,CAAC,iBAAiB;SAC9E,CAAC,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,0BAA0B,EAAE,UAAU,CAAC,CAAC;IAE5C,MAAM,iBAAiB,GAAG,CAAC,MAA6C,EAAE,cAAuB,EAAE,EAAE;QACnG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,yEAAyE;QACzE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACtG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YACxD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,yBAAyB,EAAE,iBAAiB,CAAC,CAAC;IAElD,MAAM,eAAe,GAAG,CAAC,MAA2C,EAAE,cAAuB,EAAE,EAAE;QAC/F,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC;YAAE,OAAO;QACjC,wEAAwE;QACxE,0EAA0E;QAC1E,oEAAoE;QACpE,gEAAgE;QAChE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACtG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;YACxD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,aAAa,EAAE,MAAM,CAAC,SAAS;YAC/B,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;IACL,CAAC,CAAC;IACF,GAAG,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;IAE9C,YAAY,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,IAAI,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAU,EAAE,MAA8C,EAAE,SAA6B;IACnH,wBAAwB;IACxB,uEAAuE;IACvE,yEAAyE;IACzE,+DAA+D;IAC/D,uEAAuE;IACvE,mCAAmC;IACnC,oEAAoE;IACpE,8DAA8D;IAC9D,MAAM,SAAS,GAAG,CAAC,CAAgC,EAAE,EAAE,CACrD,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QACtB,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,EAAE;QAC/C,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACb,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/B,IAAI;QACJ,MAAM,EAAE,aAAa;QACrB,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,CAAU,EAAE,MAA6C,EAAE,SAA6B;IACxH,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,EAAE;QAC/C,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,YAAY,EAAE,GAAG,CAAC,YAAY;KAC/B,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrB,MAAM,IAAI,GACR,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,IAAI,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACxE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACb,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,KAAK,EAAE,OAAO;QACd,IAAI;QACJ,MAAM,EAAE,mBAAmB;QAC3B,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QACnD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC;QAC1I,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,CAAiD;IACpE,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,KAAK,CAAC;QACX;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,4EAA4E;AAC5E,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC,YAAY,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,YAAY,CAAC,UAAW,CAAC;IACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;IACD,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,eAAe,GAAG,IAAI,CAAC;IACpC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC3B,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,YAAY,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IACjC,YAAY,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IACrC,YAAY,CAAC,UAAU,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACjC,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC9C,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;AACzC,CAAC"}

package/dist/session/buffers.js

@@ -0,0 +1,43 @@
+export class RingBuffer {
+    capacity;
+    items = [];
+    nextSeq = 1;
+    constructor(capacity) {
+        this.capacity = capacity;
+    }
+    push(item) {
+        const full = { ...item, seq: this.nextSeq++ };
+        this.items.push(full);
+        if (this.items.length > this.capacity) {
+            this.items.splice(0, this.items.length - this.capacity);
+        }
+        return full;
+    }
+    query(opts = {}) {
+        const since = opts.since ?? 0;
+        let out = this.items.filter((it) => it.seq > since);
+        if (opts.filter)
+            out = out.filter(opts.filter);
+        if (opts.limit !== undefined)
+            out = out.slice(-opts.limit);
+        return out;
+    }
+    clear() {
+        this.items = [];
+    }
+    size() {
+        return this.items.length;
+    }
+    // Mutate-in-place: used by network buffer to update an entry when the response arrives.
+    update(predicate, patch) {
+        for (let i = this.items.length - 1; i >= 0; i--) {
+            const item = this.items[i];
+            if (predicate(item)) {
+                this.items[i] = { ...item, ...patch };
+                return this.items[i];
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=buffers.js.map

package/dist/session/buffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffers.js","sourceRoot":"","sources":["../../src/session/buffers.ts"],"names":[],"mappings":"AA2CA,MAAM,OAAO,UAAU;IAGD;IAFZ,KAAK,GAAQ,EAAE,CAAC;IAChB,OAAO,GAAG,CAAC,CAAC;IACpB,YAAoB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAExC,IAAI,CAAC,IAAoB;QACvB,MAAM,IAAI,GAAG,EAAE,GAAI,IAAe,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,EAAO,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAIF,EAAE;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,wFAAwF;IACxF,MAAM,CAAC,SAA+B,EAAE,KAAiB;QACvD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAC5B,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;gBACtC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YACxB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/session/pause.js

@@ -0,0 +1,99 @@
+// Tracks one pause at a time. Callers wait via waitForPause(); the next
+// Debugger.paused event resolves the pending waiter (or buffers state for a
+// later call).
+export class PauseTracker {
+    state = null;
+    waiters = [];
+    current() {
+        return this.state;
+    }
+    isPaused() {
+        return this.state !== null;
+    }
+    onPaused(state) {
+        this.state = state;
+        while (this.waiters.length) {
+            const w = this.waiters.shift();
+            if (w.timer)
+                clearTimeout(w.timer);
+            w.resolve(state);
+        }
+    }
+    onResumed() {
+        this.state = null;
+    }
+    // Resolves on the next pause, or immediately if already paused.
+    waitForPause(timeoutMs) {
+        if (this.state)
+            return Promise.resolve(this.state);
+        return new Promise((resolve, reject) => {
+            const w = {
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    const i = this.waiters.indexOf(w);
+                    if (i >= 0)
+                        this.waiters.splice(i, 1);
+                    reject(new Error(`Timed out after ${timeoutMs}ms waiting for pause`));
+                }, timeoutMs),
+            };
+            this.waiters.push(w);
+        });
+    }
+    // Used by step commands: resolve when either paused-again or resumed.
+    //
+    // Critical: check `this.state` at entry. The step path in tools/execution.ts
+    // calls `onResumed()` (clearing state), then awaits `Debugger.stepOver` —
+    // and for fast steps Chrome delivers the stepOver response and the
+    // subsequent `Debugger.paused` in the same WebSocket batch. CRI emits
+    // events synchronously, so `onPaused` runs *before* the awaiter resumes
+    // and registers its waiter. Without this entry guard the pause is
+    // buffered into nowhere, the waiter sits unresolved for `timeoutMs`,
+    // and stepThen returns `{paused:false}` while `isPaused()` is actually
+    // true — desync that misleads every subsequent pause-only tool.
+    waitForPauseOrResume(timeoutMs) {
+        if (this.state)
+            return Promise.resolve(this.state);
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const onPause = (s) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                this.waiters = this.waiters.filter((w) => w !== waiter);
+                resolve(s);
+            };
+            const waiter = {
+                resolve: onPause,
+                reject: (e) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(timer);
+                    reject(e);
+                },
+                timer: null,
+            };
+            this.waiters.push(waiter);
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                this.waiters = this.waiters.filter((w) => w !== waiter);
+                // Treat timeout as "resumed without pausing" — common for short steps.
+                resolve(null);
+            }, timeoutMs);
+        });
+    }
+    reset() {
+        this.state = null;
+        for (const w of this.waiters) {
+            if (w.timer)
+                clearTimeout(w.timer);
+            w.reject(new Error("Session closed"));
+        }
+        this.waiters = [];
+    }
+}
+//# sourceMappingURL=pause.js.map

package/dist/session/pause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause.js","sourceRoot":"","sources":["../../src/session/pause.ts"],"names":[],"mappings":"AAkBA,wEAAwE;AACxE,4EAA4E;AAC5E,eAAe;AACf,MAAM,OAAO,YAAY;IACf,KAAK,GAAsB,IAAI,CAAC;IAChC,OAAO,GAAa,EAAE,CAAC;IAE/B,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,KAAiB;QACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAC;YAChC,IAAI,CAAC,CAAC,KAAK;gBAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,gEAAgE;IAChE,YAAY,CAAC,SAAiB;QAC5B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACjD,MAAM,CAAC,GAAW;gBAChB,OAAO;gBACP,MAAM;gBACN,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE;oBACrB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBAClC,IAAI,CAAC,IAAI,CAAC;wBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,SAAS,sBAAsB,CAAC,CAAC,CAAC;gBACxE,CAAC,EAAE,SAAS,CAAC;aACd,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sEAAsE;IACtE,EAAE;IACF,6EAA6E;IAC7E,0EAA0E;IAC1E,mEAAmE;IACnE,sEAAsE;IACtE,wEAAwE;IACxE,kEAAkE;IAClE,qEAAqE;IACrE,uEAAuE;IACvE,gEAAgE;IAChE,oBAAoB,CAAC,SAAiB;QACpC,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;gBAChC,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;gBACxD,OAAO,CAAC,CAAC,CAAC,CAAC;YACb,CAAC,CAAC;YACF,MAAM,MAAM,GAAW;gBACrB,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;oBACZ,IAAI,OAAO;wBAAE,OAAO;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,CAAC,CAAC,CAAC;gBACZ,CAAC;gBACD,KAAK,EAAE,IAAI;aACZ,CAAC;YACF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;gBACxD,uEAAuE;gBACvE,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,CAAC,KAAK;gBAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/session/state.js

@@ -0,0 +1,93 @@
+import { PauseTracker } from "./pause.js";
+import { RingBuffer } from "./buffers.js";
+import { ScriptStore } from "../sourcemap/store.js";
+import { log } from "../util/log.js";
+import { noSession, notPaused } from "../util/errors.js";
+const ROOT_SESSION_KEY = "__root__";
+export { ROOT_SESSION_KEY };
+class SessionState {
+    client = null;
+    chrome = null;
+    chromePort = null;
+    attached = false; // true when attached to a pre-existing chrome (don't kill on close)
+    currentTargetId = null;
+    currentSessionId = undefined; // for flat-session targets
+    pause = new PauseTracker();
+    console = new RingBuffer(1000);
+    network = new RingBuffer(1000);
+    scripts = new ScriptStore();
+    breakpoints = new Map();
+    // Per-session handler refs so we can removeListener on Target.detachedFromTarget.
+    // Key is sessionId or ROOT_SESSION_KEY for the top-level target.
+    sessionHandlers = new Map();
+    // Last set_pause_on_exceptions state. Replayed to every newly-attached
+    // child session in onChildAttached, so workers/iframes honor the setting
+    // even when they attach after the user configured it.
+    pauseOnExceptions = "none";
+    // Counter for generating user-friendly breakpoint IDs that survive resolve roundtrips.
+    bpCounter = 0;
+    nextBpId() {
+        this.bpCounter += 1;
+        return `bp_${this.bpCounter}`;
+    }
+    reset() {
+        this.client = null;
+        this.chrome = null;
+        this.chromePort = null;
+        this.attached = false;
+        this.currentTargetId = null;
+        this.currentSessionId = undefined;
+        this.pause.reset();
+        this.console.clear();
+        this.network.clear();
+        this.scripts.clear();
+        this.breakpoints.clear();
+        this.sessionHandlers.clear();
+        this.pauseOnExceptions = "none";
+        this.bpCounter = 0;
+    }
+    async close() {
+        log.info("closing session");
+        try {
+            if (this.client) {
+                try {
+                    await this.client.close();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        finally {
+            try {
+                if (this.chrome && !this.attached) {
+                    try {
+                        this.chrome.kill();
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+            }
+            finally {
+                this.reset();
+            }
+        }
+    }
+}
+export const sessionState = new SessionState();
+export function getSession() {
+    return sessionState.client ? sessionState : null;
+}
+export function requireSession() {
+    if (!sessionState.client)
+        throw noSession();
+    return sessionState;
+}
+export function requirePaused() {
+    const s = requireSession();
+    if (!s.pause.isPaused())
+        throw notPaused();
+    return s;
+}
+//# sourceMappingURL=state.js.map