browser-debugger-cli 0.13.0 → 0.14.0

package/dist/ui/formatters/preview.js

@@ -1,12 +1,15 @@
-import { RESOURCE_TYPE_ABBREVIATIONS, MIME_TYPE_RULES } from '../../constants.js';
-import { buildSuccessResponse } from '../OutputBuilder.js';
-import { formatTimestamp } from './console/shared.js';
+import { MAX_CONSOLE_TEXT_LENGTH, MIME_TYPE_RULES, RESOURCE_TYPE_ABBREVIATIONS, } from '../../constants.js';
+import { buildSuccessResponse, stringifyEnvelope } from '../OutputBuilder.js';
+import { capMessageText, formatTimestamp } from './console/shared.js';
+import { capForDisplay } from './longValues.js';
 import { failureReason, formatRequestStatus, getRequestState, } from './requestStatus.js';
 import { OutputFormatter, truncateUrl, truncateText } from '../formatting.js';
-import { withPageCrashedNote } from '../messages/commands.js';
-import { PREVIEW_EMPTY_STATES, PREVIEW_HEADERS, compactTipsMessage, verboseCommandsMessage, } from '../messages/preview.js';
+import { moreCharsNote, withPageCrashedNote } from '../messages/commands.js';
 import { consoleDroppedNote } from '../messages/consoleMessages.js';
+import { networkEvictedNote } from '../messages/networkMessages.js';
+import { PREVIEW_EMPTY_STATES, PREVIEW_HEADERS, compactTipsMessage, verboseCommandsMessage, } from '../messages/preview.js';
 import { sessionCommand } from '../messages/sessionCommand.js';
