@wenathlan/extension 1.1.45 → 1.1.46

package/dist/index.js

@@ -196,6 +196,143 @@ function annotationplanof(input) {
   return plan;
 }
 
+// cdpbus.ts
+var cdpkinds = ["attachcdp", "detachcdp", "cdpcmd", "watchcdp", "setbreakpoint", "stepcode", "watchexpr", "overridescript"];
+var cdpdomains = ["Runtime", "Log", "Debugger", "DOM", "Network", "Page"];
+function methoddomain(method) {
+  const match = /^([A-Z][A-Za-z]*)\.([a-zA-Z][A-Za-z0-9]*)$/.exec(method.trim());
+  return match?.[1];
+}
+function cdpallowlistof(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const domains = Array.isArray(entry.domains) ? entry.domains.filter((domain) => typeof domain === "string" && cdpdomains.includes(domain)) : [];
+  if (domains.length === 0) return void 0;
+  if (entry.methods === void 0) return { domains };
+  const methods = Array.isArray(entry.methods) ? entry.methods.filter((method) => typeof method === "string" && methoddomain(method) !== void 0 && domains.includes(methoddomain(method))) : [];
+  if (methods.length === 0) return void 0;
+  return { domains, methods };
+}
+function allowlistcovers(allowlist, method) {
+  const domain = methoddomain(method);
+  if (domain === void 0) return false;
+  if (!allowlist.domains.includes(domain)) return false;
+  if (allowlist.methods !== void 0 && !allowlist.methods.includes(method)) return false;
+  return true;
+}
+function attachcdpsession(input) {
+  return { id: input.id, runid: input.runid, stepid: input.stepid, tabid: input.tabid, origin: input.origin, attachedat: input.now, domains: [...new Set(input.domains)], debuggerversion: input.debuggerversion };
+}
+function detachcdpsession(session, at, userdetached = false) {
+  return { ...session, detachedat: at, ...userdetached ? { userdetached: true } : {} };
+}
+function sendcdpcommand(input) {
+  const domain = methoddomain(input.method);
+  if (domain === void 0) return { ...input, method: input.method.trim(), domain: "", duration: input.duration, ...input.errorclass !== void 0 ? { errorclass: input.errorclass } : { errorclass: "malformedmethod" }, at: input.at };
+  return { ...input, method: input.method.trim(), domain, duration: input.duration, ...input.errorclass !== void 0 ? { errorclass: input.errorclass } : {}, at: input.at };
+}
+function serializecdpcommand(queue, command) {
+  return [...queue, command];
+}
+function cdpeventruleof(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const domain = typeof entry.domain === "string" && cdpdomains.includes(entry.domain) ? entry.domain : void 0;
+  const event = typeof entry.event === "string" && entry.event.trim() ? entry.event.trim() : void 0;
+  if (domain === void 0 || event === void 0) return void 0;
+  const match = typeof entry.match === "string" && entry.match.trim() ? entry.match.trim() : void 0;
+  return { domain, event, ...match !== void 0 ? { match } : {} };
+}
+function watchcdpevents(rules, events) {
+  const matched = [];
+  const counts = {};
+  for (const domain of cdpdomains) counts[domain] = 0;
+  for (const event of events) {
+    for (const rule of rules) {
+      if (rule.domain !== event.domain || rule.event !== event.event) continue;
+      if (rule.match !== void 0 && !(event.payload ?? "").includes(rule.match)) continue;
+      matched.push({ ruleid: rule.id, domain: event.domain, event: event.event, ...event.payload !== void 0 ? { payload: event.payload } : {} });
+      counts[event.domain] = (counts[event.domain] ?? 0) + 1;
+    }
+  }
+  return { matched, counts };
+}
+function breakpointinputof(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const url = typeof entry.url === "string" && entry.url.trim() ? entry.url.trim() : void 0;
+  const line = typeof entry.line === "number" && Number.isInteger(entry.line) && entry.line >= 0 ? entry.line : void 0;
+  if (url === void 0 || line === void 0) return void 0;
+  const column = typeof entry.column === "number" && Number.isInteger(entry.column) && entry.column >= 0 ? entry.column : void 0;
+  const condition = typeof entry.condition === "string" && entry.condition.trim() ? entry.condition.trim() : void 0;
+  return { url, line, ...column !== void 0 ? { column } : {}, ...condition !== void 0 ? { condition } : {} };
+}
+function capturepause(input) {
+  return { id: input.id, runid: input.runid, stepid: input.stepid, reason: input.reason, callframes: [...input.callframes], ...input.hitbreakpoint !== void 0 ? { hitbreakpoint: input.hitbreakpoint } : {}, ...input.domsnapshotid !== void 0 ? { domsnapshotid: input.domsnapshotid } : {}, at: input.at };
+}
+function stepmodeof(value) {
+  const modes = ["stepover", "stepinto", "stepout", "resume"];
+  return typeof value === "string" && modes.includes(value) ? value : void 0;
+}
+function watchexpressionof(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const expression = typeof entry.expression === "string" && entry.expression.trim() ? entry.expression.trim() : void 0;
+  if (expression === void 0) return void 0;
+  const scope = typeof entry.scope === "string" && entry.scope.trim() ? entry.scope.trim() : "topframe";
+  return { expression, scope };
+}
+function recordwatchvalue(expression, pauseid, value, at) {
+  return { ...expression, values: [...expression.values, { pauseid, value, at }] };
+}
+function overrideinputof(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const urlpattern = typeof entry.urlpattern === "string" && entry.urlpattern.trim() ? entry.urlpattern.trim() : void 0;
+  const source = typeof entry.source === "string" ? entry.source : void 0;
+  if (urlpattern === void 0 || source === void 0 || source.trim().length === 0) return void 0;
+  return { urlpattern, source };
+}
+function overridematches(urlpattern, url) {
+  const patternmatch = /^(https:\/\/[^/]+)(\/.*)?$/.exec(urlpattern);
+  const urlmatch = /^(https:\/\/[^/]+)(\/.*)?$/.exec(url);
+  if (!patternmatch || !urlmatch) return false;
+  if (patternmatch[1] !== urlmatch[1]) return false;
+  const patternpath = (patternmatch[2] ?? "/").split("/").filter((segment) => segment.length > 0);
+  const urlpath = (urlmatch[2] ?? "/").split("/").filter((segment) => segment.length > 0);
+  const walk = (patternindex, urlindex) => {
+    if (patternindex >= patternpath.length) return urlindex >= urlpath.length;
+    const segment = patternpath[patternindex];
+    if (segment === "**") return walk(patternindex + 1, urlindex) || urlindex < urlpath.length && walk(patternindex, urlindex + 1);
+    if (urlindex >= urlpath.length) return false;
+    if (segment !== "*" && segment !== urlpath[urlindex]) return false;
+    return walk(patternindex + 1, urlindex + 1);
+  };
+  return walk(0, 0);
+}
+function teardownplanof(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entry = value;
+  const revertsteps = Array.isArray(entry.revertsteps) ? entry.revertsteps.filter((step) => typeof step === "string" && step.trim().length > 0) : [];
+  const policy = entry.resumepolicy;
+  if (revertsteps.length === 0) return void 0;
+  if (policy !== void 0 && policy !== "resume" && policy !== "pause" && policy !== "ask") return void 0;
+  return { revertsteps, resumepolicy: policy ?? "ask" };
+}
+function teardowncdpsession(input) {
+  const revertedbreakpoints = input.breakpoints.filter((spec) => spec.revertedat === void 0).map((spec) => spec.id);
+  const revertedoverrides = input.overrides.filter((spec) => spec.revertedat === void 0).map((spec) => spec.id);
+  const resumepolicy = input.userdetached ? "pause" : input.plan?.resumepolicy ?? "ask";
+  return {
+    session: detachcdpsession(input.session, input.at, input.userdetached),
+    revertedbreakpoints,
+    revertedoverrides,
+    resumepolicy,
+    paused: input.userdetached || resumepolicy === "pause",
+    keepsalive: input.userdetached
+  };
+}
+
 // httpclient.ts
 var httpkinds = ["fetchurl", "parsejson", "parsehtml", "callrest", "callgraphql"];
 var redirectstatuses = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
