@wenathlan/extension 1.1.46 → 1.1.48

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.46",
+  "version": "1.1.48",
   "description": "A consent-first bridge for reviewed browser-agent tasks.",
   "permissions": [
     "activeTab",

package/extension/dist/pagebridge.js

@@ -32,6 +32,106 @@
     return { urlpattern, source };
   }
 
+  // emulation.ts
+  var browserpermissions = ["geolocation", "notifications", "camera", "microphone", "clipboard-read", "clipboard-write", "midi", "persistent-storage"];
+  var permissionstates = ["granted", "denied", "prompt"];
+  function familyofkind(kind) {
+    if (kind === "emulatedevice") return "device";
+    if (kind === "emulatenetwork") return "network";
+    if (kind === "emulatelocate") return "location";
+    if (kind === "setuseragent") return "agent";
+    if (kind === "overridepermission") return "permission";
+    if (kind === "blackboxscripts") return "blackbox";
+    return void 0;
+  }
+  function devicepresetof(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+    const entry = value;
+    const name = typeof entry.name === "string" && entry.name.trim() ? entry.name.trim() : void 0;
+    const width = typeof entry.width === "number" && Number.isInteger(entry.width) && entry.width > 0 ? entry.width : void 0;
+    const height = typeof entry.height === "number" && Number.isInteger(entry.height) && entry.height > 0 ? entry.height : void 0;
+    const pixelratio = typeof entry.pixelratio === "number" && Number.isFinite(entry.pixelratio) && entry.pixelratio > 0 ? entry.pixelratio : void 0;
+    if (name === void 0 || width === void 0 || height === void 0 || pixelratio === void 0) return void 0;
+    return { name, width, height, pixelratio, mobile: entry.mobile === true };
+  }
+  function networkpresetof(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+    const entry = value;
+    const name = typeof entry.name === "string" && entry.name.trim() ? entry.name.trim() : void 0;
+    const latency = typeof entry.latency === "number" && Number.isFinite(entry.latency) && entry.latency >= 0 ? entry.latency : void 0;
+    const download = typeof entry.download === "number" && Number.isFinite(entry.download) && entry.download >= 0 ? entry.download : void 0;
+    const upload = typeof entry.upload === "number" && Number.isFinite(entry.upload) && entry.upload >= 0 ? entry.upload : void 0;
+    if (name === void 0 || latency === void 0 || download === void 0 || upload === void 0) return void 0;
+    return { name, latency, download, upload, offline: entry.offline === true };
+  }
+  function locationpresetof(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+    const entry = value;
+    const name = typeof entry.name === "string" && entry.name.trim() ? entry.name.trim() : void 0;
+    const latitude = typeof entry.latitude === "number" && Number.isFinite(entry.latitude) ? entry.latitude : void 0;
+    const longitude = typeof entry.longitude === "number" && Number.isFinite(entry.longitude) ? entry.longitude : void 0;
+    const accuracy = typeof entry.accuracy === "number" && Number.isFinite(entry.accuracy) && entry.accuracy >= 0 ? entry.accuracy : void 0;
+    if (name === void 0 || latitude === void 0 || longitude === void 0 || accuracy === void 0) return void 0;
+    if (!locationrangevalid(latitude, longitude)) return void 0;
+    return { name, latitude, longitude, accuracy };
+  }
+  function agentpresetof(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+    const entry = value;
+    const name = typeof entry.name === "string" && entry.name.trim() ? entry.name.trim() : void 0;
+    const useragent = typeof entry.useragent === "string" ? entry.useragent : void 0;
+    const platform = typeof entry.platform === "string" && entry.platform.trim() ? entry.platform.trim() : void 0;
+    const brands = Array.isArray(entry.brands) ? entry.brands.filter((brand) => typeof brand === "string" && brand.trim().length > 0) : [];
+    if (name === void 0 || useragent === void 0 || platform === void 0 || brands.length === 0) return void 0;
+    if (!agentgrammarvalid(useragent)) return void 0;
+    return { name, useragent, platform, brands: [...new Set(brands)] };
+  }
+  function permissiongrantof(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+    const entry = value;
+    const name = typeof entry.name === "string" && browserpermissions.includes(entry.name) ? entry.name : void 0;
+    const state = typeof entry.state === "string" && permissionstates.includes(entry.state) ? entry.state : void 0;
+    if (name === void 0 || state === void 0) return void 0;
+    return { name, state, runscope: entry.runscope !== false };
+  }
+  function blackboxruleof(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+    const entry = value;
+    const urlpatterns = Array.isArray(entry.urlpatterns) ? entry.urlpatterns.filter((pattern) => typeof pattern === "string" && /^https:\/\//.test(pattern)) : [];
+    const tracescope = entry.tracescope;
+    if (urlpatterns.length === 0) return void 0;
+    if (tracescope !== "profiles" && tracescope !== "traces" && tracescope !== "both") return void 0;
+    return { urlpatterns: [...new Set(urlpatterns)], tracescope };
+  }
+  function locationrangevalid(latitude, longitude) {
+    return Number.isFinite(latitude) && Number.isFinite(longitude) && latitude >= -90 && latitude <= 90 && longitude >= -180 && longitude <= 180;
+  }
+  function agentgrammarvalid(useragent) {
+    const text = useragent.trim();
+    if (text.length === 0 || text.length > 512) return false;
+    if (/[\r\n]/.test(text)) return false;
+    if (!/^[A-Za-z0-9][A-Za-z0-9._+\-()/:; ,]*$/.test(text)) return false;
+    return /\/\d/.test(text) || /\d+\.\d+/.test(text);
+  }
+  function blackboxmatches(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 === void 0) return false;
+      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);
+  }
+
   // runtimeline.ts
   var loglevels = ["error", "warn", "info", "log", "debug", "trace"];
   function levelrank(level) {
@@ -120,9 +220,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", "attachcdp", "detachcdp", "cdpcmd", "overridescript"]);
+  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", "heapshot", "profilecpu", "capturesourcemaps", "emulatedevice", "emulatenetwork", "emulatelocate", "setuseragent", "overridepermission"]);
   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 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", "measureflow", "trackmemory", "watchshifts", "traceload", "annotatetrace", "replaytrace", "blackboxscripts"]);
   var allowedactions = /* @__PURE__ */ new Set([...sensitiveactions, ...interactionactions, ...readactions]);
   function parseoptions(step) {
     if (step.options === void 0) return {};
@@ -2477,6 +2577,185 @@
     }
   }
 