+import { capLength } from '../../utils/strings.js';
 /**
  * Infer resource type from MIME type when CDP doesn't provide it.
  *
@@ -55,7 +58,8 @@ export function formatPreview(output, options) {
     return formatPreviewHumanReadable(output, options);
 }
 /**
- * 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)
@@ -73,7 +77,10 @@ export function buildPreviewJsonData(output, options) {
         ...(output.totals && { totals: output.totals }),
         ...(output.pageCrashedAt !== undefined && { pageCrashedAt: output.pageCrashedAt }),
         ...(pick('network') && output.data.network && { network: last(output.data.network) }),
-        ...(pick('console') && output.data.console && { console: last(output.data.console) }),
+        ...(pick('console') &&
+            output.data.console && {
+            console: last(output.data.console)?.map((message) => capMessageText(message, options.full)),
+        }),
     };
 }
 /**
@@ -81,12 +88,12 @@ export function buildPreviewJsonData(output, options) {
  *
  * @param output - Preview output
  * @param options - Preview options
- * @returns `{ version, success, data }` envelope, pretty-printed, or on one
- *   line in follow mode (one object per line, NDJSON)
+ * @returns `{ version, success, data }` envelope, indented on a terminal, and
+ *   always on one line in follow mode (one object per line, NDJSON)
  */
 function formatPreviewAsJson(output, options) {
     const envelope = buildSuccessResponse(buildPreviewJsonData(output, options));
-    return options.follow ? JSON.stringify(envelope) : JSON.stringify(envelope, null, 2);
+    return options.follow ? JSON.stringify(envelope) : stringifyEnvelope(envelope);
 }
 /**
  * Format preview as human-readable output, after a warning when the page
@@ -98,6 +105,24 @@ function formatPreviewHumanReadable(output, options) {
         : formatPreviewCompact(output, options);
     return withPageCrashedNote(body, output.pageCrashedAt);
 }
+/**
+ * A console message text in the compact preview: cut like `console --list`
+ * cuts it and to its first two lines, or whole with `--full`. The pointer
+ * naming `--full` comes after the line cut, so it is always shown.
+ *
+ * @param text - Message text
+ * @param full - `--full`
+ * @returns Text to print
+ */
+function compactConsoleText(text, full) {
+    if (full)
+        return text;
+    const capped = capLength(text, MAX_CONSOLE_TEXT_LENGTH);
+    const shown = truncateText(capped.text, 2);
+    return capped.truncatedFrom === undefined
+        ? shown
+        : `${shown}${moreCharsNote(capped.truncatedFrom - capped.text.length)}`;
+}
 /**
  * Format preview in compact format (default)
  * Token-efficient output optimized for AI agents
@@ -119,6 +144,9 @@ function formatPreviewCompact(output, options) {
             const totalCount = output.totals?.network ?? output.data.network.length;
             const limitHint = formatLimitHint(showingCount, totalCount);
             fmt.text(`NETWORK (${showingCount}/${totalCount})${limitHint}:`);
+            const evictedNote = previewEvictedNote(output);
+            if (evictedNote)
+                fmt.text(`  ${evictedNote}`);
             if (requests.length === 0) {
                 if (options.filteredTypes &&
                     options.filteredTypes.length > 0 &&
@@ -159,8 +187,7 @@ function formatPreviewCompact(output, options) {
             else {
                 const consoleLines = messages.map((msg) => {
                     const prefix = msg.type.toUpperCase().padEnd(5);
-                    const text = truncateText(msg.text, 2);
-                    return `${prefix} ${text}`;
+                    return `${prefix} ${compactConsoleText(msg.text, options.full)}`;
                 });
                 fmt.list(consoleLines, 2);
             }
@@ -172,6 +199,18 @@ function formatPreviewCompact(output, options) {
     }
     return fmt.build();
 }
+/**
+ * Note that the session dropped requests or evicted bodies at its capture limits.
+ *
+ * @param output - Preview output with its totals
+ * @returns Note text, or undefined when nothing was let go
+ */
+function previewEvictedNote(output) {
+    return networkEvictedNote({
+        requestsDropped: output.totals?.networkDropped ?? 0,
+        bodiesEvicted: output.totals?.networkBodiesEvicted ?? 0,
+    });
+}
 /**
  * Format preview in verbose format (opt-in with --verbose)
  * Original human-friendly output with Unicode formatting
@@ -198,6 +237,9 @@ function formatPreviewVerbose(output, options) {
                 ? `Network Requests (all ${requests.length})`
                 : `Network Requests (last ${requests.length} of ${output.totals?.network ?? output.data.network.length})`;
             fmt.text(title).separator('━', 50);
+            const evictedNote = previewEvictedNote(output);
+            if (evictedNote)
+                fmt.text(evictedNote);
             if (requests.length === 0) {
                 if (options.filteredTypes &&
                     options.filteredTypes.length > 0 &&
@@ -248,7 +290,7 @@ function formatPreviewVerbose(output, options) {
             else {
                 messages.forEach((msg) => {
                     const icon = msg.type === 'error' ? 'ERR' : msg.type === 'warning' ? 'WARN' : 'INFO';
-                    fmt.text(`${icon} [${msg.type}] ${msg.text}`);
+                    fmt.text(`${icon} [${msg.type}] ${capForDisplay(msg.text, MAX_CONSOLE_TEXT_LENGTH, options.full)}`);
                 });
             }
             fmt.blank();

package/dist/ui/formatters/status.js

@@ -2,6 +2,7 @@ import { describeRunningChrome } from '../../session/chrome.js';
 import { calculateDuration, formatTimeAgo } from '../../session/statusData.js';
 import { OutputFormatter } from '../formatting.js';
 import { colorSchemeLabel, sessionActiveLine } from '../messages/commands.js';
+import { networkEvictedNote } from '../messages/networkMessages.js';
 import { lastSessionEndText } from '../messages/session.js';
 import { noActiveSessionMessage, sessionCommand } from '../messages/sessionCommand.js';
 import { isProcessAlive } from '../../utils/process.js';
@@ -51,6 +52,12 @@ export function formatSessionStatus(metadata, pid, activity, pageState, verbose
         if (activity.lastNetworkRequestAt) {
             fmt.keyValue('  Last Request', formatTimeAgo(activity.lastNetworkRequestAt), 18);
         }
+        const evictedNote = networkEvictedNote({
+            requestsDropped: activity.networkRequestsDropped ?? 0,
+            bodiesEvicted: activity.networkBodiesEvicted ?? 0,
+        });
+        if (evictedNote)
+            fmt.text(`  ${evictedNote}`);
         fmt.keyValue('Console Messages', `${activity.consoleMessagesCaptured} captured`, 18);
         if (activity.lastConsoleMessageAt) {
             fmt.keyValue('  Last Message', formatTimeAgo(activity.lastConsoleMessageAt), 18);

package/dist/ui/formatters/triggeredRequests.js

@@ -1,6 +1,7 @@
 /**
  * Human output of the network requests a DOM action triggered.
  */
