browser-debugger-cli 0.15.0 → 0.16.0

package/dist/index.js

@@ -54,6 +54,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 import { readFileSync } from "fs";
 import { createRequire } from "module";
 import { dirname, join } from "path";
+function getBundledProtocolVersion() {
+  const packageJson = JSON.parse(
+    readFileSync(require2.resolve("devtools-protocol/package.json"), "utf-8")
+  );
+  return packageJson.version;
+}
 function loadProtocol() {
   if (cachedProtocol) {
     return cachedProtocol;
@@ -83,6 +89,10 @@ function findCommand(domainName, commandName) {
   const normalized = commandName.toLowerCase();
   return domain.commands.find((c) => c.name.toLowerCase() === normalized);
 }
+function findType(domainName, typeName) {
+  const normalized = typeName.toLowerCase();
+  return findDomain(domainName)?.types?.find((t) => t.id.toLowerCase() === normalized);
+}
 function normalizeMethod(input) {
   const [domainName, commandName] = input.split(".");
   if (!domainName || !commandName) {
@@ -115,6 +125,7 @@ __export(schema_exports, {
   getDomainSummary: () => getDomainSummary,
   getMethodSchema: () => getMethodSchema,
   getProtocolCounts: () => getProtocolCounts,
+  getTypeSchema: () => getTypeSchema,
   searchMethods: () => searchMethods
 });
 function getMethodSchema(domainName, methodName) {
@@ -129,47 +140,86 @@ function getMethodSchema(domainName, methodName) {
   return buildMethodSchema(domain.domain, command);
 }
 function buildMethodSchema(domainName, command) {
-  const parameters = command.parameters?.map(paramToSchema) ?? [];
+  const parameters = command.parameters?.map((p) => paramToSchema(domainName, p)) ?? [];
   const returns = command.returns?.map(returnToSchema) ?? [];
-  const example = {
-    command: `bdg cdp ${domainName}.${command.name}`
-  };
-  if (parameters.length > 0) {
-    const exampleParams = {};
-    parameters.forEach((p) => {
-      if (!p.required) return;
-      exampleParams[p.name] = getExampleValue(p);
-    });
-    if (Object.keys(exampleParams).length > 0) {
-      example.params = exampleParams;
-      example.command += ` --params '${JSON.stringify(exampleParams)}'`;
-    }
-  }
+  const redirect = buildRedirect(command);
+  const exampleSource = parameters.length > 0 ? parameters : redirect?.parameters ?? [];
   const schema = {
     name: `${domainName}.${command.name}`,
     domain: domainName,
     method: command.name,
     parameters,
     returns,
-    example
+    example: buildExample(`${domainName}.${command.name}`, exampleSource)
   };
+  if (redirect) schema.redirect = redirect;
   if (command.description) schema.description = command.description;
   if (command.experimental) schema.experimental = command.experimental;
   if (command.deprecated) schema.deprecated = command.deprecated;
   return schema;
 }
-function paramToSchema(param) {
+function buildRedirect(command) {
+  if (!command.redirect) return void 0;
+  const target = findCommand(command.redirect, command.name);
+  return {
+    method: `${command.redirect}.${command.name}`,
+    resolved: target !== void 0,
+    parameters: target?.parameters?.map((p) => paramToSchema(command.redirect ?? "", p)) ?? []
+  };
+}
+function buildExample(methodName, parameters) {
+  const example = { command: `bdg cdp ${methodName}` };
+  const required = parameters.filter((p) => p.required);
+  if (required.length === 0) return example;
+  const exampleParams = Object.fromEntries(required.map((p) => [p.name, getExampleValue(p)]));
+  example.params = exampleParams;
+  example.command += ` --params '${JSON.stringify(exampleParams)}'`;
+  return example;
+}
+function lookupRef(domainName, ref) {
+  const [refDomain, id] = ref.includes(".") ? ref.split(".") : [domainName, ref];
+  const type = refDomain && id ? findType(refDomain, id) : void 0;
+  return type && { name: `${refDomain}.${type.id}`, type };
+}
+function paramToSchema(domainName, param) {
   const schema = {
     name: param.name,
     type: resolveType(param),
     required: !param.optional
   };
+  const referenced = param.$ref ? lookupRef(domainName, param.$ref) : void 0;
+  const values = param.enum ?? referenced?.type.enum;
   if (param.description) schema.description = param.description;
   if (param.deprecated) schema.deprecated = param.deprecated;
-  if (param.enum) schema.enum = param.enum;
+  if (param.experimental) schema.experimental = param.experimental;
+  if (values) schema.enum = values;
+  if (referenced) {
+    schema.ref = referenced.name;
+    schema.refType = referenced.type.type;
+  }
   if (param.items) schema.items = resolveType(param.items);
   return schema;
 }
+function getTypeSchema(domainName, typeName) {
+  const domain = findDomain(domainName);
+  const type = domain && findType(domain.domain, typeName);
+  if (!domain || !type) return void 0;
+  const schema = {
+    name: `${domain.domain}.${type.id}`,
+    domain: domain.domain,
+    id: type.id,
+    baseType: type.type
+  };
+  if (type.description) schema.description = type.description;
+  if (type.experimental) schema.experimental = type.experimental;
+  if (type.deprecated) schema.deprecated = type.deprecated;
+  if (type.enum) schema.enum = type.enum;
+  if (type.items) schema.items = resolveType(type.items);
+  if (type.properties) {
+    schema.properties = type.properties.map((p) => paramToSchema(domain.domain, p));
+  }
+  return schema;
+}
 function returnToSchema(ret) {
   const schema = {
     name: ret.name,
@@ -190,12 +240,16 @@ function getExampleValue(param) {
   if (param.enum && param.enum.length > 0) {
     return param.enum[0];
   }
-  switch (param.type) {
+  const type = param.refType ?? param.type;
+  const named = Object.hasOwn(EXAMPLE_VALUES, param.name) ? EXAMPLE_VALUES[param.name] : void 0;
+  const namedType = typeof named === "number" ? ["integer", "number"] : ["string"];
+  if (named !== void 0 && namedType.includes(type)) return named;
+  switch (type) {
     case "string":
       return "example";
     case "integer":
     case "number":
-      return 0;
+      return 1;
     case "boolean":
       return true;
     case "array":
@@ -265,11 +319,22 @@ function searchMethods(query) {
   });
   return [...named, ...described];
 }
-var SEARCH_KEYWORDS;
+var EXAMPLE_VALUES, SEARCH_KEYWORDS;
 var init_schema = __esm({
   "src/cdp/schema.ts"() {
     "use strict";
     init_protocol();
+    EXAMPLE_VALUES = {
+      width: 1280,
+      height: 800,
+      x: 100,
+      y: 100,
+      deviceScaleFactor: 1,
+      scale: 1,
+      timeout: 5e3,
+      responseCode: 200,
+      url: "https://example.com"
+    };
     SEARCH_KEYWORDS = {
       "Emulation.setDeviceMetricsOverride": [
         "viewport",
@@ -292,38 +357,6 @@ var init_schema = __esm({
   }
 });
 
-// src/commands/dom/screenshotResize.ts
-function calculateImageTokens(width, height) {
-  return Math.ceil(width * height / PIXELS_PER_TOKEN);
-}
-function calculateResizeScale(width, height) {
-  const longestEdge = Math.max(width, height);
-  if (longestEdge <= MAX_EDGE_PX) {
-    return 1;
-  }
-  return MAX_EDGE_PX / longestEdge;
-}
-function isTallPage(width, height) {
-  if (width === 0) return false;
-  return height / width > TALL_PAGE_THRESHOLD;
-}
-function shouldResize(width, height, noResize) {
-  if (noResize) {
-    return false;
-  }
-  const longestEdge = Math.max(width, height);
-  return longestEdge > MAX_EDGE_PX;
-}
-var MAX_EDGE_PX, PIXELS_PER_TOKEN, TALL_PAGE_THRESHOLD;
-var init_screenshotResize = __esm({
-  "src/commands/dom/screenshotResize.ts"() {
-    "use strict";
-    MAX_EDGE_PX = 1568;
-    PIXELS_PER_TOKEN = 750;
-    TALL_PAGE_THRESHOLD = 3;
-  }
-});
-
 // node_modules/escape-string-regexp/index.js
 var require_escape_string_regexp = __commonJS({
   "node_modules/escape-string-regexp/index.js"(exports, module) {
@@ -960,7 +993,7 @@ var require_node = __commonJS({
     var tty2 = __require("tty");
     var util = __require("util");
     exports.init = init;
-    exports.log = log36;
+    exports.log = log33;
     exports.formatArgs = formatArgs;
     exports.save = save;
     exports.load = load;
@@ -1095,7 +1128,7 @@ var require_node = __commonJS({
       }
       return (/* @__PURE__ */ new Date()).toISOString() + " ";
     }
-    function log36(...args) {
+    function log33(...args) {
       return process.stderr.write(util.formatWithOptions(exports.inspectOpts, ...args) + "\n");
     }
     function save(namespaces) {
@@ -1422,8 +1455,8 @@ function createLogger(context) {
   logger.debug = (message) => logMessage(message, "debug");
   return logger;
 }
-function logDebugError(log36, context, error) {
-  log36.debug(`Failed to ${context}: ${getErrorMessage(error)}`);
+function logDebugError(log33, context, error) {
+  log33.debug(`Failed to ${context}: ${getErrorMessage(error)}`);
 }
 var debugEnabled;
 var init_logger = __esm({
@@ -1569,6 +1602,9 @@ function getDaemonSocketPath() {
 function ensureSessionDir() {
   makeDirectory(getSessionDir(), PRIVATE_DIR_MODE);
 }
+function getSessionDownloadsDir() {
+  return path3.join(getSessionDir(), DOWNLOADS_DIR);
+}
 function sessionDirChain(dir) {
   const base = getSessionBaseDir();
   const relative2 = path3.relative(base, dir);
@@ -1635,7 +1671,7 @@ function secureSessionDir(dir = getSessionDir()) {
   }
   return null;
 }
-var log, SESSION_FILES, SESSION_DIR_OVERRIDE_ENV, SESSION_NAME_ENV, NAMED_SESSIONS_DIR, MAX_SOCKET_PATH_BYTES, MAX_DAEMON_SOCKET_PATH_BYTES, SESSION_STATE_FILES, PRIVATE_DIR_MODE, GROUP_OTHER_ACCESS, SESSION_DIR_TRUST;
+var log, SESSION_FILES, SESSION_DIR_OVERRIDE_ENV, SESSION_NAME_ENV, NAMED_SESSIONS_DIR, MAX_SOCKET_PATH_BYTES, MAX_DAEMON_SOCKET_PATH_BYTES, SESSION_STATE_FILES, PRIVATE_DIR_MODE, GROUP_OTHER_ACCESS, DOWNLOADS_DIR, SESSION_DIR_TRUST;
 var init_paths = __esm({
   "src/session/paths.ts"() {
     "use strict";
@@ -1665,6 +1701,7 @@ var init_paths = __esm({
     ];
     PRIVATE_DIR_MODE = 448;
     GROUP_OTHER_ACCESS = 63;
+    DOWNLOADS_DIR = "downloads";
     SESSION_DIR_TRUST = { allowGroupWrite: true };
   }
 });
@@ -1800,48 +1837,6 @@ var init_atomicFile = __esm({
   }
 });
 
-// src/session/metadata.ts
-import * as fs8 from "fs";
-function handleCorruptedMetadata(metaPath, error, options) {
-  if (options?.warnOnCorruption) {
-    log6.info(`Session metadata corrupted (cannot read details): ${getErrorMessage(error)}`);
-    log6.info(`Troubleshooting: Run "${sessionCommand("bdg cleanup")}" to remove corrupted files`);
-  }
-  if (options?.selfHealOnCorruption) {
-    try {
-      fs8.rmSync(metaPath, { force: true });
-      log6.info("Removed corrupted session metadata file");
-    } catch (deleteError) {
-      log6.debug(`Failed to remove corrupted metadata: ${getErrorMessage(deleteError)}`);
-    }
-  }
-}
-function readSessionMetadata(options) {
-  const metaPath = getSessionFilePath("METADATA");
-  if (!fs8.existsSync(metaPath)) {
-    return null;
-  }
-  try {
-    const content = fs8.readFileSync(metaPath, "utf-8");
-    return JSON.parse(content);
-  } catch (error) {
-    handleCorruptedMetadata(metaPath, error, options);
-    return null;
-  }
-}
-var log6;
-var init_metadata = __esm({
-  "src/session/metadata.ts"() {
-    "use strict";
-    init_logging();
-    init_sessionCommand();
-    init_atomicFile();
-    init_errors();
-    init_paths();
-    log6 = createLogger("session");
-  }
-});
-
 // src/utils/validation.ts
 function valid() {
   return { valid: true };
@@ -2138,6 +2133,10 @@ function formatDuration(ms) {
   }
   return `${ms}ms`;
 }
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  return bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
 var hintsHidden, OutputFormatter, MIN_URL_END_SHOWN, WEB_PROTOCOLS;
 var init_formatting = __esm({
   "src/ui/formatting.ts"() {
@@ -2296,6 +2295,15 @@ function fieldLabelList(labels) {
   const shown = labels.slice(0, 5).map((label) => label.replace(/\s*:\s*$/, "")).join(", ");
   return labels.length > 5 ? `${shown} and ${labels.length - 5} more` : shown;
 }
+function cdpUnlistedMethodWarning(method, protocolVersion) {
+  return `${method} is not in the bundled protocol (devtools-protocol ${protocolVersion}); sending it to Chrome as is`;
+}
+function cdpUnresolvedRedirectLine(method) {
+  return `Redirect target ${method} is not in the protocol (unresolved redirect)`;
+}
+function cdpRedirectTitle(method) {
+  return `Implemented by ${method} (redirect)`;
+}
 function requiredFieldsEmptyMessage(labels) {
   const fields = labels.length === 1 ? "field" : "fields";
   return `${labels.length} required ${fields} empty: ${fieldLabelList(labels)}`;
@@ -2332,6 +2340,19 @@ function pageNavigationText(navigation) {
   const status = navigation.status === void 0 ? "" : ` (${navigation.status})`;
   return `navigated to ${navigation.url}${status}`;
 }
+function downloadText(download) {
+  const where = download.path === void 0 ? "" : ` \u2192 ${download.path}`;
+  const running = download.state === "inProgress";
+  const bytes = download.bytes === void 0 || running && download.bytes === 0 ? "" : `, ${formatBytes(download.bytes)}${running ? " so far" : ""}`;
+  const reason = download.reason === void 0 ? "" : `: ${download.reason}`;
+  return `Download: ${download.suggestedFilename}${where} (${download.state}${bytes}${reason})`;
+}
+function downloadsSummary(downloads) {
+  const last = downloads[downloads.length - 1];
+  if (!last) return "0";
+  const where = last.path === void 0 ? "" : ` \u2192 ${last.path}`;
+  return `${downloads.length} (last: ${last.suggestedFilename}${where}, ${last.state})`;
+}
 function moreMessagesText(count) {
   return `(+${count} more)`;
 }
@@ -2632,6 +2653,9 @@ function sessionFilesCleanedMessage() {
 function sessionOutputRemovedMessage() {
   return "Session output file removed";
 }
+function downloadsKeptMessage(dir, files) {
+  return `Downloads kept: ${pluralize(files, "file")} in ${dir} (delete them yourself when done)`;
+}
 function sessionDirectoryCleanMessage() {
   return "Session directory is now clean";
 }
@@ -2695,7 +2719,7 @@ function helpJsonDetailsNote() {
 function moreCharsNote(count) {
   return `\u2026 ${count} more chars (use --full)`;
 }
-var REQUIRED_FIELD_EMPTY_REASON, NO_VISIBLE_EFFECT, HOVER_OFF_DONE, HOVER_USAGE, LAYOUT_REASONS, SCROLL_LOCKED_PREFIX, VIEWPORT_POSITION_HINTS, INSPECT_OUTPUT_LEGEND, COLLAPSED_LISTENERS_HEADING, NO_LISTENERS_HINT, NOTE_TYPES_SHOWN, POINTER_ACTION_DONE, POINTER_ACTION_NOUN, PAGE_ACTION_DONE, PAGE_INFO_DESCRIPTION, PAGE_EMULATE_DESCRIPTION, PAGE_ACTION_DESCRIPTIONS, CLICK_RESULT_WAIT_HELP, WAIT_HELP_EXAMPLES, FRAME_URL_MAX_LENGTH, AUDIT_HELP_EXAMPLES, CSS_SEARCH_HELP_EXAMPLES;
+var REQUIRED_FIELD_EMPTY_REASON, CDP_EXECUTION_HELP, NO_VISIBLE_EFFECT, HOVER_OFF_DONE, HOVER_USAGE, LAYOUT_REASONS, SCROLL_LOCKED_PREFIX, VIEWPORT_POSITION_HINTS, INSPECT_OUTPUT_LEGEND, COLLAPSED_LISTENERS_HEADING, NO_LISTENERS_HINT, NOTE_TYPES_SHOWN, POINTER_ACTION_DONE, POINTER_ACTION_NOUN, PAGE_ACTION_DONE, PAGE_INFO_DESCRIPTION, PAGE_EMULATE_DESCRIPTION, PAGE_ACTION_DESCRIPTIONS, CLICK_RESULT_WAIT_HELP, WAIT_HELP_EXAMPLES, FRAME_URL_MAX_LENGTH, AUDIT_HELP_EXAMPLES, CSS_SEARCH_HELP_EXAMPLES;
 var init_commands = __esm({
   "src/ui/messages/commands.ts"() {
     "use strict";
@@ -2704,6 +2728,7 @@ var init_commands = __esm({
     init_sessionCommand();
     init_strings();
     REQUIRED_FIELD_EMPTY_REASON = "Required field is empty";
+    CDP_EXECUTION_HELP = "  Execution: bundled methods are case-insensitive (network.getcookies works)\n  Other methods are sent as typed (case-sensitive)";
     NO_VISIBLE_EFFECT = "no visible effect observed: no DOM change, requests or navigation within 300 ms";
     HOVER_OFF_DONE = "\u2713 Mouse moved off the page (hover styles and menus that close on mouseleave are gone)";
     HOVER_USAGE = "bdg dom hover <selector|index>, or bdg dom hover --off to move the mouse away";
@@ -3008,7 +3033,7 @@ var init_CommandError = __esm({
 });
 
 // src/ipc/transport/IPCError.ts
-var IPCError, IPCConnectionError, IPCTimeoutError, IPCParseError, IPCEarlyCloseError;
+var IPCError, IPCConnectionError, IPCTimeoutError, IPCParseError, IPCEarlyCloseError, IPCCancelledError;
 var init_IPCError = __esm({
   "src/ipc/transport/IPCError.ts"() {
     "use strict";
@@ -3066,6 +3091,14 @@ var init_IPCError = __esm({
         this.requestName = requestName;
       }
     };
+    IPCCancelledError = class extends IPCError {
+      name = "IPCCancelledError";
+      requestName;
+      constructor(requestName) {
+        super(`${requestName} request cancelled`, EXIT_CODES.SOFTWARE_ERROR);
+        this.requestName = requestName;
+      }
+    };
   }
 });
 
@@ -3268,6 +3301,12 @@ function commandTimedOutError(seconds) {
     suggestion: `Check the session with: ${sessionCommand("bdg status")}; if the page stays frozen, end it with: ${sessionCommand("bdg cleanup --force")}`
   };
 }
+function screenshotInterruptedError(signal) {
+  return {
+    message: `Screenshot cancelled (${signal === "SIGINT" ? "interrupted" : "terminated"})`,
+    suggestion: "No file was written; run it again to capture (the next command sees the page's own emulation)"
+  };
+}
 function sessionUnavailableSuggestion(exitCode) {
   return exitCode === 85 ? `Wait until "${sessionCommand("bdg <url>")}" returns, then retry` : startSessionSuggestion();
 }
@@ -3711,18 +3750,6 @@ function waitTargetRequiredError() {
     suggestion: `e.g. ${sessionCommand("bdg dom wait '#result' --visible")}, ${sessionCommand("bdg dom wait body --text 'Welcome'")} or ${sessionCommand("bdg dom wait --load")}`
   };
 }
-function elementNotVisibleError() {
-  return {
-    message: "Element is not rendered (e.g. display: none), so it has no area to capture",
-    suggestion: "Make it visible first, or capture a visible ancestor"
-  };
-}
-function elementZeroDimensionsError() {
-  return {
-    message: "Element has zero width or height, so there is nothing to capture",
-    suggestion: "It may be collapsed or empty; capture a visible ancestor instead"
-  };
-}
 function hoverOffWithTargetError() {
   return {
     message: "--off moves the mouse off the page; it takes no element",
@@ -3845,6 +3872,34 @@ function formInIframeError(iframeUrl, crossOrigin) {
     suggestion: crossOrigin ? "Cross-origin iframes cannot be read or controlled; open the iframe URL directly: bdg <iframe url>" : 'dom form lists forms of the main document only; its fields are reachable directly: bdg dom query "input, select, textarea", then bdg dom fill <index> <value>'
   };
 }
+function cdpTypeNotMethodError(name) {
+  return {
+    message: `${name} is a protocol type, not a method`,
+    suggestion: `Use: bdg cdp ${name} --describe (to see its values or properties)`
+  };
+}
+function cdpMethodNotFoundError(input, similar, listHint) {
+  const didYouMean = similar.length > 0 ? ["", "Did you mean:", ...similar.map((name) => `  - ${name}`)] : [];
+  return {
+    message: `Method '${input}' not found`,
+    suggestion: [listHint, ...didYouMean].join("\n")
+  };
+}
+function cdpMethodTypoError(input, similar, listHint) {
+  const err = cdpMethodNotFoundError(input, similar, listHint);
+  return {
+    message: err.message,
+    suggestion: `${err.suggestion}
+
+To send it as typed (a method newer than bdg's protocol): ${sessionCommand(`bdg cdp ${input} --send-anyway`)}`
+  };
+}
+function cdpMethodNotInBundledProtocolError(method, protocolVersion) {
+  return {
+    message: `Method '${method}' is not in the bundled protocol (devtools-protocol ${protocolVersion})`,
+    suggestion: `bdg cdp ${method} sends it to Chrome as is, which may still have it. Methods bdg knows: bdg cdp --search <keyword>`
+  };
+}
 function skillSourceMissingError(source) {
   return {
     message: `The bdg skill is missing from the installed package (${source})`,
@@ -4021,6 +4076,47 @@ var init_suggestions = __esm({
   }
 });
 
+// src/commands/shared/interrupt.ts
+function interruptExitCode(signal) {
+  return signal === "SIGINT" ? EXIT_CODES.INTERRUPTED : EXIT_CODES.TERMINATED;
+}
+function interruptSignal(interrupt) {
+  return interrupt.reason === "SIGTERM" ? "SIGTERM" : "SIGINT";
+}
+function abortOnInterrupt() {
+  const interrupt = new AbortController();
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.on(signal, () => {
+      if (interrupt.signal.aborted) process.exit(interruptExitCode(signal));
+      interrupt.abort(signal);
+    });
+  }
+  return interrupt.signal;
+}
+async function unlessInterrupted(work, interrupt, interruptedError) {
+  const fail = () => interruptedError(interruptSignal(interrupt));
+  if (interrupt.aborted) throw fail();
+  let onAbort = () => void 0;
+  const interrupted = new Promise((_, reject2) => {
+    onAbort = () => reject2(fail());
+    interrupt.addEventListener("abort", onAbort, { once: true });
+  });
+  try {
+    return await Promise.race([work, interrupted]);
+  } catch (error) {
+    if (interrupt.aborted) throw fail();
+    throw error;
+  } finally {
+    interrupt.removeEventListener("abort", onAbort);
+  }
+}
+var init_interrupt = __esm({
+  "src/commands/shared/interrupt.ts"() {
+    "use strict";
+    init_exitCodes();
+  }
+});
+
 // src/ipc/transport/errors.ts
 function formatConnectionError(requestName, socketPath, error) {
   const code = error.code;
@@ -4042,6 +4138,9 @@ function formatTimeoutError(requestName, timeoutMs) {
 function formatEarlyCloseError(requestName) {
   return new IPCEarlyCloseError(requestName);
 }
+function formatCancelledError(requestName) {
+  return new IPCCancelledError(requestName);
+}
 var init_errors4 = __esm({
   "src/ipc/transport/errors.ts"() {
     "use strict";
@@ -4211,7 +4310,7 @@ var init_validation2 = __esm({
 
 // src/ipc/transport/index.ts
 import * as path5 from "path";
-async function sendRequest(request, requestName, expectedType, timeoutMs = getIPCRequestTimeout(), socketPath = getDaemonSocketPath()) {
+async function sendRequest(request, requestName, expectedType, timeoutMs = getIPCRequestTimeout(), socketPath = getDaemonSocketPath(), signal) {
   const untrusted = secureSessionDir(path5.dirname(socketPath));
   if (untrusted) {
     const err = untrustedSessionDirError(untrusted);
@@ -4222,11 +4321,18 @@ async function sendRequest(request, requestName, expectedType, timeoutMs = getIP
     );
   }
   return new Promise((resolve4, reject2) => {
+    if (signal?.aborted) {
+      reject2(formatCancelledError(requestName));
+      return;
+    }
     const buffer = new JSONLBuffer();
     let resolved = false;
+    let onAbort = () => {
+    };
     const resolveOnce = (cleanup2, error, response) => {
       if (resolved) return;
       resolved = true;
+      signal?.removeEventListener("abort", onAbort);
       cleanup2();
       if (error) {
         reject2(error);
@@ -4272,6 +4378,8 @@ async function sendRequest(request, requestName, expectedType, timeoutMs = getIP
         }
       }
     );
+    onAbort = () => resolveOnce(cleanup, formatCancelledError(requestName));
+    signal?.addEventListener("abort", onAbort, { once: true });
   });
 }
 var log10;
@@ -4379,7 +4487,7 @@ async function getHARData() {
   await assertResponsive();
   return sendRequest(request, "HAR data", "har_data_response");
 }
-async function startSession(url, options) {
+async function startSession(url, options, signal) {
   const request = withSession({
     type: "start_session_request",
     url,
@@ -4401,7 +4509,10 @@ async function startSession(url, options) {
   return sendRequest(
     request,
     "start session",
-    "start_session_response"
+    "start_session_response",
+    void 0,
+    void 0,
+    signal
   );
 }
 async function stopSession() {
@@ -4413,7 +4524,7 @@ async function stopSession() {
     "stop_session_response"
   );
 }
-async function sendCommand(commandName, params, timeoutMs) {
+async function sendCommand(commandName, params, timeoutMs, signal) {
   const request = {
     ...params,
     type: `${commandName}_request`,
@@ -4424,7 +4535,9 @@ async function sendCommand(commandName, params, timeoutMs) {
     request,
     commandName,
     `${commandName}_response`,
-    timeoutMs
+    timeoutMs,
+    void 0,
+    signal
   );
 }
 async function getDetails(type, id) {
@@ -4508,6 +4621,9 @@ async function cssSearch(params) {
 async function domInspect(params) {
   return sendCommand("dom_inspect", params);
 }
+async function domScreenshot(params, signal) {
+  return sendCommand("dom_screenshot", params, void 0, signal);
+}
 async function domWait(params) {
   return sendCommand(
     "dom_wait",
@@ -4528,36 +4644,6 @@ var init_client = __esm({
   }
 });
 
-// src/connection/errors.ts
-var ConnectionError, CDPConnectionError;
-var init_errors5 = __esm({
-  "src/connection/errors.ts"() {
-    "use strict";
-    init_exitCodes();
-    ConnectionError = class extends Error {
-      issue;
-      constructor(message, options) {
-        super(message);
-        this.name = this.constructor.name;
-        if (options instanceof Error) {
-          this.cause = options;
-          return;
-        }
-        if (options?.cause) {
-          this.cause = options.cause;
-        }
-        if (options?.issue) {
-          this.issue = options.issue;
-        }
-      }
-    };
-    CDPConnectionError = class extends ConnectionError {
-      code = "CDP_CONNECTION_ERROR";
-      exitCode = EXIT_CODES.CDP_CONNECTION_FAILURE;
-    };
-  }
-});
-
 // node_modules/ws/lib/constants.js
 var require_constants = __commonJS({
   "node_modules/ws/lib/constants.js"(exports, module) {
@@ -8352,7 +8438,7 @@ var init_elementInfo = __esm({
   return withoutDecorations(el, start);
 }`;
     MASKED_VALUE = "\u2022\u2022\u2022\u2022";
-    SENSITIVE_NAME_SOURCE = "passw|passwd|pwd|passcode|(^|[^a-z])otp([^a-z]|$)|cvv|cvc";
+    SENSITIVE_NAME_SOURCE = "passw|passwd|pwd|passcode|passphrase|(^|[^a-z])(otp|pin|ssn)([^a-z]|$)|cvv|cvc|card[-_]?(num(ber)?|no)([^a-z]|$)";
     SENSITIVE_FIELD_JS = `(el) => {
   const autocomplete = el.getAttribute('autocomplete') || '';
   if (/(^|\\s)(cc-[a-z-]+|one-time-code|current-password|new-password)(\\s|$)/i.test(autocomplete)) return true;
@@ -9826,7 +9912,7 @@ async function resolveSelector(selector) {
       EXIT_CODES.RESOURCE_NOT_FOUND
     );
   }
-  return { backendNodeId };
+  return backendNodeId;
 }
 async function resolveBackendNodeIds(selectors) {
   return mapConcurrently(selectors, async (selector) => (await selectAll(selector))[0]);
@@ -9974,589 +10060,56 @@ var init_outputFile = __esm({
       EISDIR: { reason: "it is a directory", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
       ENOTDIR: { reason: "a part of the path is a file", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
       EEXIST: { reason: "a part of the path is a file", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
-      ENAMETOOLONG: { reason: "the name is too long", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
-      ENOENT: { reason: "the directory cannot be created", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
-      ENOSPC: { reason: "no space left on the device", exitCode: EXIT_CODES.SESSION_FILE_ERROR },
-      EPSEUDOFS: {
-        reason: "it is on a pseudo-filesystem (/proc, /sys)",
-        exitCode: EXIT_CODES.INVALID_ARGUMENTS
-      }
-    };
-  }
-});
-
-// src/runtime/page/userAgent.ts
-var log24;
-var init_userAgent = __esm({
-  "src/runtime/page/userAgent.ts"() {
-    "use strict";
-    init_logging();
-    init_errors();
-    log24 = createLogger("session");
-  }
-});
-
-// src/runtime/page/emulation.ts
-function viewportOverride(viewport, deviceScaleFactor = 0) {
-  const mobile = viewport.mobile === true;
-  return {
-    width: viewport.width,
-    height: viewport.height,
-    deviceScaleFactor: deviceScaleFactor || (mobile ? MOBILE_PIXEL_RATIO : 0),
-    mobile
-  };
-}
-var log25, MOBILE_PIXEL_RATIO;
-var init_emulation = __esm({
-  "src/runtime/page/emulation.ts"() {
-    "use strict";
-    init_elementGeometry();
-    init_userAgent();
-    init_logging();
-    init_errors();
-    log25 = createLogger("session");
-    MOBILE_PIXEL_RATIO = 3;
-  }
-});
-
-// src/commands/dom/helpers/screenshot.ts
-async function waitForPostScrollStability() {
-  const deadline = Date.now() + POST_SCROLL_MAX_WAIT_MS;
-  await callBdgScript("Runtime.evaluate", {
-    expression: `
-      (() => {
-        window.__bdg_scrollStability = {
-          lastNetworkActivity: Date.now(),
-          lastDomMutation: Date.now(),
-          activeRequests: 0
-        };
-
-        const state = window.__bdg_scrollStability;
-
-        if (window.PerformanceObserver) {
-          const perfObserver = new PerformanceObserver((list) => {
-            for (const entry of list.getEntries()) {
-              if (entry.entryType === 'resource') {
-                state.lastNetworkActivity = Date.now();
-              }
-            }
-          });
-          try {
-            perfObserver.observe({ entryTypes: ['resource'] });
-            state.perfObserver = perfObserver;
-          } catch (e) {}
-        }
-
-        const mutationObserver = new MutationObserver(() => {
-          state.lastDomMutation = Date.now();
-        });
-        mutationObserver.observe(document.body || document.documentElement, {
-          childList: true,
-          subtree: true,
-          attributes: true
-        });
-        state.mutationObserver = mutationObserver;
-      })()
-    `,
-    returnByValue: true
-  });
-  try {
-    while (Date.now() < deadline) {
-      const checkResult = await callBdgScript("Runtime.evaluate", {
-        expression: `
-          (() => {
-            const state = window.__bdg_scrollStability;
-            if (!state) return { networkIdle: 999, domIdle: 999 };
-            return {
-              networkIdle: Date.now() - state.lastNetworkActivity,
-              domIdle: Date.now() - state.lastDomMutation
-            };
-          })()
-        `,
-        returnByValue: true
-      });
-      const value = checkResult.data?.result?.result?.value;
-      const networkIdle = value?.networkIdle ?? 0;
-      const domIdle = value?.domIdle ?? 0;
-      if (networkIdle >= POST_SCROLL_NETWORK_IDLE_MS && domIdle >= POST_SCROLL_DOM_STABLE_MS) {
-        log26.debug(`Post-scroll stable: network ${networkIdle}ms, DOM ${domIdle}ms`);
-        return;
-      }
-      await new Promise((resolve4) => setTimeout(resolve4, STABILITY_CHECK_INTERVAL_MS));
-    }
-    log26.debug("Post-scroll stability timeout, proceeding anyway");
-  } finally {
-    await callBdgScript("Runtime.evaluate", {
-      expression: `
-        (() => {
-          const state = window.__bdg_scrollStability;
-          if (state) {
-            state.perfObserver?.disconnect();
-            state.mutationObserver?.disconnect();
-            delete window.__bdg_scrollStability;
-          }
-        })()
-      `,
-      returnByValue: true
-    });
-  }
-}
-async function scrollToElement(selector) {
-  const result = await callBdgScript("Runtime.evaluate", {
-    expression: `
-      (() => {
-        const el = (${DEEP_QUERY_JS})(${selectorArgsJS(selector)})[0];
-        if (!el) return { found: false };
-        const originalX = window.scrollX;
-        const originalY = window.scrollY;
-        el.scrollIntoView({ block: 'center', behavior: 'instant' });
-        return { found: true, originalX, originalY };
-      })()
-    `,
-    returnByValue: true
-  });
-  const value = result.data?.result?.result?.value;
-  if (!value?.found) {
-    const err = noNodesFoundError(selector);
-    throw new CommandError(
-      err.message,
-      { suggestion: err.suggestion },
-      EXIT_CODES.RESOURCE_NOT_FOUND
-    );
-  }
-  await waitForPostScrollStability();
-  return { x: value.originalX ?? 0, y: value.originalY ?? 0 };
-}
-async function restoreScrollPosition(position) {
-  await callBdgScript("Runtime.evaluate", {
-    expression: `window.scrollTo(${position.x}, ${position.y})`,
-    returnByValue: true
-  });
-}
-async function windowSize(viewport) {
-  const response = await callBdgScript("Runtime.evaluate", {
-    expression: "[window.innerWidth, window.innerHeight]",
-    returnByValue: true
-  });
-  const value = response.data?.result?.result?.value;
-  const [width, height] = Array.isArray(value) ? value : [];
-  return {
-    width: Math.round(width ?? viewport.clientWidth),
-    height: Math.round(height ?? viewport.clientHeight)
-  };
-}
-async function useUnitPixelRatio(devicePixelRatio, viewport) {
-  if (devicePixelRatio === 1) return () => Promise.resolve();
-  const sessionViewport = readSessionMetadata()?.viewport;
-  const size = sessionViewport ?? await windowSize(viewport);
-  await callCDP("Emulation.setDeviceMetricsOverride", viewportOverride(size, 1));
-  return restoreSessionMetrics;
-}
-async function restoreSessionMetrics() {
-  const sessionViewport = readSessionMetadata()?.viewport;
-  if (!sessionViewport) {
-    await callCDP("Emulation.clearDeviceMetricsOverride", {});
-    return;
-  }
-  await callCDP("Emulation.setDeviceMetricsOverride", viewportOverride(sessionViewport));
-  if (sessionViewport.mobile) {
-    await callCDP("Emulation.setTouchEmulationEnabled", { enabled: true, maxTouchPoints: 5 });
-  }
-}
-async function getElementBounds(ref) {
-  const response = await callCDP("DOM.getBoxModel", ref);
-  const boxModel = response.data?.result;
-  if (!boxModel?.model?.border) {
-    const err = elementNotVisibleError();
-    throw new CommandError(
-      err.message,
-      { suggestion: err.suggestion },
-      EXIT_CODES.INVALID_ARGUMENTS
-    );
-  }
-  const border = boxModel.model.border;
-  const x = border[0] ?? 0;
-  const y = border[1] ?? 0;
-  const width = (border[2] ?? 0) - x;
-  const height = (border[5] ?? 0) - y;
-  if (width <= 0 || height <= 0) {
-    const err = elementZeroDimensionsError();
-    throw new CommandError(
-      err.message,
-      { suggestion: err.suggestion },
-      EXIT_CODES.INVALID_ARGUMENTS
-    );
-  }
-  return { x, y, width, height };
-}
-async function visibleAreaOrigin() {
-  const response = await callCDP("Page.getLayoutMetrics", {});
-  const metrics = response.data?.result;
-  const viewport = metrics?.cssVisualViewport;
-  return { x: viewport?.pageX ?? 0, y: viewport?.pageY ?? 0 };
-}
-async function capturePageScreenshot(outputPath, options = {}) {
-  const format = options.format ?? "png";
-  const quality = format === "jpeg" ? options.quality ?? 90 : void 0;
-  const requestedFullPage = options.fullPage ?? true;
-  const noResize = options.noResize ?? false;
-  let originalScrollPosition;
-  if (options.scroll) {
-    originalScrollPosition = await scrollToElement(options.scroll);
-  }
-  const dprResponse = await callBdgScript("Runtime.evaluate", {
-    expression: "window.devicePixelRatio",
-    returnByValue: true
-  });
-  const devicePixelRatio = dprResponse.data?.result?.result?.value ?? 1;
-  const metricsResponse = await callCDP("Page.getLayoutMetrics", {});
-  const metricsResult = metricsResponse.data?.result;
-  const contentSize = metricsResult?.contentSize ?? { width: 0, height: 0 };
-  const viewport = metricsResult?.visualViewport ?? { clientWidth: 0, clientHeight: 0 };
-  const pageIsTooTall = !noResize && requestedFullPage && isTallPage(contentSize.width, contentSize.height);
-  const useScroll = options.scroll !== void 0;
-  const effectiveFullPage = useScroll ? false : pageIsTooTall ? false : requestedFullPage;
-  const captureWidth = effectiveFullPage ? contentSize.width : viewport.clientWidth;
-  const captureHeight = effectiveFullPage ? contentSize.height : viewport.clientHeight;
-  const resized = shouldResize(captureWidth, captureHeight, noResize);
-  const scale = resized ? calculateResizeScale(captureWidth, captureHeight) : 1;
-  const finalWidth = Math.round(captureWidth * scale);
-  const finalHeight = Math.round(captureHeight * scale);
-  const restoreMetrics = await useUnitPixelRatio(devicePixelRatio, viewport);
-  if (devicePixelRatio !== 1) {
-    if (options.scroll) {
-      await callBdgScript("Runtime.evaluate", {
-        expression: `(${DEEP_QUERY_JS})(${selectorArgsJS(options.scroll)})[0]?.scrollIntoView({ block: 'center', behavior: 'instant' })`,
-        returnByValue: true
-      });
-    }
-  }
-  const clipOrigin = effectiveFullPage ? { x: 0, y: 0 } : await visibleAreaOrigin();
-  let screenshotResult;
-  try {
-    const screenshotResponse = await callCDP("Page.captureScreenshot", {
-      format,
-      ...quality !== void 0 && { quality },
-      captureBeyondViewport: effectiveFullPage,
-      clip: {
-        x: clipOrigin.x,
-        y: clipOrigin.y,
-        width: captureWidth,
-        height: captureHeight,
-        scale
-      }
-    });
-    screenshotResult = screenshotResponse.data?.result;
-  } finally {
-    await restoreMetrics();
-  }
-  if (!screenshotResult?.data) {
-    throw new CDPConnectionError("No screenshot data returned", new Error("Empty response"));
-  }
-  const buffer = Buffer.from(screenshotResult.data, "base64");
-  const absolutePath = await writeOutputFile(outputPath, buffer);
-  const result = {
-    path: absolutePath,
-    format,
-    width: finalWidth,
-    height: finalHeight,
-    size: buffer.length,
-    fullPage: effectiveFullPage,
-    captureMode: effectiveFullPage ? "full_page" : "viewport",
-    finalTokens: calculateImageTokens(finalWidth, finalHeight)
-  };
-  if (quality !== void 0) {
-    result.quality = quality;
-  }
-  if (!effectiveFullPage) {
-    result.viewport = {
-      width: viewport.clientWidth,
-      height: viewport.clientHeight
-    };
-  }
-  if (resized) {
-    result.resized = true;
-    result.originalWidth = captureWidth;
-    result.originalHeight = captureHeight;
-    result.originalTokens = calculateImageTokens(captureWidth, captureHeight);
-  }
-  if (pageIsTooTall && !useScroll) {
-    const aspectRatio = Math.round(contentSize.height / contentSize.width * 10) / 10;
-    result.fullPageSkipped = {
-      reason: "page_too_tall",
-      originalHeight: contentSize.height,
-      aspectRatio
-    };
-    result.warning = `Full page capture skipped: page too tall (${aspectRatio}:1 aspect ratio). Only viewport captured.`;
-  }
-  if (useScroll && options.scroll) {
-    result.scrolledTo = options.scroll;
-  }
-  if (originalScrollPosition) {
-    await restoreScrollPosition(originalScrollPosition);
-  }
-  return result;
-}
-async function visibleViewport() {
-  const metrics = (await callCDP("Page.getLayoutMetrics", {})).data?.result;
-  const view = metrics?.cssVisualViewport ?? metrics?.visualViewport;
-  return { width: view?.clientWidth ?? 0, height: view?.clientHeight ?? 0 };
-}
-function insideView(area, view) {
-  return area.x >= 0 && area.y >= 0 && area.x + area.width <= view.width && area.y + area.height <= view.height;
-}
-async function measureInView(ref, padding) {
-  const view = await visibleViewport();
-  let box = await getElementBounds(ref);
-  let bounds = await captureArea(ref, box, padding);
-  const fits = bounds.width <= view.width && bounds.height <= view.height;
-  if (!fits) {
-    await keepLayoutWithoutScrollbars(view);
-    box = await getElementBounds(ref);
-    return { box, bounds: await captureArea(ref, box, padding), inView: false };
-  }
-  if (insideView(bounds, view)) return { box, bounds, inView: true };
-  const scrolledFrom = await scrollPosition();
-  const dx = bounds.x + bounds.width / 2 - view.width / 2;
-  const dy = bounds.y + bounds.height / 2 - view.height / 2;
-  await callBdgScript("Runtime.evaluate", { expression: `window.scrollBy(${dx}, ${dy})` });
-  try {
-    box = await getElementBounds(ref);
-    bounds = await captureArea(ref, box, padding);
-  } catch (error) {
-    await restoreScrollPosition(scrolledFrom);
-    throw error;
-  }
-  return { box, bounds, inView: insideView(bounds, view), scrolledFrom };
-}
-async function keepLayoutWithoutScrollbars(view) {
-  const phone = readSessionMetadata()?.viewport?.mobile;
-  await callCDP("Emulation.setScrollbarsHidden", { hidden: true });
-  await callCDP(
-    "Emulation.setDeviceMetricsOverride",
-    viewportOverride({ ...view, ...phone && { mobile: true } }, 1)
-  );
-}
-async function restoreViewport() {
-  await callCDP("Emulation.setScrollbarsHidden", { hidden: false });
-  await restoreSessionMetrics();
-}
-async function scrollPosition() {
-  const response = await callBdgScript("Runtime.evaluate", {
-    expression: "[window.scrollX, window.scrollY]",
-    returnByValue: true
-  });
-  const value = response.data?.result?.result?.value;
-  const [x, y] = Array.isArray(value) ? value : [];
-  return { x: x ?? 0, y: y ?? 0 };
-}
-async function captureArea(ref, bounds, padding) {
-  const area = await paintedArea(ref, bounds);
-  return padding > 0 ? {
-    x: area.x - padding,
-    y: area.y - padding,
-    width: area.width + 2 * padding,
-    height: area.height + 2 * padding
-  } : area;
-}
-async function paintedArea(ref, bounds) {
-  const objectGroup = `bdg-shot-${process.pid}`;
-  try {
-    const resolved = await callBdgScript("DOM.resolveNode", { ...ref, objectGroup });
-    const objectId = resolved.data?.result?.object.objectId;
-    if (!objectId) return bounds;
-    const response = await callCDP("Runtime.callFunctionOn", {
-      objectId,
-      functionDeclaration: CONTENT_OVERFLOW_JS,
-      returnByValue: true
-    });
-    const overflow = response.data?.result?.result?.value;
-    if (!overflow) return bounds;
-    const [left, top, right, bottom] = ["left", "top", "right", "bottom"].map(
-      (side) => Math.max(0, overflow[side] ?? 0)
-    );
-    if (Math.max(left, top, right, bottom) <= OVERFLOW_SLACK) return bounds;
-    return {
-      x: bounds.x - left,
-      y: bounds.y - top,
-      width: bounds.width + left + right,
-      height: bounds.height + top + bottom
-    };
-  } catch (error) {
-    log26.debug(`Could not measure overflowing content: ${String(error)}`);
-    return bounds;
-  } finally {
-    await callCDP("Runtime.releaseObjectGroup", { objectGroup }).catch(() => void 0);
-  }
-}
-async function captureElementScreenshot(outputPath, ref, options = {}) {
-  const format = options.format ?? "png";
-  const quality = format === "jpeg" ? options.quality ?? 90 : void 0;
-  const noResize = options.noResize ?? false;
-  const dprResponse = await callBdgScript("Runtime.evaluate", {
-    expression: "window.devicePixelRatio",
-    returnByValue: true
-  });
-  const devicePixelRatio = dprResponse.data?.result?.result?.value ?? 1;
-  const before = (await callCDP("Page.getLayoutMetrics", {})).data?.result;
-  const restoreMetrics = await useUnitPixelRatio(
-    devicePixelRatio,
-    before?.visualViewport ?? { clientWidth: 800, clientHeight: 600 }
-  );
-  const restore = async (wide, scrolledFrom2) => {
-    await (wide ? restoreViewport() : restoreMetrics());
-    if (scrolledFrom2) await restoreScrollPosition(scrolledFrom2);
-  };
-  let measured;
-  try {
-    measured = await measureInView(ref, options.padding ?? 0);
-  } catch (error) {
-    await restoreViewport();
-    throw error;
-  }
-  const { box, bounds, inView, scrolledFrom } = measured;
-  const originalWidth = bounds.width;
-  const originalHeight = bounds.height;
-  const resized = shouldResize(originalWidth, originalHeight, noResize);
-  const scale = resized ? calculateResizeScale(originalWidth, originalHeight) : 1;
-  const finalWidth = Math.round(originalWidth * scale);
-  const finalHeight = Math.round(originalHeight * scale);
-  const metricsResponse = await callCDP("Page.getLayoutMetrics", {});
-  const metricsResult = metricsResponse.data?.result;
-  const scroll = metricsResult?.cssLayoutViewport ?? { pageX: 0, pageY: 0 };
-  const onPage = (area) => ({
-    ...area,
-    x: area.x + scroll.pageX,
-    y: area.y + scroll.pageY
-  });
-  const clip = onPage(bounds);
-  let screenshotResult;
-  try {
-    const screenshotResponse = await callCDP("Page.captureScreenshot", {
-      format,
-      ...quality !== void 0 && { quality },
-      clip: { ...clip, scale },
-      captureBeyondViewport: !inView
-    });
-    screenshotResult = screenshotResponse.data?.result;
-  } finally {
-    await restore(!inView, scrolledFrom);
-  }
-  if (!screenshotResult?.data) {
-    throw new CDPConnectionError("No screenshot data returned", new Error("Empty response"));
-  }
-  const buffer = Buffer.from(screenshotResult.data, "base64");
-  const absolutePath = await writeOutputFile(outputPath, buffer);
-  const result = {
-    path: absolutePath,
-    format,
-    width: finalWidth,
-    height: finalHeight,
-    size: buffer.length,
-    fullPage: false,
-    finalTokens: calculateImageTokens(finalWidth, finalHeight),
-    element: {
-      bounds: roundBounds(onPage(box)),
-      ...bounds !== box && { captured: roundBounds(clip) },
-      ...options.padding && { padding: options.padding }
-    }
-  };
-  if (quality !== void 0) {
-    result.quality = quality;
-  }
-  if (resized) {
-    result.resized = true;
-    result.originalWidth = originalWidth;
-    result.originalHeight = originalHeight;
-    result.originalTokens = calculateImageTokens(originalWidth, originalHeight);
+      ENAMETOOLONG: { reason: "the name is too long", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
+      ENOENT: { reason: "the directory cannot be created", exitCode: EXIT_CODES.INVALID_ARGUMENTS },
+      ENOSPC: { reason: "no space left on the device", exitCode: EXIT_CODES.SESSION_FILE_ERROR },
+      EPSEUDOFS: {
+        reason: "it is on a pseudo-filesystem (/proc, /sys)",
+        exitCode: EXIT_CODES.INVALID_ARGUMENTS
+      }
+    };
   }
-  return result;
+});
+
+// src/commands/dom/helpers/screenshot.ts
+function screenshotInterrupted(signal) {
+  const err = screenshotInterruptedError(signal);
+  return new CommandError(err.message, { suggestion: err.suggestion }, interruptExitCode(signal));
+}
+async function requestCapture(request, interrupt) {
+  if (!interrupt) return domScreenshot(request);
+  const capture = domScreenshot(request, interrupt);
+  const response = await unlessInterrupted(capture, interrupt, screenshotInterrupted);
+  if (interrupt.aborted) throw screenshotInterrupted(interruptSignal(interrupt));
+  return response;
 }
-function roundBounds(bounds) {
-  return {
-    x: Math.round(bounds.x),
-    y: Math.round(bounds.y),
-    width: Math.round(bounds.width),
-    height: Math.round(bounds.height)
-  };
+async function captureScreenshot(outputPath, request, interrupt) {
+  const response = await requestCapture(request, interrupt);
+  if (response.status === "error" || !response.data) {
+    const fallback = operationFailedError(
+      "take the screenshot",
+      `Check the session: ${sessionCommand("bdg status")}`
+    );
+    const suggestion = response.error === void 0 ? fallback.suggestion : response.suggestion;
+    throw new CommandError(
+      response.error ?? fallback.message,
+      suggestion ? { suggestion } : {},
+      response.exitCode ?? EXIT_CODES.CDP_CONNECTION_FAILURE
+    );
+  }
+  const path8 = await writeOutputFile(outputPath, Buffer.from(response.data.image, "base64"));
+  return { path: path8, ...response.data.screenshot };
 }
-var log26, POST_SCROLL_NETWORK_IDLE_MS, POST_SCROLL_DOM_STABLE_MS, POST_SCROLL_MAX_WAIT_MS, STABILITY_CHECK_INTERVAL_MS, OVERFLOW_SCAN_LIMIT, CONTENT_OVERFLOW_JS, OVERFLOW_SLACK;
 var init_screenshot = __esm({
   "src/commands/dom/helpers/screenshot.ts"() {
     "use strict";
-    init_screenshotResize();
+    init_interrupt();
     init_outputFile();
-    init_errors5();
     init_errors3();
     init_messages();
     init_client();
-    init_targetNode();
-    init_emulation();
-    init_metadata();
-    init_logging();
+    init_sessionCommand();
     init_exitCodes();
-    log26 = createLogger("dom");
-    POST_SCROLL_NETWORK_IDLE_MS = 150;
-    POST_SCROLL_DOM_STABLE_MS = 200;
-    POST_SCROLL_MAX_WAIT_MS = 2e3;
-    STABILITY_CHECK_INTERVAL_MS = 50;
-    OVERFLOW_SCAN_LIMIT = 2e3;
-    CONTENT_OVERFLOW_JS = `function () {
-  const view = this.ownerDocument.defaultView;
-  const scroller = this.ownerDocument.scrollingElement || this.ownerDocument.documentElement;
-  const own = this.getBoundingClientRect();
-  const reach = { left: own.left, top: own.top, right: own.right, bottom: own.bottom };
-  const page = { left: -view.scrollX, top: -view.scrollY, right: scroller.scrollWidth - view.scrollX, bottom: scroller.scrollHeight - view.scrollY };
-  const clips = (style) => style.overflowX !== 'visible' || style.overflowY !== 'visible';
-  let budget = ${OVERFLOW_SCAN_LIMIT};
-  const walk = (el) => {
-    for (const child of el.children) {
-      if (--budget < 0) return;
-      const style = view.getComputedStyle(child);
-      if (style.display === 'none' || style.position === 'fixed') continue;
-      const r = child.getBoundingClientRect();
-      if (r.width > 0 && r.height > 0 && style.visibility === 'visible') {
-        reach.left = Math.min(reach.left, Math.max(r.left, page.left));
-        reach.top = Math.min(reach.top, Math.max(r.top, page.top));
-        reach.right = Math.max(reach.right, Math.min(r.right, page.right));
-        reach.bottom = Math.max(reach.bottom, Math.min(r.bottom, page.bottom));
-      }
-      if (!clips(style)) walk(child);
-    }
-  };
-  const ownStyle = view.getComputedStyle(this);
-  if (!clips(ownStyle)) {
-    walk(this);
-    const scaleX = this.offsetWidth ? own.width / this.offsetWidth : 1;
-    const scaleY = this.offsetHeight ? own.height / this.offsetHeight : 1;
-    const wider = Math.max(0, this.scrollWidth - this.clientWidth) * scaleX;
-    const taller = Math.max(0, this.scrollHeight - this.clientHeight) * scaleY;
-    if (ownStyle.direction === 'rtl') reach.left = Math.min(reach.left, own.left - wider);
-    else reach.right = Math.max(reach.right, own.right + wider);
-    reach.bottom = Math.max(reach.bottom, own.bottom + taller);
-  }
-  const ink = { left: 0, top: 0, right: 0, bottom: 0 };
-  const grow = (side, amount) => { ink[side] = Math.max(ink[side], amount); };
-  for (const layer of ownStyle.boxShadow === 'none' ? [] : ownStyle.boxShadow.split(/,(?![^(]*\\))/)) {
-    if (/\\binset\\b/.test(layer)) continue;
-    const [x = 0, y = 0, blur = 0, spread = 0] = (layer.replace(/(rgba?|hsla?|color|oklch|lab|lch)\\([^)]*\\)/g, '').match(/-?[\\d.]+px/g) || []).map(parseFloat);
-    grow('left', blur + spread - x);
-    grow('right', blur + spread + x);
-    grow('top', blur + spread - y);
-    grow('bottom', blur + spread + y);
-  }
-  if (ownStyle.outlineStyle !== 'none') {
-    const outline = parseFloat(ownStyle.outlineWidth) + parseFloat(ownStyle.outlineOffset);
-    ['left', 'top', 'right', 'bottom'].forEach((side) => grow(side, outline));
-  }
-  return {
-    left: Math.max(own.left - reach.left, ink.left),
-    top: Math.max(own.top - reach.top, ink.top),
-    right: Math.max(reach.right - own.right, ink.right),
-    bottom: Math.max(reach.bottom - own.bottom, ink.bottom)
-  };
-}`;
-    OVERFLOW_SLACK = 1;
   }
 });
 
@@ -10564,17 +10117,15 @@ var init_screenshot = __esm({
 var helpers_exports = {};
 __export(helpers_exports, {
   assertNodeAttached: () => assertNodeAttached,
-  captureElementScreenshot: () => captureElementScreenshot,
-  capturePageScreenshot: () => capturePageScreenshot,
-  documentReadyState: () => documentReadyState,
+  captureScreenshot: () => captureScreenshot,
   getDOMElements: () => getDOMElements,
   getDomContext: () => getDomContext,
-  getElementBounds: () => getElementBounds,
   noMatchesError: () => noMatchesError,
   pageDocumentId: () => pageDocumentId,
   queryDOMElements: () => queryDOMElements,
   resolveBackendNodeIds: () => resolveBackendNodeIds,
   resolveSelector: () => resolveSelector,
+  screenshotInterrupted: () => screenshotInterrupted,
   selectMatch: () => selectMatch
 });
 var init_helpers = __esm({
@@ -13956,11 +13507,15 @@ var program = new Command();
 // src/commands/helpJson.ts
 init_schema();
 
+// src/runtime/page/screenshotResize.ts
+var MAX_EDGE_PX = 1568;
+var PIXELS_PER_TOKEN = 750;
+var TALL_PAGE_THRESHOLD = 3;
+
 // src/commands/optionBehaviors.ts
-init_screenshotResize();
 var TRIGGERED_REQUESTS_BEHAVIOR = "Requests (and WebSocket connections) that start after the action begins are returned as triggeredRequests (method, url, status, durationMs; pending when still running at return, loading when the response arrived but its body is still streaming; with resourceType; human output lists documents, XHR/fetch and WebSockets first (up to 10) and counts static assets on one line; absent when network telemetry is off). Attribution is by time: requests a page timer or poller starts meanwhile are listed too, whether or not the action caused them";
-var ACTION_EFFECTS_BEHAVIOR = 'The result also says what changed on the page: a navigation (Page: navigated to <url> (status), or URL changed to <url> (same document); JSON navigation { url, sameDocument, status }), and messages that appeared or changed in alert/status/aria-live elements or flash/error/toast-like classes (New text: "\u2026" (element); JSON messages [{ text, element }], at most 3, with "(+N more)" and moreMessages for the rest; after a navigation every message on the new page counts; texts of only digits and time units, such as clocks and counters, are left out, but other text that changes on its own, such as a rotating banner, can show up). Both are absent when nothing changed. Cost: one page script sent before the action without waiting for it and one read after it, a few ms; when the page does not answer (a pending navigation) bdg waits at most 200 ms for the snapshot and 250 ms per read, and the navigation is still reported from CDP events';
-var STILL_CHANGING_BEHAVIOR = 'When the page was still changing as the action returned, the status line says (page still changing), a note below it says what was pending and suggests bdg dom wait <selector>, and JSON has settled: false with pending { requests (document, fetch/XHR and script requests still running), navigation (a new page still loading), loading (a loading indicator that appeared, e.g. "div#loading"), domChanging (DOM changes kept coming in bursts over a second look 250 ms later; a single render, ticking text and style animations do not count), busy (the page did not answer within 250 ms: a long script) }; absent when the page looked settled (exit code stays 0). A result a timer renders later, with no DOM change, request or loading indicator before it, is not detected. Cost: nothing extra, except 250 ms plus one read when the DOM looked busy. Not checked with --no-wait';
+var ACTION_EFFECTS_BEHAVIOR = 'The result also says what changed on the page: a navigation (Page: navigated to <url> (status), or URL changed to <url> (same document); JSON navigation { url, sameDocument, status }), and messages that appeared or changed in alert/status/aria-live elements or flash/error/toast-like classes (New text: "\u2026" (element); JSON messages [{ text, element }], at most 3, with "(+N more)" and moreMessages for the rest; after a navigation every message on the new page counts; texts of only digits and time units, such as clocks and counters, are left out, but other text that changes on its own, such as a rotating banner, can show up). Both are absent when nothing changed. Downloads that began meanwhile are listed (Download: <name> \u2192 <path> (<state>, <size>); JSON downloads [{ url, suggestedFilename, path, state: inProgress|completed|canceled, bytes }]); a Chrome bdg launched saves them into <session dir>/downloads (never ~/Downloads), named as suggested with (1), (2)\u2026 when taken, and one still running when the action returns is inProgress and appears at its path once complete; downloads of tabs the page opens (target=_blank, window.open) count too; when that directory cannot be created they are refused (canceled, with reason) instead of going to ~/Downloads, and if Chrome refuses the download behavior bdg status warns that downloads are not redirected; ones that begin after the action returned are listed by bdg status and bdg peek (Downloads: N (last: \u2026)); files stay after stop and cleanup; with --chrome-ws-url (the exception: not a browser bdg owns) downloads go to the download folder of that Chrome (usually ~/Downloads), only downloads of the session page are tracked (not those of tabs or popups it opens), and bdg sets behavior default with events, which replaces one another CDP client set and which Chrome drops when the session connection closes. Cost: one page script sent before the action without waiting for it and one read after it, a few ms; when the page does not answer (a pending navigation) bdg waits at most 200 ms for the snapshot and 250 ms per read, and the navigation is still reported from CDP events';
+var STILL_CHANGING_BEHAVIOR = 'When the page was still changing as the action returned, the status line says (page still changing), a note below it says what was pending and suggests bdg dom wait <selector>, and JSON has settled: false with pending { requests (document, fetch/XHR and script requests still running), navigation (a new page still loading), loading (a loading indicator that appeared, e.g. "div#loading"), domChanging (DOM changes came in bursts and, at a second look 250 ms later, again, with no quiet gap over 150 ms; time the page could not run its tasks, a long task or timers a starved renderer runs late, is not quiet, and a single burst more than 150 ms old with at most 75 ms of quiet time since also gets the second look (only that 250 ms; domChanging still needs a fresh change at it); a single render, ticking text and style animations do not count, and changes more than about 150 ms apart while the page could run look settled), busy (the page did not answer within 250 ms and ran a long task since the action began, or did not answer a check within 250 ms more: a long script; a page that answered late without a long task, a starved renderer, gets its answer waited for instead; a renderer descheduled in the middle of a task can still record a long task and is then busy; the check runs at most once per action, adding at most 250 ms, so an endless script is reported busy about 500 ms after the action) }; absent when the page looked settled (exit code stays 0). A result a timer renders later, with no DOM change, request or loading indicator before it, is not detected. Cost: nothing extra, except 250 ms plus one read when the DOM looked busy. Not checked with --no-wait';
 var SHOWN_BEHAVIOR = `Elements the action showed are listed (Shown: <element> "<text>"; JSON shown [{ text, element }], at most 3, outermost first): elements with visible text added inside the target's form, search box, dialog or combobox (else its grandparent, or its parent when that is the body), and popups and messages added anywhere (tooltip, menu, listbox, dialog, alert, status roles, popover, aria-live, message-like classes); widgets elsewhere on the page and re-rendered elements whose text was there before do not count`;
 var NO_WAIT_TRIGGERED_REQUESTS = "Returns immediately without waiting for network; triggeredRequests lists only requests bdg saw start before returning (often none yet; check bdg network list later)";
 var FOLLOW_BEHAVIOR = "Stops with exit 83 when the session it follows ends, 130 on Ctrl-C, 143 on SIGTERM; with --json prints one compact object per line (NDJSON). Other failures (a busy page, a timeout) are retried: reported once in text, as one error line per refresh in JSON";
@@ -14271,9 +13826,9 @@ var OPTION_BEHAVIORS = {
     automaticBehavior: FOLLOW_BEHAVIOR
   },
   "har:--include-sensitive": {
-    default: 'The HAR is sanitized: values become "[redacted]" for Authorization, Proxy-Authorization, Authentication, Cookie and Set-Cookie headers, X-*key/token/secret/auth headers and headers with an api-key/apikey/token/secret/jwt/subscription-key/session(-id) segment (www-authenticate is kept); every cookie value; query and fragment parameters named like credentials (plus code, sig, key) in the request URL, queryString, redirectURL and Location/Referer headers ("%5Bredacted%5D" in URLs); and password/token/secret/key/session/signature fields of JSON (primitives at any depth under such a name), form-urlencoded (also sniffed when the Content-Type says otherwise) and multipart request bodies. A JSON body too deep to walk becomes "[redacted]" whole. Header, cookie and parameter names, cookie attributes, headersSize and bodySize stay; log.comment and JSON sanitized: true say so',
+    default: `The HAR is sanitized: values become "[redacted]" for Authorization, Proxy-Authorization, Authentication, Cookie and Set-Cookie headers, X-*key/token/secret/auth headers and headers with an api-key/apikey/token/secret/jwt/subscription-key/session(-id) segment (www-authenticate is kept); every cookie value; query and fragment parameters named like credentials (plus code, sig, key) in the request URL, queryString, redirectURL and Location/Referer headers ("%5Bredacted%5D" in URLs); and password/token/secret/key/session/signature/bearer/cookie/csrf/refresh/auth/sid/pin/ssn/card-number fields of JSON (primitives at any depth under such a name), form-urlencoded (also sniffed when the Content-Type says otherwise, user[password] names too) and multipart request and response bodies (an access_token/refresh_token/id_token login response too) and of WebSocket messages, also in truncated JSON, JSON encoded in string values (3 levels), socket.io and SockJS packets, server-sent events, NDJSON, base64 bodies with no, a generic, JSON, form or event-stream type and binary WebSocket messages that are UTF-8 text; any whole JWT (eyJ\u2026) in a JSON string, form or URL value, multipart part or text body (only the JWT is replaced). camelCase names count as words (userPin). JSON is edited in place, not re-serialized: everything but the replaced values (64-bit numbers, formatting, duplicate keys, a BOM or )]}' prefix) stays byte for byte. Header, cookie and parameter names, cookie attributes, headersSize, bodySize and content.size stay; log.comment and JSON sanitized: true say so`,
     whenEnabled: "Writes every captured value (JSON sanitized: false); human output warns that the file holds credentials",
-    automaticBehavior: "Matching is by name, so it over-redacts: harmless values under credential-looking names (tokenCount: 5, sessionLength) are replaced too, and credentials under other names are kept. Unlike Chrome DevTools, which drops these headers and empties cookies, names are kept so the HAR still shows a request was authenticated. Response bodies and WebSocket messages are not redacted. HAR files are written readable by their owner only (0600). network headers and network getCookies always show real values"
+    automaticBehavior: 'Matching is by name, so it over-redacts: harmless values under credential-looking names (tokenCount: 5, sessionLength, refreshInterval, cookieConsent) are replaced too, and credentials under other names are kept. Only JSON syntax is understood: single-quoted strings, unquoted keys, JSONP, STOMP passcode: header lines and bare values with spaces ({"token":abc def}, a non-JWT token after Bearer in text) are not (fully) redacted. A body the sanitizer fails on is replaced whole by [redacted]. Unlike Chrome DevTools, which drops these headers and empties cookies, names are kept so the HAR still shows a request was authenticated. Kept as captured: other binary (base64) bodies, binary WebSocket messages that are not UTF-8, and text that is not JSON or a form (apart from JWTs); a WebSocket message cut at 100 KB has _truncatedFrom. HAR files are written readable by their owner only (0600). network headers and network getCookies always show real values'
   },
   "peek:--verbose": {
     default: "Compact output (truncated URLs, no resource types)",
@@ -14305,8 +13860,8 @@ var OPTION_BEHAVIORS = {
     whenEnabled: "Alias for --force, kept for compatibility"
   },
   "cleanup:--purge": {
-    default: "A named session's directory (Chrome profile, ~60 MB; logs; port.txt) is kept for its next start",
-    whenEnabled: "After cleaning up, deletes the directory of the session named by --session (exit 81 without --session); a running session is refused unless --force is given, and the directory is kept (exit 90) if the daemon still answers, cleanup reported a problem, or its Chrome has not exited"
+    default: "A named session's directory (Chrome profile, ~60 MB; logs; port.txt; downloads/) is kept for its next start",
+    whenEnabled: "After cleaning up, deletes the directory of the session named by --session, downloaded files included (exit 81 without --session); a running session is refused unless --force is given, and the directory is kept (exit 90) if the daemon still answers, cleanup reported a problem, or its Chrome has not exited"
   },
   "bdg:--viewport": {
     default: "A launched Chrome opens a 1920x1080 window (the viewport is smaller by the scrollbar, and in a visible window by the browser UI); an attached Chrome keeps its window",
@@ -14326,12 +13881,22 @@ var OPTION_BEHAVIORS = {
   "bdg:--chrome-ws-url": {
     default: "bdg launches its own Chrome (closed on stop)",
     whenEnabled: "Attaches to a running Chrome instead; it keeps running after stop. --port, -u and --[no-]headless cannot be combined with it (exit 81)",
-    automaticBehavior: "A port (9222), host:port or http://host:port is turned into the browser WebSocket URL via /json/version; a browser URL uses the first open tab. Refused with exit 90 when another running bdg session launched that Chrome or drives that tab (sessions of this BDG_SESSION_DIR, and of others that claimed a port)"
+    automaticBehavior: "A port (9222), host:port or http://host:port is turned into the browser WebSocket URL via /json/version; a browser URL uses the first open tab. Refused with exit 90 when another running bdg session launched that Chrome or drives that tab (sessions of this BDG_SESSION_DIR, and of others that claimed a port). Downloads are not redirected: they go to the download folder of that Chrome (usually ~/Downloads), and only downloads of the session page are reported (not those of tabs or popups it opens)"
   },
   "stop:--kill-chrome": {
     default: "Chrome launched by bdg is always closed on stop; an attached Chrome (--chrome-ws-url) is left running",
     whenEnabled: "No additional effect; kept for compatibility"
   },
+  "cdp:--send-anyway": {
+    default: "A Domain.method 1 edit from a bundled method or domain (2 for names over 5 letters, case ignored) is taken for a typo: exit 81 with Did you mean",
+    whenEnabled: "Sends such a name to Chrome as typed (for a method newer than the bundled protocol, e.g. next to a bundled sibling like getWindowBounds/setWindowBounds), with the not-in-bundled-protocol warning",
+    automaticBehavior: "Blocked methods (Page.captureScreenshot, Page.close, Browser.close), type names and names that are not Domain.method are still refused; a well-formed name far from every bundled one is sent without the flag"
+  },
+  "cdp:--describe": {
+    default: "Without --describe, a Domain.method is called (one missing from the bundled protocol is sent as typed, with a warning: only bundled methods are matched case-insensitively)",
+    whenEnabled: "Describes a domain, a method (parameters with ? for optional, returns, example) or a protocol type (Domain.Type: enum values or object properties)",
+    automaticBehavior: "Parameters referring to an enum type list its values inline (JSON enum, ref, refType); a redirected method (DOM.highlightNode) also shows the method implementing it and its parameters, which Chrome checks (JSON redirect, resolved: true); a redirect to a method the protocol lacks (Page.deleteCookie \u2192 Network.deleteCookie) is shown as unresolved (resolved: false). Example values work as typed: width 1280, height 800, x/y 100, deviceScaleFactor/scale 1, timeout 5000, url https://example.com, other numbers 1 (never 0, which often means off)"
+  },
   "status:--verbose": {
     default: "Basic session status (daemon running, session active, URL)",
     whenEnabled: "Includes Chrome diagnostics and CDP connection details"
@@ -14395,25 +13960,25 @@ var loggingBufferColumns = 25;
 var level_;
 var Log = class _Log {
   static _logToStdErr(title, argsArray) {
-    const log36 = _Log.loggerfn(title);
-    log36(...argsArray);
+    const log33 = _Log.loggerfn(title);
+    log33(...argsArray);
   }
   /**
    * @param {string} title
    */
   static loggerfn(title) {
     title = `LH:${title}`;
-    let log36 = loggersByTitle[title];
-    if (!log36) {
-      log36 = (0, import_debug.default)(title);
-      loggersByTitle[title] = log36;
+    let log33 = loggersByTitle[title];
+    if (!log33) {
+      log33 = (0, import_debug.default)(title);
+      loggersByTitle[title] = log33;
       if (title.endsWith("error")) {
-        log36.color = colors.red;
+        log33.color = colors.red;
       } else if (title.endsWith("warn")) {
-        log36.color = colors.yellow;
+        log33.color = colors.yellow;
       }
     }
-    return log36;
+    return log33;
   }
   /**
    * @param {string} level
@@ -14989,14 +14554,61 @@ function isDaemonSocketGone(socketPath = getSessionFilePath("DAEMON_SOCKET"), ti
   });
 }
 
+// src/session/metadata.ts
+init_logging();
+init_sessionCommand();
+init_atomicFile();
+init_errors();
+init_paths();
+import * as fs8 from "fs";
+var log6 = createLogger("session");
+function handleCorruptedMetadata(metaPath, error, options) {
+  if (options?.warnOnCorruption) {
+    log6.info(`Session metadata corrupted (cannot read details): ${getErrorMessage(error)}`);
+    log6.info(`Troubleshooting: Run "${sessionCommand("bdg cleanup")}" to remove corrupted files`);
+  }
+  if (options?.selfHealOnCorruption) {
+    try {
+      fs8.rmSync(metaPath, { force: true });
+      log6.info("Removed corrupted session metadata file");
+    } catch (deleteError) {
+      log6.debug(`Failed to remove corrupted metadata: ${getErrorMessage(deleteError)}`);
+    }
+  }
+}
+function readSessionMetadata(options) {
+  const metaPath = getSessionFilePath("METADATA");
+  if (!fs8.existsSync(metaPath)) {
+    return null;
+  }
+  try {
+    const content = fs8.readFileSync(metaPath, "utf-8");
+    return JSON.parse(content);
+  } catch (error) {
+    handleCorruptedMetadata(metaPath, error, options);
+    return null;
+  }
+}
+
 // src/session/cleanup/staleSession.ts
-init_metadata();
 init_paths();
 init_logging();
 
 // src/utils/async.ts
-function delay2(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+function delay2(ms, signal) {
+  return new Promise((resolve4) => {
+    if (signal?.aborted) {
+      resolve4();
+      return;
+    }
+    const done = () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", done);
+      resolve4();
+    };
+    const timer = setTimeout(done, ms);
+    signal?.addEventListener("abort", done, { once: true });
+  });
 }
 async function waitUntil(condition, timeoutMs, pollMs = 25) {
   const deadline = Date.now() + timeoutMs;
@@ -15010,12 +14622,12 @@ async function waitUntil(condition, timeoutMs, pollMs = 25) {
 // src/utils/file.ts
 init_logging();
 import * as fs9 from "fs";
-function safeRemoveFile(path8, context, log36) {
+function safeRemoveFile(path8, context, log33) {
   try {
     fs9.rmSync(path8, { force: true });
     return true;
   } catch (error) {
-    logDebugError(log36, `remove ${context}`, error);
+    logDebugError(log33, `remove ${context}`, error);
     return false;
   }
 }
@@ -15714,8 +15326,8 @@ function getVersion() {
 var VERSION = getVersion();
 
 // src/ui/OutputBuilder.ts
-function buildSuccessResponse(data) {
-  return { version: VERSION, success: true, data };
+function buildSuccessResponse(data, warning) {
+  return { version: VERSION, success: true, data, ...warning && { warning } };
 }
 function stringifyEnvelope(envelope) {
   return process.stdout.isTTY ? JSON.stringify(envelope, null, 2) : JSON.stringify(envelope);
@@ -15826,6 +15438,9 @@ function sessionEndedError() {
     EXIT_CODES.RESOURCE_NOT_FOUND
   );
 }
+function printWarning(warning) {
+  if (warning) console.error(escapeControlChars(`Warning: ${warning}`));
+}
 async function runCommand(handler, options, formatter) {
   try {
     const result = await handler(options);
@@ -15836,6 +15451,7 @@ async function runCommand(handler, options, formatter) {
           stringifyEnvelope(
             OutputBuilder.buildJsonError(result.error ?? "Unknown error", {
               ...result.errorContext,
+              ...result.warning && { warning: result.warning },
               exitCode
             })
           )
@@ -15851,14 +15467,16 @@ async function runCommand(handler, options, formatter) {
             }
           }
         }
+        printWarning(result.warning);
       }
       process.exit(exitCode);
     }
+    if (!options.json) printWarning(result.warning);
     if (result.hint && !options.quiet) {
       console.error(escapeControlChars(result.hint));
     }
     if (options.json) {
-      console.log(stringifyEnvelope(buildSuccessResponse(result.data)));
+      console.log(stringifyEnvelope(buildSuccessResponse(result.data, result.warning)));
     } else if (formatter) {
       const formattedOutput = formatter(result.data);
       console.log(escapeControlChars(formattedOutput));
@@ -15879,10 +15497,14 @@ async function runCommand(handler, options, formatter) {
           )
         );
       } else {
+        const { warning, ...metadata } = error.metadata;
         console.error(genericError(error.message));
-        for (const value of Object.values(error.metadata)) {
-          console.error(escapeControlChars(String(value)));
+        for (const value of Object.values(metadata)) {
+          console.error(
+            escapeControlChars(typeof value === "string" ? value : JSON.stringify(value))
+          );
         }
+        printWarning(warning);
       }
       process.exit(error.exitCode);
     }
@@ -15912,6 +15534,9 @@ async function runCommand(handler, options, formatter) {
   }
 }
 
+// src/commands/shared/startHelpers.ts
+init_interrupt();
+
 // src/ui/messages/session.ts
 init_formatting();
 init_commands();
@@ -16057,7 +15682,13 @@ async function launchDaemon() {
   });
   daemon.unref();
   await waitForDaemonReady(() => exited);
-  return { pid: daemon.pid, hasExited: () => exited };
+  return {
+    pid: daemon.pid,
+    hasExited: () => exited,
+    stop: () => {
+      if (!exited) daemon.kill("SIGTERM");
+    }
+  };
 }
 var UNREACHABLE_DAEMON_EXIT_MS = 8e3;
 async function stopUnreachableDaemon() {
@@ -16190,6 +15821,7 @@ var COMMANDS = {
   dom_audit: defineCommand(),
   css_search: defineCommand(),
   dom_inspect: defineCommand(),
+  dom_screenshot: defineCommand(),
   dom_wait: defineCommand()
 };
 
@@ -16272,27 +15904,58 @@ var SPAWNED_DAEMON_EXIT_WAIT_MS = 3e3;
 var DEFAULT_START_DEPS = {
   launch: launchDaemon,
   send: startSession,
+  stop: stopSession,
   exitWaitMs: SPAWNED_DAEMON_EXIT_WAIT_MS
 };
 async function startSessionViaDaemon(url, options, telemetry) {
-  process.once("SIGINT", () => reportStartOutcome(interruptedOutcome("SIGINT"), options));
-  process.once("SIGTERM", () => reportStartOutcome(interruptedOutcome("SIGTERM"), options));
-  reportStartOutcome(await attemptStart(url, options, telemetry), options);
+  const interrupt = new AbortController();
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.on(signal, () => {
+      if (interrupt.signal.aborted) reportStartOutcome(interruptedOutcome(signal), options);
+      interrupt.abort(signal);
+    });
+  }
+  reportStartOutcome(
+    await attemptStart(url, options, telemetry, DEFAULT_START_DEPS, interrupt.signal),
+    options
+  );
 }
-async function attemptStart(url, options, telemetry, deps = DEFAULT_START_DEPS) {
+async function attemptStart(url, options, telemetry, deps = DEFAULT_START_DEPS, interrupt) {
   const spawned = [];
   const attempt = async () => {
-    const outcome2 = await requestSession(url, options, telemetry, deps);
+    const outcome2 = await requestSession(url, options, telemetry, deps, interrupt);
     if (!outcome2.ok && outcome2.spawned) spawned.push(outcome2.spawned);
     return outcome2;
   };
   let outcome = await attempt();
   const deadline = Date.now() + SHUTDOWN_WAIT_MS;
   while (isShuttingDown(outcome) && Date.now() < deadline) {
-    await delay2(SHUTDOWN_POLL_MS);
+    await delay2(SHUTDOWN_POLL_MS, interrupt);
     outcome = await attempt();
   }
-  return afterSpawnedDaemonExit(outcome, spawned, deps.exitWaitMs);
+  return settleOutcome(outcome, spawned, deps, interrupt);
+}
+async function settleOutcome(outcome, spawned, deps, interrupt) {
+  if (outcome.ok) {
+    const { spawned: daemon, ...started } = outcome;
+    return interrupt?.aborted ? cancelStartedSession(started.data, daemon, deps, interrupt) : started;
+  }
+  const failure = await afterSpawnedDaemonExit(outcome, spawned, deps.exitWaitMs);
+  return interrupt?.aborted ? withInterruptExitCode(failure, interrupt) : failure;
+}
+function cancelStartedSession(data, spawned, deps, interrupt) {
+  log11.debug("Interrupted as the session started; stopping it");
+  deps.stop().catch((error) => {
+    log11.debug(`Stopping the interrupted session failed: ${getErrorMessage(error)}`);
+  });
+  const daemon = spawned ?? {
+    pid: data.daemonPid,
+    hasExited: () => !isProcessAlive(data.daemonPid)
+  };
+  return afterSpawnedDaemonExit(cancelledOutcome(interrupt), [daemon], deps.exitWaitMs);
+}
+function withInterruptExitCode(outcome, interrupt) {
+  return outcome.ok ? outcome : { ...outcome, exitCode: interruptExitCode(interruptSignal(interrupt)) };
 }
 async function afterSpawnedDaemonExit(outcome, spawned, waitMs) {
   if (outcome.ok) return outcome;
@@ -16320,15 +15983,18 @@ async function afterSpawnedDaemonExit(outcome, spawned, waitMs) {
 }
 function interruptedOutcome(signal) {
   const message = `Start cancelled (${signal === "SIGINT" ? "interrupted" : "terminated"})`;
-  const exitCode = signal === "SIGINT" ? EXIT_CODES.INTERRUPTED : EXIT_CODES.TERMINATED;
-  return { ok: false, error: message, human: message, exitCode };
+  return { ok: false, error: message, human: message, exitCode: interruptExitCode(signal) };
+}
+function cancelledOutcome(interrupt) {
+  return interruptedOutcome(interruptSignal(interrupt));
 }
 var SHUTDOWN_WAIT_MS = 15e3;
 var SHUTDOWN_POLL_MS = 200;
 function isShuttingDown(outcome) {
   return !outcome.ok && (outcome.retryable === true || outcome.errorCode === "SESSION_SHUTTING_DOWN" /* SESSION_SHUTTING_DOWN */);
 }
-async function requestSession(url, options, telemetry, deps) {
+async function requestSession(url, options, telemetry, deps, interrupt) {
+  if (interrupt?.aborted) return cancelledOutcome(interrupt);
   let spawned;
   try {
     spawned = await deps.launch();
@@ -16346,10 +16012,16 @@ async function requestSession(url, options, telemetry, deps) {
     const exitCode = error instanceof DaemonError ? error.exitCode : EXIT_CODES.SOFTWARE_ERROR;
     return { ok: false, error: message, human: genericError(message), exitCode };
   }
-  const outcome = await sendStart(url, options, telemetry, deps.send);
-  return !outcome.ok && outcome.daemonExiting && spawned ? { ...outcome, spawned } : outcome;
+  if (interrupt?.aborted) return cancelBeforeRequest(spawned, interrupt);
+  const outcome = await sendStart(url, options, telemetry, deps.send, interrupt);
+  return spawned && (outcome.ok || outcome.daemonExiting) ? { ...outcome, spawned } : outcome;
+}
+function cancelBeforeRequest(spawned, interrupt) {
+  if (!spawned) return cancelledOutcome(interrupt);
+  spawned.stop();
+  return { ...cancelledOutcome(interrupt), daemonExiting: true, spawned };
 }
-async function sendStart(url, options, telemetry, send) {
+async function sendStart(url, options, telemetry, send, interrupt) {
   try {
     log11.debug("Connecting to daemon...");
     const response = await send(
@@ -16366,7 +16038,8 @@ async function sendStart(url, options, telemetry, send) {
         chromeFlags: options.chromeFlags,
         viewport: options.viewport,
         colorScheme: options.colorScheme
-      })
+      }),
+      interrupt
     );
     if (response.status === "error") {
       return { ...describeStartFailure(response, options), daemonExiting: true };
@@ -16382,6 +16055,7 @@ async function sendStart(url, options, telemetry, send) {
     }
     return { ok: true, data: response.data };
   } catch (error) {
+    if (interrupt?.aborted) return { ...cancelledOutcome(interrupt), daemonExiting: true };
     if (error instanceof IPCTimeoutError) {
       const timeout = timeoutError(error);
       return {
@@ -16731,9 +16405,11 @@ var CDP_HTTP_TIMEOUT_MS = 5e3;
 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;
+  const timeout = AbortSignal.timeout(timeoutMs);
+  const signal = options?.signal ? AbortSignal.any([timeout, options.signal]) : timeout;
   let response;
   try {
-    response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+    response = await fetch(url, { signal });
   } catch (error) {
     logger?.debug(`Chrome version request failed: ${getErrorMessage(error)} (${url})`);
     return { kind: "unreachable" };
@@ -17048,6 +16724,50 @@ function assertValidChromeWsUrl(url) {
 init_errors3();
 init_messages();
 
+// src/cdp/methodTarget.ts
+init_protocol();
+init_levenshtein();
+init_suggestions();
+var METHOD_NAME = /^[A-Za-z][A-Za-z0-9]*\.[A-Za-z][A-Za-z0-9]*$/;
+function typoLimit(name) {
+  return name.length <= 5 ? 1 : 2;
+}
+function closeNames(input, candidates) {
+  const lower = input.toLowerCase();
+  return candidates.map((name) => ({ name, distance: levenshteinDistance(lower, name.toLowerCase()) })).filter(({ distance }) => distance > 0 && distance <= typoLimit(input)).sort((a, b) => a.distance - b.distance).map(({ name }) => name);
+}
+function closeMethods(domainName, methodName) {
+  const commands = findDomain(domainName)?.commands ?? [];
+  const exact = commands.find((c) => c.name.toLowerCase() === methodName.toLowerCase());
+  const names = exact ? [exact.name] : closeNames(
+    methodName,
+    commands.map((c) => c.name)
+  );
+  return names.map((name) => `${domainName}.${name}`);
+}
+function resolveUnknownDomain(domainName, methodName) {
+  const domains = closeNames(
+    domainName,
+    loadProtocol().domains.map((d) => d.domain)
+  );
+  const method = `${domainName}.${methodName}`;
+  if (domains.length === 0) return { kind: "unlisted", method };
+  return { kind: "typo", method, suggestions: domains.flatMap((d) => closeMethods(d, methodName)) };
+}
+function resolveMethodTarget(input) {
+  if (!METHOD_NAME.test(input)) return { kind: "malformed" };
+  const known = normalizeMethod(input);
+  if (known) return { kind: "known", method: known };
+  const [domainName = "", methodName = ""] = input.split(".");
+  const domain = findDomain(domainName);
+  if (!domain) return resolveUnknownDomain(domainName, methodName);
+  const type = findType(domain.domain, methodName);
+  if (type) return { kind: "type", name: `${domain.domain}.${type.id}` };
+  const method = `${domain.domain}.${methodName}`;
+  const suggestions = closeMethods(domain.domain, methodName);
+  return suggestions.length > 0 ? { kind: "typo", method, suggestions } : { kind: "unlisted", method };
+}
+
 // src/commands/cdp.ts
 init_protocol();
 init_schema();
@@ -17055,8 +16775,10 @@ init_errors3();
 init_messages();
 init_client();
 
+// src/connection/errors.ts
+init_exitCodes();
+
 // src/runtime/dom/evalHelpers.ts
-init_errors5();
 init_errors3();
 init_messages();
 
@@ -17090,11 +16812,7 @@ var WEBSOCKET_CONFIG = {
   noPongClosure: 1001
 };
 
-// src/connection/cdp.ts
-init_errors5();
-
 // src/daemon/session/cdpSetup.ts
-init_errors5();
 init_constants();
 init_errors3();
 init_messages();
@@ -17288,6 +17006,7 @@ function describeException(details) {
 
 // src/ui/formatters/cdp.ts
 init_formatting();
+init_commands();
 function firstSentence(description) {
   const [line = ""] = (description ?? "").split("\n");
   const end = line.indexOf(". ");
@@ -17306,6 +17025,16 @@ function columns(rows) {
 function typeText(field) {
   return field.items ? `${field.type}<${field.items}>` : field.type;
 }
+var MAX_ENUM_VALUES = 8;
+function expansionText(field) {
+  const values = field.enum;
+  if (!values || values.length === 0) {
+    return field.refType && field.refType !== "object" ? ` (${field.refType})` : "";
+  }
+  const shown = values.slice(0, MAX_ENUM_VALUES);
+  const more = values.length - shown.length;
+  return ` (${[...shown, ...more > 0 ? [`\u2026 ${more} more`] : []].join("|")})`;
+}
 function formatCdpSearch(data) {
   if (data.count === 0) {
     return joinLines(`No CDP method matches "${data.query}"`, "List the domains: bdg cdp --list");
@@ -17342,13 +17071,37 @@ function fieldSection(title, fields) {
     `${title}:`,
     ...columns(
       fields.map((f) => [
-        `${f.name}${f.optional ? "?" : ""}: ${typeText(f)}`,
-        (f.description ?? "").replace(/\s*\n\s*/g, " ")
+        `${f.name}${f.optional ? "?" : ""}: ${typeText(f)}${expansionText(f)}`,
+        `${(f.description ?? "").replace(/\s*\n\s*/g, " ")}${tags(f)}`
       ])
     )
   ];
 }
+function parameterFields(parameters) {
+  return parameters.map((p) => ({ ...p, optional: !p.required }));
+}
+function typeHint(parameters) {
+  const ref = parameters.find((p) => p.refType === "object")?.ref;
+  return ref && `Describe a type: bdg cdp ${ref} --describe`;
+}
+function redirectSection(redirect) {
+  if (!redirect) return [];
+  if (!redirect.resolved) return [cdpUnresolvedRedirectLine(redirect.method)];
+  const title = cdpRedirectTitle(redirect.method);
+  return redirect.parameters.length === 0 ? [title] : fieldSection(`${title}, with these parameters`, parameterFields(redirect.parameters));
+}
+function formatCdpType(data) {
+  const properties = data.properties ?? [];
+  return joinLines(
+    `${data.name}: ${typeText({ name: data.id, type: data.baseType, items: data.items })}${tags(data)}`,
+    data.description,
+    data.enum && `Values: ${data.enum.join(", ")}`,
+    ...fieldSection("Properties", parameterFields(properties)),
+    typeHint(properties)
+  );
+}
 function formatCdpDescription(data) {
+  if (data.type === "type") return formatCdpType(data);
   if (data.type === "domain") {
     return joinLines(
       `${data.domain}: ${pluralize(data.commands, "method")}, ${pluralize(data.events, "event")}${tags(data)}`,
@@ -17357,15 +17110,15 @@ function formatCdpDescription(data) {
       data.nextStep
     );
   }
+  const redirected = data.redirect?.parameters ?? [];
   return joinLines(
     `${data.name}${tags(data)}`,
     data.description,
-    ...fieldSection(
-      "Parameters",
-      data.parameters.map((p) => ({ ...p, optional: !p.required }))
-    ),
+    ...fieldSection("Parameters", parameterFields(data.parameters)),
+    ...redirectSection(data.redirect),
     ...fieldSection("Returns", data.returns),
     data.note && `Note: ${data.note}`,
+    typeHint([...data.parameters, ...redirected]),
     data.example && `Example: ${data.example.command}`
   );
 }
@@ -17376,6 +17129,9 @@ function formatCdpResult(data) {
   return isEmptyCdpResult(data.result) ? `${data.method}: done (no result data)` : JSON.stringify(data.result, null, 2);
 }
 
+// src/commands/cdp.ts
+init_commands();
+
 // src/ui/messages/hints.ts
 init_formatting();
 init_sessionCommand();
@@ -17429,13 +17185,18 @@ function getMethodHint(methodName, result) {
 }
 function registerCdpCommand(program2) {
   program2.command("cdp").summary("CDP protocol introspection and execution").description(
-    "CDP protocol introspection and execution\n  Discovery: --list, --search, --describe\n  Execution: case-insensitive (network.getcookies works)"
+    "CDP protocol introspection and execution\n  Discovery: --list, --search, --describe\n" + CDP_EXECUTION_HELP
   ).argument("[method]", "CDP method name (e.g., Network.getCookies, network.getcookies)").addOption(new Option("--params <json>", "Method parameters as JSON")).addOption(
     new Option("--list", "List all domains or methods in a domain").conflicts([
       "describe",
       "params"
     ])
   ).addOption(new Option("--describe", "Show method signature and parameters").conflicts("params")).addOption(
+    new Option(
+      "--send-anyway",
+      "Send a Domain.method that looks like a typo of a bundled one as typed"
+    ).conflicts(["list", "describe", "search"])
+  ).addOption(
     new Option("--search <query>", "Search methods by keyword").conflicts([
       "list",
       "describe",
@@ -17459,11 +17220,7 @@ async function runCdpCommand(method, options) {
     return runCommand(async () => handleDescribeMethod(method), options, formatCdpDescription);
   }
   if (method) {
-    return runCommand(
-      async () => handleExecuteMethod(method, options.params),
-      options,
-      formatCdpResult
-    );
+    return runCommand(async () => handleExecuteMethod(method, options), options, formatCdpResult);
   }
   return runCommand(async () => {
     const err = missingArgumentError(CDP_USAGE);
@@ -17617,94 +17374,97 @@ function handleListDomainMethods(domainName) {
     }
   };
 }
-function handleDescribeMethod(methodName) {
-  const [domainName, method] = methodName.includes(".") ? methodName.split(".") : [methodName, void 0];
-  if (!method) {
-    const summary = getDomainSummary(domainName);
-    if (!summary) {
-      const similar = findSimilarMethods(methodName);
-      const suggestions = ["Use: bdg cdp --list (to see all domains)"];
-      if (similar.length > 0) {
-        suggestions.push("");
-        suggestions.push("Did you mean:");
-        similar.forEach((name) => suggestions.push(`  - ${name}`));
-      }
-      return {
-        success: false,
-        error: `Domain or method '${methodName}' not found`,
-        exitCode: EXIT_CODES.INVALID_ARGUMENTS,
-        errorContext: {
-          suggestion: suggestions.join("\n")
-        }
-      };
-    }
-    const domainNote = DOMAIN_NOTES[summary.name];
-    return {
-      success: true,
-      data: {
-        type: "domain",
-        domain: summary.name,
-        description: summary.description,
-        commands: summary.commandCount,
-        events: summary.eventCount,
-        experimental: summary.experimental,
-        deprecated: summary.deprecated,
-        note: domainNote,
-        nextStep: `Use: bdg cdp ${summary.name} --list (to see all methods)`
-      }
-    };
-  }
-  const schema = getMethodSchema(domainName, method);
-  if (!schema) {
-    const similar = findSimilarMethods(methodName, domainName);
-    const suggestions = [`Use: bdg cdp ${domainName} --list (to see all ${domainName} methods)`];
-    if (similar.length > 0) {
-      suggestions.push("");
-      suggestions.push("Did you mean:");
-      similar.forEach((name) => suggestions.push(`  - ${name}`));
-    }
+function handleDescribeMethod(name) {
+  const [domainName = "", member] = name.includes(".") ? name.split(".") : [name, void 0];
+  if (!member) return describeDomain(name);
+  const schema = getMethodSchema(domainName, member);
+  if (schema) return { success: true, data: describeMethod(schema) };
+  const type = getTypeSchema(domainName, member);
+  if (type) return { success: true, data: { type: "type", ...type } };
+  const target = resolveMethodTarget(name);
+  const err = target.kind === "unlisted" ? cdpMethodNotInBundledProtocolError(target.method, getBundledProtocolVersion()) : cdpMethodNotFoundError(
+    name,
+    findSimilarMethods(name, domainName),
+    `Use: bdg cdp ${domainName} --list (to see all ${domainName} methods)`
+  );
+  return {
+    success: false,
+    error: err.message,
+    exitCode: EXIT_CODES.INVALID_ARGUMENTS,
+    errorContext: { suggestion: err.suggestion }
+  };
+}
+function describeDomain(domainName) {
+  const summary = getDomainSummary(domainName);
+  if (!summary) {
+    const err = cdpMethodNotFoundError(
+      domainName,
+      findSimilarMethods(domainName),
+      "Use: bdg cdp --list (to see all domains)"
+    );
     return {
       success: false,
-      error: `Method '${methodName}' not found`,
+      error: `Domain or method '${domainName}' not found`,
       exitCode: EXIT_CODES.INVALID_ARGUMENTS,
-      errorContext: {
-        suggestion: suggestions.join("\n")
-      }
+      errorContext: { suggestion: err.suggestion }
     };
   }
-  const methodNote = METHOD_NOTES[schema.name] ?? DOMAIN_NOTES[schema.domain];
-  const alternative = blockedAlternative(schema.name);
   return {
     success: true,
     data: {
-      type: "method",
-      name: schema.name,
-      domain: schema.domain,
-      method: schema.method,
-      description: schema.description,
-      experimental: schema.experimental,
-      deprecated: schema.deprecated,
-      note: methodNote,
-      parameters: schema.parameters.map((p) => ({
-        name: p.name,
-        type: p.type,
-        required: p.required,
-        description: p.description,
-        enum: p.enum,
-        items: p.items,
-        deprecated: p.deprecated
-      })),
-      returns: schema.returns.map((r) => ({
-        name: r.name,
-        type: r.type,
-        optional: r.optional,
-        description: r.description,
-        items: r.items
-      })),
-      example: alternative ? { command: alternative } : schema.example
+      type: "domain",
+      domain: summary.name,
+      description: summary.description,
+      commands: summary.commandCount,
+      events: summary.eventCount,
+      experimental: summary.experimental,
+      deprecated: summary.deprecated,
+      note: DOMAIN_NOTES[summary.name],
+      nextStep: `Use: bdg cdp ${summary.name} --list (to see all methods)`
     }
   };
 }
+function describeParameter(p) {
+  return {
+    name: p.name,
+    type: p.type,
+    required: p.required,
+    description: p.description,
+    enum: p.enum,
+    ref: p.ref,
+    refType: p.refType,
+    items: p.items,
+    experimental: p.experimental,
+    deprecated: p.deprecated
+  };
+}
+function describeMethod(schema) {
+  const alternative = blockedAlternative(schema.name);
+  return {
+    type: "method",
+    name: schema.name,
+    domain: schema.domain,
+    method: schema.method,
+    description: schema.description,
+    experimental: schema.experimental,
+    deprecated: schema.deprecated,
+    note: METHOD_NOTES[schema.name] ?? DOMAIN_NOTES[schema.domain],
+    parameters: schema.parameters.map(describeParameter),
+    returns: schema.returns.map((r) => ({
+      name: r.name,
+      type: r.type,
+      optional: r.optional,
+      description: r.description,
+      items: r.items
+    })),
+    redirect: schema.redirect && {
+      method: schema.redirect.method,
+      resolved: schema.redirect.resolved,
+      parameters: schema.redirect.parameters.map(describeParameter)
+    },
+    example: alternative ? { command: alternative } : schema.example
+  };
+}
 var BLOCKED_CDP_METHODS = {
   "Page.captureScreenshot": {
     alternative: "bdg dom screenshot [path]",
@@ -17719,38 +17479,53 @@ var BLOCKED_CDP_METHODS = {
     reason: "Closes Chrome under the session, which then ends without saving its state"
   }
 };
-async function handleExecuteMethod(methodName, paramsJson) {
-  const normalized = normalizeMethod(methodName);
-  if (normalized && BLOCKED_CDP_METHODS[normalized]) {
-    const blocked = BLOCKED_CDP_METHODS[normalized];
-    return {
-      success: false,
-      error: `${normalized} is blocked via raw CDP: ${blocked.reason}`,
-      exitCode: EXIT_CODES.INVALID_ARGUMENTS,
-      errorContext: { suggestion: `Use: ${sessionCommand(blocked.alternative)}` }
-    };
-  }
-  if (!normalized) {
-    const similar = findSimilarMethods(methodName);
-    const suggestions = ["Use: bdg cdp --search <keyword> (to search for methods)"];
-    if (similar.length > 0) {
-      suggestions.push("");
-      suggestions.push("Did you mean:");
-      similar.forEach((name) => suggestions.push(`  - ${name}`));
+function methodToSend(methodName, options = {}) {
+  const target = resolveMethodTarget(methodName);
+  if (target.kind === "known") {
+    const blocked = BLOCKED_CDP_METHODS[target.method];
+    if (blocked) {
+      throw new CommandError(
+        `${target.method} is blocked via raw CDP: ${blocked.reason}`,
+        { suggestion: `Use: ${sessionCommand(blocked.alternative)}` },
+        EXIT_CODES.INVALID_ARGUMENTS
+      );
     }
+    return { method: target.method };
+  }
+  if (target.kind === "unlisted" || target.kind === "typo" && options.sendAnyway) {
     return {
-      success: false,
-      error: `Method '${methodName}' not found`,
-      exitCode: EXIT_CODES.INVALID_ARGUMENTS,
-      errorContext: {
-        suggestion: suggestions.join("\n")
-      }
+      method: target.method,
+      warning: cdpUnlistedMethodWarning(target.method, getBundledProtocolVersion())
     };
   }
+  const err = target.kind === "type" ? cdpTypeNotMethodError(target.name) : unknownMethodError(methodName, target);
+  throw new CommandError(err.message, { suggestion: err.suggestion }, EXIT_CODES.INVALID_ARGUMENTS);
+}
+function unknownMethodError(methodName, target) {
+  if (target.kind === "malformed") {
+    return cdpMethodNotFoundError(
+      methodName,
+      findSimilarMethods(methodName),
+      "Use: bdg cdp --search <keyword> (to search for methods)"
+    );
+  }
+  const [domainName = ""] = methodName.split(".");
+  return target.suggestions.length > 0 ? cdpMethodTypoError(
+    methodName,
+    target.suggestions.slice(0, 3),
+    "Use: bdg cdp --search <keyword> (to search for methods)"
+  ) : cdpMethodTypoError(methodName, [], domainSuggestion(domainName));
+}
+function withWarning(error, warning) {
+  if (!warning || !(error instanceof CommandError)) return error;
+  return new CommandError(error.message, { ...error.metadata, warning }, error.exitCode);
+}
+async function handleExecuteMethod(methodName, options) {
+  const { method: normalized, warning } = methodToSend(methodName, options);
   let params;
-  if (paramsJson) {
+  if (options.params) {
     try {
-      params = JSON.parse(paramsJson);
+      params = JSON.parse(options.params);
     } catch (error) {
       return {
         success: false,
@@ -17758,31 +17533,31 @@ async function handleExecuteMethod(methodName, paramsJson) {
         exitCode: EXIT_CODES.INVALID_ARGUMENTS,
         errorContext: {
           suggestion: `Use: bdg cdp ${normalized} --describe (to see parameter schema)`
-        }
+        },
+        ...warning && { warning }
       };
     }
   }
   const response = await callCDP(normalized, params);
-  validateIPCResponse(response);
-  const cdpResult = response.data?.result;
+  try {
+    validateIPCResponse(response);
+  } catch (error) {
+    throw withWarning(error, warning);
+  }
+  const ipcHint = response.data?.hint && formatHint(response.data.hint);
+  return cdpCallResult(normalized, response.data?.result, warning, ipcHint);
+}
+function cdpCallResult(method, cdpResult, warning, ipcHint) {
+  const withCallWarning = warning ? { warning } : {};
   const exception = pageExceptionResult(cdpResult);
-  if (exception) return exception;
-  const result = {
+  if (exception) return { ...exception, ...withCallWarning };
+  const hints = [ipcHint, getMethodHint(method, cdpResult)].filter(Boolean);
+  return {
     success: true,
-    data: {
-      method: normalized,
-      result: cdpResult
-    }
+    data: { method, result: cdpResult },
+    ...withCallWarning,
+    ...hints.length > 0 && { hint: hints.join("\n") }
   };
-  if (response.data?.hint) {
-    result.hint = formatHint(response.data.hint);
-  }
-  const methodHint = getMethodHint(normalized, cdpResult);
-  if (methodHint) {
-    result.hint = result.hint ? `${result.hint}
-${methodHint}` : methodHint;
-  }
-  return result;
 }
 
 // src/commands/cleanup.ts
@@ -17885,6 +17660,7 @@ function formatCleanup(data) {
   return joinLines(
     cleaned.session && sessionFilesCleanedMessage(),
     cleaned.output && sessionOutputRemovedMessage(),
+    data.downloadsKept && downloadsKeptMessage(data.downloadsKept.dir, data.downloadsKept.files),
     ...(data.warnings ?? []).map((warning) => warningMessage(warning)),
     "",
     data.message
@@ -17973,18 +17749,26 @@ async function cleanupSession(opts) {
     };
   }
   const didCleanup = Object.values(cleaned).some(Boolean) || purged !== void 0;
+  const downloadsKept = purged === void 0 ? keptDownloads() : void 0;
   return {
     success: true,
     data: {
       cleaned,
       ...purged !== void 0 && { purged },
+      ...downloadsKept && { downloadsKept },
       message: !didCleanup ? noSessionFilesMessage() : purged !== void 0 ? sessionDirectoryPurgedMessage(purged) : sessionDirectoryCleanMessage(),
       ...warnings.length > 0 && { warnings }
     }
   };
 }
+function keptDownloads() {
+  const dir = getSessionDownloadsDir();
+  if (!fs14.existsSync(dir) || !fs14.statSync(dir).isDirectory()) return void 0;
+  const files = fs14.readdirSync(dir).length;
+  return files > 0 ? { dir, files } : void 0;
+}
 function registerCleanupCommand(program2) {
-  program2.command("cleanup").description("Clean up stale session files").option("-f, --force", "Kill a running (possibly hung) session, then clean up", false).option("--remove-output", "Also remove session.json output file", false).option("--aggressive", "Alias for --force (kept for compatibility)", false).option(
+  program2.command("cleanup").description("Clean up stale session files (downloaded files are kept)").option("-f, --force", "Kill a running (possibly hung) session, then clean up", false).option("--remove-output", "Also remove session.json output file", false).option("--aggressive", "Alias for --force (kept for compatibility)", false).option(
     "--purge",
     "Also delete a named session's directory (Chrome profile, logs, port); needs --session",
     false
@@ -18901,7 +18685,11 @@ function megabytes(bytes) {
 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 bodies = pluralize(
+    bodiesEvicted,
+    "older request/response body",
+    "older request/response bodies"
+  );
   const budget = megabytes(MAX_TOTAL_BODY_BYTES);
   if (requestsDropped > 0 && bodiesEvicted > 0) {
     return `\u26A0 ${requests} dropped, ${bodies} evicted: bdg keeps the newest ${MAX_NETWORK_REQUESTS} requests and ${budget} of bodies`;
@@ -18927,11 +18715,11 @@ function localProxyNote() {
   return "(loopback; likely a local proxy)";
 }
 function harSanitizedComment() {
-  return "Sanitized by bdg: values of auth, cookie, API key, token and session headers, cookies, credential query parameters in URLs, and password/token fields of request bodies are [redacted] (by name, so some harmless values are too); response bodies and WebSocket messages are not sanitized. Export with --include-sensitive to keep everything";
+  return "Sanitized by bdg: values of auth, cookie, API key, token and session headers, cookies, credential query parameters in URLs, password/token/secret fields of JSON and form request and response bodies and WebSocket messages (also truncated JSON, JSON encoded in strings, socket.io, SockJS, server-sent events, NDJSON, and base64 bodies and binary messages that are UTF-8 text), and any JWT (also inside longer strings and form values) are [redacted] in place (by name, so some harmless values are too); everything else stays byte for byte. Not sanitized: other binary data, text that is not JSON or a form, and non-JSON syntax (single quotes, unquoted keys, JSONP, bare values with spaces); a body that could not be sanitized is [redacted] whole. Export with --include-sensitive to keep everything";
 }
 function harExportedMessage(result) {
   const filterNote = result.filtered ? " (filtered)" : "";
-  const note = result.sanitized ? "Credentials sanitized (auth/cookie/API key/token headers, cookies, URL tokens, password and token body fields are [redacted]); --include-sensitive keeps them" : "\u26A0 Includes credentials (--include-sensitive): share this file with care";
+  const note = result.sanitized ? "Credentials sanitized (auth/cookie/API key/token headers, cookies, URL tokens, password and token fields of bodies and WebSocket messages are [redacted]); --include-sensitive keeps them" : "\u26A0 Includes credentials (--include-sensitive): share this file with care";
   return `\u2713 Exported ${result.entries} requests${filterNote} to ${result.file}
   ${note}`;
 }
@@ -19047,10 +18835,6 @@ function addWebSocketMessages(fmt, webSocket) {
   webSocket.frames.forEach((frame) => fmt.text(formatWebSocketMessage(frame)));
 }
 var BODY_PREVIEW_LENGTH = 2e4;
-function formatBytes(bytes) {
-  if (bytes < 1024) return `${bytes} B`;
-  return bytes < 1024 * 1024 ? `${(bytes / 1024).toFixed(1)} KB` : `${(bytes / 1024 / 1024).toFixed(1)} MB`;
-}
 function isLoopback(ip) {
   const bare = ip.replace(/^\[|\]$/g, "").toLowerCase();
   return /^(::ffff:)?127\./.test(bare) || bare === "::1";
@@ -19126,7 +18910,11 @@ function formatNetworkDetails(request) {
   fmt.keyValueList(requestSummaryRows(request));
   fmt.blank();
   if (request.requestHeaders) addHeaders(fmt, "Request Headers:", request.requestHeaders);
-  if (request.requestBody) {
+  if (request.requestBodyNotCaptured) {
+    fmt.text("Request Body:").separator("\u2501", 70);
+    fmt.text(`(not captured: ${request.requestBodyNotCaptured})`);
+    fmt.blank();
+  } else if (request.requestBody) {
     fmt.text("Request Body:").separator("\u2501", 70);
     fmt.text(request.requestBody);
     fmt.blank();
@@ -19904,6 +19692,8 @@ function formatActionOutput(done, details, result, options = {}) {
   if (requests.length > 0) {
     fmt.blank().section(formatTriggeredRequestsTitle(result.triggeredRequests ?? [], omitted), requests);
   }
+  if (result.downloads?.length) fmt.blank();
+  for (const download of result.downloads ?? []) fmt.text(downloadText(download));
   for (const dialog of result.dialogs ?? []) {
     fmt.blank();
     fmt.text(`Dialog: ${dialogConsoleText(dialog)}`);
@@ -20236,7 +20026,7 @@ init_elementInfo();
 init_frameScopedConnection();
 init_logging();
 init_errors();
-var log27 = createLogger("dom");
+var log24 = createLogger("dom");
 function childFrameIds(tree) {
   return (tree?.childFrames ?? []).flatMap((child) => [child.frame.id, ...childFrameIds(child)]);
 }
@@ -21439,7 +21229,7 @@ function formatFormDiscovery(result) {
 init_logging();
 init_errors();
 init_exitCodes();
-var log28 = createLogger("dom");
+var log25 = createLogger("dom");
 function buildValidation(raw) {
   const hasNativeError = !raw.isValid && !raw.valueMissing && raw.validationMessage;
   const hasAriaError = raw.ariaInvalid;
@@ -21596,7 +21386,7 @@ async function cacheFormElements(forms, document2) {
   const elements = forms.flatMap((form) => [...form.fields, ...form.buttons]);
   const backendNodeIds = await resolveBackendNodeIds(elements.map((el) => el.selector)).catch(
     (error) => {
-      log28.debug(`Form fields not cached by node: ${getErrorMessage(error)}`);
+      log25.debug(`Form fields not cached by node: ${getErrorMessage(error)}`);
       return [];
     }
   );
@@ -21612,7 +21402,7 @@ async function cacheFormElements(forms, document2) {
     },
     document2
   );
-  log28.debug(`Cached ${elements.length} form elements`);
+  log25.debug(`Cached ${elements.length} form elements`);
 }
 async function handleFormCommand(options) {
   await runCommand(
@@ -22590,6 +22380,7 @@ function listedMatches(result, limit) {
 // src/commands/dom/screenshot.ts
 import { extname as extname2 } from "path";
 init_helpers();
+init_interrupt();
 init_outputFile();
 init_errors3();
 init_messages();
@@ -22598,7 +22389,7 @@ init_logging();
 init_directories();
 init_errors();
 init_exitCodes();
-var log29 = createLogger("dom");
+var log26 = createLogger("dom");
 var EXTENSION_FORMATS = {
   ".png": "png",
   ".jpg": "jpeg",
@@ -22619,34 +22410,27 @@ function resolveImageFormat(outputPath, requested) {
   }
   return requested ?? fromExtension ?? "png";
 }
-function buildPageScreenshotOptions(options) {
-  return filterDefined({
-    format: options.format,
-    quality: options.quality,
-    fullPage: options.fullPage,
-    noResize: options.resize === false,
-    scroll: options.scroll
-  });
-}
-function buildElementScreenshotOptions(options) {
-  return filterDefined({
-    format: options.format,
-    quality: options.quality,
-    noResize: options.resize === false,
-    padding: options.padding
-  });
+function buildScreenshotRequest(options, backendNodeId) {
+  const shared = {
+    format: options.format ?? "png",
+    ...filterDefined({ quality: options.quality }),
+    ...options.resize === false && { noResize: true }
+  };
+  if (backendNodeId !== void 0) {
+    return { ...shared, backendNodeId, ...filterDefined({ padding: options.padding }) };
+  }
+  return { ...shared, ...filterDefined({ fullPage: options.fullPage, scroll: options.scroll }) };
 }
 function hasElementTarget(options) {
   return options.selector !== void 0 || options.index !== void 0;
 }
 async function resolveElementNodeId(options) {
   if (options.selector !== void 0 && options.index !== void 0) {
-    return { backendNodeId: await selectMatch(options.selector, options.index) };
+    return selectMatch(options.selector, options.index);
   }
   if (options.index !== void 0) {
-    const resolver = DomElementResolver.getInstance();
-    const node = await resolver.getNodeIdForIndex(options.index);
-    return { backendNodeId: node.nodeId };
+    const node = await DomElementResolver.getInstance().getNodeIdForIndex(options.index);
+    return node.nodeId;
   }
   if (options.selector !== void 0) {
     return resolveSelector(options.selector);
@@ -22689,10 +22473,11 @@ function formatFrameFilename(frameNumber, format) {
   return `${String(frameNumber).padStart(3, "0")}.${format}`;
 }
 async function handlePageScreenshot(outputPath, options) {
+  const interrupt = abortOnInterrupt();
   await runCommand(
     async () => {
-      const screenshotOptions = buildPageScreenshotOptions(options);
-      const result = await capturePageScreenshot(outputPath, screenshotOptions);
+      const request = buildScreenshotRequest(options);
+      const result = await captureScreenshot(outputPath, request, interrupt);
       return { success: true, data: result };
     },
     options,
@@ -22700,12 +22485,14 @@ async function handlePageScreenshot(outputPath, options) {
   );
 }
 async function handleElementScreenshot(outputPath, options) {
+  const interrupt = abortOnInterrupt();
   await runCommand(
     async () => {
-      const nodeRef = await resolveElementNodeId(options);
-      const screenshotOptions = buildElementScreenshotOptions(options);
-      const result = await captureElementScreenshot(outputPath, nodeRef, screenshotOptions);
-      const elementResult = addElementInfo(result, options);
+      const lookup = resolveElementNodeId(options);
+      const backendNodeId = await unlessInterrupted(lookup, interrupt, screenshotInterrupted);
+      const request = buildScreenshotRequest(options, backendNodeId);
+      const shot = await captureScreenshot(outputPath, request, interrupt);
+      const elementResult = addElementInfo(shot, options);
       return { success: true, data: elementResult };
     },
     options,
@@ -22713,14 +22500,8 @@ async function handleElementScreenshot(outputPath, options) {
   );
 }
 async function captureSequenceFrame(outputPath, options) {
-  if (hasElementTarget(options)) {
-    const nodeRef = await resolveElementNodeId(options);
-    const elementOptions = buildElementScreenshotOptions(options);
-    await captureElementScreenshot(outputPath, nodeRef, elementOptions);
-  } else {
-    const pageOptions = buildPageScreenshotOptions(options);
-    await capturePageScreenshot(outputPath, pageOptions);
-  }
+  const backendNodeId = hasElementTarget(options) ? await resolveElementNodeId(options) : void 0;
+  await captureScreenshot(outputPath, buildScreenshotRequest(options, backendNodeId));
 }
 async function handleSequenceCapture(outputDir, options) {
   const fs19 = await import("fs");
@@ -22750,7 +22531,7 @@ async function handleSequenceCapture(outputDir, options) {
     if (options.json) {
       console.log(JSON.stringify(buildSuccessResponse({ frame: frameCount, path: outputPath })));
     } else {
-      log29.info(`Frame ${frameCount}: ${filename}`);
+      log26.info(`Frame ${frameCount}: ${filename}`);
     }
     if (limit > 0 && frameCount >= limit) break;
     await delay2(interval);
@@ -22977,7 +22758,7 @@ function formatInstalledSkills(data) {
 init_logging();
 init_errors();
 init_exitCodes();
-var log30 = createLogger("bdg");
+var log27 = createLogger("bdg");
 var SKILL_SOURCE_PATH = join8(PACKAGE_ROOT, ".claude", "skills", "bdg", "SKILL.md");
 var SKILL_ROOTS = {
   claude: join8(".claude", "skills"),
@@ -23039,7 +22820,7 @@ function writeSkill(target, path8, content) {
     writing = path8;
     renameSync2(temporary, path8);
   } catch (error) {
-    safeRemoveFile(temporary, "temporary skill copy", log30);
+    safeRemoveFile(temporary, "temporary skill copy", log27);
     return { target, path: writing, error };
   }
   if (backup === void 0) return { target, path: path8, status: "installed" };
@@ -23194,7 +22975,7 @@ function filterByResourceType(requests, types) {
 init_logging();
 init_suggestions();
 init_url();
-var log31 = createLogger("network");
+var log28 = createLogger("network");
 var SIZE_UNITS = {
   b: 1,
   kb: 1024,
@@ -23304,7 +23085,7 @@ function validateSizeValue(value) {
     parseSize(value);
     return null;
   } catch (error) {
-    log31.debug(
+    log28.debug(
       `Size parse failed for "${value}": ${error instanceof Error ? error.message : String(error)}`
     );
     return createError(
@@ -23495,35 +23276,84 @@ import { createRequire as createRequire2 } from "node:module";
 init_elementInfo();
 init_logging();
 init_errors();
-var log32 = createLogger("network");
+var log29 = createLogger("network");
 var REDACTED = "[redacted]";
 var SENSITIVE_FIELD = new RegExp(
-  `${SENSITIVE_NAME_SOURCE}|token|secret|api[-_]?key|authoriz|credential|jwt|private[-_]?key|access[-_]?key|session|signature`,
+  `${SENSITIVE_NAME_SOURCE}|token|secret|api[-_]?key|authoriz|credential|jwt|private[-_]?key|access[-_]?key|session|signature|bearer|cookie|csrf|xsrf|refresh|oauth|(^|[^a-z])(auth|sid)([^a-z]|$)|auth[-_]?code|code[-_]?verifier`,
   "i"
 );
-var FORM_BODY = /^[^\s=&{["]+=[^\s&]*(?:&[^\s=&]+=[^\s&]*)*$/;
+var FORM_BODY = /^(?!\[)[^\s=&{"]+=[^\s&]*(?:&[^\s=&]+=[^\s&]*)*$/;
+var JSON_LIKE_START = /^\uFEFF?(?:\)\]\}',?)?\s*(?:(?:\d+:)?(?:\d*-?(?:\/[^,]*,)?|[ac])[[{]|(?:data|event|id|retry):)/;
+var JSON_MIME = /json|event-stream/i;
+var DECODABLE_MIME = /^(?:application\/octet-stream|binary\/octet-stream|application\/x-www-form-urlencoded|text\/event-stream)?$|json/i;
+var BARE = /[^\s,:[\]{}"]+/y;
+var DOT = 46;
+var MAX_ENCODED_DEPTH = 3;
+var REDACTED_STRING = JSON.stringify(REDACTED);
+var UTF8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
 function isSensitiveField2(name) {
-  return SENSITIVE_FIELD.test(name);
+  return SENSITIVE_FIELD.test(name.replace(/([a-z])([A-Z])/g, "$1_$2"));
+}
+function redactOrReplaceWhole(text, redact, whole = REDACTED) {
+  try {
+    return redact(text);
+  } catch (error) {
+    log29.debug(`Body replaced whole, sanitizing failed: ${getErrorMessage(error)}`);
+    return whole;
+  }
+}
+function redactJwts(text, replacement) {
+  if (!text.includes("eyJ")) return text;
+  const parts = [];
+  let copied = 0;
+  let at = text.indexOf("eyJ");
+  while (at !== -1) {
+    const end = isJwtBoundary(text, at - 1) ? jwtEnd(text, at) : void 0;
+    if (end !== void 0 && isJwtBoundary(text, end)) {
+      parts.push(text.slice(copied, at), replacement);
+      copied = end;
+    }
+    at = text.indexOf("eyJ", Math.max(at + 3, copied));
+  }
+  if (parts.length === 0) return text;
+  parts.push(text.slice(copied));
+  return parts.join("");
 }
 function redactPairs(text, isSensitive, replacement) {
   return text.split("&").map((pair) => {
     const eq = pair.indexOf("=");
-    if (eq === -1 || !isSensitive(decodeName(pair.slice(0, eq)))) return pair;
-    return `${pair.slice(0, eq)}=${replacement}`;
+    if (eq === -1) return pair;
+    if (isSensitive(decodeName(pair.slice(0, eq)))) return `${pair.slice(0, eq)}=${replacement}`;
+    const value = pair.slice(eq + 1);
+    const redacted = redactJwts(value, replacement);
+    return redacted === value ? pair : `${pair.slice(0, eq + 1)}${redacted}`;
   }).join("&");
 }
-function redactRequestBody(text, mimeType) {
+function redactBody(text, mimeType) {
   if (/multipart\/form-data/i.test(mimeType)) return redactMultipart(text, mimeType);
-  if (/x-www-form-urlencoded/i.test(mimeType) || FORM_BODY.test(text)) {
-    return redactPairs(text, isSensitiveField2, REDACTED);
+  if (/x-www-form-urlencoded/i.test(mimeType)) return redactPairs(text, isSensitiveField2, REDACTED);
+  if (JSON_LIKE_START.test(text)) return redactJsonText(text, 0);
+  if (FORM_BODY.test(text)) return redactPairs(text, isSensitiveField2, REDACTED);
+  if (JSON_MIME.test(mimeType)) return redactJsonText(text, 0);
+  return redactJwts(text, REDACTED);
+}
+function redactBase64Body(base64, mimeType) {
+  if (!DECODABLE_MIME.test(mimeType.split(";")[0]?.trim() ?? "")) return base64;
+  let decoded;
+  try {
+    decoded = UTF8.decode(Buffer.from(base64, "base64"));
+  } catch (error) {
+    log29.debug(`Base64 body is not UTF-8: ${getErrorMessage(error)}`);
+    return base64;
   }
-  return redactJsonBody(text);
+  const redacted = redactBody(decoded, mimeType);
+  return redacted === decoded ? base64 : Buffer.from(redacted, "utf8").toString("base64");
 }
 function decodeName(name) {
   try {
     return decodeURIComponent(name.replace(/\+/g, " "));
   } catch (error) {
-    log32.debug(`Field name not decodable: ${getErrorMessage(error)}`);
+    log29.debug(`Field name not decodable: ${getErrorMessage(error)}`);
     return name;
   }
 }
@@ -23538,41 +23368,153 @@ function redactPart(part) {
   const headerEnd = part.indexOf("\r\n\r\n");
   if (headerEnd === -1) return part;
   const name = /;\s*name="([^"]*)"/i.exec(part.slice(0, headerEnd))?.[1];
-  if (name === void 0 || !isSensitiveField2(name)) return part;
+  if (name === void 0 || !isSensitiveField2(name)) return redactJwts(part, REDACTED);
   const valueEnd = part.endsWith("\r\n") ? part.length - 2 : part.length;
   return `${part.slice(0, headerEnd + 4)}${REDACTED}${part.slice(valueEnd)}`;
 }
-function redactJsonBody(text) {
-  if (!/^\s*[[{]/.test(text)) return text;
-  let parsed;
-  try {
-    parsed = JSON.parse(text);
-  } catch (error) {
-    log32.debug(`Request body not JSON: ${getErrorMessage(error)}`);
-    return error instanceof SyntaxError ? text : REDACTED;
+function redactJsonText(text, depth) {
+  const scan2 = {
+    text,
+    parts: [],
+    copied: 0,
+    containers: [false],
+    key: void 0,
+    lineEnd: -1,
+    depth
+  };
+  let index = 0;
+  while (index < text.length) index = scanToken(scan2, index);
+  if (scan2.parts.length === 0) return text;
+  scan2.parts.push(text.slice(scan2.copied));
+  return scan2.parts.join("");
+}
+function scanToken(scan2, index) {
+  const char = scan2.text[index];
+  if (char === '"') return scanString(scan2, index);
+  if (char === "{" || char === "[") {
+    scan2.containers.push(takeValue(scan2));
+  } else if (char === "}" || char === "]") {
+    if (scan2.containers.length > 1) scan2.containers.pop();
+    scan2.key = void 0;
+  } else if (char === ",") {
+    scan2.key = void 0;
+  } else {
+    return scanBare(scan2, index);
+  }
+  return index + 1;
+}
+function scanString(scan2, start) {
+  const end = stringEnd(scan2, start);
+  if (isFollowedByColon(scan2.text, end)) {
+    scan2.key = isSensitiveField2(keyName(scan2.text, start, end));
+  } else if (takeValue(scan2)) {
+    replaceValue(scan2, start, end, REDACTED_STRING);
+  } else {
+    const encoded = redactEncodedJson(scan2, start, end);
+    if (encoded === void 0) redactStringJwts(scan2, start, end);
+    else replaceValue(scan2, start, end, encoded);
+  }
+  return end;
+}
+function redactStringJwts(scan2, start, end) {
+  const contentEnd = end - 1 > start && scan2.text[end - 1] === '"' ? end - 1 : end;
+  const content = scan2.text.slice(start + 1, contentEnd);
+  const redacted = redactJwts(content, REDACTED);
+  if (redacted !== content) replaceValue(scan2, start + 1, contentEnd, redacted);
+}
+function scanBare(scan2, index) {
+  BARE.lastIndex = index;
+  const bare = BARE.exec(scan2.text)?.[0];
+  if (bare === void 0) return index + 1;
+  const end = index + bare.length;
+  const isLiteral = /^[-\d]/.test(bare) || bare === "true" || bare === "false" || bare === "null";
+  if (!isLiteral && scan2.key !== true) return end;
+  if (takeValue(scan2) && bare !== "null") replaceValue(scan2, index, end, REDACTED_STRING);
+  return end;
+}
+function takeValue(scan2) {
+  const sensitive = scan2.key === true || scan2.containers[scan2.containers.length - 1] === true;
+  scan2.key = void 0;
+  return sensitive;
+}
+function replaceValue(scan2, start, end, replacement) {
+  scan2.parts.push(scan2.text.slice(scan2.copied, start), replacement);
+  scan2.copied = end;
+}
+function isJwtBoundary(text, index) {
+  if (index < 0 || index >= text.length) return true;
+  const code = text.charCodeAt(index);
+  return !isBase64UrlCode(code) && code !== DOT;
+}
+function jwtEnd(text, start) {
+  const first = segmentEnd(text, start + 3);
+  if (first - start < 8 || text[first] !== ".") return void 0;
+  const second = segmentEnd(text, first + 1);
+  if (second - first - 1 < 5 || text[second] !== ".") return void 0;
+  return segmentEnd(text, second + 1);
+}
+function segmentEnd(text, from) {
+  let index = from;
+  while (index < text.length && isBase64UrlCode(text.charCodeAt(index))) index++;
+  return index;
+}
+function isBase64UrlCode(code) {
+  return code >= 48 && code <= 57 || code >= 65 && code <= 90 || code >= 97 && code <= 122 || code === 95 || code === 45;
+}
+function redactEncodedJson(scan2, start, end) {
+  if (scan2.depth >= MAX_ENCODED_DEPTH || end - start < 2 || scan2.text[end - 1] !== '"') {
+    return void 0;
   }
+  if (!/[[{]/.test(scan2.text.slice(start + 1, end - 1))) return void 0;
+  let decoded;
   try {
-    const hits = { count: 0 };
-    const redacted = redactJson(parsed, false, hits);
-    return hits.count > 0 ? JSON.stringify(redacted) : text;
+    decoded = JSON.parse(scan2.text.slice(start, end));
   } catch (error) {
-    log32.debug(`Request body redacted whole: ${getErrorMessage(error)}`);
-    return REDACTED;
+    log29.debug(`String value not decodable: ${getErrorMessage(error)}`);
+    return void 0;
   }
+  if (!JSON_LIKE_START.test(decoded)) return void 0;
+  const redacted = redactJsonText(decoded, scan2.depth + 1);
+  return redacted === decoded ? void 0 : JSON.stringify(redacted);
 }
-function redactJson(value, sensitive, hits) {
-  if (Array.isArray(value)) return value.map((item) => redactJson(item, sensitive, hits));
-  if (value !== null && typeof value === "object") {
-    return Object.fromEntries(
-      Object.entries(value).map(([key, field]) => [
-        key,
-        redactJson(field, sensitive || isSensitiveField2(key), hits)
-      ])
-    );
+function stringEnd(scan2, start) {
+  const { text } = scan2;
+  let from = start + 1;
+  for (; ; ) {
+    const quote = text.indexOf('"', from);
+    const lineEnd = nextLineEnd(scan2, from);
+    if (quote === -1 || lineEnd < quote) {
+      return lineEnd > from && text[lineEnd - 1] === "\r" ? lineEnd - 1 : lineEnd;
+    }
+    let backslashes = 0;
+    while (text[quote - 1 - backslashes] === "\\" && quote - 1 - backslashes > start) {
+      backslashes++;
+    }
+    if (backslashes % 2 === 0) return quote + 1;
+    from = quote + 1;
+  }
+}
+function nextLineEnd(scan2, from) {
+  if (scan2.lineEnd < from) {
+    const lineEnd = scan2.text.indexOf("\n", from);
+    scan2.lineEnd = lineEnd === -1 ? scan2.text.length : lineEnd;
+  }
+  return scan2.lineEnd;
+}
+function isFollowedByColon(text, index) {
+  let next = index;
+  while (next < text.length && " 	\n\r".includes(text.charAt(next))) next++;
+  return text[next] === ":";
+}
+function keyName(text, start, end) {
+  const raw = text.slice(start + 1, end - 1);
+  if (!raw.includes("\\")) return raw;
+  try {
+    return JSON.parse(text.slice(start, end));
+  } catch (error) {
+    log29.debug(`Key not decodable: ${getErrorMessage(error)}`);
+    return raw;
   }
-  if (!sensitive || !["string", "number", "boolean"].includes(typeof value)) return value;
-  hits.count++;
-  return REDACTED;
 }
 
 // src/telemetry/har/sanitize.ts
@@ -23588,8 +23530,11 @@ var SENSITIVE_CUSTOM_HEADER = /^x-.*(key|token|secret|auth)/i;
 var SENSITIVE_HEADER_SEGMENT = /(^|-)(api-?key|apikey|token|secret|jwt|subscription-key|session(-?id)?)(-|$)/i;
 var URL_HEADERS = /* @__PURE__ */ new Set(["location", "referer"]);
 var SENSITIVE_URL_PARAM = /^(code|sig|key)$/i;
+var BASE64_REDACTED = Buffer.from(REDACTED).toString("base64");
+var TEXT_OPCODE = 1;
+var BINARY_OPCODE2 = 2;
 function sanitizeEntry(entry) {
-  const { request, response } = entry;
+  const { request, response, _webSocketMessages: messages } = entry;
   const postData = request.postData;
   return {
     ...entry,
@@ -23600,17 +23545,33 @@ function sanitizeEntry(entry) {
       headers: request.headers.map(redactHeader),
       queryString: request.queryString.map(redactQueryParam),
       ...postData?.text !== void 0 && {
-        postData: { ...postData, text: redactRequestBody(postData.text, postData.mimeType) }
+        postData: {
+          ...postData,
+          text: redactOrReplaceWhole(postData.text, (text) => redactBody(text, postData.mimeType))
+        }
       }
     },
     response: {
       ...response,
       cookies: response.cookies.map(redactCookie),
       headers: response.headers.map(redactHeader),
-      redirectURL: redactUrl(response.redirectURL)
-    }
+      redirectURL: redactUrl(response.redirectURL),
+      content: redactContent(response.content)
+    },
+    ...messages && { _webSocketMessages: messages.map(redactWebSocketMessage) }
   };
 }
+function redactContent(content) {
+  const { text, mimeType } = content;
+  if (text === void 0) return content;
+  const redacted = content.encoding === "base64" ? redactOrReplaceWhole(text, (body) => redactBase64Body(body, mimeType), BASE64_REDACTED) : redactOrReplaceWhole(text, (body) => redactBody(body, mimeType));
+  return redacted === text ? content : { ...content, text: redacted };
+}
+function redactWebSocketMessage(message) {
+  if (message.opcode !== TEXT_OPCODE && message.opcode !== BINARY_OPCODE2) return message;
+  const data = message.opcode === TEXT_OPCODE ? redactOrReplaceWhole(message.data, (text) => redactBody(text, "")) : redactOrReplaceWhole(message.data, (text) => redactBase64Body(text, ""), BASE64_REDACTED);
+  return data === message.data ? message : { ...message, data };
+}
 function isSensitiveHeader(name) {
   return SENSITIVE_HEADERS.has(name.toLowerCase()) || SENSITIVE_CUSTOM_HEADER.test(name) || SENSITIVE_HEADER_SEGMENT.test(name);
 }
@@ -23646,7 +23607,7 @@ var DEFAULT_HTTP_VERSION = "HTTP/1.1";
 function buildHAR(requests, metadata, options = {}) {
   const built = [...requests].sort((a, b) => a.timestamp - b.timestamp).map(buildEntry);
   const entries = options.includeSensitive ? built : built.map(sanitizeEntry);
-  const log36 = {
+  const log33 = {
     version: "1.2",
     creator: {
       name: "bdg",
@@ -23657,12 +23618,12 @@ function buildHAR(requests, metadata, options = {}) {
     ...!options.includeSensitive && { comment: harSanitizedComment() }
   };
   if (metadata.chromeVersion) {
-    log36.browser = {
+    log33.browser = {
       name: "Chrome",
       version: metadata.chromeVersion
     };
   }
-  return { log: log36 };
+  return { log: log33 };
 }
 function buildEntry(req) {
   const timings = buildTimings(req);
@@ -23693,7 +23654,8 @@ function buildWebSocketMessage(frame) {
     type: frame.direction === "sent" ? "send" : "receive",
     time: frame.timestamp / 1e3,
     opcode: frame.opcode,
-    data: frame.payloadData
+    data: frame.payloadData,
+    ...frame.truncatedFrom !== void 0 && { _truncatedFrom: frame.truncatedFrom }
   };
 }
 function buildRequest(req) {
@@ -23706,7 +23668,7 @@ function buildRequest(req) {
     headers: convertHeaders(req.requestHeaders),
     queryString: extractQueryParams(url),
     headersSize: estimateRequestHeadersSize(req.method, req.url, req.requestHeaders),
-    bodySize: req.requestBody ? Buffer.byteLength(req.requestBody, "utf-8") : 0
+    bodySize: requestBodySize(req)
   };
   const postData = buildPostData(req);
   if (postData) {
@@ -23754,13 +23716,17 @@ function contentLength(req) {
   const bytes = value === void 0 ? NaN : Number(value);
   return Number.isInteger(bytes) && bytes >= 0 ? bytes : void 0;
 }
+function requestBodySize(req) {
+  if (!req.requestBody) return 0;
+  if (skippedBodyReason(req.requestBody) !== void 0) return -1;
+  return Buffer.byteLength(req.requestBody, "utf-8");
+}
 function buildPostData(req) {
   if (!req.requestBody) return void 0;
-  const contentType = getHeader(req.requestHeaders, "content-type") ?? "text/plain";
-  return {
-    mimeType: contentType,
-    text: req.requestBody
-  };
+  const mimeType = getHeader(req.requestHeaders, "content-type") ?? "text/plain";
+  const skipped = skippedBodyReason(req.requestBody);
+  if (skipped !== void 0) return { mimeType, comment: `Body not captured: ${skipped}` };
+  return { mimeType, text: req.requestBody };
 }
 function span(start, end) {
   if (start === void 0 || end === void 0 || start < 0 || end < 0 || end < start) {
@@ -24006,6 +23972,13 @@ function formatSessionStatus(metadata, pid, activity, pageState, verbose = false
     if (activity.lastConsoleMessageAt) {
       fmt.keyValue("  Last Message", formatTimeAgo(activity.lastConsoleMessageAt), 18);
     }
+    const downloadRows = [
+      ...activity.downloads?.length ? [downloadsSummary(activity.downloads)] : [],
+      ...activity.downloadsWarning ? [`\u26A0 ${activity.downloadsWarning}`] : []
+    ];
+    downloadRows.forEach(
+      (row, index) => index === 0 ? fmt.keyValue("Downloads", row, 18) : fmt.text(`${" ".repeat(18)}${row}`)
+    );
   }
   fmt.blank().text("Collectors").separator("\u2501", 50);
   const activeTelemetry = metadata.activeTelemetry ?? ["network", "console", "dom"];
@@ -24142,6 +24115,7 @@ function buildPreviewJsonData(output, options) {
     ...output.partial !== void 0 && { partial: output.partial },
     ...output.totals && { totals: output.totals },
     ...output.pageCrashedAt !== void 0 && { pageCrashedAt: output.pageCrashedAt },
+    ...output.downloads && { downloads: output.downloads },
     ...pick("network") && output.data.network && { network: last(output.data.network) },
     ...pick("console") && output.data.console && {
       console: last(output.data.console)?.map((message) => capMessageText(message, options.full))
@@ -24226,6 +24200,8 @@ function formatPreviewCompact(output, options) {
       fmt.blank();
     }
   }
+  if (output.downloads?.length)
+    fmt.text(`Downloads: ${downloadsSummary(output.downloads)}`).blank();
   if (!options.follow) {
     fmt.tip(compactTipsMessage());
   }
@@ -24314,6 +24290,9 @@ function formatPreviewVerbose(output, options) {
       fmt.blank();
     }
   }
+  if (output.downloads?.length) {
+    fmt.keyValue("Downloads", downloadsSummary(output.downloads), 18).blank();
+  }
   if (!options.follow) {
     fmt.tip(verboseCommandsMessage());
   }
@@ -24437,7 +24416,7 @@ function registerDocumentCommand(networkCmd) {
 }
 
 // src/commands/network/har.ts
-var log33 = createLogger("network");
+var log30 = createLogger("network");
 function generateHARFilename() {
   const now = /* @__PURE__ */ new Date();
   const year = now.getFullYear();
@@ -24460,7 +24439,7 @@ async function getChromeVersion() {
     const product = response.data?.result?.product;
     return product?.split("/")[1];
   } catch (error) {
-    log33.debug(`Could not read Chrome version: ${getErrorMessage(error)}`);
+    log30.debug(`Could not read Chrome version: ${getErrorMessage(error)}`);
     return void 0;
   }
 }
@@ -25272,13 +25251,13 @@ import * as fs17 from "fs";
 init_paths();
 init_logging();
 init_directories();
-var log34 = createLogger("session");
+var log31 = createLogger("session");
 function readPortFile(portPath) {
   try {
     const port = parseInt(fs17.readFileSync(portPath, "utf-8").trim(), 10);
     return Number.isInteger(port) && port >= 1 && port <= 65535 ? port : null;
   } catch (error) {
-    logDebugError(log34, `read ${portPath}`, error);
+    logDebugError(log31, `read ${portPath}`, error);
     return null;
   }
 }
@@ -25330,7 +25309,7 @@ function selectSession(optionValue) {
 // src/session/sessionList.ts
 init_logging();
 init_sessionCommand();
-var log35 = createLogger("session");
+var log32 = createLogger("session");
 function toRunningSession(name, data) {
   const meta = data.sessionMetadata;
   const state = meta ? "active" : data.ending ? "ending" : "starting";
@@ -25357,7 +25336,7 @@ async function describeSession(entry) {
     const response = await getStatus(socketPath);
     if (response.status === "ok" && response.data) return toRunningSession(name, response.data);
   } catch (error) {
-    logDebugError(log35, `get status of ${dir}`, error);
+    logDebugError(log32, `get status of ${dir}`, error);
   }
   return { name, state: "unresponsive" };
 }
@@ -25396,7 +25375,7 @@ function leftoverPort(dir) {
     const meta = JSON.parse(fs18.readFileSync(sessionFilePathIn(dir, "METADATA"), "utf8"));
     if (typeof meta.port === "number") return meta.port;
   } catch (error) {
-    logDebugError(log35, `read the metadata in ${dir}`, error);
+    logDebugError(log32, `read the metadata in ${dir}`, error);
   }
   return readPortFile(sessionFilePathIn(dir, "PORT"));
 }
@@ -25409,7 +25388,7 @@ function isSameDir(a, b) {
     const second = fs18.statSync(b);
     return first.ino === second.ino && first.dev === second.dev;
   } catch (error) {
-    logDebugError(log35, `compare ${a} with ${b}`, error);
+    logDebugError(log32, `compare ${a} with ${b}`, error);
     return false;
   }
 }