+  // extension/pageemulate.ts
+  function registry() {
+    const holder = globalThis;
+    if (holder.devthinkemulation === void 0) holder.devthinkemulation = {};
+    return holder.devthinkemulation;
+  }
+  function priorsnapshot(family) {
+    if (family === "device") return { pixelratio: window.devicePixelRatio, viewportwidth: window.innerWidth, viewportheight: window.innerHeight };
+    if (family === "agent") return { useragent: navigator.userAgent, platform: navigator.platform };
+    if (family === "permission") return { note: "the browser permission state stays untouched and the override restores by removing the page-side answer" };
+    return { note: "the layer adds no prior page state to restore" };
+  }
+  function applydevice(width, height, pixelratio, mobile) {
+    const state = registry();
+    if (state.pixelratio === void 0) state.pixelratio = window.devicePixelRatio;
+    Object.defineProperty(window, "devicePixelRatio", { configurable: true, get: () => pixelratio });
+    document.documentElement.dataset.devthinkMobile = mobile ? "true" : "false";
+    document.documentElement.dataset.devthinkViewport = `${width}x${height}`;
+  }
+  function revertdevice(prior) {
+    const state = registry();
+    const restored = typeof prior?.pixelratio === "number" ? prior.pixelratio : state.pixelratio ?? window.devicePixelRatio;
+    Object.defineProperty(window, "devicePixelRatio", { configurable: true, get: () => restored });
+    delete document.documentElement.dataset.devthinkMobile;
+    delete document.documentElement.dataset.devthinkViewport;
+    delete state.pixelratio;
+  }
+  function applylocation(latitude, longitude, accuracy) {
+    const state = registry();
+    if (state.geolocation === void 0) state.geolocation = navigator.geolocation;
+    const position = () => ({
+      coords: { latitude, longitude, accuracy, altitude: null, altitudeAccuracy: null, heading: null, speed: null },
+      timestamp: Date.now()
+    });
+    const overridden = {
+      getCurrentPosition: (success) => {
+        success(position());
+      },
+      watchPosition: (success) => {
+        success(position());
+        return 0;
+      },
+      clearWatch: () => {
+      }
+    };
+    Object.defineProperty(navigator, "geolocation", { configurable: true, get: () => overridden });
+  }
+  function revertlocation() {
+    const state = registry();
+    if (state.geolocation !== void 0) Object.defineProperty(navigator, "geolocation", { configurable: true, get: () => state.geolocation });
+    delete state.geolocation;
+  }
+  function applyagent(useragent, platform, brands) {
+    const state = registry();
+    if (state.useragent === void 0) state.useragent = navigator.userAgent;
+    if (state.platform === void 0) state.platform = navigator.platform;
+    if (state.brands === void 0) state.brands = brands;
+    Object.defineProperty(navigator, "userAgent", { configurable: true, get: () => useragent });
+    Object.defineProperty(navigator, "platform", { configurable: true, get: () => platform });
+    const branded = brands.map((brand, index) => ({ brand, version: `${index + 1}.0.0.0` }));
+    const dataholder = navigator;
+    if (dataholder.userAgentData !== void 0) Object.defineProperty(dataholder, "userAgentData", { configurable: true, get: () => ({ brands: branded }) });
+  }
+  function revertagent(prior) {
+    const state = registry();
+    const useragent = typeof prior?.useragent === "string" ? prior.useragent : state.useragent ?? navigator.userAgent;
+    const platform = typeof prior?.platform === "string" ? prior.platform : state.platform ?? navigator.platform;
+    Object.defineProperty(navigator, "userAgent", { configurable: true, get: () => useragent });
+    Object.defineProperty(navigator, "platform", { configurable: true, get: () => platform });
+    delete state.useragent;
+    delete state.platform;
+    delete state.brands;
+  }
+  function applypermission(name, state) {
+    const holder = navigator;
+    if (holder.devthinkpermission === void 0) holder.devthinkpermission = {};
+    holder.devthinkpermission[name] = state;
+    const state0 = registry();
+    if (state0.permissions === void 0 && navigator.permissions !== void 0) state0.permissions = navigator.permissions;
+    if (navigator.permissions === void 0) return;
+    const overridden = {
+      query: (description) => new Promise((resolve) => {
+        const applied = holder.devthinkpermission?.[description.name];
+        resolve({ state: applied ?? "prompt", name: description.name, onchange: null });
+      })
+    };
+    Object.defineProperty(navigator, "permissions", { configurable: true, get: () => overridden });
+  }
+  function revertpermission() {
+    const state = registry();
+    if (state.permissions !== void 0) Object.defineProperty(navigator, "permissions", { configurable: true, get: () => state.permissions });
+    delete state.permissions;
+    delete navigator.devthinkpermission;
+  }
+  function applyblackbox(patterns) {
+    registry().blackbox = patterns;
+  }
+  function activeblackboxpatterns() {
+    return registry().blackbox ?? [];
+  }
+  async function runemulationstep(step) {
+    const options = (() => {
+      try {
+        return parseoptions(step);
+      } catch {
+        return {};
+      }
+    })();
+    const family = familyofkind(step.kind);
+    const derivation = "The mask is a page-injected override through the scripting api; the browser device metrics, network stack, true location, request headers and permission state stay untouched because no debugger or platform permission exists in the manifest.";
+    if (step.kind === "emulatedevice") {
+      const preset = devicepresetof(options.device);
+      if (!preset) return { ok: false, summary: "The reviewed device preset is absent or malformed." };
+      const prior = priorsnapshot("device");
+      applydevice(preset.width, preset.height, preset.pixelratio, preset.mobile);
+      return { ok: true, summary: `Applied the device preset ${preset.name} of ${preset.width} by ${preset.height} css pixels, pixel ratio ${preset.pixelratio} and the ${preset.mobile ? "mobile" : "desktop"} hint to the run tab.`, details: { prior, preset: { name: preset.name, width: preset.width, height: preset.height, pixelratio: preset.pixelratio, mobile: preset.mobile }, derivation } };
+    }
+    if (step.kind === "emulatenetwork") {
+      const preset = networkpresetof(options.network);
+      if (!preset) return { ok: false, summary: "The reviewed network preset is absent or malformed." };
+      const window0 = typeof options.window === "number" ? options.window : void 0;
+      return { ok: true, summary: `Applied the network preset ${preset.name} with ${preset.latency} milliseconds latency, ${preset.download} and ${preset.upload} kilobit per second bounds${preset.offline ? ` and the offline flag${window0 !== void 0 ? ` for the reviewed window of ${window0} milliseconds` : ""}` : ""}; the bounds shape the traffic the extension itself initiates.`, details: { preset: { name: preset.name, latency: preset.latency, download: preset.download, upload: preset.upload, offline: preset.offline }, ...window0 !== void 0 ? { window: window0 } : {}, derivation } };
+    }
+    if (step.kind === "emulatelocate") {
+      const preset = locationpresetof(options.location);
+      if (!preset) return { ok: false, summary: "The reviewed location preset is absent or malformed." };
+      applylocation(preset.latitude, preset.longitude, preset.accuracy);
+      return { ok: true, summary: `Applied the location preset ${preset.name} of ${preset.latitude}, ${preset.longitude} with the ${preset.accuracy} meter accuracy radius to the run tab.`, details: { preset: { name: preset.name, latitude: preset.latitude, longitude: preset.longitude, accuracy: preset.accuracy }, derivation } };
+    }
+    if (step.kind === "setuseragent") {
+      const preset = agentpresetof(options.agent);
+      if (!preset) return { ok: false, summary: "The reviewed agent preset is absent or malformed." };
+      const prior = priorsnapshot("agent");
+      applyagent(preset.useragent, preset.platform, preset.brands);
+      return { ok: true, summary: `Applied the agent preset ${preset.name} with the reviewed user agent string, platform ${preset.platform} and ${preset.brands.length} brand${preset.brands.length === 1 ? "" : "s"} together, scoped to the run tab only.`, details: { prior, preset: { name: preset.name, platform: preset.platform, brands: preset.brands }, derivation } };
+    }
+    if (step.kind === "overridepermission") {
+      const grant = permissiongrantof(options.permission);
+      if (!grant) return { ok: false, summary: "The reviewed permission override is absent or malformed." };
+      const prior = priorsnapshot("permission");
+      applypermission(grant.name, grant.state);
+      return { ok: true, summary: `Answered the ${grant.name} permission queries of the run tab with the reviewed ${grant.state} state${grant.runscope ? " for the run scope" : ""}; the browser permission itself stays untouched.`, details: { prior, permission: { name: grant.name, state: grant.state, runscope: grant.runscope }, derivation } };
+    }
+    if (step.kind === "blackboxscripts") {
+      const rules = (Array.isArray(options.rules) ? options.rules : []).flatMap((rule) => {
+        const parsed = blackboxruleof(rule);
+        return parsed !== void 0 ? [parsed] : [];
+      });
+      if (rules.length === 0) return { ok: false, summary: "The reviewed blackbox rule list is absent or malformed." };
+      applyblackbox(rules.flatMap((rule) => rule.urlpatterns));
+      return { ok: true, summary: `Marked ${rules.flatMap((rule) => rule.urlpatterns).length} third party url pattern${rules.flatMap((rule) => rule.urlpatterns).length === 1 ? "" : "s"} as blackboxed in the traces of the run; the rules read no page state.`, details: { rules, derivation: "Blackbox rules shape stack traces and profiles of the run only; they read no page state and touch no third party script." } };
+    }
+    void family;
+    return { ok: false, summary: "The emulation step is not part of the mask family." };
+  }
+  function revertemulationlayer(family, prior) {
+    if (family === "device") {
+      revertdevice(prior);
+      return { ok: true, summary: "Restored the prior pixel ratio and cleared the device hint of the run tab." };
+    }
+    if (family === "location") {
+      revertlocation();
+      return { ok: true, summary: "Restored the true navigator geolocation of the run tab." };
+    }
+    if (family === "agent") {
+      revertagent(prior);
+      return { ok: true, summary: "Restored the true navigator user agent, platform and brand list of the run tab." };
+    }
+    if (family === "permission") {
+      revertpermission();
+      return { ok: true, summary: "Removed the page-side permission answers so the browser permission state returns." };
+    }
+    if (family === "blackbox") {
+      delete registry().blackbox;
+      return { ok: true, summary: "Removed the blackbox pattern registry of the run." };
+    }
+    return { ok: true, summary: "The network layer holds no page state to restore; the transport bounds ended with the run." };
+  }
+
   // extension/pagedebug.ts
   var harnesskey = "__devthinkcdp";
   function readharness() {
@@ -2544,7 +2823,9 @@
         }
       }
       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." } };