+import { MAX_TRIGGERED_REQUESTS } from '../../constants.js';
 import { assetTypeNames, isNotableRequest } from '../../telemetry/requestKinds.js';
 import { formatRequestStatus } from './requestStatus.js';
 import { formatDuration, truncateUrl } from '../formatting.js';
@@ -57,7 +58,7 @@ export function formatTriggeredRequestLines(requests, omitted = 0) {
     const lines = notable.slice(0, MAX_TRIGGERED_REQUESTS_SHOWN).map(formatTriggeredRequest);
     const hidden = notable.length - lines.length + omitted;
     if (hidden > 0)
-        lines.push(omitted > 0 ? moreRequestsNote(hidden) : moreMatchesNote(hidden));
+        lines.push(omitted > 0 ? moreRequestsNote(hidden) : moreMatchesNote(hidden, MAX_TRIGGERED_REQUESTS));
     if (assets.length > 0)
         lines.push(assetRequestsNote(assets.length, assetTypeNames(assets)));
     return lines;

package/dist/ui/messages/chrome.d.ts

@@ -158,9 +158,28 @@ export declare function chromeBinaryOverrideIsDirectory(path: string, source: st
  * Generate error when CDP port is already in use.
  *
  * @param port - Port number that is in use
+ * @param reason - What was found on the port, when known
  * @returns Multi-line formatted error message with troubleshooting steps
  */
-export declare function portInUseError(port: number): string;
+export declare function portInUseError(port: number, reason?: string): string;
+/**
+ * Why a launched Chrome is not the one answering on 127.0.0.1:<port>.
+ *
+ * @param answeredBy - What answers there: a different browser, another
+ *   process, or nothing (the address is held but does not answer)
+ * @param chromeHost - Address the launched Chrome listens on
+ * @returns Reason for the PORT_IN_USE issue
+ */
+export declare function portTakenByReason(answeredBy: 'browser' | 'process' | 'nothing', chromeHost: string): string;
+/**
+ * Why a launch failed when Chrome announced its port but did not answer on
+ * it in time (a slow start, not a port conflict).
+ *
+ * @param port - Port Chrome announced
+ * @param waitedMs - How long bdg waited
+ * @returns Reason for the CHROME_LAUNCH_FAILED issue
+ */
+export declare function chromeNotAnsweringReason(port: number, waitedMs: number): string;
 /**
  * Warning when bdg's Chrome preferences (password manager and leak check
  * off, etc.) could not be written into the profile.

package/dist/ui/messages/chrome.js

@@ -37,7 +37,7 @@ export function formatChromeIssue(issue) {
     const ctx = issue.context ?? {};
     switch (issue.code) {
         case 'PORT_IN_USE':
-            return portInUseError(ctx['port']);
+            return portInUseError(ctx['port'], ctx['reason']);
         case 'INVALID_PORT':
             return invalidPortError(ctx['port']);
         case 'USER_DATA_DIR_CREATE_FAILED':
@@ -274,10 +274,36 @@ export function chromeBinaryOverrideIsDirectory(path, source) {
  * Generate error when CDP port is already in use.
  *
  * @param port - Port number that is in use
+ * @param reason - What was found on the port, when known
  * @returns Multi-line formatted error message with troubleshooting steps
  */
-export function portInUseError(port) {
-    return joinLines(`Port ${port} is already in use.\n`, 'Another program (or a Chrome left from a previous session) is listening on it.\n', 'Try:', `  - Use a different port: ${sessionCommand(`bdg <url> --port ${port + 1}`)}`, `  - If a bdg session holds it: find it with bdg sessions, then end that one: bdg stop --session <name> (bdg cleanup --force --session <name> if it is stuck)`, `  - See what uses the port: lsof -i :${port}`);
+export function portInUseError(port, reason) {
+    return joinLines(reason ? `Port ${port} is already in use: ${reason}.\n` : `Port ${port} is already in use.\n`, 'Another program (or a Chrome left from a previous session) is listening on it.\n', 'Try:', `  - Use a different port: ${sessionCommand(`bdg <url> --port ${port + 1}`)}`, `  - If a bdg session holds it: find it with bdg sessions, then end that one: bdg stop --session <name> (bdg cleanup --force --session <name> if it is stuck)`, `  - See what uses the port: lsof -i :${port}`);
+}
+/**
+ * Why a launched Chrome is not the one answering on 127.0.0.1:<port>.
+ *
+ * @param answeredBy - What answers there: a different browser, another
+ *   process, or nothing (the address is held but does not answer)
+ * @param chromeHost - Address the launched Chrome listens on
+ * @returns Reason for the PORT_IN_USE issue
+ */
+export function portTakenByReason(answeredBy, chromeHost) {
+    if (answeredBy === 'nothing')
+        return `something holds 127.0.0.1 (Chrome fell back to ${chromeHost})`;
+    const other = answeredBy === 'browser' ? 'another browser' : 'another process';
+    return `${other} answers on 127.0.0.1 (Chrome listens on ${chromeHost})`;
+}
+/**
+ * Why a launch failed when Chrome announced its port but did not answer on
+ * it in time (a slow start, not a port conflict).
+ *
+ * @param port - Port Chrome announced
+ * @param waitedMs - How long bdg waited
+ * @returns Reason for the CHROME_LAUNCH_FAILED issue
+ */
+export function chromeNotAnsweringReason(port, waitedMs) {
+    return `Chrome announced port ${port} but did not answer on 127.0.0.1 within ${(waitedMs / 1000).toFixed(1)}s (slow start)`;
 }
 /**
  * Warning when bdg's Chrome preferences (password manager and leak check

package/dist/ui/messages/commands.d.ts

@@ -134,14 +134,13 @@ export declare function valueMismatchWarning(mismatch: FillValueMismatch): strin
  */
 export declare const CLICK_NOT_RECEIVED_WARNING = "The click may not have reached the element: the page saw no mouse press (the browser may be showing a dialog or bubble that captures input)";
 /**
- * Note under a shortened list of matches.
+ * Note under a shortened human list whose JSON output lists more, up to a cap.
  *
- * @param hidden - Matches not listed
- * @param jsonLimit - How many JSON output lists, when it leaves some out too
- * @returns e.g. "... and 1174 more (use --json for all)",
- *   "... and 8980 more (--json lists the first 100)"
+ * @param hidden - Items not listed
+ * @param jsonLimit - Most items the JSON output lists
+ * @returns e.g. "... and 8980 more (--json lists up to 100)"
  */
-export declare function moreMatchesNote(hidden: number, jsonLimit?: number): string;
+export declare function moreMatchesNote(hidden: number, jsonLimit: number): string;
 /**
  * Note under `dom query` matches cut by `--limit`.
  *
@@ -158,6 +157,20 @@ export declare function queryMoreMatchesNote(omitted: number, indexed?: number):
  * @returns e.g. `Visibility is checked for the first 100 matches only; bdg dom layout <index> checks any of them`
  */
 export declare function queryViewportCheckedNote(checked: number): string;
+/**
+ * First line under an accessibility tree cut by `--limit` or `--depth`.
+ *
+ * @param listed - Nodes listed
+ * @returns e.g. "Showing the first 50 nodes (text boxes and repeated text left out)"
+ */
+export declare function a11yTreeShownNote(listed: number): string;
+/**
+ * How to see the rest of an accessibility tree cut by `--limit` or `--depth`.
+ *
+ * @param omitted - Nodes left out
+ * @returns e.g. "51391 more: --limit 0 lists all, --depth <n> limits the levels, or search with bdg dom a11y query \"role:<role>\""
+ */
+export declare function a11yTreeMoreNote(omitted: number): string;
 /**
  * Note under a list of a11y query matches cut by `--limit`.
  *
@@ -362,10 +375,11 @@ export declare function coverText(cover: string, transparent: boolean | undefine
  * Note when `bdg dom inspect` could not read the element's matched rules, so
  * no hints, rules or why were computed.
  *
- * @param reason - `timeout` (very large stylesheets) or `failed` (Chrome reported an error)
+ * @param reason - `timeout` (very large stylesheets), `failed` (Chrome reported
+ *   an error) or `skipped` (hints not read: an earlier read on this page timed out)
  * @returns Note
  */
-export declare function inspectCascadeNote(reason: 'timeout' | 'failed'): string;
+export declare function inspectCascadeNote(reason: 'timeout' | 'failed' | 'skipped'): string;
 /**
  * Note of `bdg dom inspect` when the selector named a pseudo-element: its
  * element is inspected and the pseudo-element is on the `pseudo` line.
@@ -835,5 +849,12 @@ export declare const CSS_SEARCH_HELP_EXAMPLES = "\nExamples:\n  bdg css search -
  * @returns Note
  */
 export declare function helpJsonDetailsNote(): string;
+/**
+ * Pointer after a value cut for human output.
+ *
+ * @param count - Characters left out
+ * @returns e.g. `… 299800 more chars (use --full)`
+ */
+export declare function moreCharsNote(count: number): string;
 export {};
 //# sourceMappingURL=commands.d.ts.map

package/dist/ui/messages/commands.js

@@ -193,16 +193,14 @@ export function valueMismatchWarning(mismatch) {
  */
 export const CLICK_NOT_RECEIVED_WARNING = 'The click may not have reached the element: the page saw no mouse press (the browser may be showing a dialog or bubble that captures input)';
 /**
- * Note under a shortened list of matches.
+ * Note under a shortened human list whose JSON output lists more, up to a cap.
  *
- * @param hidden - Matches not listed
- * @param jsonLimit - How many JSON output lists, when it leaves some out too
- * @returns e.g. "... and 1174 more (use --json for all)",
- *   "... and 8980 more (--json lists the first 100)"
+ * @param hidden - Items not listed
+ * @param jsonLimit - Most items the JSON output lists
+ * @returns e.g. "... and 8980 more (--json lists up to 100)"
  */
 export function moreMatchesNote(hidden, jsonLimit) {
-    const where = jsonLimit === undefined ? 'use --json for all' : `--json lists the first ${jsonLimit}`;
-    return `... and ${hidden} more (${where})`;
+    return `... and ${hidden} more (--json lists up to ${jsonLimit})`;
 }
 /**
  * Note under `dom query` matches cut by `--limit`.
@@ -225,6 +223,24 @@ export function queryMoreMatchesNote(omitted, indexed) {
 export function queryViewportCheckedNote(checked) {
     return `Visibility is checked for the first ${checked} matches only; ${sessionCommand('bdg dom layout <index>')} checks any of them`;
 }
+/**
+ * First line under an accessibility tree cut by `--limit` or `--depth`.
+ *
+ * @param listed - Nodes listed
+ * @returns e.g. "Showing the first 50 nodes (text boxes and repeated text left out)"
+ */
+export function a11yTreeShownNote(listed) {
+    return `Showing the first ${listed} nodes (text boxes and repeated text left out)`;
+}
+/**
+ * How to see the rest of an accessibility tree cut by `--limit` or `--depth`.
+ *
+ * @param omitted - Nodes left out
+ * @returns e.g. "51391 more: --limit 0 lists all, --depth <n> limits the levels, or search with bdg dom a11y query \"role:<role>\""
+ */
+export function a11yTreeMoreNote(omitted) {
+    return `${omitted} more: --limit 0 lists all, --depth <n> limits the levels, or search with bdg dom a11y query "role:<role>"`;
+}
 /**
  * Note under a list of a11y query matches cut by `--limit`.
  *
@@ -585,10 +601,13 @@ export function coverText(cover, transparent) {
  * Note when `bdg dom inspect` could not read the element's matched rules, so
  * no hints, rules or why were computed.
  *
- * @param reason - `timeout` (very large stylesheets) or `failed` (Chrome reported an error)
+ * @param reason - `timeout` (very large stylesheets), `failed` (Chrome reported
+ *   an error) or `skipped` (hints not read: an earlier read on this page timed out)
  * @returns Note
  */
 export function inspectCascadeNote(reason) {
+    if (reason === 'skipped')
+        return "hints skipped: this page's stylesheets are slow to read (--rules waits 5 s)";
     return reason === 'timeout'
         ? "CSS rules not read: the page's stylesheets took too long (hints wait 1 s; --rules and --why 5 s)"
         : 'CSS rules not read: Chrome could not report the rules matching this element';
@@ -1279,4 +1298,13 @@ Examples:
 export function helpJsonDetailsNote() {
     return 'Option behaviors, defaults, choices and examples: bdg <command> --help --json (e.g. bdg dom query --help --json). Everything at once: bdg --help --json --full';
 }
+/**
+ * Pointer after a value cut for human output.
+ *
+ * @param count - Characters left out
+ * @returns e.g. `… 299800 more chars (use --full)`
+ */
+export function moreCharsNote(count) {
+    return `… ${count} more chars (use --full)`;
+}
 //# sourceMappingURL=commands.js.map

package/dist/ui/messages/networkMessages.d.ts

@@ -3,6 +3,30 @@
  *
  * User-facing messages for the network list command output and formatting.
  */
+/**
+ * Why a stored response body was replaced by a placeholder (shown by
+ * `bdg details network <id>` as `bodyNotCaptured`).
+ *
+ * @param budgetBytes - Total body budget of the session
+ * @returns e.g. `evicted: total body budget (bdg keeps the newest 100 MB of response bodies)`
+ */
+export declare function bodyEvictedReason(budgetBytes: number): string;
+/** What a session's network capture let go at its limits */
+export interface NetworkEvictionCounts {
+    /** Oldest finished requests dropped at the request cap */
+    requestsDropped: number;
+    /** Oldest response bodies evicted at the body budget */
+    bodiesEvicted: number;
+}
+/**
+ * Note that the session dropped its oldest requests or evicted its oldest
+ * response bodies at its limits.
+ *
+ * @param counts - Requests dropped and bodies evicted
+ * @returns e.g. `⚠ 2000 older network requests were dropped: bdg keeps the newest 10000`;
+ *   undefined when nothing was let go
+ */
+export declare function networkEvictedNote(counts: NetworkEvictionCounts): string | undefined;
 /**
  * Generate message for following network output.
  *

package/dist/ui/messages/networkMessages.js

@@ -3,6 +3,51 @@
  *
  * User-facing messages for the network list command output and formatting.
  */
+import { MAX_NETWORK_REQUESTS, MAX_TOTAL_BODY_BYTES } from '../../constants.js';
+import { pluralize } from '../formatting.js';
+/**
+ * A byte budget in whole megabytes.
+ *
+ * @param bytes - Budget
+ * @returns e.g. `100 MB`
+ */
+function megabytes(bytes) {
+    return `${Math.round(bytes / (1024 * 1024))} MB`;
+}
+/**
+ * Why a stored response body was replaced by a placeholder (shown by
+ * `bdg details network <id>` as `bodyNotCaptured`).
+ *
+ * @param budgetBytes - Total body budget of the session
+ * @returns e.g. `evicted: total body budget (bdg keeps the newest 100 MB of response bodies)`
+ */
+export function bodyEvictedReason(budgetBytes) {
+    return `evicted: total body budget (bdg keeps the newest ${megabytes(budgetBytes)} of response bodies)`;
+}
+/**
+ * Note that the session dropped its oldest requests or evicted its oldest
+ * response bodies at its limits.
+ *
+ * @param counts - Requests dropped and bodies evicted
+ * @returns e.g. `⚠ 2000 older network requests were dropped: bdg keeps the newest 10000`;
+ *   undefined when nothing was let go
+ */
+export function networkEvictedNote(counts) {
+    const { requestsDropped, bodiesEvicted } = counts;
+    const requests = pluralize(requestsDropped, 'older network request');
+    const bodies = pluralize(bodiesEvicted, 'older response body', 'older response bodies');
+    const budget = megabytes(MAX_TOTAL_BODY_BYTES);
+    if (requestsDropped > 0 && bodiesEvicted > 0) {
+        return `⚠ ${requests} dropped, ${bodies} evicted: bdg keeps the newest ${MAX_NETWORK_REQUESTS} requests and ${budget} of bodies`;
+    }
+    if (requestsDropped > 0) {
+        return `⚠ ${requests} ${requestsDropped === 1 ? 'was' : 'were'} dropped: bdg keeps the newest ${MAX_NETWORK_REQUESTS}`;
+    }
+    if (bodiesEvicted > 0) {
+        return `⚠ ${bodies} ${bodiesEvicted === 1 ? 'was' : 'were'} evicted: bdg keeps the newest ${budget} of bodies`;
+    }
+    return undefined;
+}
 /**
  * Generate message for following network output.
  *

package/dist/utils/http.d.ts

@@ -1,5 +1,12 @@
 import type { CDPTarget } from '../types.js';
 import type { Logger } from '../ui/logging/index.js';
+/**
+ * Timeout for CDP HTTP requests in milliseconds.
+ *
+ * Chrome's HTTP API should respond quickly when running.
+ * A 5-second timeout helps detect when Chrome is not responding.
+ */
+export declare const CDP_HTTP_TIMEOUT_MS = 5000;
 /**
  * Options for CDP HTTP target fetch.
  */
@@ -47,10 +54,10 @@ export type DevToolsProbe = {
  *
  * @param port - Chrome debugging port
  * @param logger - Optional logger for debug output
- * @param options - Host and HTTPS
+ * @param options - Host, HTTPS and request timeout
  * @returns What answered
  */
-export declare function probeDevToolsEndpoint(port: number, logger?: Logger, options?: Pick<FetchCDPTargetsOptions, 'host' | 'secure'>): Promise<DevToolsProbe>;
+export declare function probeDevToolsEndpoint(port: number, logger?: Logger, options?: FetchCDPTargetsOptions): Promise<DevToolsProbe>;
 /**
  * The browser-level DevTools WebSocket URL of a Chrome (`/json/version`).
  *

package/dist/utils/http.js

@@ -6,7 +6,7 @@ import { getErrorMessage } from './errors.js';
  * Chrome's HTTP API should respond quickly when running.
  * A 5-second timeout helps detect when Chrome is not responding.
  */
-const CDP_HTTP_TIMEOUT_MS = 5000;
+export const CDP_HTTP_TIMEOUT_MS = 5000;
 /**
  * Fetch CDP targets from Chrome's HTTP API.
  *
@@ -67,14 +67,15 @@ export async function fetchCDPTargets(port = DEFAULT_CDP_PORT, logger, options)
  *
  * @param port - Chrome debugging port
  * @param logger - Optional logger for debug output
- * @param options - Host and HTTPS
+ * @param options - Host, HTTPS and request timeout
  * @returns What answered
  */
 export async function probeDevToolsEndpoint(port, logger, options) {
     const url = `${options?.secure ? 'https' : 'http'}://${options?.host ?? HTTP_LOCALHOST}:${port}/json/version`;
+    const timeoutMs = options?.timeoutMs ?? CDP_HTTP_TIMEOUT_MS;
     let response;
     try {
-        response = await fetch(url, { signal: AbortSignal.timeout(CDP_HTTP_TIMEOUT_MS) });
+        response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
     }
     catch (error) {
         logger?.debug(`Chrome version request failed: ${getErrorMessage(error)} (${url})`);

package/dist/utils/strings.d.ts

@@ -11,4 +11,23 @@
  * @returns Truncated text with ellipsis if needed
  */
 export declare function truncateByLength(text: string, maxLength?: number): string;
+/**
+ * A text cut to a maximum length, with its original length when it was cut.
+ */
+export interface CappedText {
+    /** The text, or its first `maxLength` characters */
+    text: string;
+    /** Original length, set only when the text was cut */
+    truncatedFrom?: number;
+}
+/**
+ * Cut a text to its first `maxLength` characters (UTF-16 code units),
+ * keeping the original length (the `truncatedFrom` of JSON output). A
+ * surrogate pair (an emoji) is never split: the cut ends before it.
+ *
+ * @param text - Text to cut
+ * @param maxLength - Characters kept (at most)
+ * @returns The text, with `truncatedFrom` when it was cut
+ */
+export declare function capLength(text: string, maxLength: number): CappedText;
 //# sourceMappingURL=strings.d.ts.map

package/dist/utils/strings.js

@@ -20,4 +20,20 @@ export function truncateByLength(text, maxLength = DEFAULT_MAX_LENGTH) {
     }
     return text.slice(0, maxLength - 1) + '…';
 }
+/**
+ * Cut a text to its first `maxLength` characters (UTF-16 code units),
+ * keeping the original length (the `truncatedFrom` of JSON output). A
+ * surrogate pair (an emoji) is never split: the cut ends before it.
+ *
+ * @param text - Text to cut
+ * @param maxLength - Characters kept (at most)
+ * @returns The text, with `truncatedFrom` when it was cut
+ */
+export function capLength(text, maxLength) {
+    if (text.length <= maxLength)
+        return { text };
+    const lastKept = text.charCodeAt(maxLength - 1);
+    const end = lastKept >= 0xd800 && lastKept <= 0xdbff ? maxLength - 1 : maxLength;
+    return { text: text.slice(0, end), truncatedFrom: text.length };
+}
 //# sourceMappingURL=strings.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browser-debugger-cli",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "DevTools telemetry in your terminal. For humans and agents. Direct WebSocket to Chrome's debugging port.",
   "type": "module",
   "bin": {
@@ -27,7 +27,7 @@
     "validate:ts-version": "node -e \"const ts = require('typescript'); const v = ts.version.split('.'); if (parseInt(v[0]) < 5 || (parseInt(v[0]) === 5 && parseInt(v[1]) < 6)) { console.error('Requires TypeScript 5.6+, found:', ts.version); process.exit(1); } else { console.log('✅ TypeScript version:', ts.version); }\"",
     "check": "npm run format:check && npm run type-check && npm run lint",
     "check:enhanced": "npm run format:check && npm run type-check && npm run lint && npm run validate:module-type && npm run validate:ts-version",
-    "test": "tsx --test 'src/**/__tests__/**/!(*.smoke).test.ts'",
+    "test": "tsx --test --test-timeout=120000 'src/**/__tests__/**/!(*.smoke).test.ts'",
     "test:watch": "tsx --test --watch 'src/**/__tests__/**/!(*.smoke).test.ts'",
     "test:coverage": "c8 npm test",
     "test:smoke": "tsx --test --test-concurrency=1 'src/__tests__/smoke/*.smoke.test.ts'",