@@ -1912,6 +2049,108 @@ var sessionmemory = class {
   async getconsoleconsents() {
     return await this.adapter.get("consoleconsents") ?? [];
   }
+  /** Stores one devtools session record with its enabled domains and detach state, replacing the previous record of its id. */
+  async setcdpsession(session) {
+    const records = (await this.adapter.get("cdpsessions") ?? []).filter((item) => item.id !== session.id);
+    await this.adapter.set("cdpsessions", [session, ...records]);
+  }
+  /** Returns every stored devtools session record, newest first. */
+  async getcdpsessions() {
+    return await this.adapter.get("cdpsessions") ?? [];
+  }
+  /** Stores one raw command outcome with its duration and error class. */
+  async addcdpcommand(command) {
+    const records = await this.adapter.get("cdpcommands") ?? [];
+    await this.adapter.set("cdpcommands", [command, ...records]);
+  }
+  /** Returns every stored raw command outcome, newest first. */
+  async getcdpcommands() {
+    return await this.adapter.get("cdpcommands") ?? [];
+  }
+  /** Stores one domain event rule with its match filter, replacing the previous rule of its id. */
+  async setcdpeventrule(rule) {
+    const records = (await this.adapter.get("cdpeventrules") ?? []).filter((item) => item.id !== rule.id);
+    await this.adapter.set("cdpeventrules", [rule, ...records]);
+  }
+  /** Returns every stored domain event rule, newest first. */
+  async getcdpeventrules() {
+    return await this.adapter.get("cdpeventrules") ?? [];
+  }
+  /** Stores one breakpoint record with its condition and hit counter, replacing the previous record of its id. */
+  async addbreakpoint(spec) {
+    const records = (await this.adapter.get("breakpoints") ?? []).filter((item) => item.id !== spec.id);
+    await this.adapter.set("breakpoints", [spec, ...records]);
+  }
+  /** Returns every stored breakpoint record, newest first. */
+  async getbreakpoints() {
+    return await this.adapter.get("breakpoints") ?? [];
+  }
+  /** Stores one pause state capture; the user configured pause retention window expires the call frames and the dom snapshot reference of the oldest captures while the pause reason and hit breakpoint survive. */
+  async addpause(pause) {
+    const records = await this.getpauses();
+    const combined = [pause, ...records.filter((item) => item.id !== pause.id)];
+    const retention = (await this.getsettings())?.pauseretention;
+    if (retention === void 0) {
+      await this.adapter.set("pauses", combined);
+      return;
+    }
+    const kept = combined.slice(0, retention);
+    const expired = combined.slice(retention).map((item) => {
+      if (item.framesexpired === true) return item;
+      const faded = { ...item, callframes: [], framesexpired: true };
+      delete faded.domsnapshotid;
+      return faded;
+    });
+    await this.adapter.set("pauses", [...kept, ...expired]);
+  }
+  /** Returns every stored pause state capture, newest first. */
+  async getpauses() {
+    return await this.adapter.get("pauses") ?? [];
+  }
+  /** Returns the pause state captures of one run, newest first. */
+  async listpauses(runid) {
+    const records = await this.getpauses();
+    return records.filter((item) => item.runid === runid);
+  }
+  /** Stores one watch expression with its per pause values, replacing the previous expression of its id. */
+  async setwatchexpression(expression) {
+    const records = (await this.adapter.get("watchexpressions") ?? []).filter((item) => item.id !== expression.id);
+    await this.adapter.set("watchexpressions", [expression, ...records]);
+  }
+  /** Returns every stored watch expression, newest first. */
+  async getwatchexpressions() {
+    return await this.adapter.get("watchexpressions") ?? [];
+  }
+  /** Stores one script override with its review provenance, replacing the previous override of its id. */
+  async addscriptoverride(spec) {
+    const records = (await this.adapter.get("scriptoverrides") ?? []).filter((item) => item.id !== spec.id);
+    await this.adapter.set("scriptoverrides", [spec, ...records]);
+  }
+  /** Returns every stored script override, newest first. */
+  async getscriptoverrides() {
+    return await this.adapter.get("scriptoverrides") ?? [];
+  }
+  /** Stores one debugger consent decision per origin with the consented domain list, replacing the previous decision of its id. */
+  async setdebuggergrant(grant) {
+    const records = (await this.adapter.get("debuggergrants") ?? []).filter((item) => item.id !== grant.id);
+    await this.adapter.set("debuggergrants", [grant, ...records]);
+  }
+  /** Returns every debugger consent decision, newest first. */
+  async getdebuggergrants() {
+    return await this.adapter.get("debuggergrants") ?? [];
+  }
+  /** Revokes every approved debugger consent of one origin: the revoke time stamps the records so the next attach needs a new reviewed prompt. */
+  async revokedebuggergrants(origin, at) {
+    const records = await this.getdebuggergrants();
+    let revoked = 0;
+    const updated = records.map((grant) => {
+      if (grant.origin !== origin || grant.revokedat !== void 0) return grant;
+      revoked += 1;
+      return { ...grant, revokedat: at };
+    });
+    await this.adapter.set("debuggergrants", updated);
+    return revoked;
+  }
   /** Merges expired entry counts into the per run level count summary that survives the retention window. */
   async mergelevelsummary(runid, counts, now) {
     const records = await this.getlevelsummaries();
@@ -2464,7 +2703,7 @@ function extractvalues(body, paths) {
 // runtimeline.ts
 var timelinekinds = ["watchconsole", "watcherrors", "watchtasks"];
 var loglevels = ["error", "warn", "info", "log", "debug", "trace"];
-var timelinesources = ["console", "error", "rejection", "resource", "longtask", "network"];
+var timelinesources = ["console", "error", "rejection", "resource", "longtask", "network", "cdp"];
 function levelrank(level) {
   return loglevels.indexOf(level);
 }
@@ -2871,9 +3110,9 @@ function polldecision(input) {
 }
 
 // policy.ts
-var sensitiveactions = /* @__PURE__ */ new Set(["click", "type", "navigate", "select", "presskey", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "reload", "back", "forward", "writestorage", "setattribute", "removeattribute", "evaluate", "tabcreate", "tabactivate", "tabclose", "tabreload", "windowcreate", "windowclose", "windowresize", "downloadfile", "clickpoint", "shiftclick", "dismissdialog", "enterframe", "typetime", "appendtext", "setvalue", "typeedit", "keyhold", "keyrelease", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "openlink", "openprivate", "reloadcache", "stopnav", "followlink", "spanav", "rewritequery", "setfragment", "navlist", "navprofile", "handleauth", "printpdf", "prefetch", "preconnect", "deeplink", "reopentab", "pausenav", "navrate", "openclipboard", "batchopen", "duplicatetab", "closepattern", "pintab", "mutetab", "movetab", "movetabwindow", "grouptabs", "colorgroup", "collapsegroup", "discardtab", "reloadtabs", "zoomin", "zoomout", "switchtab", "maximizewindow", "minimizewindow", "restorewindow", "focuswindow", "scratchwindow", "incognitowindow", "restoretab", "restorelayout", "reopenrun", "badgetab", "fillform", "filllabel", "fillplaceholder", "submitform", "retryform", "runwizard", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcard", "fillcode", "consentpassword", "exportcsv", "exportjson", "exportexcel", "copytable", "pushsheets", "streamdisk", "paginateextract", "resumeextract", "batchdownload", "pausedownload", "resumedownload", "interceptmime", "readclipboard", "writeclipboard", "copyscreen", "quarantinedownload", "scanvirus", "cleanupartifacts", "recordscreen", "captureaudio", "downloadimages", "callrest", "callgraphql", "sendmessage", "blockrequest", "mockresponse", "rewriteheaders", "setcookies", "clearcookies", "authflow", "saveapikey", "routeproxy", "postform", "postfiles"]);
-var interactionactions = /* @__PURE__ */ new Set(["focus", "scroll", "hover", "clickdeep", "rightclick", "doubleclick", "scrollpage", "scrollby", "scrollend", "scrolltop", "fullscreen", "zoomset", "movepointer", "clicktext", "clickaria", "clickname", "expanddetails", "pierceshadow", "retryaction", "capturebodies"]);
-var readactions = /* @__PURE__ */ new Set(["observe", "inspect", "extract", "wait", "waitfor", "waittext", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "readlinks", "readimages", "readmeta", "readforms", "readstorage", "highlight", "tablist", "windowlist", "tabsnapshot", "mapclicks", "verifyvisible", "verifyenabled", "resolvexpath", "a11ytree", "readvisible", "readertree", "detectlists", "detecttables", "readjson", "watchmutate", "waitquiet", "watchbanner", "detectinfinitescroll", "detectvirtual", "detectlazy", "readscrollpos", "readlang", "readoutline", "countpages", "listshadow", "listframes", "classifypage", "fingerprintsection", "diffsnapshots", "readselection", "watchfocus", "detectsticky", "detectscrolllock", "readopengraph", "detectlanguage", "deriveselector", "waitload", "waiturl", "spawait", "detecthttp", "readredirects", "readfinalurl", "trailaudit", "navintent", "checksafe", "querytabs", "watchtab", "findclones", "searchtabs", "listaudio", "snapshotsession", "savelayout", "attachmeta", "detectfields", "generatevalues", "saveprofiles", "asksubmit", "readerrors", "skiphoneypot", "detectlogin", "detecttemplate", "handoffcaptcha", "scrapetable", "importcsv", "looprows", "transformvalues", "deduperows", "mergepages", "stamplerows", "previewgrid", "logprovenance", "verifydownload", "exportnetlog", "namecaptures", "shotview", "shotfullpage", "shotelement", "shotregion", "contactsheet", "capturepdf", "captureframe", "readmedia", "readassets", "probestream", "timelapse", "shotcanvas", "convertimage", "makethumbs", "fetchurl", "parsejson", "parsehtml", "opensocket", "waitmessage", "watchrequests", "readheaders", "mapapi", "subscribesse", "longpoll", "extractapi", "readcookies", "watchconsole", "watcherrors", "watchtasks"]);
+var sensitiveactions = /* @__PURE__ */ new Set(["click", "type", "navigate", "select", "presskey", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "reload", "back", "forward", "writestorage", "setattribute", "removeattribute", "evaluate", "tabcreate", "tabactivate", "tabclose", "tabreload", "windowcreate", "windowclose", "windowresize", "downloadfile", "clickpoint", "shiftclick", "dismissdialog", "enterframe", "typetime", "appendtext", "setvalue", "typeedit", "keyhold", "keyrelease", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "openlink", "openprivate", "reloadcache", "stopnav", "followlink", "spanav", "rewritequery", "setfragment", "navlist", "navprofile", "handleauth", "printpdf", "prefetch", "preconnect", "deeplink", "reopentab", "pausenav", "navrate", "openclipboard", "batchopen", "duplicatetab", "closepattern", "pintab", "mutetab", "movetab", "movetabwindow", "grouptabs", "colorgroup", "collapsegroup", "discardtab", "reloadtabs", "zoomin", "zoomout", "switchtab", "maximizewindow", "minimizewindow", "restorewindow", "focuswindow", "scratchwindow", "incognitowindow", "restoretab", "restorelayout", "reopenrun", "badgetab", "fillform", "filllabel", "fillplaceholder", "submitform", "retryform", "runwizard", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcard", "fillcode", "consentpassword", "exportcsv", "exportjson", "exportexcel", "copytable", "pushsheets", "streamdisk", "paginateextract", "resumeextract", "batchdownload", "pausedownload", "resumedownload", "interceptmime", "readclipboard", "writeclipboard", "copyscreen", "quarantinedownload", "scanvirus", "cleanupartifacts", "recordscreen", "captureaudio", "downloadimages", "callrest", "callgraphql", "sendmessage", "blockrequest", "mockresponse", "rewriteheaders", "setcookies", "clearcookies", "authflow", "saveapikey", "routeproxy", "postform", "postfiles", "attachcdp", "detachcdp", "cdpcmd", "overridescript"]);
+var interactionactions = /* @__PURE__ */ new Set(["focus", "scroll", "hover", "clickdeep", "rightclick", "doubleclick", "scrollpage", "scrollby", "scrollend", "scrolltop", "fullscreen", "zoomset", "movepointer", "clicktext", "clickaria", "clickname", "expanddetails", "pierceshadow", "retryaction", "capturebodies", "setbreakpoint", "stepcode", "watchexpr"]);
+var readactions = /* @__PURE__ */ new Set(["observe", "inspect", "extract", "wait", "waitfor", "waittext", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "readlinks", "readimages", "readmeta", "readforms", "readstorage", "highlight", "tablist", "windowlist", "tabsnapshot", "mapclicks", "verifyvisible", "verifyenabled", "resolvexpath", "a11ytree", "readvisible", "readertree", "detectlists", "detecttables", "readjson", "watchmutate", "waitquiet", "watchbanner", "detectinfinitescroll", "detectvirtual", "detectlazy", "readscrollpos", "readlang", "readoutline", "countpages", "listshadow", "listframes", "classifypage", "fingerprintsection", "diffsnapshots", "readselection", "watchfocus", "detectsticky", "detectscrolllock", "readopengraph", "detectlanguage", "deriveselector", "waitload", "waiturl", "spawait", "detecthttp", "readredirects", "readfinalurl", "trailaudit", "navintent", "checksafe", "querytabs", "watchtab", "findclones", "searchtabs", "listaudio", "snapshotsession", "savelayout", "attachmeta", "detectfields", "generatevalues", "saveprofiles", "asksubmit", "readerrors", "skiphoneypot", "detectlogin", "detecttemplate", "handoffcaptcha", "scrapetable", "importcsv", "looprows", "transformvalues", "deduperows", "mergepages", "stamplerows", "previewgrid", "logprovenance", "verifydownload", "exportnetlog", "namecaptures", "shotview", "shotfullpage", "shotelement", "shotregion", "contactsheet", "capturepdf", "captureframe", "readmedia", "readassets", "probestream", "timelapse", "shotcanvas", "convertimage", "makethumbs", "fetchurl", "parsejson", "parsehtml", "opensocket", "waitmessage", "watchrequests", "readheaders", "mapapi", "subscribesse", "longpoll", "extractapi", "readcookies", "watchconsole", "watcherrors", "watchtasks", "watchcdp"]);
 var allowedactions = /* @__PURE__ */ new Set([...sensitiveactions, ...interactionactions, ...readactions]);
 var watchactions = /* @__PURE__ */ new Set(["watchmutate", "watchbanner", "watchfocus", "watchtab"]);
 var targetactions = /* @__PURE__ */ new Set(["inspect", "focus", "click", "type", "scroll", "select", "hover", "clickdeep", "rightclick", "doubleclick", "drag", "drop", "upload", "clear", "check", "uncheck", "toggle", "submit", "readattribute", "readstyle", "readgeometry", "readvalue", "readtext", "readhtml", "countelements", "readtable", "highlight", "setattribute", "removeattribute", "waitfor", "shiftclick", "typetime", "appendtext", "setvalue", "typeedit", "submitsearch", "selectmulti", "chooseradio", "setslider", "setdate", "setcolor", "expanddetails", "verifyvisible", "verifyenabled", "pierceshadow", "deriveselector", "fingerprintsection", "submitform", "retryform", "selectchain", "picktypeahead", "pickdate", "attachfile", "fillcode", "consentpassword", "scrapetable", "paginateextract", "shotelement", "captureframe", "shotcanvas"]);
@@ -2890,6 +3129,7 @@ var socketactions = /* @__PURE__ */ new Set(["opensocket", "sendmessage", "waitm
 var netwatchactions = /* @__PURE__ */ new Set(["watchrequests", "readheaders", "capturebodies", "mapapi", "extractapi"]);
 var controlactions = /* @__PURE__ */ new Set(["blockrequest", "mockresponse", "rewriteheaders", "setcookies", "readcookies", "clearcookies", "authflow", "saveapikey", "routeproxy", "postform", "postfiles"]);
 var debugactions = /* @__PURE__ */ new Set(["watchconsole", "watcherrors", "watchtasks"]);
+var cdpactions = /* @__PURE__ */ new Set(["attachcdp", "detachcdp", "cdpcmd", "watchcdp", "setbreakpoint", "stepcode", "watchexpr", "overridescript"]);
 var credentialheaders = /* @__PURE__ */ new Set(["authorization", "proxy-authorization", "cookie", "cookie2", "set-cookie", "api-key", "x-api-key", "x-auth-token", "x-session-token", "proxy-authorization"]);
 var fieldkinds = ["text", "email", "phone", "date", "number", "select", "check", "radio", "file", "password", "card", "code"];
 var layoutmutationactions = /* @__PURE__ */ new Set(["grouptabs", "colorgroup", "collapsegroup", "savelayout", "restorelayout"]);
@@ -2911,8 +3151,11 @@ function iswatchkind(kind) {
 function isdebugkind(kind) {
   return debugactions.has(kind);
 }
+function iscdpkind(kind) {
+  return cdpactions.has(kind);
+}
 function observationmodeof(kind) {
-  if (watchactions.has(kind) || debugactions.has(kind) || kind === "waitquiet") return "watching";
+  if (watchactions.has(kind) || debugactions.has(kind) || cdpactions.has(kind) && kind === "watchcdp" || kind === "waitquiet") return "watching";
   if (kind === "diffsnapshots") return "diffing";
   return "passive";
 }
@@ -4126,6 +4369,130 @@ function rotationruleof(value) {
   if (maxentries === void 0 || overflowtarget === void 0) return void 0;
   return { maxentries, overflowtarget };
 }
+function debuggate(session, tabid, origin, now) {
+  if (!session || session.stoppedat) return { allowed: false, reason: "No active browser session exists for the devtools protocol step." };
+  if (session.expiresat <= now) return { allowed: false, reason: "The browser session has expired and cannot run a devtools protocol step." };
+  if (session.pausedat) return { allowed: false, reason: "The browser session is paused and cannot run a devtools protocol step." };
+  if (session.tabid !== tabid) return { allowed: false, reason: `The devtools protocol step needs the run tab ${session.tabid} and refuses tab ${tabid}.` };
+  if (!origingranted(session, origin)) return { allowed: false, reason: `The devtools protocol step on ${origin} needs the session origin grants first.` };
+  return { allowed: true };
+}
+function debuggerconsentcovers(origin, domains, grants) {
+  const needed = [...new Set(domains)];
+  const covering = grants.find((grant) => grant.origin === origin && grant.approved === true && grant.revokedat === void 0 && needed.every((domain) => grant.domains.includes(domain)));
+  if (covering) return { allowed: true };
+  if (grants.some((grant) => grant.origin === origin && grant.revokedat !== void 0)) return { allowed: false, reason: `The debugger consent on ${origin} was revoked; approve a new prompt before the devtools protocol runs again.` };
+  return { allowed: false, reason: `The devtools protocol on ${origin} needs the reviewed debugger consent for ${needed.join(", ")} first; approve the prompt with the domain allowlist shown in the review panel.` };
+}
+function validatebreakpointcondition(condition) {
+  const expression = condition.trim();
+  if (expression.length === 0) return { allowed: false, reason: "The breakpoint condition must not be empty." };
+  if (/(?<![=!<>])=(?!=)/.test(expression)) return { allowed: false, reason: "Breakpoint conditions refuse assignment because the reviewed grammar is comparison only." };
+  if (/[A-Za-z_$][\w$]*\s*\(/.test(expression)) return { allowed: false, reason: "Breakpoint conditions refuse calls because the reviewed grammar is comparison only." };
+  const literal = /^(?:-?\d+(?:\.\d+)?|"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|true|false|null)$/;
+  const tokens = expression.match(/(?:[A-Za-z_$][\w$]*|-?\d+(?:\.\d+)?|"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|===|!==|==|!=|>=|<=|&&|\|\||[!.<>()+\-*\/%])/g);
+  if (tokens === null || tokens.join("") !== expression.replace(/\s+/g, "")) return { allowed: false, reason: "The breakpoint condition must use the reviewed expression grammar of member chains, literals, comparisons, logic operators, negation and parentheses." };
+  const identifierlike = /^(?:true|false|null)$/;
+  for (const token of tokens) {
+    if (literal.test(token) || identifierlike.test(token)) continue;
+    if (["===", "!==", "==", "!=", ">=", "<=", "&&", "||", "!", ".", "(", ")", "<", ">", "+", "-", "*", "/", "%"].includes(token)) continue;
+    if (/^[A-Za-z_$][\w$]*$/.test(token)) continue;
+    return { allowed: false, reason: `The token ${token} of the breakpoint condition stays outside the reviewed expression grammar.` };
+  }
+  return { allowed: true };
+}
+function breakpointbudgetallowed(active, ceiling) {
+  if (ceiling === void 0) return { allowed: true };
+  if (typeof ceiling !== "number" || !Number.isInteger(ceiling) || ceiling < 0) return { allowed: false, reason: "The reviewed breakpoint ceiling must be zero or a positive integer of user configured value with no code ceiling." };
+  if (active >= ceiling) return { allowed: false, reason: `The run already holds ${active} active breakpoint${active === 1 ? "" : "s"} and the reviewed breakpoint ceiling is ${ceiling}; revert one or review a wider ceiling.` };
+  return { allowed: true };
+}
+function pauseretentionwindow(settings) {
+  return settings?.pauseretention;
+}
+function breakpointceilingof(settings) {
+  return settings?.breakpointceiling;
+}
+function validatecdpgrammar(step, options) {
+  const kind = step.kind;
+  if (kind === "attachcdp") {
+    if (!Array.isArray(options.domains) || options.domains.length === 0 || !options.domains.every((domain) => typeof domain === "string" && cdpdomains.includes(domain))) return { allowed: false, reason: `The attach needs a non-empty enabled domain list of the reviewed domain grammar: ${cdpdomains.join(", ")}.` };
+    if (teardownplanof(options.teardown) === void 0) return { allowed: false, reason: "Every attach needs a reviewed teardown plan with its revert steps and resume policy before approval." };
+    if (options.allowlist !== void 0) {
+      const allowlist = cdpallowlistof(options.allowlist);
+      if (!allowlist || !allowlist.domains.every((domain) => options.domains.includes(domain))) return { allowed: false, reason: "The reviewed method allowlist must stay inside the enabled domains of the attach." };
+    }
+    const budgetcheck = debugwaitbudgetallowed(typeof options.wait === "number" ? options.wait : void 0, void 0);
+    if (!budgetcheck.allowed) return budgetcheck;
+    return { allowed: true };
+  }
+  if (kind === "detachcdp") return { allowed: true };
+  if (kind === "cdpcmd") {
+    const command = options.command && typeof options.command === "object" && !Array.isArray(options.command) ? options.command : void 0;
+    if (!command || typeof command.method !== "string" || methoddomain(command.method) === void 0) return { allowed: false, reason: "The raw command needs a reviewed method of the Domain.method form." };
+    if (command.params !== void 0 && (typeof command.params !== "object" || Array.isArray(command.params))) return { allowed: false, reason: "The raw command params must be a JSON object." };
+    if (command.resultpath !== void 0 && typeof command.resultpath !== "string") return { allowed: false, reason: "The reviewed result path must be a dotted path string." };
+    return { allowed: true };
+  }
+  if (kind === "watchcdp") {
+    if (!Array.isArray(options.events) || options.events.length === 0 || !options.events.every((rule) => cdpeventruleof(rule) !== void 0)) return { allowed: false, reason: "The event watch needs a non-empty reviewed list of domain event rules of the reviewed domain grammar." };
+    let watchwindow;
+    if (options.watch !== void 0) {
+      const watch = options.watch;
+      if (!watch || typeof watch !== "object" || Array.isArray(watch)) return { allowed: false, reason: "The reviewed event watch window must be an object." };
+      const reviewed = watch;
+      if (reviewed.window !== void 0) {
+        if (typeof reviewed.window !== "number" || !Number.isFinite(reviewed.window) || reviewed.window < 0) return { allowed: false, reason: "The reviewed event watch window must be zero or a positive number of milliseconds." };
+        watchwindow = reviewed.window;
+      }
+    }
+    if (watchwindow === void 0) return { allowed: false, reason: "The event watch needs a reviewed lifetime window before any domain event is observed." };
+    const budgetcheck = debugwaitbudgetallowed(watchwindow, typeof options.wait === "number" ? options.wait : void 0);
+    if (!budgetcheck.allowed) return budgetcheck;
+    return { allowed: true };
+  }
+  if (kind === "setbreakpoint") {
+    const breakpoint = breakpointinputof(options.breakpoint);
+    if (!breakpoint) return { allowed: false, reason: "The breakpoint needs a reviewed script url and a zero based line." };
+    if (!ishttpsurl(breakpoint.url)) return { allowed: false, reason: "The breakpoint script url must be a reviewed HTTPS url." };
+    if (breakpoint.condition !== void 0) {
+      const conditioncheck = validatebreakpointcondition(breakpoint.condition);
+      if (!conditioncheck.allowed) return conditioncheck;
+    }
+    return { allowed: true };
+  }
+  if (kind === "stepcode") {
+    if (stepmodeof(options.mode) === void 0) return { allowed: false, reason: "The step code mode must be one of stepover, stepinto, stepout or resume." };
+    return { allowed: true };
+  }
+  if (kind === "watchexpr") {
+    if (watchexpressionof(options.expression) === void 0) return { allowed: false, reason: "The watch expression needs the reviewed expression text." };
+    if (options.reviewed !== true) return { allowed: false, reason: "Watch expressions must be reviewed before evaluation; set the explicit reviewed flag on the step." };
+    return { allowed: true };
+  }
+  if (kind === "overridescript") {
+    const override = overrideinputof(options.override);
+    if (!override) return { allowed: false, reason: "The script override needs a reviewed url pattern and its full fixture source." };
+    if (patternorigin(override.urlpattern) === void 0) return { allowed: false, reason: "Script overrides without a named https origin pattern are refused." };
+    if (options.reviewed !== true) return { allowed: false, reason: "The full fixture source must be reviewed before the script override runs; set the explicit reviewed flag on the step." };
+    return { allowed: true };
+  }
+  return { allowed: true };
+}
+function planallowlist(steps) {
+  const attach = steps.find((step) => step.kind === "attachcdp");
+  if (!attach) return void 0;
+  let options = {};
+  try {
+    options = parseoptions(attach);
+  } catch {
+    options = {};
+  }
+  const domains = Array.isArray(options.domains) ? options.domains.filter((domain) => typeof domain === "string" && cdpdomains.includes(domain)) : [];
+  if (domains.length === 0) return void 0;
+  const gated = cdpallowlistof(options.allowlist);
+  return { domains, ...gated?.methods !== void 0 ? { methods: gated.methods } : {} };
+}
 function controltarget(step) {
   let options = {};
   try {
@@ -4535,6 +4902,10 @@ function validatestep(step, origin) {
     const timelinecheck = validatetimelinegrammar(step, options);
     if (!timelinecheck.allowed) return timelinecheck;
   }
+  if (iscdpkind(step.kind)) {
+    const cdpcheck = validatecdpgrammar(step, options);
+    if (!cdpcheck.allowed) return cdpcheck;
+  }
   if (step.kind === "tabcreate") {
     if (options.background !== void 0 && typeof options.background !== "boolean") return { allowed: false, reason: "The reviewed background flag must be a boolean." };
     if (options.window !== void 0 && (typeof options.window !== "number" || !Number.isInteger(options.window) || options.window < 0)) return { allowed: false, reason: "The reviewed target window id must be a non-negative integer." };
@@ -4640,6 +5011,46 @@ function canexecute(input) {
     const timelinegatecheck = timelinegate(input.session, input.tabid, input.origin, now);
     if (!timelinegatecheck.allowed) return timelinegatecheck;
   }
+  if (iscdpkind(input.step.kind)) {
+    const debuggatecheck = debuggate(input.session, input.tabid, input.origin, now);
+    if (!debuggatecheck.allowed) return debuggatecheck;
+    if (!input.plan) return { allowed: false, reason: "The devtools protocol steps need an approved plan." };
+    const allowlist = planallowlist(input.plan.steps);
+    if (input.step.kind !== "attachcdp") {
+      if (allowlist === void 0) return { allowed: false, reason: "The devtools protocol step needs the attachcdp step of the same plan with its enabled domains first." };
+      if (input.step.kind === "cdpcmd") {
+        let cdpoptions2 = {};
+        try {
+          cdpoptions2 = parseoptions(input.step);
+        } catch {
+          cdpoptions2 = {};
+        }
+        const command = cdpoptions2.command && typeof cdpoptions2.command === "object" && !Array.isArray(cdpoptions2.command) ? cdpoptions2.command : void 0;
+        const method = typeof command?.method === "string" ? command.method : "";
+        if (methoddomain(method) === void 0 || !allowlistcovers(allowlist, method)) return { allowed: false, reason: `The raw command ${method || ""} stays outside the enabled domain allowlist of the plan attach; review the attach domains or the method gates.` };
+      }
+    }
+    let cdpoptions = {};
+    try {
+      cdpoptions = parseoptions(input.step);
+    } catch {
+      cdpoptions = {};
+    }
+    if (input.step.kind === "setbreakpoint") {
+      const breakpoint = breakpointinputof(cdpoptions.breakpoint);
+      if (breakpoint) {
+        const targetgate = origincheck(input.session, breakpoint.url);
+        if (!targetgate.allowed) return targetgate;
+      }
+    }
+    if (input.step.kind === "overridescript") {
+      const override = overrideinputof(cdpoptions.override);
+      if (override) {
+        const targetgate = origincheck(input.session, override.urlpattern);
+        if (!targetgate.allowed) return targetgate;
+      }
+    }
+  }
   if (iscontrolkind(input.step.kind)) {
     const controlgate = sessiongate({ session: input.session, tabid: input.tabid, origin: input.origin, now, action: "control the network" });
     if (!controlgate.allowed) return controlgate;
@@ -4723,7 +5134,7 @@ function canexecute(input) {
 }
 
 // version.ts
-var packageversion = "1.1.45";
+var packageversion = "1.1.46";
 
 // types.ts
 var protocolversion = packageversion;
@@ -4748,6 +5159,20 @@ function parseproposal(value, origin, grants) {
   const expiresat = typeof planinput.expiresat === "number" ? planinput.expiresat : createdat + 10 * 60 * 1e3;
   if (expiresat <= createdat) throw new Error("Plan expiry must be in the future.");
   const planwindow = expiresat - createdat;
+  const attachinput = stepsinput.map((input) => record(input)).find((candidate) => candidate.kind === "attachcdp");
+  let planallowlist2;
+  if (attachinput !== void 0) {
+    const attachoptions = (() => {
+      try {
+        return parseoptions({ id: "attach", kind: "attachcdp", summary: "attach", risk: "sensitive", ...typeof attachinput.options === "string" ? { options: attachinput.options } : {} });
+      } catch {
+        return {};
+      }
+    })();
+    const domains = Array.isArray(attachoptions.domains) ? attachoptions.domains.filter((domain) => typeof domain === "string" && cdpdomains.includes(domain)) : [];
+    const gated = cdpallowlistof(attachoptions.allowlist);
+    planallowlist2 = domains.length > 0 ? { domains, ...gated?.methods !== void 0 ? { methods: gated.methods } : {} } : void 0;
+  }
   const steps = stepsinput.map((input, index) => {
     const candidate = record(input);
     const kind = text(candidate.kind, `step ${index + 1} kind`);
@@ -4798,6 +5223,36 @@ function parseproposal(value, origin, grants) {
       if (!granted) throw new Error(`The ${step.kind} capture of ${origin} targets an origin outside the grants.`);
       if (debugoptions.level !== void 0 && !loglevels.includes(debugoptions.level)) throw new Error(`The reviewed level floor must be one of ${loglevels.join(", ")}.`);
     }
+    if (iscdpkind(step.kind)) {
+      const granted = covered.some((pattern) => {
+        try {
+          return new URL(origin).origin === new URL(pattern).origin;
+        } catch {
+          return false;
+        }
+      });
+      if (!granted) throw new Error(`The ${step.kind} step of ${origin} targets an origin outside the grants.`);
+      let cdpoptions = {};
+      try {
+        cdpoptions = parseoptions(step);
+      } catch {
+        cdpoptions = {};
+      }
+      if (step.kind === "attachcdp") {
+        if (teardownplanof(cdpoptions.teardown) === void 0) throw new Error("Attach steps without a reviewed teardown plan are refused.");
+        const domains = Array.isArray(cdpoptions.domains) ? cdpoptions.domains.filter((domain) => typeof domain === "string" && cdpdomains.includes(domain)) : [];
+        if (domains.length === 0) throw new Error("Attach steps need a non-empty enabled domain list of the reviewed domain grammar.");
+        const gated = cdpallowlistof(cdpoptions.allowlist);
+        if (cdpoptions.allowlist !== void 0 && (!gated || !gated.domains.every((domain) => domains.includes(domain)))) throw new Error("The reviewed method allowlist must stay inside the enabled domains of the attach.");
+      }
+      if (step.kind === "cdpcmd") {
+        const command = cdpoptions.command && typeof cdpoptions.command === "object" && !Array.isArray(cdpoptions.command) ? cdpoptions.command : void 0;
+        const method = typeof command?.method === "string" ? command.method : "";
+        if (methoddomain(method) === void 0) throw new Error("Raw commands need a reviewed method of the Domain.method form.");
+        if (planallowlist2 === void 0) throw new Error("Raw command steps need the attachcdp step of the same plan with its enabled domains first.");
+        if (!allowlistcovers(planallowlist2, method)) throw new Error(`The raw command ${method} stays outside the enabled domain allowlist of the plan attach.`);
+      }
+    }
     const evaluation = validatestep(step, origin);
     if (!evaluation.allowed) throw new Error(evaluation.reason);
     const target = outboundtarget(step);
@@ -4872,7 +5327,7 @@ function requestbody(input) {
   return JSON.stringify({ version: protocolversion, objective: input.objective, session: input.session, observation: input.observation, capabilities: input.capabilities });
 }
 function outcomeresponse(input) {
-  return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, outcome: input.outcome, ...input.resolvedtarget ? { resolvedtarget: input.resolvedtarget } : {}, ...input.capture ? { capture: input.capture } : {}, ...input.media ? { media: input.media } : {}, ...input.transport ? { transport: input.transport } : {}, ...input.network ? { network: input.network } : {}, ...input.control ? { control: input.control } : {}, ...input.timeline ? { timeline: input.timeline } : {} });
+  return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, outcome: input.outcome, ...input.resolvedtarget ? { resolvedtarget: input.resolvedtarget } : {}, ...input.capture ? { capture: input.capture } : {}, ...input.media ? { media: input.media } : {}, ...input.transport ? { transport: input.transport } : {}, ...input.network ? { network: input.network } : {}, ...input.control ? { control: input.control } : {}, ...input.timeline ? { timeline: input.timeline } : {}, ...input.cdp ? { cdp: input.cdp } : {} });
 }
 function mapresponse(input) {
   return JSON.stringify({ version: protocolversion, planid: input.plan.id, planstate: input.plan.state, map: input.map });
@@ -4989,7 +5444,21 @@ function timelinereport(input) {
 function consolediffreport(input) {
   return { version: protocolversion, diff: input.diff };
 }
+function cdpreport(input) {
+  const overrides = input.overrides.map((spec) => {
+    const { source, ...metadata } = spec;
+    void source;
+    return metadata;
+  });
+  const grants = input.grants.map((grant) => {
+    const { prompt, ...metadata } = grant;
+    void prompt;
+    return metadata;
+  });
+  return { version: protocolversion, sessions: input.sessions, commands: input.commands, events: input.events, breakpoints: input.breakpoints, pauses: input.pauses, watches: input.watches, overrides, grants };
+}
 export {
+  allowlistcovers,
   annotationplanof,
   apientries,
   apikeyconsentgranted,
@@ -4997,6 +5466,7 @@ export {
   applyheaderules,
   argkind,
   assetentries,
+  attachcdpsession,
   attachtimeline,
   authconsentgranted,
   authorizeurl,
@@ -5007,6 +5477,9 @@ export {
   blockruleof,
   bodyfilterof,
   bodymatches,
+  breakpointbudgetallowed,
+  breakpointceilingof,
+  breakpointinputof,
   buildname,
   buildpdf,
   buildsheet,
@@ -5022,12 +5495,18 @@ export {
   captureformats,
   capturekinds,
   captureoptionsof,
+  capturepause,
   captureregion,
   capturereport,
   capturestates,
   capturestitched,
   capturetargets,
   capturevisible,
+  cdpallowlistof,
+  cdpdomains,
+  cdpeventruleof,
+  cdpkinds,
+  cdpreport,
   channeloptionsof,
   channelorigin,
   closechannel,
@@ -5048,9 +5527,12 @@ export {
   crossesviewport,
   cursorfrom,
   datasetresponse,
+  debuggate,
+  debuggerconsentcovers,
   debugwaitbudgetallowed,
   dedupeimages,
   actionrisk as deriveactionrisk,
+  detachcdpsession,
   diffresponse,
   diffreviewgrade,
   downloadreport,
@@ -5082,6 +5564,7 @@ export {
   imagefilterof,
   imagematches,
   imagenames,
+  iscdpkind,
   iscontrolkind,
   isdebugkind,
   isformkind,
@@ -5102,6 +5585,7 @@ export {
   mediakinds,
   mediareport,
   messagefilterof,
+  methoddomain,
   mockfor,
   mockspecof,
   multipartchunks,
@@ -5122,6 +5606,8 @@ export {
   observationresponse,
   openchannel,
   outcomeresponse,
+  overrideinputof,
+  overridematches,
   pairexchange,
   pairstates,
   parsehtmlbody,
@@ -5130,6 +5616,7 @@ export {
   parsetokens,
   passwordconsentgranted,
   patternorigin,
+  pauseretentionwindow,
   payloadshapeof,
   payloadvalid,
   payloadwithdefaults,
@@ -5137,6 +5624,7 @@ export {
   pdfpagesize,
   pdfsegments,
   pdftextlayout,
+  planallowlist,
   pollcursorof,
   polldecision,
   pollurl,
@@ -5158,6 +5646,7 @@ export {
   receivemessage,
   reconnectwaits,
   recordingoptionsof,
+  recordwatchvalue,
   redactconsoletext,
   redactedcookies,
   regionsteps,
@@ -5176,9 +5665,11 @@ export {
   scaledrect,
   seamweights,
   selectorresponse,
+  sendcdpcommand,
   sendfetch,
   sequenceintegrity,
   serializearg,
+  serializecdpcommand,
   sessionmemory,
   signalsreport,
   socketgate,
@@ -5189,11 +5680,14 @@ export {
   stackframes,
   stackgate,
   statusclassof,
+  stepmodeof,
   streamsummaries,
   streamwindowof,
   submitreviewgranted,
   subscriptionoptionsof,
   tabreportresponse,
+  teardowncdpsession,
+  teardownplanof,
   templateurl,
   thumbdirectiveof,
   thumbgeometry,
@@ -5208,12 +5702,15 @@ export {
   transformgrammar,
   unwrapgraphql,
   urlencodeform,
+  validatebreakpointcondition,
   validatefieldmatch,
   validateformrecord,
   validatestep,
   validatetargetref,
   validatevaluegen,
+  watchcdpevents,
   watcherdetached,
+  watchexpressionof,
   watchgate,
   wizardreport
 };