+      const iframes = [...document.querySelectorAll("iframe[src]")].map((frame) => frame.src).filter((src) => src.startsWith("https://"));
+      const serviceworker = "serviceWorker" in navigator && navigator.serviceWorker.controller ? navigator.serviceWorker.controller.scriptURL : void 0;
+      return { ok: true, summary: `Attached the instrumented devtools harness with the reviewed domains ${options.domains.join(", ")} enabled.`, details: { attached: true, domains: [...harness.domains], targets: { iframes, ...serviceworker !== void 0 ? { serviceworker } : {} }, 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 and the iframe and service worker targets derive from the page frame list and controller state." } };
     }
     if (step.kind === "detachcdp") {
       const harness = readharness();
@@ -2734,14 +3015,16 @@
       }
     }
     if (step.kind === "watcherrors") {
+      const blackbox = activeblackboxpatterns();
+      const hideframes = (record) => ({ ...record, frames: record.frames.filter((frame) => !blackbox.some((pattern) => blackboxmatches(pattern, frame.url))) });
       const onerror = (event) => {
-        const record = errorcapture({ message: event.message, sourceurl: event.filename, line: event.lineno, ...event.error instanceof Error ? { stacktext: event.error.stack } : {}, redact: options.redact });
+        const record = hideframes(errorcapture({ message: event.message, sourceurl: event.filename, line: event.lineno, ...event.error instanceof Error ? { stacktext: event.error.stack } : {}, redact: options.redact }));
         errors.push({ ...record, stepid: step.id, at: Date.now() });
         capture("error", "error", record.message, Date.now());
       };
       const onrejection = (event) => {
         const reason = event.reason instanceof Error ? `${event.reason.name}: ${event.reason.message}` : String(event.reason);
-        const record = rejectioncapture({ reason, ...event.reason instanceof Error ? { stacktext: event.reason.stack } : {}, redact: options.redact });
+        const record = hideframes(rejectioncapture({ reason, ...event.reason instanceof Error ? { stacktext: event.reason.stack } : {}, redact: options.redact }));
         rejections.push({ ...record, stepid: step.id, at: Date.now() });
         capture("error", "rejection", record.reason, Date.now());
       };
@@ -2786,6 +3069,143 @@
     return { ok: true, summary, details: { entries, console: consoleentries, errors, rejections, resources, longtasks, watchwindow: options.window, depth: options.depth, derivation: "Console, error and task watching derives from page-injected listeners and the performance buffers through the scripting api; no debugger permission exists in the manifest." } };
   }
 
