@wenathlan/extension 1.1.45 → 1.1.46

package/extension/dist/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnOEjO8Z0PDgQyfvawGcaO2j+o0GLCFTLNj7TkYC/Avo9l2NenMRq7gp90Nfd7E9MViv/OMcCKSYZ5unv12QPRtv31C+a5UQWDFAOP/cH5mwMd6hsayElrSoW8ta+FwFqmr9dIFkn7cQEU3YhZr4Gcbs+ycUHOxVgDA4NBKB0rQ6e9VW5LvTw0isRYUrqM+M72vKxHk9zUIYYn/LGPvottKBYi2GLr0PHSeC2UE+Shmq7vcFIXj6hDjvD4kLJ5sKoUllEcZ1TPuBcnHUQ9ndKA5iktXDQOIJCUJmi7a0YJ2PGg7fvpYfT9k0ai/qZ+pIoRfoOEwE01bPoDn7NjeYnNQIDAQAB",
   "name": "Devthink",
-  "version": "1.1.45",
+  "version": "1.1.46",
   "description": "A consent-first bridge for reviewed browser-agent tasks.",
   "permissions": [
     "activeTab",

package/extension/dist/pagebridge.js

@@ -1,5 +1,37 @@
 "use strict";
 (() => {
+  // cdpbus.ts
+  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 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 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 };
+  }
+
   // runtimeline.ts
   var loglevels = ["error", "warn", "info", "log", "debug", "trace"];
   function levelrank(level) {
@@ -88,9 +120,9 @@
   }
 
   // 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]);
   function parseoptions(step) {
     if (step.options === void 0) return {};
@@ -2446,6 +2478,204 @@
   }
 
   // extension/pagedebug.ts
+  var harnesskey = "__devthinkcdp";
+  function readharness() {
+    return globalThis[harnesskey];
+  }
+  function writeharness(harness) {
+    if (harness === void 0) delete globalThis[harnesskey];
+    else globalThis[harnesskey] = harness;
+  }
+  var instrumentedmethods = /* @__PURE__ */ new Set(["Runtime.evaluate", "Log.enable", "Debugger.enable", "DOM.enable", "Network.enable", "Page.enable", "DOM.getSnapshot", "Page.getNavigationHistory"]);
+  function cdpstepoptions(step) {
+    let options = {};
+    try {
+      options = parseoptions(step);
+    } catch {
+      options = {};
+    }
+    const teardown = options.teardown && typeof options.teardown === "object" && !Array.isArray(options.teardown) && Array.isArray(options.teardown.revertsteps) ? { revertsteps: options.teardown.revertsteps.filter((item) => typeof item === "string"), resumepolicy: String(options.teardown.resumepolicy ?? "ask") } : void 0;
+    const command = options.command && typeof options.command === "object" && !Array.isArray(options.command) ? options.command : void 0;
+    const watch = options.watch && typeof options.watch === "object" && !Array.isArray(options.watch) ? options.watch : {};
+    const breakpoint = breakpointinputof(options.breakpoint);
+    const expression = watchexpressionof(options.expression);
+    const override = overrideinputof(options.override);
+    return {
+      domains: Array.isArray(options.domains) ? options.domains.filter((domain) => typeof domain === "string") : [],
+      ...teardown !== void 0 ? { teardown } : {},
+      ...command !== void 0 && typeof command.method === "string" ? { command: { method: command.method, ...command.params && typeof command.params === "object" && !Array.isArray(command.params) ? { params: command.params } : {}, ...typeof command.resultpath === "string" ? { resultpath: command.resultpath } : {} } } : {},
+      events: Array.isArray(options.events) ? options.events.flatMap((rule) => {
+        const parsed = rule && typeof rule === "object" && !Array.isArray(rule) ? rule : void 0;
+        if (!parsed || typeof parsed.domain !== "string" || typeof parsed.event !== "string") return [];
+        return [{ domain: parsed.domain, event: parsed.event, ...typeof parsed.match === "string" ? { match: parsed.match } : {} }];
+      }) : [],
+      watchwindow: typeof watch.window === "number" && Number.isFinite(watch.window) && watch.window >= 0 ? watch.window : 0,
+      ...breakpoint !== void 0 ? { breakpoint } : {},
+      ...options.mode !== void 0 && stepmodeof(options.mode) !== void 0 ? { mode: options.mode } : {},
+      ...expression !== void 0 ? { expression } : {},
+      ...override !== void 0 ? { override } : {}
+    };
+  }
+  function domstate() {
+    return { url: location.href, title: document.title, nodes: document.querySelectorAll("*").length, forms: document.forms.length };
+  }
+  async function runcdpstep(step) {
+    const options = cdpstepoptions(step);
+    if (step.kind === "attachcdp") {
+      const existing = readharness();
+      if (existing) {
+        for (const detach of existing.hooks) detach();
+      }
+      const harness = { domains: options.domains, breakpoints: [], overrides: [], events: [], hooks: [] };
+      if (options.domains.includes("Log") || options.domains.includes("Runtime")) {
+        for (const level of loglevels) {
+          const original = console[level];
+          const hooked = (...args) => {
+            try {
+              original.apply(console, args);
+            } catch {
+            }
+            harness.events.push({ domain: "Log", event: "entryAdded", payload: args.map((arg) => serializearg(arg, 2)).join(" "), at: Date.now() });
+          };
+          console[level] = hooked;
+          harness.hooks.push(() => {
+            console[level] = original;
+          });
+        }
+      }
+      writeharness(harness);
+      return { ok: true, summary: `Attached the instrumented devtools harness with the reviewed domains ${options.domains.join(", ")} enabled.`, details: { attached: true, domains: [...harness.domains], derivation: "The chrome devtools protocol needs the debugger permission, which the manifest gate forbids; the session runs through the page-instrumented harness injected by the scripting api." } };
+    }
+    if (step.kind === "detachcdp") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      for (const detach of harness.hooks) detach();
+      const reverted = { breakpoints: harness.breakpoints.length, overrides: harness.overrides.length };
+      writeharness(void 0);
+      return { ok: true, summary: `Detached the instrumented devtools harness cleanly after reverting ${reverted.breakpoints} breakpoint${reverted.breakpoints === 1 ? "" : "s"} and ${reverted.overrides} override${reverted.overrides === 1 ? "" : "s"}.`, details: { detached: true, ...reverted } };
+    }
+    if (step.kind === "cdpcmd") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      const method = options.command?.method ?? "";
+      const params = options.command?.params ?? {};
+      if (!instrumentedmethods.has(method)) return { ok: false, summary: `The reviewed command ${method} reports the uninstrumented error class: the page harness implements ${[...instrumentedmethods].join(", ")} only.`, details: { method, errorclass: "uninstrumented" } };
+      const started = Date.now();
+      try {
+        if (method === "Runtime.evaluate") {
+          const expression = typeof params.expression === "string" ? params.expression : "";
+          const probeurl = typeof params.url === "string" ? params.url : "inline";
+          const scope = params.scope && typeof params.scope === "object" && !Array.isArray(params.scope) ? params.scope : {};
+          const override = harness.overrides.find((spec) => overridematch(spec.urlpattern, probeurl));
+          const source = override !== void 0 && overridematch(override.urlpattern, probeurl) ? override.source : expression;
+          const value = new Function(...Object.keys(scope), `"use strict"; return (${source});`)(...Object.values(scope));
+          let tripped;
+          for (const breakpoint of harness.breakpoints) {
+            if (breakpoint.url !== probeurl) continue;
+            const conditionok = breakpoint.condition === void 0 ? true : Boolean(new Function(...Object.keys(scope), `"use strict"; return (${breakpoint.condition});`)(...Object.values(scope)));
+            if (!conditionok) continue;
+            breakpoint.hits += 1;
+            tripped = { reason: "breakpoint", hitbreakpoint: breakpoint.id, frames: stackframes(new Error().stack ?? ""), scope, cursor: breakpoint.line, lines: Math.max(1, source.split("\n").length) };
+            harness.paused = tripped;
+            break;
+          }
+          const serialized = serializearg(value, 3);
+          harness.events.push({ domain: "Runtime", event: "executionContextDestroyed", payload: serialized.slice(0, 200), at: Date.now() });
+          return { ok: true, summary: `The reviewed command ${method} returned in ${Date.now() - started} milliseconds${tripped !== void 0 ? " and paused the run on the reviewed breakpoint" : ""}.`, details: { method, duration: Date.now() - started, result: { value: serialized }, ...tripped !== void 0 ? { paused: { reason: tripped.reason, hitbreakpoint: tripped.hitbreakpoint, frames: tripped.frames } } : {} } };
+        }
+        if (method === "DOM.getSnapshot") {
+          const state = domstate();
+          return { ok: true, summary: `The reviewed command ${method} returned the dom snapshot of ${state.nodes} nodes in ${Date.now() - started} milliseconds.`, details: { method, duration: Date.now() - started, result: state } };
+        }
+        if (method === "Page.getNavigationHistory") {
+          const state = domstate();
+          return { ok: true, summary: `The reviewed command ${method} returned the page navigation history in ${Date.now() - started} milliseconds.`, details: { method, duration: Date.now() - started, result: { url: state.url, title: state.title } } };
+        }
+        return { ok: true, summary: `The reviewed command ${method} enabled its domain through the instrumented harness in ${Date.now() - started} milliseconds.`, details: { method, duration: Date.now() - started, result: {} } };
+      } catch (error) {
+        return { ok: false, summary: `The reviewed command ${method} failed with the evaluationerror class: ${error instanceof Error ? error.message : String(error)}.`, details: { method, duration: Date.now() - started, errorclass: "evaluationerror" } };
+      }
+    }
+    if (step.kind === "watchcdp") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      const started = Date.now();
+      const navigation = performance.getEntriesByType("navigation")[0];
+      if (harness.domains.includes("Page") && navigation !== void 0 && navigation.loadEventStart > 0) harness.events.push({ domain: "Page", event: "loadEventFired", payload: location.href, at: started });
+      await wait4(options.watchwindow);
+      const observed = harness.events.filter((event) => event.at >= started);
+      return { ok: true, summary: `Observed ${observed.length} domain event${observed.length === 1 ? "" : "s"} for the reviewed window of ${options.watchwindow} milliseconds.`, details: { events: observed, watchwindow: options.watchwindow, derivation: "Domain events derive from the instrumented console hooks and the page performance navigation buffer because no debugger permission exists in the manifest." } };
+    }
+    if (step.kind === "setbreakpoint") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      if (!options.breakpoint) return { ok: false, summary: "The breakpoint input is absent." };
+      const id = `bp-${options.breakpoint.url}-${options.breakpoint.line}-${options.breakpoint.column ?? 0}`;
+      const registered = { id, ...options.breakpoint, hits: 0 };
+      harness.breakpoints.push(registered);
+      return { ok: true, summary: `Registered the reviewed breakpoint at ${options.breakpoint.url}:${options.breakpoint.line}${options.breakpoint.condition !== void 0 ? ` under the condition ${options.breakpoint.condition}` : ""}.`, details: { breakpoint: registered } };
+    }
+    if (step.kind === "stepcode") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      const mode = stepmodeof(options.mode);
+      if (mode === void 0) return { ok: false, summary: "The step code mode is absent." };
+      if (harness.paused === void 0) return { ok: false, summary: "No paused instrumented probe exists to step through; pause on a reviewed breakpoint first." };
+      if (mode === "resume" || mode === "stepout") {
+        const reason = harness.paused.reason;
+        const frames = harness.paused.frames;
+        delete harness.paused;
+        return { ok: true, summary: `The ${mode} mode ${mode === "resume" ? "resumed" : "stepped out of"} the paused probe after ${frames.length} call frame${frames.length === 1 ? "" : "s"}.`, details: { mode, paused: false, reason } };
+      }
+      harness.paused.cursor += 1;
+      const state = domstate();
+      return { ok: true, summary: `The ${mode} mode advanced to line ${harness.paused.cursor} of the paused probe and captured the pause state with ${harness.paused.frames.length} call frame${harness.paused.frames.length === 1 ? "" : "s"} and the dom state.`, details: { mode, paused: true, pausestate: { reason: harness.paused.reason, ...harness.paused.hitbreakpoint !== void 0 ? { hitbreakpoint: harness.paused.hitbreakpoint } : {}, frames: harness.paused.frames, cursor: harness.paused.cursor, dom: state } } };
+    }
+    if (step.kind === "watchexpr") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      if (!options.expression) return { ok: false, summary: "The watch expression input is absent." };
+      if (harness.paused === void 0) return { ok: false, summary: "No paused instrumented probe exists to evaluate the watch expression in; pause on a reviewed breakpoint first." };
+      try {
+        const value = new Function(...Object.keys(harness.paused.scope), `"use strict"; return (${options.expression.expression});`)(...Object.values(harness.paused.scope));
+        return { ok: true, summary: `Evaluated the reviewed watch expression at the pause in the ${options.expression.scope} scope.`, details: { expression: options.expression.expression, scope: options.expression.scope, value: serializearg(value, 3) } };
+      } catch (error) {
+        return { ok: false, summary: `The reviewed watch expression failed with the evaluationerror class: ${error instanceof Error ? error.message : String(error)}.`, details: { errorclass: "evaluationerror" } };
+      }
+    }
+    if (step.kind === "overridescript") {
+      const harness = readharness();
+      if (!harness) return { ok: false, summary: "No instrumented devtools harness is attached to this page." };
+      if (!options.override) return { ok: false, summary: "The script override input is absent." };
+      const id = `ov-${options.override.urlpattern}`;
+      harness.overrides = harness.overrides.filter((spec) => spec.id !== id);
+      harness.overrides.push({ id, urlpattern: options.override.urlpattern, source: options.override.source });
+      try {
+        new Function(options.override.source)();
+        return { ok: true, summary: `Applied the reviewed script fixture for ${options.override.urlpattern} on the current document and on later instrumented evaluations of the pattern.`, details: { override: { id, urlpattern: options.override.urlpattern, applied: true } } };
+      } catch (error) {
+        return { ok: false, summary: `The reviewed script fixture failed with the evaluationerror class: ${error instanceof Error ? error.message : String(error)}.`, details: { errorclass: "evaluationerror" } };
+      }
+    }
+    return { ok: false, summary: "The devtools step is not part of the instrumented family." };
+  }
+  function overridematch(urlpattern, url) {
+    const patternmatch = /^(https:\/\/[^/]+|inline)(\/.*)?$/.exec(urlpattern);
+    const urlmatch = /^(https:\/\/[^/]+|inline)(\/.*)?$/.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 debugwatchoptions(step) {
     let options = {};
     try {
@@ -3429,6 +3659,7 @@
   var detectionkinds = /* @__PURE__ */ new Set(["detectlists", "detecttables", "detectinfinitescroll", "detectvirtual", "detectlazy", "detectsticky", "detectscrolllock", "countpages", "classifypage", "fingerprintsection", "readscrollpos"]);
   var watchstepkinds = /* @__PURE__ */ new Set(["watchmutate", "watchbanner", "watchfocus", "waitquiet", "readjson", "diffsnapshots", "deriveselector"]);
   var debugstepkinds = /* @__PURE__ */ new Set(["watchconsole", "watcherrors", "watchtasks"]);
+  var cdpstepkinds = /* @__PURE__ */ new Set(["attachcdp", "detachcdp", "cdpcmd", "watchcdp", "setbreakpoint", "stepcode", "watchexpr", "overridescript"]);
   var navstepkinds = /* @__PURE__ */ new Set(["waitload", "waiturl", "followlink", "spanav", "spawait", "rewritequery", "setfragment", "stopnav", "prefetch", "preconnect", "printpdf"]);
   var formkinds = /* @__PURE__ */ new Set(["fillform", "filllabel", "fillplaceholder", "detectfields", "generatevalues", "readerrors", "skiphoneypot", "detectlogin", "detecttemplate", "handoffcaptcha", "asksubmit", "submitform", "consentpassword", "attachfile"]);
   var wizardkinds = /* @__PURE__ */ new Set(["runwizard", "selectchain", "picktypeahead", "pickdate", "fillcard", "fillcode"]);
@@ -3495,6 +3726,7 @@
     else if (detectionkinds.has(step.kind)) result = runpagedetection(step, element, rootdocument);
     else if (watchstepkinds.has(step.kind)) result = runpagewatch(step, element, rootdocument);
     else if (debugstepkinds.has(step.kind)) return await rundebugwatch(step);
+    else if (cdpstepkinds.has(step.kind)) return await runcdpstep(step);
     else if (mutatingkinds.has(step.kind)) result = runpageaction(step, element);
     else {
       if (!element) return { ok: false, summary: "Action target is no longer available." };