@wenathlan/extension 1.1.47 → 1.1.49

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.47",
+  "version": "1.1.49",
   "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", "heapshot", "profilecpu", "capturesourcemaps"]);
+  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", "restoresession", "exportsessions", "importsessions"]);
   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", "measureflow", "trackmemory", "watchshifts", "traceload", "annotatetrace", "replaytrace"]);
+  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", "persiststate", "capturesession", "namedsessions", "diffsessions", "searchsessions"]);
   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() {
@@ -2736,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());
       };
@@ -3800,6 +4081,7 @@
   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"]);
@@ -3868,6 +4150,7 @@
     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." };
@@ -4189,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