browser-debugger-cli 0.13.0 → 0.14.0

package/dist/commands/shared/daemonErrorHandler.js

@@ -3,7 +3,7 @@
  */
 import { sessionUnavailableSuggestion } from '../../errors/messages.js';
 import { genericError } from '../../errors/messages.js';
-import { OutputBuilder } from '../../ui/OutputBuilder.js';
+import { OutputBuilder, stringifyEnvelope } from '../../ui/OutputBuilder.js';
 import { connectionLostRetryMessage, connectionLostStopHintMessage, followedSessionEndedMessage, } from '../../ui/messages/preview.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
 /** Follow-mode state: whether a session ever answered, and whether its loss was reported */
@@ -42,7 +42,7 @@ export function handleDaemonConnectionError(error, options) {
                 exitCode,
                 ...(suggestion && { suggestion }),
             });
-            console.log(follow ? JSON.stringify(envelope) : JSON.stringify(envelope, null, 2));
+            console.log(follow ? JSON.stringify(envelope) : stringifyEnvelope(envelope));
         }
         else {
             console.error(genericError(message));

package/dist/commands/shared/dataFetcher.d.ts

@@ -3,6 +3,7 @@
  */
 import type { PeekSection } from '../../ipc/protocol/commands.js';
 import type { BdgOutput, ConsoleMessage, NetworkRequest } from '../../types.js';
+import type { NetworkEvictionCounts } from '../../ui/messages/networkMessages.js';
 export type FetchSuccess<T> = {
     success: true;
     data: T;
@@ -47,12 +48,13 @@ export declare function fetchPreviewData(query?: PreviewQuery): Promise<FetchRes
  * Fetch all captured network requests from daemon.
  *
  * @param withHeaders - Include request/response headers (needed by header filters)
- * @returns Requests, and when the page crashed (while it is not loaded
- *   again), or a fetch error
+ * @returns Requests, when the page crashed (while it is not loaded again)
+ *   and what the session let go at its capture limits, or a fetch error
  */
 export declare function fetchNetworkRequests(withHeaders?: boolean): Promise<FetchResult<{
     requests: NetworkRequest[];
     pageCrashedAt: number | undefined;
+    evictions: NetworkEvictionCounts;
 }>>;
 /**
  * Fetch all console messages from daemon.

package/dist/commands/shared/dataFetcher.js

@@ -90,16 +90,24 @@ export async function fetchPreviewData(query = {}) {
  * Fetch all captured network requests from daemon.
  *
  * @param withHeaders - Include request/response headers (needed by header filters)
- * @returns Requests, and when the page crashed (while it is not loaded
- *   again), or a fetch error
+ * @returns Requests, when the page crashed (while it is not loaded again)
+ *   and what the session let go at its capture limits, or a fetch error
  */
 export async function fetchNetworkRequests(withHeaders = false) {
     const result = await fetchPreviewData({ lastN: 0, only: 'network', withHeaders });
     if (!result.success)
         return result;
+    const { totals, pageCrashedAt } = result.data.output;
     return {
         success: true,
-        data: { requests: result.data.network, pageCrashedAt: result.data.output.pageCrashedAt },
+        data: {
+            requests: result.data.network,
+            pageCrashedAt,
+            evictions: {
+                requestsDropped: totals?.networkDropped ?? 0,
+                bodiesEvicted: totals?.networkBodiesEvicted ?? 0,
+            },
+        },
     };
 }
 /**

package/dist/commands/shared/handleValidationError.js

@@ -1,6 +1,6 @@
 import { CommandError } from '../../errors/index.js';
 import { genericError } from '../../errors/messages.js';
-import { OutputBuilder } from '../../ui/OutputBuilder.js';
+import { OutputBuilder, stringifyEnvelope } from '../../ui/OutputBuilder.js';
 import { escapeControlChars } from '../../ui/formatting.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
 /**
@@ -24,7 +24,7 @@ export function handleValidationError(error, json) {
             if (error.metadata.suggestion) {
                 errorOptions.suggestion = error.metadata.suggestion;
             }
-            console.log(JSON.stringify(OutputBuilder.buildJsonError(error.message, errorOptions), null, 2));
+            console.log(stringifyEnvelope(OutputBuilder.buildJsonError(error.message, errorOptions)));
         }
         else {
             console.error(genericError(error.message));
@@ -38,7 +38,7 @@ export function handleValidationError(error, json) {
         const envelope = OutputBuilder.buildJsonError(message, {
             exitCode: EXIT_CODES.INVALID_ARGUMENTS,
         });
-        console.log(JSON.stringify(envelope, null, 2));
+        console.log(stringifyEnvelope(envelope));
     }
     else {
         console.error(genericError(message));

package/dist/commands/shared/optionTypes.d.ts

@@ -143,12 +143,12 @@ export type DetailsCommandOptions = BaseOptions & {
 };
 /** Options for DOM query command */
 export type DomQueryCommandOptions = BaseOptions & {
-    /** Matches listed (0 = all); default 50, or 1000 with --json */
+    /** Matches listed (0 = all); default 50, or 100 with --json */
     limit?: number;
 };
 /** Options for DOM get command */
 export type DomGetCommandOptions = BaseOptions & RawOptions & SelectionOptions & {
-    /** All of the element's text instead of its first 500 characters (semantic output) */
+    /** All of the element's text (semantic output) or HTML (`--raw`), instead of its start */
     full?: boolean;
     /** Which match of the selector (0-based); `--nth` is its alias */
     index?: number;
@@ -159,6 +159,8 @@ export type DomScreenshotCommandOptions = BaseOptions & ScreenshotOptions;
 export interface DomEvalCommandOptions extends BaseOptions {
     /** Iframe to evaluate in: index, name/id attribute, or part of the name, id or URL */
     frame?: string;
+    /** The whole value instead of its first 20000 characters */
+    full?: boolean;
 }
 /** Options for DOM frames command */
 export type DomFramesCommandOptions = BaseOptions;
@@ -276,7 +278,12 @@ export interface WaitCommandOptions extends BaseOptions {
     timeout: number;
 }
 /** Options for A11y tree command */
-export type A11yTreeCommandOptions = BaseOptions;
+export interface A11yTreeCommandOptions extends BaseOptions {
+    /** Nodes to list (0 = all); default 50, also with --json */
+    limit?: number;
+    /** Levels below the root to list (0 = root only) */
+    depth?: number;
+}
 /** Options for A11y query command */
 export interface A11yQueryCommandOptions extends BaseOptions {
     /** Matches to list (0 = all) */
@@ -354,6 +361,8 @@ export interface ConsoleCommandOptions extends BaseOptions {
     history?: boolean;
     /** Filter by message level (error, warning, info, debug) */
     level?: ConsoleLevel;
+    /** Message texts whole instead of cut */
+    full?: boolean;
 }
 /**
  * Options for preview display.
@@ -380,6 +389,8 @@ export interface PeekCommandOptions extends BaseOptions, PreviewDisplayOptions {
     type?: string;
     /** Refresh interval of --follow in ms (string from CLI, default: 1000) */
     interval?: string;
+    /** Console message texts whole instead of cut */
+    full?: boolean;
 }
 /**
  * Options for tail command.

package/dist/commands/shared/startHelpers.js

@@ -14,7 +14,7 @@ import { IPCErrorCode, } from '../../ipc/index.js';
 import { IPCTimeoutError } from '../../ipc/transport/index.js';
 import { isConnectionError } from '../../ipc/utils/errors.js';
 import { getSessionName } from '../../session/paths.js';
-import { OutputBuilder, buildSuccessResponse } from '../../ui/OutputBuilder.js';
+import { OutputBuilder, buildSuccessResponse, stringifyEnvelope } from '../../ui/OutputBuilder.js';
 import { escapeControlChars, joinLines } from '../../ui/formatting.js';
 import { createLogger } from '../../ui/logging/index.js';
 import { daemonStillExitingHint, daemonStillExitingSuggestion, startNotices, } from '../../ui/messages/session.js';
@@ -318,7 +318,7 @@ function reportStartOutcome(outcome, options) {
                 exitCode: outcome.exitCode,
                 ...outcome.details,
             });
-            console.log(JSON.stringify(envelope, null, 2));
+            console.log(stringifyEnvelope(envelope));
         }
         else {
             console.error(escapeControlChars(outcome.human));
@@ -340,7 +340,7 @@ function reportStartOutcome(outcome, options) {
             daemonPid: data.daemonPid,
             ...(autoStopAt && { autoStopAt: autoStopAt.toISOString() }),
         };
-        console.log(JSON.stringify(buildSuccessResponse(result), null, 2));
+        console.log(stringifyEnvelope(buildSuccessResponse(result)));
     }
     else {
         const page = {

package/dist/connection/chromeIdentity.d.ts

@@ -49,12 +49,18 @@ export declare function waitForDevToolsEndpoint(logs: StartupLogs, isRunning: ()
  * Check that the Chrome answering on 127.0.0.1:<port> is the one just
  * launched, so bdg never drives another session's browser.
  *
+ * A Chrome that announced 127.0.0.1:<port> but does not answer yet (a slow
+ * start, its `/json/version` request timing out) is asked again until the
+ * deadline; only an answer from something else is a port conflict. A Chrome
+ * that fell back to [::1] is asked once: 127.0.0.1 is held by something else.
+ *
  * @param options - Chrome's log positions from before the launch, requested
  *   port (free on 127.0.0.1 and ::1 right before the launch), Chrome's PID and
- *   longest wait for its announcement
+ *   longest wait for its announcement and its answer
  * @throws ChromeLaunchError: CHROME_DIED_AFTER_LAUNCH if Chrome exits first;
  *   PORT_IN_USE if another browser or process answers on the port;
- *   CHROME_LAUNCH_FAILED if Chrome announced nothing and nothing answers
+ *   CHROME_LAUNCH_FAILED if Chrome announced nothing and nothing answers, or
+ *   announced the port but did not answer on it in time
  */
 export declare function verifyLaunchedChrome(options: {
     logs: StartupLogs;

package/dist/connection/chromeIdentity.js

@@ -18,8 +18,9 @@
  * before the launch, and a second listener is how a conflict shows.
  */
 import { createLogger } from '../ui/logging/index.js';
+import { chromeNotAnsweringReason, portTakenByReason } from '../ui/messages/chrome.js';
 import { delay } from '../utils/async.js';
-import { fetchBrowserWsUrl } from '../utils/http.js';
+import { CDP_HTTP_TIMEOUT_MS, fetchBrowserWsUrl, probeDevToolsEndpoint, } from '../utils/http.js';
 import { isProcessAlive } from '../utils/process.js';
 import { ChromeLaunchError } from './errors.js';
 import { acceptsConnections } from './portReservation.js';
@@ -29,6 +30,8 @@ const LISTENING_PATTERN = /^DevTools listening on (ws:\/\/\S+)/;
 /** How long to wait for Chrome to announce its endpoint after the port answered */
 const ENDPOINT_WAIT_MS = 10000;
 const ENDPOINT_POLL_MS = 50;
+/** Shortest wait for one answer, also when the deadline has passed */
+const MIN_ANSWER_WAIT_MS = 1000;
 const log = createLogger('chrome');
 /**
  * Find the endpoint Chrome announced in its output (the last announcement).
@@ -75,32 +78,75 @@ export async function waitForDevToolsEndpoint(logs, isRunning, timeoutMs = ENDPO
  * Check that the Chrome answering on 127.0.0.1:<port> is the one just
  * launched, so bdg never drives another session's browser.
  *
+ * A Chrome that announced 127.0.0.1:<port> but does not answer yet (a slow
+ * start, its `/json/version` request timing out) is asked again until the
+ * deadline; only an answer from something else is a port conflict. A Chrome
+ * that fell back to [::1] is asked once: 127.0.0.1 is held by something else.
+ *
  * @param options - Chrome's log positions from before the launch, requested
  *   port (free on 127.0.0.1 and ::1 right before the launch), Chrome's PID and
- *   longest wait for its announcement
+ *   longest wait for its announcement and its answer
  * @throws ChromeLaunchError: CHROME_DIED_AFTER_LAUNCH if Chrome exits first;
  *   PORT_IN_USE if another browser or process answers on the port;
- *   CHROME_LAUNCH_FAILED if Chrome announced nothing and nothing answers
+ *   CHROME_LAUNCH_FAILED if Chrome announced nothing and nothing answers, or
+ *   announced the port but did not answer on it in time
  */
 export async function verifyLaunchedChrome(options) {
-    const { logs, port, pid, timeoutMs } = options;
+    const { logs, port, pid, timeoutMs = ENDPOINT_WAIT_MS } = options;
+    const started = Date.now();
     const isRunning = () => isProcessAlive(pid);
     const endpoint = await waitForDevToolsEndpoint(logs, isRunning, timeoutMs);
-    if (!endpoint && !isRunning()) {
-        throw new ChromeLaunchError(`Chrome died immediately after launch (PID: ${pid})`, {
-            issue: { code: 'CHROME_DIED_AFTER_LAUNCH', context: { port, pid } },
-        });
-    }
+    if (!endpoint && !isRunning())
+        throw diedError(port, pid);
     if (!endpoint)
         return acceptUnannouncedChrome(logs, port);
     if (endpoint.port !== port) {
         throw portTakenError(port, `Chrome listens on port ${endpoint.port} instead`);
     }
-    const answering = await fetchBrowserWsUrl(port, log);
-    if (!answering || new URL(answering).pathname !== endpoint.browserPath) {
-        throw portTakenError(port, `another process answers on 127.0.0.1 (Chrome listens on ${endpoint.host})`);
+    const onLoopback = endpoint.host === '127.0.0.1';
+    const deadline = onLoopback ? started + timeoutMs : Date.now();
+    const answer = await waitForAnswer(port, deadline, isRunning);
+    if (answer.kind === 'devtools' && new URL(answer.wsUrl).pathname === endpoint.browserPath) {
+        log.debug(`Chrome on port ${port} is the launched one (${endpoint.browserPath})`);
+        return;
+    }
+    if (answer.kind === 'unreachable' && !isRunning())
+        throw diedError(port, pid);
+    if (answer.kind === 'unreachable' && onLoopback) {
+        throw slowStartError(port, Date.now() - started);
+    }
+    throw portTakenError(port, portTakenByReason(answerSource(answer), endpoint.host));
+}
+/**
+ * Ask 127.0.0.1:<port> for its DevTools version until something answers,
+ * Chrome exits or the deadline passes (at least once). Each request waits at
+ * most until the deadline (but at least MIN_ANSWER_WAIT_MS).
+ *
+ * @param port - Requested port
+ * @param deadline - Time (ms since epoch) to stop asking
+ * @param isRunning - Whether Chrome is still running
+ * @returns The first answer, or the last `unreachable` result
+ */
+async function waitForAnswer(port, deadline, isRunning) {
+    for (;;) {
+        const remaining = Math.max(deadline - Date.now(), MIN_ANSWER_WAIT_MS);
+        const timeoutMs = Math.min(CDP_HTTP_TIMEOUT_MS, remaining);
+        const answer = await probeDevToolsEndpoint(port, undefined, { timeoutMs });
+        if (answer.kind !== 'unreachable' || !isRunning() || Date.now() >= deadline)
+            return answer;
+        await delay(ENDPOINT_POLL_MS);
     }
-    log.debug(`Chrome on port ${port} is the launched one (${endpoint.browserPath})`);
+}
+/**
+ * What answered on 127.0.0.1:<port> instead of the launched Chrome.
+ *
+ * @param answer - The answer
+ * @returns A browser, another process, or nothing
+ */
+function answerSource(answer) {
+    if (answer.kind === 'devtools')
+        return 'browser';
+    return answer.kind === 'not-devtools' ? 'process' : 'nothing';
 }
 /**
  * Accept a Chrome that did not announce its endpoint, if a browser answers on
@@ -128,6 +174,32 @@ async function acceptUnannouncedChrome(logs, port) {
     }
     log.info(`Warning: ${missing}; using the browser on 127.0.0.1:${port}, which was free before the launch`);
 }
+/**
+ * The error for a Chrome that exited during the launch checks.
+ *
+ * @param port - Requested port
+ * @param pid - Chrome's PID
+ * @returns Launch error with the CHROME_DIED_AFTER_LAUNCH issue
+ */
+function diedError(port, pid) {
+    return new ChromeLaunchError(`Chrome died immediately after launch (PID: ${pid})`, {
+        issue: { code: 'CHROME_DIED_AFTER_LAUNCH', context: { port, pid } },
+    });
+}
+/**
+ * The error for a Chrome that announced the port but did not answer on it in
+ * time.
+ *
+ * @param port - Requested port
+ * @param waitedMs - How long bdg waited
+ * @returns Launch error with the CHROME_LAUNCH_FAILED issue
+ */
+function slowStartError(port, waitedMs) {
+    const reason = chromeNotAnsweringReason(port, waitedMs);
+    return new ChromeLaunchError(reason, {
+        issue: { code: 'CHROME_LAUNCH_FAILED', context: { port, reason } },
+    });
+}
 /**
  * The error for a port another process answers on.
  *

package/dist/constants.d.ts

@@ -58,7 +58,8 @@ export declare const DOCKER_CHROME_FLAGS: string[];
  */
 export declare const BDG_CHROME_PREFS: Record<string, unknown>;
 /**
- * Maximum network requests to collect before dropping new requests
+ * Finished network requests kept: past this the oldest are dropped, so the
+ * newest are kept (requests in flight are never dropped)
  * Prevents memory issues in long-running sessions with high network activity
  */
 export declare const MAX_NETWORK_REQUESTS = 10000;
@@ -88,6 +89,24 @@ export declare const OBJECT_EXPANSION_FAILURE_THRESHOLD = 5;
  * Can be overridden with --max-body-size flag
  */
 export declare const MAX_RESPONSE_SIZE: number;
+/**
+ * Total size of the response bodies a session keeps (100MB)
+ * Past this the oldest bodies are replaced by a placeholder; their requests stay
+ */
+export declare const MAX_TOTAL_BODY_BYTES: number;
+/**
+ * Characters of one value `dom get --raw` and `dom eval` print (human output,
+ * and eval string results and outer HTML in JSON)
+ */
+export declare const MAX_VALUE_LENGTH = 20000;
+/**
+ * Characters of a console message text in human output (`console`, `peek`)
+ */
+export declare const MAX_CONSOLE_TEXT_LENGTH = 200;
+/**
+ * Characters of a console message text in JSON output (`console`, `peek`)
+ */
+export declare const MAX_CONSOLE_JSON_TEXT_LENGTH = 10000;
 /**
  * Total Chrome network buffer size (50MB)
  * Limits total memory used by Chrome for preserving network payloads
@@ -103,6 +122,15 @@ export declare const CHROME_NETWORK_BUFFER_PER_RESOURCE: number;
  * Limits size of POST body data included in requestWillBeSent notification
  */
 export declare const CHROME_POST_DATA_LIMIT: number;
+/** Matches `dom query` and `dom a11y query` list with `--json` and no `--limit` */
+export declare const QUERY_JSON_LIST_LIMIT = 100;
+/** Matches `dom layout` measures per command (the rest are counted as omitted) */
+export declare const LAYOUT_ELEMENT_LIMIT = 100;
+/**
+ * Requests listed in an action's result (a click that loads a page triggers
+ * its whole load); notable ones are kept before assets
+ */
+export declare const MAX_TRIGGERED_REQUESTS = 50;
 /**
  * Default page readiness timeout (2 seconds)
  * Maximum time to wait for page to be ready before proceeding

package/dist/constants.js

@@ -87,7 +87,8 @@ export const BDG_CHROME_PREFS = {
 // DATA COLLECTION LIMITS
 // ============================================================================
 /**
- * Maximum network requests to collect before dropping new requests
+ * Finished network requests kept: past this the oldest are dropped, so the
+ * newest are kept (requests in flight are never dropped)
  * Prevents memory issues in long-running sessions with high network activity
  */
 export const MAX_NETWORK_REQUESTS = 10000;
@@ -120,6 +121,27 @@ export const OBJECT_EXPANSION_FAILURE_THRESHOLD = 5;
  * Can be overridden with --max-body-size flag
  */
 export const MAX_RESPONSE_SIZE = 5 * 1024 * 1024; // 5MB
+/**
+ * Total size of the response bodies a session keeps (100MB)
+ * Past this the oldest bodies are replaced by a placeholder; their requests stay
+ */
+export const MAX_TOTAL_BODY_BYTES = 100 * 1024 * 1024;
+// ============================================================================
+// OUTPUT VALUE LIMITS (lifted by --full)
+// ============================================================================
+/**
+ * Characters of one value `dom get --raw` and `dom eval` print (human output,
+ * and eval string results and outer HTML in JSON)
+ */
+export const MAX_VALUE_LENGTH = 20_000;
+/**
+ * Characters of a console message text in human output (`console`, `peek`)
+ */
+export const MAX_CONSOLE_TEXT_LENGTH = 200;
+/**
+ * Characters of a console message text in JSON output (`console`, `peek`)
+ */
+export const MAX_CONSOLE_JSON_TEXT_LENGTH = 10_000;
 // ============================================================================
 // CHROME CDP BUFFER LIMITS
 // ============================================================================
@@ -139,6 +161,18 @@ export const CHROME_NETWORK_BUFFER_PER_RESOURCE = 10 * 1024 * 1024; // 10MB
  */
 export const CHROME_POST_DATA_LIMIT = 1 * 1024 * 1024; // 1MB
 // ============================================================================
+// JSON LIST LIMITS
+// ============================================================================
+/** Matches `dom query` and `dom a11y query` list with `--json` and no `--limit` */
+export const QUERY_JSON_LIST_LIMIT = 100;
+/** Matches `dom layout` measures per command (the rest are counted as omitted) */
+export const LAYOUT_ELEMENT_LIMIT = 100;
+/**
+ * Requests listed in an action's result (a click that loads a page triggers
+ * its whole load); notable ones are kept before assets
+ */
+export const MAX_TRIGGERED_REQUESTS = 50;
+// ============================================================================
 // TIMEOUTS & INTERVALS
 // ============================================================================
 /**

package/dist/daemon/SessionController.js

@@ -245,6 +245,8 @@ export class SessionController {
                             network: data.totalNetwork,
                             console: data.totalConsole,
                             ...(data.droppedConsole && { consoleDropped: data.droppedConsole }),
+                            ...(data.droppedNetwork && { networkDropped: data.droppedNetwork }),
+                            ...(data.evictedNetworkBodies && { networkBodiesEvicted: data.evictedNetworkBodies }),
                         },
                         currentNavigationId: data.currentNavigationId,
                         ...(data.pageCrashedAt !== undefined && { pageCrashedAt: data.pageCrashedAt }),

package/dist/daemon/session/Session.d.ts

@@ -83,7 +83,8 @@ export declare class Session {
      * Execute a registered command against this session. After a renderer
      * crash only {@link RUN_ON_CRASHED_PAGE} commands run (`bdg cdp` only for
      * {@link CRASH_SAFE_CDP} methods); others fail with exit 107 instead of
-     * waiting for a page that cannot answer.
+     * waiting for a page that cannot answer. Commands that may change the page
+     * drop `dom inspect`'s kept matched rules ({@link withMatchedStylesReset}).
      *
      * @param name - Command name
      * @param params - Command parameters

package/dist/daemon/session/Session.js

@@ -11,8 +11,10 @@ import { connectCDP, navigateToTarget } from './cdpSetup.js';
 import { externalChromePort, findPageTarget, setupChromeConnection, } from './chromeConnection.js';
 import { startTelemetryCollectors } from './collectors.js';
 import { createCommandRegistry } from './commandRegistry.js';
+import { withMatchedStylesReset } from './matchedStylesReset.js';
 import { teardownSession } from './teardown.js';
 import { CommandError } from '../../errors/index.js';
+import { unknownSessionCommandMessage } from '../../errors/messages.js';
 import { applySessionEmulation } from '../../runtime/page/emulation.js';
 import { readPageLoadingState } from '../../runtime/page/loadingState.js';
 import { reapOrphanedChrome, removeSessionFiles } from '../../session/cleanup/staleSession.js';
@@ -151,7 +153,8 @@ export class Session {
      * Execute a registered command against this session. After a renderer
      * crash only {@link RUN_ON_CRASHED_PAGE} commands run (`bdg cdp` only for
      * {@link CRASH_SAFE_CDP} methods); others fail with exit 107 instead of
-     * waiting for a page that cannot answer.
+     * waiting for a page that cannot answer. Commands that may change the page
+     * drop `dom inspect`'s kept matched rules ({@link withMatchedStylesReset}).
      *
      * @param name - Command name
      * @param params - Command parameters
@@ -168,7 +171,12 @@ export class Session {
         if (crashedAt !== undefined && needsPage) {
             return Promise.reject(pageCrashedCommandError(crashedAt));
         }
-        return this.registry[name](this.cdp, params);
+        if (!Object.hasOwn(this.registry, name)) {
+            return Promise.reject(new CommandError(unknownSessionCommandMessage(name), {}, EXIT_CODES.INVALID_ARGUMENTS));
+        }
+        const handler = this.registry[name];
+        const cdp = this.cdp;
+        return withMatchedStylesReset(cdp, name, () => handler(cdp, params));
     }
     /**
      * Summary of this session for start responses.

package/dist/daemon/session/TelemetryStore.d.ts

@@ -1,9 +1,16 @@
 import type { DialogInfo } from '../../ipc/protocol/domTypes.js';
 import type { NavigationEvent } from '../../telemetry/navigation.js';
 import type { PendingRequest } from '../../telemetry/network.js';
+import type { NetworkEvictions } from '../../telemetry/networkRetention.js';
 import type { CDPTarget, ConsoleMessage, NetworkRequest, TelemetryType, WebSocketConnection } from '../../types.js';
 export declare class TelemetryStore {
+    /**
+     * Finished requests, oldest first: the newest are kept, so the session's
+     * `networkEvictions.requestsDropped` oldest ones are gone
+     */
     readonly networkRequests: NetworkRequest[];
+    /** Requests dropped and response bodies evicted at the capture limits */
+    readonly networkEvictions: NetworkEvictions;
     /** Requests still in flight, keyed by CDP requestId */
     readonly pendingNetworkRequests: Map<string, PendingRequest>;
     readonly consoleMessages: ConsoleMessage[];

package/dist/daemon/session/TelemetryStore.js

@@ -1,7 +1,13 @@
 import { MAX_CONSOLE_MESSAGES } from '../../constants.js';
 import { dialogConsoleText } from '../../ui/messages/commands.js';
 export class TelemetryStore {
+    /**
+     * Finished requests, oldest first: the newest are kept, so the session's
+     * `networkEvictions.requestsDropped` oldest ones are gone
+     */
     networkRequests = [];
+    /** Requests dropped and response bodies evicted at the capture limits */
+    networkEvictions = { requestsDropped: 0, bodiesEvicted: 0 };
     /** Requests still in flight, keyed by CDP requestId */
     pendingNetworkRequests = new Map();
     consoleMessages = [];

package/dist/daemon/session/commandRegistry.js

@@ -21,7 +21,7 @@ import { evaluateInBdgWorld, sendForBdgScript } from '../../runtime/page/bdgWorl
 import { emulatePage, pageAppearance } from '../../runtime/page/emulation.js';
 import { readDocumentReadyState } from '../../runtime/page/loadingState.js';
 import { navigatePage } from '../../runtime/page/navigation.js';
-import { skippedBodyReason } from '../../telemetry/network.js';
+import { skippedBodyReason } from '../../telemetry/networkRetention.js';
 import { consoleMessageDroppedError } from '../../ui/messages/consoleMessages.js';
 import { sessionCommand } from '../../ui/messages/sessionCommand.js';
 import { EXIT_CODES } from '../../utils/exitCodes.js';
@@ -140,6 +140,20 @@ function webSocketAsRequest(connection) {
         webSocket: { frames: connection.frames, ...(closedTime !== undefined && { closedTime }) },
     };
 }
+/**
+ * Status activity counts of what the network capture let go at its limits,
+ * left out when nothing was.
+ *
+ * @param store - Telemetry store
+ * @returns `networkRequestsDropped` and `networkBodiesEvicted` when non-zero
+ */
+function networkEvictionActivity(store) {
+    const { requestsDropped, bodiesEvicted } = store.networkEvictions;
+    return {
+        ...(requestsDropped > 0 && { networkRequestsDropped: requestsDropped }),
+        ...(bodiesEvicted > 0 && { networkBodiesEvicted: bodiesEvicted }),
+    };
+}
 /**
  * All captured network activity: finished and in-flight requests and
  * WebSocket connections, in start order.
@@ -319,6 +333,7 @@ export function createCommandRegistry(store, emulation) {
             const totalNetwork = allNetwork.length;
             const totalConsole = store.consoleMessages.length;
             const dropped = store.consoleDropped;
+            const { requestsDropped, bodiesEvicted } = store.networkEvictions;
             const networkBounds = calculateSliceBounds(totalNetwork, lastN, offset);
             const consoleBounds = calculateSliceBounds(totalConsole, lastN, offset);
             const recentNetwork = params.only === 'console'
@@ -347,6 +362,8 @@ export function createCommandRegistry(store, emulation) {
                 totalNetwork,
                 totalConsole,
                 ...(dropped > 0 && { droppedConsole: dropped }),
+                ...(requestsDropped > 0 && { droppedNetwork: requestsDropped }),
+                ...(bodiesEvicted > 0 && { evictedNetworkBodies: bodiesEvicted }),
                 hasMoreNetwork: networkBounds.start > 0,
                 hasMoreConsole: consoleBounds.start > 0,
             });
@@ -377,12 +394,13 @@ export function createCommandRegistry(store, emulation) {
                         : { crashedAt: store.pageCrashedAt }),
                 },
                 activeTelemetry: store.activeTelemetry,
-                activity: filterDefined({
+                activity: {
                     networkRequestsCaptured: store.networkRequests.length,
                     consoleMessagesCaptured: store.consoleMessages.length,
-                    lastNetworkRequestAt: lastNetworkRequest?.timestamp,
-                    lastConsoleMessageAt: lastConsoleMessage?.timestamp,
-                }),
+                    ...(lastNetworkRequest && { lastNetworkRequestAt: lastNetworkRequest.timestamp }),
+                    ...(lastConsoleMessage && { lastConsoleMessageAt: lastConsoleMessage.timestamp }),
+                    ...networkEvictionActivity(store),
+                },
                 navigationId: store.getCurrentNavigationId?.() ?? 0,
             };
             return result;

package/dist/daemon/session/matchedStylesReset.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `dom inspect` keeps slow matched-rules answers for a few seconds, but page
+ * state such as `:checked`, `:hover` or `:focus` changes without any CDP
+ * event. Every daemon command that may change the page drops them, before
+ * and after it runs. Hooking the commands rather than the CDP methods they
+ * send keeps `dom inspect`'s own page scripts from clearing its answers, and
+ * listing the read-only commands makes a new command reset by default.
+ */
+import type { CDPConnection } from '../../connection/cdp.js';
+import type { CommandName } from '../../ipc/index.js';
+/**
+ * Commands that leave the page as it is: they read it, or only the telemetry.
+ * Any command not listed (new ones included) resets by default.
+ */
+export declare const KEEPS_MATCHED_STYLES: ReadonlySet<CommandName>;
+/**
+ * Run a command, dropping the kept matched rules before and after it unless
+ * it leaves the page as it is.
+ *
+ * @param cdp - CDP connection
+ * @param name - Command name
+ * @param run - The command
+ * @returns Its result
+ */
+export declare function withMatchedStylesReset<T>(cdp: CDPConnection, name: CommandName, run: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=matchedStylesReset.d.ts.map