+  // extension/pageprofile.ts
+  function profilestepoptions(step) {
+    let options = {};
+    try {
+      options = parseoptions(step);
+    } catch {
+      options = {};
+    }
+    const watch = options.watch && typeof options.watch === "object" && !Array.isArray(options.watch) ? options.watch : {};
+    const flow = options.flow && typeof options.flow === "object" && !Array.isArray(options.flow) ? options.flow : void 0;
+    const heap = options.heap && typeof options.heap === "object" && !Array.isArray(options.heap) ? options.heap : {};
+    const growth = options.growth && typeof options.growth === "object" && !Array.isArray(options.growth) ? options.growth : void 0;
+    const profile = options.profile && typeof options.profile === "object" && !Array.isArray(options.profile) ? options.profile : {};
+    const trace = options.trace && typeof options.trace === "object" && !Array.isArray(options.trace) ? options.trace : {};
+    return {
+      ...flow !== void 0 && typeof flow.prefix === "string" && Array.isArray(flow.steps) && Array.isArray(flow.metrics) ? { flow: { prefix: flow.prefix, steps: flow.steps.filter((item) => typeof item === "string"), metrics: flow.metrics.filter((item) => typeof item === "string") } } : {},
+      watchwindow: typeof watch.window === "number" && Number.isFinite(watch.window) && watch.window >= 0 ? watch.window : 0,
+      heapinterval: typeof heap.interval === "number" && Number.isFinite(heap.interval) && heap.interval >= 0 ? heap.interval : 0,
+      ...growth !== void 0 && typeof growth.slope === "number" ? { growth: { slope: growth.slope, interval: typeof growth.interval === "number" && Number.isFinite(growth.interval) && growth.interval >= 0 ? growth.interval : 0 } } : {},
+      duration: typeof profile.duration === "number" && Number.isFinite(profile.duration) && profile.duration >= 0 ? profile.duration : 0,
+      threshold: typeof options.threshold === "number" && Number.isFinite(options.threshold) && options.threshold >= 0 ? options.threshold : 0,
+      categories: Array.isArray(trace.categories) ? trace.categories.filter((category) => typeof category === "string") : [],
+      ...typeof trace.exporttarget === "string" ? { exporttarget: trace.exporttarget } : {},
+      ...typeof trace.traceid === "string" ? { traceid: trace.traceid } : {},
+      scripts: Array.isArray(options.scripts) ? options.scripts.filter((url) => typeof url === "string") : []
+    };
+  }
+  function categoryof(entry, initiator) {
+    if (entry.entryType === "navigation") return "navigation";
+    if (entry.entryType === "paint" || entry.entryType === "largest-contentful-paint" || entry.entryType === "layout-shift") return "painting";
+    if (entry.entryType === "resource") return initiator === "fetch" || initiator === "xmlhttprequest" ? "network" : "loading";
+    return "scripting";
+  }
+  async function collectentries(watchwindow, types) {
+    const rows = [];
+    for (const type of ["navigation", "paint", "mark", "measure", "resource", "longtask"]) {
+      for (const entry of performance.getEntriesByType(type)) {
+        rows.push({ name: entry.name, type: entry.entryType, start: entry.startTime, duration: entry.duration, ...type === "resource" ? { initiator: entry.initiatorType } : {} });
+      }
+    }
+    if (types.length > 0) {
+      await new Promise((resolve) => {
+        const observer = new PerformanceObserver((list) => {
+          for (const entry of list.getEntries()) rows.push({ name: entry.name, type: entry.entryType, start: entry.startTime, duration: entry.duration });
+        });
+        observer.observe({ entryTypes: types, buffered: true });
+        window.setTimeout(() => {
+          observer.disconnect();
+          resolve();
+        }, Math.max(0, watchwindow));
+      });
+    } else {
+      await new Promise((resolve) => window.setTimeout(resolve, Math.max(0, watchwindow)));
+    }
+    return rows;
+  }
+  function heapsample() {
+    const memory = performance.memory;
+    return { usedbytes: memory?.usedJSHeapSize ?? 0, limitbytes: memory?.jsHeapSizeLimit ?? memory?.totalJSHeapSize ?? 0, nodecount: document.querySelectorAll("*").length };
+  }
+  async function runprofilestep(step) {
+    const options = profilestepoptions(step);
+    if (step.kind === "measureflow") {
+      if (!options.flow || options.watchwindow <= 0) return { ok: false, summary: "The reviewed flow spec with its watch window is absent." };
+      const started = performance.now();
+      for (const stepid of options.flow.steps) performance.mark(`${options.flow.prefix}:${stepid}:start`);
+      const entries = await collectentries(options.watchwindow, ["largest-contentful-paint", "first-input", "event", "longtask"]);
+      for (const stepid of options.flow.steps) performance.mark(`${options.flow.prefix}:${stepid}:end`);
+      for (const stepid of options.flow.steps) performance.measure(`${options.flow.prefix}:${stepid}`, `${options.flow.prefix}:${stepid}:start`, `${options.flow.prefix}:${stepid}:end`);
+      return { ok: true, summary: `Marked the start and end of ${options.flow.steps.length} step${options.flow.steps.length === 1 ? "" : "s"} of the flow ${options.flow.prefix} and collected ${entries.length} performance entr${entries.length === 1 ? "y" : "ies"} for the reviewed window of ${options.watchwindow} milliseconds.`, details: { entries, watchwindow: options.watchwindow, started, derivation: "Flow measurement derives from the performance timeline buffers and the injected marks through the scripting api; no debugger permission exists in the manifest." } };
+    }
+    if (step.kind === "heapshot") {
+      const sample = heapsample();
+      return { ok: true, summary: `Captured the on demand heap sample of ${sample.usedbytes} used bytes against the ${sample.limitbytes} byte limit with ${sample.nodecount} dom node${sample.nodecount === 1 ? "" : "s"}.`, details: { ...sample, derivation: "Heap bytes derive from the page performance memory buffer and the node count from the dom because no heap profiler exists without the debugger permission." } };
+    }
+    if (step.kind === "trackmemory") {
+      if (!options.growth) return { ok: false, summary: "The reviewed growth slope is absent." };
+      const sample = heapsample();
+      return { ok: true, summary: `Took the heap sample of ${sample.usedbytes} used bytes beside the step for the growth tracking of slope ${options.growth.slope} bytes per millisecond.`, details: { ...sample, slope: options.growth.slope, interval: options.growth.interval, derivation: "Growth samples derive from the page performance memory buffer beside every step of the run." } };
+    }
+    if (step.kind === "profilecpu") {
+      if (options.duration <= 0) return { ok: false, summary: "The reviewed cpu profile duration is absent." };
+      const started = performance.now();
+      const entries = await collectentries(options.duration, ["longtask", "event", "first-input"]);
+      const samples = entries.filter((entry) => entry.type === "longtask" || entry.type === "event" || entry.type === "first-input").map((entry) => ({ name: entry.name || entry.type, time: entry.duration }));
+      return { ok: true, summary: `Profiled the cpu window of ${options.duration} milliseconds with ${samples.length} sample${samples.length === 1 ? "" : "s"} from the long task and event timing buffers.`, details: { samples, duration: options.duration, started, derivation: "Cpu samples derive from the long task attribution and event timing buffers because no sampling profiler exists without the debugger permission." } };
+    }
+    if (step.kind === "watchshifts") {
+      if (options.watchwindow <= 0) return { ok: false, summary: "The reviewed layout shift window is absent." };
+      const shifts = [];
+      await new Promise((resolve) => {
+        const observer = new PerformanceObserver((list) => {
+          for (const entry of list.getEntries()) {
+            const shift = entry;
+            const selectors = (shift.sources ?? []).flatMap((source) => source.node instanceof Element ? [source.node.tagName.toLowerCase() + (source.node.id ? `#${source.node.id}` : "")] : []);
+            const score = typeof shift.value === "number" ? shift.value : 0;
+            if (options.threshold > 0 && score < options.threshold) continue;
+            shifts.push({ score, starttime: shift.startTime, selectors });
+          }
+        });
+        observer.observe({ entryTypes: ["layout-shift"], buffered: true });
+        window.setTimeout(() => {
+          observer.disconnect();
+          resolve();
+        }, options.watchwindow);
+      });
+      return { ok: true, summary: `Watched ${shifts.length} layout shift${shifts.length === 1 ? "" : "s"} for the reviewed window of ${options.watchwindow} milliseconds${options.threshold > 0 ? ` with the score threshold ${options.threshold}` : ""}.`, details: { shifts, watchwindow: options.watchwindow, derivation: "Layout shifts derive from the performance layout-shift buffer with the impacted element selectors of the shift sources." } };
+    }
+    if (step.kind === "traceload") {
+      if (options.categories.length === 0 || options.watchwindow <= 0) return { ok: false, summary: "The reviewed trace categories or window are absent." };
+      const started = performance.now();
+      const entries = await collectentries(options.watchwindow, ["largest-contentful-paint", "first-input", "event", "longtask", "layout-shift"]);
+      const events4 = entries.filter((entry) => options.categories.includes(categoryof({ name: entry.name, entryType: entry.type, startTime: entry.start, duration: entry.duration }, entry.initiator))).map((entry) => ({ name: entry.name, category: categoryof({ name: entry.name, entryType: entry.type, startTime: entry.start, duration: entry.duration }, entry.initiator), offset: Math.round(entry.start - started) }));
+      return { ok: true, summary: `Recorded ${events4.length} trace event${events4.length === 1 ? "" : "s"} of the reviewed categories ${options.categories.join(", ")} for the window of ${options.watchwindow} milliseconds and derived the exportable trace file.`, details: { events: events4, categories: options.categories, watchwindow: options.watchwindow, started, ...options.exporttarget !== void 0 ? { exporttarget: options.exporttarget } : {}, derivation: "The trace file derives from the performance timeline entries of the reviewed categories; it is not the devtools binary trace format because no debugger permission exists in the manifest." } };
+    }
+    if (step.kind === "capturesourcemaps") {
+      const scripts = [];
+      for (const element of document.querySelectorAll("script[src]")) {
+        const src = element.src;
+        if (!src.startsWith(location.origin)) continue;
+        if (options.scripts.length > 0 && !options.scripts.includes(src)) continue;
+        let mapurl;
+        try {
+          const response = await fetch(src, { credentials: "same-origin" });
+          const source = await response.text();
+          const match = /[#@]\s*sourceMappingURL=(\S+)/.exec(source);
+          if (match !== null && match[1] !== void 0) mapurl = new URL(match[1], src).toString();
+        } catch {
+        }
+        scripts.push({ url: src, ...mapurl !== void 0 ? { mapurl } : {} });
+      }
+      const withmaps = scripts.filter((script) => script.mapurl !== void 0);
+      return { ok: true, summary: `Read the sourceMappingURL declarations of ${scripts.length} same origin script${scripts.length === 1 ? "" : "s"} of ${location.origin} and found ${withmaps.length} map declaration${withmaps.length === 1 ? "" : "s"}; the script sources stay in the page bridge and only the map urls leave it.`, details: { scripts, origin: location.origin, derivation: "Source map declarations are read by re-fetching the loaded same origin scripts of the page; cross origin scripts stay outside the capture and no map content enters the page bridge." } };
+    }
+    return { ok: false, summary: "The profiling step is not part of the instrumented family." };
+  }
+
   // extension/pageforms.ts
   function matchfield(fields, match) {
     const key = match.mode === "label" ? "label" : match.mode === "placeholder" ? "placeholder" : match.mode === "arialabel" ? "arialabel" : "name";
@@ -3660,6 +4080,8 @@
   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 profilestepkinds = /* @__PURE__ */ new Set(["measureflow", "heapshot", "trackmemory", "profilecpu", "watchshifts", "traceload", "capturesourcemaps"]);
+  var emulationstepkinds = /* @__PURE__ */ new Set(["emulatedevice", "emulatenetwork", "emulatelocate", "setuseragent", "overridepermission", "blackboxscripts"]);
   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"]);
@@ -3727,6 +4149,8 @@
     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 (profilestepkinds.has(step.kind)) return await runprofilestep(step);
+    else if (emulationstepkinds.has(step.kind)) return await runemulationstep(step);
     else if (mutatingkinds.has(step.kind)) result = runpageaction(step, element);
     else {
       if (!element) return { ok: false, summary: "Action target is no longer available." };
@@ -4048,6 +4472,6 @@
     for (const cookie of targets) document.cookie = `${cookie.name}=; path=/; expires=Thu, 01 Jan 1970 00:00:00 GMT`;
     return { cleared: targets.length, summary: `Cleared ${targets.length} cookie${targets.length === 1 ? "" : "s"} through the page cookie jar of ${location.origin}.` };
   }
-  Object.assign(globalThis, { devthinkbridge: { capturesnapshot, previewtarget, performstep, readdialogs, measurepage, elementrect, preparecapture, scrollcapture, restorecapture, scrollcontainercapture, waitsettle, pdfsegment, pdfbreaks, videoframe, canvasdata, streamelements, mediaelements, pageassets, pageimages, parsehtmlmarkup, resourcerecords, writecookies, readcookies, clearcookies } });
+  Object.assign(globalThis, { devthinkbridge: { capturesnapshot, previewtarget, performstep, readdialogs, measurepage, elementrect, preparecapture, scrollcapture, restorecapture, scrollcontainercapture, waitsettle, pdfsegment, pdfbreaks, videoframe, canvasdata, streamelements, mediaelements, pageassets, pageimages, parsehtmlmarkup, resourcerecords, writecookies, readcookies, clearcookies, revertemulationlayer } });
 })();
 //# sourceMappingURL=pagebridge.js.map