browser-debugger-cli 0.12.0 → 0.14.0

package/dist/ui/formatters/console/summarize.js

@@ -2,15 +2,40 @@
  * Smart summary view: prioritises errors and warnings with deduplication
  * and shows info/debug/other as count-only footer entries.
  */
+import { MAX_CONSOLE_TEXT_LENGTH } from '../../../constants.js';
+import { capForDisplay } from '../longValues.js';
 import { OutputFormatter, pluralize } from '../../formatting.js';
-import { analyzeMessages, formatCountPrefix, formatSectionHeader, formatSourceLocation, } from './shared.js';
-function renderErrorSection(fmt, errors, total) {
+import { consoleDroppedNote, consoleMoreGroupsNote } from '../../messages/consoleMessages.js';
+import { analyzeMessages, formatCountPrefix, formatSectionHeader, formatSourceLocation, newestGroups, } from './shared.js';
+/**
+ * A message's text cut like `console --list` cuts it, or whole with `--full`.
+ *
+ * @param message - Message
+ * @param full - `--full`
+ * @returns Text to print
+ */
+function messageText(message, full) {
+    return capForDisplay(message.text, MAX_CONSOLE_TEXT_LENGTH, full);
+}
+/**
+ * The errors: the newest distinct ones, with a note for the earlier ones.
+ *
+ * @param fmt - Output
+ * @param errors - Distinct errors in order of first appearance
+ * @param total - Errors logged
+ * @param limit - Distinct errors listed (0 = all)
+ * @param full - Print the texts whole (`--full`)
+ */
+function renderErrorSection(fmt, errors, total, limit, full) {
     if (errors.length === 0)
         return;
+    const { shown, more } = newestGroups(errors, limit);
     fmt.text(formatSectionHeader('Errors', errors.length, total));
     fmt.separator('─', 30);
-    for (const { message, count } of errors) {
-        fmt.text(`${formatCountPrefix(count)}${message.text}`);
+    if (more > 0)
+        fmt.text(consoleMoreGroupsNote(more, 'error')).blank();
+    for (const { message, count } of shown) {
+        fmt.text(`${formatCountPrefix(count)}${messageText(message, full)}`);
         const source = formatSourceLocation(message.stackTrace);
         if (source) {
             fmt.text(`     → ${source}`);
@@ -18,13 +43,25 @@ function renderErrorSection(fmt, errors, total) {
         fmt.blank();
     }
 }
-function renderWarningSection(fmt, warnings, total) {
+/**
+ * The warnings: the newest distinct ones, with a note for the earlier ones.
+ *
+ * @param fmt - Output
+ * @param warnings - Distinct warnings in order of first appearance
+ * @param total - Warnings logged
+ * @param limit - Distinct warnings listed (0 = all)
+ * @param full - Print the texts whole (`--full`)
+ */
+function renderWarningSection(fmt, warnings, total, limit, full) {
     if (warnings.length === 0)
         return;
+    const { shown, more } = newestGroups(warnings, limit);
     fmt.text(formatSectionHeader('Warnings', warnings.length, total));
     fmt.separator('─', 30);
-    for (const { message, count } of warnings) {
-        fmt.text(`• ${formatCountPrefix(count)}${message.text}`);
+    if (more > 0)
+        fmt.text(consoleMoreGroupsNote(more, 'warning'));
+    for (const { message, count } of shown) {
+        fmt.text(`• ${formatCountPrefix(count)}${messageText(message, full)}`);
         const source = formatSourceLocation(message.stackTrace);
         if (source)
             fmt.text(`     → ${source}`);
@@ -43,16 +80,25 @@ function renderOtherSummary(fmt, summary) {
     }
 }
 /**
- * Format console output as smart summary (default mode).
+ * Format console output as smart summary (default mode): the newest distinct
+ * errors and warnings, counts of the rest, and a note when the session
+ * dropped its oldest messages.
+ *
+ * @param messages - Messages to summarise
+ * @param options - Distinct messages listed, messages dropped and `--full`
+ * @returns Summary
  */
-export function formatConsoleSummary(messages) {
+export function formatConsoleSummary(messages, options = {}) {
     const fmt = new OutputFormatter();
     const { grouped, summary } = analyzeMessages(messages);
     fmt.text('Console Summary');
     fmt.separator('━', 60);
+    if (options.dropped)
+        fmt.text(consoleDroppedNote(options.dropped));
     fmt.blank();
-    renderErrorSection(fmt, grouped.errors, summary.errors.total);
-    renderWarningSection(fmt, grouped.warnings, summary.warnings.total);
+    const { groupLimit, full } = options;
+    renderErrorSection(fmt, grouped.errors, summary.errors.total, groupLimit, full);
+    renderWarningSection(fmt, grouped.warnings, summary.warnings.total, groupLimit, full);
     if (grouped.errors.length === 0 && grouped.warnings.length === 0) {
         fmt.text('No errors or warnings found');
         fmt.blank();

package/dist/ui/formatters/console.d.ts

@@ -11,12 +11,13 @@ export type { ConsoleFormatOptions, ConsoleJsonOutput, ConsoleLevel, ConsoleSkip
 export { LEVEL_MAP } from './console/shared.js';
 export { formatConsoleChronological, lastMessages } from './console/chronological.js';
 export { formatConsoleFollowLines } from './console/follow.js';
-export { buildConsoleJsonOutput, formatConsoleJson } from './console/json.js';
+export { buildConsoleJsonOutput } from './console/json.js';
 export { formatConsoleSummary } from './console/summarize.js';
 /**
  * Format console output based on options. Routes to the per-mode formatter:
  * a `--level` filter lists the matching messages (the summary only shows
- * errors and warnings, so it would hide e.g. `--level info`).
+ * errors and warnings, so it would hide e.g. `--level info`). The text
+ * starts with a warning when the page crashed.
  */
 export declare function formatConsole(messages: ConsoleMessage[], options: ConsoleFormatOptions): string;
 //# sourceMappingURL=console.d.ts.map

package/dist/ui/formatters/console.js

@@ -5,26 +5,24 @@
  * the `formatConsole` dispatcher. The per-mode implementations live in
  * `./console/`.
  */
+import { withPageCrashedNote } from '../messages/commands.js';
 import { formatConsoleChronological } from './console/chronological.js';
-import { formatConsoleJson } from './console/json.js';
 import { formatConsoleSummary } from './console/summarize.js';
 export { LEVEL_MAP } from './console/shared.js';
 export { formatConsoleChronological, lastMessages } from './console/chronological.js';
 export { formatConsoleFollowLines } from './console/follow.js';
-export { buildConsoleJsonOutput, formatConsoleJson } from './console/json.js';
+export { buildConsoleJsonOutput } from './console/json.js';
 export { formatConsoleSummary } from './console/summarize.js';
 /**
  * Format console output based on options. Routes to the per-mode formatter:
  * a `--level` filter lists the matching messages (the summary only shows
- * errors and warnings, so it would hide e.g. `--level info`).
+ * errors and warnings, so it would hide e.g. `--level info`). The text
+ * starts with a warning when the page crashed.
  */
 export function formatConsole(messages, options) {
-    if (options.json) {
-        return formatConsoleJson(messages, options);
-    }
-    if (options.list || options.level) {
-        return formatConsoleChronological(messages, options);
-    }
-    return formatConsoleSummary(messages);
+    const body = options.list || options.level
+        ? formatConsoleChronological(messages, options)
+        : formatConsoleSummary(messages, options);
+    return withPageCrashedNote(body, options.pageCrashedAt);
 }
 //# sourceMappingURL=console.js.map

package/dist/ui/formatters/details.js

@@ -1,4 +1,4 @@
-import { skippedBodyReason } from '../../telemetry/network.js';
+import { skippedBodyReason } from '../../telemetry/networkRetention.js';
 import { formatFramePosition, formatTimestamp } from './console/shared.js';
 import { headerValueLines } from './networkHeaders.js';
 import { formatRequestStatus } from './requestStatus.js';
@@ -184,13 +184,15 @@ function requestSummaryRows(request) {
 }
 /**
  * Add a header block, a header sent several times one value per line
- * ({@link headerValueLines}).
+ * ({@link headerValueLines}); nothing when there are no headers.
  *
  * @param fmt - Formatter
  * @param title - Block title
  * @param headers - Headers to list
  */
 function addHeaders(fmt, title, headers) {
+    if (Object.keys(headers).length === 0)
+        return;
     fmt.text(title).separator('━', 70);
     Object.entries(headers).forEach(([key, value]) => headerValueLines(key, value).forEach((line) => fmt.text(`  ${key}: ${line}`)));
     fmt.blank();

package/dist/ui/formatters/dom.d.ts

@@ -6,7 +6,7 @@ import type { DomQueryResult, DomGetResult, ScreenshotResult } from '../../types
  * Displays found nodes with their index, tag, identifying attributes
  * ({@link queryTagAttributes}), classes, and preview text
  * (plus where they are when outside the viewport or hidden, e.g.
- * `(below fold)`), up to {@link QUERY_DISPLAY_LIMIT} of them (no match is an error, exit 83).
+ * `(below fold)`), as many as `--limit` listed, with a note for the rest (no match is an error, exit 83).
  * One line of next commands follows; they take the match's index, so they
  * work for matches in shadow roots and iframes too.
  *
@@ -33,10 +33,13 @@ export declare function formatDomQuery(data: DomQueryResult): string;
 /**
  * Format DOM get results for human-readable output.
  *
- * Displays full outerHTML for matched elements. For single elements, shows HTML directly.
- * For multiple elements, shows numbered list with HTML for each.
+ * Displays the outerHTML of matched elements, each cut to its first
+ * {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`. For
+ * single elements, shows HTML directly. For multiple elements, shows
+ * numbered list with HTML for each.
  *
  * @param data - DOM get result containing array of nodes with outerHTML
+ * @param options - `full` to print the HTML whole
  * @returns Formatted output string
  *
  * @example
@@ -59,7 +62,9 @@ export declare function formatDomQuery(data: DomQueryResult): string;
  * // [1] <span class="error">Error 2</span>
  * ```
  */
-export declare function formatDomGet(data: DomGetResult): string;
+export declare function formatDomGet(data: DomGetResult, options?: {
+    full?: boolean | undefined;
+}): string;
 /**
  * Format DOM eval results for human-readable output.
  *
@@ -69,9 +74,11 @@ export declare function formatDomGet(data: DomGetResult): string;
  * JSON-quoted. Other values are formatted JSON, and values Chrome only
  * describes (functions, DOM nodes) their description. The iframe it ran in
  * (`--frame`) is reported on stderr, so stdout stays the bare value. `--json`
- * output is unchanged (the value in `data.result`).
+ * output is unchanged (the value in `data.result`). The text is cut to its
+ * first {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`.
  *
  * @param data - DOM eval result containing the evaluated value
+ * @param options - `full` to print the value whole
  * @returns The string, or formatted JSON
  *
  * @example
@@ -90,6 +97,8 @@ export declare function formatDomGet(data: DomGetResult): string;
 export declare function formatDomEval(data: {
     result: unknown;
     type?: string;
+}, options?: {
+    full?: boolean | undefined;
 }): string;
 /**
  * Format the page's iframes, one per line, nested frames indented below

package/dist/ui/formatters/dom.js

@@ -1,15 +1,15 @@
+import { MAX_VALUE_LENGTH } from '../../constants.js';
 import { keyAttributeItems } from './keyAttributes.js';
+import { capForDisplay } from './longValues.js';
 import { OutputFormatter } from '../formatting.js';
-import { frameLabel, moreMatchesNote, framesStillLoadingNote, noFramesMessage, queryNextSteps, screenshotGrownNote, screenshotScaledNote, viewportPositionHint, } from '../messages/commands.js';
-/** Matches listed in human output (JSON has all of them) */
-const QUERY_DISPLAY_LIMIT = 50;
+import { frameLabel, framesStillLoadingNote, noFramesMessage, queryMoreMatchesNote, queryViewportCheckedNote, queryNextSteps, screenshotGrownNote, screenshotScaledNote, viewportPositionHint, } from '../messages/commands.js';
 /**
  * Format DOM query results for human-readable output.
  *
  * Displays found nodes with their index, tag, identifying attributes
  * ({@link queryTagAttributes}), classes, and preview text
  * (plus where they are when outside the viewport or hidden, e.g.
- * `(below fold)`), up to {@link QUERY_DISPLAY_LIMIT} of them (no match is an error, exit 83).
+ * `(below fold)`), as many as `--limit` listed, with a note for the rest (no match is an error, exit 83).
  * One line of next commands follows; they take the match's index, so they
  * work for matches in shadow roots and iframes too.
  *
@@ -35,7 +35,7 @@ const QUERY_DISPLAY_LIMIT = 50;
 export function formatDomQuery(data) {
     const { count, nodes, selector } = data;
     const fmt = new OutputFormatter();
-    const nodeLines = nodes.slice(0, QUERY_DISPLAY_LIMIT).map((node) => {
+    const nodeLines = nodes.map((node) => {
         const attributes = queryTagAttributes(node)
             .map((item) => ` ${item}`)
             .join('');
@@ -49,7 +49,8 @@ export function formatDomQuery(data) {
     return fmt
         .text(`Found ${count} node${count === 1 ? '' : 's'} matching "${selector}":`)
         .list(nodeLines)
-        .list(count > QUERY_DISPLAY_LIMIT ? [moreMatchesNote(count - QUERY_DISPLAY_LIMIT)] : [])
+        .list(data.omitted ? [queryMoreMatchesNote(data.omitted, data.indexed)] : [])
+        .list(data.viewportChecked ? [queryViewportCheckedNote(data.viewportChecked)] : [])
         .tip(queryNextSteps(exampleIndex))
         .build();
 }
@@ -76,10 +77,13 @@ function queryTagAttributes(node) {
 /**
  * Format DOM get results for human-readable output.
  *
- * Displays full outerHTML for matched elements. For single elements, shows HTML directly.
- * For multiple elements, shows numbered list with HTML for each.
+ * Displays the outerHTML of matched elements, each cut to its first
+ * {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`. For
+ * single elements, shows HTML directly. For multiple elements, shows
+ * numbered list with HTML for each.
  *
  * @param data - DOM get result containing array of nodes with outerHTML
+ * @param options - `full` to print the HTML whole
  * @returns Formatted output string
  *
  * @example
@@ -102,15 +106,16 @@ function queryTagAttributes(node) {
  * // [1] <span class="error">Error 2</span>
  * ```
  */
-export function formatDomGet(data) {
+export function formatDomGet(data, options = {}) {
     const { nodes } = data;
+    const html = (node) => capForDisplay(node.outerHTML ?? '', MAX_VALUE_LENGTH, options.full);
     if (nodes.length === 1) {
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return nodes[0].outerHTML ?? '';
+        return html(nodes[0]);
     }
     const fmt = new OutputFormatter();
     nodes.forEach((node, i) => {
-        fmt.text(`[${i}] ${node.outerHTML}`);
+        fmt.text(`[${i}] ${html(node)}`);
     });
     return fmt.build();
 }
@@ -123,9 +128,11 @@ export function formatDomGet(data) {
  * JSON-quoted. Other values are formatted JSON, and values Chrome only
  * describes (functions, DOM nodes) their description. The iframe it ran in
  * (`--frame`) is reported on stderr, so stdout stays the bare value. `--json`
- * output is unchanged (the value in `data.result`).
+ * output is unchanged (the value in `data.result`). The text is cut to its
+ * first {@link MAX_VALUE_LENGTH} characters with a pointer naming `--full`.
  *
  * @param data - DOM eval result containing the evaluated value
+ * @param options - `full` to print the value whole
  * @returns The string, or formatted JSON
  *
  * @example
@@ -141,7 +148,17 @@ export function formatDomGet(data) {
  * // }
  * ```
  */
-export function formatDomEval(data) {
+export function formatDomEval(data, options = {}) {
+    return capForDisplay(evalResultText(data), MAX_VALUE_LENGTH, options.full);
+}
+/**
+ * An eval result as text: a string as is unless it would read as another
+ * value, else formatted JSON.
+ *
+ * @param data - DOM eval result
+ * @returns Text of the value
+ */
+function evalResultText(data) {
     if (data.type === 'undefined')
         return 'undefined';
     const { result } = data;

package/dist/ui/formatters/helpFormatters.js

@@ -17,7 +17,7 @@ import { section } from '../formatting.js';
 export function buildAgentDiscoveryHelp() {
     const counts = getProtocolCounts();
     return section('For AI Agents:', [
-        'bdg --help --json          Machine-readable command schema',
+        'bdg --help --json          Commands, flags, exit codes (bdg <cmd> --help --json: details)',
         `bdg cdp --list             List all ${counts.domains} CDP domains`,
         `bdg cdp --search <term>    Search ${counts.methods} CDP methods`,
     ]);

package/dist/ui/formatters/inspect.js

@@ -212,6 +212,9 @@ function fontParts(text) {
 }
 /**
  * A contrast as words, e.g. `contrast 4.47 fail on #fff (faded: opacity 0.4)`.
+ * An approximate one gets no pass/fail level, only the estimate and why
+ * (`contrast ≈1 on #fff (approximate: img.hero behind)`): what is behind
+ * the text is not a known color.
  *
  * @param contrast - Contrast
  * @returns Words, or undefined
@@ -221,10 +224,9 @@ function contrastText(contrast) {
         return undefined;
     return [
         contrast.approximate
-            ? `contrast ≈${contrast.ratio} ${contrast.level}`
+            ? `contrast ≈${contrast.ratio}`
             : `contrast ${contrast.ratio} ${contrast.level}`,
         `on ${contrast.background}`,
-        contrast.overImage && '(over image)',
         contrast.opacity !== undefined && `(faded: opacity ${contrast.opacity})`,
         contrast.approximate && `(approximate: ${contrast.approximate.join(', ')})`,
     ]
@@ -274,7 +276,7 @@ function fillText(fill) {
         .join(' ');
 }
 /**
- * The fill line: backgrounds, opacity and blend mode.
+ * The fill line: backgrounds (and that they are clipped to gradient text), opacity and blend mode.
  *
  * @param data - Inspect result
  * @returns Line
@@ -286,6 +288,10 @@ function fillLine(data) {
         paint &&
             `stroke ${paint.stroke}${paint.strokeWidth !== undefined ? ` ${paint.strokeWidth}` : ''}`,
         ...(data.fills ?? []).map(fillText),
+        data.text?.gradientFill &&
+            !data.text.holder &&
+            (data.fills ?? []).length > 0 &&
+            'clipped to the text',
         data.opacity !== undefined && `opacity ${data.opacity}`,
         data.blend && `blend ${data.blend}`,
     ]);

package/dist/ui/formatters/installSkill.d.ts

@@ -1,6 +1,14 @@
 import type { InstalledSkill } from '../../types.js';
 /**
- * Format where the skill was installed, one line per agent.
+ * Format the targets the skill was written for, as a failed install lists
+ * the ones that succeeded.
+ *
+ * @param skills - Install results
+ * @returns Human-readable lines
+ */
+export declare function formatSkillTargets(skills: InstalledSkill[]): string;
+/**
+ * Format where the skill was installed, plus what to do next.
  *
  * @param data - Install results
  * @returns Human-readable summary

package/dist/ui/formatters/installSkill.js

@@ -1,5 +1,8 @@
 import { homedir } from 'os';
 import { OutputFormatter } from '../formatting.js';
+import { skillBackupMessage } from '../messages/commands.js';
+/** Indent of the path column, so a backup line sits under the path it belongs to */
+const PATH_INDENT = ' '.repeat(2 + 6 + 2 + 9 + 2);
 /**
  * Shorten a path under the home directory to `~/...`.
  *
@@ -11,17 +14,40 @@ function tildePath(path) {
     return path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
 }
 /**
- * Format where the skill was installed, one line per agent.
+ * Add where the skill was installed, one line per agent, plus where a
+ * replaced copy was kept.
+ *
+ * @param fmt - Formatter to add the lines to
+ * @param skills - Install results
+ * @returns The formatter
+ */
+function addSkillTargets(fmt, skills) {
+    fmt.text('bdg skill:');
+    for (const skill of skills) {
+        fmt.text(`  ${skill.target.padEnd(6)}  ${skill.status.padEnd(9)}  ${tildePath(skill.path)}`);
+        if (skill.backup)
+            fmt.text(`${PATH_INDENT}${skillBackupMessage(tildePath(skill.backup))}`);
+    }
+    return fmt;
+}
+/**
+ * Format the targets the skill was written for, as a failed install lists
+ * the ones that succeeded.
+ *
+ * @param skills - Install results
+ * @returns Human-readable lines
+ */
+export function formatSkillTargets(skills) {
+    return addSkillTargets(new OutputFormatter(), skills).build();
+}
+/**
+ * Format where the skill was installed, plus what to do next.
  *
  * @param data - Install results
  * @returns Human-readable summary
  */
 export function formatInstalledSkills(data) {
-    const fmt = new OutputFormatter().text('bdg skill:');
-    for (const skill of data.skills) {
-        fmt.text(`  ${skill.target.padEnd(6)}  ${skill.status.padEnd(9)}  ${tildePath(skill.path)}`);
-    }
-    return fmt
+    return addSkillTargets(new OutputFormatter(), data.skills)
         .hints('Next:', [
         'Start a new agent session to load it (running sessions keep the old list)',
         'After upgrading bdg, run bdg install-skill again',

package/dist/ui/formatters/layout.js

@@ -1,9 +1,10 @@
 /**
  * Human-readable output of `bdg dom layout`.
  */
+import { LAYOUT_ELEMENT_LIMIT } from '../../constants.js';
 import { indexSourceText } from '../../errors/messages.js';
 import { OutputFormatter } from '../formatting.js';
-import { coverText, indexLayoutHeadline, layoutHeadline, layoutPositionLabel, moreMatchesNote, pageLayoutLine, } from '../messages/commands.js';
+import { coverText, indexLayoutHeadline, layoutHeadline, layoutPositionLabel, maskedText, moreMatchesNote, pageLayoutLine, } from '../messages/commands.js';
 /** Elements listed in human output (JSON has up to 100) */
 const LAYOUT_DISPLAY_LIMIT = 20;
 /**
@@ -26,6 +27,7 @@ export function layoutLine(element, viewport) {
         element.coveredBy && coverText(element.coveredBy, element.coverTransparent),
         element.inert && 'inert',
         element.invisible,
+        element.masked && maskedText(element.masked),
         element.context && element.context !== element.clippedBy && `in ${element.context}`,
     ]
         .filter(Boolean)
@@ -47,7 +49,7 @@ export function formatLayout(data) {
         ? indexLayoutHeadline(indexSourceText(data.indexSource))
         : layoutHeadline(data.count, data.elements.length + (data.omitted ?? 0), data.selector))
         .list(shown.map((element) => layoutLine(element, data.page.viewport)))
-        .list(more > 0 ? [moreMatchesNote(more, data.omitted ? data.elements.length : undefined)] : [])
+        .list(more > 0 ? [moreMatchesNote(more, LAYOUT_ELEMENT_LIMIT)] : [])
         .build();
 }
 //# sourceMappingURL=layout.js.map

package/dist/ui/formatters/longValues.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Long values in human output: cut, with a pointer naming `--full`.
+ */
+/**
+ * A value for human output: its first `maxLength` characters followed by
+ * how many more there are, or all of it with `--full`.
+ *
+ * @param text - Value
+ * @param maxLength - Characters printed
+ * @param full - `--full`: print it whole
+ * @returns Text to print
+ */
+export declare function capForDisplay(text: string, maxLength: number, full?: boolean): string;
+//# sourceMappingURL=longValues.d.ts.map

package/dist/ui/formatters/longValues.js

@@ -0,0 +1,23 @@
+/**
+ * Long values in human output: cut, with a pointer naming `--full`.
+ */
+import { moreCharsNote } from '../messages/commands.js';
+import { capLength } from '../../utils/strings.js';
+/**
+ * A value for human output: its first `maxLength` characters followed by
+ * how many more there are, or all of it with `--full`.
+ *
+ * @param text - Value
+ * @param maxLength - Characters printed
+ * @param full - `--full`: print it whole
+ * @returns Text to print
+ */
+export function capForDisplay(text, maxLength, full) {
+    if (full)
+        return text;
+    const capped = capLength(text, maxLength);
+    return capped.truncatedFrom === undefined
+        ? text
+        : `${capped.text}${moreCharsNote(capped.truncatedFrom - capped.text.length)}`;
+}
+//# sourceMappingURL=longValues.js.map

package/dist/ui/formatters/networkList.d.ts

@@ -5,6 +5,7 @@
  * with support for filtering results display.
  */
 import type { NetworkRequest } from '../../types.js';
+import { type NetworkEvictionCounts } from '../messages/networkMessages.js';
 export interface NetworkListOptions {
     verbose?: boolean;
     /** Start of the current page, which the START column counts from ({@link pageStartOf}) */
@@ -13,6 +14,8 @@ export interface NetworkListOptions {
     totalCount?: number;
     /** Requests matching the filters, before --last (defaults to totalCount) */
     filteredCount?: number;
+    /** Requests dropped and bodies evicted at the session's capture limits */
+    evictions?: NetworkEvictionCounts;
 }
 /**
  * When the current page started loading: the request of its document, in
@@ -41,16 +44,19 @@ export declare function pageStartOf(requests: NetworkRequest[]): PageStart | und
 export declare function formatStartOffset(request: NetworkRequest, pageStart: PageStart | undefined): string;
 /**
  * Rows of the network stream: requests that finished since the last poll,
- * with the column header the first time.
+ * with the column header the first time (the stream banner is on stderr),
+ * after the dropped/evicted note when the counts changed.
  *
  * @param requests - Newly finished requests
- * @param options - `header` the first time; `verbose` for full URLs; the page start for START
+ * @param options - `header` the first time; `verbose` for full URLs; the page start for
+ *   START; `evictions` only when the session's counts changed since the last poll
  * @returns Text to print (empty when there is nothing new)
  */
 export declare function formatNetworkFollowRows(requests: NetworkRequest[], options?: {
     header?: boolean;
     verbose?: boolean;
     pageStart?: PageStart;
+    evictions?: NetworkEvictionCounts;
 }): string;
 /**
  * Format network requests for display.

package/dist/ui/formatters/networkList.js

@@ -7,6 +7,7 @@
 import { getResourceTypeAbbr } from './preview.js';
 import { getRequestState } from './requestStatus.js';
 import { OutputFormatter, truncateUrl } from '../formatting.js';
+import { networkEvictedNote } from '../messages/networkMessages.js';
 const SIZE_UNITS = ['B', 'KB', 'MB', 'GB'];
 const SEPARATOR_WIDTH = 80;
 function formatSize(bytes) {
@@ -154,6 +155,9 @@ function formatNetworkListHuman(requests, options) {
     const header = buildHeader(requests.length, options.filteredCount ?? totalCount, totalCount);
     fmt.text(header);
     fmt.separator('─', SEPARATOR_WIDTH);
+    const evictedNote = options.evictions && networkEvictedNote(options.evictions);
+    if (evictedNote)
+        fmt.text(evictedNote);
     if (requests.length === 0) {
         fmt.text('No matching requests found.');
         return fmt.build();
@@ -170,17 +174,21 @@ function formatNetworkListHuman(requests, options) {
 const FOLLOW_ID_WIDTH = 14;
 /**
  * Rows of the network stream: requests that finished since the last poll,
- * with the column header the first time.
+ * with the column header the first time (the stream banner is on stderr),
+ * after the dropped/evicted note when the counts changed.
  *
  * @param requests - Newly finished requests
- * @param options - `header` the first time; `verbose` for full URLs; the page start for START
+ * @param options - `header` the first time; `verbose` for full URLs; the page start for
+ *   START; `evictions` only when the session's counts changed since the last poll
  * @returns Text to print (empty when there is nothing new)
  */
 export function formatNetworkFollowRows(requests, options = {}) {
     const fmt = new OutputFormatter();
     const widths = columnWidths(requests, FOLLOW_ID_WIDTH);
+    const evictedNote = options.evictions && networkEvictedNote(options.evictions);
+    if (evictedNote)
+        fmt.text(evictedNote);
     if (options.header) {
-        fmt.text('Streaming network requests... (Ctrl+C to stop)');
         fmt.text(formatColumnHeader(widths));
         fmt.separator('─', SEPARATOR_WIDTH);
     }

package/dist/ui/formatters/preview.d.ts

@@ -39,6 +39,8 @@ export interface PreviewOptions {
     filteredTypes?: string[] | undefined;
     /** Total network requests before filtering (for showing feedback when no matches). */
     unfilteredNetworkCount?: number | undefined;
+    /** Console message texts whole instead of cut (`--full`). */
+    full?: boolean | undefined;
 }
 /**
  * Format preview output (peek command)
@@ -53,11 +55,14 @@ export interface PreviewJsonData {
     target: BdgOutput['target'];
     partial?: boolean;
     totals?: BdgOutput['totals'];
+    /** When the page's renderer crashed (epoch ms), while it is not loaded again */
+    pageCrashedAt?: number;
     network?: BdgOutput['data']['network'];
     console?: BdgOutput['data']['console'];
 }
 /**
- * Build the JSON payload for a preview, honoring the section and `--last` filters.
+ * Build the JSON payload for a preview, honoring the section and `--last`
+ * filters; console texts are cut with `truncatedFrom` unless `--full`.
  *
  * @param output - Preview output from the daemon
  * @param options - Preview options (section filters, last N)